2. 搭建RISC-V调试环境

任务目标

本案例将使用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）。

验证方法与判定标准

执行以下步骤确认调试链路正常：

1. OpenOCD终端无错误输出，且显示 target state: halted 或类似状态信息。
2. GDB执行 monitor reset halt 后，info registers 输出的 pc 值应为 0x2000（HiFive1的复位向量地址，位于Flash的启动代码段）。
3. 寄存器 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）是否点亮。