2. RISC-V Debug Module 架构概览与组件识别
任务目标
本案例将使用OpenOCD作为调试服务器，GDB作为调试客户端，连接SiFive HiFive1开发板（基于FE310 SoC，RISC-V RV32IMAC内核），完成以下基本调试操作：复位目标板、暂停程序执行、读取核心寄存器。
环境与依赖
- 硬件：SiFive HiFive1开发板（通过板载USB转JTAG接口连接主机）
- 软件：OpenOCD（需支持RISC-V，版本≥0.10.0，建议从riscv-openocd源码编译）、GDB（riscv32-unknown-elf-gdb，来自RISC-V GNU工具链）
- 操作系统：Linux/macOS（Windows需配置驱动，本案例以Linux为例）
连接与配置
HiFive1通过USB线连接主机后，系统应识别出两个串口设备（调试桥与虚拟串口）。确认设备节点：
ls /dev/ttyUSB* # 通常为 /dev/ttyUSB0（调试）与 /dev/ttyUSB1（串口）OpenOCD使用HiFive1的板级配置（board/sifive-hifive1.cfg），该文件已包含FTDI JTAG接口与FE310目标芯片的初始化参数，无需手动修改。
启动OpenOCD
在终端启动OpenOCD，指定板级配置：
openocd -f board/sifive-hifive1.cfg启动成功后，终端显示类似 Info : Listening on port 3333 for gdb connections，表示GDB调试端口已就绪。
GDB连接与调试操作
另开终端，启动RISC-V GDB并连接OpenOCD：
riscv32-unknown-elf-gdb
(gdb) target extended-remote :3333
(gdb) monitor reset halt # 复位并暂停目标
(gdb) info registers # 读取核心寄存器
关键操作说明：
monitor reset halt：通过OpenOCD的RISC-V适配层发送复位信号，并在复位向量处暂停CPU。info registers：显示x0-x31通用寄存器及pc（程序计数器）。- 若需继续运行，使用
continue；再次暂停使用interrupt（Ctrl+C）。
验证方法与判定标准
执行以下步骤确认调试链路正常：
- OpenOCD终端无错误输出，且显示
target state: halted或类似状态信息。 - GDB执行
monitor reset halt后，info registers输出的pc值应为0x2000（HiFive1的复位向量地址，位于Flash的启动代码段）。 - 寄存器
x0恒为0x0（RISC-V架构硬性规定），其余寄存器值可随机但需为合法32位数值。
若 pc 显示为 0x2000 且 x0 为0，则说明复位、暂停与寄存器读取三项操作全部成功，调试环境搭建完成。
常见问题
- OpenOCD提示找不到设备：检查USB线是否连接数据口（非充电口），并确认当前用户有权限访问
/dev/ttyUSB*（可尝试sudo openocd）。 - GDB连接被拒绝：确认OpenOCD仍在运行且端口3333未被占用（
netstat -tlnp | grep 3333）。 - 寄存器值全为0：可能目标板未上电或JTAG链路异常，检查板载电源指示灯（LED D2）是否点亮。