board: Added board support package for Nucleo_F446ZE

Includes support for USB, CAN, ADC, DAC, and Arduino GPIO Map.
Future could support: ETM Trace (if Zephyr supports it), QSPI, FMC, DCMI

Initially based on closest BSP for the same SoC: nucleo_f446re
Extra peripherals added based on closest BSP for nucleo-144 board:
 nucleo_f429zi
Checked against nucleo-144 schematic
Documentation updated as best as I could
Arduino compatible pinmux for SPI, UART and I2C via Zio header

Tested:
  USB Device mode (samples/subsys/usb/console)
  Console via ST-link usart3 (samples/hello_world)
  user LEDs (samples/basic/blinky)
  scripts/twister --device-tests -p nucleo_f446ze
Not tested but should work: SPI, I2C, CAN, ADC, DAC
Not working yet: Quad-SPI (missing in dts/arm/st/f4/stm32f4.dtsi)

Co-authored-by: Alexandre Bourdiol
 <[email protected]>
Signed-off-by: Tom Owen <[email protected]>

Author: 2 people

boards/arm/nucleo_f446ze/Kconfig.board

@@ -0,0 +1,8 @@
+# STM32F446ZE Nucleo board configuration
+
+# Copyright (c) 2021 Tom Owen
+# SPDX-License-Identifier: Apache-2.0
+
+config BOARD_NUCLEO_F446ZE
+	bool "Nucleo F446ZE Development Board"
+	depends on SOC_STM32F446XX

boards/arm/nucleo_f446ze/Kconfig.defconfig

@@ -0,0 +1,15 @@
+# STM32F446ZE Nucleo board configuration
+
+# Copyright (c) 2021 Tom Owen
+# SPDX-License-Identifier: Apache-2.0
+
+if BOARD_NUCLEO_F446ZE
+
+config BOARD
+	default "nucleo_f446ze"
+
+config SPI_STM32_INTERRUPT
+	default y
+	depends on SPI
+
+endif # BOARD_NUCLEO_F446ZE

boards/arm/nucleo_f446ze/arduino_r3_connector.dtsi

@@ -0,0 +1,40 @@
+/*
+ * Copyright (c) 2021, Tom Owen
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/ {
+	arduino_header: connector {
+		compatible = "arduino-header-r3";
+		#gpio-cells = <2>;
+		gpio-map-mask = <0xffffffff 0xffffffc0>;
+		gpio-map-pass-thru = <0 0x3f>;
+		gpio-map = <0 0 &gpioa 3 0>,	/* A0 */
+			   <1 0 &gpioc 0 0>,	/* A1 */
+			   <2 0 &gpioc 3 0>,	/* A2 */
+			   <3 0 &gpiof 3 0>,	/* A3 */
+			   <4 0 &gpiof 5 0>,	/* A4 */
+			   <5 0 &gpiof 10 0>,	/* A5 */
+			   <6 0 &gpiog 9 0>,	/* D0 */
+			   <7 0 &gpiog 14 0>,	/* D1 */
+			   <8 0 &gpiof 15 0>,	/* D2 */
+			   <9 0 &gpioe 13 0>,	/* D3 */
+			   <10 0 &gpiof 14 0>,	/* D4 */
+			   <11 0 &gpioe 11 0>,	/* D5 */
+			   <12 0 &gpioe 9 0>,	/* D6 */
+			   <13 0 &gpiof 13 0>,	/* D7 */
+			   <14 0 &gpiof 12 0>,	/* D8 */
+			   <15 0 &gpiod 15 0>,	/* D9 */
+			   <16 0 &gpiod 14 0>,	/* D10 */
+			   <17 0 &gpioa 7 0>,	/* D11 */
+			   <18 0 &gpioa 6 0>,	/* D12 */
+			   <19 0 &gpioa 5 0>,	/* D13 */
+			   <20 0 &gpiob 9 0>,	/* D14 */
+			   <21 0 &gpiob 8 0>;	/* D15 */
+	};
+};
+
+arduino_i2c: &i2c1 {};
+arduino_spi: &spi1 {};
+arduino_serial: &usart6 {};

boards/arm/nucleo_f446ze/board.cmake

@@ -0,0 +1,6 @@
+# SPDX-License-Identifier: Apache-2.0
+
+board_runner_args(jlink "--device=STM32F446ZE" "--speed=4000")
+
+include(${ZEPHYR_BASE}/boards/common/openocd.board.cmake)
+include(${ZEPHYR_BASE}/boards/common/jlink.board.cmake)

boards/arm/nucleo_f446ze/doc/img/nucleo_f446ze.jpg

@@ -0,0 +1,258 @@
+.. _nucleo_f446ze_board:
+
+ST Nucleo F446ZE
+################
+
+
+Overview
+********
+
+The Nucleo F446ZE board features an ARM Cortex-M4 based STM32F446ZE MCU
+with a wide range of connectivity support and configurations. Here are
+some highlights of the Nucleo F446ZE board:
+
+- STM32F446 microcontroller in QFP144 package
+- Two types of extension resources:
+
+  - ST zio support for Arduino™ Uno V3 connectivity (A0 to A5, D0 to D15) and additional signals exposing a wide range of peripherals
+  - ST morpho extension pin headers for full access to all STM32 I/Os
+
+- On-board ST-LINK/V2-1 debugger/programmer with SWD connector
+- USB re-enumeration capability. Three different interfaces supported on USB:
+  - Virtual Com port
+  - Mass storage (USB Disk drive) for drag'n'drop programming
+  - Debug port
+- Flexible board power supply:
+  - USB VBUS or external source(3.3V, 5V, 7 - 12V)
+  - Power management access point
+  - USB OTG
+
+- Three LEDs: USB communication (LD1), user LED (LD2), power LED (LD3)
+- Two push-buttons: USER and RESET
+
+.. image:: img/nucleo_f446ze.jpg
+   :width: 720px
+   :align: center
+   :height: 720px
+   :alt: Nucleo F446ZE
+
+More information about the board can be found at the `Nucleo F446ZE website`_.
+
+Hardware
+********
+
+Nucleo F446ZE provides the following hardware components:
+
+- STM32F446ZET6 in LQFP144 package
+- ARM |reg| 32-bit Cortex |reg|-M4 CPU with FPU
+- Adaptive real-time accelerator (ART Accelerator)
+- 180 MHz max CPU frequency
+- VDD from 1.7 V to 3.6 V
+- 512 KB Flash
+- 128 KB SRAM
+- 10 General purpose timers
+- 2 Advanced control timers
+- 2 basic timers
+- SPI(4)
+- I2C(4)
+- USART(4)
+- UART(2)
+- USB OTG Full Speed and High Speed
+- CAN(2)
+- SAI(2)
+- SPDIF_Rx(1)
+- HDMI_CEC(1)
+- Quad SPI(1)
+- Camera Interface
+- GPIO(50) with external interrupt capability
+- 12-bit ADC(3) with 16 channels
+- 12-bit DAC with 2 channels
+
+More information about STM32F446ZE can be found here:
+
+- `STM32F446ZE on www.st.com`_
+- `STM32F446 reference manual`_
+
+Supported Features
+==================
+
+The Zephyr nucleo_f446ze board configuration supports the following hardware features:
+
++-------------+------------+-------------------------------------+
+| Interface   | Controller | Driver/Component                    |
++=============+============+=====================================+
+| NVIC        | on-chip    | nested vector interrupt controller  |
++-------------+------------+-------------------------------------+
+| UART        | on-chip    | serial port                         |
++-------------+------------+-------------------------------------+
+| PINMUX      | on-chip    | pinmux                              |
++-------------+------------+-------------------------------------+
+| GPIO        | on-chip    | gpio                                |
++-------------+------------+-------------------------------------+
+| PWM         | on-chip    | pwm                                 |
++-------------+------------+-------------------------------------+
+| I2C         | on-chip    | i2c                                 |
++-------------+------------+-------------------------------------+
+| USB         | on-chip    | usb                                 |
++-------------+------------+-------------------------------------+
+| Backup SRAM | on-chip    | Backup SRAM                         |
++-------------+------------+-------------------------------------+
+| CAN 1/2     | on-chip    | Controller Area Network             |
++-------------+------------+-------------------------------------+
+| ADC         | on-chip    | Analog Input                        |
++-------------+------------+-------------------------------------+
+| DAC         | on-chip    | Analog Output                       |
++-------------+------------+-------------------------------------+
+
+Other hardware features are not yet supported on this Zephyr port.
+
+The default configuration can be found in the defconfig file:
+``boards/arm/nucleo_f446ze/nucleo_f446ze_defconfig``
+
+
+Connections and IOs
+===================
+
+Nucleo F446ZE Board has 8 GPIO controllers. These controllers are responsible for pin muxing,
+input/output, pull-up, etc.
+
+Available pins:
+---------------
+.. image:: img/nucleo_f446ze_zio_left_2019_8_29.png
+   :width: 720px
+   :align: center
+   :height: 540px
+   :alt: Nucleo F446ZE Zio/Arduino connectors (left)
+.. image:: img/nucleo_f446ze_zio_right_2019_8_29.png
+   :width: 720px
+   :align: center
+   :height: 540px
+   :alt: Nucleo F446ZE Zio/Arduino connectors (right)
+.. image:: img/nucleo_f446ze_morpho_left_2019_8_29.png
+   :width: 720px
+   :align: center
+   :height: 540px
+   :alt: Nucleo F446ZE Morpho connectors (left)
+.. image:: img/nucleo_f446ze_morpho_right_2019_8_29.png
+   :width: 720px
+   :align: center
+   :height: 540px
+   :alt: Nucleo F446ZE Morpho connectors (right)
+
+For mode details please refer to `STM32 Nucleo-144 board User Manual`_.
+
+Default Zephyr Peripheral Mapping:
+----------------------------------
+
+- UART_2_TX : PD5
+- UART_2_RX : PD6
+- UART_3_TX : PD8
+- UART_3_RX : PD9
+- USER_PB   : PC13
+- LD0       : PB0
+- LD1       : PB7
+- LD2       : PB14
+- I2C1_SDA  : PB9
+- I2C1_SCL  : PB8
+- I2C2_SDA  : PF0
+- I2C2_SCL  : PF1
+- SPI1_CS   : PD14
+- SPI1_SCK  : PA5
+- SPI1_MISO : PA6
+- SPI1_MOSI : PA7
+- SPI2_NSS  : PB12
+- SPI2_SCK  : PB13
+- SPI2_MISO : PB14
+- SPI2_MOSI : PB15
+- CAN1_RX   : PD0
+- CAN1_TX   : PD1
+- USB_DP    : PA11
+- USB_DM    : PA12
+- ADC1_IN0  : PA0
+- DAC_OUT1  : PA4
+
+
+System Clock
+------------
+
+Nucleo F446ZE System Clock could be driven by an internal or external oscillator,
+as well as the main PLL clock. By default, the System clock is driven by the PLL clock at 84MHz,
+driven by an 8MHz high-speed external clock.
+
+Serial Port
+-----------
+
+Nucleo F446ZE board has 2 UARTs and 4 USARTs. The Zephyr console output is assigned to USART3.
+Default settings are 115200 8N1.
+
+Backup SRAM
+-----------
+
+In order to test backup SRAM you may want to disconnect VBAT from VDD. You can
+do it by removing ``SB156`` jumper on the back side of the board.
+
+Controller Area Network
+-----------------------
+
+The TX/RX wires are connected with pins 25/27 of CN9 connector.
+
+Programming and Debugging
+*************************
+
+Applications for the ``nucleo_f446ze`` board configuration can be built and
+flashed in the usual way (see :ref:`build_an_application` and
+:ref:`application_run` for more details).
+
+Flashing
+========
+
+Nucleo F446ZE board includes an ST-LINK/V2-1 embedded debug tool interface.
+This interface is supported by the openocd version included in the Zephyr SDK.
+
+Flashing an application to Nucleo F446ZE
+----------------------------------------
+
+Here is an example for the :ref:`hello_world` application.
+
+Run a serial host program to connect with your Nucleo board.
+
+.. code-block:: console
+
+   $ minicom -b 115200 -D /dev/ttyACM0
+
+Build and flash the application:
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/hello_world
+   :board: nucleo_f446ze
+   :goals: build flash
+
+You should see the following message on the console:
+
+.. code-block:: console
+
+   $ Hello World! arm
+
+Debugging
+=========
+
+You can debug an application in the usual way.  Here is an example for the
+:ref:`hello_world` application.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/hello_world
+   :board: nucleo_f446ze
+   :maybe-skip-config:
+   :goals: debug
+
+.. _Nucleo F446ZE website:
+   http://www.st.com/en/evaluation-tools/nucleo-f446ze.html
+
+.. _STM32 Nucleo-144 board User Manual:
+   https://www.st.com/resource/en/user_manual/um1974-stm32-nucleo144-boards-mb1137-stmicroelectronics.pdf
+
+.. _STM32F446ZE on www.st.com:
+   http://www.st.com/en/microcontrollers/stm32f446ze.html
+
+.. _STM32F446 reference manual:
+   http://www.st.com/resource/en/reference_manual/dm00135183.pdf