[PATCH v5 6/6] doc: dtbinding: Update documentation for Generic Firmware loader
Christian Marangi
ansuelsmth at gmail.com
Fri Apr 3 15:52:03 CEST 2026
Update documentation for Generic Firmware loader, generalize it from FS
specific and add new property and example for FIP loader.
Signed-off-by: Christian Marangi <ansuelsmth at gmail.com>
---
.../misc/{fs_loader.txt => fw_loader.txt} | 15 +++++++++++++--
1 file changed, 13 insertions(+), 2 deletions(-)
rename doc/device-tree-bindings/misc/{fs_loader.txt => fw_loader.txt} (77%)
diff --git a/doc/device-tree-bindings/misc/fs_loader.txt b/doc/device-tree-bindings/misc/fw_loader.txt
similarity index 77%
rename from doc/device-tree-bindings/misc/fs_loader.txt
rename to doc/device-tree-bindings/misc/fw_loader.txt
index 542be4b25a0a..44d9c076ebb8 100644
--- a/doc/device-tree-bindings/misc/fs_loader.txt
+++ b/doc/device-tree-bindings/misc/fw_loader.txt
@@ -1,9 +1,9 @@
-* File system firmware loader
+* Generic Firmware loader
Required properties:
--------------------
-- compatible: should contain "u-boot,fs-loader"
+- compatible: should contain "u-boot,fs-loader" or "u-boot,fip-loader"
- phandlepart: which block storage device and partition the image loading from,
this property is required for mmc, usb and sata. This is unsigned
32-bit array. For example phandlepart=<&mmc_0 1>, meaning use
@@ -12,6 +12,8 @@ Required properties:
required for ubi and mounting.
- ubivol: which volume of ubi the image loading from, this property is required
for ubi and mounting.
+- partoffset: valid ONLY for "u-boot,fip-loader". Offset of the partition to
+ parse the FIP parition from.
Example of storage device and partition search set for mmc, usb, sata and
ubi in device tree source as shown in below:
@@ -46,3 +48,12 @@ ubi in device tree source as shown in below:
mtdpart = "UBI",
ubivol = "ubi0";
};
+
+ Example for FIP from eMMC:
+ fs_loader4: fip-loader at 4 {
+ bootph-all;
+ compatible = "u-boot,fip-loader";
+ phandlepart = <&mmc0 0>;
+ partoffset = <0x100>;
+ };
+
--
2.53.0
More information about the U-Boot
mailing list