1.. zephyr:board:: gd32l233r_eval
2
3Overview
4********
5
6The GD32L233R-EVAL board is a hardware platform that enables design and debug
7of the GigaDevice GD32L233 Cortex-M23 Low Power MCU.
8
9The GD32RCT6 features a single-core ARM Cortex-M4F MCU which can run up
10to 64-MHz with flash accesses zero wait states, 256kB of Flash, 32kB of
11SRAM and 59 GPIOs.
12
13Hardware
14********
15
16- GD32L233RCT6 MCU
17- AT24C02C 2Kb EEPROM
18- 4 x User LEDs
19- 2 x User Push buttons
20- 1 x USART (Mini-USB)
21- 1 x POT connected to an ADC input
22- Headphone interface
23- SLCD segment code screen
24- GD-Link on board programmer
25- J-Link/SWD connector
26
27For more information about the GD32L233 SoC and GD32L233R-EVAL board:
28
29- `GigaDevice Cortex-M23 Low Power SoC Website`_
30- `GD32L233xx Datasheet`_
31- `GD32L23x User Manual`_
32- `GD32L23x Demo Suites`_
33
34Supported Features
35==================
36
37The board configuration supports the following hardware features:
38
39.. list-table::
40   :header-rows: 1
41
42   * - Peripheral
43     - Kconfig option
44     - Devicetree compatible
45   * - EXTI
46     - :kconfig:option:`CONFIG_GD32_EXTI`
47     - :dtcompatible:`gd,gd32-exti`
48   * - GPIO
49     - :kconfig:option:`CONFIG_GPIO`
50     - :dtcompatible:`gd,gd32-gpio`
51   * - NVIC
52     - N/A
53     - :dtcompatible:`arm,v8m-nvic`
54   * - SYSTICK
55     - N/A
56     - N/A
57   * - USART
58     - :kconfig:option:`CONFIG_SERIAL`
59     - :dtcompatible:`gd,gd32-usart`
60   * - PINMUX
61     - :kconfig:option:`CONFIG_PINCTRL`
62     - :dtcompatible:`gd,gd32-pinctrl-af`
63   * - ADC
64     - :kconfig:option:`CONFIG_ADC`
65     - :dtcompatible:`gd,gd32-adc`
66
67Serial Port
68===========
69
70The GD32L233R-EVAL board has one serial communication port. The default port
71is USART1 with TX connected at PA2 and RX at PA3. USART1 have connect to a
72CH04E serial connector with Mini-USB.
73
74Programming and Debugging
75*************************
76
77Using J-Link
78=============
79
80The GD32L233R-EVAL includes an onboard programmer/debugger (GD-Link) which
81allows flash programming and debugging over USB. There is also a SWD header
82which can be used with tools like Segger J-Link(latest version required).
83
84#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
85
86   .. zephyr-app-commands::
87      :zephyr-app: samples/hello_world
88      :board: gd32l233r_eval
89      :goals: build
90      :compact:
91
92#. Run your favorite terminal program to listen for output. On Linux the
93   terminal should be something like ``/dev/ttyUSB0``. For example:
94
95   .. code-block:: console
96
97      minicom -D /dev/ttyUSB0 -o
98
99   The -o option tells minicom not to send the modem initialization
100   string. Connection should be configured as follows:
101
102      - Speed: 115200
103      - Data: 8 bits
104      - Parity: None
105      - Stop bits: 1
106
107#. To flash an image:
108
109   .. zephyr-app-commands::
110      :zephyr-app: samples/hello_world
111      :board: gd32l233r_eval
112      :goals: flash
113      :compact:
114
115   You should see "Hello World! gd32l233r_eval" in your terminal.
116
117#. To debug an image:
118
119   .. zephyr-app-commands::
120      :zephyr-app: samples/hello_world
121      :board: gd32l233r_eval
122      :goals: debug
123      :compact:
124
125.. _GigaDevice Cortex-M23 Low Power SoC Website:
126   https://www.gigadevice.com/products/microcontrollers/gd32/arm-cortex-m23/low-power-line/
127
128.. _GD32L233xx Datasheet:
129   https://gd32mcu.com/download/down/document_id/289/path_type/1
130
131.. _GD32L23x User Manual:
132   https://gd32mcu.com/download/down/document_id/293/path_type/1
133
134.. _GD32L23x Demo Suites:
135   https://gd32mcu.com/download/down/document_id/292/path_type/1
136