• Documentation
  • PlatformIO
  • v6.0.0
PlatformIO
v6.0.0
  • What is PlatformIO?

Getting Started

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

Configuration

  • platformio.ini
  • Build Configurations
  • Environment variables

Instruments

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

Advanced

  • Scripting
  • Debugging
    • Tutorials
    • Configuration
    • Tools & Debug Probes
      • Altera / Intel USB-Blaster
      • Atmel-ICE
      • avr-stub
      • Black Magic Probe
      • CMSIS-DAP
      • JTAG-HS1
      • JTAG-HS2
      • 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
      • OVPsim
      • QEMU
      • Raspberry Pi SWD
      • Renode
      • RV-LINK
      • simavr
      • Sipeed RV Debugger
      • ST-LINK
      • TI-ICDI
      • TIAO USB Multi-Protocol Adapter (TUMPA)
      • UM232H
      • Verilator
      • Whisper
      • Custom
    • Debug Unit Tests
    • CLI Guide
    • Platforms
    • Frameworks
    • Boards
  • Unit Testing
  • Static Code Analysis
  • Remote Development

Integration

  • Cloud & Desktop IDE
  • Continuous Integration
  • Compilation database compile_commands.json

Miscellaneous

  • FAQ
  • Migrating from 5.x to 6.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.

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

Boards¶

Note

For more detailed board information please scroll tables below by horizontal.

Name

Platform

Debug

MCU

Frequency

Flash

RAM

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