From f8f9107d97b849afe69ca86e7abd8d1748ea7acd Mon Sep 17 00:00:00 2001 From: Teddy Reed Date: Thu, 9 Jun 2016 19:38:02 -0700 Subject: mkimage: fit: spl: Add an optional static offset for external data When building a FIT with external data (-E), U-Boot proper may require absolute positioning for executing the external firmware. To acheive this use the (-p) switch, which will replace the amended 'data-offset' with 'data-position' indicating the absolute position of external data. It is considered an error if the requested absolute position overlaps with the initial data required for the compact FIT. Signed-off-by: Teddy Reed --- doc/mkimage.1 | 6 ++++++ doc/uImage.FIT/source_file_format.txt | 3 +++ 2 files changed, 9 insertions(+) (limited to 'doc') diff --git a/doc/mkimage.1 b/doc/mkimage.1 index 4b3a2552550..ffa7d60156f 100644 --- a/doc/mkimage.1 +++ b/doc/mkimage.1 @@ -151,6 +151,12 @@ the corresponding public key is written into this file for for run-time verification. Typically the file here is the device tree binary used by CONFIG_OF_CONTROL in U-Boot. +.TP +.BI "\-p [" "external position" "]" +Place external data at a static external position. See \-E. Instead of writing +a 'data-offset' property defining the offset from the end of the FIT, \-p will +use 'data-position' as the absolute position from the base of the FIT. + .TP .BI "\-r Specifies that keys used to sign the FIT are required. This means that they diff --git a/doc/uImage.FIT/source_file_format.txt b/doc/uImage.FIT/source_file_format.txt index 3f5418045e5..91aa89a77ec 100644 --- a/doc/uImage.FIT/source_file_format.txt +++ b/doc/uImage.FIT/source_file_format.txt @@ -282,6 +282,9 @@ In this case the 'data' property is omitted. Instead you can use: aligned to a 4-byte boundary. - data-size : size of the data in bytes +The 'data-offset' property can be substituted with 'data-position', which +defines an absolute position or address as the offset. This is helpful when +booting U-Boot proper before performing relocation. 9) Examples ----------- -- cgit v1.3.1