# 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

- Drivers

- Wiring Connections

  - JTAG Interface

  - Serial Wire Mode Interface (SWD)

- Platforms

- Frameworks

- Boards

## 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)
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 Lite | GigaDevice GD32V | External | GD32VF103C8T6 | 108MHz | 64KB | 20KB
Wio Lite RISC-V | GigaDevice GD32V | External | GD32VF103CBT6 | 108MHz | 128KB | 32KB