Nucleo H5E5ZJ

Overview

The NUCLEO-H5E5ZJ is an STM32 Nucleo-144 development board based on the STM32H5E5ZJT6 microcontroller. ST identifies the board as MB2129.

The board provides:

  • An Arm® Cortex®-M33 microcontroller running at up to 250 MHz, with an FPU, an MPU, and Arm TrustZone® support.

  • 4 MiB of internal flash and 1536 KiB of SRAM in an LQFP144 package.

  • An embedded ST-LINK debug interface and a USART3 virtual COM port.

  • Three user LEDs: green LD1, red LD2, and blue LD3.

  • A user push-button and a reset push-button.

  • Arduino Uno V3 and ST morpho expansion connectors.

  • A USB high-speed interface with an integrated PHY.

See the NUCLEO-H5E5ZJ product page for board documentation and the STM32H5E5ZJ product page for device documentation. The pin assignments below follow ST’s board configuration, Nucleo BSP, and STM32CubeH5 examples.

Hardware

Supported Features

The nucleo_h5e5zj board supports the hardware features listed below.

on-chip / on-board
Feature integrated in the SoC / present on the board.
2 / 2
Number of instances that are enabled / disabled.
Click on the label to see the first instance of this feature in the board/SoC DTS files.
vnd,foo
Compatible string for the Devicetree binding matching the feature.
Click on the link to view the binding documentation.

nucleo_h5e5zj/stm32h5e5xx target

On-target memory for this board target: 256 KiB of RAM, 4 MiB of Flash.

Type

Location

Description

Compatible

CPU

on-chip

ARM Cortex-M33 CPU1

arm,cortex-m33

ADC

on-chip

STM32 ADC2

st,stm32-adc

CAN

on-chip

STM32 FDCAN CAN FD controller12

st,stm32-fdcan

Clock control

on-chip

STM32H5 RCC (Reset and Clock controller)1

st,stm32h5-rcc

on-chip

STM32 HSE Clock1

st,stm32-hse-clock

on-chip

STM32 HSI Clock1

st,stm32h7-hsi-clock

on-chip

STM32 HSI48 Clock1

st,stm32-hsi48-clock

on-chip

Generic fixed-rate clock provider2

fixed-clock

on-chip

STM32 LSE Clock1

st,stm32-lse-clock

on-chip

STM32H5 PLL.12

st,stm32h5-pll-clock

on-chip

STM32 Microcontroller Clock Output (MCO)2

st,stm32-clock-mco

Counter

on-chip

STM32 counters14

st,stm32-counter

CRC

on-chip

STM32 CRC calculation unit1

st,stm32-crc

Cryptographic accelerator

on-chip

STM32 HASH Processor1

st,stm32-hash

DAC

on-chip

STM32 family DAC1

st,stm32-dac

Display

on-chip

STM32 LCD-TFT display controller1

st,stm32-ltdc

on-chip

STM32 Chrom-ART Accelerator (DMA2D)1

st,stm32-dma2d

DMA

on-chip

STM32U5 DMA controller2

st,stm32u5-dma

Ethernet

on-chip

ST STM32 Ethernet MAC1

st,stm32h5-ethernet

on-chip

Synopsys DesignWare MAC MDIO controller1

snps,dwmac-mdio

on-chip

Synopsys DesignWare MAC PTP (Precision Time Protocol) Clock1

snps,dwmac-ptp-clock

Flash controller

on-chip

STM32 Family flash controller1

st,stm32-flash-controller

GPIO & Headers

on-chip

STM32 GPIO Controller11

st,stm32-gpio

on-board

GPIO pins exposed on Arduino Uno (R3) headers1

arduino-header-r3

on-board

GPIO pins exposed on ST Morpho connector1

st-morpho-header

I2C

on-chip

STM32 I2C V2 controller13

st,stm32-i2c-v2

I2S

on-chip

STM32H7 I2S controller3

st,stm32h7-i2s

on-chip

STM32 SAI Block controller2

st,stm32-sai

I3C

on-chip

STM32H5 I3C controller2

st,stm32-i3c

Input

on-board

Group of GPIO-bound input keys1

gpio-keys

Interrupt controller

on-chip

ARMv8-M NVIC (Nested Vectored Interrupt Controller)1

arm,v8m-nvic

on-chip

STM32G0 External Interrupt Controller1

st,stm32g0-exti

LED

on-board

Group of GPIO-controlled LEDs1

gpio-leds

on-board

Group of PWM-controlled LEDs1

pwm-leds

Memory controller

on-chip

STM32 Flexible Memory Controller (FMC)1

st,stm32-fmc

MMU / MPU

on-chip

ARMv8-M MPU (Memory Protection Unit)1

arm,armv8m-mpu

MTD

on-chip

STM32 flash memory1

st,stm32-nv-flash

NVMEM

on-chip

Fixed layout for Non-Volatile memory1

fixed-layout

OTP memory

on-chip

STM32 embedded NVM OTP11

st,stm32-nvm-otp

PHY

on-chip

This binding is to be used by all the usb transceivers which are built-in with USB IP1

usb-nop-xceiv

on-chip

STM32 USB HS PHY controller (USBPHYC)1

st,stm32-usbphyc

Pin control

on-chip

STM32 pin controller with High-Speed Low-Voltage (HSLV) support1

st,stm32h5-pinctrl

Power management

on-chip

STM32 power controller1

st,stm32-pwr

on-chip

STM32 wake-up lines controller1

st,stm32-pwr-wkupctrl

on-chip

STM32H5 I/O cell controller1

st,stm32h5-iocell

PWM

on-chip

STM32 PWM12

st,stm32-pwm

Regulator

on-chip

STM32 VREFBUF regulator1

st,stm32-vrefbuf

Reset controller

on-chip

STM32 Reset and Clock Control (RCC) Controller1

st,stm32-rcc-rctl

RNG

on-chip

STM32 Random Number Generator1

st,stm32-rng

RTC

on-chip

STM32 RTC1

st,stm32-rtc

SDHC

on-chip

STM32 SDMMC Host Controller2

st,stm32-sdmmc

Sensors

on-chip

STM32 quadrature decoder6

st,stm32-qdec

on-chip

STM32 Digital Temperature Sensor1

st,stm32-digi-temp

on-chip

STM32 family TEMP node for production calibrated sensors with two calibration temperatures1

st,stm32-temp-cal

on-chip

STM32 VREF+1

st,stm32-vref

on-chip

STM32 VBAT1

st,stm32-vbat

on-chip

STM32 Vddcore1

st,stm32-vddcore

Serial controller

on-chip

STM32 USART15

st,stm32-usart

on-chip

STM32 LPUART1

st,stm32-lpuart

on-chip

STM32 UART15

st,stm32-uart

SMbus

on-chip

STM32 SMBus controller4

st,stm32-smbus

SPI

on-chip

STM32H7 SPI controller15

st,stm32h7-spi

USB Type-C Port Controller

on-chip

STM32 USB Type-C / Power Delivery1

st,stm32-ucpd

Timer

on-chip

ARMv8-M System Tick1

arm,armv8m-systick

on-chip

STM32 timers113

st,stm32-timers

on-chip

STM32U5 LPTIM6

st,stm32u5-lptim

USB

on-chip

STM32 OTGFS controller1

st,stm32-otgfs

on-chip

STM32 OTGHS controller without pinmux1

st,stm32n6-otghs

Video

on-chip

STM32 JPEG HW Codec1

st,stm32-jpeg

Watchdog

on-chip

STM32 system window watchdog1

st,stm32-window-watchdog

on-chip

STM32 watchdog1

st,stm32-watchdog

xSPI

on-chip

STM32 XSPI Controller2

st,stm32-xspi

on-chip

STM32 XSPI Controller Manager1

st,stm32-xspim

Default Peripheral Mapping

Interface

Pins

Use

USART3 TX / RX

PD8 / PD9

ST-LINK virtual COM port

UART7 TX / RX

PB4 / PA8

Arduino D1 / D0

I2C4 SCL / SDA

PF5 / PG6

Expansion interface

SPI4 SCK / MISO / MOSI

PE12 / PE13 / PE14

Arduino D13 / D12 / D11

FDCAN1 TX / RX

PD5 / PE0

External CAN transceiver

LD1, green

PA3, active-high

led0

LD2, red

PF0, active-low

led1

LD3, blue

PE5, active-low

led2

User button

PC13, active-high

sw0

TIM2 channel 4 (disabled by default)

PA3

pwm-led0 (requires overlay enabling pwm2 and pwmleds)

ADC1 channels 2 / 6 / 7 / 9 / 3

PF11 / PF12 / PA7 / PB0 / PA6

Analog inputs

USB OTG HS

Dedicated OTG_HS_DM / OTG_HS_DP pins

zephyr_udc0

The console uses USART3 at 115200 baud, 8 data bits, no parity, and one stop bit. UART7 is also available through the arduino_serial devicetree label.

The green LED is shared by the GPIO and PWM interfaces. Do not use both interfaces for PA3 at the same time. The PWM configuration uses TIM2 channel 4.

SPI4 configures the three data and clock signals. An application must provide the chip-select GPIO required by its SPI device.

FDCAN1 is the default zephyr,canbus controller and requires an external CAN transceiver.

System Clock

The default configuration follows ST’s clock template: a 48 MHz external crystal feeds PLL1, with M = 12, N = 125, and P = 2. The CPU, AHB, and APB clocks run at 250 MHz. A 32.768 kHz external crystal supplies the RTC.

Memory

The board target exposes the full 4 MiB of internal flash. SRAM1 is the default Zephyr RAM region and provides 256 KiB. SRAM2 through SRAM5 are described by the SoC devicetree and provide the remaining 1280 KiB; they are not included in the default linker RAM region.

Other Interfaces

ST’s board configuration also describes the following Ethernet RMII signals:

  • Reference clock: PA1

  • CRS_DV: PD1

  • RXD0 / RXD1: PC4 / PC5

  • TX_EN: PA5

  • TXD0 / TXD1: PB12 / PG12

  • MDIO / MDC: PA2 / PC1

  • PHY clock output: PD4

Programming and Debugging

The nucleo_h5e5zj board supports the runners and associated west commands listed below.

flash debug debugserver attach
stlink_gdbserver ✅ (default) ✅ ✅
stm32cubeprogrammer ✅ (default)

Connect the embedded ST-LINK USB interface to the host. Install STM32CubeProgrammer to use the default flash runner.

Building and Flashing

Build and flash the Hello World application:

# From the root of the zephyr repository
west build -b nucleo_h5e5zj samples/hello_world
west flash

Open the ST-LINK virtual COM port with the console settings above. On Linux, the port is typically named /dev/ttyACM0. The application prints:

Hello World! nucleo_h5e5zj/stm32h5e5xx

Debugging

The ST-LINK GDB server is configured as the debug runner:

west debug --runner stlink_gdbserver

References