• Documentation
  • PlatformIO
  • v4.2.1
PlatformIO
v4.2.1
  • What is PlatformIO?

Getting Started

  • PlatformIO IDE
  • PlatformIO Core (CLI)
  • PlatformIO Home
  • Tutorials and Examples

Configuration

  • platformio.ini
  • Environment variables
  • Advanced Scripting

Instruments

  • Library Manager
  • Platforms
  • Frameworks
  • Boards
  • Custom Platform & Board

PIO Plus

  • PIO Account
  • PIO Check
  • PIO Remote
  • PIO Unified Debugger
    • Tutorials
    • Configuration
    • Tools & Debug Probes
      • Altera / Intel USB-Blaster Download Cable
      • Atmel-ICE
      • Black Magic Probe
      • CMSIS-DAP
      • ESP-Prog
      • FTDI Chip
      • GD-LINK
        • Configuration
        • Drivers
        • Wiring Connections
        • Platforms
        • Frameworks
        • Boards
      • oddWires IOT-Bus JTAG
      • J-LINK
      • Mini-Module FT2232H
      • MSP Debug
      • Olimex ARM-USB-OCD-H
      • Olimex ARM-USB-OCD
      • Olimex ARM-USB-TINY-H
      • Olimex ARM-USB-TINY
      • QEMU
      • RV-LINK
      • Sipeed RV Debugger
      • ST-LINK
      • TI-ICDI
      • TIAO USB Multi-Protocol Adapter (TUMPA)
      • UM232H
      • Custom
    • CLI Guide
    • Platforms
    • Frameworks
    • Boards
  • PIO Unit Testing

Integration

  • Cloud & Desktop IDE
  • Continuous Integration

Miscellaneous

  • Articles about us
  • FAQ
  • Migrating from 3.x to 4.0

GD-LINK¶

../../../_images/gd-link.jpg

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