Linux内核regmap介绍

Regmap介绍

  内核3.1引入一套新的API regmap，目的是提取出关于I2C SPI irq等相关注册、使能以及读写的公共部分，以提高代码的可重用性，并且使得在使用如上内核基础组件时变得更为简单易用。

基础结构

  struct regmap_config 结构体代表一个设备的寄存器配置信息，在做 Regmap 初始化时，驱动就需要把这个结构体传给 Regmap。这个结构体的定义在 include/linux/regmap.h，其中包含该设备的寄存器数量，寄存器位宽，缓存类型，读写属性等:

struct regmap_config {
    int reg_bits; // 寄存器地址的位数，必须配置，例如I2C寄存器地址位数为 8
    int pad_bits; // 寄存器值的位数，必须配置
    int val_bits;
    bool (*writeable_reg)(struct device *dev, unsigned int reg); // 可写寄存器回调，maintain一个可写寄存器表
    bool (*readable_reg)(struct device *dev, unsigned int reg); // 可读寄存器回调, maintain一个可读寄存器表
    bool (*volatile_reg)(struct device *dev, unsigned int reg); // 可要求读写立即生效的寄存器回调，不可以被cache,maintain一个可立即生效寄存器表
    bool (*precious_reg)(struct device *dev, unsigned int reg); // 要求寄存器数值维持在一个数值范围才正确，maintain一个数值准确表
    unsigned int max_register; // max_register: 最大寄存器地址
    const struct reg_default *reg_defaults;
    unsigned int num_reg_defaults;
    enum regcache_type cache_type;
    const void *reg_defaults_raw;
    unsigned int num_reg_defaults_raw;
    u8 read_flag_mask;
    u8 write_flag_mask;
};

  这一层是直接和驱动对接的。Regmap 根据传进来的 regmap_config 初始化对应的缓存和总线操作接口，驱动就可以正常调用 regmap_write 和 regmap_read 函数。

初始化regmap

   regmap_init_i2c(struct i2c_client *i2c, struct regmap_config *config);
   regmap_init_spi(struct spi_device *spi, strcut regmap_config *config);
   regmap_add_irq_chip(struct regmap *map, int irq, int irq_flags, int irq_base, struct regmap_irq_chip *chip, struct regmap_irq_chip_data **data);

  前两个是用来关联i2c或者spi设备和regmap_config的，第三个用来在关联后的regmap上注册 irq

使用regmap

  在初始化好regmap之后，就可以调用regmap提供的read/write/update等操作了:

 regmap_write(struct regmap *map, int reg, int val); // 向reg写入val
 regmap_raw_write(struct regmap *map, int reg, void *val, size_t val_len);  // 向reg写入指定长度的数据，数据存放在val中
 regmap_read(struct regmap *map, int reg, int *val); // 读取reg的数据到val中
 regmap_raw_read(struct regmap *map, int reg, void *val, size_t val_len); // 读取reg中指定长度的数据
 regmap_bulk_read(struct regmap *map, int reg, void *val, size_t val_count); // 读取从reg开始之后val_count个寄存器的数据到val中
 regmap_update_bits(struct regmap *map, int reg, int mask, int val); // 更新reg寄存器中mask指定的位
 regcache_cache_bypass(arizona->regmap, true); // 设置读写寄存器不通过cache模式而是bypass模式，读写立即生效，一般在audio等确保时序性驱动中用到

释放regmap

regmap_exit(struct regmap *map);