[PATCH v5 6/6] doc: dtbinding: Update documentation for Generic Firmware loader

[Simon Glass]

Hi Christian,

On 2026-04-03T13:51:57, Christian Marangi <ansuelsmth at gmail.com> wrote:
> doc: dtbinding: Update documentation for Generic Firmware loader
>
> 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>

> diff --git a/doc/device-tree-bindings/misc/fs_loader.txt b/doc/device-tree-bindings/misc/fw_loader.txt
> @@ -7,6 +7,8 @@ Required properties:
> +- mdtpart: which partition of ubi the image loading from, this property is
> +        required for ubi and mounting.

mtdpart

> diff --git a/doc/device-tree-bindings/misc/fs_loader.txt b/doc/device-tree-bindings/misc/fw_loader.txt
> @@ -12,6 +12,8 @@ Required properties:
> +- partoffset: valid ONLY for "u-boot,fip-loader". Offset of the partition to
> +           parse the FIP parition from.

partition

> diff --git a/doc/device-tree-bindings/misc/fs_loader.txt b/doc/device-tree-bindings/misc/fw_loader.txt
> @@ -1,9 +1,9 @@
>  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,

The section says 'Required properties' but phandlepart, mtdpart and
ubivol are alternatives; only one set is required depending on the
storage type. Please can you clarify this.

> diff --git a/doc/device-tree-bindings/misc/fs_loader.txt b/doc/device-tree-bindings/misc/fw_loader.txt
> @@ -46,3 +48,12 @@ ubi in device tree source as shown in below:
> +     Example for FIP from eMMC:
> +     fs_loader4: fip-loader at 4 {
> +             bootph-all;
> +             compatible = "u-boot,fip-loader";
> +             phandlepart = <&mmc0 0>;
> +             partoffset = <0x100>;
> +     };

Since the FIP loader supports UBI storage as well, it would be good to
add an example for FIP on UBI too.

Regards,
Simon