docs/Generic_images.md edit overlays how-to

Signed-off-by: Artem Lapkin <art@khadas.com>
This commit is contained in:
Artem Lapkin
2021-08-24 14:44:37 +08:00
parent 7e96a3ad63
commit 7db1922aa3

View File

@ -1,9 +1,3 @@
# New Developing fenix branch
git branch dev
NOTE: experimental branch for testers developing and other things !!!
## Generic images
New simple generic image. one image for any devices
@ -177,4 +171,52 @@ root@hyphop:~# blkid | grep ROOTFS
```
### DTB overlays how-to
We inroduce new universal simple ways to apply DTB overlays
Overlays configuration must have same path as dtb file with ".overlay.env" file extension
```
/boot/dtb/amlogic/meson-sm1-khadas-vim3l.dtb.overlay.env
/boot/dtb/amlogic/meson-g12b-a311d-khadas-vim3.dtb.overlay.env
/boot/dtb/amlogic/meson-g12b-s922x-khadas-vim3.dtb.overlay.env
/boot/dtb/amlogic/meson-gxm-khadas-vim2.dtb.overlay.env
/boot/dtb/amlogic/meson-gxl-s905x-khadas-vim.dtb.overlay.env
```
### Overlays configuration VIM3L example
```
cat /boot/dtb/amlogic/meson-sm1-khadas-vim3l.dtb.overlay.env
# fdt overlays config
fdt_overlays_dir=/dtb/amlogic/overlays/kvim3l
fdt_overlays=i2s spdifout
# END
find /boot | grep vim3l | grep dtbo
/boot/dtb/amlogic/overlays/kvim3l/uart3.dtbo
/boot/dtb/amlogic/overlays/kvim3l/i2c3.dtbo
/boot/dtb/amlogic/overlays/kvim3l/spdifout.dtbo
/boot/dtb/amlogic/overlays/kvim3l/i2s.dtbo
```
### Overlays configuration syntax
Its same common uboot env file syntax
+ fdt_overlays_dir= - overlays path
+ fdt_overlays= - overlays file list without or with .dtbo extension
+ # comment - comment area
+ other_vars= - ignored
NOTE: works for EXTLINUX and same for EFI
NOTE: at this moment works only for our mainline uboot modification
+ https://dl.khadas.com/Firmware/uboot/mainline/
+ https://github.com/khadas/khadas-uboot
..WIP..