1.. zephyr:board:: nucleo_u5a5zj_q
2
3Overview
4********
5
6The Nucleo U5A5ZJ Q board, featuring an ARM Cortex-M33 based STM32U5A5ZJ MCU,
7provides an affordable and flexible way for users to try out new concepts and
8build prototypes by choosing from the various combinations of performance and
9power consumption features. Here are some highlights of the Nucleo U5A5ZJ Q
10board:
11
12
13- STM32U5A5ZJ microcontroller in LQFP144 package
14- Internal SMPS to generate V core logic supply
15- Two types of extension resources:
16
17  - Arduino Uno V3 connectivity
18  - ST morpho extension pin headers for full access to all STM32 I/Os
19
20- On-board ST-LINK/V3E debugger/programmer
21- Flexible board power supply:
22
23  - USB VBUS or external source(3.3V, 5V, 7 - 12V)
24  - ST-Link V3E
25
26- Three users LEDs
27- Two push-buttons: USER and RESET
28- USB Type-C ™ Sink device FS
29
30Hardware
31********
32
33The STM32U5A5xx devices are an ultra-low-power microcontrollers family (STM32U5
34Series) based on the high-performance Arm® Cortex®-M33 32-bit RISC core.
35They operate at a frequency of up to 160 MHz.
36
37- Includes ST state-of-the-art patented technology
38- Ultra-low-power with FlexPowerControl:
39
40  - 1.71 V to 3.6 V power supply
41  - -40 °C to +85/125 °C temperature range
42  - Low-power background autonomous mode (LPBAM): autonomous peripherals with
43    DMA, functional down to Stop 2 mode
44  - VBAT mode: supply for RTC, 32 x 32-bit backup registers and 2-Kbyte backup SRAM
45  - 150 nA Shutdown mode (24 wake-up pins)
46  - 195 nA Standby mode (24 wake-up pins)
47  - 480 nA Standby mode with RTC
48  - 2 µA Stop 3 mode with 40-Kbyte SRAM
49  - 8.2 µA Stop 3 mode with 2.5-Mbyte SRAM
50  - 4.65 µA Stop 2 mode with 40-Kbyte SRAM
51  - 17.5 µA Stop 2 mode with 2.5-Mbyte SRAM
52  - 18.5 µA/MHz Run mode at 3.3 V
53
54- Core:
55
56  - Arm® 32-bit Cortex®-M33 CPU with TrustZone®, MPU, DSP,
57    and FPU ART Accelerator
58  - 32-Kbyte ICACHE allowing 0-wait-state execution from flash and external
59    memories: frequency up to 160 MHz, 240 DMIPS
60  - 16-Kbyte DCACHE1 for external memories
61
62- Power management:
63
64  - Embedded regulator (LDO) and SMPSstep-down converter supporting switch
65    on-the-fly and voltage scaling
66
67- Benchmarks:
68
69  - 1.5 DMIPS/MHz (Drystone 2.1)
70  - 655 CoreMark® (4.09 CoreMark®/MHz)
71  - 369 ULPMark™-CP
72  - 89 ULPMark™-PP
73  - 47.2 ULPMark™-CM
74  - 120000 SecureMark™-TLS
75
76- Memories:
77
78  - 4-Mbyte flash memory with ECC, 2 banks readwhile-write, including 512 Kbytes
79    with 100 kcycles
80  - With SRAM3 ECC off: 2514-Kbyte RAM including 66 Kbytes with ECC
81  - With SRAM3 ECC on: 2450-Kbyte RAMincluding 322 Kbytes with ECC
82  - External memory interface supporting SRAM,PSRAM, NOR, NAND, and FRAM memories
83  - 2 Octo-SPI memory interfaces
84  - 16-bit HSPI memory interface up to 160 MHz
85
86- Rich graphic features:
87
88  - Neo-Chrom GPU (GPU2D) accelerating any angle rotation, scaling, and
89    perspective correct texture mapping
90  - 16-Kbyte DCACHE2
91  - Chrom-ART Accelerator (DMA2D) for smoothmotion and transparency effects
92  - Chrom-GRC (GFXMMU) allowing up to 20 % of graphic resources optimization
93  - MIPI® DSI host controller with two DSI lanes running at up to 500 Mbit/s each
94  - LCD-TFT controller (LTDC)
95  - Digital camera interface
96
97- General-purpose input/outputs:
98
99  - Up to 156 fast I/Os with interrupt capability most 5V-tolerant and
100    up to 14 I/Os with independent supply down to 1.08 V
101
102- Clock management:
103
104  - 4 to 50 MHz crystal oscillator
105  - 32 kHz crystal oscillator for RTC (LSE)
106  - Internal 16 MHz factory-trimmed RC (± 1 %)
107  - Internal low-power 32 kHz RC (± 5 %)
108  - 2 internal multispeed 100 kHz to 48 MHz oscillators, including one
109    autotrimmed by LSE (better than ± 0.25 % accuracy)
110  - Internal 48 MHz
111  - 5 PLLs for system clock, USB, audio, ADC, DSI
112
113- Security and cryptography:
114
115  - SESIP3 and PSA Level 3 Certified Assurance Target
116  - Arm® TrustZone® and securable I/Os, memories, and peripherals
117  - Flexible life cycle scheme with RDP andpassword-protected debug
118  - Root of trust thanks to unique boot entry and secure hide-protection area (HDP)
119  - Secure firmware installation (SFI) thanks to embedded root secure services (RSS)
120  - Secure data storage with hardware unique key (HUK)
121  - Secure firmware upgrade support with TF-M
122  - 2 AES coprocessors including one with DPA resistance
123  - Public key accelerator, DPA resistant
124  - On-the-fly decryption of Octo-SPI external memories
125  - HASH hardware accelerator
126  - True random number generator, NIST SP800-90B compliant
127  - 96-bit unique ID
128  - 512-byte OTP (one-time programmable)
129  - Active tampers
130
131- Up to 17 timers, 2 watchdogs and RTC:
132
133  - 19 timers: 2 16-bit advanced motor-control, 4 32-bit, 3 16-bit general
134    purpose, 2 16-bit basic, 4 low-power 16-bit (available in Stop mode),
135    2 SysTick timers, and 2 watchdogs
136  - RTC with hardware calendar, alarms, and calibration
137
138- Up to 25 communication peripherals:
139
140  - 1 USB Type-C®/USB power delivery controller
141  - 1 USB OTG high-speed with embedded PHY
142  - 2 SAIs (serial audio interface)
143  - 6 I2C FM+(1 Mbit/s), SMBus/PMBus144  - 7 USARTs (ISO 7816, LIN, IrDA, modem)
145  - 3 SPIs (6x SPIs with OCTOSPI/HSPI)
146  - 1 CAN FD controller
147  - 2 SDMMC interfaces
148  - 1 multifunction digital filter (6 filters) + 1 audio digital filter
149    with sound-activity detection
150  - Parallel synchronous slave interface
151
152- Mathematical coprocessor:
153
154  - CORDIC for trigonometric functions acceleration
155  - FMAC (filter mathematical accelerator)
156
157- Rich analog peripherals (independent supply):
158
159  - 2 14-bit ADC 2.5-Msps with hardware oversampling
160  - 1 12-bit ADC 2.5-Msps, with hardware oversampling, autonomous in Stop 2 mode
161  - 12-bit DAC (2 channels), low-power sample, and hold, autonomous in Stop 2 mode
162  - 2 operational amplifiers with built-in PGA
163  - 2 ultra-low-power comparators
164
165- ECOPACK2 compliant packages
166
167More information about STM32U5A5ZJ can be found here:
168
169- `STM32U5A5ZJ on www.st.com`_
170- `STM32U5A5 reference manual`_
171
172Supported Features
173==================
174
175The Zephyr nucleo_u5a5zj_q board configuration supports the following hardware features:
176
177+-----------+------------+-------------------------------------+
178| Interface | Controller | Driver/Component                    |
179+===========+============+=====================================+
180| CAN/CANFD | on-chip    | canbus                              |
181+-----------+------------+-------------------------------------+
182| CLOCK     | on-chip    | reset and clock control             |
183+-----------+------------+-------------------------------------+
184| DAC       | on-chip    | DAC Controller                      |
185+-----------+------------+-------------------------------------+
186| GPIO      | on-chip    | gpio                                |
187+-----------+------------+-------------------------------------+
188| I2C       | on-chip    | i2c                                 |
189+-----------+------------+-------------------------------------+
190| NVIC      | on-chip    | nested vector interrupt controller  |
191+-----------+------------+-------------------------------------+
192| PINMUX    | on-chip    | pinmux                              |
193+-----------+------------+-------------------------------------+
194| SPI       | on-chip    | spi                                 |
195+-----------+------------+-------------------------------------+
196| UART      | on-chip    | serial port-polling;                |
197|           |            | serial port-interrupt               |
198+-----------+------------+-------------------------------------+
199| WATCHDOG  | on-chip    | independent watchdog                |
200+-----------+------------+-------------------------------------+
201| BKP SRAM  | on-chip    | Backup SRAM                         |
202+-----------+------------+-------------------------------------+
203| RNG       | on-chip    | True Random number generator        |
204+-----------+------------+-------------------------------------+
205| RTC       | on-chip    | rtc                                 |
206+-----------+------------+-------------------------------------+
207| USB       | on-chip    | USB 2.0 HS                          |
208+-----------+------------+-------------------------------------+
209
210
211Other hardware features are not yet supported on this Zephyr port.
212
213The default configuration can be found in the defconfig file:
214:zephyr_file:`boards/st/nucleo_u5a5zj_q/nucleo_u5a5zj_q_defconfig`
215
216
217Connections and IOs
218===================
219
220Nucleo U5A5ZJ Q Board has 10 GPIO controllers. These controllers are responsible
221for pin muxing, input/output, pull-up, etc.
222
223For more details please refer to `STM32 Nucleo-144 board User Manual`_.
224
225Default Zephyr Peripheral Mapping:
226----------------------------------
227
228
229- CAN/CANFD_TX: PD1
230- CAN/CANFD_RX: PD0
231- DAC1_OUT1 : PA4
232- I2C_1_SCL : PB8
233- I2C_1_SDA : PB9
234- I2C_2_SCL : PF1
235- I2C_2_SDA : PF0
236- LD1 : PC7
237- LD2 : PB7
238- LD3 : PG2
239- LPUART_1_TX : PG7
240- LPUART_1_RX : PG8
241- SPI_1 nCS (GPIO) : PD14
242- SPI_1_SCK : PA5
243- SPI_1_MISO : PA6
244- SPI_1_MOSI : PA7
245- UART_1_TX : PA9
246- UART_1_RX : PA10
247- UART_2_TX : PD5
248- UART_2_RX : PD6
249- USER_PB : PC13
250- USB_DM : PA11
251- USB_DP : PA12
252
253System Clock
254------------
255
256Nucleo U5A5ZJ Q System Clock could be driven by internal or external oscillator,
257as well as main PLL clock. By default System clock is driven by PLL clock at
258160MHz, driven by the 16MHz high speed oscillator.
259
260Serial Port
261-----------
262
263Nucleo U5A5ZJ Q board has 6 U(S)ARTs. The Zephyr console output is assigned to
264USART1. Default settings are 115200 8N1.
265
266Backup SRAM
267-----------
268
269In order to test backup SRAM you may want to disconnect VBAT from VDD. You can
270do it by removing ``SB50`` jumper on the back side of the board.
271
272Using USB
273---------
274
275USB 2.0 high speed (HS) operation requires the HSE clock source to be populated
276and enabled.  The Nucleo U5A5ZJ-Q includes the 16MHz oscillator and required
277jumper settings.
278
279Programming and Debugging
280*************************
281
282Nucleo U5A5ZJ-Q board includes an ST-LINK/V3 embedded debug tool interface.
283This probe allows to flash the board using various tools.
284
285Flashing
286========
287
288The board is configured to be flashed using west `STM32CubeProgrammer`_ runner,
289so its :ref:`installation <stm32cubeprog-flash-host-tools>` is required.
290
291Alternatively, OpenOCD, JLink, or pyOCD can also be used to flash the board using
292the ``--runner`` (or ``-r``) option:
293
294.. code-block:: console
295
296   $ west flash --runner openocd
297   $ west flash --runner jlink
298   $ west flash --runner pyocd
299
300For pyOCD, additional target information needs to be installed.
301This can be done by executing the following commands.
302
303.. code-block:: console
304
305   $ pyocd pack --update
306   $ pyocd pack --install stm32u5
307
308
309Flashing an application to Nucleo U5A5ZJ Q
310------------------------------------------
311
312Connect the Nucleo U5A5ZJ Q to your host computer using the USB port.
313Then build and flash an application. Here is an example for the
314:zephyr:code-sample:`hello_world` application.
315
316Run a serial host program to connect with your Nucleo board:
317
318.. code-block:: console
319
320   $ minicom -D /dev/ttyACM0
321
322Then build and flash the application.
323
324.. zephyr-app-commands::
325   :zephyr-app: samples/hello_world
326   :board: nucleo_u5a5zj_q
327   :goals: build flash
328
329You should see the following message on the console:
330
331.. code-block:: console
332
333   Hello World! arm
334
335Debugging
336=========
337
338Default flasher for this board is openocd. It could be used in the usual way.
339Here is an example for the :zephyr:code-sample:`blinky` application.
340
341.. zephyr-app-commands::
342   :zephyr-app: samples/basic/blinky
343   :board: nucleo_u5a5zj_q
344   :goals: debug
345
346Note: Check the ``build/tfm`` directory to ensure that the commands required by these scripts
347(``readlink``, etc.) are available on your system. Please also check ``STM32_Programmer_CLI``
348(which is used for initialization) is available in the PATH.
349
350.. _STM32 Nucleo-144 board User Manual:
351   https://www.st.com/resource/en/user_manual/um2861-stm32u5-nucleo144-board-mb1549-stmicroelectronics.pdf
352
353.. _STM32U5A5ZJ on www.st.com:
354   https://www.st.com/en/microcontrollers/stm32u5a5zj.html
355
356.. _STM32U5A5 reference manual:
357   https://www.st.com/resource/en/reference_manual/rm0456-stm32u5-series-armbased-32bit-mcus-stmicroelectronics.pdf
358
359.. _STM32CubeProgrammer:
360   https://www.st.com/en/development-tools/stm32cubeprog.html
361
362.. _STMicroelectronics customized version of OpenOCD:
363   https://github.com/STMicroelectronics/OpenOCD
364