Linux Platform设备驱动框架详解与实践-嵌云网-嵌入式AI开发资源站

Linux Platform设备驱动框架详解与实践

刘慈欣

1. Linux内核Platform设备驱动框架概述

在嵌入式Linux开发领域，Platform设备驱动框架是连接SoC片上外设与内核的关键基础设施。这个框架最初由Russell King在2003年提出，目的是解决传统字符设备驱动在管理片上资源时的局限性。与需要物理总线的PCI、USB设备不同，Platform设备直接挂载在处理器地址空间，典型代表包括GPIO控制器、时钟模块、DMA引擎等。

我在实际开发中发现，许多工程师虽然能编写基本驱动模块，但对Platform框架的理解往往停留在表面。比如不清楚何时该选择Platform驱动而非传统字符设备驱动，或者混淆了device和driver的注册时序问题。这些问题在开发触摸屏控制器或传感器接口时尤为常见。

2. Platform框架核心组件解析

2.1 设备与驱动的分离设计

Platform框架最精妙之处在于贯彻了Linux设备模型中的"分离思想"。具体表现为：

platform_device：描述硬件资源
- 包含设备名称、ID、资源（内存/I/O区域、中断号）
- 通过struct resource定义硬件寄存器映射范围
```
c复制static struct resource foo_resources[] = {
    [0] = DEFINE_RES_MEM(0x10000000, 0x1000),
    [1] = DEFINE_RES_IRQ(IRQ_GPIO(5)),
};
```

platform_driver：实现驱动逻辑

包含probe/remove回调函数
通过of_match_table支持设备树匹配

c复制static const struct of_device_id foo_of_match[] = {
    { .compatible = "vendor,foo-device" },
    {},
};

重要提示：在设备树普及的现代内核中，platform_device通常由.dts文件定义，内核启动时自动转换生成，开发者应优先采用这种方式。

2.2 资源管理机制

Platform框架通过以下方式管理片上资源：

IORESOURCE_MEM：标记内存映射区域
IORESOURCE_IRQ：标记中断资源
**devm_**系列API：实现自动资源释放

实测案例：在调试i.MX6ULL的ECSPI控制器时，错误配置资源顺序会导致DMA传输失败。正确的做法是：

c复制platform_get_resource(pdev, IORESOURCE_MEM, 0);  // 寄存器基址
platform_get_irq(pdev, 0);  // 中断号

3. 设备树(Device Tree)集成实践

3.1 设备节点定义规范

现代Linux内核强烈推荐使用设备树描述Platform设备。以TI AM335x的GPIO模块为例：

dts复制gpio0: gpio@44e07000 {
    compatible = "ti,omap4-gpio";
    reg = <0x44e07000 0x1000>;
    interrupts = <96>;
    gpio-controller;
    #gpio-cells = <2>;
};

关键字段说明：

compatible：驱动匹配字符串，必须与驱动中的of_match_table一致
reg：寄存器物理地址和长度
interrupts：中断号及相关标志

3.2 驱动匹配流程

内核处理设备树节点的完整流程：

启动时，DTB被解析为device_node结构体
每个节点转换为platform_device
总线层比较device的compatible与driver的of_match_table
匹配成功后调用driver的probe函数

调试技巧：通过of_node->full_name和driver->name打印匹配过程：

c复制pr_info("Matching %s with %s\n", np->full_name, drv->name);

4. 典型驱动开发模式

4.1 传统板级支持包(BSP)方式

适用于旧内核或特殊硬件平台：

c复制static struct platform_device my_device = {
    .name = "my_platform_dev",
    .id = -1,
    .resource = my_dev_resources,
    .num_resources = ARRAY_SIZE(my_dev_resources),
};

static int __init my_init(void)
{
    platform_device_register(&my_device);
    platform_driver_register(&my_driver);
}

4.2 现代设备树驱动模式

推荐的新开发方式：

c复制static int my_probe(struct platform_device *pdev)
{
    struct resource *res;
    void __iomem *regs;
    
    res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
    regs = devm_ioremap_resource(&pdev->dev, res);
    
    int irq = platform_get_irq(pdev, 0);
    devm_request_irq(&pdev->dev, irq, my_isr, 0, "my_irq", NULL);
    
    // 初始化硬件
    iowrite32(0x55AA, regs + CONTROL_REG);
}

5. 高级应用与性能优化

5.1 多设备实例管理

当需要管理同类型多个设备时（如多个UART端口）：

c复制static int serial_probe(struct platform_device *pdev)
{
    int instance = of_alias_get_id(pdev->dev.of_node, "serial");
    struct serial_port *port = &ports[instance];
    
    port->regs = devm_platform_ioremap_resource(pdev, 0);
    // 其他初始化
}

对应的设备树：

dts复制serial0: serial@4000 {
    compatible = "vendor,uart";
    reg = <0x4000 0x100>;
    alias = "serial0";
};

serial1: serial@5000 {
    compatible = "vendor,uart";
    reg = <0x5000 0x100>;
    alias = "serial1";
};

5.2 DMA缓冲区共享

通过Platform框架实现驱动间DMA内存共享：

c复制struct shared_buffer {
    dma_addr_t dma_handle;
    void *cpu_addr;
    size_t size;
};

// 在probe函数中分配
ret = dma_alloc_coherent(&pdev->dev, size, &buf->dma_handle, GFP_KERNEL);

6. 调试与问题排查

6.1 常见错误代码

错误现象	可能原因	解决方案
probe未执行	compatible不匹配	检查dmesg中的OF匹配日志
资源获取失败	设备树reg/interrupts错误	使用`reg=`和`interrupts=`重新生成节点
内存访问异常	未正确映射寄存器	确认ioremap返回值非NULL

6.2 实用调试命令

查看已注册Platform设备：

bash复制ls /sys/bus/platform/devices

检查设备树节点：

bash复制dtc -I fs /proc/device-tree | less

动态日志跟踪：

bash复制echo 8 > /proc/sys/kernel/printk
dmesg | grep platform

7. 实际案例：GPIO按键驱动实现

完整实现一个通过Platform框架管理的按键驱动：

设备树节点：

dts复制buttons {
    compatible = "gpio-keys";
    button0 {
        label = "USER1";
        gpios = <&gpio0 5 GPIO_ACTIVE_LOW>;
        linux,code = <KEY_1>;
    };
};

驱动关键代码：

c复制static int buttons_probe(struct platform_device *pdev)
{
    struct gpio_desc *desc;
    desc = devm_gpiod_get(&pdev->dev, "button0", GPIOD_IN);
    
    int irq = gpiod_to_irq(desc);
    request_threaded_irq(irq, NULL, button_isr,
                         IRQF_TRIGGER_FALLING | IRQF_ONESHOT,
                         "button0", NULL);
}

static const struct of_device_id buttons_of_match[] = {
    { .compatible = "gpio-keys" },
    {},
};
MODULE_DEVICE_TABLE(of, buttons_of_match);

static struct platform_driver buttons_driver = {
    .probe = buttons_probe,
    .driver = {
        .name = "gpio-keys",
        .of_match_table = buttons_of_match,
    },
};

在调试这个驱动时，我发现必须为GPIO中断设置IRQF_ONESHOT标志，否则在快速连续按键时会出现中断丢失。这是典型的实时性要求场景下Platform驱动需要注意的细节。