Using RV-LINK

1. What is RV-LINK

RV-LINK is a simulation-based firmware development board RISC-V, by programming RV-LINK firmware can be Sipeed Longan Nano development board into a jtagdebugger for debugging another piece Longan or other development support jtag debugging board. RV-LINK project address: https://gitee.com/zoomdy/RV-LINK

2. Burn RV-LINK firmware

2.1. Using the PlatformIO project to burn a key

• Download RV-LINK source code

  Project source code download address: http://dl.sipeed.com/LONGAN/Nano/Tools/RV-LINK-pio-src-v0.1.zip

  It can also be downloaded from the official RV-LINK project: https://gitee.com/zoomdy/RV-LINK

• Open the project directory with VSCODE

  Extract the source code downloaded above into a separate folder and open the source folder using VSCODE

  As shown below:

  The firmware is usually burned using the DFU method, and the configuration file does not need to be modified.

  If you need to change the programming mode, you can modify platformio.ini to modify the file, please refer to the specific configuration:modify the project configuration file

• Burn firmware with PIO

  After connecting the development board, after the development board enters the burning mode, click the arrow symbol in the lower left corner to burn.

  After the programming is successful, you can see the green light flashing on the development board. After connecting the development board to the USB port of the computer, you can see that there is one more serial device in the device manager. At this point the Longan board successfully became the RV-LINK debugger.

2.2. Other burning methods

Reference Document: Turning the Longan Nano Development Board into a RISC-V Emulator

3. Debugging with RV-LINK

3.1. Connecting the development board

Connect the development board that brushes the RV-LINK firmware to the jtag of the development board to be debugged.

3.2. Using RV-LINK in the PlatformIO IDE

RV-LINK in the PlatformIO IDE can support one-button boot debugging just like any other debugger.

Only in the project platformio.ini configuration file, specify the debug options and debug port option.

Sample code

[env:sipeed-longan-nano]
platform = gd32v
framework = gd32vf103-sdk
board = sipeed-longan-nano
monitor_speed = 115200
upload_protocol = rv-link ; rv-link download option
debug_tool = rv-link ; rv-link debug option
debug_port = COM2    ;  Required with rv-link Required debugger serial port

3.3. Using RV-LINK on other platforms

Reference RV-LINK WIKI