summaryrefslogtreecommitdiffstats
path: root/Documentation/user
diff options
context:
space:
mode:
authorAhmad Fatoum <a.fatoum@pengutronix.de>2023-03-26 13:22:11 +0200
committerSascha Hauer <s.hauer@pengutronix.de>2023-03-28 09:46:30 +0200
commite2018cff1b2c9426c71a54938d9398b99482b8e2 (patch)
tree739af7c5f70729ecdc341ad865f27c77bc08204a /Documentation/user
parent50af0029486fbc7325f9e51213b780de789e282c (diff)
downloadbarebox-e2018cff1b2c9426c71a54938d9398b99482b8e2.tar.gz
barebox-e2018cff1b2c9426c71a54938d9398b99482b8e2.tar.xz
Documentation: booting-linux: document booting specific FIT configuration
Apparently, this was so far undocumented, but it's useful in some setups where board type is detected dynamically. Document it. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20230326112211.2900004-1-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
Diffstat (limited to 'Documentation/user')
-rw-r--r--Documentation/user/booting-linux.rst10
1 files changed, 10 insertions, 0 deletions
diff --git a/Documentation/user/booting-linux.rst b/Documentation/user/booting-linux.rst
index 1a95f87e77..6fa8cd911e 100644
--- a/Documentation/user/booting-linux.rst
+++ b/Documentation/user/booting-linux.rst
@@ -19,8 +19,10 @@ architecture the bootm command handles different image types. On ARM the
following images are supported:
* ARM Linux zImage
+* ARM64 Linux Image, plain or compressed
* U-Boot uImage
* barebox images
+* FIT images, containing a zImage or Image
The images can either be passed directly to the bootm command as argument or
in the ``global.bootm.image`` variable:
@@ -48,6 +50,14 @@ variable:
global.bootm.image=/path/to/zImage
bootm
+FIT image configurations will be matched by comparing the ``compatible`` property
+inside the configuration node with the barebox live tree's ``/compatible``.
+It's also possible to select a specific configuration explicitly:
+
+.. code-block:: sh
+
+ global.bootm.image=/dev/mmc0.fit@conf-imx8mm-evk.dtb
+
**NOTE:** it may happen that barebox is probed from the devicetree, but you have
want to start a Kernel without passing a devicetree. In this case set the
``global.bootm.boot_atag`` variable to ``true``.