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/i2c-dev.h>里声明，但实际要链接-li2c，且头文件需配合<linux/i2c.h>使用；部分旧系统需自己封装ioctl(I2C_SMBUS)。
立即学习“C++免费学习笔记（深入）”；
- 必须先用
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>管理缓冲区，别用栈上固定数组
传感器返回的数据长度常不固定：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 << 8) | lo。
- 每次写寄存器后，查手册看是否需要延时（如BME280写配置后要等2ms，否则读回0xFF）
- 用
usleep(2000)比sleep(1)精确，但别在实时性要求高的场景滥用 - 传感器上电后常需初始化序列（发特定寄存器配置），跳过这步，后续读数全不可信
- 示例：读MPU6050的WHO_AM_I寄存器（
0x75）验证通信，返回0x68才说明链路正常
真正卡住的时候，往往不是代码逻辑，而是没拿万用表量SCL/SDA波形，或者忘了传感器VDD必须和主控共地。
