调试器连接与采样配置

支持的调试器

主程序	调试器支持
HSS_DataVisualizer	仅 SEGGER J-Link / J-Trace
UNI_DataVisualizer	DAP-Link / ST-Link V2 / ST-Link V3 / J-Link / Black Magic / FTDI / WCH-Link / CH347usbjtag / Glasgow Interface Explorer 等

持有 J-Link 的用户建议优先使用 HSS_DataVisualizer 以获得最佳性能；其它调试器请使用 UNI_DataVisualizer。

各调试器注意事项

J-Link（HSS 专用版）

仅 HSS

• 建议使用 SEGGER 官方驱动以获得更好的性能
• J-Link 驱动安装路径不要带版本号，否则可能导致程序无法正常工作：

J-Link（在 UNI 中使用）

仅 UNI

• 需通过 J-Link 官方软件包内的 JLinkConfig.exe 将 J-Link 配置为 WinUSB 驱动；若配置对话框中无法选择 WinUSB 选项，请使用 Zadig 安装通用 WinUSB 驱动
• 不建议在 UNI 中使用 J-Link——无法发挥其最强性能：实测 J-Link Ultra+ 在 UNI 中采样速率仅约 500 次/秒，而在 HSS 中可高达 33000 次/秒

ST-Link V2 / V3

仅 UNI

• 请确保已安装最新版 ST-Link 固件 STSW-LINK007 与 驱动 STSW-LINK009
• 固件版本要求：ST-Link V2 ≥ v2.26、ST-Link V3 ≥ v3.2

FTDI 系列调试器

仅 UNI

• 支持基于以下 USB-JTAG 桥接芯片构建的调试器：FT232H、FT2232C、FT2232D、FT2232H、FT4232H（例如 Olimex ARM-USB 系列的 TINY / TINY-H / OCD / OCD-H）
• 不支持 FTDI 官方 VCP / D2xx 驱动，请使用 Zadig 安装通用 WinUSB 驱动

其它调试器

仅 UNI

• Black Magic：参阅官网与仓库
• WCH-Link：参阅官网与仓库
• CH347usbjtag：参阅官网与仓库
• Glasgow Interface Explorer：参阅 probe.rs probe-setup 章节与官网

采样模式

模式	特点
HSS	异步高速采样（推荐），速率上限取决于调试器型号
SWD / JTAG 直读	通用异步读取方式
RTT	同步高速访问，需在设置中指定 RTT 地址范围

• 附加模式连接：不复位芯片，直接附着到正在运行的目标
• 连接后可使用调试器控制：开始运行 / 挂起 / 复位并挂起 / 复位并运行

连接流程

1. 新建工程配置文件（*.HSSDVProj），在设置页面设置目标芯片、接口（SWD / JTAG）、速度与采样周期等参数
2. 加载符号文件（*.elf / *.axf / *.out 等，详见变量观测与示波图）
3. 在变量树中双击变量，加入观测列表
4. 连接目标开始示波（Pro Ribbon 界面可用快捷键：F1 连接 / F2 附加模式连接；Esc 断开）

自定义芯片支持包（.pack）仅 UNI

UNI 支持通过 CMSIS .pack 芯片支持包添加自定义芯片。

pack 包内 pdsc 文件 family 重名问题：部分厂商 pack 包的 pdsc 文件可能存在 family 重名，导致生成的 yaml 相互覆盖。解决方法：

1. 用解压软件（如 Bandizip）分别打开重名 family 的 pack 包，将内部 pdsc 文件解出
2. 用代码编辑器（如 VSCode）修改各 pdsc 的 family 名称使其唯一（如 MM32F103 Series 改为 MM32F103x8xB Series 与 MM32F103xCxE Series）
3. 将修改后的 pdsc 放回各自 pack 包
4. 在 UNI 中重新添加修改后的 pack 包，即可生成不重名的 yaml