Khadas Docs

Amazing Khadas, always amazes you!

User Tools

Site Tools


products:sbc:common:configurations:device-tree-overlay

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
products:sbc:common:configurations:device-tree-overlay [2023/11/07 04:18]
nick
products:sbc:common:configurations:device-tree-overlay [2026/05/11 02:18] (current)
nick
Line 1: Line 1:
-====== Device Tree Overlay ======+====== Device tree overlay ======
  
 We can use DT overlays to enable/disable or change configuration for peripherals without recompiling the DT kernel source code. We can use DT overlays to enable/disable or change configuration for peripherals without recompiling the DT kernel source code.
Line 7: Line 7:
 https://github.com/khadas/khadas-linux-kernel-dt-overlays https://github.com/khadas/khadas-linux-kernel-dt-overlays
  
-===== Device Reference Table ======+===== Device reference table ======
  
 ^          Kernel Version  ^  DT overlays folder                                    ^  DT overlays list variable  ^  DT overlays config file                                  ^ ^          Kernel Version  ^  DT overlays folder                                    ^  DT overlays list variable  ^  DT overlays config file                                  ^
Line 19: Line 19:
 ^  VIM4    5.4/5.15        |  /boot/dtb/amlogic/kvim4.dtb.overlays                  | :::                          /boot/dtb/amlogic/kvim4.dtb.overlay.env                  | ^  VIM4    5.4/5.15        |  /boot/dtb/amlogic/kvim4.dtb.overlays                  | :::                          /boot/dtb/amlogic/kvim4.dtb.overlay.env                  |
 ^  Edge2  |  5.10            |  /boot/dtb/rockchip/rk3588s-khadas-edge2.dtb.overlays  | :::                          /boot/dtb/rockchip/rk3588s-khadas-edge2.dtb.overlay.env  | ^  Edge2  |  5.10            |  /boot/dtb/rockchip/rk3588s-khadas-edge2.dtb.overlays  | :::                          /boot/dtb/rockchip/rk3588s-khadas-edge2.dtb.overlay.env  |
 +^ Edge-2L |  6.1              /boot/dtb/rockchip/rk3576-khadas-edge-2l.dtb.overlays  | :::                          /boot/dtb/rockchip/rk3576-khadas-edge-2l.dtb.overlay.env  |
 ^  Edge1  |  4.4              /boot/dtb/rockchip/overlays/captain                    overlays                    /boot/env.txt                                            | ^  Edge1  |  4.4              /boot/dtb/rockchip/overlays/captain                    overlays                    /boot/env.txt                                            |
 | :::     | :::              |  /boot/dtb/rockchip/overlays/edgev                     | :::                         | :::                                                       | | :::     | :::              |  /boot/dtb/rockchip/overlays/edgev                     | :::                         | :::                                                       |
  
-===== Device Configurations =====+===== Device configurations =====
  
 <tabbox VIM1/2/3/3L/Edge1> <tabbox VIM1/2/3/3L/Edge1>
Line 144: Line 145:
  
 DT-overlays configuration file: ''/boot/dtb/rockchip/rk3588s-khadas-edge2.dtb.overlay.env'' DT-overlays configuration file: ''/boot/dtb/rockchip/rk3588s-khadas-edge2.dtb.overlay.env''
 +
 +<tabbox Edge-2L>
 +
 +DT-overlays ''dtbo'' directory: ''/boot/dtb/rockchip/rk3576-khadas-edge-2l.dtb.overlays''
 +
 +```shell
 +khadas@Khadas:~$ ls /boot/dtb/rockchip/rk3576-khadas-edge-2l.dtb.overlays
 +edge-2l-io-pwm.dtbo
 +edge-2l-io-spi.dtbo
 +```
 +
 +DT-overlays configuration file: ''/boot/dtb/rockchip/rk3576-khadas-edge-2l.dtb.overlay.env''
  
 </tabbox> </tabbox>
  
-===== Configuration DT Overlays =====+===== Configuration DT overlays =====
  
 You need to edit the DT overlays configuration file and add custom DT overlays ''dtbo'' files to special folder. You need to edit the DT overlays configuration file and add custom DT overlays ''dtbo'' files to special folder.
  
-===== Make custom DT Overlays =====+===== Make custom DT overlays =====
  
 There are some preparations steps for DT overlays ''dtbo'' files, you can also add custom DT overlays. There are some preparations steps for DT overlays ''dtbo'' files, you can also add custom DT overlays.
  
-==== Write DT Overlay Source====+==== Write DT overlay source====
  
 Basic  DT overlay source example: Basic  DT overlay source example:
Line 174: Line 187:
 ``` ```
  
-==== Compile DT Overlay Source ====+==== Compile DT overlay source ====
  
 ```sh ```sh
Line 180: Line 193:
 ``` ```
  
-==== Copy DT Overlays to Special Folder ====+==== Copy DT overlays to special folder ====
  
   * VIM3 with 5.15 kernel is ''/boot/dtb/amlogic/kvim3.dtb.overlays''    * VIM3 with 5.15 kernel is ''/boot/dtb/amlogic/kvim3.dtb.overlays'' 
Line 187: Line 200:
   * VIM1S is ''/boot/dtb/amlogic/kvim1s.dtb.overlays''   * VIM1S is ''/boot/dtb/amlogic/kvim1s.dtb.overlays''
   * Edge2 is ''/boot/dtb/rockchip/rk3588s-khadas-edge2.dtb.overlays''   * Edge2 is ''/boot/dtb/rockchip/rk3588s-khadas-edge2.dtb.overlays''
 +  * Edge-2L is ''/boot/dtb/rockchip/rk3576-khadas-edge-2l.dtb.overlays''
   * VIM1/2/3/3L/Edge1 is ''/boot/dtb/overlays/%%*%%*BOARD%%*%%*''    * VIM1/2/3/3L/Edge1 is ''/boot/dtb/overlays/%%*%%*BOARD%%*%%*'' 
  
Line 193: Line 207:
 </WRAP> </WRAP>
  
-==== 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:
Line 203: Line 217:
   * VIM1S is ''/boot/dtb/amlogic/kvim4.dtb.overlay.env''   * VIM1S is ''/boot/dtb/amlogic/kvim4.dtb.overlay.env''
   * Edge2 is ''/boot/dtb/rockchip/rk3588s-khadas-edge2.dtb.overlay.env''   * Edge2 is ''/boot/dtb/rockchip/rk3588s-khadas-edge2.dtb.overlay.env''
 +  * Edge-2L is ''/boot/dtb/rockchip/rk3576-khadas-edge-2l.dtb.overlay.env''
  
 ==== Reboot ==== ==== Reboot ====
  
 Need reboot board to take effect. Need reboot board to take effect.
Last modified: 2026/05/11 02:18 by nick