本文使用了 10.1 寸 MIPI 屏幕。将排线与板子接好后,发现设备上电后,屏幕无法正常显示视频信号:
问题可能有两种情况:
- 排线未接好,或板子物理层面存在问题
- 板子的镜像有问题,未支持 MIPI 的输出
我们优先针对情况 2 进行排查——按照官网的方式刷写官方公开镜像:
android14_hdmi_dp_dsiC41409463_ap6256_msata_update.img
其中 dsiC41409463 表示支持这块 MIPI 屏幕:
可以看到屏幕已经点亮,证明排线与硬件物理连接正常。
自编译镜像支持 MIPI
官方固件已能点亮 MIPI 屏幕,但我们要改动系统源码,应如何修改以使自编译固件支持 MIPI 输出呢?
在 kernel-6.1/arch/arm64/boot/dts/rockchip/tspi-3m-rk3576.dts 中解除 MIPI 相关代码的注释:
#include "tspi-3m-rk3576-dsi-c41409463.dtsi"
然后重新进行镜像编译即可。
然而重新编译后仍无法点亮,经过排查发现,问题并不是出在源码或镜像本身,而是还需要修改 kernel-6.1/arch/arm64/boot/dts/rockchip/tspi-3m-rk3576-dsi-c41409463.dtsi 中的 GPIO 引脚配置:
reset-gpios = <&gpio2 RK_PB4 GPIO_ACTIVE_LOW>; /* align to official image (GPIO2_B4, pin12); was gpio3 RK_PC7 */
DTS / DTSI 设备树
设备树(Device Tree)是 Linux 内核用来描述硬件板级资源的机制,用以替代硬编码的板级文件。
.dts
Device Tree Source,板级设备树源文件
- 对应某一块具体的开发板 / 整机,描述这块板子真实硬件配置。
- 包含:板上外设、引脚配置、电源、总线、硬件修改、覆盖 dtsi 的参数。
- 一个板子一般一个 dts。
- 会
#include "xxx.dtsi"引入通用芯片配置。
示例结构:
#include "rk3576.dtsi"
/ {
model = "My RK3576 Board";
compatible = "my,rk3576-board";
leds {
status = "okay";
};
};
.dtsi
Device Tree Source Include,设备树头文件,类似 C 语言 .h
- 放芯片 SoC 通用定义:内部控制器、I2C、SPI、GPIO、时钟、寄存器基地址。
- 多个 dts 可以共同 include 同一个 dtsi。
- 只描述 SoC 内部硬件,不写板子特有外设。
- 一般不能单独编译,只能被
.dts包含。
例如
rk3576.dtsi描述 RK3576 这颗 CPU 的所有内部模块,所有基于 RK3576 的板子 dts 都会 include 它。
编译关系
xxx.dts # 板级文件
#include xxx.dtsi # 引入 SoC 公共配置
↓ dtc 编译器
xxx.dtb # 二进制设备树,供内核加载使用
status 属性很关键
status = "okay":启用设备status = "disabled":关闭设备
dtsi 中很多外设默认是
disabled,在 dts 里改成okay代表板子上实际接上了该器件。
简单对比表
| 文件 | 作用 | 对应对象 | 是否可直接编译 |
|---|---|---|---|
.dts | 单板硬件描述 | 具体板子 | ✅ 可以,输出 dtb |
.dtsi | SoC 公共硬件定义 | 芯片 | ❌ 仅被 include 引用 |
通俗记忆
.dtsi:芯片手册,描述 CPU 本身有哪些控制器;.dts:你的板子图纸,描述板子上哪些器件接上、参数怎么改。