# Sipeed Longan Nano Lite

Contents

- Sipeed Longan Nano Lite

  - Hardware

  - Configuration

  - Uploading

  - Debugging

  - Frameworks

## 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 | GD32VF103C8T6
Frequency | 108MHz
Flash | 64KB
RAM | 20KB
Vendor | Sipeed

## Configuration

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

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

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

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

    ; change microcontroller
    board_build.mcu = GD32VF103C8T6

    ; change MCU frequency
    board_build.f_cpu = 108000000L

## Uploading

Sipeed Longan Nano Lite 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-lite]
    platform = gd32v
    board = sipeed-longan-nano-lite

    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 Lite 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)