Add support for the STM32MP257F Evaluation board (EV1) [1].
The goal is an image built from upstream components:
- TF-A v2.15.0
- U-Boot 2026.10
- Linux 7.3
configured, where possible, with the same build options used by the
official STMicroelectronics OpenSTLinux Yocto layers [2].
This was not possible for OP-TEE OS. Indeed upstream OP-TEE OS does not
support yet, on STM32MP25, the STPMIC2 PMIC and the SCMI voltage
domains, which the mainline Linux device tree requires for the microSD
card supplies [3]. Until this is resolved, the STMicroelectronics
downstream version (4.0.0-stm32mp-r3) has to be used.
Host bmap-tools is enabled to speed up the flashing of the microSD
card, which is much faster than with dd.
[1] https://www.st.com/en/evaluation-tools/stm32mp257f-ev1.html
[2] https://github.com/STMicroelectronics/meta-st-stm32mp/tree/openstlinux-6.6-yocto-scarthgap-mpu-v26.02.18
[3] https://github.com/OP-TEE/optee_os/issues/8027
Signed-off-by: Dario Binacchi <dario.binacchi@amarulasolutions.com>
---
DEVELOPERS | 2 +
.../stm32mp257f-ev1/genimage.cfg | 52 ++++++++++++++
.../overlay/boot/extlinux/extlinux.conf | 4 ++
.../overlay/etc/fwumdata.config | 4 ++
.../arm-trusted-firmware.hash | 2 +
...-arm-smc-id-of-the-SMC-watchdog-on-s.patch | 53 ++++++++++++++
.../stm32mp257f-ev1/patches/linux/linux.hash | 2 +
...2mp25-rename-the-PCIe-bus-SCMI-clock.patch | 44 ++++++++++++
.../patches/optee-os/optee-os.hash | 2 +
.../stm32mp257f-ev1/patches/uboot/uboot.hash | 2 +
.../stm32mp257f-ev1/post-image.sh | 18 +++++
.../stm32mp257f-ev1/readme.txt | 72 +++++++++++++++++++
configs/stm32mp257f_ev1_defconfig | 66 +++++++++++++++++
13 files changed, 323 insertions(+)
create mode 100644 board/stmicroelectronics/stm32mp257f-ev1/genimage.cfg
create mode 100644 board/stmicroelectronics/stm32mp257f-ev1/overlay/boot/extlinux/extlinux.conf
create mode 100644 board/stmicroelectronics/stm32mp257f-ev1/overlay/etc/fwumdata.config
create mode 100644 board/stmicroelectronics/stm32mp257f-ev1/patches/arm-trusted-firmware/arm-trusted-firmware.hash
create mode 100644 board/stmicroelectronics/stm32mp257f-ev1/patches/linux/0001-arm64-dts-st-fix-arm-smc-id-of-the-SMC-watchdog-on-s.patch
create mode 100644 board/stmicroelectronics/stm32mp257f-ev1/patches/linux/linux.hash
create mode 100644 board/stmicroelectronics/stm32mp257f-ev1/patches/optee-os/0001-dts-stm32mp25-rename-the-PCIe-bus-SCMI-clock.patch
create mode 100644 board/stmicroelectronics/stm32mp257f-ev1/patches/optee-os/optee-os.hash
create mode 100644 board/stmicroelectronics/stm32mp257f-ev1/patches/uboot/uboot.hash
create mode 100755 board/stmicroelectronics/stm32mp257f-ev1/post-image.sh
create mode 100644 board/stmicroelectronics/stm32mp257f-ev1/readme.txt
create mode 100644 configs/stm32mp257f_ev1_defconfig
@@ -811,6 +811,7 @@ F: board/bsh/
F: board/stmicroelectronics/stm32f746-disco/
F: board/stmicroelectronics/stm32f769-disco/
F: board/stmicroelectronics/stm32h747-disco/
+F: board/stmicroelectronics/stm32mp257f-ev1/
F: boot/stm32-ddr-phy-binary/
F: boot/ti-k3-boot-firmware/
F: configs/imx6ulz_bsh_smm_m2_defconfig
@@ -819,6 +820,7 @@ F: configs/imx8mn_bsh_smm_s2_pro_defconfig
F: configs/stm32f746_disco_sd_defconfig
F: configs/stm32f769_disco_sd_defconfig
F: configs/stm32h747_disco_sd_defconfig
+F: configs/stm32mp257f_ev1_defconfig
F: package/aespipe/
F: package/armadillo/
F: package/atf/
new file mode 100644
@@ -0,0 +1,52 @@
+image sdcard.img {
+ hdimage {
+ partition-table-type = "gpt"
+ }
+
+ partition fsbla1 {
+ image = "tf-a-stm32mp257f-ev1.stm32"
+ size = 256K
+ }
+
+ partition fsbla2 {
+ image = "tf-a-stm32mp257f-ev1.stm32"
+ size = 256K
+ }
+
+ partition metadata1 {
+ image = "fwu-mdata.bin"
+ partition-type-uuid = "${FWU_MDATA_TYPE_UUID}"
+ size = 256K
+ }
+
+ partition metadata2 {
+ image = "fwu-mdata.bin"
+ partition-type-uuid = "${FWU_MDATA_TYPE_UUID}"
+ size = 256K
+ }
+
+ partition fip-a {
+ image = "fip.bin"
+ partition-type-uuid = "${FIP_TYPE_UUID}"
+ partition-uuid = "${FIP_A_UUID}"
+ size = 4M
+ }
+
+ partition fip-b {
+ image = "fip.bin"
+ partition-type-uuid = "${FIP_TYPE_UUID}"
+ partition-uuid = "${FIP_B_UUID}"
+ size = 4M
+ }
+
+ partition u-boot-env {
+ partition-type-uuid = "3de21764-95bd-54bd-a5c3-4abe786f38a8"
+ size = 512K
+ }
+
+ partition rootfs {
+ image = "rootfs.ext4"
+ partition-uuid = "e91c4e10-16e6-4c0e-bd0e-77becf4a3582"
+ bootable = "yes"
+ }
+}
new file mode 100644
@@ -0,0 +1,4 @@
+label stm32mp257f-ev1-buildroot
+ kernel /boot/Image.gz
+ devicetree /boot/stm32mp257f-ev1.dtb
+ append root=PARTUUID=e91c4e10-16e6-4c0e-bd0e-77becf4a3582 rootwait console=ttySTM0,115200 earlycon
new file mode 100644
@@ -0,0 +1,4 @@
+# FWU metadata location: <device> <offset> <metadata_size>
+# metadata1 and metadata2 partitions of the SD card (see genimage.cfg)
+/dev/mmcblk0p3 0x0 0x78
+/dev/mmcblk0p4 0x0 0x78
new file mode 100644
@@ -0,0 +1,2 @@
+# Locally calculated
+sha256 b807d8bf190b7c46b4260729b4bbe2f7df83cd1086edcb181d66595ae6598d23 arm-trusted-firmware-v2.15.0-git4.tar.gz
new file mode 100644
@@ -0,0 +1,53 @@
+From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
+From: Mateusz Nowicki <mateusz.nowicki@posteo.net>
+Date: Mon, 7 Sep 2026 09:14:11 +0000
+Subject: [PATCH] arm64: dts: st: fix arm,smc-id of the SMC watchdog on
+ stm32mp2
+
+OP-TEE implements the STM32MP2 watchdog SMC service with function ID
+0xbc000000 (CFG_WDT_SM_HANDLER_ID), not 0xb200005a. With the current
+value the arm_smc_wdt probe fails with -EIO and the IWDG started by the
+bootloader is never refreshed.
+
+Fixes: 89fca38168c9 ("arm64: dts: st: add arm-wdt node for watchdog support on stm32mp251")
+Fixes: e9b03ef21386 ("arm64: dts: st: introduce stm32mp23 SoCs family")
+Signed-off-by: Mateusz Nowicki <mateusz.nowicki@posteo.net>
+Reviewed-by: Antonio Borneo <antonio.borneo@foss.st.com>
+Link: https://lore.kernel.org/r/20260907091400.55954-1-mateusz.nowicki@posteo.net
+Signed-off-by: Alexandre Torgue <alexandre.torgue@foss.st.com>
+Upstream: https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git/commit/?id=ae4d08bbe3f4f5ec920dbdba26091adf0ae6ba71
+Signed-off-by: Dario Binacchi <dario.binacchi@amarulasolutions.com>
+---
+ arch/arm64/boot/dts/st/stm32mp231.dtsi | 2 +-
+ arch/arm64/boot/dts/st/stm32mp251.dtsi | 2 +-
+ 2 files changed, 2 insertions(+), 2 deletions(-)
+
+diff --git a/arch/arm64/boot/dts/st/stm32mp231.dtsi b/arch/arm64/boot/dts/st/stm32mp231.dtsi
+index 0feb8943efae..1f297163fae2 100644
+--- a/arch/arm64/boot/dts/st/stm32mp231.dtsi
++++ b/arch/arm64/boot/dts/st/stm32mp231.dtsi
+@@ -35,7 +35,7 @@ arm-pmu {
+
+ arm_wdt: watchdog {
+ compatible = "arm,smc-wdt";
+- arm,smc-id = <0xb200005a>;
++ arm,smc-id = <0xbc000000>;
+ status = "disabled";
+ };
+
+diff --git a/arch/arm64/boot/dts/st/stm32mp251.dtsi b/arch/arm64/boot/dts/st/stm32mp251.dtsi
+index 44938c036e30..ea1b04002b28 100644
+--- a/arch/arm64/boot/dts/st/stm32mp251.dtsi
++++ b/arch/arm64/boot/dts/st/stm32mp251.dtsi
+@@ -36,7 +36,7 @@ arm-pmu {
+
+ arm_wdt: watchdog {
+ compatible = "arm,smc-wdt";
+- arm,smc-id = <0xb200005a>;
++ arm,smc-id = <0xbc000000>;
+ status = "disabled";
+ };
+
+--
+2.43.0
+
new file mode 100644
@@ -0,0 +1,2 @@
+# From https://www.kernel.org/pub/linux/kernel/v7.x/sha256sums.asc
+sha256 87363c24f10e06321eb362765521094e94471f6bff8bce2d6b3e40f39f004953 linux-7.3.tar.xz
new file mode 100644
@@ -0,0 +1,44 @@
+From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
+From: Dario Binacchi <dario.binacchi@amarulasolutions.com>
+Date: Tue, 20 Oct 2026 12:26:20 +0200
+Subject: [PATCH] dts: stm32mp25: rename the PCIe bus SCMI clock
+
+The PCIe bus clock is exposed to the Cortex-A35 agent through SCMI with
+the ck_icn_p_pcie domain name, which is also the name of the same clock
+in the mainline Linux stm32mp25 RCC driver. When the mainline kernel
+is used, the SCMI clock driver registers ck_icn_p_pcie first and the
+RCC driver fails to probe, leaving the system without clock tree,
+console and SD card:
+
+ stm32mp25_rcc 44200000.clock-controller: error -EEXIST: failed to register clk 'ck_icn_p_pcie' (ck_icn_p_pcie+0x8/0x38)
+ stm32mp25_rcc 44200000.clock-controller: probe with driver stm32mp25_rcc failed with error -17
+
+Mainline Linux does not use this SCMI clock: the PCIe nodes reference
+the RCC clock directly (<&rcc CK_BUS_PCIE>).
+
+Rename the SCMI clock domain to ck_scmi_icn_pcie. Only the name exposed
+through SCMI changes: the SCMI clock ID (CK_SCMI_ICN_PCIE) is unchanged,
+so device trees referencing this clock by its ID are not affected.
+
+Upstream: https://github.com/STMicroelectronics/optee_os/pull/5
+Signed-off-by: Dario Binacchi <dario.binacchi@amarulasolutions.com>
+---
+ core/arch/arm/dts/stm32mp25-st-scmi-cfg.dtsi | 2 +-
+ 1 file changed, 1 insertion(+), 1 deletion(-)
+
+diff --git a/core/arch/arm/dts/stm32mp25-st-scmi-cfg.dtsi b/core/arch/arm/dts/stm32mp25-st-scmi-cfg.dtsi
+index f0c164ffdcf1..284e8208a8a8 100644
+--- a/core/arch/arm/dts/stm32mp25-st-scmi-cfg.dtsi
++++ b/core/arch/arm/dts/stm32mp25-st-scmi-cfg.dtsi
+@@ -857,7 +857,7 @@
+
+ clock@84 {
+ reg = <CK_SCMI_ICN_PCIE>;
+- domain-name = "ck_icn_p_pcie";
++ domain-name = "ck_scmi_icn_pcie";
+ clocks = <&rcc CK_BUS_PCIE>;
+ flags = <SCMI_CLOCK_DEFAULT_ENABLED>;
+ };
+--
+2.43.0
+
new file mode 100644
@@ -0,0 +1,2 @@
+# Locally calculated
+sha256 0fb0ef4c2d303bea8c2c7e2dfbab6e04bc92da631b778b1ba834ee320f869f03 optee-os-4.0.0-stm32mp-r3.tar.gz
new file mode 100644
@@ -0,0 +1,2 @@
+# Locally calculated
+sha256 3f856da3cbbc93af51ff95fde18588a348b4a26723b01d9841e999d988481015 u-boot-2026.10.tar.bz2
new file mode 100755
@@ -0,0 +1,18 @@
+#!/bin/sh
+
+set -e
+
+BOARD_DIR="$(dirname "$0")"
+
+# GPT partition type and partition UUIDs, also used by genimage.cfg
+export FWU_MDATA_TYPE_UUID="8a7a84a0-8387-40f6-ab41-a8b9a5a60d23"
+export FIP_TYPE_UUID="19d5df83-11b0-457b-be2c-7559c13142a5"
+export FIP_A_UUID="4fd84c93-54ef-463f-a7ef-ae25ff887087"
+export FIP_B_UUID="09c54952-d5bf-45af-acee-335303766fb3"
+
+# FWU metadata (v2): 1 image (the FIP) per bank, 2 banks (fip-a, fip-b)
+"${HOST_DIR}/bin/mkfwumdata" -g -i 1 -b 2 -v 2 \
+ "${FWU_MDATA_TYPE_UUID},${FIP_TYPE_UUID},${FIP_A_UUID},${FIP_B_UUID}" \
+ "${BINARIES_DIR}/fwu-mdata.bin"
+
+support/scripts/genimage.sh -c "${BOARD_DIR}/genimage.cfg"
new file mode 100644
@@ -0,0 +1,72 @@
+STM32MP257F Evaluation board
+
+Intro
+=====
+
+This configuration supports the STM32MP257F Evaluation board (EV1)
+platform:
+
+ https://www.st.com/en/evaluation-tools/stm32mp257f-ev1.html
+
+It uses mainline Linux, U-Boot and TF-A, the STMicroelectronics
+downstream version of OP-TEE OS, and boots from the microSD card using
+the FWU (Firmware Update) multi bank layout of the TF-A FIP: two FIP
+banks (fip-a and fip-b) and two redundant copies of the FWU metadata
+(metadata1 and metadata2) selecting the active bank.
+
+The STMicroelectronics downstream OP-TEE OS is used because upstream
+OP-TEE OS does not support yet, on STM32MP25, the STPMIC2 PMIC, the PWR
+regulators and their exposure through the SCMI voltage domain protocol,
+which the mainline Linux device tree requires for the microSD card
+supplies. See the related upstream discussion:
+
+ https://github.com/OP-TEE/optee_os/issues/8027
+
+How to build
+============
+
+ $ make stm32mp257f_ev1_defconfig
+ $ make
+
+How to write the microSD card
+=============================
+
+Once the build process is finished you will have an image called
+"sdcard.img" in the output/images/ directory, together with its block
+map "sdcard.img.bmap".
+
+Copy the bootable "sdcard.img" onto a microSD card with "bmaptool",
+which only writes the blocks actually used by the image:
+
+ $ sudo bmaptool copy output/images/sdcard.img /dev/sdX
+
+Alternatively, with "dd":
+
+ $ sudo dd if=output/images/sdcard.img of=/dev/sdX
+
+Boot the board
+==============
+
+ (1) Set the boot switches to boot from the microSD card and insert
+ the microSD card.
+
+ (2) Plug a USB cable in the ST-LINK connector and run your serial
+ communication program on /dev/ttyACM0 (115200 8N1).
+
+ (3) Power-up the board.
+
+ (4) The system will start, with the console on UART.
+
+FWU metadata
+============
+
+The FWU metadata is generated at build time by the host mkfwumdata
+tool, with fip-a as active bank. It can be inspected and modified
+from Linux with the fwumdata tool, configured by /etc/fwumdata.config:
+
+ # fwumdata -l
+
+For example, to boot the FIP from the fip-b partition:
+
+ # fwumdata -a 1 -p 0
+ # reboot
new file mode 100644
@@ -0,0 +1,66 @@
+BR2_aarch64=y
+BR2_cortex_a35=y
+BR2_TOOLCHAIN_EXTERNAL=y
+BR2_TOOLCHAIN_EXTERNAL_BOOTLIN=y
+BR2_TOOLCHAIN_EXTERNAL_BOOTLIN_AARCH64_GLIBC_STABLE=y
+BR2_GLOBAL_PATCH_DIR="board/stmicroelectronics/stm32mp257f-ev1/patches"
+BR2_DOWNLOAD_FORCE_CHECK_HASHES=y
+BR2_ROOTFS_DEVICE_CREATION_DYNAMIC_MDEV=y
+BR2_ROOTFS_OVERLAY="board/stmicroelectronics/stm32mp257f-ev1/overlay"
+BR2_ROOTFS_POST_IMAGE_SCRIPT="board/stmicroelectronics/stm32mp257f-ev1/post-image.sh"
+BR2_LINUX_KERNEL=y
+BR2_LINUX_KERNEL_CUSTOM_VERSION=y
+BR2_LINUX_KERNEL_CUSTOM_VERSION_VALUE="7.3"
+BR2_LINUX_KERNEL_USE_ARCH_DEFAULT_CONFIG=y
+BR2_LINUX_KERNEL_IMAGEGZ=y
+BR2_LINUX_KERNEL_DTS_SUPPORT=y
+BR2_LINUX_KERNEL_INTREE_DTS_NAME="st/stm32mp257f-ev1"
+BR2_LINUX_KERNEL_INSTALL_TARGET=y
+BR2_LINUX_KERNEL_NEEDS_HOST_OPENSSL=y
+BR2_PACKAGE_UBOOT_TOOLS=y
+BR2_PACKAGE_UBOOT_TOOLS_FWUMDATA=y
+BR2_PACKAGE_OPTEE_CLIENT=y
+BR2_TARGET_ROOTFS_EXT2=y
+BR2_TARGET_ROOTFS_EXT2_4=y
+BR2_TARGET_ROOTFS_EXT2_SIZE="256M"
+# BR2_TARGET_ROOTFS_TAR is not set
+BR2_TARGET_ARM_TRUSTED_FIRMWARE=y
+BR2_TARGET_ARM_TRUSTED_FIRMWARE_CUSTOM_VERSION=y
+BR2_TARGET_ARM_TRUSTED_FIRMWARE_CUSTOM_VERSION_VALUE="v2.15.0"
+BR2_TARGET_ARM_TRUSTED_FIRMWARE_PLATFORM="stm32mp2"
+BR2_TARGET_ARM_TRUSTED_FIRMWARE_FIP=y
+BR2_TARGET_ARM_TRUSTED_FIRMWARE_BL32_OPTEE=y
+BR2_TARGET_ARM_TRUSTED_FIRMWARE_UBOOT_AS_BL33=y
+BR2_TARGET_ARM_TRUSTED_FIRMWARE_UBOOT_BL33_IMAGE="u-boot-nodtb.bin"
+BR2_TARGET_ARM_TRUSTED_FIRMWARE_ADDITIONAL_VARIABLES="STM32MP25=1 STM32MP_SDMMC=1 STM32MP_DDR4_TYPE=1 PSA_FWU_SUPPORT=1 STM32MP_BL33_EL1=0 PSCI_OS_INIT_MODE=1 DTB_FILE_NAME=stm32mp257f-ev1.dtb BL32_EXTRA2= BL33_CFG=$(BINARIES_DIR)/u-boot.dtb"
+BR2_TARGET_ARM_TRUSTED_FIRMWARE_IMAGES="fip.bin *.stm32"
+BR2_TARGET_ARM_TRUSTED_FIRMWARE_NEEDS_DTC=y
+BR2_TARGET_OPTEE_OS=y
+BR2_TARGET_OPTEE_OS_CUSTOM_TARBALL=y
+BR2_TARGET_OPTEE_OS_CUSTOM_TARBALL_LOCATION="$(call github,STMicroelectronics,optee_os,4.0.0-stm32mp-r3)/optee-os-4.0.0-stm32mp-r3.tar.gz"
+BR2_TARGET_OPTEE_OS_NEEDS_DTC=y
+BR2_TARGET_OPTEE_OS_NEEDS_PYTHON_CRYPTOGRAPHY=y
+BR2_TARGET_OPTEE_OS_NEEDS_CMAKE=y
+# BR2_TARGET_OPTEE_OS_SDK is not set
+# BR2_TARGET_OPTEE_OS_SERVICES is not set
+BR2_TARGET_OPTEE_OS_PLATFORM="stm32mp2"
+BR2_TARGET_OPTEE_OS_PLATFORM_FLAVOR="257F_EV1"
+BR2_TARGET_OPTEE_OS_ADDITIONAL_VARIABLES="CFG_WITH_TUI=n"
+BR2_TARGET_STM32_DDR_PHY_BINARY=y
+BR2_TARGET_UBOOT=y
+BR2_TARGET_UBOOT_BUILD_SYSTEM_KCONFIG=y
+BR2_TARGET_UBOOT_CUSTOM_VERSION=y
+BR2_TARGET_UBOOT_CUSTOM_VERSION_VALUE="2026.10"
+BR2_TARGET_UBOOT_BOARD_DEFCONFIG="stm32mp25"
+BR2_TARGET_UBOOT_NEEDS_DTC=y
+BR2_TARGET_UBOOT_NEEDS_PYLIBFDT=y
+BR2_TARGET_UBOOT_NEEDS_OPENSSL=y
+BR2_TARGET_UBOOT_NEEDS_GNUTLS=y
+# BR2_TARGET_UBOOT_FORMAT_BIN is not set
+BR2_TARGET_UBOOT_FORMAT_CUSTOM=y
+BR2_TARGET_UBOOT_FORMAT_CUSTOM_NAME="u-boot-nodtb.bin u-boot.dtb"
+BR2_TARGET_UBOOT_CUSTOM_MAKEOPTS="DEVICE_TREE=st/stm32mp257f-ev1"
+BR2_PACKAGE_HOST_BMAP_TOOLS=y
+BR2_PACKAGE_HOST_GENIMAGE=y
+BR2_PACKAGE_HOST_UBOOT_TOOLS=y
+BR2_PACKAGE_HOST_UBOOT_TOOLS_MKFWUMDATA=y