boards/gd/gd32f450i_eval/doc/index.rst
.. zephyr:board:: gd32f450i_eval
Overview
The GD32F450I-EVAL board is a hardware platform that enables prototyping on GD32F450IK Cortex-M4F Stretch Performance MCU.
The GD32F450IK features a single-core ARM Cortex-M4F MCU which can run up to 200 MHz with flash accesses zero wait states, 3072kiB of Flash, 256kiB of SRAM and 140 GPIOs.
Hardware
For more information about the GD32F450 SoC and GD32F450I-EVAL board:
GigaDevice Cortex-M4F Stretch Performance SoC Website_GD32F450xx Datasheet_GD32F4xx User Manual_GD32F450I-EVAL User Manual_.. zephyr:board-supported-hw::
The GD32F450I-EVAL board has one serial communication port. The default port is USART0 with TX connected at PA9 and RX at PA10.
Programming and Debugging
.. zephyr:board-supported-runners::
Before programming your board make sure to configure boot and serial jumpers as follows:
USART0)The GD32F450I-EVAL includes an onboard programmer/debugger (GD-Link) which allows flash programming and debugging over USB. There is also a JTAG header (J1) which can be used with tools like Segger J-Link.
#. Build the Zephyr kernel and the :zephyr:code-sample:hello_world sample application:
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: gd32f450i_eval :goals: build :compact:
#. Run your favorite terminal program to listen for output. On Linux the
terminal should be something like /dev/ttyUSB0. For example:
.. code-block:: console
minicom -D /dev/ttyUSB0 -o
The -o option tells minicom not to send the modem initialization string. Connection should be configured as follows:
- Speed: 115200
- Data: 8 bits
- Parity: None
- Stop bits: 1
#. To flash an image:
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: gd32f450i_eval :goals: flash :compact:
You should see "Hello World! gd32f450i_eval" in your terminal.
#. To debug an image:
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: gd32f450i_eval :goals: debug :compact:
.. _GigaDevice Cortex-M4F Stretch Performance SoC Website: https://www.gigadevice.com/products/microcontrollers/gd32/arm-cortex-m4/stretch-performance-line/
.. _GD32F450xx Datasheet: https://gd32mcu.21ic.com/data/documents/shujushouce/GD32F450xx_Datasheet_Rev1.1.pdf
.. _GD32F4xx User Manual: https://www.gigadevice.com/manual/gd32f450xxxx-user-manual/
.. _GD32F450I-EVAL User Manual: http://www.gd32mcu.com/download/down/document_id/120/path_type/1