设备树驱动匹配实战：of_match_ptr与platform_driver的深度解析

1. 设备树驱动开发入门：从概念到实战

大家好，我是有十多年嵌入式开发经验的老司机。今天咱们来聊聊Linux设备树驱动开发中一个非常核心的话题：platform_driver与of_match_ptr的匹配机制。如果你正在做嵌入式Linux开发，特别是驱动开发，这篇文章可能会帮你少踩很多坑。

先说说为什么需要设备树。在早期的Linux内核中，硬件信息都是直接写在内核代码里的，这导致每换一个硬件平台就要重新编译内核，非常麻烦。设备树（Device Tree）的出现解决了这个问题，它把硬件描述信息从内核代码中分离出来，形成一个独立的配置文件（.dts文件）。这样，同一个内核镜像就可以在不同的硬件平台上运行，只需要加载对应的设备树文件即可。

在实际开发中，我们需要让驱动程序能够正确识别和匹配设备树中描述的硬件设备，这就是platform_driver和of_match_ptr发挥作用的地方。简单来说，platform_driver是Linux内核中用于管理平台设备的一种驱动模型，而of_match_ptr则是连接设备树节点和驱动程序的关键桥梁。

让我用一个生活中的比喻来解释：设备树就像是一份硬件清单，列出了所有可用的硬件设备及其特性；而驱动程序就像是设备的驱动程序，知道如何操作特定的硬件。of_match_ptr就像是这份清单的索引，帮助系统快速找到对应的驱动程序。

2. 设备树节点编写详解

2.1 设备树基础结构

设备树采用树状结构描述硬件资源，从根节点开始，逐级描述系统中的各种设备。每个设备节点都包含若干属性和值，用来描述设备的特性和资源配置。

让我们看一个具体的设备树节点示例：

/ {
    compatible = "my_platform";
    
    my_key_device {
        compatible = "example,my_key";
        mykey-gpios = <&gpio0 16 GPIO_ACTIVE_LOW>;
        reg = <0x00001234 0x0800>;
        interrupt-parent = <&gpio0>;
        interrupts = <10 IRQ_TYPE_LEVEL_HIGH>;
        status = "okay";
    };
};

在这个示例中，我们定义了一个名为"my_key_device"的设备节点。每个属性都有其特定含义：

• compatible：这是最重要的属性，用于驱动匹配。格式通常是"制造商,设备型号"，这样驱动程序可以通过这个字符串来识别设备。

• mykey-gpios：定义GPIO资源，指定使用哪个GPIO控制器、哪个引脚和有效电平。

• reg：指定设备的寄存器地址范围和大小。

• interrupt-parent和interrupts：定义中断相关配置。

在实际项目中，我经常看到开发者因为设备树节点编写不规范而导致驱动无法正常匹配。最常见的问题就是compatible字符串写错，或者格式不符合约定俗成的规范。

2.2 设备树编译与调试技巧

编写好设备树后，我们需要使用设备树编译器（DTC）将其编译成二进制格式（.dtb）。编译过程中可能会遇到各种语法错误，这时候就需要仔细检查设备树源文件。

我个人的经验是，在修改设备树后，一定要用dtc工具进行语法检查：

dtc -I dts -O dtb -o my_platform.dtb my_platform.dts

如果编译通过，还可以使用反编译命令来验证设备树内容是否正确：

dtc -I dtb -O dts my_platform.dtb

在实际调试中，我经常使用/proc/device-tree目录来查看内核实际加载的设备树信息。这个目录下包含了当前系统设备树的完整结构，可以帮助我们确认设备节点是否被正确解析。

另一个有用的调试技巧是在内核启动参数中添加earlycon和earlyprintk选项，这样可以在早期启动阶段就看到设备树相关的调试信息。

3. platform_driver驱动开发实战

3.1 platform_driver结构体详解

现在让我们深入看看platform_driver的结构。这是一个相对复杂的结构体，包含了很多重要的字段：

struct platform_driver {
    int (*probe)(struct platform_device *pdev);
    int (*remove)(struct platform_device *pdev);
    void (*shutdown)(struct platform_device *pdev);
    int (*suspend)(struct platform_device *pdev, pm_message_t state);
    int (*resume)(struct platform_device *pdev);
    struct device_driver driver;