寄存器基础与寻址：地址映射、读写操作与位域掩码

做 Sensor 驱动开发，说白了就是在跟寄存器打交道。你写的每一行代码，最终都要落到某个寄存器的某几个位上。我见过不少新手，拿着 datasheet 翻半天，结果连寄存器地址都映射错了——那调试起来真是欲哭无泪。

这一节，咱们就把寄存器操作的基础打扎实。地址怎么映射、怎么读写、怎么用掩码只改某几个位，这些基本功不过关，后面写驱动就是空中楼阁。

寄存器地址映射：CPU 怎么找到 Sensor？

Sensor 挂在 I2C 或 SPI 总线上，CPU 要访问它，得先知道它的“门牌号”。这个门牌号，就是寄存器地址。

但有个关键点：物理地址 ≠ 驱动里用的地址。CPU 看到的地址空间和 Sensor 内部的寄存器地址空间是两码事。驱动里你得先通过总线协议把 Sensor 的寄存器地址“翻译”过去。

拿 I2C 举例。Sensor 通常有一个 7 位从机地址（比如 0x6C），内部寄存器有各自的偏移地址（比如 0x30 是控制寄存器）。驱动里发数据时，先发从机地址，再发寄存器偏移，最后才是读写的数据。这个过程就是地址映射。

/* I2C 寄存器地址映射示例 */
#define SENSOR_I2C_ADDR    0x6C
#define REG_CTRL           0x30
#define REG_STATUS         0x31
#define REG_DATA_L         0x32
#define REG_DATA_H         0x33

/* 读寄存器：先写地址，再读数据 */
static int sensor_read_reg(struct i2c_client *client, u8 reg_addr, u8 *val)
{
    struct i2c_msg msg[2];
    int ret;

    /* 第一段消息：写寄存器地址 */
    msg[0].addr = client->addr;
    msg[0].flags = 0;           /* 写 */
    msg[0].len = 1;
    msg[0].buf = &reg_addr;

    /* 第二段消息：读数据 */
    msg[1].addr = client->addr;
    msg[1].flags = I2C_M_RD;    /* 读 */
    msg[1].len = 1;
    msg[1].buf = val;

    ret = i2c_transfer(client->adapter, msg, 2);
    if (ret != 2)
        return -EIO;

    return 0;
}

这段代码我几乎每个 Sensor 驱动里都会写，只是寄存器地址和名字不同。你想想看，如果地址映射错了，读回来的数据全是 0xFF 或者 0x00，那排查起来多痛苦。

读写操作原理：不只是发数据

寄存器读写看起来简单——发个地址，读或写几个字节。但实际项目中，坑往往藏在细节里。

我记得有一次调试一个加速度计，读数据时总是丢字节。查了半天，发现是 I2C 控制器不支持重复起始条件（repeated start），而我用的读写方式需要它。后来换成单次写 + 单次读的方式才解决。

常见的读写方式有三种：

方式	描述	适用场景
组合事务	写地址 + 读数据，中间有 STOP 再 START	控制器不支持重复起始
重复起始	写地址后不 STOP，直接发 START 读数据	标准 I2C 读写，效率高
连续读写	一次事务读写多个寄存器（地址自动递增）	批量读取数据寄存器

连续读写这个特性特别有用。很多 Sensor 的数据寄存器是连续的，比如陀螺仪的 X、Y、Z 轴数据。一次读 6 个字节，比读 6 次快得多。

/* 连续读取多个寄存器 */
static int sensor_read_burst(struct i2c_client *client, u8 start_reg, 
                             u8 *buf, int len)
{
    struct i2c_msg msg[2];
    int ret;

    msg[0].addr = client->addr;
    msg[0].flags = 0;
    msg[0].len = 1;
    msg[0].buf = &start_reg;

    msg[1].addr = client->addr;
    msg[1].flags = I2C_M_RD;
    msg[1].len = len;
    msg[1].buf = buf;

    ret = i2c_transfer(client->adapter, msg, 2);
    if (ret != 2)
        return -EIO;

    return 0;
}

位域操作与掩码技巧：精准修改

寄存器里一个字节 8 个位，每个位或每组位可能控制不同的功能。比如控制寄存器的 bit[0] 是使能位，bit[3:1] 是工作模式选择。你不能直接写整个寄存器，否则会破坏其他位的状态。

正确的做法是：读-改-写。先读回当前值，用掩码清除要修改的位，再设置新值，最后写回去。

/* 位域操作宏定义 */
#define BIT(n)          (1UL << (n))
#define GENMASK(h, l)   (((~0UL) << (l)) & (~0UL >> (BITS_PER_LONG - 1 - (h))))

/* 读-改-写函数 */
static int sensor_update_bits(struct i2c_client *client, u8 reg, 
                              u8 mask, u8 val)
{
    u8 old_val, new_val;
    int ret;

    ret = sensor_read_reg(client, reg, &old_val);
    if (ret < 0)
        return ret;

    new_val = (old_val & ~mask) | (val & mask);

    return sensor_write_reg(client, reg, new_val);
}

/* 使用示例：设置工作模式为 0x03，保持其他位不变 */
#define REG_CTRL_MODE_MASK   GENMASK(3, 1)   /* bit[3:1] */
#define REG_CTRL_MODE_VAL    0x03 << 1       /* 模式值左移到正确位置 */

sensor_update_bits(client, REG_CTRL, REG_CTRL_MODE_MASK, REG_CTRL_MODE_VAL);

这个 sensor_update_bits 函数，我几乎每个驱动里都会封装一个。它接受寄存器地址、掩码和值，自动完成读-改-写。你想想看，如果没有这个函数，每次改一个位都要写三行代码，还容易漏掉取反操作。

我曾经接手过一个项目，前任工程师直接写死寄存器值，每次配置都写一个完整的字节。结果后来要加一个新功能，需要改其中一个位，他得把所有用到这个寄存器的地方都翻一遍。那叫一个酸爽。

寄存器操作的知识体系

下面这张图把寄存器操作的核心流程串起来了。从地址映射到读写操作，到位域修改，每一步都有对应的代码实现和注意事项。

这张图把寄存器操作的四个步骤串起来了。从地址映射开始，到读写操作，到位域修改，最后验证。每一步都有对应的代码实现和注意事项。

实战中的几个坑

最后分享几个我踩过的坑，希望能帮你省点时间：

• 寄存器地址是 16 位的：有些 Sensor 的寄存器地址是 16 位（比如很多 SPI 接口的芯片），I2C 驱动里如果按 8 位地址发，后面的数据全对不上。记得看 datasheet 里寄存器地址的宽度。
• 写寄存器需要延时：有些 Sensor 写完配置寄存器后，需要几毫秒才能生效。连续写多个寄存器时，中间不加延时，后面的写操作可能被忽略。
• 保留位必须按 datasheet 写：寄存器里标记为“Reserved”的位，datasheet 会告诉你写 0 还是写 1。别自作聪明写别的值，我见过有人写错了保留位，导致芯片进入测试模式。
• 多字节数据的字节序：Sensor 的数据寄存器可能是大端（Big-endian）或小端（Little-endian）。读回来两个字节，是先高后低还是先低后高？datasheet 里一定有说明，别想当然。