GD32F527I-EVAL
Overview
The GD32F527I-EVAL board is a hardware platform for prototyping with the GigaDevice GD32F527IS Cortex-M33F MCU.
The Zephyr board configuration enables the GD32F527IS SoC, USART0 console, GPIO, LEDs, user keys, pin control, clock control, and CKOUT0 clock output.
Hardware
The following hardware is described by the current Zephyr board files:
GD32F527IS MCU
512 KiB SRAM
25 MHz HXTAL and PLL, with a 200 MHz system clock
LED1 to LED4 connected to PF7, PF8, PE3, and PE2
WAKEUP key on PA0, TAMPER key on PC13, and USER key on PB14
USART0 console with TX on PA9 and RX on PA10
CKOUT0 output on PA8, sourced from PLLP and divided by 4
Supported Features
The gd32f527i_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.
gd32f527i_eval/gd32f527 target
On-target memory for this board target: 512 KiB of RAM, 4 MiB of Flash.
Type |
Location |
Description |
Compatible |
|---|---|---|---|
CPU |
on-chip |
ARM Cortex-M33F CPU1 |
|
ADC |
on-chip |
GigaDevice GD32 ADC3 |
|
Clock control |
on-chip |
GigaDevice GD32 CKOUT clock output1 |
|
on-chip |
GigaDevice GD32F527 RCU Clock Tree Configuration1 |
||
on-chip |
Gigadevice RCU - Clock Controller1 |
||
on-chip |
Generic fixed-rate clock provider1 |
||
on-chip |
GigaDevice GD32 HXTAL External Crystal Clock1 |
||
on-chip |
GigaDevice GD32 Main PLL Clock1 |
||
Counter |
on-chip |
GigaDevice GD32 timer14 |
|
DAC |
on-chip |
GigaDevice GD32 series DAC module1 |
|
DMA |
on-chip |
GD32 DMA controller with FIFO2 |
|
Flash controller |
on-chip |
GD32F527 flash controller1 |
|
GPIO & Headers |
on-chip |
||
Input |
on-board |
Group of GPIO-bound input keys1 |
|
Interrupt controller |
on-chip |
ARMv8-M NVIC (Nested Vectored Interrupt Controller)1 |
|
on-chip |
GigaDevice External Interrupt Controller1 |
||
LED |
on-board |
Group of GPIO-controlled LEDs1 |
|
Miscellaneous |
on-chip |
GigaDevice GD32 System Configuration Registers1 |
|
MMU / MPU |
on-chip |
ARMv8-M MPU (Memory Protection Unit)1 |
|
MTD |
on-chip |
GD32 flash memory2 |
|
Pin control |
on-chip |
GD32 Pin Controller (AF Model)1 |
|
PWM |
on-chip |
GigaDevice GD32 PWM12 |
|
Reset controller |
on-chip |
Gigadevice RCU - Reset Controller1 |
|
Serial controller |
on-chip |
||
SPI |
on-chip |
GigaDevice GD32 SPI6 |
|
SRAM |
on-chip |
Generic on-chip SRAM2 |
|
Timer |
on-chip |
ARMv8-M System Tick1 |
|
Watchdog |
on-chip |
GD32 window watchdog timer1 |
|
on-chip |
GD32 free watchdog timer1 |
Clock Configuration
The 25 MHz HXTAL feeds the PLL, which generates a 200 MHz system clock. The AHB prescaler is 1, the APB1 prescaler is 4, and the APB2 prescaler is 2.
Default Zephyr Peripheral Mapping
LED1 to LED4: PF7, PF8, PE3, PE2 (aliases
led0toled3)USER key: PB14 (alias
sw0)TAMPER key: PC13 (alias
sw1)WAKEUP key: PA0 (alias
sw2)USART0 TX/RX: PA9/PA10
CKOUT0: PA8
Serial Port
The default serial console is USART0. The board pin control configuration connects USART0 TX to PA9 and USART0 RX to PA10. The default baud rate is 115200 bit/s.
Programming and Debugging
The gd32f527i_eval board supports the runners and associated west commands listed below.
| flash | debug | rtt | reset | attach | debugserver | |
|---|---|---|---|---|---|---|
| jlink | ✅ (default) | ✅ (default) | ✅ | ✅ | ✅ | ✅ |
| pyocd | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
west flash and west debug use J-Link by default with the GD32F527IS
device. Connect a J-Link probe to the SWD header of the board.
pyOCD can be used as an alternative runner. The GD32F527 DFP pack is not
included in the GigaDevice HAL module. Download
GigaDevice.GD32F527_DFP.1.4.0.pack from the GD32 MCU website
(https://www.gd32mcu.com) and copy it to
modules/hal/gigadevice/gd32f527/support/, which is where the board
runner configuration looks for it. Then install pyOCD, connect a GD-Link or
other CMSIS-DAP probe, and select the runner explicitly:
west flash --runner pyocd
west debug --runner pyocd
Build the Zephyr kernel and the Hello World sample application:
west build -b gd32f527i_eval samples/hello_world
Run your favorite terminal program to listen for output. On Linux the terminal
should be something like /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 gd32f527i_eval samples/hello_world
west flash
You should see “Hello World! gd32f527i_eval” in your terminal.
To debug an image:
west build -b gd32f527i_eval samples/hello_world
west debug