boards: arm: nucleo_wba52cg: Add board definition

Add nucleo_wba52cg with basic peripherals.

Signed-off-by: Guillaume Gautier <guillaume.gautier-ext@st.com>

boards/arm/nucleo_wba52cg/Kconfig.board

@@ -0,0 +1,8 @@
+# STM32WBA52CG Nucleo board configuration
+
+# Copyright (c) 2023 STMicroelectronics
+# SPDX-License-Identifier: Apache-2.0
+
+config BOARD_NUCLEO_WBA52CG
+	bool "Nucleo WBA52CG Development Board"
+	depends on SOC_STM32WBA52XX

boards/arm/nucleo_wba52cg/Kconfig.defconfig

@@ -0,0 +1,16 @@
+# STM32WBA52CG Nucleo board configuration
+
+# Copyright (c) 2023 STMicroelectronics
+
+# SPDX-License-Identifier: Apache-2.0
+
+if BOARD_NUCLEO_WBA52CG
+
+config BOARD
+	default "nucleo_wba52cg"
+
+config SPI_STM32_INTERRUPT
+	default y
+	depends on SPI
+
+endif # BOARD_NUCLEO_WBA52CG

boards/arm/nucleo_wba52cg/arduino_r3_connector.dtsi

@@ -0,0 +1,39 @@
+/*
+ * Copyright (c) 2023 STMicroelectronics
+ *
+ * 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 7 0>,	/* A0 */
+			   <1 0 &gpioa 6 0>,	/* A1 */
+			   <2 0 &gpioa 2 0>,	/* A2 */
+			   <3 0 &gpioa 1 0>,	/* A3 */
+			   <4 0 &gpioa 5 0>,	/* A4 */
+			   <5 0 &gpioa 0 0>,	/* A5 */
+			   <6 0 &gpioa 10 0>,	/* D0 */
+			   <7 0 &gpiob 5 0>,	/* D1 */
+			   <8 0 &gpiob 7 0>,	/* D2 */
+			   <9 0 &gpiob 6 0>,	/* D3 */
+			   <10 0 &gpiob 13 0>,	/* D4 */
+			   <11 0 &gpiob 14 0>,	/* D5 */
+			   <12 0 &gpiob 0 0>,	/* D6 */
+			   <13 0 &gpiob 9 0>,	/* D7 */
+			   <14 0 &gpiob 15 0>,	/* D8 */
+			   <15 0 &gpioa 9 0>,	/* D9 */
+			   <16 0 &gpioa 12 0>,	/* D10 */
+			   <17 0 &gpioa 15 0>,	/* D11 */
+			   <18 0 &gpiob 3 0>,	/* D12 */
+			   <19 0 &gpiob 4 0>,	/* D13 */
+			   <20 0 &gpiob 1 0>,	/* D14 */
+			   <21 0 &gpiob 2 0>;	/* D15 */
+	};
+};
+
+arduino_i2c: &i2c1 {};
+arduino_spi: &spi1 {};

boards/arm/nucleo_wba52cg/board.cmake

@@ -0,0 +1,3 @@
+board_runner_args(stm32cubeprogrammer "--port=swd" "--reset-mode=hw")
+
+include(${ZEPHYR_BASE}/boards/common/stm32cubeprogrammer.board.cmake)

boards/arm/nucleo_wba52cg/doc/nucleo_wba52cg.rst

@@ -0,0 +1,261 @@
+.. _nucleo_wba52cg_board:
+
+ST Nucleo WBA52CG
+#################
+
+Overview
+********
+
+NUCLEO-WBA52CG is a Bluetooth® Low Energy wireless and ultra-low-power board
+embedding a powerful and ultra-low-power radio compliant with the Bluetooth®
+Low Energy SIG specification v5.3.
+
+The ARDUINO® Uno V3 connectivity support and the ST morpho headers allow the
+easy expansion of the functionality of the STM32 Nucleo open development
+platform with a wide choice of specialized shields.
+
+- Ultra-low-power wireless STM32WBA52CG microcontroller based on the Arm®
+  Cortex®‑M33 core, featuring 1 Mbyte of flash memory and 128 Kbytes of SRAM in
+  a UFQFPN48 package
+
+- MCU RF board (MB1863):
+
+  - 2.4 GHz RF transceiver supporting Bluetooth® specification v5.3
+  - Arm® Cortex® M33 CPU with TrustZone®, MPU, DSP, and FPU
+  - Integrated PCB antenna
+
+- Three user LEDs
+- Three user and one reset push-buttons
+
+- Board connectors:
+
+  - USB Micro-B
+  - ARDUINO® Uno V3 expansion connector
+  - ST morpho headers for full access to all STM32 I/Os
+
+- Flexible power-supply options: ST-LINK USB VBUS or external sources
+- On-board STLINK-V3MODS debugger/programmer with USB re-enumeration capability:
+  mass storage, Virtual COM port, and debug port
+
+.. image:: img/nucleowba52cg.jpg
+   :align: center
+   :alt: Nucleo WB55RG
+
+More information about the board can be found at the `Nucleo WBA52CG website`_.
+
+Hardware
+********
+
+The STM32WBA52xx multiprotocol wireless and ultralow power devices embed a
+powerful and ultralow power radio compliant with the Bluetooth® SIG Low Energy
+specification 5.3. They contain a high-performance Arm Cortex-M33 32-bit RISC
+core. They operate at a frequency of up to 100 MHz.
+
+- Includes ST state-of-the-art patented technology
+
+- Ultra low power radio:
+
+  - 2.4 GHz radio
+  - RF transceiver supporting Bluetooth® Low Energy 5.3 specification
+  - Proprietary protocols
+  - RX sensitivity: -96 dBm (Bluetooth® Low Energy at 1 Mbps)
+  - Programmable output power, up to +10 dBm with 1 dB steps
+  - Integrated balun to reduce BOM
+  - Suitable for systems requiring compliance with radio frequency regulations
+    ETSI EN 300 328, EN 300 440, FCC CFR47 Part 15 and ARIB STD-T66
+
+- Ultra low power platform with FlexPowerControl:
+
+  - 1.71 to 3.6 V power supply
+  - - 40 °C to 85 °C temperature range
+  - Autonomous peripherals with DMA, functional down to Stop 1 mode
+  - 140 nA Standby mode (16 wake-up pins)
+  - 200 nA Standby mode with RTC
+  - 2.4 µA Standby mode with 64 KB SRAM
+  - 16.3 µA Stop mode with 64 KB SRAM
+  - 45 µA/MHz Run mode at 3.3 V
+  - Radio: Rx 7.4 mA / Tx at 0 dBm 10.6 mA
+
+- Core: Arm® 32-bit Cortex®-M33 CPU with TrustZone®, MPU, DSP, and FPU
+- ART Accelerator™: 8-Kbyte instruction cache allowing 0-wait-state execution
+  from flash memory (frequency up to 100 MHz, 150 DMIPS)
+- Power management: embedded regulator LDO supporting voltage scaling
+
+- Benchmarks:
+
+  - 1.5 DMIPS/MHz (Drystone 2.1)
+  - 407 CoreMark® (4.07 CoreMark/MHz)
+
+- Clock sources:
+
+  - 32 MHz crystal oscillator
+  - 32 kHz crystal oscillator (LSE)
+  - Internal low-power 32 kHz (±5%) RC
+  - Internal 16 MHz factory trimmed RC (±1%)
+  - PLL for system clock and ADC
+
+- Memories:
+
+  - 1 MB flash memory with ECC, including 256 Kbytes with 100 cycles
+  - 128 KB SRAM, including 64 KB with parity check
+  - 512-byte (32 rows) OTP
+
+- Rich analog peripherals (independent supply):
+
+  - 12-bit ADC 2.5 Msps with hardware oversampling
+
+- Communication peripherals:
+
+  - Three UARTs (ISO 7816, IrDA, modem)
+  - Two SPIs
+  - Two I2C Fm+ (1 Mbit/s), SMBus/PMBus®
+
+- System peripherals:
+
+  - Touch sensing controller, up to 20 sensors, supporting touch key, linear,
+     rotary touch sensors
+  - One 16-bit, advanced motor control timer
+  - Three 16-bit timers
+  - One 32-bit timer
+  - Two low-power 16-bit timers (available in Stop mode)
+  - Two Systick timers
+  - Two watchdogs
+  - 8-channel DMA controller, functional in Stop mode
+
+- Security and cryptography:
+
+  - Arm® TrustZone® and securable I/Os, memories, and peripherals
+  - Flexible life cycle scheme with RDP and password protected debug
+  - Root of trust thanks to unique boot entry and secure hide protection area (HDP)
+  - SFI (secure firmware installation) thanks to embedded RSS (root secure services)
+  - Secure data storage with root hardware unique key (RHUK)
+  - Secure firmware upgrade support with TF-M
+  - Two AES co-processors, including one with DPA resistance
+  - Public key accelerator, DPA resistant
+  - HASH hardware accelerator
+  - True random number generator, NIST SP800-90B compliant
+  - 96-bit unique ID
+  - Active tampers
+  - CRC calculation unit
+
+- Up to 35 I/Os (most of them 5 V-tolerant) with interrupt capability
+
+- Development support:
+
+  - Serial wire debug (SWD), JTAG
+
+- ECOPACK2 compliant package
+
+More information about STM32WB55RG can be found here:
+
+- `STM32WBA52CG on www.st.com`_
+- `STM32WBA52CG datasheet`_
+- `STM32WBA52CG reference manual`_
+
+Supported Features
+==================
+
+The Zephyr nucleo_wba52cg 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                                 |
++-----------+------------+-------------------------------------+
+| SPI       | on-chip    | spi                                 |
++-----------+------------+-------------------------------------+
+
+Other hardware features are not yet supported on this Zephyr port.
+
+The default configuration can be found in the defconfig file:
+``boards/arm/nucleo_wba52cg/nucleo_wba52cg_defconfig``
+
+Connections and IOs
+===================
+
+Nucleo WBA52CG Board has 4 GPIO controllers. These controllers are responsible for pin muxing,
+input/output, pull-up, etc.
+
+Default Zephyr Peripheral Mapping:
+----------------------------------
+
+.. rst-class:: rst-columns
+
+- USART_1 TX/RX : PB12/PA8
+- I2C_1_SCL : PB2
+- I2C_1_SDA : PB1
+- USER_PB : PC13
+- LD1 : PB4
+- SPI_1_NSS : PA12 (arduino_spi)
+- SPI_1_SCK : PB4 (arduino_spi)
+- SPI_1_MISO : PB3 (arduino_spi)
+- SPI_1_MOSI : PA15 (arduino_spi)
+
+System Clock
+------------
+
+Nucleo WBA52CG System Clock could be driven by internal or external oscillator,
+as well as main PLL clock. By default System clock is driven by HSE+PLL clock at 100MHz.
+
+Serial Port
+-----------
+
+Nucleo WBA52CG board has 1 U(S)ARTs. The Zephyr console output is assigned to USART1.
+Default settings are 115200 8N1.
+
+
+Programming and Debugging
+*************************
+
+Flashing
+========
+
+Nucleo WBA52CG board includes an ST-LINK/V3 embedded debug tool interface.
+For now, only STM32CubeProgrammer is available for flashing. It is configured
+as flashing tool by default.
+
+Flashing an application to Nucleo WBA52CG
+-----------------------------------------
+
+Here is an example for the :ref:`blinky-sample` application.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/basic/blinky
+   :board: nucleo_wba52cg
+   :goals: build flash
+
+You will see the LED blinking every second.
+
+Debugging
+=========
+
+You can debug an application using a STM32WBA compatible version of STM32CubeIDE.
+For that:
+- Create an empty STM32WBA project by going to File > New > STM32 project
+- Select your MCU, click Next, and select an Empty project.
+- Right click on your project name, select Debug as > Debug configurations
+- In the new window, create a new target in STM32 Cortex-M C/C++ Application
+- Select the new target and enter the path to zephyr.elf file in the C/C++ Application field
+- Check Disable auto build
+- Run debug
+
+.. _Nucleo WBA52CG website:
+   https://www.st.com/en/evaluation-tools/nucleo-wba52cg.html
+
+.. _STM32WBA52CG on www.st.com:
+   https://www.st.com/en/microcontrollers-microprocessors/stm32wba52cg.html
+
+.. _STM32WBA52CG datasheet:
+   https://www.st.com/resource/en/datasheet/stm32wba52cg.pdf
+
+.. _STM32WBA52CG reference manual:
+   https://www.st.com/resource/en/reference_manual/rm0493-multiprotocol-wireless-bluetooth-lowenergy-armbased-32bit-mcu-stmicroelectronics.pdf