spl: document 'chosen/u-boot, spl-boot-device'
authorPhilipp Tomsich <philipp.tomsich@theobroma-systems.com>
Thu, 24 May 2018 15:15:51 +0000 (17:15 +0200)
committerPhilipp Tomsich <philipp.tomsich@theobroma-systems.com>
Fri, 20 Jul 2018 23:55:26 +0000 (01:55 +0200)
To let the full U-Boot know where it was booted from (i.e. which of
the entries in /chosen/u-boot,spl-boot-order' contained a valid
image), we define (and document) /chosen/u-boot,spl-boot-device as the
property that could/should automatically be injected by SPL.

This commit only contains a documentation change, which documents the
new property and the intended usage.

Signed-off-by: Philipp Tomsich <philipp.tomsich@theobroma-systems.com>
Tested-by: Klaus Goger <klaus.goger@theobroma-systems.com>
doc/device-tree-bindings/chosen.txt

index c96b8f7..da7b4e6 100644 (file)
@@ -73,3 +73,13 @@ Example
                u-boot,spl-boot-order = "same-as-spl", &sdmmc, "/sdhci@fe330000";
        };
 };
+
+u-boot,spl-boot-device property
+-------------------------------
+
+This property is a companion-property to the u-boot,spl-boot-order and
+will be injected automatically by the SPL stage to notify a later stage
+of where said later stage was booted from.
+
+You should not define this property yourself in the device-tree, as it
+may be overwritten without warning.