嵌入式 Linux 与 RTOS / 系统课时
用 Platform 驱动匹配设备
用 Platform 驱动匹配设备
Platform 驱动用于描述 SoC 内部这类不能靠总线枚举发现的设备。本篇从设备树 compatible 匹配开始,在 probe 中取得寄存器、IRQ 和时钟资源,并用 devm 接口把资源释放绑定到设备生命周期,形成可维护的板级驱动骨架。
学习目标
- 理解设备树
compatible、of_match_table与probe之间的匹配关系 - 在
probe中正确获取并校验 MMIO、IRQ 与时钟资源 - 使用 devm 系列接口处理失败回滚和设备解绑时的资源释放
从设备树节点进入 probe
Platform 设备通常由设备树创建。内核解析节点后形成 platform_device,Platform bus 再把设备节点的 compatible 与驱动的 of_match_table 比较;命中后才调用驱动的 probe。因此资源获取失败属于 probe 阶段问题,而不是匹配问题。

匹配表必须以空元素结束,并通过 MODULE_DEVICE_TABLE(of, ...) 导出设备树别名。module_platform_driver() 则负责生成模块初始化与退出代码,避免手写重复的 platform_driver_register() 和 platform_driver_unregister()。
写出标准资源获取骨架
下面的驱动完整可编译。它映射第一个 reg 资源、取得第一个 IRQ,并获取名为 core 的可选时钟。示例只取得 IRQ 而不注册中断处理函数,因为真实中断处理必须知道设备状态寄存器和清中断规则;在不了解硬件的情况下写一个始终返回 IRQ_HANDLED 的处理函数,反而可能制造中断风暴。
将代码保存为 demo_platform.c:
#include <linux/clk.h>
#include <linux/io.h>
#include <linux/module.h>
#include <linux/of.h>
#include <linux/platform_device.h>
#include <linux/slab.h>
struct demo_dev {
void __iomem *base;
int irq;
struct clk *clk;
};
static void demo_disable_clk(void *data)
{
struct clk *clk = data;
clk_disable_unprepare(clk);
}
static int demo_probe(struct platform_device *pdev)
{
struct device *dev = &pdev->dev;
struct demo_dev *d;
int ret;
d = devm_kzalloc(dev, sizeof(*d), GFP_KERNEL);
if (!d)
return -ENOMEM;
/* devm 映射会在 probe 失败或设备解绑时自动撤销。 */
d->base = devm_platform_ioremap_resource(pdev, 0);
if (IS_ERR(d->base))
return dev_err_probe(dev, PTR_ERR(d->base),
"failed to map registers\n");
d->irq = platform_get_irq(pdev, 0);
if (d->irq < 0)
return dev_err_probe(dev, d->irq,
"failed to get irq\n");
d->clk = devm_clk_get_optional(dev, "core");
if (IS_ERR(d->clk))
return dev_err_probe(dev, PTR_ERR(d->clk),
"failed to get clock\n");
if (d->clk) {
ret = clk_prepare_enable(d->clk);
if (ret)
return dev_err_probe(dev, ret,
"failed to enable clock\n");
/* 时钟启用不是 devm_clk_get 的自动动作,因此显式挂清理动作。 */
ret = devm_add_action_or_reset(dev, demo_disable_clk, d->clk);
if (ret)
return ret;
}
platform_set_drvdata(pdev, d);
dev_info(dev, "resources ready: irq=%d\n", d->irq);
return 0;
}
static const struct of_device_id demo_of_match[] = {
{ .compatible = "anystack,demo-peripheral" },
{ }
};
MODULE_DEVICE_TABLE(of, demo_of_match);
static struct platform_driver demo_driver = {
.probe = demo_probe,
.driver = {
.name = "anystack-demo",
.of_match_table = demo_of_match,
},
};
module_platform_driver(demo_driver);
MODULE_LICENSE("GPL");
MODULE_DESCRIPTION("Platform driver resource management example");同目录创建 Makefile:
obj-m += demo_platform.o编译并确认模块生成:
make -C /lib/modules/$(uname -r)/build M=$PWD modules
test -f demo_platform.ko && echo OK预期输出的最后一行:
OK编译成功只说明驱动代码和当前内核 API 匹配;是否进入 probe,还取决于系统中是否存在 compatible 匹配的设备。
准备对应的设备树节点
下面是片段示例,需要放入具体 SoC 的设备树总线节点中。reg 的地址单元格式、interrupts 的编码以及时钟控制器 phandle 都由平台决定,不能原样复制到任意开发板。
demo@10000000 {
compatible = "anystack,demo-peripheral";
reg = <0x10000000 0x1000>;
interrupts = <0 42 4>;
clocks = <&periph_clk>;
clock-names = "core";
status = "okay";
};这里真正决定驱动匹配的是 compatible = "anystack,demo-peripheral"。reg 对应 devm_platform_ioremap_resource(pdev, 0),第一个 interrupts 对应 platform_get_irq(pdev, 0),而 clock-names = "core" 与 devm_clk_get_optional(dev, "core") 的名称必须一致。
验证匹配和资源获取
把正确的设备树部署到目标板、启动新设备树并加载驱动后,可查看内核日志:
sudo insmod demo_platform.ko
dmesg | grep 'resources ready'匹配和资源获取成功时,预期看到类似:
anystack-demo <ID>.demo: resources ready: irq=<ID>其中设备名和 IRQ 编号由平台决定,实际值可能不同。如果日志里完全没有 probe 相关信息,先检查设备树节点是否启用、compatible 是否逐字匹配以及模块是否已加载;如果进入 probe 后返回错误,则继续按 reg、IRQ、时钟的顺序检查对应资源描述。
为什么 devm 能减少清理代码
devm_kzalloc()、devm_platform_ioremap_resource() 和 devm_clk_get_optional() 都把资源登记到当前 struct device。后续步骤失败时,内核会释放此前已经成功申请的托管资源;设备解绑时也会执行同样的清理,因此这个示例不需要单独实现只负责 kfree()、iounmap() 的 remove。
但 devm 并不等于“所有副作用都会自动撤销”。示例中的 clk_prepare_enable() 主动改变了时钟状态,所以额外使用 devm_add_action_or_reset() 注册关闭动作。如果以后在 probe 中启动 DMA、使能硬件中断或让设备进入运行态,同样要确认解绑时由谁负责停止这些行为。
一个可维护的 Platform 驱动应把 probe 写成清晰的资源依赖链:匹配只负责找到设备,资源 API 负责取得内核已经解析出的硬件描述,devm 负责生命周期,真正与寄存器语义相关的初始化则放在资源准备完成之后。