GNUBoot
/
coreboot-kgpe-d16
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

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:
Patrick Rudolph 2018-10-28 13:12:46 +01:00 committed by Philipp Deppenwiese
parent 84bf089f6a
commit 82b1e019a5
1 changed files with 16 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
Documentation/lib/payloads/fit.md
View File

@ -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