WS53 调试指南#

本文主要说明 WS53 开发板与 SEGGER J-Link 调试器的硬件连接。连接完成后,如何配置工程、启动调试、设置断点和查看调试信息,请按后续资料中的文档操作。

适用范围#

  • 本文以快速入门使用的 HH-D170 星闪开发板为例,也适用于引出相同调试信号的 WS53 开发板。

  • SDK 的 ws53 Target 使用 J-Link 调试器,调试接口为 SWD,GDB 端口为 3333。

调试器选择#

WS53 调试指南使用 SEGGER J-Link 作为调试器,并通过 GDB Server 为 VS Code 插件或命令行 GDB 提供调试服务。

准备工作#

准备以下物品:

物品

用途

WS53 开发板

目标设备。确认板卡已引出 SWD 调试信号,并能正常供电。

SEGGER J-Link 调试器

连接主机与 WS53 调试接口。根据调试器型号准备对应 USB 线。

J-Link 与开发板之间的连接线或转接板

按调试器和开发板两端的接口类型选择。

Type-C 数据线或独立电源

给开发板供电;需要查看串口日志时,同时连接开发板的 USB 转串口。

在主机上安装 J-Link 软件包。HiSpark Studio 的 J-Link 配置说明见工程调试:调试配置选项,其中包含 JlinkGDBServerCL 路径要求;J-Link 软件包从 SEGGER J-Link 下载页面获取。

使用 SWD 连接#

WS53 的 SDK 配置默认使用 SWD。使用标准 J-Link 20-pin 接口或对应转接板时,按下表连接;板端信号名称以开发板丝印和硬件资料为准。

WS53 与 J-Link 20-pin SWD 对接图

图中接口底图来自 SEGGER 20-pin J-Link Connector,彩色标注表示 WS53 开发板的对接关系。

J-Link 信号

标准 20-pin 针脚

WS53 开发板端

说明

VTref

1

开发板 3V3

连接开发板 3V3。

GND

4、6、8、10、12

开发板 GND

J-Link 与开发板必须共地。

SWDIO

7

开发板 MIO14

双向数据线。

SWCLK

9

开发板 MIO15

调试时钟线。

标准 J-Link 接口的针脚定义和 SWD 复用关系见 SEGGER J-Link Interface Description。如果调试器使用 10-pin 接口,或开发板使用非标准排针,请使用对应的原装转接线,并按转接线两端的信号标识重新核对,不要套用 20-pin 的物理针号。

连接前检查#

  1. 关闭开发板和 J-Link 的电源,确认连接器方向、缺口和 1 脚标记一致。

  2. 根据板卡丝印确认 3V3、GND、SWDIO 和 SWCLK。

  3. 将 J-Link 1 号引脚连接开发板 3V3,先连接 GND 和信号线,再给开发板上电;检查 VTref 与目标板实际电压一致。

  4. 将 J-Link 通过 USB 连接到主机。

  5. 若主机同时连接串口线,确认串口线的 TX/RX 接在开发板的调试串口,不能接到 SWD 信号线上。

完成检查后,J-Link 与开发板之间应使用 SWD 调试接口。

使用 VS Code 插件调试#

启动调试#

完成调试器配置后,在 HiSpark Studio for VS Code 中选择 GDB Launch 或 GDB Attach。工程调试界面、调试器配置、Launch/Attach 和常用调试功能见HiSpark Studio 工程调试。

使用命令行调试#

命令行调试分为“使用 OpenOCD 启动调试服务器”和“使用 RISC-V GDB 连接服务器”两步。先完成本页的硬件连接,并确认开发板已经上电、调试器已经连接;构建和烧录仍按快速入门执行。

使用 OpenOCD 启动调试服务器#

OpenOCD 用于启动 GDB Server。请先从 hs-openocd 使用说明 获取对应平台的发布包并解压。当前 WS53 工程对 HiSparkLinkPro 的 OpenOCD 配置使用 cmsis-dap.cfg 作为调试器接口配置,使用 WS53-swd.cfg 作为目标配置,GDB Server 默认监听 3333 端口。

在 Linux 终端中进入 OpenOCD 解压目录,执行:

./openocd -s . -f cmsis-dap.cfg -f WS53-swd.cfg

如果 OpenOCD 可执行文件不在当前目录,将 ./openocd 替换为实际路径。保持 OpenOCD 所在终端运行,再按下文启动 GDB。

使用 RISC-V GDB 连接#

在新的终端中进入 SDK 的 src 目录,使用 WS53 工具链中的 GDB,并加载构建生成的 ELF 文件。Windows PowerShell 示例:

cd "<SDK目录>\src"
& .\tools\bin\compiler\riscv\cc_riscv32_musl_b010\cc_riscv32_musl_win\bin\riscv32-linux-musl-gdb.exe `
  .\output\ws53\acore\ws53_liteos_app\application.elf

Linux 示例:

cd <SDK目录>/src
./tools/bin/compiler/riscv/cc_riscv32_musl_b010/cc_riscv32_musl/bin/riscv32-linux-musl-gdb \
  output/ws53/acore/ws53_liteos_app/application.elf

进入 GDB 后执行:

target remote localhost:3333
monitor reset halt
break main
continue

OpenOCD 提供 GDB Remote Protocol,GDB 连接命令如上。命令行调试只连接已经烧录的镜像;不要使用 GDB load 向 Flash 写入固件,除非当前目标 cfg 和芯片烧录说明明确支持该操作。

后续资料#

本文只完成源码和配置静态核对,未替代具体开发板的实物连线检查,也未声明已完成目标板调试验证。首次连接或更换板卡时,应以板卡原理图、丝印和 J-Link 型号手册为准。