Enabling different Device Tree Overlays (DTBOs) allows optional hardware or kernel modifications to be enabled, without recompiling the linux kernel.
This is also the intended way alter the behavior of the kernel. For example to enable the panthor graphics stack or disable the led on your system.
sudo bredos-config
The tool then installs the base device tree and the selected overlays. Then navigate to Device Tree Manager
-> Enable / Disable Overlays
and enable dtb overlays to your liking. Reboot your system to aplly the changes.
While bredos-config is able to install dtbs and alter the grub config to load them on boot it cannot alter UEFI settings. This has to be done by the user. The changes the user has to made are shown by bredos-config on first installation of base/overlay dtbs or under the step with 3.4 Configure UEFI
. If your device is u-boot-based
no further changes are needed.
If during board power-on you see a BredOS logo, you are using UEFI.
This is the recommended way to enable/disable dtb overlays. The following steps are not neccessary if you use
bredos-config
.
If you are running on a UEFI-powered board, you need to configure it.
If you have already done this before you can skip ahead to step 5.
Images after 12th of September 2024 use
/boot/efi
instead of/boot
.
To determine where your ESP partition is located, run the command,
df | grep "/boot" | awk '{print $NF}'
and replace <ESP>
IN ALL OF THE FOLLOWING commands with it's output.
sudo mkdir -p <ESP>/dtb/{base,overlays}
If you are using a FydeTab Duo, copy the specific DTB file to the
base
folder:sudo cp /boot/dtbs/rockchip/rk3588s-fydetab-duo.dtb /dtb/base/
sudo cp /dtb/base/rk3588s-fydetab-duo.dtb /dtb/base/rk3588s-tablet-12c-linux.dtb
rk3588-board.dtb
with your actual device name:sudo cp /boot/dtbs/rockchip/rk3588-board.dtb <ESP>/dtb/base/
sudo nano /etc/default/grub
#
at the beginning:# GRUB_DTB="dtbs/rockchip/device-tree.dtb"
sudo grub-mkconfig -o /boot/grub/grub.cfg
Device Manager
> Rockchip Platform Configuration
> ACPI / Device Tree
, and do the following:If you need help there is a guide to change the boot order. In its first steps it shows you how to boot into UEFI Settings.
Navigate to Device Manager
> Rockchip Platform Configuration
> ACPI / Device Tree
Set Config Table Mode
to Device Tree
Change Support DTB override & overlays
to Enabled
Continue
).my-overlay
with the dtbo of your choice.sudo cp /boot/dtbs/rockchip/overlay/my-overlay.dtbo <ESP>/dtb/overlays/
sudo nano /boot/extlinux/extlinux.conf
fdtoverlays /dtbs/rockchip/overlay/my-overlay.dtbo
DO NOT add more than one
fdtoverlays
line.
If you wish to enable more than one DTBOs, append them onto the one line, seperated by a whitespace.
For example:fdtoverlays /dtbs/rockchip/overlay/overlay1.dtbo /dtbs/rockchip/overlay/overlay2.dtbo