summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorTeddy Reed <teddy.reed@gmail.com>2016-06-09 19:38:02 -0700
committerTom Rini <trini@konsulko.com>2016-06-24 17:23:06 -0400
commitf8f9107d97b849afe69ca86e7abd8d1748ea7acd (patch)
treeb210c79fc53f0459b0af6cecb90d7c1cdc1f3016 /doc
parent92dfd9221c97265ff303bf9437481b9767bd72ea (diff)
downloadu-boot-f8f9107d97b849afe69ca86e7abd8d1748ea7acd.tar.gz
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 <teddy.reed@gmail.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/mkimage.16
-rw-r--r--doc/uImage.FIT/source_file_format.txt3
2 files changed, 9 insertions, 0 deletions
diff --git a/doc/mkimage.1 b/doc/mkimage.1
index 4b3a255255..ffa7d60156 100644
--- a/doc/mkimage.1
+++ b/doc/mkimage.1
@@ -152,6 +152,12 @@ 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
must be verified for the image to boot. Without this option, the verification
diff --git a/doc/uImage.FIT/source_file_format.txt b/doc/uImage.FIT/source_file_format.txt
index 3f5418045e..91aa89a77e 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
-----------