1.. _gd32e507z_eval:
2
3GigaDevice GD32E507Z-EVAL
4#########################
5
6Overview
7********
8
9The GD32E507Z-EVAL board is a hardware platform that enables prototyping
10on GD32E507ZE Cortex-M33 High Performance MCU.
11
12The GD32E507ZE 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 112 GPIOs.
15
16.. image:: img/gd32e507z_eval.webp
17     :align: center
18     :alt: gd32e507z_eval
19
20Hardware
21********
22
23- GD32E507ZET6 MCU
24- AT24C02C 2Kb EEPROM
25- GD25Q16 16Mbit SPI and QSPI NOR Flash
26- GD9FU1G8F2A 1Gbit NAND Flash
27- Micron MT48LC16M16A2P-6AIT 256Mbit SDRAM
28- 4 x User LEDs
29- 1 x Joystick (L/R/U/D/C)
30- 1 x USART (connected to USB VCOM at J1 connector)
31- 1 x POT connected to an ADC input
32- Headphone interface
33- USB FS connector
34- 1 x CAN (includes SN65HVD230 PHY)
35- Ethernet Interface
36- 3.2" RGB-LCD (320x240)
37- GD-Link on board programmer
38- J-Link/JTAG connector
39
40For more information about the GD32E507 SoC and GD32E507Z-EVAL board:
41
42- `GigaDevice Cortex-M33 High Performance SoC Website`_
43- `GD32E507X Datasheet`_
44- `GD32E50X User Manual`_
45- `GD32E507Z-EVAL User Manual`_
46
47Supported Features
48==================
49
50The board configuration supports the following hardware features:
51
52.. list-table::
53   :header-rows: 1
54
55   * - Peripheral
56     - Kconfig option
57     - Devicetree compatible
58   * - EXTI
59     - :kconfig:option:`CONFIG_GD32_EXTI`
60     - :dtcompatible:`gd,gd32-exti`
61   * - GPIO
62     - :kconfig:option:`CONFIG_GPIO`
63     - :dtcompatible:`gd,gd32-gpio`
64   * - NVIC
65     - N/A
66     - :dtcompatible:`arm,v8m-nvic`
67   * - PWM
68     - :kconfig:option:`CONFIG_PWM`
69     - :dtcompatible:`gd,gd32-pwm`
70   * - SYSTICK
71     - N/A
72     - N/A
73   * - USART
74     - :kconfig:option:`CONFIG_SERIAL`
75     - :dtcompatible:`gd,gd32-usart`
76
77Serial Port
78===========
79
80The GD32E507Z-EVAL board has one serial communication port. The default port
81is USART0 with TX connected at PA9 and RX at PA10. USART0 is exposed as a
82virtual COM port via the J1 USB connector.
83
84Programming and Debugging
85*************************
86
87Before programming your board make sure to configure boot jumpers as
88follows:
89
90- JP3/4: Select 2-3 for both (boot from user memory)
91
92Using GD-Link or J-Link
93=======================
94
95The board comes with an embedded GD-Link programmer. It can be used with pyOCD
96provided you install the necessary CMSIS-Pack:
97
98.. code-block:: console
99
100   pyocd pack install gd32e507ze
101
102J-Link can also be used to program the board using the JTAG interface exposed in
103the JP2 header.
104
105#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
106
107   .. zephyr-app-commands::
108      :zephyr-app: samples/hello_world
109      :board: gd32e507z_eval
110      :goals: build
111      :compact:
112
113#. Run your favorite terminal program to listen for output. On Linux the
114   terminal should be something like ``/dev/ttyUSB0``. For example:
115
116   .. code-block:: console
117
118      minicom -D /dev/ttyUSB0 -o
119
120   The -o option tells minicom not to send the modem initialization
121   string. Connection should be configured as follows:
122
123      - Speed: 115200
124      - Data: 8 bits
125      - Parity: None
126      - Stop bits: 1
127
128#. To flash an image:
129
130   .. zephyr-app-commands::
131      :zephyr-app: samples/hello_world
132      :board: gd32e507z_eval
133      :goals: flash
134      :compact:
135
136   You should see "Hello World! gd32e507z_eval" in your terminal.
137
138#. To debug an image:
139
140   .. zephyr-app-commands::
141      :zephyr-app: samples/hello_world
142      :board: gd32e507z_eval
143      :goals: debug
144      :compact:
145
146.. _GigaDevice Cortex-M33 High Performance SoC Website:
147   https://www.gigadevice.com/products/microcontrollers/gd32/arm-cortex-m33/high-performance-line/
148
149.. _GD32E507X Datasheet:
150   https://gd32mcu.com/download/down/document_id/252/path_type/1
151
152.. _GD32E50X User Manual:
153   https://www.gd32mcu.com/download/down/document_id/249/path_type/1
154
155.. _GD32E507Z-EVAL User Manual:
156   https://www.gd32mcu.com/data/documents/evaluationBoard/GD32E50x_Demo_Suites_V1.2.1.rar
157