用i2c-dev发SMBus命令需先open(/dev/i2c-1)、ioctl(I2C_SLAVE, addr),再调用i2c_smbus_read_byte_data()等函数;禁用read/write混用,注意地址、寄存器范围及clock stretching超时问题。

怎么用 i2c-dev 节点发 SMBus 命令(比如读取温度)
Linux 内核的 i2c-dev 驱动把 I²C 总线暴露为字符设备(如 /dev/i2c-1),但注意:它本身不解析 SMBus 协议,只是透传原始字节。真正做 SMBus 读写得靠用户态库或自己构造符合 SMBus 规范的 ioctl 调用。
最直接的方式是用 i2c_smbus_access() —— 它封装了底层 ioctl(I2C_SMBUS),藏在 和 里。别自己拼 ioctl,容易错地址/长度/方向。
实操要点:
- 先用
open("/dev/i2c-1", O_RDWR)打开设备节点,再用ioctl(fd, I2C_SLAVE, addr)设置从机地址(7位地址,不用左移) -
i2c_smbus_read_byte_data(fd, reg)对应 SMBus Read Byte Data:发 START + ADDR(W) + REG + RESTART + ADDR(R) + READ(1 byte),适用于多数温湿度传感器的寄存器读取 - 如果传感器只支持块读(比如某些 BME280 配置后需读 8 字节原始数据),必须用
i2c_smbus_read_i2c_block_data(),不能用read()直接读设备文件 —— 那样会跳过 SMBus 协议层,大概率返回 -1 或乱码 - 确保内核已加载
i2c-dev模块:lsmod | grep i2c_dev;没加载就modprobe i2c-dev
为什么 i2c_smbus_write_word_data() 总返回 -1(Invalid argument)
这个错误基本锁定在参数非法:SMBus Word Data 要求寄存器地址(reg)必须是单字节(0x00–0xFF),而你传了 0x100 以上的值;或者 value 超出 16 位范围(0–65535),但更常见的是地址没对齐或传感器根本不支持该命令类型。
排查步骤:
- 查传感器 datasheet,确认目标寄存器是否支持 Word Data 写入 —— 很多传感器的配置寄存器只接受 Byte Data 或 Block Data
- 用
i2cdetect -y 1确认从机地址在线且没被占用;用i2cdump -y 1 0x40(替换成你的地址)看寄存器布局是否和文档一致 - 检查
ioctl(fd, I2C_SLAVE, 0x40)是否成功,失败会导致后续所有 SMBus 调用返回 -1 - 别把 7 位地址当 8 位用:0x40 是 7 位地址,内核自动左移补 R/W 位;传 0x80 就错了
嵌入式环境里怎么避免 read()/write() 和 SMBus ioctl 混用
绝对不要在一个 fd 上交替用 read() 和 i2c_smbus_xxx()。前者走的是 I²C 核心的“纯传输”路径(类似裸 I²C),后者走的是 SMBus 协议封装路径,两者在内核中由不同 handler 处理,共享 fd 会导致状态冲突、ACK 错误甚至总线锁死。
Linux 安全审计工具,检查 SSH 配置、开放/监听端口、防火墙规则(ufw/iptables/nftables)、失败登录尝试、sudoers 权限...
正确姿势:
- 全用 SMBus 系列函数:统一走
i2c_smbus_read_byte_data()、i2c_smbus_write_byte_data()等,这是最稳的 - 真要裸传(比如某些私有协议传感器),就关闭
i2c-dev,改用内核驱动(如bmp280)或直接操作 GPIO 模拟 I²C(不推荐) - 交叉编译时确保
sysroot包含linux/i2c.h和linux/i2c-dev.h,否则i2c_smbus_access()声明缺失,链接时报 undefined reference - 嵌入式板子常禁用
I2C_CHARDEV内核选项,编译内核时得显式打开:CONFIG_I2C_CHARDEV=y
传感器返回值异常?先盯住 clock stretching 和 timeout
很多低功耗传感器(如 SI7021、HTU21D)在转换期间会拉长 SCL,即 clock stretching。标准 i2c-dev 的默认超时是 1 秒,但某些 SoC 的 I²C 控制器驱动(尤其 Allwinner、Rockchip)对 stretching 响应差,导致 i2c_smbus_read_byte_data() 卡住或返回 -ETIMEDOUT。
应对方法:
- 查板级设备树,确认 I²C 总线节点有没有
i2c-scl-falling-time-ns/i2c-scl-rising-time-ns,这些影响 stretching 检测精度 - 临时加延时:读取前用
usleep(10000)(10ms),等传感器完成转换 —— 不优雅但有效,适合调试阶段 - 换用
i2c_smbus_read_i2c_block_data()代替多次read_byte_data(),减少 START/STOP 开销,也降低 stretching 触发概率 - 用逻辑分析仪抓波形,确认 SCL 是否真被拉长,还是传感器根本没响应(NACK)
真正麻烦的是 sensor 返回 NACK 后,有些 I²C 控制器不会自动恢复,得靠 i2cdetect 强制扫描一次总线才能清状态 —— 这种硬件级坑,代码里很难绕过去。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!










