1.. zephyr:board:: stm32u5a9j_dk
2
3Overview
4********
5
6The STM32U5A9J-DK Discovery kit is a complete demonstration and development
7platform for the STM32U5A9NJH6Q microcontroller, featuring an Arm® Cortex®-M33
8core with Arm® TrustZone®.
9
10Leveraging the innovative ultra-low-power oriented features, 2.5 Mbytes of
11embedded SRAM, 4 Mbytes of embedded flash memory, and rich graphics features,
12the STM32U5A9J-DK Discovery kit enables users to easily prototype applications
13with state-of-the-art energy efficiency, as well as providing stunning and
14optimized graphics rendering with the support of the 2.5D NeoChrom Accelerator,
15Chrom-ART Accelerator, and Chrom-GRC™ MMU.
16
17The full range of hardware features available on the board helps users to
18enhance their application development by an evaluation of all the peripherals
19such as a 2.47-inch RGB 480x480 pixels TFT round LCD module with MIPI DSI®
20interface and capacitive touch panel, USB Type-C® HS, Octo-SPI flash memory
21device, Hexadeca-SPI PSRAM memory device, eMMC flash memory device,
22Time-of-Flight and gesture detection sensor, temperature sensor, and two 2.54 mm
23pitch double-row flexible expansion connectors for easy prototyping with
24daughterboards for specific applications (USART, LPUART, two SPIs, SAI, three
25I2C, SDMMC, ADCs, timers, and GPIOs).
26
27The STM32U5A9J-DK Discovery kit integrates an STLINK-V3E embedded in-circuit
28debugger and programmer for the STM32 microcontroller with a USB Virtual COM
29port bridge and comes with the STM32CubeU5 MCU Package, which provides an STM32
30comprehensive software HAL library as well as various software examples.
31
32.. image:: img/top_view.jpg
33     :align: center
34     :alt: STM32U5A9J-DK Top View
35
36.. image:: img/bottom_view.jpg
37     :align: center
38     :alt: STM32U5A9J-DK Bottom View
39
40More information about the board can be found at the `STM32U5A9J-DK website`_.
41More information about STM32U5A9NJH6Q can be found here:
42
43- `STM32U5A9NJ on www.st.com`_
44- `STM32U5 Series reference manual`_
45- `STM32U5Axxx datasheet`_
46
47Supported Features
48==================
49
50.. zephyr:board-supported-hw::
51
52Pin Mapping
53===========
54
55For more details please refer to `STM32U5A9J-DK board User Manual`_.
56
57Default Zephyr Peripheral Mapping:
58----------------------------------
59
60- USART_1 TX/RX : PA9/PA10 (ST-Link Virtual Port Com)
61- LD3 : PE0
62- LD4 : PE1
63- User Button: PC13
64- USART_3 TX/RX : PB10/PB11
65- LPUART_1 TX/RX : PG7/PG8
66- I2C1 SCL/SDA : PG14/PG13
67- I2C2 SCL/SDA : PF1/PF0
68- I2C6 SCL/SDA : PD1/PD0
69- SPI2 SCK/MISO/MOSI/CS : PB13/PD3/PD4/PB12
70- SPI3 SCK/MISO/MOSI/CS : PG9/PG10/PG11/PG15
71- ADC1 : channel5 PA0, channel14 PC5
72- ADC2 : channel9 PA4
73- ADC4 : channel5 PF14
74
75System Clock
76============
77
78The STM32U5A9J-DK Discovery kit relies on an HSE oscillator (16 MHz crystal)
79and an LSE oscillator (32.768 kHz crystal) as clock references.
80Using the HSE (instead of HSI) is mandatory to manage the DSI interface for
81the LCD module and the USB high‑speed interface.
82
83Serial Port
84===========
85
86The STM32U5A9J Discovery kit has up to 4 USARTs, 2 UARTs, and 1 LPUART.
87The Zephyr console output is assigned to USART1 which connected to the onboard
88ST-LINK/V3.0. Virtual COM port interface. Default communication settings are
89115200 8N1.
90
91
92Programming and Debugging
93*************************
94
95.. zephyr:board-supported-runners::
96
97STM32U5A9J Discovery kit includes an ST-LINK/V3 embedded debug tool interface.
98This probe allows to flash and debug the board using various tools.
99
100Flashing
101========
102
103The board is configured to be flashed using west `STM32CubeProgrammer`_ runner,
104so its :ref:`installation <stm32cubeprog-flash-host-tools>` is required.
105
106Alternatively, OpenOCD can also be used to flash the board using
107the ``--runner`` (or ``-r``) option:
108
109.. code-block:: console
110
111   $ west flash --runner openocd
112
113Flashing an application to STM32U5A9J_DK
114----------------------------------------
115
116Connect the STM32U5A9J Discovery board to your host computer using the USB
117port, then run a serial host program to connect with your Discovery
118board. For example:
119
120.. code-block:: console
121
122   $ minicom -D /dev/ttyACM0 -b 115200
123
124Then, build and flash in the usual way. Here is an example for the
125:zephyr:code-sample:`hello_world` application.
126
127.. zephyr-app-commands::
128   :zephyr-app: samples/hello_world
129   :board: stm32u5a9j_dk
130   :goals: build flash
131
132You should see the following message on the console:
133
134.. code-block:: console
135
136   Hello World! stm32u5a9j_dk
137
138Debugging
139=========
140
141Default debugger for this board is openocd. It could be used in the usual way
142with "west debug" command.
143Here is an example for the :zephyr:code-sample:`blinky` application.
144
145.. zephyr-app-commands::
146   :zephyr-app: samples/basic/blinky
147   :board: stm32u5a9j_dk
148   :goals: debug
149
150
151.. _STM32U5A9J-DK website:
152   https://www.st.com/en/evaluation-tools/stm32u5a9j-dk.html
153
154.. _STM32U5A9J-DK board User Manual:
155   https://www.st.com/resource/en/user_manual/um2967-discovery-kit-with-stm32u5a9nj-mcu-stmicroelectronics.pdf
156
157.. _STM32U5A9NJ on www.st.com:
158   https://www.st.com/en/microcontrollers-microprocessors/stm32u5a9nj.html
159
160.. _STM32U5 Series reference manual:
161   https://www.st.com/resource/en/reference_manual/rm0456-stm32u5-series-armbased-32bit-mcus-stmicroelectronics.pdf
162
163.. _STM32U5Axxx datasheet:
164   https://www.st.com/resource/en/datasheet/stm32u5a9nj.pdf
165
166.. _STM32CubeProgrammer:
167   https://www.st.com/en/development-tools/stm32cubeprog.html
168
169.. _STM32U5A9J_DK board schematics:
170   https://www.st.com/resource/en/schematic_pack/mb1829-u5a9njq-b01-schematic.pdf
171