RV-LINK：Eclipse 使用 RV-LINK 调试 RISC-V 程序

旧城等待， 2023-08-17 16:05 35阅读 0赞

# RV-LINK：Eclipse 使用 RV-LINK 调试 RISC-V 程序 #

[https://blog.csdn.net/zoomdy/article/details/101565649][https_blog.csdn.net_zoomdy_article_details_101565649]  
zoomdy **at** 163 *dot* com

RV-LINK 项目主页：[https://gitee.com/zoomdy/RV-LINK][https_gitee.com_zoomdy_RV-LINK]  
最新的文档请访问：[https://gitee.com/zoomdy/RV-LINK/wikis][https_gitee.com_zoomdy_RV-LINK_wikis]，这里的内容可能没有及时更新。

## 前期准备 ##

按照[《GDB 使用 RV-LINK 仿真器调试 RISC-V 程序》][GDB _ RV-LINK _ RISC-V]准备好 RV-LINK，GDB，安装好 USB 驱动。

## Eclipse ##

假设使用 Eclipse CDT + GNU MCU Eclipse 插件（可以通过 Eclipse Marketplace 安装），如果是 Windows，那么还需要 [GNU MCU Eclipse Windows Build Tools][]。

## 创建调试配置 ##

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pvb21keQ_size_16_color_FFFFFF_t_70]

*  新建 GDB Hardware Debugging 类调试配置，
 *  Debugger 标签页的 GDB Command 填入 `riscv-none-embed-gdb -ex "set arch riscv:rv32"`，riscv-none-embed-gdb 所在的路径一定要加到 PATH 环境变量，否则找不到程序; `-ex "set arch riscv:rv32"`是必须设置的，否则报告错误`bfd requires xlen 8, but target has xlen 4`
 *  JTAG Device 选择 `Generic Serial`，
 *  GDB Connection String 填入 RV-LINK 串口号，Windows 填入 com3、com4 等，Linux 填入 /dev/ttyACM0、/dev/ttyACM1 等。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pvb21keQ_size_16_color_FFFFFF_t_70 1]

*  Startup 标签页的 Reset and Delay 和 Halt 选项勾上，这两个选项没勾，可能会导致 Flash 下载失败。
 *  Set brekpoint at 选项勾上，输入框填入 `main`，将在 main 函数停下来。
 *  Resume 选项勾上。

以上是典型配置，可以按需求修改配置。

点击 Debug 按钮就可以开始调试了，下载程序时，进度停留在 94%，如下图所示：  
![在这里插入图片描述][2019092722450883.png]  
其它 Eclipse 窗口可能处于卡顿状态，等程序下载完成后就会恢复正常，这确实不太友好。

> 注意：在进度停留在 94% ，即下载程序期间，不要去点击调试按钮。这段时间就静静地做个美男子（美女子）吧！不会很长，GD32VF103 的 Flash 下载速度约 4KB/s。

## 常见的错误 ##

### No such file or directory ###

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pvb21keQ_size_16_color_FFFFFF_t_70 2]

Error message from debugger back end:
    com3: No such file or directory.

可能的原因有：

*  串口号错误，通过设备管理器查看正确的串口号，如果设备管理器没有看到串口，那么检查 RV-LINK 是否正确连接，USB 串口驱动是否正确安装。
 *  串口被占用，串口被其它程序占用，比如已经打开了一个调试进程，又打开同样的调试进程就会报这个错误。
 *  如果在虚拟机里跑，检查一下有没有将 USB 串口映射到虚拟机里。

### the target is not connected ###

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pvb21keQ_size_16_color_FFFFFF_t_70 3]

Error message from debugger back end:
    Remote replied unexpectedly to 'vMustReplyEmpty': 
    RV-LINK ERROR: the target is not connected!
    RV-LINK: Longan Nano, configed for GD32VF103 family.

可能的原因有：

*  目标板没有上电，检查目标板的电源。
 *  JTAG 连线有问题，检查 JTAG 连线，任何一根线有短路或断路，都无法连接上。

### the target is not supported ###

Error message from debugger back end:
    Remote replied unexpectedly to 'vMustReplyEmpty': 
    RV-LINK ERROR: the target is not supported, upgrade RV-LINK firmware!
    RV-LINK: Longan Nano, configed for GD32VF103 family.

可能的原因有：

*  所连接的目标 MCU 不被当前的 RV-LINK 支持，例如当前 RV-LINK 配置成支持 GD32VF103，而实际连接的是 K210，就会报告这个错误。需要更换 RV-LINK 固件，如果目标 MCU 还没有被 RV-LINK 支持，那么需要在 RV-LINK 中添加对该 MCU 的支持。

[https_blog.csdn.net_zoomdy_article_details_101565649]: https://blog.csdn.net/zoomdy/article/details/101565649
[https_gitee.com_zoomdy_RV-LINK]: https://gitee.com/zoomdy/RV-LINK
[https_gitee.com_zoomdy_RV-LINK_wikis]: https://gitee.com/zoomdy/RV-LINK/wikis
[GDB _ RV-LINK _ RISC-V]: https://blog.csdn.net/zoomdy/article/details/101456186
[GNU MCU Eclipse Windows Build Tools]: https://gnu-mcu-eclipse.github.io/windows-build-tools/releases/
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pvb21keQ_size_16_color_FFFFFF_t_70]: /images/20230810/b0a2290bb9e84ac18f036a0a3dfa5107.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pvb21keQ_size_16_color_FFFFFF_t_70 1]: /images/20230810/b626fc9656c847c3becf33ab6c7c7381.png
[2019092722450883.png]: /images/20230810/310a8f69be1b4999886c9b3df96f5836.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pvb21keQ_size_16_color_FFFFFF_t_70 2]: /images/20230810/1bc294d853b64aafaa17cf80a895aab2.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3pvb21keQ_size_16_color_FFFFFF_t_70 3]: /images/20230810/c188c0db5b2a44c091e989b1b2071118.png