# 4 Ozone
## 4.1 Ozone Download and Configuration Method
1. Download Ozone
You can download it directly from Segger's official website. If it is a Windows system, select the Windows version. For the Ozone version, you can select the latest one.
Download address for Segger's online debugging tool
[Ozone - The J-Link Debugger Windows 64-bit Installer](https://www.segger.cn/downloads/jlink/#Ozone) [[Debugging Crash Method](../tools/ozone.md#43Ozone单步调试Debug)]
**Note:**
Ozone and Jlink versions later than V7.6 check for pirated Jlink debuggers. For developers using them for learning purposes, [Ozone_Windows_V320d_x64.exe](https://www.segger.cn/downloads/jlink/Ozone_Windows_V320d_x64.exe)(https://www.segger.cn/downloads/jlink/Ozone_Windows_V320d_x64.exe) and [JLink_Windows_V758a_x86_64.exe](https://www.segger.cn/downloads/jlink/JLink_Windows_V758a_x86_64.exe)(https://www.segger.cn/downloads/jlink/JLink_Windows_V758a_x86_64.exe) can be recommended.
2. Configure Device, MCU peripheral registers, and the RT-Thread OS script
A. Replace the Ozone configuration file `C:\Users\yourname\AppData\Roaming\SEGGER\JLinkDevices\JLinkDevices.xml` with `SiFli-SDK\tools\flash\jlink_drv\JLinkDevices.xml`. In addition, create a directory named SiFli under `C:\Users\yourname\AppData\Roaming\SEGGER\JLinkDevices\Devices\`, and copy `SiFli-SDK-i\tools\flash\jlink_drv\sf32lb52x\SF32LB52X_*.elf` to it. The corresponding directories and files are as follows:
For the Jlink programming driver mapping, see the contents of the JLinkDevices.xml file:
```xml
```
B. Copy the peripheral register configuration files `D:\sifli\git\SiFli-SDK-i\tools\svd_external\SF32LB52X\SF32LB52x.*` to the `C:\Program Files\SEGGER\Ozone\Config\Peripherals` directory;
C. Copy `SiFli-SDK\tools\segger\RtThreadOSPlugin.js` to the `C:\Program Files\SEGGER\Ozone\Plugins\OS\` directory. The corresponding directories and files are as follows:
After configuring items A/B/C, open Ozone, and you can select the Devices and MCU peripheral registers that need to be debugged.
After configuring the MCU peripheral registers and the RT-Thread OS script, enter the Ozone interface, where you can view the corresponding MCU peripheral registers and OS threads.
## 4.2 Ozone Debug Connection Fails
Note:
You need to add the flash driver and xml configuration file in the same way as for jlink, so that Ozone can support the SF32LB55X chip.
```xml
C:\Program Files\SEGGER\Ozone\Devices\SiFli\SF32LB55X****.elf
C:\Program Files\SEGGER\Ozone\JLinkDevices.xml
#不同Jlink或者Ozone版本的路径可能如下：
C:\Users\yourname\AppData\Roaming\SEGGER\JLinkDevices.xml
C:\Users\yourname\AppData\Roaming\SEGGER\JLinkDevices\Devices\SF32LB55X****.elf
```
## 4.3 Ozone Single-Step Debug
1. By default, J-Link connect connects to HCPU. If you are debugging HCPU, you can skip this step and debug HCPU directly. If you want to debug LCPU, run SDK\tools\segger\jlink_lcpu_a0.bat (55), jlink_lcpu_pro.bat (58), or jlink_lcpu_56x.bat (56) in the Windows cmd command window. Running this batch file executes several commands in \tools\segger\jlink_lcpu_xxx.jlink:
```
w4 0x4004f000 1
connect
w4 0x40070000 0
exit
```
You can also enter these two commands in sequence directly in the Jlink window to switch to lcpu.
You can also write registers in the code to switch SWD Jlink to Lcpu debugging;
2. Now take 55 as an example to demonstrate Lcpu single-step execution. First create a new project.
3. Select the debug chip,
If it cannot be found, you need to in
Add the 55x chip model configuration to C:\Program Files\SEGGER\Ozone\JLinkDevices.xml
and the four flash programming files in C:\Program Files\SEGGER\Ozone\Devices\SiFli\SF32LB55X_****.elf
4. Select the jlink device that is already connected to the PC. If it cannot be found, check the jlink connection and jlink power supply.
5. Select the compiled *.axf or *.elf file. If it is the watch_demo project, the Lcpu axf path will be at
```
\release\example\rom_bin\lcpu_general_ble_img\lcpu_general_551.axf
```
6. Select Jlink or the virtual IP of SifliUsartServer.exe
For 52, the default debugging port is uart. After connecting with SifliUsartServer.exe, use IP 127.0.0.1:19025
7. The next step is to select where to obtain the initial PC pointer and initial stack from. You can select the default option or select the Do no set option, then click finish to complete.
8. Attach and halt Program means to let jlink connect to lcpu and stop at the currently running PC pointer,
Attch and Running Program means to let jlink connect to lcpu and start continuing program execution from the current PC.
9. After clicking the run program arrow icon, you can see that lcpu can already run in single-step mode. You can add breakpoints and view stack information and register status.
## 4.4 Disconnection Issue After Ozone Connects
Often, after being connected for a while, the following Target Connection Lost dialog box appears, and then the connection is lost.
If you encounter the above issue, before connecting Ozone for debugging, close Ozone's Memory window and other unused windows. For example, the following window reads a nonexistent memory address or reads PSRAM memory that has not yet been initialized:
Because Ozone reads these memory contents during connection, a disconnection will occur if the read fails.
## 4.5 Enable RT-Thread RTOS Online Debugging in Ozone
Copy the \sdk\tools\segger\RtThreadOSPlugin.js file to the Ozone installation directory:
`C:\Program Files\SEGGER\Ozone\Plugins\OS\RtThreadOSPlugin.js`
Then open this file and follow the steps below. You can then use Ozone to switch RTThread threads online for viewing and debugging.
After Ozone is connected and Project.SetOSPlugin("RtThreadOSPlugin"); is enabled, the site is as follows:
## 4.6 Redefine File Paths in Ozone
When the path of the programmed bin is not the local build path, using Ozone for Debug will prompt File not find, and the corresponding C source code cannot be located, so step-by-step tracing and issue locating cannot be performed.
Solution:
Single file not found: Right-click the file and use Locate File to locate the corresponding file, and then the C source file can be located.
Incorrect base address for batch files: Use the Project.AddPathSubstitute command to relocate the path, for example, replacing the linux path in the elf with the windows path.
