Documentation: Improve payload fit
* Convert '' to ` * Add example how to use mkimage Change-Id: Id83db3db51582cb0d6ded7f3152b5549fba1f2e7 Signed-off-by: Patrick Rudolph <siro@das-labor.org> Reviewed-on: https://review.coreboot.org/29319 Tested-by: build bot (Jenkins) <no-reply@coreboot.org> Reviewed-by: Jonathan Neuschäfer <j.neuschaefer@gmx.net> Reviewed-by: Philipp Deppenwiese <zaolin.daisuki@gmail.com>
This commit is contained in:
parent
84bf089f6a
commit
82b1e019a5
|
@ -25,7 +25,7 @@ The section must be named in order to be found by the FIT parser:
|
||||||
|
|
||||||
The FIT parser needs architecure support.
|
The FIT parser needs architecure support.
|
||||||
### aarch64
|
### aarch64
|
||||||
The source code can be found in ''src/arch/arm64/fit.c''.
|
The source code can be found in `src/arch/arm64/fit.c`.
|
||||||
|
|
||||||
On aarch64 the kernel (a section named 'kernel') must be in **Image**
|
On aarch64 the kernel (a section named 'kernel') must be in **Image**
|
||||||
format and it needs a devicetree (a section named 'fdt') to boot.
|
format and it needs a devicetree (a section named 'fdt') to boot.
|
||||||
|
@ -83,7 +83,7 @@ If no matching compat string is found, the default config is chosen.
|
||||||
|
|
||||||
## Building FIT image
|
## Building FIT image
|
||||||
|
|
||||||
The FIT image has to be built by calling ''mkimage''. You can use
|
The FIT image has to be built by calling `mkimage`. You can use
|
||||||
the following example configuration:
|
the following example configuration:
|
||||||
|
|
||||||
```
|
```
|
||||||
|
@ -148,9 +148,20 @@ the following example configuration:
|
||||||
};
|
};
|
||||||
```
|
```
|
||||||
|
|
||||||
It includes a compressed initrd **initramfs.cpio.xz**, which will be
|
Save it as ITS file `config.its` along with the other files defined here:
|
||||||
decompressed by the Linux kernel, a compressed kernel **Image.lzma**, which will
|
* target.dtb
|
||||||
be decompressed by the FIT loader and an uncompressed devicetree blob.
|
* initramfs.cpio.xz
|
||||||
|
* Image.lzma
|
||||||
|
|
||||||
|
Generate the `uImage` that will be included into the CBFS by calling
|
||||||
|
|
||||||
|
```bash
|
||||||
|
mkimage -f config.its uImage
|
||||||
|
```
|
||||||
|
|
||||||
|
The generated file includes a compressed initrd **initramfs.cpio.xz**, which
|
||||||
|
will be decompressed by the Linux kernel, a compressed kernel **Image.lzma**,
|
||||||
|
which will be decompressed by the FIT loader and an uncompressed devicetree blob.
|
||||||
|
|
||||||
[uImage.FIT]: https://raw.githubusercontent.com/u-boot/u-boot/master/doc/uImage.FIT/howto.txt
|
[uImage.FIT]: https://raw.githubusercontent.com/u-boot/u-boot/master/doc/uImage.FIT/howto.txt
|
||||||
[U-Boot]: https://www.denx.de/wiki/U-Boot
|
[U-Boot]: https://www.denx.de/wiki/U-Boot
|
||||||
|
|
Loading…
Reference in New Issue