GD32L233R-EVA

Overview

The GD32L233R-EVAL board is a hardware platform that enables design and debug of the GigaDevice GD32L233 Cortex-M23 Low Power MCU.

The GD32RCT6 features a single-core ARM Cortex-M4F MCU which can run up to 64-MHz with flash accesses zero wait states, 256kB of Flash, 32kB of SRAM and 59 GPIOs.

Hardware

GD32L233RCT6 MCU
AT24C02C 2Kb EEPROM
4 x User LEDs
2 x User Push buttons
1 x USART (Mini-USB)
1 x POT connected to an ADC input
Headphone interface
SLCD segment code screen
GD-Link on board programmer
J-Link/SWD connector

For more information about the GD32L233 SoC and GD32L233R-EVAL board:

Supported Features

The gd32l233r_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.

`gd32l233r_eval/gd32l233` target

Type	Location	Description	Compatible
CPU	on-chip	ARM Cortex-M23 CPU1	`arm,cortex-m23`
ADC	on-chip	GigaDevice GD32 ADC1	`gd,gd32-adc`
Clock control	on-chip	Gigadevice RCU - Clock Controller1	`gd,gd32-cctl`
Flash controller	on-chip	There are three types GD32 FMC1	`gd,gd32-flash-controller`
GPIO & Headers	on-chip	GD32 GPIO5	`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`
Interrupt controller	on-chip	GigaDevice External Interrupt Controller1	`gd,gd32-exti`
LED	on-board	Group of GPIO-controlled LEDs1	`gpio-leds`
Multi-Function Device	on-chip	Gigadevice RCU1	`gd,gd32-rcu`
Miscellaneous	on-chip	GigaDevice GD32 System Configuration Registers1	`gd,gd32-syscfg`
MTD	on-chip	Flash memory binding of GD32 FMC v11	`gd,gd32-nv-flash-v1`
Pin control	on-chip	GD32 Pin Controller (AF Model)1	`gd,gd32-pinctrl-af`
Reset controller	on-chip	Gigadevice RCU - Reset Controller1	`gd,gd32-rctl`
Serial controller	on-chip	GigaDevice USART1 3	`gd,gd32-usart`
SRAM	on-chip	Generic on-chip SRAM2	`mmio-sram`
Timer	on-chip	ARMv8-M System Tick1	`arm,armv8m-systick`

Serial Port

The GD32L233R-EVAL board has one serial communication port. The default port is USART1 with TX connected at PA2 and RX at PA3. USART1 have connect to a CH04E serial connector with Mini-USB.

Programming and Debugging

The gd32l233r_eval board supports the runners and associated west commands listed below.

	flash	debug	attach	rtt	debugserver
jlink	✅ (default)	✅ (default)	✅	✅	✅

Using J-Link

The GD32L233R-EVAL includes an onboard programmer/debugger (GD-Link) which allows flash programming and debugging over USB. There is also a SWD header which can be used with tools like Segger J-Link(latest version required).

Build the Zephyr kernel and the Hello World sample application:
```
west build -b gd32l233r_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 gd32l233r_eval samples/hello_world
west flash
```
You should see “Hello World! gd32l233r_eval” in your terminal.

To debug an image:

west build -b gd32l233r_eval samples/hello_world
west debug