4、DSI设备驱动模型：DSI设备注册、panel节点解析、of_graph与端口绑定

MIPI DSI 设备驱动模型是连接 DSI 主机控制器与显示面板的软件桥梁。本章深入剖析 DSI 设备的注册流程、设备树 panel 节点的解析方法，以及 of_graph 端口绑定机制，帮助开发者理解驱动框架如何自动完成设备发现与连接。

4.1 DSI 设备驱动模型总览

Linux 内核中，DSI 设备驱动模型采用分层架构，主要包含以下三个层次：

4.2 DSI 设备注册流程

DSI 设备的注册由主机控制器驱动发起，典型流程如下：

1. 主机控制器初始化： 在 probe() 中调用 mipi_dsi_host_register() 注册 mipi_dsi_host 实例。
2. 设备树解析： 内核遍历主机控制器的子节点，识别 compatible 属性匹配的 panel 节点。
3. DSI 设备创建： 调用 mipi_dsi_device_register_full() 创建 mipi_dsi_device 对象。
4. 总线匹配： 总线层根据 of_match_table 匹配 panel 驱动，调用驱动的 probe() 函数。
5. Panel 初始化： 在 panel 驱动的 probe() 中完成 DCS 初始化序列、时序配置和背光注册。

4.3 Panel 节点解析

设备树中 panel 节点的典型结构如下：

// 设备树片段：DSI 主机控制器与 panel 节点
dsi@ff450000 {
    compatible = "rockchip,rk3399-mipi-dsi";
    reg = <0xff450000 0x10000>;
    clocks = <&cru SCLK_MIPIDPHY_REF>;
    clock-names = "ref";
    phys = <&mipi_dphy>;
    phy-names = "dphy";
    status = "okay";

    panel@0 {
        compatible = "boe,tv080wum-nl0";
        reg = <0>;
        backlight = <&backlight>;
        enable-gpios = <&gpio1 13 GPIO_ACTIVE_HIGH>;
        reset-gpios = <&gpio1 14 GPIO_ACTIVE_LOW>;
        pinctrl-names = "default";
        pinctrl-0 = <&lcd_panel_enable>;

        port {
            panel_in: endpoint {
                remote-endpoint = <&dsi_out>;
            };
        };
    };
};

解析过程中，内核通过以下 API 提取关键信息：

4.4 of_graph 与端口绑定

of_graph 是内核提供的设备图解析框架，用于描述设备之间的数据连接关系。在 DSI 显示驱动中，它用于绑定主机控制器的输出端口与 panel 的输入端口。

端口绑定的核心 API 调用链如下：

// 主机控制器驱动中获取远程 panel 设备
struct device_node *remote_ep;
struct device_node *remote_node;
struct mipi_dsi_device *dsi;

// 1. 获取本地输出端口的远程 endpoint
remote_ep = of_graph_get_remote_endpoint(host->dev.of_node);

// 2. 获取远程 endpoint 所属的设备节点
remote_node = of_graph_get_remote_port_parent(remote_ep);

// 3. 创建 DSI 设备
dsi = mipi_dsi_device_register_full(host, remote_node);

// 4. 释放节点引用
of_node_put(remote_ep);
of_node_put(remote_node);

4.5 驱动绑定完整流程

从设备树解析到驱动绑定的完整流程可概括为以下步骤：

4.6 关键数据结构

DSI 设备驱动模型中，以下数据结构是开发者必须掌握的：

4.7 常见问题与排查

• 设备树节点未解析： 检查 compatible 字符串是否完全匹配，包括大小写和厂商前缀。
• 端口绑定失败： 使用 of_graph_get_remote_endpoint() 返回 NULL 时，检查 remote-endpoint 的 phandle 引用是否正确。
• DSI 设备创建失败： 确认主机控制器已成功注册，且 mipi_dsi_host_register() 返回 0。
• Panel probe 未调用： 检查 panel 驱动是否编译进内核，以及 module_platform_driver() 或 module_mipi_dsi_driver() 是否正确注册。