Linux平台设备驱动开发与设备树实践指南

1. 平台设备与驱动注册的核心概念

在Linux内核开发中，平台设备和平台驱动是嵌入式系统开发中最常打交道的两个概念。我第一次接触这个机制是在2013年开发一块基于ARM的工控板时，当时为了搞清楚它们之间的关系整整花了两周时间。

平台设备(platform device)在内核中代表那些无法通过标准总线(如PCI、USB)自动发现的设备，这类设备通常直接集成在SoC芯片上或者通过固定地址连接到系统总线。典型的例子包括：

• 集成在SoC内部的UART控制器
• 通过内存映射访问的GPIO控制器
• 固定地址的I2C适配器

而平台驱动(platform driver)则是专门为这些平台设备编写的驱动程序。与传统的字符设备驱动不同，平台驱动需要通过platform_driver_register()显式注册到内核的platform总线上。

关键区别：普通字符设备通过主次设备号标识，而平台设备通过名称(name)和资源(resources)来匹配驱动

2. 设备树(Device Tree)带来的变革

在设备树普及之前，平台设备信息都是硬编码在内核源码中的arch/arm/mach-xxx目录下。我2015年参与的一个项目需要支持三款不同硬件配置的设备，当时不得不维护多个内核分支，每次功能更新都要合并到各个分支，苦不堪言。

设备树的出现彻底改变了这种局面。现在典型的平台设备在设备树中的定义如下：

code复制uart0: serial@101f0000 {
    compatible = "vendor,uart";
    reg = <0x101f0000 0x1000>;
    interrupts = <42 IRQ_TYPE_LEVEL_HIGH>;
    clocks = <&uart_clk>;
    clock-names = "apb_pclk";
};

对应的驱动代码中会这样匹配：

c复制static const struct of_device_id uart_dt_ids[] = {
    { .compatible = "vendor,uart" },
    {}
};
MODULE_DEVICE_TABLE(of, uart_dt_ids);

static struct platform_driver uart_driver = {
    .driver = {
        .name = "vendor-uart",
        .of_match_table = uart_dt_ids,
    },
    .probe = uart_probe,
    .remove = uart_remove,
};

3. 注册流程中的经典坑位

3.1 资源(Resource)定义错误

resource是平台设备最核心的配置之一，常见问题包括：

1. 内存区域大小不对齐到页大小(4KB)
2. 中断号与硬件实际连接不符
3. 忘记设置IORESOURCE_MEM/IORESOURCE_IRQ标志

我遇到过最隐蔽的一个bug是：某款SoC的寄存器区域实际需要32字节对齐，但设备树里按常规写了4字节对齐，导致偶尔出现寄存器写入无效的情况。

3.2 设备与驱动匹配失败

匹配失败通常表现为probe函数不被调用，可能原因：

• compatible字符串拼写错误（注意大小写）
• 驱动模块未正确导出of_match_table
• 设备树节点status不是"okay"
• 驱动注册时机晚于设备注册

调试技巧：

bash复制# 查看已注册的平台设备
ls /sys/devices/platform/

# 检查设备树节点状态
cat /proc/device-tree/path/to/device/status

3.3 电源管理相关陷阱

在实现suspend/resume功能时容易踩的坑：

1. 未正确处理时钟管理

c复制// 错误示例：直接关闭时钟
clk_disable_unprepare(uart->clk);

// 正确做法：保存时钟状态
if (device_may_wakeup(dev))
    enable_irq_wake(uart->irq);
else
    clk_disable_unprepare(uart->clk);

2. 寄存器上下文保存/恢复不全
3. 未考虑DMA缓存一致性

4. 多平台兼容性设计

在为不同硬件平台开发驱动时，我总结出以下经验：

4.1 抽象硬件差异层

c复制struct uart_hw_ops {
    int (*init)(struct uart_device *uart);
    void (*set_baud)(struct uart_device *uart, int rate);
    // ...
};

// 针对不同SoC的实现
static const struct uart_hw_ops soc_a_ops = {
    .init = soc_a_uart_init,
    .set_baud = soc_a_set_baud,
};

static const struct uart_hw_ops soc_b_ops = {
    // ...
};

4.2 动态检测