GD-LINK¶
GD-Link adapter is a three-in-one multi-function development tool for GD32 series of MCUs. It provides CMSIS-DAP debugger port with JTAG/SWD interface. Official reference can be found here.
Contents
Configuration¶
You can configure debugging tool using debug_tool option in “platformio.ini” (Project Configuration File):
[env:myenv]
platform = ...
board = ...
debug_tool = gd-link
If you would like to use this tool for firmware uploading, please change upload protocol:
[env:myenv]
platform = ...
board = ...
debug_tool = gd-link
upload_protocol = gd-link
More options:
Drivers¶
| Windows: | Check vendor recommendations. |
|---|---|
| Mac: | Not required. |
| Linux: | Please install “udev” rules 99-platformio-udev.rules. If you already installed them before, please check that your rules are up-to-date or repeat steps. |
Wiring Connections¶
JTAG Interface¶
| GD-Link JTAG 20-Pin Connector | Board JTAG Pin | Description |
|---|---|---|
| +3V3 | VCC | Positive Supply Voltage — Power supply for JTAG interface drivers |
| TMS/IO | TMS | Test Mode State pin |
| TCK/CLK | TCK | JTAG Return Test Clock |
| TDO/SWO | TDO | Test Data Out pin |
| TDI | TDI | Test Data In pin |
| GDN | GND | Digital ground |
| TReset | RESET | Connect this pin to the (active low) reset input of the target CPU |
Serial Wire Mode Interface (SWD)¶
| GD-Link SWD 20-Pin Connector | Board SWD Pin | Description |
|---|---|---|
| +3V3 | VCC | Positive Supply Voltage — Power supply for JTAG interface drivers |
| GND | GND | Digital ground |
| TMS/IO | SWDIO | Data I/O |
| TCK/CLK | SWCLK | Clock |
| TReset | RESET | Connect this pin to the (active low) reset input of the target CPU |
Platforms¶
| Name | Description |
|---|---|
| GigaDevice GD32V | The GigaDevice GD32V device is a 32-bit general-purpose microcontroller based on the RISC-V core with an impressive balance of processing power, reduced power consumption and peripheral set. |
| Nuclei | Find professional RISC-V Processor IP in Nuclei, first professional RISC-V IP company in Mainland China, match all your requirements in AIoT Era. |
Frameworks¶
| Name | Description |
|---|---|
| Arduino | Arduino Wiring-based Framework allows writing cross-platform software to control devices attached to a wide range of Arduino boards to create all kinds of creative coding, interactive objects, spaces or physical experiences |
| GigaDevice GD32V SDK | GigaDevice GD32VF103 Firmware Library (SDK) is a firmware function package, including programs, data structures and macro definitions, all the performance features of peripherals of GD32VF103 devices are involved in the package |
| Nuclei SDK | Open Source Software Development Kit for the Nuclei N/NX processors |
Boards¶
Note
For more detailed board information please scroll tables below by horizontal.
| Name | Platform | Debug | MCU | Frequency | Flash | RAM |
|---|---|---|---|---|---|---|
| GD32VF103V Evaluation Kit | Nuclei | External | GD32VF103VBT6 | 108MHz | 128KB | 32KB |
| GD32VF103V RVStar Kit | Nuclei | On-board | GD32VF103VBT6 | 108MHz | 128KB | 32KB |
| GD32VF103V-EVAL | GigaDevice GD32V | External | GD32VF103VBT6 | 108MHz | 128KB | 32KB |
| Sipeed Longan Nano | GigaDevice GD32V | External | GD32VF103CBT6 | 108MHz | 128KB | 32KB |
| Sipeed Longan Nano | Nuclei | External | GD32VF103CBT6 | 108MHz | 128KB | 32KB |
| Sipeed Longan Nano Lite | GigaDevice GD32V | External | GD32VF103C8T6 | 108MHz | 64KB | 20KB |
| Wio Lite RISC-V | GigaDevice GD32V | External | GD32VF103CBT6 | 108MHz | 128KB | 32KB |