summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorAustin Shirley <austin@deadband.dev>2026-06-12 15:20:07 -0600
committerAustin Shirley <ausshir@gmail.com>2026-06-15 11:57:23 -0600
commit37a66c811bc7c6c9a75375e5aaa195c31c746bf5 (patch)
tree96f3b484aa4ed76b85a3aa5a116082fa38d676aa /docs
parent24c877cb8c7fd69091bfd03c19e68e4f759f36e0 (diff)
downloadarm-trusted-firmware-37a66c811bc7c6c9a75375e5aaa195c31c746bf5.tar.gz
arm-trusted-firmware-37a66c811bc7c6c9a75375e5aaa195c31c746bf5.zip
feat(st): add optional recovery FIP for NAND boot
Without PSA_FWU, the NAND boot path walks backup blocks of the active FIP. Add an optional build flag STM32MP_NAND_FIP_RECOVERY_OFFSET that falls back to a recovery FIP once the active FIP and its backup blocks are exhausted. Before Ia18ff2d the backup walk overran the partition end and could load a FIP placed there. Make this behaviour an explicit opt-in. Tested on STM32MP135. Change-Id: Id308e39998cbb863c8c0ccfead49a5af831c3761 Signed-off-by: Austin Shirley <austin@deadband.dev>
Diffstat (limited to 'docs')
-rw-r--r--docs/plat/st/stm32mpus.rst7
1 files changed, 7 insertions, 0 deletions
diff --git a/docs/plat/st/stm32mpus.rst b/docs/plat/st/stm32mpus.rst
index 7b4711278..7bea16a65 100644
--- a/docs/plat/st/stm32mpus.rst
+++ b/docs/plat/st/stm32mpus.rst
@@ -54,6 +54,13 @@ Other configuration flags:
| Default: stm32mp157c-ev1.dtb
- | ``DWL_BUFFER_BASE``: the 'serial boot' load address of FIP,
| default location (end of the first 128MB) is used when absent
+- | ``STM32MP_FORCE_MTD_START_OFFSET``: to force the FIP offset on MTD devices.
+ | Requires PSA_FWU_SUPPORT=0.
+ | Default: 0x80000 on NOR, 0x200000 on NAND
+- | ``STM32MP_NAND_FIP_RECOVERY_OFFSET``: NAND offset of a recovery FIP, tried when
+ | the active FIP and its backup blocks are exhausted. Requires PSA_FWU_SUPPORT=0.
+ | Use a partition the same size as the active FIP.
+ | Default: 0 (disabled)
- | ``STM32MP_RECONFIGURE_CONSOLE``: to re-configure crash console (especially after BL2).
| Default: 0 (disabled)
- | ``STM32MP_UART_BAUDRATE``: to select UART baud rate.