1.. zephyr:board:: gd32f450v_start
2
3Overview
4********
5
6The GD32F450V-START board is a hardware platform that enables prototyping
7on GD32F450VK Cortex-M4F Stretch Performance MCU.
8
9The GD32F450VK 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 82 GPIOs.
12
13Hardware
14********
15
16- GD32F450VKT6 MCU
17- 1 x User LEDs
18- 1 x User Push buttons
19- USB FS/HS connectors
20- GD-Link on board programmer
21- J-Link/SWD connector
22
23For more information about the GD32F450 SoC and GD32F450V-START board:
24
25- `GigaDevice Cortex-M4F Stretch Performance SoC Website`_
26- `GD32F450X Datasheet`_
27- `GD32F4XX User Manual`_
28- `GD32F450V-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 GD32F450V-START board has no exposed serial communication port. The board
66provides default configuration for USART0 with TX connected at PB6 and RX at
67PB7. PB6/PB7 are exposed in JP6, so you can solder a connector and use a
68UART-USB adapter.
69
70Programming and Debugging
71*************************
72
73Before programming your board make sure to configure boot jumpers as
74follows:
75
76- JP2/3: Select 2-3 for both (boot from user memory)
77
78Using GD-Link
79=============
80
81The GD32F450V-START includes an onboard programmer/debugger (GD-Link) which
82allows flash programming and debugging over USB. There is also a SWD header
83(JP100) which can be used with tools like Segger J-Link.
84
85#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
86
87   .. zephyr-app-commands::
88      :zephyr-app: samples/hello_world
89      :board: gd32f450v_start
90      :goals: build
91      :compact:
92
93#. Run your favorite terminal program to listen for output. On Linux the
94   terminal should be something like ``/dev/ttyUSB0``. For example:
95
96   .. code-block:: console
97
98      minicom -D /dev/ttyUSB0 -o
99
100   The -o option tells minicom not to send the modem initialization
101   string. Connection should be configured as follows:
102
103      - Speed: 115200
104      - Data: 8 bits
105      - Parity: None
106      - Stop bits: 1
107
108#. To flash an image:
109
110   .. zephyr-app-commands::
111      :zephyr-app: samples/hello_world
112      :board: gd32f450v_start
113      :goals: flash
114      :compact:
115
116   You should see "Hello World! gd32f450v_start" in your terminal.
117
118#. To debug an image:
119
120   .. zephyr-app-commands::
121      :zephyr-app: samples/hello_world
122      :board: gd32f450v_start
123      :goals: debug
124      :compact:
125
126.. _GigaDevice Cortex-M4F Stretch Performance SoC Website:
127   https://www.gigadevice.com/products/microcontrollers/gd32/arm-cortex-m4/stretch-performance-line/
128
129.. _GD32F450X Datasheet:
130   https://gd32mcu.com/data/documents/datasheet/GD32F450xx_Datasheet_Rev2.3.pdf
131
132.. _GD32F4xx User Manual:
133   https://www.gigadevice.com/manual/gd32f450xxxx-user-manual/
134
135.. _GD32F450V-START User Manual:
136   https://gd32mcu.com/data/documents/evaluationBoard/GD32F4xx_Demo_Suites_V2.6.1.rar
137