1. 把 STK3310 接进 Linux IIO 功能库:先看清这条驱动链路
功能库这个词放在 Linux 驱动里,最贴近的落点是 IIO 子系统:STK3310 这类接近传感器不是裸写寄存器就完事,而是要把 iio_dev、通道和中断挂进这套 IIO 功能库。
这条链路解决的是“传感器能被内核统一看见、能被用户态稳定读取”的问题;probe 里每一步都围绕 I2C 通路、ID 校验、寄存器配置和中断注册展开,哪一步漏了都会在设备目录里露馅。
这篇操作指南适合刚接 Linux 驱动的人,也适合已经写过 probe、但被阈值和中断触发方式卡住的熟手;后面按代码顺序把参数和坑拆开。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. IIO 功能库的骨架:iio_dev、通道和 probe 的职责边界
IIO 功能库不是“多写一个注册函数”这么简单,它把传感器拆成设备、通道、私有数据三层。probe 的职责是先把这些对象挂好,再校验硬件,最后注册;如果顺序反过来,一个半成品设备可能先暴露给用户态,后面的错误反而更难定位。这里最容易出现的误解,是把 iio_dev 当成一个普通结构体随便填,实际上 name、info、channels、num_channels 这几个字段决定设备注册后用户态能看见什么、能读什么。
我一般把 probe 分成四段看:分配 iio_dev 和私有数据、读芯片 ID、写工作模式和阈值、注册中断和 IIO 设备。每一段都要有明确的失败出口,不能“先往下跑,出错再说”。下面按这个骨架拆。
2.1 为什么先填 iio_dev 再谈寄存器
iio_dev 是内核侧对传感器的代表对象,indio_dev->name 是设备名,indio_dev->info 指向通道和事件描述,indio_dev->channels 是通道数组,indio_dev->num_channels 是通道数量。代码里先 devm_iio_device_alloc 拿到对象,再把 data->client = client 存进私有区,接着填这些字段,最后才 devm_iio_device_register。
这个顺序的理由很实际:注册是最后一脚,注册之前设备还不可见。先把描述字段填好,再写 PS_CONF、PS_THDH、PS_THDL,最后挂中断并注册,失败时不会留下一个“目录有了但读不到数据”的半成品。反过来说,如果先注册再校验 ID,用户态可能已经看到设备,probe 后面返回 -ENODEV 时还要处理已暴露节点的清理,排查成本会变高。
步骤上我会按下面顺序走,不跳步:
- 调用
devm_iio_device_alloc,失败直接返回-ENOMEM。 - 用
iio_priv拿到私有数据区,保存client。 - 读
STK3310_REG_ID,先确认 I2C 通路和芯片在线。 - 填
name、info、channels、num_channels。 - 写
PS_CONF,再写PS_THDH、PS_THDL。 - 有中断号就注册线程化中断。
- 最后
devm_iio_device_register。
2.2 devm_iio_device_alloc、iio_priv 与 devm 释放
先把对象分配出来,这段代码来自 probe 的前半段:
c复制indio_dev = devm_iio_device_alloc(&client->dev, sizeof(*data));
if (!indio_dev)
return -ENOMEM;
data = iio_priv(indio_dev);
data->client = client;
indio_dev->name = "stk3310";
indio_dev->info = &stk3310_info;
indio_dev->channels = stk3310_channels;
indio_dev->num_channels = ARRAY_SIZE(stk3310_channels);
devm_iio_device_alloc 的第一个参数是父设备 &client->dev,第二个参数是私有数据区大小 sizeof(*data)。它返回 struct iio_dev *,失败返回 NULL,所以 if (!indio_dev) return -ENOMEM; 不能省。iio_priv(indio_dev) 根据 iio_dev 的分配布局拿到紧跟在后面的私有区指针,随后把 client 存进去,后面读写 I2C 都靠它。
这里用 devm_ 版本的好处是生命周期跟着设备走:probe 失败或设备移除时,已经分配的资源由设备管理机制回收,不需要在错误分支里手动 kfree。devm_request_threaded_irq 也是同一套思路,注册成功的中断会跟着设备释放。注意,devm 不是“永不释放”,它只是把释放时机交给设备模型,错误分支仍然要 return ret,不能继续使用已经失败的对象。
2.3 最小注册路径的代码拆解
注册路径本身很短,但每个字段都有含义:
c复制indio_dev->name = "stk3310";
indio_dev->info = &stk3310_info;
indio_dev->channels = stk3310_channels;
indio_dev->num_channels = ARRAY_SIZE(stk3310_channels);
return devm_iio_device_register(&client->dev, indio_dev);
name 是设备名,info 指向通道和事件描述,channels 是通道数组,num_channels 用 ARRAY_SIZE 算数组元素个数。四个字段缺一个,注册后用户态看到的能力就不完整;尤其是 num_channels 写错,可能出现通道数量对不上、读不到对应 raw 值的情况。
devm_iio_device_register 是最后一脚,返回值必须原样返回。它成功之后,IIO 功能库才会把设备挂到自己的设备体系里;失败时不要继续往下走,也不要手动去补目录。把注册放在 probe 末尾,是为了让前面的 ID 校验、寄存器写入、中断注册都先过一遍,失败时设备不会提前露头。
3. probe 初始化实战:ID 校验、PS_CONF 与线程化中断
这一段按 probe 的实际执行顺序走。完整代码如下,后面逐段解释:
c复制static int stk3310_probe(struct i2c_client *client)
{
struct iio_dev *indio_dev;
struct stk3310_data *data;
int ret, irq;
indio_dev = devm_iio_device_alloc(&client->dev, sizeof(*data));
if (!indio_dev)
return -ENOMEM;
data = iio_priv(indio_dev);
data->client = client;
ret = i2c_smbus_read_byte_data(client, STK3310_REG_ID);
if (ret < 0)
return ret;
if ((ret & 0xF0) != STK3310_CHIP_ID_MASK)
return -ENODEV;
indio_dev->name = "stk3310";
indio_dev->info = &stk3310_info;
indio_dev->channels = stk3310_channels;
indio_dev->num_channels = ARRAY_SIZE(stk3310_channels);
/* 默认工作模式:使能 PS,持续位先设为 1 */
ret = i2c_smbus_write_byte_data(client, STK3310_REG_PS_CONF, 0x01);
if (ret < 0)
return ret;
/* 初始阈值:高阈值 0x7F,低阈值 0x2A,实际按产品结构标定 */
i2c_smbus_write_byte_data(client, STK3310_REG_PS_THDH, 0x7F);
i2c_smbus_write_byte_data(client, STK3310_REG_PS_THDL, 0x2A);
irq = client->irq;
if (irq) {
ret = devm_request_threaded_irq(&client->dev, irq, NULL,
stk3310_irq_handler,
IRQF_TRIGGER_LOW | IRQF_ONESHOT,
"stk3310", data);
if (ret)
return ret;
}
return devm_iio_device_register(&client->dev, indio_dev);
}
代码逻辑是:分配对象并保存 client,读 ID 并校验,填 IIO 描述字段,写 PS_CONF 进入默认工作模式,写初始阈值,有中断号就注册线程化中断,最后注册 IIO 设备。参数上,0x01 是 PS_CONF 的默认值,作用是使能 PS 并把持续位先设为 1;0x7F 和 0x2A 只是让驱动先跑起来的初始阈值,不是产品最终标定值。
3.1 读 PRODUCT_ID:先确认 I2C 通路再写配置
所有传感器驱动的第一步都是验证 I2C 通路。我一般先读 PRODUCT_ID,这样既能确认芯片在线,也能顺带排除地址写错这种低级问题。代码里先执行:
c复制ret = i2c_smbus_read_byte_data(client, STK3310_REG_ID);
if (ret < 0)
return ret;
if ((ret & 0xF0) != STK3310_CHIP_ID_MASK)
return -ENODEV;
i2c_smbus_read_byte_data 返回负值说明 I2C 读失败,直接返回该错误码;返回非负值才是寄存器内容。接着用 (ret & 0xF0) != STK3310_CHIP_ID_MASK 判断芯片 ID 的高四位是否匹配,不匹配返回 -ENODEV。这里把“读失败”和“ID 不匹配”分成两个分支,排查时才能知道是总线问题还是芯片型号/地址问题。
操作上不要急着写 PS_CONF。先读 ID 有三个好处:确认芯片在线、确认 I2C 地址没有写错、确认代码里的 STK3310_CHIP_ID_MASK 与手头芯片一致。等到 ID 读通,再往下写工作模式和阈值,失败范围会小很多。
3.2 写 PS_CONF 与阈值:顺序、返回值和参数表
ID 校验通过后,先写 PS_CONF,再写两个阈值寄存器。代码里的顺序是:
c复制ret = i2c_smbus_write_byte_data(client, STK3310_REG_PS_CONF, 0x01);
if (ret < 0)
return ret;
i2c_smbus_write_byte_data(client, STK3310_REG_PS_THDH, 0x7F);
i2c_smbus_write_byte_data(client, STK3310_REG_PS_THDL, 0x2A);
PS_CONF 写 0x01 表示默认工作模式:使能 PS,持续位先设为 1。先开工作模式再给阈值,是为了让后面的判定边界有明确的采样上下文。PS_THDH 写 0x7F、PS_THDL 写 0x2A,这两个值只负责让驱动先跑起来,真正标定要等结构件定了再做。参数表如下:
| 寄存器/参数 | 代码中的值 | 作用 | 设置时看什么 |
|---|---|---|---|
STK3310_REG_ID |
读,掩码 0xF0 |
确认芯片在线和地址正确 | 读失败先查 I2C;ID 不匹配返回 -ENODEV |
STK3310_REG_PS_CONF |
0x01 |
使能 PS,持续位先设为 1 | 写失败直接返回错误 |
STK3310_REG_PS_THDH |
0x7F |
高阈值,管“接近” | 初始值,结构件定了再标定 |
STK3310_REG_PS_THDL |
0x2A |
低阈值,管“离开” | 初始值,结构件定了再标定 |
client->irq |
由 I2C 设备提供 | 中断号 | 为 0 时跳过中断注册 |
IRQF_TRIGGER_LOW |
触发方式 | 对应 INT 默认极性 | 与硬件极性核对 |
IRQF_ONESHOT |
中断标志 | 线程化中断执行期间屏蔽中断 | 避免事件风暴 |
这张表里最容易被忽略的是最后两行。阈值不是“设完就完”,中断触发方式也不是随便选的;它们一个决定事件判定边界,一个决定事件会不会在边界上反复触发。
3.3 线程化中断注册:client->irq、触发极性和 ONESHOT
中断注册在阈值写入之后、IIO 注册之前:
c复制irq = client->irq;
if (irq) {
ret = devm_request_threaded_irq(&client->dev, irq, NULL,
stk3310_irq_handler,
IRQF_TRIGGER_LOW | IRQF_ONESHOT,
"stk3310", data);
if (ret)
return ret;
}
irq 来自 client->irq,为 0 时跳过注册,设备仍然可以注册,但不会有中断事件。devm_request_threaded_irq 的第二个参数是中断号,第三个参数传 NULL 表示没有硬中断顶半部,第四个参数 stk3310_irq_handler 是线程化处理函数,第五个参数是标志位,第六个是中断名,第七个把 data 作为处理函数入参传进去。
标志位选了 IRQF_TRIGGER_LOW | IRQF_ONESHOT。IRQF_TRIGGER_LOW 跟芯片 INT 引脚默认极性对应;IRQF_ONESHOT 保证线程化中断执行期间中断被屏蔽,避免事件风暴。这里的边界是:IRQF_ONESHOT 不是“自动清中断”,它只是把中断屏蔽到线程化处理完成;如果触发极性和硬件对不上,低电平一直满足,照样会反复进中断。所以注册成功后还要核对 INT 极性和阈值表现,不能只看 probe 返回值。
4. 阈值和中断参数:PS_THDH/PS_THDL 怎么设,事件怎么上报
阈值和中断是这条驱动里最容易被“玄学”化的部分:有人把 0x7F、0x2A 当成固定配方,有人一看到中断重复就怀疑芯片坏了。实际更常见的情况是参数语义没分清:高阈值和低阈值不是“灵敏度”和“不灵敏度”,而是两个判定边界;中断触发方式也不是“随便选一个电平”,它要和 INT 引脚默认极性对齐。下面把参数和事件链路拆开。
4.1 高阈值管“接近”,低阈值管“离开”
PS_THDH 是高阈值,管“接近”;PS_THDL 是低阈值,管“离开”。代码里初始值是 0x7F 和 0x2A,这两个值一高一低,形成一条判定带。接近事件看高阈值,离开事件看低阈值,两个边界分开设置,目的是
