linux下用i2c-dev读i2c传感器需确保/dev/i2c-x存在、用户属i2c组;用ioctl(i2c_slave, addr)设地址,优先用i2c_smbus_read_byte_data()等smbus函数处理寄存器读写,并注意地址(7位)、字节序、延时及初始化。

Linux下用i2c-dev接口读取I2C传感器数据最直接
在嵌入式Linux(如树莓派、Jetson、ARM开发板)上,C++读I2C传感器不依赖第三方库,核心是打开/dev/i2c-X设备文件,用ioctl()控制总线,再用read()/write()传输字节。关键不是“能不能”,而是“设备节点是否存在”和“用户是否有权限”。
常见错误现象:open() failed: Permission denied(没加i2c组)、No such file or directory(内核没启用i2c-dev模块)、Input/output error(地址错/硬件没接通/上拉电阻缺失)。
- 先确认硬件:用
i2cdetect -y X(X为总线号)扫描,看到传感器地址(如0x68)才算物理连通 - 加用户到
i2c组:sudo usermod -a -G i2c $USER,然后重新登录 - 检查
/dev/i2c-X是否存在,不存在就加载驱动:sudo modprobe i2c-dev - 代码里必须用
ioctl(fd, I2C_SLAVE, addr)设置从机地址,否则read()会失败
i2c_smbus_read_byte_data()比裸read()更安全
很多传感器(如BME280、MPU6050)需要先写寄存器地址再读数据,裸read()只能读连续字节,没法指定寄存器。这时用SMBus函数更稳——它自动处理“写地址+读数据”的组合事务,且内核保证原子性,避免被其他进程打断。
注意:i2c_smbus_read_byte_data()在<linux></linux>里声明,但实际要链接-li2c,且头文件需配合<linux></linux>使用;部分旧系统需自己封装ioctl(I2C_SMBUS)。
- 必须先用
i2c_smbus_access()或宏定义(如I2C_SMBUS_READ)构造请求 - 寄存器地址是单字节(如
0x00),读回值是单字节;多字节用i2c_smbus_read_word_data() - 返回值
-1表示出错,需检查errno(常见ENXIO=地址无响应,EIO=NACK或时序问题) - 别假设传感器支持所有SMBus操作——有些只认
write byte+read block,得查数据手册
用std::vector<uint8_t></uint8_t>管理缓冲区,别用栈上固定数组
传感器返回的数据长度常不固定:HTU21D读湿度要2字节+1字节CRC,BMP280读温度可能要3字节原始值。硬写uint8_t buf[4]容易越界或截断,且无法动态适配不同命令。
用std::vector能明确控制生命周期,配合resize()按需分配,还能直接传给read()的void*参数(用.data())。
- 读之前先
buf.resize(n),n是预期字节数(查传感器寄存器描述) - 读完立刻检查
ret == (int)buf.size(),不等就说明通信异常(比如只收到1字节却期待3字节) - 对带CRC的传感器(如SHT3x),预留额外空间存校验字节,别忘了在解析前验证
- 别把
vector传进循环反复resize()——提前分配好最大可能长度,复用更高效
地址、字节序、延时三个点最容易被忽略
同样的传感器,在不同平台读出来全是错的?大概率栽在这三处:I2C地址常带最低位读写位(0x68是写地址,0x69是读地址),但i2c_smbus_xxx()函数内部自动处理,所以传0x68即可;而裸ioctl(I2C_SLAVE)也只要传7位地址(0x68),内核会补位——传0xD0这种8位地址必失败。
字节序陷阱更隐蔽:MPU6050的加速度X轴是寄存器0x3B(高位)和0x3C(低位),但有些芯片(如BME680)的温度值是小端,有些是大端,必须按数据手册拼接,不能默认(hi 。
- 每次写寄存器后,查手册看是否需要延时(如BME280写配置后要等2ms,否则读回0xFF)
- 用
usleep(2000)比sleep(1)精确,但别在实时性要求高的场景滥用 - 传感器上电后常需初始化序列(发特定寄存器配置),跳过这步,后续读数全不可信
- 示例:读MPU6050的WHO_AM_I寄存器(
0x75)验证通信,返回0x68才说明链路正常
真正卡住的时候,往往不是代码逻辑,而是没拿万用表量SCL/SDA波形,或者忘了传感器VDD必须和主控共地。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











