1.. zephyr:board:: gd32e507v_start
2
3Overview
4********
5
6The GD32E507V-START board is a hardware platform that enables prototyping
7on GD32E507VE Cortex-M33 High Performance MCU.
8
9The GD32E507VE features a single-core ARM Cortex-M33 MCU which can run up
10to 180 MHz with flash accesses zero wait states, 512kiB of Flash, 128kiB of
11SRAM and 80 GPIOs.
12
13Hardware
14********
15
16- GD32E507VET6 MCU
17- 1 x User LEDs
18- 1 x User Push buttons
19- 1 x USART (RS-232 at J1 connector)
20- GD-Link on board programmer
21- J-Link/SWD connector
22
23For more information about the GD32E507 SoC and GD32E507V-START board:
24
25- `GigaDevice Cortex-M33 High Performance SoC Website`_
26- `GD32E507X Datasheet`_
27- `GD32E50X User Manual`_
28- `GD32E507V-START User Manual`_
29
30Supported Features
31==================
32
33The board configuration supports the following hardware features:
34
35.. list-table::
36   :header-rows: 1
37
38   * - Peripheral
39     - Kconfig option
40     - Devicetree compatible
41   * - EXTI
42     - :kconfig:option:`CONFIG_GD32_EXTI`
43     - :dtcompatible:`gd,gd32-exti`
44   * - GPIO
45     - :kconfig:option:`CONFIG_GPIO`
46     - :dtcompatible:`gd,gd32-gpio`
47   * - NVIC
48     - N/A
49     - :dtcompatible:`arm,v8m-nvic`
50   * - PWM
51     - :kconfig:option:`CONFIG_PWM`
52     - :dtcompatible:`gd,gd32-pwm`
53   * - SYSTICK
54     - N/A
55     - N/A
56   * - USART
57     - :kconfig:option:`CONFIG_SERIAL`
58     - :dtcompatible:`gd,gd32-usart`
59
60Other peripherals may be used if shields are connected to the board.
61
62Serial Port
63===========
64
65The GD32E507V-START board has one serial communication port. The default port
66is USART0 with TX connected at PB6 and RX at PB7. USART0 is exposed as a
67virtual COM port via the CN3 USB connector.
68
69Programming and Debugging
70*************************
71
72Before programming your board make sure to configure boot jumpers as
73follows:
74
75- JP3/4: Select 2-3 for both (boot from user memory)
76
77Using GD-Link or J-Link
78=======================
79
80The board comes with an embedded GD-Link programmer. It can be used with pyOCD
81provided you install the necessary CMSIS-Pack:
82
83.. code-block:: console
84
85   pyocd pack install gd32e507ve
86
87J-Link can also be used to program the board using the SWD interface exposed in
88the JP1 header.
89
90#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
91
92   .. zephyr-app-commands::
93      :zephyr-app: samples/hello_world
94      :board: gd32e507v_start
95      :goals: build
96      :compact:
97
98#. Run your favorite terminal program to listen for output. On Linux the
99   terminal should be something like ``/dev/ttyUSB0``. For example:
100
101   .. code-block:: console
102
103      minicom -D /dev/ttyUSB0 -o
104
105   The -o option tells minicom not to send the modem initialization
106   string. Connection should be configured as follows:
107
108      - Speed: 115200
109      - Data: 8 bits
110      - Parity: None
111      - Stop bits: 1
112
113#. To flash an image:
114
115   .. zephyr-app-commands::
116      :zephyr-app: samples/hello_world
117      :board: gd32e507v_start
118      :goals: flash
119      :compact:
120
121   You should see "Hello World! gd32e507v_start" in your terminal.
122
123#. To debug an image:
124
125   .. zephyr-app-commands::
126      :zephyr-app: samples/hello_world
127      :board: gd32e507v_start
128      :goals: debug
129      :compact:
130
131.. _GigaDevice Cortex-M33 High Performance SoC Website:
132   https://www.gigadevice.com/products/microcontrollers/gd32/arm-cortex-m33/high-performance-line/
133
134.. _GD32E507X Datasheet:
135   https://gd32mcu.com/download/down/document_id/252/path_type/1
136
137.. _GD32E50X User Manual:
138   https://www.gd32mcu.com/download/down/document_id/249/path_type/1
139
140.. _GD32E507V-START User Manual:
141   https://www.gd32mcu.com/data/documents/evaluationBoard/GD32E50x_Demo_Suites_V1.2.1.rar
142