3. 内核驱动框架：DRM/KMS框架下的RK HDMI驱动、设备树dts配置要点

瑞芯微（Rockchip）平台的HDMI显示输出完全遵循Linux内核的DRM（Direct Rendering Manager）/KMS（Kernel Mode Setting）框架。理解这一框架下的驱动分层与设备树（Device Tree）配置，是进行HDMI异常排查的基础。本章将深入剖析RK HDMI驱动的软件架构、关键数据结构以及设备树节点的配置要点。

3.1 DRM/KMS框架与RK HDMI驱动分层

DRM/KMS是Linux内核中用于管理显示输出和图形渲染的现代框架。在RK平台上，HDMI驱动作为KMS输出组件（Connector + Encoder）的一部分，与CRTC（显示控制器）和Plane（图层）协同工作。

3.2 RK HDMI驱动关键组件与数据结构

RK平台HDMI驱动主要分为两类：Synopsys DesignWare HDMI（dw-hdmi）和Rockchip Inno HDMI（inno-hdmi）。前者用于RK3399、RK3568等中高端芯片，后者用于RK3328、RK3128等入门级芯片。两者在DRM框架下的注册流程一致，但寄存器接口和PHY配置不同。

3.3 设备树（DTS）配置要点

设备树是RK平台硬件描述的核心。HDMI相关的DTS配置涉及节点使能、时钟、复位、IO电压、PHY以及显示接口路由。错误的DTS配置是导致HDMI初始化失败的最常见原因之一。

3.3.1 核心节点配置

以下是一个基于RK3568的典型HDMI设备树节点配置示例：

// 文件：arch/arm64/boot/dts/rockchip/rk3568.dtsi (SoC级)
hdmi: hdmi@fe0a0000 {
    compatible = "rockchip,rk3568-dw-hdmi";
    reg = <0x0 0xfe0a0000 0x0 0x20000>;
    interrupts = <GIC_SPI 45 IRQ_TYPE_LEVEL_HIGH>;
    clocks = <&cru PCLK_HDMI>,
             <&cru HCLK_VOP>,
             <&cru CLK_HDMI_CEC>,
             <&cru HCLK_VO>;
    clock-names = "pclk", "hclk", "cec", "hclk_vo";
    resets = <&cru SRST_HDMI>;
    reset-names = "hdmi";
    pinctrl-names = "default";
    pinctrl-0 = <&hdmi_hpd>, <&hdmi_cec>;
    power-domains = <&power RK3568_PD_VO>;
    #address-cells = <1>;
    #size-cells = <0>;
    status = "disabled";

    ports {
        #address-cells = <1>;
        #size-cells = <0>;

        port@0 {
            reg = <0>;
            #address-cells = <1>;
            #size-cells = <0>;

            hdmi_in_vop: endpoint@0 {
                reg = <0>;
                remote-endpoint = <&vop_out_hdmi>;
            };
        };
    };
};

// 文件：arch/arm64/boot/dts/rockchip/rk3568-evb.dts (板级)
&hdmi {
    status = "okay";
    pinctrl-0 = <&hdmi_hpd>, <&hdmi_cec>, <&hdmi_i2c_xfer>;
    hdmi_io_voltage = <1800000>;  // 1.8V IO电压
};

&hdmi_phy {
    status = "okay";
};

3.3.2 关键属性排查清单

3.4 显示接口路由与VOP绑定

RK平台支持多路显示输出（如HDMI、DP、MIPI DSI、eDP）。VOP（CRTC）与HDMI Encoder之间的绑定通过设备树中的 ports 节点实现。错误的端口绑定会导致“CRTC无输出”或“Encoder无输入”。

3.5 驱动初始化流程与常见失败点

RK HDMI驱动在DRM框架下的初始化流程如下：

1. 组件注册： VOP、HDMI Encoder、HDMI Connector分别调用 component_add() 注册到DRM子系统中。
2. 绑定阶段： DRM核心通过 component_bind_all() 将CRTC与Encoder、Connector绑定。
3. 模式设置： 用户空间通过KMS ioctl设置分辨率，驱动调用 .mode_set() 和 .enable() 回调。
4. PHY配置： 根据分辨率配置HDMI PHY的PLL和均衡器。
5. 信号输出： 启动TMDS信号传输。

3.6 调试手段与日志分析

当HDMI输出异常时，以下调试手段可以帮助快速定位问题：