English version of this guide:
[Tutorial] Debugging RTL8722 with the new Arduino IDE 2.0
硬件和软件要求
硬件:
RTL8720/RTL8721/RTL8722 DN/DM/DF 开发板
SEGGER JLink 调试器(https://www.segger.com/products/debug-probes/j-link/)
软件:
Arduino IDE 2.0 (https://www.arduino.cc/en/software)
SEGGER JLink 软件包 (SEGGER - The Embedded Experts - Downloads - J-Link / J-Trace)
安装步骤
- 安装 Arduino IDE 2.0。 安装 Arduino IDE 2.0 的说明可以在以下网站找到 https://docs.arduino.cc/software/ide-v2/tutorials/getting-started/ide-v2-downloading-and-installing.
注意：Arduino IDE 2.0 可以与旧的 Arduino IDE 共存。任何对开发板或程序库修改都会影响到两个版本的 IDE。
- 安装 SEGGER JLink 软件包。
对于 Windows 用户：这个过程假定 64 位版本的 JLink 软件安装在 C:\Program Files\SEGGER 文件路径下。
-
在 Arduino IDE 2.0 菜单中，在 Tools → Board → Boards Manager , 找到并安装 Realtek Ameba 的开发板支持包。
-
在工具栏附近的菜单中，选择与你的开发板和对应的 COM 端口。
-
打开示例代码 File → Examples → AmebaDebugExample → ExampleDebug .
-
按照注释，在 debug_custom.json 文件的 serverArgs 字段中加入正确的文件夹路径。
-
将开发板和 JLink 调试器与计算机链接。使用跳线，按照下图所示的引脚接续图，将调试器连接到开发板的 SWD 引脚处。如果您还不知道 JLink 调试器上的 SWD 引脚信息，请访问下方网址：J-Link Interface Description.
JLink 调试器 RTL8722 开发板 VTref 3.3V GND GND SWDIO SWDIO SWCLK SWCLK
调试过程
关于如何使用 Arduino IDE 调试，请参考 https://docs.arduino.cc/software/ide-v2/tutorials/ide-v2-debugger 。
-
调试前，确保启用 Sketch → Optimize for Debugging.
-
使用 USB 转 UART COM 串口，进入“上传模式”，编译上传示例程序。暂时还不支持使用调试器下载程序。
-
上传完成后，重启开发板，就可以通过点击 “上传” 图标旁边的 “调试” 图标开始调试。应该看到程序停止运行，并且在程序的第一行代码处出现黄色高亮，这一行高亮表示处理器即将执行的下一行代码。
注意：RTL872xD 只有2个硬件断点寄存器。当你设置断点时，这些将被用掉。试图设置太多的断点会导致调试失败，Output 窗口将显示 “WARNING: No more breakpoint resources left”。发生这种情况时，可能需要停止调试并重启。
注意：使用任何单步运行功能（step over, step into, step out）都需要两个硬件断点资源是空闲的。在使用这些功能之前，应该先删除或停用所有现有的断点。
