boards: arm: Add gd32e103v_eval board

boards/arm/gd32e103v_eval/Kconfig.board

@@ -0,0 +1,6 @@
+# Copyright (c) 2021, YuLong Yao <[email protected]>
+# SPDX-License-Identifier: Apache-2.0
+
+config BOARD_GD32E103V_EVAL
+	bool "GigaDevice GD32E103V Evaluation Kit"
+	depends on SOC_GD32E103

boards/arm/gd32e103v_eval/Kconfig.defconfig

@@ -0,0 +1,9 @@
+# Copyright (c) 2021 YuLong Yao <[email protected]>
+# SPDX-License-Identifier: Apache-2.0
+
+if BOARD_GD32E103V_EVAL
+
+config BOARD
+	default "gd32e103v_eval"
+
+endif   # BOARD_GD32E103V_EVAL

boards/arm/gd32e103v_eval/board.cmake

@@ -0,0 +1,7 @@
+# Copyright (c) 2021, YuLong Yao <[email protected]>
+# SPDX-License-Identifier: Apache-2.0
+
+include(${ZEPHYR_BASE}/boards/common/openocd.board.cmake)
+
+board_runner_args(gd32isp "--device=GD32E103VBT6")
+include(${ZEPHYR_BASE}/boards/common/gd32isp.board.cmake)

boards/arm/gd32e103v_eval/doc/index.rst

@@ -0,0 +1,217 @@
+.. _gd32e103v_eval:
+
+GigaDevice GD32E103V-EVAL
+#########################
+
+
+Overview
+********
+
+The GD32E103V-EVAL board is a hardware platform that enables design and debug
+of the GigaDevice E103 Cortex-M4F High Performance MCU.
+
+The GD32E103VB features a single-core ARM Cortex-M4F MCU which can run up
+to 120-MHz with flash accesses zero wait states, 128kiB of Flash, 32kiB of
+SRAM and 80 GPIOs.
+
+.. image:: img/gd32e103v_eval.png
+     :width: 800px
+     :align: center
+     :alt: gd32e103v_eval
+
+
+Hardware
+********
+
+- USB interface with mini-USB connector
+- 4 user LEDs
+- 4 user push buttons
+- Reset Button
+- ADC connected to a potentiometer
+- 2 DAC channels
+- GD25Q16 2Mib SPI Flash
+- AT24C02C 2KiB EEPROM
+- 3.2 TFT LCD (320x240)
+- PCM1770 Stereo DAC with Headphone Amplifier
+- GD-Link interface
+
+  - CMSIS-DAP swd debug interface over USB HID.
+
+- 2 CAN port(support CAN-FD)
+
+  - This function is not available in this board due to hardware issues, please check ``GD32C103`` .
+
+For more information about the GD32E103 SoC and GD32E103V-EVAL board:
+
+- `GigaDevice Cortex-M4F High Performance SoC Website`_
+- `GD32E103 Datasheet`_
+- `GD32E103 Reference Manual`_
+- `GD32E103V Eval Schematics`_
+- `GD32 ISP Console`_
+
+
+Supported Features
+==================
+
+The board configuration supports the following hardware features:
+
+.. list-table::
+   :header-rows: 1
+
+   * - Peripheral
+     - Kconfig option
+     - Devicetree compatible
+   * - NVIC
+     - N/A
+     - :dtcompatible:`arm,v7m-nvic`
+   * - SYSTICK
+     - N/A
+     - N/A
+   * - USART
+     - :kconfig:`CONFIG_SERIAL`
+     - :dtcompatible:`gd,gd32-usart`
+
+
+Serial Port
+===========
+
+The GD32E103V-EVAL board has 5 serial communication ports. The default port
+is UART0 at PIN-9 and PIN-10.
+
+Programming and Debugging
+*************************
+
+Before program your board make sure to configure boot setting and serial port.
+The default serial port is USART0.  This port uses header JP-5/6 to route
+signals between USB VBUS/ID and USART J2.
+
++--------+--------+------------+
+| Boot-0 | Boot-1 | Function   |
++========+========+============+
+|  1-2   |  1-2   | SRAM       |
++--------+--------+------------+
+|  1-2   |  2-3   | Bootloader |
++--------+--------+------------+
+|  2-3   |  Any   | Flash      |
++--------+--------+------------+
+
++------+------+-------------+
+| JP-5 | JP-6 | Function    |
++======+======+=============+
+| 1-2  | 1-2  | USART0 / J2 |
++------+------+-------------+
+| 2-3  | 2-3  | USB VBUS/ID |
++------+------+-------------+
+| open | open | Free        |
++------+------+-------------+
+
+Using GD-Link
+=============
+
+The GD32E103V-EVAL includes an onboard programmer/debugger (GD-Link) which
+allow flash programming and debug over USB. There are also program and debug
+headers J1 and J100 that can be used with any ARM compatible tools.
+
+#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+
+   .. zephyr-app-commands::
+      :zephyr-app: samples/hello_world
+      :board: gd32e103v_eval
+      :goals: build
+      :compact:
+
+#. Run your favorite terminal program to listen for output. Under Linux the
+   terminal should be :code:`/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: gd32e103v_eval
+      :goals: flash
+      :compact:
+
+   You should see "Hello World! gd32e103v_eval" in your terminal.
+
+#. To debug an image:
+
+   .. zephyr-app-commands::
+      :zephyr-app: samples/hello_world
+      :board: gd32e103v_eval
+      :goals: debug
+      :compact:
+
+
+Using ROM bootloader
+====================
+
+The GD32E103 MCU have a ROM bootloader which allow flash programming.  User
+should install `GD32 ISP Console`_ software at some Linux path.  The recommended
+is :code:`$HOME/.local/bin`.
+
+#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+
+   .. zephyr-app-commands::
+      :zephyr-app: samples/hello_world
+      :board: gd32e103v_eval
+      :goals: build
+      :compact:
+
+#. Enable board bootloader:
+
+   - Remove boot-0 jumper
+   - press reset button
+
+#. To flash an image:
+
+   .. code-block:: console
+
+      west build -b gd32e103v_eval samples/hello_world
+      west flash -r gd32isp [--port=/dev/ttyUSB0]
+
+#. Run your favorite terminal program to listen for output. Under Linux the
+   terminal should be :code:`/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
+
+   Press reset button
+
+   You should see "Hello World! gd32e103v_eval" in your terminal.
+
+
+.. _GigaDevice Cortex-M4F High Performance SoC Website:
+	https://www.gigadevice.com/products/microcontrollers/gd32/arm-cortex-m4/value-line/gd32e103-series/
+
+.. _GD32E103 Datasheet:
+	http://www.gd32mcu.com/download/down/document_id/235/path_type/1
+
+.. _GD32E103 Reference Manual:
+	http://www.gd32mcu.com/download/down/document_id/163/path_type/1
+
+.. _GD32E103V Eval Schematics:
+	http://www.gd32mcu.com/download/down/document_id/178/path_type/1
+
+.. _GD32 ISP Console:
+	http://www.gd32mcu.com/download/down/document_id/175/path_type/1

boards/arm/gd32e103v_eval/gd32e103v_eval-pinctrl.dtsi

@@ -0,0 +1,33 @@
+/*
+ * Copyright (c) 2021, YuLong Yao <[email protected]>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <dt-bindings/pinctrl/gd32e103v(b-8)xx-pinctrl.h>
+
+&pinctrl {
+	usart0_default: usart0_default {
+		group1 {
+			pinmux = <USART0_TX_PA9_NORMP>, <USART0_RX_PA10_NORMP>;
+		};
+	};
+
+	pwm0_default: pwm0_default {
+		group1 {
+			pinmux = <TIMER0_CH0_PA8_OUT_NORMP>;
+		};
+	};
+
+	dac_default: dac_default {
+		group1 {
+			pinmux = <DAC_OUT0_PA4>;
+		};
+	};
+
+	i2c0_default: i2c0_default {
+		group1 {
+			pinmux = <I2C0_SCL_PB6_NORMP>, <I2C0_SDA_PB7_NORMP>;
+			drive-open-drain;
+		};
+	};
+};