Support for the Sipeed Longan Nano board. More...
Detailed Description
Support for the Sipeed Longan Nano board.
Overview
The Sipeed Longan Nano is a development board for the GigaDevice GD32VF103CBT6 MCU with the following on-board components:
- GD32VF103CBT6 RISC-V MCU @108MHz
- USB Type C
- TF card slot
- 3 user LEDs
Hardware:
| MCU | GD32VF103CBT6 | Supported |
|---|---|---|
| Family | RISC-V with ECLIC | |
| Vendor | GigaDevice | |
| RAM | 32 kByte | |
| Flash | 128 KByte | |
| Frequency | 108 MHz | |
| Power Modes | 3 (Sleep, Deep Sleep, Standby) | no |
| GPIOs | 37 | yes |
| Timers | 5 x 16-bit timer | yes |
| RTC | 1 x 32-bit counter, 20-bit prescaler | yes |
| WDT | 2 x 12-bit counter, 3-bit prescaler | yes |
| ADC | 2 x 12-bit units, 16 channels @ 1 Msps | yes |
| DAC | 2 x 12-bit channel | no |
| UART | - | yes |
| USART | 3 | yes |
| SPI | 3 | yes |
| I2C | 2 x Fast Mode 400 kHz | yes |
| I2S | 2 | no |
| CAN | 2 x CAN 2.0B with up to 1 Mbps | no |
| PWM | 6 Channels | yes |
| USB | 1 x USB FS OTG | no |
| Vcc | 3.0V - 3.6V | |
| Datasheet | Datasheet | |
| Reference Manual | Reference Manual | |
| Board Manual | Board Manual | |
| Board Schematic | Board Schematic |
Pin Layout / Configuration
The general pin layout is shown below.
The following table shows the connection of the on-board components with the MCU pins and their configuration in RIOT.
| MCU Pin | MCU Peripheral | RIOT Peripheral | Board Function | Remark |
|---|---|---|---|---|
| PA0 | BOOT0 | BTN0 | BOOT | |
| PA1 | PWM_DEV(0) CH0 | LED1 green | ||
| PA2 | PWM_DEV(0) CH1 | LED2 blue | ||
| PA3 | ADC01_IN3 | ADC_LINE(1) | ||
| PA4 | ADC01_IN4 | ADC_LINE(6) | N/A if SPI is used | |
| PA5 | ADC01_IN5 | ADC_LINE(7) | N/A if SPI or TFT is used | |
| PA6 | ADC01_IN6 | ADC_LINE(8) | N/A if SPI is used | |
| PA7 | ADC01_IN7 | ADC_LINE(9) | N/A if SPI or TFT is used | |
| PA4 | SPI1 CS | SPI_DEV(1) CS | N/A if ADC_LINE(6) is used | |
| PA5 | SPI1 SCLK | SPI_DEV(1) SCLK | N/A if ADC_LINE(7) is used | |
| PA6 | SPI1 MISO | SPI_DEV(1) MISO | N/A if ADC_LINE(8) is used | |
| PA7 | SPI1 MOSI | SPI_DEV(1) MOSI | N/A if ADC_LINE(9) is used | |
| PA9 | USART0 TX | UART_DEV(0) TX | UART TX | |
| PA10 | USART0 RX | UART_DEV(0) RX | UART RX | |
| PB0 | ADC01_IN8 | ADC_LINE(4) | N/A if TFT is used | |
| PB1 | ADC01_IN8 | ADC_LINE(5) | N/A if TFT is used | |
| PB6 | I2C0 SCL | I2C_DEV(0) SCL | ||
| PB7 | I2C0 SDA | I2C_DEV(0) SDA | ||
| PB8 | PWM_DEV(1) CH0 | N/A if CAN is used | ||
| PB9 | PWM_DEV(1) CH1 | N/A if CAN is used | ||
| PB10 | I2C1 SCL | I2C_DEV(1) SCL | ||
| PB11 | I2C1 SDA | I2C_DEV(1) SDA | ||
| PB12 | SPI0 CS | SPI_DEV(0) CS | ||
| PB13 | SPI0 SCLK | SPI_DEV(0) SCLK | ||
| PB14 | SPI0 MISO | SPI_DEV(0) MISO | ||
| PB15 | SPI0 MOSI | SPI_DEV(0) MOSI | ||
| PC13 | LED0 red | |||
| - | ADC01_IN16 | ADC_LINE(2) | internal Temperature channel | |
| - | ADC01_IN17 | ADC_LINE(3) | internal VFEF channel |
- Note
- Since the availability of
ADC_LINE(4)toADC_LINE(9)depends on other peripheral configurations, their index may vary.
Flashing the Device
Using the DFU bootloader
The board is flashed via the in-ROM DFU bootloader by default. To enter bootloader mode, hold the BOOT0 button while pressing the RESET button.
After flashing you need to leave bootloader mode again by pressing the RESET button.
Using an external debug adapter
The board can also be flashed via a JTAG interface with OpenOCD (at least release version 0.12.0). By default, an FTDI adapter according to the configuration defined in interface/openocd-usb.cfg is assumed.
To use an FTDI adapter with a different configuration, the configuration can be defined using the variable OPENOCD_FTDI_ADAPTER, for example:
If another adapter is used, it can be specified using variable OPENOCD_DEBUG_ADAPTER, for example for a Segger J-Link adapter:
Accessing STDIO via UART
The stdio is directly accessible through the first UART interface. If an external USB-to-UART interface is used, this interface is mapped to /dev/ttyUSB<n> on a Linux host, where <n> is the index of the UART interface, which is 0 by default.
Use the term target to connect to the board using /dev/ttyUSB0:
If the UART interface index of board's USB to UART bridge is not 0, use the following command to connect:
Files | |
| file | board.h |
| Board specific definitions for the Sipeed Longan Nano board. | |
| file | gpio_params.h |
| Configuration of SAUL mapped GPIO pins. | |
| file | periph_conf.h |
| Board specific definitions for the SeeedStudio GD32 RISC-V board. | |
