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.

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:

• Debugging options

• Upload 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