Linux 驱动 Probe 函数详解
在 Linux 设备驱动模型中，probe 函数是驱动程序最核心的入口点之一，它扮演着“设备初始化”的角色，当内核发现某个硬件设备与某个驱动程序匹配时，就会调用该驱动的 probe 函数。
Probe 函数的本质
probe 函数的主要目的是验证硬件是否存在并配置硬件资源，它在驱动程序加载后，由内核的设备总线（Bus）在匹配成功时自动触发。
- 触发时机：当总线（如 PCI, USB, I2C, Platform Bus）发现一个设备 ID 与驱动程序注册的 ID 列表匹配时。
- 核心任务：将通用的内核资源转化为具体的硬件操作接口。
Probe 的工作流程
一个典型的 probe 函数执行流程通常包含以下步骤：
- 资源获取：
- 获取内存映射地址（I/O Memory）。
- 获取中断号（IRQ）。
- 获取时钟（Clock）和 GPIO 资源。
- 硬件初始化：
- 配置寄存器初始值。
- 唤醒硬件设备。
- 测试硬件响应（确认设备确实在总线上）。
- 软件结构体初始化：
- 分配私有数据结构（通常使用
devm_kzalloc）。 - 初始化锁（Mutex/Spinlock）和队列。
- 分配私有数据结构（通常使用
- 接口注册：
- 向内核注册字符设备、网络设备或输入设备。
- 在
/sys/class或/dev下创建设备节点。
匹配机制（Matching）
内核如何决定调用哪个驱动的 probe？这取决于总线的匹配规则：
- Platform 设备：通过
name字符串匹配，或者通过 Device Tree (设备树) 中的compatible属性匹配。 -
PCI 设备
：通过 Vendor ID 和 Device ID 匹配。 - USB 设备：通过 Vendor ID 和 Product ID 匹配。
- I2C 设备：通过设备树的
compatible属性或 I2C ID 表匹配。
关键技术点：devm 资源管理
在现代 Linux 驱动中，为了避免在 probe 失败时手动释放大量资源（导致内存泄漏），广泛使用了 Managed Device Resource (devm) 机制。
- 特点：使用
devm_前缀的函数（如devm_kzalloc,devm_ioremap,devm_request_irq）。 - 优势：这些资源在驱动被卸载（
remove）或probe执行失败返回时，由内核自动释放，极大地简化了错误处理路径。
Probe 函数的返回值
probe 函数的返回值直接决定了设备是否被成功绑定：
- 返回 0
：表示
probe成功，设备与驱动绑定完成，设备进入工作状态。 - 返回负数（如 -ENODEV, -ENOMEM）：表示
probe失败，内核将认为该驱动不适用于此设备，并释放已分配的资源。
Probe 与 Remove 的关系
probe 和 remove 是一对对称的操作：
- probe：资源申请 $rightarrow$ 硬件初始化 $rightarrow$ 接口注册。
- remove：接口注销 $rightarrow$ 硬件停止 $rightarrow$ 资源释放。
Probe 函数是驱动程序的“敲门砖”，一个健壮的 probe 函数应该具备：
- 严格的错误检查：每一步资源申请后必须检查返回值。
- 最小化初始化：仅初始化必要资源，避免阻塞启动过程。
- 高效的资源管理：优先使用
devm系列函数。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/linux%e9%a9%b1%e5%8a%a8probe%e6%98%af%e4%bb%80%e4%b9%88%ef%bc%8c%e5%a6%82%e4%bd%95%e7%bc%96%e5%86%99probe%e5%87%bd%e6%95%b0%ef%bc%9f/
