Connecting to Ozone's Automation Socket Interface
The automation interface allows complete control of Ozone via a TCP socket connected to the console window. It allows complete control of the application, either manually using a terminal or fully automated via another application.
Connecting via Putty
PuTTY is a free, open-source terminal emulator and network file-transfer client primarily for Windows (also available for Unix-like systems). It implements several network protocols, most commonly SSH (Secure Shell), and is used to securely connect to remote machines' command lines. Here, we use Putty to connect to and remote control Ozone.
General sequence
- Start Ozone
- Start Putty
- Apply settings in Putty
- Open the socket connection
- Issue commands in Putty and evaluate response messages
Please find details to the steps below.
Start Ozone
Start Ozone e.g. by double-clicking onto the desktop icon that was created by the Ozone installer, or via the respective entry in the start menu.
Start Putty
On details on how to start Putty, please refer to the Putty documentation. Often, a desktop icon is created during installation, or you may navigate to the directory where the installer saved the executable (e.g. "C:\program files\Putty") and double-click onto "putty.exe".
Apply settings in Putty
Please apply the following settings in Putty:
- Host name (or IP address):
localhost - Port:
19200 - Connection type:
Other: Raw
Open the socket connection
After entering the settings click on the "Open" button to establish the socket connection. Once the connection is established, a welcome message will be displayed, e.g. SEGGER Ozone - The J-Link Debugger V3.40h.
Issue commands in Putty and evaluate response messages
You now may enter any command in Putty which you may enter in Ozone's console window:
File.Open("<ELF file>"); will open an ELF file, Window.Show ("Watched Data"); will open the watched data window, Window.Add ("Watched Data 1", "<variable name>"); will add a variable to the watched data window, etc. Simply enter ? to get a list of the available commands.
Please note that the command feedback will be printed to both the console window and the socket interface, so Putty will display the same information as is printed in the console window. This allows you to evaluate how Ozone executed the command you issued.