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

arm,cortex-m33f

ADC

on-chip

GigaDevice GD32 ADC3

gd,gd32-adc

Clock control

on-chip

GigaDevice GD32 CKOUT clock output1

gd,gd32-clock-ckout

on-chip

GigaDevice GD32F527 RCU Clock Tree Configuration1

gd,gd32f527-rcu

on-chip

Gigadevice RCU - Clock Controller1

gd,gd32-cctl

on-chip

Generic fixed-rate clock provider1

fixed-clock

on-chip

GigaDevice GD32 HXTAL External Crystal Clock1

gd,gd32-hxtal-clock

on-chip

GigaDevice GD32 Main PLL Clock1

gd,gd32-pll-clock

Counter

on-chip

GigaDevice GD32 timer14

gd,gd32-timer

DAC

on-chip

GigaDevice GD32 series DAC module1

gd,gd32-dac

DMA

on-chip

GD32 DMA controller with FIFO2

gd,gd32-dma-v1

Flash controller

on-chip

GD32F527 flash controller1

gd,gd32f527-flash-controller

GPIO & Headers

on-chip

GD32 GPIO81

gd,gd32-gpio

Input

on-board

Group of GPIO-bound input keys1

gpio-keys

Interrupt controller

on-chip

ARMv8-M NVIC (Nested Vectored Interrupt Controller)1

arm,v8m-nvic

on-chip

GigaDevice External Interrupt Controller1

gd,gd32-exti

LED

on-board

Group of GPIO-controlled LEDs1

gpio-leds

Miscellaneous

on-chip

GigaDevice GD32 System Configuration Registers1

gd,gd32-syscfg

MMU / MPU

on-chip

ARMv8-M MPU (Memory Protection Unit)1

arm,armv8m-mpu

MTD

on-chip

GD32 flash memory2

gd,gd32-nv-flash

Pin control

on-chip

GD32 Pin Controller (AF Model)1

gd,gd32-pinctrl-af

PWM

on-chip

GigaDevice GD32 PWM12

gd,gd32-pwm

Reset controller

on-chip

Gigadevice RCU - Reset Controller1

gd,gd32-rctl

Serial controller

on-chip

GigaDevice USART17

gd,gd32-usart

SPI

on-chip

GigaDevice GD32 SPI6

gd,gd32-spi

SRAM

on-chip

Generic on-chip SRAM2

mmio-sram

Timer

on-chip

ARMv8-M System Tick1

arm,armv8m-systick

Watchdog

on-chip

GD32 window watchdog timer1

gd,gd32-wwdgt

on-chip

GD32 free watchdog timer1

gd,gd32-fwdgt

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 led0 to led3)

  • 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