3. RK3399 显示控制器 (VOP) 设备树节点：vopb 与 vopl 的差异、时钟配置、端口与端点绑定

RK3399 集成了两个独立的显示控制器——VOPB (Video Output Processor Big) 和 VOPL (Video Output Processor Little)。在设备树中，这两个节点分别对应 vopb 和 vopl，它们共享部分硬件资源，但在输出能力、时钟域和绑定方式上存在关键差异。理解这些差异是正确配置显示链路的基础。

3.1 VOPB 与 VOPL 的硬件差异

VOPB 是高性能显示控制器，支持更高的分辨率、更多的图层和更丰富的输出格式；VOPL 则面向低功耗场景，通常用于副屏或简单界面输出。下表列出了两者的核心差异：

3.2 时钟配置详解

每个 VOP 节点需要配置两组时钟：AXI 总线时钟 (ACLK) 和 AHB 总线时钟 (HCLK)，以及可选的 DCLK (像素时钟)。时钟名称和索引必须与 SoC 的时钟树定义一致。

以下是一个典型的 VOPB 时钟配置片段：

vopb: vop@ff900000 {
    compatible = "rockchip,rk3399-vop-big";
    reg = <0x0 0xff900000 0x0 0x3efc>;
    interrupts = <GIC_SPI 118 IRQ_TYPE_LEVEL_HIGH>;
    clocks = <&cru ACLK_VOPB>,
             <&cru HCLK_VOPB>,
             <&cru DCLK_VOPB>;
    clock-names = "aclk_vopb",
                  "hclk_vopb",
                  "dclk_vopb";
    power-domains = <&power RK3399_PD_VOPB>;
    resets = <&cru SRST_ACLK_VOPB>,
             <&cru SRST_HCLK_VOPB>;
    reset-names = "axi", "ahb";
    status = "disabled";
};

时钟配置的关键点：

• ACLK：VOP 内部 AXI 总线时钟，用于图层 DMA 传输，频率通常为 400~600 MHz。
• HCLK：AHB 总线时钟，用于寄存器访问，频率通常为 100~150 MHz。
• DCLK：像素时钟，由 CRU (Clock & Reset Unit) 根据显示时序动态调整，频率等于像素时钟频率。
• clock-names：必须与驱动中 devm_clk_get() 使用的名称完全匹配。

3.3 端口 (port) 与端点 (endpoint) 绑定

RK3399 的显示链路采用 OF Graph 绑定方式，通过 port 和 endpoint 描述 VOP 与外部显示接口控制器（如 HDMI、DP、DSI）之间的连接关系。每个 VOP 节点包含一个或多个 port，每个 port 包含一个 endpoint，指向下游显示接口控制器的输入端口。

下图展示了 VOPB 和 VOPL 与外部接口的典型绑定拓扑：

设备树中绑定的具体实现如下：

/* VOPB 节点内部 */
&vopb {
    status = "okay";

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

        vopb_out_hdmi: endpoint@0 {
            reg = <0>;
            remote-endpoint = <&hdmi_in_vopb>;
        };
    };

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

        vopb_out_dsi0: endpoint@0 {
            reg = <0>;
            remote-endpoint = <&dsi0_in_vopb>;
        };
    };
};

/* HDMI 控制器节点内部 */
&hdmi {
    status = "okay";

    ports {
        port@0 {
            reg = <0>;

            hdmi_in_vopb: endpoint@0 {
                reg = <0>;
                remote-endpoint = <&vopb_out_hdmi>;
            };
        };
    };
};

3.4 绑定规则与调试要点

在配置端口与端点绑定时，需要遵循以下规则：

1. 一对一绑定：每个 VOP 的 endpoint 只能连接到一个下游控制器的 endpoint，反之亦然。
2. 端口编号对应接口类型：port@0 通常对应第一个输出接口，port@1 对应第二个。具体映射关系由 SoC 设计决定，需查阅 TRM。
3. remote-endpoint 必须成对出现：VOP 的 endpoint 和下游控制器的 endpoint 必须互相引用，否则 OF Graph 解析失败。
4. status 属性：未使用的 VOP 或接口应设置为 status = "disabled"，避免驱动尝试初始化不存在的硬件链路。

3.5 双屏显示配置示例

以下是一个实际的双屏配置场景：VOPB 驱动 HDMI 4K 主屏，VOPL 驱动 MIPI DSI 1080p 副屏。设备树中需要同时使能两个 VOP 节点，并分别绑定到对应的输出接口。

/* 主屏：VOPB -> HDMI */
&vopb {
    status = "okay";
    assigned-clocks = <&cru DCLK_VOPB>;
    assigned-clock-rates = <594000000>;  /* 4K@60Hz 像素时钟 */
};

&hdmi {
    status = "okay";
    pinctrl-names = "default";
    pinctrl-0 = <&hdmi_cec>;
};

/* 副屏：VOPL -> MIPI DSI0 */
&vopl {
    status = "okay";
    assigned-clocks = <&cru DCLK_VOPL>;
    assigned-clock-rates = <148500000>;  /* 1080p@60Hz 像素时钟 */
};

&dsi0 {
    status = "okay";
    rockchip,lane-rate = <500>;
    panel@0 {
        compatible = "boe,tv080wum-nl0";
        reg = <0>;
        enable-gpios = <&gpio1 RK_PB5 GPIO_ACTIVE_HIGH>;
    };
};

在驱动层面，VOP 的绑定关系决定了 framebuffer 的分配策略：

• VOPB 通常绑定 /dev/dri/card0，作为主显示设备。
• VOPL 绑定 /dev/dri/card1，作为副显示设备。
• 用户空间可通过 DRM_IOCTL_MODE_GETCONNECTOR 查询每个 VOP 绑定的输出接口。