GD32E103V-EVAL

Overview

The GD32E103V-EVAL board is a hardware platform that enables design and debug of the GigaDevice E103 Cortex-M4F High Performance MCU.

The GD32E103VB features a single-core ARM Cortex-M4F MCU which can run up to 120-MHz with flash accesses zero wait states, 128kiB of Flash, 32kiB of SRAM and 80 GPIOs.

Hardware

USB interface with mini-USB connector
4 user LEDs
4 user push buttons
Reset Button
ADC connected to a potentiometer
2 DAC channels
GD25Q16 2Mib SPI Flash
AT24C02C 2KiB EEPROM
3.2 TFT LCD (320x240)
PCM1770 Stereo DAC with Headphone Amplifier
GD-Link interface
- CMSIS-DAP swd debug interface over USB HID.
2 CAN FD ports
- This function is not available in this board due to hardware issues, please check GD32C103 .

For more information about the GD32E103 SoC and GD32E103V-EVAL board:

Supported Features

The gd32e103v_eval board supports the hardware features listed below.

on-chip / on-board: Feature integrated in the SoC / present on the board.
2 / 2: Number of instances that are enabled / disabled.
Click on the label to see the first instance of this feature in the board/SoC DTS files.
vnd,foo: Compatible string for the Devicetree binding matching the feature.
Click on the link to view the binding documentation.

`gd32e103v_eval/gd32e103` target

Type	Location	Description	Compatible
CPU	on-chip	ARM Cortex-M4F CPU1	`arm,cortex-m4f`
Clock control	on-chip	Gigadevice Reset and Clock Unit (RCU) if a multi-function peripheral in charge of reset control (RCTL) and clock control (CCTL) for all SoC peripherals1	`gd,gd32-cctl`
Counter	on-chip	GigaDevice GD32 timer1 13	`gd,gd32-timer`
DAC	on-chip	GigaDevice GD32 series DAC module1	`gd,gd32-dac`
DMA	on-chip	GD32 DMA controller2	`gd,gd32-dma`
Flash controller	on-chip	There are three types GD32 FMC1	`gd,gd32-flash-controller`
GPIO & Headers	on-chip	GD32 GPIO5	`gd,gd32-gpio`
I2C	on-chip	GigiDevice GD32 I2C1 1	`gd,gd32-i2c`
Input	on-board	Group of GPIO-bound input keys1	`gpio-keys`
Interrupt controller	on-chip	ARMv7-M NVIC (Nested Vectored Interrupt Controller)1	`arm,v7m-nvic`
Interrupt controller	on-chip	GigaDevice External Interrupt Controller1	`gd,gd32-exti`
LED	on-board	Group of GPIO-controlled LEDs1	`gpio-leds`
LED	on-board	Group of PWM-controlled LEDs1	`pwm-leds`
Multi-Function Device	on-chip	Gigadevice Reset and Clock Unit (RCU) if a multi-function peripheral in charge of reset control (RCTL) and clock control (CCTL) for all SoC peripherals1	`gd,gd32-rcu`
MTD	on-chip	Flash memory binding of GD32 FMC v11	`gd,gd32-nv-flash-v1`
MTD	on-board	I2C EEPROMs compatible with Atmel’s AT24 family1	`atmel,at24`
Pin control	on-chip	The AFIO peripheral is used to configure pin remapping, EXTI sources and, when available, enable the I/O compensation cell1	`gd,gd32-afio`
Pin control	on-chip	The GD32 pin controller (AFIO model) is a singleton node responsible for controlling pin function selection and pin properties1	`gd,gd32-pinctrl-afio`
PWM	on-chip	GigaDevice GD32 PWM1 11	`gd,gd32-pwm`
Reset controller	on-chip	Gigadevice Reset and Clock Unit (RCU) if a multi-function peripheral in charge of reset control (RCTL) and clock control (CCTL) for all SoC peripherals1	`gd,gd32-rctl`
Serial controller	on-chip	GigaDevice USART1 4	`gd,gd32-usart`
SRAM	on-chip	Generic on-chip SRAM description1	`mmio-sram`
Timer	on-chip	ARMv7-M System Tick1	`arm,armv7m-systick`
Watchdog	on-chip	GD32 free watchdog timer1	`gd,gd32-fwdgt`
Watchdog	on-chip	GD32 window watchdog timer1	`gd,gd32-wwdgt`

Serial Port

The GD32E103V-EVAL board has 5 serial communication ports. The default port is UART0 at PIN-9 and PIN-10.

Programming and Debugging

Before program your board make sure to configure boot setting and serial port. The default serial port is USART0. This port uses header JP-5/6 to route signals between USB VBUS/ID and USART J2.

Boot-0	Boot-1	Function
1-2	1-2	SRAM
1-2	2-3	Bootloader
2-3	Any	Flash

JP-5	JP-6	Function
1-2	1-2	USART0 / J2
2-3	2-3	USB VBUS/ID
open	open	Free

Using GD-Link

The GD32E103V-EVAL includes an onboard programmer/debugger (GD-Link) which allow flash programming and debug over USB. There are also program and debug headers J1 and J100 that can be used with any ARM compatible tools.

Build the Zephyr kernel and the Hello World sample application:
```
west build -b gd32e103v_eval samples/hello_world
```
Run your favorite terminal program to listen for output. Under Linux the terminal should be /dev/ttyUSB0. For example:
```
$ minicom -D /dev/ttyUSB0 -o
```
The -o option tells minicom not to send the modem initialization string. Connection should be configured as follows:
- Speed: 115200
- Data: 8 bits
- Parity: None
- Stop bits: 1
To flash an image:
```
west build -b gd32e103v_eval samples/hello_world
west flash
```
You should see “Hello World! gd32e103v_eval” in your terminal.

To debug an image:

west build -b gd32e103v_eval samples/hello_world
west debug

Using ROM bootloader

The GD32E103 MCU have a ROM bootloader which allow flash programming. User should install GD32 ISP Console software at some Linux path. The recommended is $HOME/.local/bin.

Build the Zephyr kernel and the Hello World sample application:
```
west build -b gd32e103v_eval samples/hello_world
```
Enable board bootloader:
- Remove boot-0 jumper
- press reset button

To flash an image:

west build -b gd32e103v_eval samples/hello_world
west flash -r gd32isp [--port=/dev/ttyUSB0]

Run your favorite terminal program to listen for output. Under Linux the terminal should be /dev/ttyUSB0. For example:
```
$ minicom -D /dev/ttyUSB0 -o
```
The -o option tells minicom not to send the modem initialization string. Connection should be configured as follows:
- Speed: 115200
- Data: 8 bits
- Parity: None
- Stop bits: 1
Press reset button

You should see “Hello World! gd32e103v_eval” in your terminal.