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