PlatformIO
latest
  • What is PlatformIO?

Getting Started

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

Configuration

  • platformio.ini
  • Environment variables
  • Advanced Scripting

Instruments

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

Professional

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

Integration

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

Miscellaneous

  • Articles about us
  • FAQ
  • Release Notes
  • Migrating from 4.x to 5.0
PlatformIO
  • Docs »
  • Debugging »
  • GD-LINK
  • Edit on GitHub

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) 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
Next Previous

© Copyright 2014-present, PlatformIO Revision 21886517.

Built with Sphinx using a theme provided by Read the Docs.
Read the Docs v: latest
Versions
latest
stable
v5.1.0
v5.0.4
v5.0.3
v5.0.2
v5.0.1
v4.3.4
Downloads
pdf
On Read the Docs
Project Home
Builds

Free document hosting provided by Read the Docs.