Sipeed Longan Nano

Hardware

Platform 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.

Microcontroller GD32VF103CBT6
Frequency 108MHz
Flash 128KB
RAM 32KB
Vendor Sipeed

Configuration

Please use sipeed-longan-nano ID for board option in “platformio.ini” (Project Configuration File):

[env:sipeed-longan-nano]
platform = gd32v
board = sipeed-longan-nano

You can override default Sipeed Longan Nano settings per build environment using board_*** option, where *** is a JSON object path from board manifest sipeed-longan-nano.json. For example, board_build.mcu, board_build.f_cpu, etc.

[env:sipeed-longan-nano]
platform = gd32v
board = sipeed-longan-nano

; change microcontroller
board_build.mcu = GD32VF103CBT6

; change MCU frequency
board_build.f_cpu = 108000000L

Uploading

Sipeed Longan Nano supports the next uploading protocols:

  • altera-usb-blaster
  • gd-link
  • jlink
  • rv-link
  • serial
  • sipeed-rv-debugger
  • um232h

Default protocol is serial

You can change upload protocol using upload_protocol option:

[env:sipeed-longan-nano]
platform = gd32v
board = sipeed-longan-nano

upload_protocol = serial

Debugging

PIO Unified Debugger - “1-click” solution for debugging with a zero configuration.

Warning

You will need to install debug tool drivers depending on your system. Please click on compatible debug tool below for the further instructions and configuration information.

You can switch between debugging Tools & Debug Probes using debug_tool option in “platformio.ini” (Project Configuration File).

Sipeed Longan Nano does not have on-board debug probe and IS NOT READY for debugging. You will need to use/buy one of external probe listed below.

Compatible Tools On-board Default
Altera / Intel USB-Blaster Download Cable   Yes
GD-LINK    
J-LINK    
RV-LINK    
Sipeed RV Debugger    
UM232H    

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)