.. zephyr:board:: nucleo_f722ze

Overview
********

The Nucleo F722ZE board features an ARM Cortex-M7 based STM32F722ZE MCU.

Key Features:

- STM32 microcontroller in LQFP144 package
- USB full-speed/high-speed device
- 3 user LEDs
- 1 user button and 1 reset button
- 32.768 kHz crystal oscillator
- Board connectors:

  - USB Micro-AB
  - SWD
  - ST Zio connector (Arduino Uno R3 compatible)
  - ST Morpho connector

- On-board ST-LINK debugger/programmer
- Flexible power supply options, including ST-LINK VBUS and external sources.

Hardware
********

Nucleo F722ZE provides the following hardware components:

- STM32F722ZET6 microcontroller in LQFP144 package
- ARM |reg| Cortex |reg|-M4 with FPU
- Adaptive Real-Time Accelerator (ART Accelerator)
- 216MHz max CPU frequency
- 512 KB flash
- 256 KB RAM
- I2C (3)
- USART/UART (4)
- SPI (5)
- I2S (3)
- SAI (2)
- USB OTG Full-speed (1)
- USB OTG Full-speed/high-speed (1)
- SDMMC (2)
- CAN (1)
- Dual mode Quad-SPI
- Random number generator (RNG)
- 3x 12-bit ADC, up to 2.4 MSPS with 24 channels or 7.2 MSPS in triple-interleaved mode
- 2x 12-bit DAC
- 16-channel DMA controller
- 16-bit timers (13) with PWM, pulse counter, and quadrature features
- 32-bit timers (2) with PWM, pulse counter, and quadrature features
- CRC
- 96-bit unique ID
- Die temperature

Supported Features
==================

.. zephyr:board-supported-hw::

Connections and IOs
===================

- SDMMC1: Pins marked as "SDMMC" on the ST Zio connector.

  - D0: PC8 (CN8 pin 2)
  - D1: PC9 (CN8 pin 4)
  - D2: PC10 (CN8 pin 6)
  - D3: PC11 (CN8 pin 8)
  - CK: PC12 (CN8 pin 10)
  - CMD: PD2 (CN8 pin 12)

- ADC1:

  - IN3: PA3 (CN9 pin 1, Arduino A0)
  - IN10: PC0 (CN9 pin 3, Arduino A1)

- DAC1:

  - OUT1: PA4 (CN7 pin 17)

- I2C2: Pins marked as "I2C" on the ST Zio connector.

  - SCL: PF1 (CN9 pin 19)
  - SDA: PF0 (CN9 pin 21)

- CAN1: Pins marked as "CAN" on the ST Zio connector.

  - RX: PD0 (CN9 pin 25)
  - TX: PD1 (CN9 pin 27)

- USART2: Pins marked as "USART" on the ST Zio connector.

  - RX: PD6 (CN9 pin 4)
  - TX: PD5 (CN9 pin 6)
  - RTS: PD4 (CN9 pin 8)
  - CTS: PD3 (CN9 pin 10)

- PWM1: Uses TIMER1.

  - PE13 (CN10 pin 10, Arduino D3)
  - PE11 (CN10 pin 6, Arduino D5)

- USART3: Connected to ST-Link virtual COM port.

  - TX: PD8
  - RX: PD9

- USART6: Arduino UART port.

  - RX: PG9 (CN10 pin 16, Arduino D0)
  - TX: PG14 (CN10 pin 14, Arduino D1)

- USBOTG_FS: Connected to USB Micro-AB connector (CN13)

  - DM: PA11
  - DP: PA12
  - ID: PA10

- QUADSPI: Pins marked as "QSPI" on the ST Zio connector.

  - CS: PB6 (CN10 pin 13)
  - CLK: PB2 (CN10 pin 15)
  - IO3: PD13 (CN10 pin 19)
  - IO1: PD12 (CN10 pin 21)
  - IO0: PD11 (CN10 pin 23)
  - IO2: PE2 (CN10 pin 25)

System Clock
------------

By default, the system clock is driven by the external clock supplied by
the ST-LINK interface. Nucleo F722ZE system clock can be driven by internal
or external sources.

Serial Port
-----------

Zephyr console is assigned to UART3 (ST-Link Virtual COM Port) by default,
using 115200 8N1.

Programming and Debugging
*************************

.. zephyr:board-supported-runners::

The ``nucleo_f722ze`` can be flashed and debugged in the typical manner.
The Nucleo F722ZE board includes an ST-LINK V2-1 debugger.

Refer to :ref:`build_an_application` and :ref:`application_run` for detailed
instructions.

Flashing
========

The board is configured to be flashed using west `STM32CubeProgrammer`_ runner,
so its :ref:`installation <stm32cubeprog-flash-host-tools>` is required.

Alternatively, OpenOCD or JLink can also be used to flash the board using
the ``--runner`` (or ``-r``) option:

.. code-block:: console

   $ west flash --runner openocd
   $ west flash --runner jlink

Build the :zephyr:code-sample:`hello_world` application and flash it using the on-board
ST-LINK interface:

.. zephyr-app-commands::
   :zephyr-app: samples/hello_world
   :board: nucleo_f722ze
   :goals: build flash

Debugging
=========

.. zephyr-app-commands::
   :zephyr-app: samples/hello_world
   :board: nucleo_f722ze
   :maybe-skip-config:
   :goals: debug


References
**********

More information about the STM32F722ZE:

- `STM32F722ZE on www.st.com`_
- `STM32F722ZE Reference Manual (RM0431)`_ (PDF)

More information about Nucleo F722ZE:

- `Nucleo F722ZE on www.st.com`_
- `STM32 Nucleo-144 User Manual (UM1974)`_ (PDF)

.. _SEGGER J-Link OB firmware:
   https://www.segger.com/products/debug-probes/j-link/models/other-j-links/st-link-on-board/

.. _STM32F722ZE on www.st.com:
   https://www.st.com/en/microcontrollers-microprocessors/stm32f722ze.html

.. _STM32F722ZE Reference Manual (RM0431):
   https://www.st.com/resource/en/reference_manual/rm0431-stm32f72xxx-and-stm32f73xxx-advanced-armbased-32bit-mcus-stmicroelectronics.pdf

.. _Nucleo F722ZE on www.st.com:
   https://www.st.com/en/evaluation-tools/nucleo-f722ze.html

.. _STM32 Nucleo-144 User Manual (UM1974):
   https://www.st.com/resource/en/user_manual/um1974-stm32-nucleo144-boards-mb1137-stmicroelectronics.pdf

.. _STM32CubeProgrammer:
   https://www.st.com/en/development-tools/stm32cubeprog.html
