Description
This document describes how to enable/disable display screen functionality by modifying files in the SDK.
The RK3576 has three Video Port paths: vp0, vp1, and vp2. These three paths can be freely configured.
Each Video Port can be connected to any one of these interfaces: HDMI / eDP / DP / DSI-2. For example, in the default image:
| Path | Default Connected Interface |
|---|---|
| vp0 | HDMI |
| vp1 | DP |
| vp2 | MIPI |
The resources of these three paths are independent and do not affect each other. Therefore, we can enable/disable a certain display interface by modifying the device tree.
Moreover, the resources occupied by these three paths vary in size. For example:
| Path | Resolution Support |
|---|---|
| vp0 | Up to 4K@120Hz |
| vp1 | Up to 2560x1600@60Hz |
| vp2 | Up to 1920x1080@60Hz |
Device Tree Description
The main device tree file for TaishanPi-3M is:
kernel-6.1/arch/arm64/boot/dts/rockchip/tspi-3m-rk3576.dts
This file contains many .dtsi files. These .dtsi files are pre-defined hardware configuration files. To make it easy for you to use and modify, each functional interface has been split into a separate .dtsi file.
HDMI Display Switch
Open kernel-6.1/arch/arm64/boot/dts/rockchip/tspi-3m-rk3576.dts, find the following code snippet:
#include "tspi-3m-rk3576-hdmi.dtsi"Comment it out to disable the HDMI interface display function:
// #include "tspi-3m-rk3576-hdmi.dtsi"For specific testing, refer to: Debian12 HDMI Screen Display 🚀 chapter.
If you need to re-enable the HDMI interface display function, just uncomment the above code.
DP Display Switch
Open kernel-6.1/arch/arm64/boot/dts/rockchip/tspi-3m-rk3576.dts, find the following code snippet:
#include "tspi-3m-rk3576-dp.dtsi"Comment it out to disable the HDMI interface display function:
// #include "tspi-3m-rk3576-dp.dtsi"For specific testing, refer to: Debian12 DP Screen Display 🚀 chapter.
If you need to re-enable the DP interface display function, just uncomment the above code.
MIPI Display Switch
Open kernel-6.1/arch/arm64/boot/dts/rockchip/tspi-3m-rk3576.dts. We have pre-configured two different MIPI display configuration files for you:
tspi-3m-rk3576-dsi-c41409463.dtsi is adapted for the C41409463 model MIPI touchscreen in LCSC Mall.
tspi-3m-rk3576-dsi-c42388916.dtsi is adapted for the C42388916 model MIPI touchscreen in LCSC Mall.
Find the following code snippet:
// #include "tspi-3m-rk3576-dsi-c41409463.dtsi"// #include "tspi-3m-rk3576-dsi-c42388916.dtsi"Uncomment one of them to enable the corresponding MIPI interface display function. For example, to enable the C41409463 model MIPI touchscreen:
#include "tspi-3m-rk3576-dsi-c41409463.dtsi"For specific testing, refer to: Debian12 MIPI Screen Display 🚀 chapter.
If you need to re-disable the MIPI interface display function, just comment out the above code.
Compile Kernel and Flash
After setting the device tree file, you also need to recompile the kernel. Refer to Debian12 Kernel Compilation 🚀 chapter for compilation, then flash the kernel image separately.
Testing and Verification
For specific testing, refer to: