mirrors/u-boot
1
0
Fork 0
mirror of https://source.denx.de/u-boot/u-boot.git synced 2025-08-15 11:46:59 +02:00
Code Issues Actions Packages Projects Releases Wiki Activity
2d6221262e
u-boot/doc/imx/imx95_container.txt
Alice Guo fe8ab3b0c0 doc: imx: add document for i.MX95 Image Container Format 
This patch add a document for i.MX95 Image Container Format.

Signed-off-by: Alice Guo <alice.guo@nxp.com>
2025-05-03 16:55:32 -03:00

137 lines
9.7 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

i.MX95 Image Container Format
-----------------------------
The image container set consists of some image containers, and image container
contains boot images. Each image container has its own container header which is
defined in Figure 1. All container headers are placed together in a continuous
8KB space at the beginning of the image container set - image container set header.
ROM code addresses image containers in image container set one by one based on
their headers’ order in image container set header.
If ELE container exists, its container header must be the 1st one in the image
container set header.
If V2X container exists, its container header must be the 2nd one in the image
container set header. V2X must be combined with ELE container.
The information of boot images are recorded in image container header. System
ROM code needs to retrieve the information from the image container header, like
the offset on boot source, the target address in RAM, the length of boot image.
The order of ROM code handling these boot images is based on the order of each
boot image information present in image container header.
Figure 1:
------------------- +--------------+--------------+--------------+--------------+
^ |Tag |Length |Length |Version |
| +--------------+--------------+--------------+--------------+
| | Flags |
| +--------------+--------------+--------------+--------------+
| |# of Images |Fuse version |SW version |
Image | +--------------+--------------+--------------+--------------+
Container | |Reserved |Signature Block Offset |
Header | ------- +--------------+--------------+--------------+--------------+
| ^ |Image0: Offset, Size, LoadAddr, EntryPoint, Flags, Hash, IV|
| | +--------------+--------------+--------------+--------------+
| Image | |Image1: Offset, Size, LoadAddr, EntryPoint, Flags, Hash, IV|
| Array | +--------------+--------------+--------------+--------------+
| | | ... |
| | +--------------+--------------+--------------+--------------+
v v |ImageN: Offset, Size, LoadAddr, EntryPoint, Flags, Hash, IV|
------------------- +--------------+--------------+--------------+--------------+
| ... |
----------- +--------------+--------------+--------------+--------------+ <-- SignOffset
^ |Tag |Length |Length |Version |
| +--------------+--------------+--------------+--------------+
| |SRK table offset |Certificate Offset |
| +--------------+--------------+--------------+--------------+
| |Blob Offset |Signature Offset |
| +--------------+--------------+--------------+--------------+
Signature | | SRK Table |
Block | +--------------+--------------+--------------+--------------+
| | Signature |
| +--------------+--------------+--------------+--------------+
| | Certificate (optional) |
| +--------------+--------------+--------------+--------------+
v | Blob (optional) |
----------- +--------------+--------------+--------------+--------------+
| ... |
+--------------+--------------+--------------+--------------+ <-- Image0Offset
| Image0 |
+--------------+--------------+--------------+--------------+
| ... |
+--------------+--------------+--------------+--------------+ <-- ImageNOffset
| ImageN |
+--------------+--------------+--------------+--------------+
| ... |
+--------------+--------------+--------------+--------------+
i.MX95 Low Power Boot Image Sets Layout
---------------------------------------
Image container sets are handled by M33 ROM.
--------------- +--------------+--------------+--------------+--------------+
^ | 1st Container Header |
| +--------------+--------------+--------------+--------------+
ELE + | | Padding for 1KB alignment |
OEM | +--------------+--------------+--------------+--------------+
Container | | 2nd Container Header |
Set | +--------------+--------------+--------------+--------------+
Header | | Padding for 1KB alignment |
| +--------------+--------------+--------------+--------------+
| | 3rd Container Header |
| +--------------+--------------+--------------+--------------+
v | Padding for 1KB alignment |
--------------- +--------------+--------------+--------------+--------------+
| ... |
+--------------+--------------+--------------+--------------+
| mx95a0-ahab-container.img |
+--------------+--------------+--------------+--------------+
| ... |
------------------- +--------------+--------------+--------------+--------------+
^ | oei-m33-ddr.bin |
| +--------------+--------------+--------------+--------------+
| | ddrfw-header.bin |
| +--------------+--------------+--------------+--------------+
| | lpddr5_imem_v202311.bin |
| +--------------+--------------+--------------+--------------+
m33-oei-ddrfw.bin | | lpddr5_dmem_v202311.bin |
| +--------------+--------------+--------------+--------------+
| | ddrfw-qb-header.bin |
| +--------------+--------------+--------------+--------------+
| | lpddr5_imem_qb_v202311.bin |
| +--------------+--------------+--------------+--------------+
v | lpddr5_dmem_qb_v202311.bin |
------------------- +--------------+--------------+--------------+--------------+
| ... |
+--------------+--------------+--------------+--------------+
| oei-m33-tcm.bin |
+--------------+--------------+--------------+--------------+
| ... |
+--------------+--------------+--------------+--------------+
| m33_image.bin |
+--------------+--------------+--------------+--------------+
| ... |
+--------------+--------------+--------------+--------------+
| u-boot-spl.bin |
+--------------+--------------+--------------+--------------+
| ... |
+--------------+--------------+--------------+--------------+
--------------- +--------------+--------------+--------------+--------------+
u-boot-atf ^ | 1st Container Header |
Container | +--------------+--------------+--------------+--------------+
Header v | Padding for 1KB alignment |
--------------- +--------------+--------------+--------------+--------------+
| ... |
+--------------+--------------+--------------+--------------+
| bl31.bin |
+--------------+--------------+--------------+--------------+
| ... |
+--------------+--------------+--------------+--------------+
| u-boot.bin |
+--------------+--------------+--------------+--------------+
| ... |
+--------------+--------------+--------------+--------------+
Reference in New Issue View Git Blame Copy Permalink