X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=doc%2Fdevice-tree-bindings%2Fchosen.txt;h=c96b8f7109053e21edca880f580c21bbdd325946;hb=931747e517b19387716cd56057e4afa9e2cdfff4;hp=bf9a30a8f97cdb0211dd4eb2a6189d3d460ac7dd;hpb=82d72a1b9967cff4908f22c57536c3660f794401;p=u-boot

diff --git a/doc/device-tree-bindings/chosen.txt b/doc/device-tree-bindings/chosen.txt
index bf9a30a8f9..c96b8f7109 100644
--- a/doc/device-tree-bindings/chosen.txt
+++ b/doc/device-tree-bindings/chosen.txt
@@ -41,3 +41,35 @@ Example
 		reg = <0xf00 0x10>;
 	};
 };
+
+u-boot,spl-boot-order property
+------------------------------
+
+In a system using an SPL stage and having multiple boot sources
+(e.g. SPI NOR flash, on-board eMMC and a removable SD-card), the boot
+device may be probed by reading the image and verifying an image
+signature.
+
+If the SPL is configured through the device-tree, the boot-order can
+be configured with the spl-boot-order property under the /chosen node.
+Each list element of the property should specify a device to be probed
+in the order they are listed: references (i.e. implicit paths), a full
+path or an alias is expected for each entry.
+
+A special specifier "same-as-spl" can be used at any position in the
+boot-order to direct U-Boot to insert the device the SPL was booted
+from there.  Whether this is indeed inserted or silently ignored (if
+it is not supported on any given SoC/board or if the boot-device is
+not available to continue booting from) is implementation-defined.
+Note that if "same-as-spl" expands to an actual node for a given
+board, the corresponding node may appear multiple times in the
+boot-order (as there currently exists no mechanism to suppress
+duplicates from the list).
+
+Example
+-------
+/ {
+	chosen {
+		u-boot,spl-boot-order = "same-as-spl", &sdmmc, "/sdhci@fe330000";
+	};
+};