summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorKever Yang <kever.yang@rock-chips.com>2020-03-30 06:56:24 +0300
committerTom Rini <trini@konsulko.com>2020-04-24 17:10:01 +0300
commitebfe611be91e0075c040588a30a9996519d30aa6 (patch)
treed8d41efeafbbb876a8b3a2cb8aad66e365d81821 /doc
parent10d887ddfa4f94aa94cf7a6d3dd4f28a339a2f13 (diff)
downloadu-boot-ebfe611be91e0075c040588a30a9996519d30aa6.tar.xz
mkimage: fit_image: Add option to make fit header align
The image is usually stored in block device like emmc, SD card, make the offset of image data aligned to block(512 byte) can avoid data copy during boot process. eg. SPL boot from FIT image with external data: - SPL read the first block of FIT image, and then parse the header; - SPL read image data separately; - The first image offset is the base_offset which is the header size; - The second image offset is just after the first image; - If the offset of imge does not aligned, SPL will do memcpy; The header size is a ramdon number, which is very possible not aligned, so add '-B size'to specify the align size in hex for better performance. example usage: ./tools/mkimage -E -f u-boot.its -B 0x200 u-boot.itb Signed-off-by: Kever Yang <kever.yang@rock-chips.com> Reviewed-by: Punit Agrawal <punit1.agrawal@toshiba.co.jp> Reviewed-by: Tom Rini <trini@konsulko.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/uImage.FIT/source_file_format.txt5
1 files changed, 5 insertions, 0 deletions
diff --git a/doc/uImage.FIT/source_file_format.txt b/doc/uImage.FIT/source_file_format.txt
index 18d2aedcb7..884a58456f 100644
--- a/doc/uImage.FIT/source_file_format.txt
+++ b/doc/uImage.FIT/source_file_format.txt
@@ -304,6 +304,11 @@ Normal kernel FIT image has data embedded within FIT structure. U-Boot image
for SPL boot has external data. Existence of 'data-offset' can be used to
identify which format is used.
+For FIT image with external data, it would be better to align each blob of data
+to block(512 byte) for block device, so that we don't need to do the copy when
+read the image data in SPL. Pass '-B 0x200' to mkimage to align the FIT
+structure and data to 512 byte, other values available for other align size.
+
9) Examples
-----------