| Peng Fan | 90815c9 | 2019-08-22 07:42:49 +0000 | [diff] [blame] | 1 | Introduction: |
| 2 | ============= |
| 3 | |
| 4 | This documentation entry describes the i.MX8 container format and how |
| 5 | to use. |
| 6 | |
| 7 | A Boot image consists of: |
| 8 | - Primary Boot Container Set |
| 9 | - Optional Secondary Boot Container Set |
| 10 | |
| 11 | The imx8image only support the Primary Boot Container Set. |
| 12 | |
| 13 | The Primary Boot Container Set contains two containers. The 1st container |
| 14 | only contain the SECO firmware image, the 2nd container can contain |
| 15 | multiple images and typically have: |
| 16 | - SCF FW image |
| 17 | - M4 FW image |
| 18 | - AP FW image |
| 19 | |
| 20 | For more details, refer i.MX8 Reference Mannual Chapter 5 |
| 21 | "System Boot and section", "5.9 (Boot image) of the processor's manual" |
| 22 | |
| 23 | Configuration file: |
| 24 | ================== |
| 25 | BOOT_FROM [sd|emmc_fastboot|fspi|nand_4k|nand_8k|nand_16k] [sector_size] |
| 26 | - indicates the boot media |
| 27 | SOC_TYPE [IMX8QM|IMX8QX] |
| 28 | - indicates the soc |
| 29 | APPEND [ahab container image] |
| 30 | - indicates the ahah image that will be put in the 1st container |
| 31 | When creating container image will be loaded by SPL, this entry |
| 32 | should not this included |
| 33 | CONTAINER |
| 34 | - indicates to create the 2nd container |
| 35 | IMAGE [SCU|M40|M41|A35|A53|A72] [image file] [load address] |
| 36 | - indicates images will be put in the 2nd container |
| 37 | |
| 38 | Example: |
| 39 | ======= |
| 40 | BOOT_FROM SD 0x400 |
| 41 | SOC_TYPE IMX8QM |
| 42 | APPEND mx8qm-ahab-container.img |
| 43 | CONTAINER |
| 44 | IMAGE SCU mx8qm-mek-scfw-tcm.bin |
| 45 | IMAGE A35 spl/u-boot-spl.bin 0x00100000 |