boards: arm: nucleo_l452re added

Port based on existing nucleo_l432kc and nucleo_l476rg

Signed-off-by: Martin Jaeger <[email protected]>

Author: martinjaeger

boards/arm/nucleo_l452re/CMakeLists.txt

@@ -0,0 +1,7 @@
+# SPDX-License-Identifier: Apache-2.0
+
+if(CONFIG_PINMUX)
+zephyr_library()
+zephyr_library_sources(pinmux.c)
+zephyr_library_include_directories(${ZEPHYR_BASE}/drivers)
+endif()

boards/arm/nucleo_l452re/Kconfig.board

@@ -0,0 +1,9 @@
+# STM32L452RE Nucleo board configuration
+#
+# Copyright (c) 2019 Libre Solar Technologies GmbH
+#
+# SPDX-License-Identifier: Apache-2.0
+
+config BOARD_NUCLEO_L452RE
+	bool "Nucleo L452RE Development Board"
+	depends on SOC_STM32L452XX

boards/arm/nucleo_l452re/Kconfig.defconfig

@@ -0,0 +1,43 @@
+# STM32L452RE Nucleo board configuration
+#
+# Copyright (c) 2019 Libre Solar Technologies GmbH
+#
+# SPDX-License-Identifier: Apache-2.0
+
+if BOARD_NUCLEO_L452RE
+
+config BOARD
+	default "nucleo_l452re"
+
+if UART_CONSOLE
+
+config UART_2
+	default y
+
+endif # UART_CONSOLE
+
+if PWM
+
+config PWM_STM32_2
+	default y
+
+endif # PWM
+
+if SPI
+
+config SPI_1
+	default y
+
+config SPI_STM32_INTERRUPT
+	default y
+
+endif # SPI
+
+if CAN
+
+config CAN_1
+	default y
+
+endif # CAN
+
+endif # BOARD_NUCLEO_L452RE

boards/arm/nucleo_l452re/arduino_r3_connector.dtsi

@@ -0,0 +1,39 @@
+/*
+ * Copyright (c) 2019 Linaro Limited
+ *
+ * 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 0 0>,	/* A0 */
+			   <1 0 &gpioa 1 0>,	/* A1 */
+			   <2 0 &gpioa 4 0>,	/* A2 */
+			   <3 0 &gpiob 0 0>,	/* A3 */
+			   <4 0 &gpioc 1 0>,	/* A4 */
+			   <5 0 &gpioc 0 0>,	/* A5 */
+			   <6 0 &gpioa 3 0>,	/* D0 */
+			   <7 0 &gpioa 2 0>,	/* D1 */
+			   <8 0 &gpioa 10 0>,	/* D2 */
+			   <9 0 &gpiob 3 0>,	/* D3 */
+			   <10 0 &gpiob 5 0>,	/* D4 */
+			   <11 0 &gpiob 4 0>,	/* D5 */
+			   <12 0 &gpiob 10 0>,	/* D6 */
+			   <13 0 &gpioa 8 0>,	/* D7 */
+			   <14 0 &gpioa 9 0>,	/* D8 */
+			   <15 0 &gpioc 7 0>,	/* D9 */
+			   <16 0 &gpiob 6 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 {};

boards/arm/nucleo_l452re/board.cmake

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

boards/arm/nucleo_l452re/doc/img/nucleo-l452re-pinout.png

@@ -0,0 +1,234 @@
+.. _nucleo_l452re_board:
+
+ST Nucleo L452RE
+################
+
+Overview
+********
+
+The Nucleo L452RE board features an ARM Cortex-M4 based STM32L452RE MCU
+with a wide range of connectivity support and configurations. Here are
+some highlights of the Nucleo L452RE board:
+
+- STM32 microcontroller in UFQFPN32 package
+- Arduino Uno V3 connectivity
+- On-board ST-LINK/V2-1 debugger/programmer with SWD connector
+- Flexible board power supply:
+
+  - USB VBUS or external source(3.3V, 5V, 7 - 12V)
+  - Power management access point
+
+- Three LEDs: USB communication (LD1), user LED (LD2), power LED (LD3)
+- One push-button: RESET
+
+.. image:: img/nucleo-l452re.jpg
+  :width: 250px
+  :align: center
+  :height: 188px
+  :alt: Nucleo L452RE
+
+More information about the board can be found at the `Nucleo L452RE website`_.
+
+Hardware
+********
+
+The STM32L452RE SoC provides the following hardware IPs:
+
+- Ultra-low-power with FlexPowerControl (down to 28 nA Standby mode and 84
+  |micro| A/MHz run mode)
+- Core: ARM |reg| 32-bit Cortex |reg| -M4 CPU with FPU, frequency up to 80 MHz,
+  100DMIPS/1.25DMIPS/MHz (Dhrystone 2.1)
+- Clock Sources:
+
+  - 4 to 48 MHz crystal oscillator
+  - 32 kHz crystal oscillator for RTC (LSE)
+  - Internal 16 MHz factory-trimmed RC ( |plusminus| 1%)
+  - Internal low-power 32 kHz RC ( |plusminus| 5%)
+  - Internal multispeed 100 kHz to 48 MHz oscillator, auto-trimmed by
+    LSE (better than |plusminus| 0.25 % accuracy)
+  - 2 PLLs for system clock, USB, audio, ADC
+
+- RTC with HW calendar, alarms and calibration
+- Up to 3 capacitive sensing channels: support touchkey, linear and rotary touch sensors
+- 12x timers:
+
+  - 1x 16-bit advanced motor-control
+  - 1x 32-bit and 3x 16-bit general purpose
+  - 2x 16-bit basic
+  - 2x low-power 16-bit timers (available in Stop mode)
+  - 2x watchdogs
+  - SysTick timer
+
+- Up to 26 fast I/Os, most 5 V-tolerant
+- Memories
+
+  - Up to 512 KB single bank Flash, proprietary code readout protection
+  - 160 KB of SRAM including 32 KB with hardware parity check
+  - Quad SPI memory interface
+
+- Rich analog peripherals (independent supply)
+
+  - 1x 12-bit ADC 5 MSPS, up to 16-bit with hardware oversampling, 200
+    |micro| A/MSPS
+  - 2x 12-bit DAC, low-power sample and hold
+  - 1x operational amplifiers with built-in PGA
+  - 2x ultra-low-power comparators
+
+- 17x communication interfaces
+  - USB 2.0 full-speed crystal less solution with LPM and BCD
+  - 1x SAI (serial audio interface)
+  - 4x I2C FM+(1 Mbit/s), SMBus/PMBus
+  - 3x USARTs (ISO 7816, LIN, IrDA, modem)
+  - 1x UART (LIN, IrDA, modem)
+  - 1x LPUART (Stop 2 wake-up)
+  - 3x SPIs (and 1x Quad SPI)
+  - CAN (2.0B Active) and SDMMC interface
+  - IRTIM (Infrared interface)
+
+- 14-channel DMA controller
+- True random number generator
+- CRC calculation unit, 96-bit unique ID
+- Development support: serial wire debug (SWD), JTAG, Embedded Trace Macrocell*
+
+
+More information about STM32L452RE can be found here:
+
+- `STM32L452RE on www.st.com`_
+- `STM32L452 reference manual`_
+
+Supported Features
+==================
+
+The Zephyr nucleo_l452re board configuration supports the following hardware features:
+
++-----------+------------+-------------------------------------+
+| Interface | Controller | Driver/Component                    |
++===========+============+=====================================+
+| NVIC      | on-chip    | nested vector interrupt controller  |
++-----------+------------+-------------------------------------+
+| UART      | on-chip    | serial port-polling;                |
+|           |            | serial port-interrupt               |
++-----------+------------+-------------------------------------+
+| PINMUX    | on-chip    | pinmux                              |
++-----------+------------+-------------------------------------+
+| GPIO      | on-chip    | gpio                                |
++-----------+------------+-------------------------------------+
+| I2C       | on-chip    | i2c                                 |
++-----------+------------+-------------------------------------+
+| PWM       | on-chip    | pwm                                 |
++-----------+------------+-------------------------------------+
+| CAN       | on-chip    | can                                 |
++-----------+------------+-------------------------------------+
+
+.. note:: CAN feature requires CAN transceiver
+
+Other hardware features are not yet supported on this Zephyr port.
+
+The default configuration can be found in the defconfig file:
+``boards/arm/nucleo_l452re/nucleo_l452re_defconfig``
+
+
+Connections and IOs
+===================
+
+Nucleo L452RE Board has 6 GPIO controllers. These controllers are responsible for pin muxing,
+input/output, pull-up, etc.
+
+Available pins:
+---------------
+.. image:: img/nucleo-l452re-pinout.png
+   :width: 496px
+   :align: center
+   :height: 446px
+   :alt: Nucleo L452RE Pinout
+
+For mode details please refer to `STM32 Nucleo-32 board User Manual`_.
+
+Default Zephyr Peripheral Mapping:
+----------------------------------
+
+- UART_1_TX : PA9
+- UART_1_RX : PA10
+- UART_2_TX : PA2
+- UART_2_RX : PA15
+- I2C_1_SCL : PB6
+- I2C_1_SDA : PB7
+- PWM_2_CH1 : PA0
+- LD2 : PA5
+
+System Clock
+------------
+
+Nucleo L452RE System Clock could be driven by internal or external oscillator,
+as well as main PLL clock. By default System clock is driven by PLL clock at 80MHz,
+driven by 16MHz high speed internal oscillator.
+
+Serial Port
+-----------
+
+Nucleo L452RE board has 3 U(S)ARTs. The Zephyr console output is assigned to UART2.
+Default settings are 115200 8N1.
+
+
+Programming and Debugging
+*************************
+
+Applications for the ``nucleo_l452re`` 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 L452RE board includes an ST-LINK/V2-1 embedded debug tool
+interface.  This interface is supported by the openocd version
+included in the Zephyr SDK since v0.9.2.
+
+Flashing an application to Nucleo L452RE
+----------------------------------------
+
+Connect the Nucleo L452RE to your host computer using the USB port,
+then run a serial host program to connect with your Nucleo board.
+
+.. code-block:: console
+
+   $ minicom -D /dev/ttyACM0
+
+Now build and flash an application. Here is an example for
+:ref:`hello_world`.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/hello_world
+   :board: nucleo_l452re
+   :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_l452re
+   :maybe-skip-config:
+   :goals: debug
+
+.. _Nucleo L452RE website:
+   https://www.st.com/en/evaluation-tools/nucleo-l452re.html
+
+.. _STM32 Nucleo-32 board User Manual:
+   https://www.st.com/resource/en/user_manual/dm00105823.pdf
+
+.. _STM32L452RE on www.st.com:
+   https://www.st.com/en/microcontrollers-microprocessors/stm32l452re.html
+
+.. _STM32L452 reference manual:
+   https://www.st.com/resource/en/reference_manual/dm00151940.pdf