summaryrefslogtreecommitdiff
path: root/doc/uImage.FIT
diff options
context:
space:
mode:
authorSimon Glass <sjg@chromium.org>2022-10-21 03:23:04 +0300
committerTom Rini <trini@konsulko.com>2022-10-31 18:02:45 +0300
commitbbe285c305e26d2944c38ea17c44c605b3289e25 (patch)
tree120c08d0bcd646f0991c3c52826216e270a07794 /doc/uImage.FIT
parent44ad35a0f699b0b49ef6efaa1405b6f99c703ea8 (diff)
downloadu-boot-bbe285c305e26d2944c38ea17c44c605b3289e25.tar.xz
image: Allow loading a FIT image for a particular phase
Add support for filtering out FIT images by phase. Rather than adding yet another argument to this already overloaded function, use a composite value, where the phase is only added in if needed. The FIT config is still selected (and verified) as normal, but the images are selected based on the phase. Tests for this come in a little later, as part of the updated VPL test. Signed-off-by: Simon Glass <sjg@chromium.org>
Diffstat (limited to 'doc/uImage.FIT')
-rw-r--r--doc/uImage.FIT/howto.txt6
1 files changed, 6 insertions, 0 deletions
diff --git a/doc/uImage.FIT/howto.txt b/doc/uImage.FIT/howto.txt
index 019dda24a0..6dbd17dc8c 100644
--- a/doc/uImage.FIT/howto.txt
+++ b/doc/uImage.FIT/howto.txt
@@ -70,6 +70,12 @@ The SPL also records to a DT all additional images (called loadables) which are
loaded. The information about loadables locations is passed via the DT node with
fit-images name.
+Finally, if there are multiple xPL phases (e.g. SPL, VPL), images can be marked
+as intended for a particular phase using the 'phase' property. For example, if
+fit_image_load() is called with image_ph(IH_PHASE_SPL, IH_TYPE_FIRMWARE), then
+only the image listed into the "firmware" property where phase is set to "spl"
+will be loaded.
+
Loadables Example
-----------------
Consider the following case for an ARM64 platform where U-Boot runs in EL2