1.. _gd32f450z_eval:
2
3GigaDevice GD32F450Z-EVAL
4#########################
5
6Overview
7********
8
9The GD32F450Z-EVAL board is a hardware platform that enables prototyping
10on GD32F450ZK Cortex-M4F Stretch Performance MCU.
11
12The GD32F450ZK features a single-core ARM Cortex-M4F MCU which can run up
13to 200 MHz with flash accesses zero wait states, 3072kiB of Flash, 256kiB of
14SRAM and 114 GPIOs.
15
16.. image:: img/gd32f450z_eval.jpg
17     :align: center
18     :alt: gd32f450z_eval
19
20
21Hardware
22********
23
24- GD32F450ZKT6 MCU
25- AT24C02C 2Kb EEPROM
26- GD25Q16B 16Mbit SPI and QSPI NOR Flash
27- Micron MT48LC16M16A2P-6AIT 256Mbit SDRAM
28- 3 x User LEDs
29- 3 x User Push buttons
30- 1 x USART (RS-232 at J1 connector)
31- 1 x POT connected to an ADC input
32- Headphone interface
33- Micro SD Card Interface
34- USB FS connector
35- USB HS connector
36- 1 x CAN
37- Ethernet Interface
38- 3.5" RGB-LCD (320x480)
39- GD-Link on board programmer
40- J-Link/JTAG connector
41
42For more information about the GD32F450 SoC and GD32F450Z-EVAL board:
43
44- `GigaDevice Cortex-M4F Stretch Performance SoC Website`_
45- `GD32F450xx Datasheet`_
46- `GD32F4xx User Manual`_
47- `GD32F450Z-EVAL User Manual`_
48
49Supported Features
50==================
51
52The board configuration supports the following hardware features:
53
54.. list-table::
55   :header-rows: 1
56
57   * - Peripheral
58     - Kconfig option
59     - Devicetree compatible
60   * - EXTI
61     - :kconfig:option:`CONFIG_GD32_EXTI`
62     - :dtcompatible:`gd,gd32-exti`
63   * - GPIO
64     - :kconfig:option:`CONFIG_GPIO`
65     - :dtcompatible:`gd,gd32-gpio`
66   * - NVIC
67     - N/A
68     - :dtcompatible:`arm,v7m-nvic`
69   * - PWM
70     - :kconfig:option:`CONFIG_PWM`
71     - :dtcompatible:`gd,gd32-pwm`
72   * - SYSTICK
73     - N/A
74     - N/A
75   * - USART
76     - :kconfig:option:`CONFIG_SERIAL`
77     - :dtcompatible:`gd,gd32-usart`
78   * - DAC
79     - :kconfig:option:`CONFIG_DAC`
80     - :dtcompatible:`gd,gd32-dac`
81   * - I2C
82     - :kconfig:option:`CONFIG_I2C`
83     - :dtcompatible:`gd,gd32-i2c`
84   * - EEPROM
85     - :kconfig:option:`CONFIG_EEPROM`
86     - :dtcompatible:`atmel,at24`
87
88Serial Port
89===========
90
91The GD32F450Z-EVAL board has one serial communication port. The default port
92is USART0 with TX connected at PA9 and RX at PA10.
93
94Programming and Debugging
95*************************
96
97Before programming your board make sure to configure boot and serial jumpers
98as follows:
99
100- JP3/JP4: Select 2-3 for both (boot from user memory)
101- JP13: Select 1-2 position (labeled as ``USART0``)
102
103Using GD-Link
104=============
105
106The GD32F450Z-EVAL includes an onboard programmer/debugger (GD-Link) which
107allows flash programming and debugging over USB. There is also a JTAG header
108(J1) which can be used with tools like Segger J-Link.
109
110#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
111
112   .. zephyr-app-commands::
113      :zephyr-app: samples/hello_world
114      :board: gd32f450z_eval
115      :goals: build
116      :compact:
117
118#. Run your favorite terminal program to listen for output. On Linux the
119   terminal should be something like ``/dev/ttyUSB0``. For example:
120
121   .. code-block:: console
122
123      minicom -D /dev/ttyUSB0 -o
124
125   The -o option tells minicom not to send the modem initialization
126   string. Connection should be configured as follows:
127
128      - Speed: 115200
129      - Data: 8 bits
130      - Parity: None
131      - Stop bits: 1
132
133#. To flash an image:
134
135   .. zephyr-app-commands::
136      :zephyr-app: samples/hello_world
137      :board: gd32f450z_eval
138      :goals: flash
139      :compact:
140
141   You should see "Hello World! gd32f450z_eval" in your terminal.
142
143#. To debug an image:
144
145   .. zephyr-app-commands::
146      :zephyr-app: samples/hello_world
147      :board: gd32f450z_eval
148      :goals: debug
149      :compact:
150
151
152.. _GigaDevice Cortex-M4F Stretch Performance SoC Website:
153   https://www.gigadevice.com/products/microcontrollers/gd32/arm-cortex-m4/stretch-performance-line/
154
155.. _GD32F450xx Datasheet:
156	https://gd32mcu.21ic.com/data/documents/shujushouce/GD32F450xx_Datasheet_Rev1.1.pdf
157
158.. _GD32F4xx User Manual:
159	https://www.gigadevice.com/manual/gd32f450xxxx-user-manual/
160
161.. _GD32F450Z-EVAL User Manual:
162  http://www.gd32mcu.com/download/down/document_id/118/path_type/1
163