4. DRM驱动与Device Tree的绑定：如何通过Device Tree匹配DRM驱动、platform_driver与of_match_table的使用

在嵌入式Linux系统中，DRM/KMS显示驱动通常以platform_driver的形式存在，并通过Device Tree（设备树）完成硬件描述与驱动匹配。本章将深入剖析DRM驱动与Device Tree的绑定机制，重点讲解of_match_table在驱动匹配中的核心作用，以及如何编写兼容的设备树节点。

4.1 驱动匹配的核心机制：platform_driver与of_match_table

DRM显示驱动在Linux内核中注册为platform_driver，其匹配过程依赖于of_match_table。当内核启动时，Device Tree中的每个节点都会被解析为platform_device，而驱动则通过of_match_table中的compatible字符串与设备节点进行匹配。

4.1.1 标准匹配流程

1. 设备树解析： 内核启动时，DTB（Device Tree Blob）被解析，每个节点生成一个platform_device。
2. 驱动注册： DRM驱动调用platform_driver_register()，将of_match_table注册到内核。
3. 匹配检查： 内核遍历已注册的platform_device，将设备节点的compatible属性与驱动的of_match_table逐一比对。
4. 绑定与probe： 匹配成功后，内核调用驱动的probe()函数，传入匹配的platform_device指针。

4.2 of_match_table 结构详解

of_match_table是驱动与设备树绑定的桥梁，其核心数据结构为struct of_device_id。以下表格展示了该结构体的关键字段及其用途：

4.2.1 典型驱动代码示例

以下是一个DRM显示驱动的of_match_table定义示例，展示了如何为不同硬件变体提供匹配条目：

static const struct of_device_id dp_driver_of_match[] = {
    {
        .compatible = "rockchip,rk3399-dp",
        .data = &rk3399_dp_config,
    },
    {
        .compatible = "rockchip,rk3568-dp",
        .data = &rk3568_dp_config,
    },
    {
        .compatible = "rockchip,rk3588-dp",
        .data = &rk3588_dp_config,
    },
    { /* sentinel */ }
};
MODULE_DEVICE_TABLE(of, dp_driver_of_match);

4.3 设备树节点编写规范

设备树节点必须与驱动的of_match_table严格对应。以下是一个典型的DRM显示控制器节点示例：

/* 设备树节点示例：RK3399 DisplayPort控制器 */
dp0: dp@fec00000 {
    compatible = "rockchip,rk3399-dp";
    reg = <0x0 0xfec00000 0x0 0x4000>;
    interrupts = <GIC_SPI 98 IRQ_TYPE_LEVEL_HIGH>;
    clocks = <&cru PCLK_DP0>, <&cru SCLK_DP0>;
    clock-names = "pclk", "sclk";
    power-domains = <&power RK3399_PD_DP0>;
    phys = <&dp0_phy>;
    phy-names = "dp";
    status = "disabled";
};

4.3.1 节点属性与驱动字段映射

4.4 probe函数中的资源获取

当驱动匹配成功后，probe()函数被调用。开发者需要从platform_device中提取设备树描述的资源，并初始化DRM子组件。以下是一个典型的probe函数框架：

static int dp_driver_probe(struct platform_device *pdev)
{
    struct device *dev = &pdev->dev;
    const struct of_device_id *match;
    const struct dp_config *config;
    struct drm_device *drm;
    struct dp_device *dp;
    int ret;

    /* 1. 获取匹配的data指针 */
    match = of_match_device(dp_driver_of_match, dev);
    if (!match || !match->data)
        return -EINVAL;
    config = match->data;

    /* 2. 分配私有数据结构 */
    dp = devm_kzalloc(dev, sizeof(*dp), GFP_KERNEL);
    if (!dp)
        return -ENOMEM;

    /* 3. 获取寄存器资源 */
    dp->regs = devm_platform_ioremap_resource(pdev, 0);
    if (IS_ERR(dp->regs))
        return PTR_ERR(dp->regs);

    /* 4. 获取中断 */
    dp->irq = platform_get_irq(pdev, 0);
    if (dp->irq < 0)
        return dp->irq;

    /* 5. 获取时钟 */
    dp->pclk = devm_clk_get(dev, "pclk");
    if (IS_ERR(dp->pclk))
        return dev_err_probe(dev, PTR_ERR(dp->pclk), "failed to get pclk\n");

    /* 6. 初始化DRM组件 */
    drm = drm_dev_alloc(&dp_driver_fops, dev);
    if (IS_ERR(drm))
        return PTR_ERR(drm);

    /* 7. 注册DRM设备 */
    ret = drm_dev_register(drm, 0);
    if (ret) {
        drm_dev_put(drm);
        return ret;
    }

    platform_set_drvdata(pdev, dp);
    return 0;
}

4.5 多平台适配策略

当同一驱动需要支持多个SoC平台时，of_match_table的data字段成为关键。以下是一个多平台适配的架构图：

4.6 匹配优先级与回退机制

内核在匹配of_match_table时，遵循以下优先级规则：

• 精确匹配： 设备树节点的compatible属性与驱动表中的字符串完全一致。
• 通配符匹配： 驱动表支持使用NULL作为通配符，但实际使用较少。
• 别名匹配： 设备树节点可以包含多个compatible值，内核按顺序尝试匹配。

4.7 调试与验证方法

开发过程中，可以通过以下方法验证驱动与Device Tree的绑定是否正确：

4.8 本章小结

DRM驱动与Device Tree的绑定是嵌入式显示驱动开发的基础。通过of_match_table，驱动可以灵活适配多种硬件平台，而无需修改核心逻辑。关键要点包括：

• of_match_table中的compatible字符串必须与设备树节点严格一致。
• 使用data指针传递平台特定配置，避免在probe函数中硬编码条件判断。
• 设备树节点中的资源（reg、interrupts、clocks等）通过platform_get_resource系列函数获取。
• 多平台适配时，利用of_match_table的优先级和回退机制，实现通用与专用驱动的共存。