设备树 dts & MIPI 屏幕视频输出信号问题排查

46 阅读2分钟

MIPI 显示相关文档

本文使用了 10.1 寸 MIPI 屏幕。将排线与板子接好后,发现设备上电后,屏幕无法正常显示视频信号:

MIPI 屏幕不正常

问题可能有两种情况:

  1. 排线未接好,或板子物理层面存在问题
  2. 板子的镜像有问题,未支持 MIPI 的输出

我们优先针对情况 2 进行排查——按照官网的方式刷写官方公开镜像:

android14_hdmi_dp_dsiC41409463_ap6256_msata_update.img

其中 dsiC41409463 表示支持这块 MIPI 屏幕:

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
.dtsiSoC 公共硬件定义芯片❌ 仅被 include 引用

通俗记忆

  • .dtsi:芯片手册,描述 CPU 本身有哪些控制器;
  • .dts:你的板子图纸,描述板子上哪些器件接上、参数怎么改。