GD32VF103C-START

Caution

This page is automatically generated from RIOT doxygen documentation. If you find any issues or have suggestions for improvement, please report them on Github.

View Doxygen Documentation View this board's documentation as generated by Doxygen.

View on GitHub View this board's source code on GitHub.

Tip

When using this board with RIOT, set the BOARD variable to gd32vf103c-start in your Makefile. If you follow the standard RIOT project structure, your Makefile should look like this:

./Makefile

# name of your application
APPLICATION = hello-world

# Change this to your board if you want to build for a different board
BOARD ?= gd32vf103c-start

# This has to be the absolute path to the RIOT base directory:
RIOTBASE ?= $(CURDIR)/RIOT

include $(RIOTBASE)/Makefile.include

Support for the GD32VF103C-START board @author Marian Buschsieweke

Overview

The GD32VF103C-START development board is an official starter kit by GigaDevice for the GD32VF103CBT6 MCU, despite the lack of official documentation. It featrures:

• GD32VF103CBT6 RISC-V MCU @108MHz
• On-Board GD-Link Programmer/Debugger (middle mini-USB connector)
• USB-OTG (left mini-USB connector)
• Integrated USB to UART bridge (right mini-USB connector)
• 1 user LED
• 1 user Button
• 1 reset button
• Arduino UNO compatible pin headers (except ISP header)

Warning: The analog pins are labeled A1 - A6 rather than A0 - A5, as would be the correct Arduino naming. The Arduino pin mapping uses the correct Arduino naming, so that apps written for other boards expecting Arduino UNO compatible shields remain compatible.

Hardware

MCU	GD32VF103CBT6	Supported
Family	RISC-V with ECLIC
Vendor	GigaDevice
RAM	32 KiB
Flash	128 KiB
Frequency	108 MHz
Power Modes	3 (Sleep, Deep Sleep, Standby)	yes
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	yes
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 (+ GD-Link + UART bridge)	yes
Vcc	3.0V - 3.6V
Datasheet	Datasheet
User Manual	User Manual
Board Manual	Board Manual

Flashing

Warning: Flashing seems to fail with some Arduino UNO compatible boards attached. Remove them and try again.

By default, flashing is done via OpenOCD using the GD-Link programmer/debugger using:

make BOARD=gd32vf103c-start -C path/to/app flash

It is also possible to flash via DFU-Util:

1. Connect a mini USB cable to the USB connector labeled OTG.
2. Power the board (e.g. by connecting a second mini USB cable to the GD-Link programmer/debugger, even though we won’t use it)
3. Enter the DFU bootloader by placing the jumper on JP4 (below BOOT) in position H. Press the reset button afterwards.
4. Run make BOARD=gd32vf103c-start PROGRAMMER=dfu-util -C path/to/app flash
5. Restore the JP4 jumper to position L. Afterwards press the reset button again

Connecting to the Serial Output

By default RIOT’s uses UART for stdio. To access that, connect a mini USB cable to the connector labeled “USART”. In addition a jumper needs to be placed on JP2 in the “Usart” position; otherwise RIOT’s TXD is not connected to the RXD of the integrated USB UART bridge. Afterwards just run:

make BOARD=gd32vf103c-start -C path/to/app term

Alternatively, stdio_cdc_acm can be used. In this case the mini USB cable needs to be connected to the USB connector labeled OTG.

Note: It is safe to keep the jumper at JP2 in “Usart” position or even remove the jumper with RIOT. PA9 is still used as UART/TXD and VBUS sensing is disabled anyway.