说明
本文档介绍如何通过修改 SDK 中的文件来实现开关屏幕显示功能。
在RK3576的有三个 Video Port 通路,分别是 vp0、vp1、vp2,这三个通路可以随意配置。
每个 Video Port 都可以接 HDMI / eDP / DP / DSI‑2 这几种接口中的任意一种,例如在默认的镜像中:
| 通路 | 默认连接到的接口 |
|---|---|
| vp0 | HDMI |
| vp1 | DP |
| vp2 | MIPI |
这三个通路的资源是独立的,互不影响,所以我们可以通过修改设备树的方式来实现关闭某个显示接口的功能。
而且这三个通路所占用的资源也是有大有小,例如:
| 通路 | 分辨率支持情况 |
|---|---|
| vp0 | 最高支持 4K@120Hz |
| vp1 | 最高支持 2560x1600@60Hz |
| vp2 | 最高支持 1920x1080@60Hz |
设备树说明
在泰山派3m的主设备树文件是:
kernel-6.1/arch/arm64/boot/dts/rockchip/tspi-3m-rk3576.dts
在这个文件中包含了很多的 .dtsi 文件,这些 .dtsi 文件是为大家预定义好的一些硬件配置文件,而且为了方便大家使用和修改,将每个功能的接口都单独拆分成了一个 .dtsi 文件。
HDMI显示开关
打开 kernel-6.1/arch/arm64/boot/dts/rockchip/tspi-3m-rk3576.dts 文件,找到如下的代码片段:
#include "tspi-3m-rk3576-hdmi.dtsi"将其注释掉,即可关闭 HDMI 接口的显示功能:
// #include "tspi-3m-rk3576-hdmi.dtsi"具体的测试参考: Debian12 HDMI屏幕显示🚀 章节。
如果需要重新启用 HDMI 接口的显示功能,只需要将上面的代码取消注释即可。
DP显示开关
打开 kernel-6.1/arch/arm64/boot/dts/rockchip/tspi-3m-rk3576.dts 文件,找到如下的代码片段:
#include "tspi-3m-rk3576-dp.dtsi"将其注释掉,即可关闭 HDMI 接口的显示功能:
// #include "tspi-3m-rk3576-dp.dtsi"具体的测试参考: Debian12 DP屏幕显示🚀 章节。
如果需要重新启用 DP 接口的显示功能,只需要将上面的代码取消注释即可。
MIPI显示开关
打开 kernel-6.1/arch/arm64/boot/dts/rockchip/tspi-3m-rk3576.dts 文件,在其中为大家预置了两个不同的 MIPI 显示屏配置文件,分别是:
tspi-3m-rk3576-dsi-c41409463.dtsi 适配了立创商城中 C41409463 型号的 MIPI 触摸屏幕。

tspi-3m-rk3576-dsi-c42388916.dtsi 适配了立创商城中 C42388916 型号的 MIPI 触摸屏幕。

找到如下的代码片段:
// #include "tspi-3m-rk3576-dsi-c41409463.dtsi"// #include "tspi-3m-rk3576-dsi-c42388916.dtsi"取消注释其中一个,即可启用对应的 MIPI 接口的显示功能,例如启用 C41409463 型号的 MIPI 触摸屏幕:
#include "tspi-3m-rk3576-dsi-c41409463.dtsi"具体的测试参考: Debian12 MIPI屏幕显示🚀 章节。
如果需要重新关闭 MIPI 接口的显示功能,只需要将上面的代码注释掉即可。
编译内核与烧录
设定好了设备树文件之后,还需要重新编译内核,参考 Debian12 编译内核🚀 章节进行编译,然后烧录单独的内核镜像即可。
测试验证
具体的测试参考: