4、传感器驱动开发：I2C驱动框架、寄存器读写、数据手册解读

说到传感器驱动，I2C总线绝对是嵌入式工程师绕不开的坎儿。我刚开始做智能照明项目那会儿，第一次拿到光照传感器的数据手册，说实话，头都是大的。满篇的寄存器地址、位域定义、时序图，看着就晕。但后来我发现，只要掌握了I2C驱动框架的套路，再复杂的传感器也就那么回事儿。

4.1 I2C驱动框架：别自己造轮子

很多新手喜欢从头开始写I2C时序，用GPIO模拟SDA和SCL。我个人习惯是：能用硬件I2C就别用软件模拟。为什么？因为硬件I2C有中断、有DMA支持，CPU占用率低得多。你想想看，一个智能灯泡里可能同时跑着蓝牙协议栈、PWM调光、温度采集，CPU资源本来就紧张，再用软件模拟I2C去轮询，那不是给自己找麻烦吗？

在Linux环境下，I2C驱动框架已经封装得很好了。我们只需要关注三个核心结构体：

struct i2c_adapter  // I2C控制器适配器
struct i2c_algorithm // 通信算法（主要是master_xfer）
struct i2c_client   // 从设备（传感器）

实际开发中，我们通常不需要动adapter和algorithm层——那是芯片原厂的事。我们要做的是注册一个i2c_client，然后通过它来读写寄存器。

4.2 寄存器读写：从数据手册到代码

拿到一个传感器，第一步不是写代码，而是读数据手册。我记得有一次项目赶进度，我跳过数据手册直接抄了网上的一段驱动代码，结果传感器死活读不出数据。折腾了两天，最后发现是寄存器地址搞错了——数据手册里写的是0x10，网上代码写的是0x01。一字之差，两天白干。

数据手册里最关键的几个信息：

• 设备地址（7位或10位）：比如BH1750光照传感器的地址是0x23（ADDR引脚接低电平）或0x5C（接高电平）
• 寄存器映射表：每个寄存器的作用、地址、读写属性
• 位域定义：每个bit代表什么含义
• 时序要求：时钟频率、起始条件、停止条件等

以BH1750为例，它的寄存器读写流程是这样的：

// 写命令：发送测量指令
uint8_t cmd = 0x10;  // 连续高分辨率模式
i2c_master_send(client, &cmd, 1);

// 等待测量完成（典型值120ms）
msleep(120);

// 读数据：读取2字节光照值
uint8_t buf[2];
i2c_master_recv(client, buf, 2);
uint16_t lux = (buf[0] << 8) | buf[1];
lux = lux / 1.2;  // 根据数据手册换算

这里有个坑：很多传感器在写命令后需要等待一段时间才能读数据。我曾经遇到过读回来的数据全是0xFF，排查了半天才发现是等待时间不够。嗯，这里要注意，数据手册里给的典型值通常是在理想条件下，实际项目中建议留出20%的余量。

4.3 数据手册解读：从寄存器到位域

数据手册的寄存器章节，说白了就是一张表格。但很多人不会看。我教你一个方法：先看整体，再看局部。

整体看什么？看寄存器地址范围。比如一个传感器有10个寄存器，地址从0x00到0x09。那你就知道，读写操作都在这个范围内。

局部看什么？看每个寄存器的位域定义。比如一个8位的控制寄存器，bit7是使能位，bit6-4是模式选择，bit3-0是保留位。那你在写代码时就要注意：修改某个位时不能影响其他位。

举个例子，假设我们要配置一个温度传感器的采样率：

// 寄存器0x01：控制寄存器
// bit7: 使能（1=使能，0=禁用）
// bit6-4: 采样率（000=1Hz, 001=2Hz, 010=4Hz, 011=8Hz）
// bit3-0: 保留（必须写0）

// 错误写法：直接写0x90（使能+4Hz）
// 这样会覆盖保留位，可能导致不可预知的行为

// 正确写法：先读后写（读-改-写）
uint8_t reg_val;
i2c_master_read_reg(client, 0x01, &reg_val, 1);
reg_val &= 0x0F;      // 清除高4位
reg_val |= 0x90;      // 设置使能位和4Hz模式
i2c_master_write_reg(client, 0x01, &reg_val, 1);

4.4 实战：封装一个通用的I2C传感器驱动

在实际项目中，我习惯把I2C读写操作封装成底层函数，上层应用只管调用。这样代码复用性高，也方便调试。

// sensor_i2c.h
typedef struct {
    uint8_t dev_addr;   // 设备地址
    uint8_t reg_addr;   // 寄存器地址
    uint8_t *data;      // 数据缓冲区
    uint16_t len;       // 数据长度
} i2c_transfer_t;

// 底层读写接口
int sensor_i2c_read(i2c_transfer_t *trans);
int sensor_i2c_write(i2c_transfer_t *trans);

// 传感器专用接口
int bh1750_init(void);
int bh1750_read_lux(float *lux);
int sht30_init(void);
int sht30_read_temp_hum(float *temp, float *hum);

这样做的好处是：如果以后换了MCU或者换了I2C控制器，只需要修改底层的sensor_i2c_read和sensor_i2c_write两个函数，上层代码完全不用动。说白了，这就是分层设计的思想。

4.5 避坑指南

最后，我总结几个I2C传感器开发中常见的坑：

• 地址左移问题：Linux内核中i2c_client的地址是7位，但很多数据手册给的是8位地址（含读写位）。记得左移1位或者直接使用7位地址。
• 时钟延展：有些慢速传感器会拉低SCL时钟线，要求主机等待。如果你的I2C控制器不支持时钟延展，就得用软件模拟。
• 重复起始条件：有些传感器要求组合传输（写寄存器地址+读数据之间不能有停止条件）。这需要I2C控制器支持重复起始（Repeated Start）。
• 上拉电阻：I2C总线必须接上拉电阻，典型值4.7kΩ。如果总线电容较大，可能需要减小到2.2kΩ。我遇到过因为上拉电阻太大导致通信不稳定的情况。

嗯，关于I2C传感器驱动开发，今天就聊到这儿。下一章我们会讲PWM调光与LED驱动，到时候再结合光照传感器做个完整的智能照明闭环。你先把今天的内容消化一下，特别是数据手册的解读方法，这个基本功打扎实了，后面学什么都快。