boards: st: Add stm32u083c_dk board support

Add board support for stm32u083c_dk

Signed-off-by: IBEN EL HADJ MESSAOUD Marwa <[email protected]>

boards/st/stm32u083c_dk/Kconfig.stm32u083c_dk

@@ -0,0 +1,5 @@
+# Copyright (c) 2024 STMicroelectronics
+# SPDX-License-Identifier: Apache-2.0
+
+config BOARD_STM32U083C_DK
+	select SOC_STM32U083XX

boards/st/stm32u083c_dk/arduino_r3_connector.dtsi

@@ -0,0 +1,38 @@
+/*
+ * Copyright (c) 2024 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 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 &gpioc 12 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_serial: &usart2 {};

boards/st/stm32u083c_dk/board.cmake

@@ -0,0 +1,9 @@
+board_runner_args(stm32cubeprogrammer "--port=swd" "--reset-mode=hw")
+
+board_runner_args(pyocd "--target=stm32u083mctx")
+
+board_runner_args(jlink "--device=STM32U083C-DK" "--reset-after-load")
+
+include(${ZEPHYR_BASE}/boards/common/stm32cubeprogrammer.board.cmake)
+include(${ZEPHYR_BASE}/boards/common/pyocd.board.cmake)
+include(${ZEPHYR_BASE}/boards/common/jlink.board.cmake)

boards/st/stm32u083c_dk/board.yml

@@ -0,0 +1,5 @@
+board:
+  name: stm32u083c_dk
+  vendor: st
+  socs:
+    - name: stm32u083xx

boards/st/stm32u083c_dk/doc/index.rst

@@ -0,0 +1,286 @@
+.. _stm32u083c_dk_board:
+
+ST STM32U083C_DK
+################
+
+Overview
+********
+
+The STM32U083C_DK board, featuring an ARM Cortex-M0+ based STM32U083MC MCU,
+provides an affordable and flexible way for users to try out new concepts and
+build prototypes by choosing from the various combinations of performance and
+power consumption features. Here are some highlights of the STM32U083C_DK
+board:
+
+- Ultra-low-power STM32U083MC microcontroller based on the Arm |reg| Cortex |reg|‑M0+ core,
+  featuring 256 Kbytes of flash memory and 40 Kbytes of SRAM in an LQFP80 package.
+
+- Board connectors:
+
+  - ST-LINK USB Type-C connector
+  - User USB Device with USB Type-C connector
+  - mikroBUS connectors
+  - MIPI debug in connector (Arm |reg| Cortex |reg| 10‑pin 1.27 mm‑pitch
+    debug connector over STDC14 footprint)
+  - Extension connectors for full access to all STM32 I/Os
+  - VBAT dedicated connector provides the capability to power the board on a battery
+
+- Flexible power-supply options:
+
+  - ST-LINK USB VBUS, USB connector, or external sources
+
+- 4×24-segment LCD
+- Three user LEDs
+- Reset push-button
+- User joystick
+- Touchkey
+- Temperature sensor
+
+Hardware
+********
+
+The STM32U083xC devices are an ultra-low-power microcontrollers family (STM32U0
+Series) based on the high-performance Arm® Cortex |reg|-M0+ 32-bit RISC core.
+They operate at a frequency of up to 56 MHz.
+
+- Includes ST state-of-the-art patented technology
+- Ultra-low-power with FlexPowerControl:
+
+  - 1.71 V to 3.6 V power supply
+  - -40 °C to +85/125 °C temperature range
+  - 130 nA VBAT mode: supply for RTC, 9 x 32-bit backup registers
+  - 16 nA Shutdown mode (6 wake-up pins)
+  - 30 nA Standby mode (6 wake-up pins) without RTC
+  - 160 nA Standby mode with RTC
+  - 825 nA Stop 2 mode with RTC
+  - 695 nA Stop 2 mode without RTC
+  - 4 µA wake-up from Stop mode
+  - 52 µA/MHz Run mode (LDO mode)
+  - Brownout reset
+
+- Core:
+
+  - 32-bit Arm |reg| Cortex |reg|-M0+ CPU, frequency up to 56 MHz
+
+- ART Accelerator:
+
+  - 1-Kbyte instruction cache allowing 0-wait-state execution from flash memory
+
+- Benchmarks:
+
+  - 1.13 DMIPS/MHz (Drystone 2.1)
+  - 134 CoreMark |reg| (2.4 CoreMark/MHz at 56 MHz)
+  - 407 ULPMark™-CP
+  - 143 ULPMark™-PP
+  - 19.7 ULPMark™-CM
+
+- Memories:
+
+  - 256-Kbyte single bank flash memory, proprietary code readout protection
+  - 40-Kbyte SRAM with hardware parity check
+
+- General-purpose input/outputs:
+
+  - Up to 69 fast I/Os, most of them 5 V‑tolerant
+
+- Clock management:
+
+  - 4 to 48 MHz crystal oscillator
+  - 32 kHz crystal oscillator for RTC (LSE)
+  - Internal 16 MHz factory-trimmed RC (±1%)
+  - Internal low-power 32 kHz RC (±5%)
+  - Internal multispeed 100 kHz to 48 MHz oscillator,
+    auto-trimmed by LSE (better than ±0.25 % accuracy)
+  - Internal 48 MHz with clock recovery
+  - PLL for system clock, USB, ADC
+
+- Security:
+
+  - Customer code protection
+  - Robust read out protection (RDP): 3 protection level states
+    and password-based regression (128-bit PSWD)
+  - Hardware protection feature (HDP)
+  - Secure boot
+  - AES: 128/256-bit key encryption hardware accelerator
+  - True random number generation, candidate for NIST SP 800-90B certification
+  - Candidate for Arm® PSA level 1 and SESIP level 3 certifications
+  - 5 passive anti-tamper pins
+  - 96-bit unique ID
+
+- Up to 10 timers, 2 watchdogs and RTC:
+
+  - 1x 16-bit advanced motor-control, 1x 32-bit and 3x 16-bit general purpose,
+    2x 16-bit basic, 3x low-power 16-bit timers (available in Stop mode),
+    2x watchdogs, SysTick timer
+  - RTC with hardware calendar, alarms and calibration
+
+- Up to 20 communication peripherals:
+
+  - 1 USB 2.0 full-speed crystal-less solution with LPM and BCD
+  - 7 USARTs/LPUARTs (SPI, ISO 7816, LIN, IrDA, modem)
+  - 4 I2C interfaces supporting Fast-mode and Fast-mode Plus (up to 1 Mbit/s)
+  - 3 SPIs, plus 4x USARTs in SPI mode
+  - IRTIM (Infrared interface)
+
+- Rich analog peripherals (independent supply):
+
+  - 1x 12-bit ADC (0.4 µs conversion time), up to 16-bit with hardware oversampling
+  - 1x 12-bit DAC output channel, low-power sample and hold
+  - 1x general-purpose operational amplifier with built-in PGA (variable gain up to 16)
+  - 2x ultra-low-power comparators
+
+- LCD driver:
+  - 8*48 or 4*52 segments, with step-up converter
+
+- General-purpose inputs/outputs:
+  - Up to 69 fast I/Os, most of them 5 V-toleranZ
+
+- ECOPACK2 compliant packages
+
+More information about STM32U083MC can be found here:
+
+- `STM32U083MC on www.st.com`_
+- `STM32U083 reference manual`_
+
+Supported Features
+==================
+
+The Zephyr stm32u083c_dk board configuration supports the following hardware features:
+
++-----------+------------+-------------------------------------+
+| Interface | Controller | Driver/Component                    |
++===========+============+=====================================+
+| CLOCK     | on-chip    | reset and clock control             |
++-----------+------------+-------------------------------------+
+| GPIO      | on-chip    | gpio                                |
++-----------+------------+-------------------------------------+
+| NVIC      | on-chip    | nested vector interrupt controller  |
++-----------+------------+-------------------------------------+
+| UART      | on-chip    | serial port-polling;                |
+|           |            | serial port-interrupt               |
++-----------+------------+-------------------------------------+
+
+
+Other hardware features are not yet supported on this Zephyr port.
+
+The default configuration can be found in the defconfig file:
+:zephyr_file:`boards/st/stm32u083c_dk/stm32u083c_dk_defconfig`
+
+
+Connections and IOs
+===================
+
+STM32U083C_DK Board has 10 GPIO controllers. These controllers are responsible
+for pin muxing, input/output, pull-up, etc.
+
+For more details please refer to `STM32U083MC User Manual`_.
+
+Default Zephyr Peripheral Mapping:
+----------------------------------
+
+- ADC1_IN8 : PA4
+- I2C1_SCL : PB8
+- I2C1_SDA : PB9
+- LPUART_1_TX : PG7
+- LPUART_1_RX : PG8
+- SPI1_NSS : PA4
+- SPI1_SCK : PA5
+- SPI1_MISO : PA6
+- SPI1_MOSI : PA7
+- UART_2_TX : PA2
+- UART_2_RX : PA3
+
+System Clock
+------------
+
+STM32U083C_DK 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
+48MHz, driven by 4MHz medium speed internal oscillator.
+
+Serial Port
+-----------
+
+STM32U083C_DK board has 7 U(S)ARTs. The Zephyr console output is assigned to
+USART2. Default settings are 115200 8N1.
+
+
+Programming and Debugging
+*************************
+
+STM32U083C_DK board includes an ST-LINK/V3 embedded debug tool interface.
+This probe allows to flash the board using various tools.
+
+Flashing
+========
+
+Board is configured to be flashed using west STM32CubeProgrammer runner.
+Installation of `STM32CubeProgrammer`_ is then required to flash the board.
+
+Alternatively, pyocd or jlink via an external probe can also be used to flash
+and debug the board if west is told to use it as runner, which can be done by
+passing either or ``-r pyocd``, or ``-r jlink``.
+
+For pyocd additional target information needs to be installed.
+This can be done by executing the following commands.
+
+.. code-block:: console
+
+   $ pyocd pack --update
+   $ pyocd pack --install stm32u0
+
+
+Flashing an application to STM32U083C_DK
+------------------------------------------
+
+Connect the STM32U083C_DK to your host computer using the USB port.
+Then build and flash an application. 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 -D /dev/ttyACM0
+
+Then build and flash the application.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/hello_world
+   :board: stm32u083c_dk
+   :goals: build flash
+
+You should see the following message on the console:
+
+.. code-block:: console
+
+   Hello World! stm32u083c_dk/stm32u083xx
+
+Debugging
+=========
+
+Default flasher for this board is openocd. It could be used in the usual way.
+Here is an example for the :zephyr:code-sample:`blinky` application.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/basic/blinky
+   :board: nucleo_u083rc
+   :goals: debug
+
+Note: Check the ``build/tfm`` directory to ensure that the commands required by these scripts
+(``readlink``, etc.) are available on your system. Please also check ``STM32_Programmer_CLI``
+(which is used for initialization) is available in the PATH.
+
+.. _STM32U083_DK website:
+   https://www.st.com/en/evaluation-tools/stm32u083c-dk.html
+
+.. _STM32U083MC User Manual:
+   https://www.st.com/resource/en/user_manual/um3292-discovery-kit-with-STM32U083MC-MCU.pdf
+
+.. _STM32U083MC on www.st.com:
+   https://www.st.com/en/microcontrollers-microprocessors/stm32u083mc
+
+.. _STM32U083 reference manual:
+   https://www.st.com/resource/en/reference_manual/rm0503-stm32u0-series-advanced-armbased-32bit-mcus-stmicroelectronics.pdf
+
+.. _STM32CubeProgrammer:
+   https://www.st.com/en/development-tools/stm32cubeprog.html