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