This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
products:sbc:common:configurations:device-tree-overlay [2022/09/22 02:36] hyphop |
products:sbc:common:configurations:device-tree-overlay [2023/06/05 04:02] nick [VIM4] |
||
---|---|---|---|
Line 1: | Line 1: | ||
====== Device Tree Overlay ====== | ====== Device Tree Overlay ====== | ||
- | We can use DT overlays to enable or disable the peripherals without recompiling the kernel source code. | + | We can use DT overlays to enable/ |
- | ===== Device reference table ====== | + | ===== DT collections |
- | ^ | + | https://github.com/khadas/khadas-linux-kernel-dt-overlays |
- | ^ VIM1 | + | |
- | ^ VIM2 | + | |
- | ^ VIM3 | + | |
- | ^ VIM3L | / | + | |
- | ^ VIM1S | / | + | |
- | ^ VIM4 | + | |
- | ^ Edge2 | / | + | |
- | ^ Edge1 | / | + | |
- | | ::: | + | |
- | ===== Device | + | ===== Device |
+ | |||
+ | ^ ^ DT overlays folder | ||
+ | ^ VIM1 | / | ||
+ | ^ VIM2 | / | ||
+ | ^ VIM3 | / | ||
+ | ^ VIM3L | ||
+ | ^ VIM1S | ||
+ | ^ VIM4 | / | ||
+ | ^ New VIM4 | / | ||
+ | ^ Edge2 | ||
+ | ^ Edge1 | ||
+ | | ::: | / | ||
+ | |||
+ | ===== Device Configurations | ||
<tabbox VIM1/ | <tabbox VIM1/ | ||
Line 23: | Line 28: | ||
<WRAP important > | <WRAP important > | ||
- | **BOARD** should be '' | + | **BOARD** should be '' |
</ | </ | ||
Line 31: | Line 36: | ||
```shell | ```shell | ||
- | khadas@Khadas: | + | khadas@Khadas: |
disable-ts050.dtbo | disable-ts050.dtbo | ||
i2c3.dtbo | i2c3.dtbo | ||
Line 42: | Line 47: | ||
``` | ``` | ||
- | DT-overlays configuration file: ''/ | + | DT-overlays configuration file: |
- | ```txt | + | ```txt /boot/env.txt |
# Device Tree Overlays | # Device Tree Overlays | ||
# | # | ||
Line 64: | Line 69: | ||
<tabbox VIM4> | <tabbox VIM4> | ||
- | DT-overlays '' | + | DT-overlays '' |
```shell | ```shell | ||
- | khadas@Khadas: | + | khadas@Khadas: |
- | total 28 | + | ext_board.dtbo |
- | -rwxr-xr-x 1 root root 462 Jul 6 14:55 ext_board.dtbo | + | i2cm_a.dtbo |
- | -rwxr-xr-x 1 root root 223 Jul 6 14:55 i2cm_a.dtbo | + | i2cm_f.dtbo |
- | -rwxr-xr-x 1 root root 223 Jul 6 14:55 i2cm_f.dtbo | + | pwm_f.dtbo |
- | -rwxr-xr-x 1 root root 225 Jul 6 14:55 pwm_f.dtbo | + | uart_e.dtbo |
- | -rwxr-xr-x 1 root root 225 Jul 6 14:55 uart_e.dtbo | + | |
``` | ``` | ||
Line 83: | Line 87: | ||
```shell | ```shell | ||
- | khadas@Khadas: | + | khadas@Khadas: |
- | total 28 | + | i2cm_b.dtbo |
- | -rw-rw-r-- 1 root root 223 Aug 12 10:59 i2cm_b.dtbo | + | i2cm_e.dtbo |
- | -rw-rw-r-- 1 root root 223 Aug 12 10:59 i2cm_e.dtbo | + | pwm_f.dtbo |
- | -rw-rw-r-- 1 root root 345 Aug 12 10:59 pwm_f.dtbo | + | uart_c.dtbo |
- | -rw-rw-r-- 1 root root 225 Aug 12 10:59 uart_c.dtbo | + | |
``` | ``` | ||
- | |||
DT-overlays configuration file is ''/ | DT-overlays configuration file is ''/ | ||
<tabbox Edge2> | <tabbox Edge2> | ||
- | DT-overlays '' | + | DT-overlays '' |
```shell | ```shell | ||
Line 106: | Line 108: | ||
</ | </ | ||
- | ===== Configuration DT overlays | + | ===== Configuration DT Overlays |
- | Need edit the DT overlays configuration file and add custom DT overlays '' | + | You need to edit the DT overlays configuration file and add custom DT overlays '' |
- | ===== Make custom DT overlays | + | ===== Make custom DT Overlays |
There are some preparations steps for DT overlays '' | There are some preparations steps for DT overlays '' | ||
- | ==== Write DT overlay source==== | + | ==== Write DT Overlay Source==== |
- | Basic example: | + | Basic DT overlay source |
```dts example.dts | ```dts example.dts | ||
Line 133: | Line 135: | ||
``` | ``` | ||
- | ==== Compile DT overlay source | + | ==== Compile DT Overlay Source |
```sh | ```sh | ||
Line 139: | Line 141: | ||
``` | ``` | ||
- | ==== Copy DT overlays | + | ==== Copy DT Overlays |
* VIM4 is ''/ | * VIM4 is ''/ | ||
* VIM1S is ''/ | * VIM1S is ''/ | ||
* Edge2 is ''/ | * Edge2 is ''/ | ||
- | * VIM1/ | + | * VIM1/ |
<WRAP important > | <WRAP important > | ||
- | **BOARD** should be '' | + | **BOARD** should be '' |
</ | </ | ||
- | ==== Edit DT overlays configuration | + | ==== Edit DT Overlays Configuration |
Edit list variable value inside DT overlay configuration file: | Edit list variable value inside DT overlay configuration file: | ||
* VIM1/ | * VIM1/ | ||
- | * VIM4 is ''/ | + | * VIM4 is ''/ |
* VIM1S is ''/ | * VIM1S is ''/ | ||
* Edge2 is ''/ | * Edge2 is ''/ |