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