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