1.. zephyr:board:: nucleo_h723zg
2
3Overview
4********
5
6The STM32 Nucleo-144 board provides an affordable and flexible way for users
7to try out new concepts and build prototypes by choosing from the various combinations
8of performance and power consumption features, provided by the STM32 microcontroller.
9For the compatible boards, the internal or external SMPS significantly reduces power
10consumption in Run mode.
11
12The ST Zio connector, which extends the ARDUINO® Uno V3 connectivity, and
13the ST morpho headers provide an easy means of expanding the functionality of the Nucleo
14open development platform with a wide choice of specialized shields.
15The STM32 Nucleo-144 board does not require any separate probe as it integrates
16the ST-LINK V3 debugger/programmer.
17
18The STM32 Nucleo-144 board comes with the STM32 comprehensive free software
19libraries and examples available with the STM32Cube MCU Package.
20
21Key Features
22
23- STM32 microcontroller in LQFP144 package
24- Ethernet compliant with IEEE-802.3-2002 (depending on STM32 support)
25- USB OTG or full-speed device (depending on STM32 support)
26- 3 user LEDs
27- 2 user and reset push-buttons
28- 32.768 kHz crystal oscillator
29- Board connectors:
30
31 - USB with Micro-AB
32 - Ethernet RJ45 (depending on STM32 support)
33 - SWDST Zio connector including Arduino* Uno V3ST
34 - ST morpho expansion
35
36- Flexible power-supply options: ST-LINK USB VBUS or external sources
37- External or internal SMPS to generate Vcore logic supply
38- On-board ST-LINK/V3 debugger/programmer with USB re-enumeration
39- capability: mass storage, virtual COM port and debug port
40- USB OTG full speed or device only
41
42More information about the board can be found at the `Nucleo H723ZG website`_.
43
44Hardware
45********
46
47Nucleo H723ZG provides the following hardware components:
48
49- STM32H723ZG in LQFP144 package
50- ARM 32-bit Cortex-M7 CPU with FPU
51- Chrom-ART Accelerator
52- Hardware JPEG Codec
53- 550 MHz max CPU frequency
54- VDD from 1.62 V to 3.6 V
55- 1 MB Flash
56- 562 kB SRAM max (376 kb used currently)
57- High-resolution timer (2.1 ns)
58- 32-bit timers(2)
59- 16-bit timers(12)
60- SPI(6)
61- I2C(4)
62- I2S (3)
63- USART(4)
64- UART(4)
65- USB OTG Full Speed and High Speed(1)
66- USB OTG Full Speed(1)
67- CAN FD(2)
68- SAI(2)
69- SPDIF_Rx(4)
70- HDMI_CEC(1)
71- Dual Mode Quad SPI(1)
72- Camera Interface
73- GPIO (up to 114) with external interrupt capability
74- 16-bit ADC(3) with 36 channels / 3.6 MSPS
75- 12-bit DAC with 2 channels(2)
76- True Random Number Generator (RNG)
77- 16-channel DMA
78- LCD-TFT Controller with XGA resolution
79
80Supported Features
81==================
82
83.. zephyr:board-supported-hw::
84
85For more details please refer to `STM32 Nucleo-144 board User Manual`_.
86
87Default Zephyr Peripheral Mapping:
88----------------------------------
89
90The Nucleo H723ZG board features a ST Zio connector (extended Arduino Uno V3)
91and a ST morpho connector. Board is configured as follows:
92
93- UART_3 TX/RX : PD8/PD9 (ST-Link Virtual Port Com)
94- USER_PB : PC13
95- LD1 : PB0
96- LD2 : PE1
97- LD3 : PB14
98- I2C : PB8, PB9
99- SPI1 NSS/SCK/MISO/MOSI : PD14/PA5/PA6/PB5 (Arduino SPI)
100- FDCAN1 RX/TX : PD0, PD1
101
102System Clock
103------------
104
105Nucleo H723ZG System Clock could be driven by an internal or external
106oscillator, as well as the main PLL clock. By default, the System clock is
107driven by the PLL clock at 550MHz, driven by an 8MHz high-speed external clock.
108
109Serial Port
110-----------
111
112Nucleo H723ZG board has 4 UARTs and 4 USARTs. The Zephyr console output is
113assigned to UART3. Default settings are 115200 8N1.
114
115Backup SRAM
116-----------
117
118In order to test backup SRAM you may want to disconnect VBAT from VDD. You can
119do it by removing ``SB52`` jumper on the back side of the board.
120
121FDCAN
122=====
123
124The Nucleo H723ZG board does not have any onboard CAN transceiver. In order to
125use the FDCAN bus on this board, an external CAN bus transceiver must be
126connected to pins PD0 (RX) and PD1 (TX).
127
128Programming and Debugging
129*************************
130
131.. zephyr:board-supported-runners::
132
133Nucleo H723ZG board includes an ST-LINK/V3 embedded debug tool interface.
134
135.. note::
136
137   Check if your ST-LINK V3 has newest FW version. It can be done with `STM32CubeProgrammer`_
138
139Flashing
140========
141
142The board is configured to be flashed using west `STM32CubeProgrammer`_ runner,
143so its :ref:`installation <stm32cubeprog-flash-host-tools>` is required.
144
145Alternatively, OpenOCD or JLink can also be used to flash the board using
146the ``--runner`` (or ``-r``) option:
147
148.. code-block:: console
149
150   $ west flash --runner openocd
151   $ west flash --runner jlink
152
153Flashing an application to Nucleo H723ZG
154----------------------------------------
155
156First, connect the NUCLEO-H723ZG to your host computer using
157the USB port to prepare it for flashing. Then build and flash your application.
158
159Here is an example for the :zephyr:code-sample:`hello_world` application.
160
161Run a serial host program to connect with your NUCLEO-H723ZG board.
162
163.. code-block:: console
164
165   $ minicom -b 115200 -D /dev/ttyACM0
166
167or use screen:
168
169.. code-block:: console
170
171   $ screen /dev/ttyACM0 115200
172
173Build and flash the application:
174
175.. zephyr-app-commands::
176   :zephyr-app: samples/hello_world
177   :board: nucleo_h723zg
178   :goals: build flash
179
180You should see the following message on the console:
181
182.. code-block:: console
183
184   $ Hello World! nucleo_h723zg
185
186Blinky example can also be used:
187
188.. zephyr-app-commands::
189   :zephyr-app: samples/basic/blinky
190   :board: nucleo_h723zg
191   :goals: build flash
192
193Debugging
194=========
195
196You can debug an application in the usual way.  Here is an example for the
197:zephyr:code-sample:`hello_world` application.
198
199.. zephyr-app-commands::
200   :zephyr-app: samples/hello_world
201   :board: nucleo_h723zg
202   :maybe-skip-config:
203   :goals: debug
204
205.. _Nucleo H723ZG website:
206   https://www.st.com/en/evaluation-tools/nucleo-h723zg.html
207
208.. _STM32 Nucleo-144 board User Manual:
209   https://www.st.com/resource/en/user_manual/dm00499160-stm32h7-nucleo144-boards-mb1364-stmicroelectronics.pdf
210
211.. _STM32H723ZG on www.st.com:
212   https://www.st.com/en/microcontrollers-microprocessors/stm32h723zg.html
213
214.. _STM32H723 reference manual:
215   https://www.st.com/resource/en/reference_manual/dm00603761-stm32h723733-stm32h725735-and-stm32h730-value-line-advanced-armbased-32bit-mcus-stmicroelectronics.pdf
216
217.. _OpenOCD installing Debug Version:
218   https://github.com/zephyrproject-rtos/openocd
219
220.. _OpenOCD installing with ST-LINK V3 support:
221   https://mbd.kleier.net/integrating-st-link-v3.html
222
223.. _STM32CubeIDE:
224   https://www.st.com/en/development-tools/stm32cubeide.html
225
226.. _STM32CubeProgrammer:
227   https://www.st.com/en/development-tools/stm32cubeprog.html
228