| Simon Glass | ba399ce | 2023-06-23 13:22:04 +0100 | [diff] [blame] | 1 | .. SPDX-License-Identifier: GPL-2.0+ |
| 2 | |
| 3 | Multiple images for SPL |
| 4 | ======================= |
| 5 | |
| 6 | (Bogus) example FIT image description file demonstrating the usage |
| 7 | of multiple images loaded by the SPL. |
| 8 | Several binaries will be loaded at their respective load addresses. |
| 9 | |
| 10 | For booting U-Boot, "firmware" is searched first. If not found, "loadables" |
| 11 | is used to identify images to be loaded into memory. If falcon boot is |
| 12 | enabled, "kernel" is searched first. If not found, it falls back to the |
| 13 | same flow as booting U-Boot. Changing image type will result skipping |
| 14 | specific image. |
| 15 | |
| 16 | Finally the one image specifying an entry point will be entered by the SPL. |
| 17 | |
| 18 | :: |
| 19 | |
| 20 | /dts-v1/; |
| 21 | |
| 22 | / { |
| 23 | description = "multiple firmware blobs and U-Boot, loaded by SPL"; |
| 24 | #address-cells = <0x1>; |
| 25 | |
| 26 | images { |
| 27 | |
| 28 | uboot { |
| 29 | description = "U-Boot (64-bit)"; |
| 30 | type = "standalone"; |
| 31 | arch = "arm64"; |
| 32 | compression = "none"; |
| 33 | load = <0x4a000000>; |
| 34 | }; |
| 35 | |
| 36 | atf { |
| 37 | description = "ARM Trusted Firmware"; |
| 38 | type = "firmware"; |
| 39 | arch = "arm64"; |
| 40 | compression = "none"; |
| 41 | load = <0x18000>; |
| 42 | entry = <0x18000>; |
| 43 | }; |
| 44 | |
| 45 | mgmt-firmware { |
| 46 | description = "arisc management processor firmware"; |
| 47 | type = "firmware"; |
| 48 | arch = "or1k"; |
| 49 | compression = "none"; |
| 50 | load = <0x40000>; |
| 51 | }; |
| 52 | |
| 53 | fdt-1 { |
| 54 | description = "Pine64+ DT"; |
| 55 | type = "flat_dt"; |
| 56 | compression = "none"; |
| 57 | load = <0x4fa00000>; |
| 58 | arch = "arm64"; |
| 59 | }; |
| 60 | |
| 61 | fdt-2 { |
| 62 | description = "Pine64 DT"; |
| 63 | type = "flat_dt"; |
| 64 | compression = "none"; |
| 65 | load = <0x4fa00000>; |
| 66 | arch = "arm64"; |
| 67 | }; |
| 68 | |
| 69 | kernel { |
| 70 | description = "4.7-rc5 kernel"; |
| 71 | type = "kernel"; |
| 72 | compression = "none"; |
| 73 | load = <0x40080000>; |
| 74 | arch = "arm64"; |
| 75 | }; |
| 76 | |
| 77 | initrd { |
| 78 | description = "Debian installer initrd"; |
| 79 | type = "ramdisk"; |
| 80 | compression = "none"; |
| 81 | load = <0x4fe00000>; |
| 82 | arch = "arm64"; |
| 83 | }; |
| 84 | }; |
| 85 | |
| 86 | configurations { |
| 87 | default = "config-1"; |
| 88 | |
| 89 | config-1 { |
| 90 | description = "sun50i-a64-pine64-plus"; |
| 91 | loadables = "uboot", "atf", "kernel", "initrd"; |
| 92 | fdt = "fdt-1"; |
| 93 | }; |
| 94 | |
| 95 | config-2 { |
| 96 | description = "sun50i-a64-pine64"; |
| 97 | loadables = "uboot", "atf", "mgmt-firmware"; |
| 98 | fdt = "fdt-2"; |
| 99 | }; |
| 100 | }; |
| 101 | }; |