📚 课程目录第3章 Sensor寄存器基础

3. Sensor寄存器基础：寄存器地址、读写操作、位域定义、寄存器映射表

在瑞芯微RK平台驱动开发中，Sensor寄存器是硬件与软件之间的核心通信接口。理解寄存器的基础概念——地址、读写操作、位域定义以及映射表结构，是正确配置Sensor并完成初始化流程调试的前提。本章将系统梳理这些基础知识，并结合RK平台的实际场景进行讲解。

3.1 寄存器地址与寻址机制

每个Sensor寄存器都有一个唯一的物理地址，用于标识其在设备内部存储空间中的位置。在I2C/SPI通信中，主机通过发送地址来指定要访问的寄存器。

地址宽度：常见为8位（如OV5640）或16位（如IMX290），RK平台Sensor驱动通常支持8位和16位地址自动适配。
地址空间：寄存器地址范围从0x00到0xFF（8位）或0x0000到0xFFFF（16位），部分Sensor使用多页（Page）机制扩展地址空间。
页切换：当寄存器数量超过单页地址范围时，通过写特定页选择寄存器（Page Select Register）切换当前页，后续地址访问均属于该页。

RK平台经验：在RK3588/RK3568等芯片上，I2C控制器支持标准模式（100kHz）和快速模式（400kHz）。Sensor初始化阶段建议使用标准模式，避免因时序问题导致寄存器写入失败。

寄存器地址示例（OV5640 8位地址）：

/* OV5640 部分寄存器地址定义 */
#define OV5640_REG_CHIP_ID_H     0x300A  /* 芯片ID高字节 */
#define OV5640_REG_CHIP_ID_L     0x300B  /* 芯片ID低字节 */
#define OV5640_REG_MODE_SELECT   0x3008  /* 工作模式选择 */
#define OV5640_REG_SOFT_RESET    0x3103  /* 软复位寄存器 */

3.2 寄存器读写操作

Sensor寄存器的读写操作遵循标准的I2C/SPI协议。在RK平台驱动中，通常使用regmap或自定义的i2c_transfer接口完成。以下是读写操作的核心流程：

3.2.1 写操作流程

发送设备地址：主机发送Sensor的I2C从设备地址（7位或10位），附带写标志位（0）。
发送寄存器地址：主机发送目标寄存器的内部地址（8位或16位，高位在前）。
发送数据：主机发送要写入的数据（1字节或多字节，连续地址自动递增）。
停止条件：主机产生I2C停止信号，结束本次传输。

3.2.2 读操作流程

伪写阶段：主机发送设备地址（写标志），再发送寄存器地址，指定要读取的寄存器。
重复起始条件：主机产生重复起始信号（Sr），不释放总线。
读阶段：主机发送设备地址（读标志，1），从Sensor读取数据。
停止条件：主机发送NACK（非应答）后产生停止信号。

常见问题：部分Sensor在连续读取时，地址不会自动递增，需要驱动中手动切换地址。RK平台驱动中，建议在初始化前通过i2c_check_functionality检查控制器是否支持I2C_FUNC_I2C功能。

RK平台常用寄存器读写接口对比
接口函数	适用场景	特点
`i2c_smbus_write_byte_data`	单字节写，8位地址	简单可靠，适用于低速初始化
`i2c_smbus_read_byte_data`	单字节读，8位地址	标准SMBus协议，兼容性好
`regmap_write`	多字节写，任意地址宽度	支持缓存、批量操作，推荐使用
`regmap_bulk_read`	连续多字节读	高效读取序列寄存器，如增益/曝光值

RK平台驱动代码示例（使用regmap读写）：

/* 定义regmap配置 */
static const struct regmap_config sensor_regmap_cfg = {
    .reg_bits = 16,          /* 寄存器地址16位 */
    .val_bits = 8,           /* 寄存器值8位 */
    .max_register = 0xFFFF,  /* 最大地址 */
    .cache_type = REGCACHE_RBTREE, /* 使用红黑树缓存 */
};

/* 初始化regmap */
sensor->regmap = devm_regmap_init_i2c(client, &sensor_regmap_cfg);
if (IS_ERR(sensor->regmap)) {
    dev_err(&client->dev, "regmap init failed\n");
    return PTR_ERR(sensor->regmap);
}

/* 写寄存器示例 */
ret = regmap_write(sensor->regmap, 0x3008, 0x02);
if (ret) {
    dev_err(&client->dev, "write 0x3008 failed: %d\n", ret);
    return ret;
}

/* 读寄存器示例 */
unsigned int val;
ret = regmap_read(sensor->regmap, 0x300A, &val);
if (ret) {
    dev_err(&client->dev, "read chip ID failed: %d\n", ret);
    return ret;
}
dev_info(&client->dev, "Chip ID high byte: 0x%02x\n", val);

3.3 位域定义与操作

Sensor寄存器中的每一位或几位组合通常代表特定的功能控制项，称为位域（Bit Field）。正确理解位域定义是避免配置错误的关键。

3.3.1 位域结构

位偏移（Bit Offset）：位域在寄存器中的起始位位置（从0开始，LSB）。
位宽度（Bit Width）：位域占用的位数，通常为1~8位。
掩码（Mask）：用于提取或修改位域的二进制掩码，计算公式：mask = ((1 << width) - 1) << offset。
值域（Value Range）：位域可表示的数值范围，如2位位域可表示0~3。

3.3.2 位域操作宏

在RK平台驱动中，常用宏定义来简化位域操作：

/* 位域操作宏定义 */
#define BIT(n)              (1UL << (n))
#define BIT_MASK(n)         (BIT(n) - 1)
#define BIT_MASK_AT(w, o)   ((BIT(w) - 1) << (o))
#define BIT_GET(v, o, w)    (((v) >> (o)) & BIT_MASK(w))
#define BIT_SET(v, o, w, x) ((v) = ((v) & ~BIT_MASK_AT(w, o)) | ((x) << (o)))

/* 示例：设置增益寄存器位域 */
#define GAIN_REG            0x3500
#define GAIN_BIT_OFFSET     0
#define GAIN_BIT_WIDTH      8
#define GAIN_MASK           BIT_MASK_AT(GAIN_BIT_WIDTH, GAIN_BIT_OFFSET)

/* 读取当前增益值 */
unsigned int gain_val = BIT_GET(reg_val, GAIN_BIT_OFFSET, GAIN_BIT_WIDTH);

/* 设置增益值为0x1A */
reg_val = BIT_SET(reg_val, GAIN_BIT_OFFSET, GAIN_BIT_WIDTH, 0x1A);
regmap_write(sensor->regmap, GAIN_REG, reg_val);

3.4 寄存器映射表

寄存器映射表（Register Map Table）是Sensor数据手册中最重要的文档之一，它列出了所有寄存器的地址、名称、类型、默认值、位域定义和功能描述。在RK平台驱动开发中，映射表是编写初始化序列和调试工具的基础。

3.4.1 映射表结构

一个完整的寄存器映射表通常包含以下列：

地址（Address）：寄存器在Sensor内部的物理地址，通常以十六进制表示。
名称（Name）：寄存器的功能名称，如MODE_SELECT、EXPOSURE_H。
类型（Type）：读写属性，常见有R（只读）、W（只写）、R/W（读写）、RC（读后清除）等。
默认值（Default）：芯片上电或复位后的初始值，用于验证初始化是否正确。
位域描述（Bit Description）：每位或位段的功能定义，包括名称、偏移、宽度和可选值。

3.4.2 RK平台映射表使用规范

在RK平台驱动中，寄存器映射表通常以结构体数组或宏定义的形式组织：

/* 寄存器映射表结构体定义 */
struct sensor_reg_map {
    u16 addr;       /* 寄存器地址 */
    u8  def_val;    /* 默认值 */
    u8  type;       /* 读写类型：0-R, 1-W, 2-RW */
    char name[32];  /* 寄存器名称 */
};

/* 示例：部分寄存器映射表 */
static const struct sensor_reg_map ov5640_reg_map[] = {
    {0x300A, 0x56, 0, "CHIP_ID_H"},      /* 只读，芯片ID高字节 */
    {0x300B, 0x42, 0, "CHIP_ID_L"},      /* 只读，芯片ID低字节 */
    {0x3008, 0x02, 2, "MODE_SELECT"},    /* 读写，工作模式 */
    {0x3103, 0x11, 2, "SOFT_RESET"},     /* 读写，软复位 */
    {0x3500, 0x00, 2, "GAIN"},           /* 读写，增益控制 */
    {0x3501, 0x00, 2, "EXPOSURE_H"},     /* 读写，曝光高字节 */
    {0x3502, 0x00, 2, "EXPOSURE_L"},     /* 读写，曝光低字节 */
    {0x3503, 0x00, 2, "EXPOSURE_CTRL"},  /* 读写，曝光控制 */
    /* ... 更多寄存器 */
};

3.4.3 映射表在调试中的应用

在初始化流程调试中，寄存器映射表用于：

验证初始化序列：将写入的值与映射表中的默认值对比，确认配置是否正确。
生成调试工具：基于映射表自动生成寄存器读写工具，支持批量导出/导入配置。
异常分析：当Sensor工作异常时，读取关键寄存器值与映射表对比，定位问题。

常见Sensor寄存器类型及含义
类型标识	含义	驱动处理方式
R	只读寄存器	初始化时不写入，仅用于读取状态或ID
W	只写寄存器	写入后不可回读，需记录写入值到缓存
R/W	可读可写寄存器	支持读写操作，初始化时按需配置
RC	读后清除寄存器	读取后自动清零，用于中断状态等场景
RSVD	保留寄存器	必须保持默认值，不可修改

RK平台调试技巧：在初始化序列中，建议在每次写入关键寄存器后立即回读验证。使用regmap_read回读并与预期值比较，若不一致则打印错误日志并记录地址，便于快速定位硬件或时序问题。

📚 课程目录

3. Sensor寄存器基础：寄存器地址、读写操作、位域定义、寄存器映射表

3.1 寄存器地址与寻址机制

3.2 寄存器读写操作

3.2.1 写操作流程

3.2.2 读操作流程

3.3 位域定义与操作

3.3.1 位域结构

3.3.2 位域操作宏

3.4 寄存器映射表

3.4.1 映射表结构

3.4.2 RK平台映射表使用规范

3.4.3 映射表在调试中的应用

3.5 本章小结