Documentation about flashing to emmc

[SimonKagstrom]

I'm trying to flash an image for the stm32mp257f-ev1 on the emmc. OpenWRT on a sdcard works. I've managed to flash the openstlinux distribution to the emmc on the board, but I don't quite understand how to write the .tsv file from the docs/stm32cubeprogrammer.md document.

The document talks about a flashing/ directory, from which files should be copied. I don't have that after my build. I've therefore copied the files from the openstlinux directory, so ended up with this:

-	0x01	fsbl-boot	Binary	none	0x0	arm-trusted-firmware/tf-a-stm32mp257f-ev1-optee-programmer-usb.stm32
-	0x02	fip-ddr	FIP	none	0x0	fip/fip-stm32mp257f-ev1-ddr-optee-programmer-usb.bin
-	0x03	fip-boot	FIP	none	0x0	fip/fip-stm32mp257f-ev1-optee-programmer-usb.bin
P	0x10	sdcard		RawImage	mmc1	0x0	openwrt-stm32-stm32mp2-stm32mp257f-ev1-ext4-factory.img

However, this fails with

INFO:      Instance 2
INFO:    Boot used partition fsbl1
NOTICE:  BL2: v2.10-stm32mp2-r2.0(debug):lts-v2.10.13-dirty(b1f57509)
NOTICE:  BL2: Built : 17:10:59, Feb 14 2025
ERROR:   Unable to find a metadata partition
WARNING: Failed to set reference to image id=12 (-2)
WARNING: loading of FWU-Metadata failed, using Bkup-FWU-Metadata
ERROR:   Unable to find a metadata partition
WARNING: Failed to set reference to image id=13 (-2)
ERROR:   loading of Bkup-FWU-Metadata failed
BACKTRACE: START: fwu_init
0: EL3: 0xe017bac
1: EL3: 0xe019134
2: EL3: 0xe017ad8
3: EL3: 0xe0170e0
BACKTRACE: END: fwu_init

presumably since the RawImage flashing is wrong (?). Is there an example you can point to? Or perhaps update the documentation?

[SimonKagstrom]

OK, so I realized I should get the flashing directory from this git repo, so that's solved.

However, while the instructions work for the SD card, I get the error above also with the images from flashing when targeting the emmc:

-	0x01	fsbl-boot	Binary	none	0x0	tf-a-stm32mp257_ev1_usb.stm32
-	0x02	fip-ddr		Binary		none	0x0	fip-ddr-stm32mp257_ev1_usb.bin
-	0x03	fip-boot	Binary		none	0x0	fip-stm32mp257_ev1_usb.bin
P	0x10	sdcard		RawImage	mmc1	0x0	openwrt-stm32-stm32mp2-stm32mp257f-ev1-ext4-factory.img

[thom24]

eMMC layout is a bit different than SDCard layout (FSBL shall in eMMC boot partition), so you cannot do a RawImage flashing.
For now we provide only SDCard images. If you refer to the STM32CubeProgrammer documentation [1] you can find an eMMC layout. If you successfully boot from eMMC, please note that sysupgrade will not work.

[1] https://wiki.st.com/stm32mpu/wiki/STM32CubeProgrammer_flashlayout#e-E2-80-A2MMC

[SimonKagstrom]

OK, thanks for the answer!

I'll investigate what the openstlinux distribution does and see if I can get OpenWRT to boot that way. I'd like to use the SDCard slot for and SDIO WiFi adapter, so that's why I'd like to use the eMMC.

[thom24]

Metadata partitions should not be needed as TF-A is compiled without PSA_FWU_SUPPORT, and we can probably use only one TF-A and FIP images like on SDCard.
If you get something working do not hesitate to open a pull-request.