I.MX6ULL_Linux_驱动篇(57)linux Regmap API驱动

这篇具有很好参考价值的文章主要介绍了I.MX6ULL_Linux_驱动篇(57)linux Regmap API驱动。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

我们在前面学习 I2C 和 SPI 驱动的时候,针对 I2C 和 SPI 设备寄存器的操作都是通过相关的 API 函数进行操作的。这样 Linux 内核中就会充斥着大量的重复、冗余代码,但是这些本质上都是对寄存器的操作,所以为了方便内核开发人员统一访问 I2C/SPI 设备的时候,为此引入了 Regmap 子系统,本章我们就来学习一下如何使用 Regmap API 函数来读写 I2C/SPI 设备寄存器。

Regmap API 简介

什么是 Regmap

Linux 下大部分设备的驱动开发都是操作其内部寄存器,比如 I2C/SPI 设备的本质都是一样的,通过 I2C/SPI 接口读写芯片内部寄存器。芯片内部寄存器也是同样的道理,比如 I.MX6ULL的 PWM、定时器等外设初始化,最终都是要落到寄存器的设置上。

Linux 下使用 i2c_transfer 来读写 I2C 设备中的寄存器, SPI 接口的话使用 spi_write/spi_read等。 I2C/SPI 芯片又非常的多,因此 Linux 内核里面就会充斥了大量的 i2c_transfer 这类的冗余
代码,再者,代码的复用性也会降低。比如 icm20608 这个芯片既支持 I2C 接口,也支持 SPI 接口。假设我们在产品设计阶段一开始将 icm20608 设计为 SPI 接口,但是后面发现 SPI 接口不够
用,或者 SOC 的引脚不够用,我们需要将 icm20608 改为 I2C 接口。这个时候 icm20608 的驱动就要大改,我们需要将 SPI 接口函数换为 I2C 的,工作量比较大。

基于代码复用的原则, Linux 内核引入了 regmap 模型, regmap 将寄存器访问的共同逻辑抽象出来,驱动开发人员不需要再去纠结使用 SPI 或者 I2C 接口 API 函数,统一使用 regmap API
函数。这样的好处就是统一使用 regmap,降低了代码冗余, 提高了驱动的可以移植性。 regmap模型的重点在于:通过 regmap 模型提供的统一接口函数来访问器件的寄存器, SOC 内部的寄存器也可以使用 regmap 接口函数来访问。regmap 是 Linux 内核为了减少慢速 I/O 在驱动上的冗余开销,提供了一种通用的接口来操作硬件寄存器。另外, regmap 在驱动和硬件之间添加了 cache,降低了低速 I/O 的操作次数,提高了访问效率,缺点是实时性会降低。
什么情况下会使用 regmap:
①、硬件寄存器操作,比如选用通过 I2C/SPI 接口来读写设备的内部寄存器,或者需要读写 SOC 内部的硬件寄存器。
②、提高代码复用性和驱动一致性,简化驱动开发过程。
③、减少底层 I/O 操作次数,提高访问效率。
本章教程我们就来重点学习一下如何将《 Linux SPI 驱动实验》中编写的 SPI接口的 icm20608 驱动改为使用 regmap API。

Regmap 驱动框架

regmap 驱动框架如下图所示:
I.MX6ULL_Linux_驱动篇(57)linux Regmap API驱动,Linux_NXP_IMX6ULL,linux,arm

regmap 框架分为三层:
①、底层物理总线: regmap 就是对不同的物理总线进行封装,目前 regmap 支持的物理总线有 i2c、 i3c、 spi、 mmio、 sccb、 sdw、 slimbus、 irq、 spmi 和 w1。
②、 regmap 核心层,用于实现 regmap,我们不用关心具体实现。
③、 regmap API 抽象层, regmap 向驱动编写人员提供的 API 接口,驱动编写人员使用这些API 接口来操作具体的芯片设备,也是驱动编写人员重点要掌握的。
 

Linux 内 核 将 regmap 框 架 抽 象 为 regmap 结 构 体 , 这 个 结 构 体 定 义 在 文 件drivers/base/regmap/internal.h 中,结构体内容如下(有缩减):

51 struct regmap {
52     union {
53         struct mutex mutex;
54         struct {
55             spinlock_t spinlock;
56             unsigned long spinlock_flags;
57         };
58     };
59     regmap_lock lock;
60     regmap_unlock unlock;
61     void *lock_arg; /* This is passed to lock/unlock functions */
62
63     struct device *dev; /* Device we do I/O on */
64     void *work_buf; /* Scratch buffer used to format I/O */
65     struct regmap_format format; /* Buffer format */
66     const struct regmap_bus *bus;
67     void *bus_context;
68     const char *name;
69
70     bool async;
71     spinlock_t async_lock;
72     wait_queue_head_t async_waitq;
73     struct list_head async_list;
74     struct list_head async_free;
75     int async_ret;
......
89     unsigned int max_register;
90     bool (*writeable_reg)(struct device *dev, unsigned int reg);
91     bool (*readable_reg)(struct device *dev, unsigned int reg);
92     bool (*volatile_reg)(struct device *dev, unsigned int reg);
93     bool (*precious_reg)(struct device *dev, unsigned int reg);
94     const struct regmap_access_table *wr_table;
95     const struct regmap_access_table *rd_table;
96     const struct regmap_access_table *volatile_table;
97     const struct regmap_access_table *precious_table;
98
99     int (*reg_read)(void *context, unsigned int reg, unsigned int *val);
100    int (*reg_write)(void *context, unsigned int reg, unsigned int val);
......
147    struct rb_root range_tree;
148    void *selector_work_buf; /* Scratch buffer used for selector */
149 };

要使用 regmap,肯定要先给驱动分配一个具体的 regmap 结构体实例,一会讲解如何分配regmap 实例。大家可以看到示例代码第 90~100 行有很多的函数以及 table,这些需要驱动编写人员根据实际情况选择性的初始化, regmap 的初始化通过结构体 regmap_config 来完成。

顾名思义, regmap_config 结构体就是用来初始化 regmap 的,这个结构体也定义在include/linux/regmap.h 文件中,结构体内容如下:

186 struct regmap_config {
187     const char *name;
188
189     int reg_bits;
190     int reg_stride;
191     int pad_bits;
192     int val_bits;
193
194     bool (*writeable_reg)(struct device *dev, unsigned int reg);
195     bool (*readable_reg)(struct device *dev, unsigned int reg);
196     bool (*volatile_reg)(struct device *dev, unsigned int reg);
197     bool (*precious_reg)(struct device *dev, unsigned int reg);
198     regmap_lock lock;
199     regmap_unlock unlock;
200     void *lock_arg;
201
202     int (*reg_read)(void *context, unsigned int reg, unsigned int *val);
203     int (*reg_write)(void *context, unsigned int reg, unsigned int val);
204
205     bool fast_io;
206
207     unsigned int max_register;
208     const struct regmap_access_table *wr_table;
209     const struct regmap_access_table *rd_table;
210     const struct regmap_access_table *volatile_table;
211     const struct regmap_access_table *precious_table;
212     const struct reg_default *reg_defaults;
213     unsigned int num_reg_defaults;
214     enum regcache_type cache_type;
215     const void *reg_defaults_raw;
216     unsigned int num_reg_defaults_raw;
217
218     u8 read_flag_mask;
219     u8 write_flag_mask;
220
221     bool use_single_rw;
222     bool can_multi_write;
223
224     enum regmap_endian reg_format_endian;
225     enum regmap_endian val_format_endian;
226
227     const struct regmap_range_cfg *ranges;
228     unsigned int num_ranges;
229 };

Linux 内核里面已经对 regmap_config 各个成员变量进行了详细的讲解,这里我们只看一些比较重要的:
第 187 行 name:名字。
第 189 行 reg_bits:寄存器地址位数,必填字段。
第 190 行 reg_stride:寄存器地址步长。
第 191 行 pad_bits:寄存器和值之间的填充位数。
第 192 行 val_bits:寄存器值位数,必填字段。
第 194 行 writeable_reg:可选的可写回调函数,寄存器可写的话此回调函数就会被调用,并返回 true。
第 195 行 readable_reg:可选的可读回调函数,寄存器可读的话此回调函数就会被调用,并返回 true。
第 196 行 volatile_reg:可选的回调函数,当寄存器值不能缓存的时候此回调函数就会被调用,并返回 true。
第 197 行 precious_reg:当寄存器值不能被读出来的时候此回调函数会被调用,比如很多中断状态寄存器读清零,读这些寄存器就可以清除中断标志位,但是并没有读出这些寄存器内部的值。
第 202 行 reg_read:可选的读操作回调函数,所有读寄存器的操作此回调函数就会执行。
第 203 行 reg_write:可选的写操作回调函数,所有写寄存器的操作此回调函数就会执行。
第 205 行 fast_io:快速 I/O,使用 spinlock 替代 mutex 来提升锁性能。
第 207 行 max_register:有效的最大寄存器地址,可选。
第 208 行 wr_table:可写的地址范围,为 regmap_access_table 结构体类型。后面的 rd_table、volatile_table、 precious_table、 wr_noinc_table 和 rd_noinc_table 同理。
第 212 行 reg_defaults:寄存器模式值,为 reg_default 结构体类型,此结构体有两个成员变量: reg 和 def, reg 是寄存器地址, def 是默认值。
第 216 行 num_reg_defaults:默认寄存器表中的元素个数。
第 218 行 read_flag_mask:读标志掩码。
第 219 行 write_flag_mask:写标志掩码。
关于 regmap_config 结构体成员变量就介绍这些,其他没有介绍的自行查阅 Linux 内核中的相关描述。

Regmap 操作函数

Regmap 申请与初始化
前面说了, regmap 支持多种物理总线,比如 I2C 和 SPI,我们需要根据所使用的接口来选择合适的 regmap 初始化函数。 Linux 内核提供了针对不同接口的 regmap 初始化函数, SPI 接口初始化函数为 regmap_init_spi,函数原型如下:

struct regmap * regmap_init_spi(struct spi_device *spi, const struct regmap_config *config)

函数参数和返回值含义如下:
spi: 需要使用 regmap 的 spi_device。
config: regmap_config 结构体,需要程序编写人员初始化一个 regmap_config 实例,然后将其地址赋值给此参数。
返回值:申请到的并进过初始化的 regmap。

I2C 接口的 regmap 初始化函数为 regmap_init_i2c,函数原型如下:

struct regmap * regmap_init_i2c(struct i2c_client *i2c, const struct regmap_config *config)

函数参数和返回值含义如下:
i2c: 需要使用 regmap 的 i2c_client。
config: regmap_config 结构体,需要程序编写人员初始化一个 regmap_config 实例,然后将其地址赋值给此参数。
返回值:申请到的并进过初始化的 regmap。
还有很多其他物理接口对应的 regmap 初始化函数,这里就不介绍了,大家直接查阅 Linux内核即可,基本和 SPI/I2C 的初始化函数相同
在退出驱动的时候需要释放掉申请到的 regmap,不管是什么接口,全部使用 regmap_exit 这个函数来释放 regmap,函数原型如下:

void regmap_exit(struct regmap *map)

函数参数和返回值含义如下:
map: 需要释放的 regmap
返回值:无。
我们一般会在 probe 函数中初始化 regmap_config,然后申请并初始化 regmap。

regmap 设备访问 API 函数

不管是 I2C 还是 SPI 等接口,还是 SOC 内部的寄存器,对于寄存器的操作就两种:读和写。 regmap 提供了最核心的两个读写操作: regmap_read 和 regmap_write。这两个函数分别用来读/写寄存器, regmap_read 函数原型如下:

int regmap_read(struct regmap *map,
                unsigned int reg,
                unsigned int *val)

函数参数和返回值含义如下:
map: 要操作的 regmap。
reg: 要读的寄存器。
val:读到的寄存器值。
返回值: 0,读取成功;其他值,读取失败。
regmap_write 函数原型如下:

int regmap_write(struct regmap *map,
                unsigned int reg,
                unsigned int val)

函数参数和返回值含义如下:
map: 要操作的 regmap。
reg: 要写的寄存器。
val:要写的寄存器值。
返回值: 0,写成功;其他值,写失败。
在 regmap_read 和 regmap_write 的基础上还衍生出了其他一些 regmap 的 API 函数,首先是regmap_update_bits 函数,看名字就知道,此函数用来修改寄存器指定的 bit,函数原型如下:

int regmap_update_bits (struct regmap *map,
                        unsigned int reg,
                        unsigned int mask,
                        unsigned int val)

函数参数和返回值含义如下:
map: 要操作的 regmap。
reg: 要操作的寄存器。
mask: 掩码,需要更新的位必须在掩码中设置为 1。
val:需要更新的位值。
返回值: 0,写成功;其他值,写失败。
比如要将寄存器的 bit1 和 bit2 置 1,那么 mask 应该设置为 0X00000011,此时 val 的 bit1和 bit2 应该设置为 1,也就是 0Xxxxxxx11。如果要清除寄存器的 bit4 和 bit7,那么 mask 应该
设置为 0X10010000, val 的 bit4 和 bit7 设置为 0,也就是 0X0xx0xxxx。
接下来看一下 regmap_bulk_read 函数,此函数用于读取多个寄存器的值,函数原型如下:

int regmap_bulk_read(struct regmap *map,
                    unsigned int reg,
                    void *val,
                    size_t val_count)

函数参数和返回值含义如下:
map: 要操作的 regmap。
reg: 要读取的第一个寄存器。
val: 读取到的数据缓冲区。
val_count:要读取的寄存器数量。
返回值: 0,写成功;其他值,读失败。
另外也有多个寄存器写函数 regmap_bulk_write,函数原型如下:

int regmap_bulk_write(struct regmap *map,
                    unsigned int reg,
                    const void *val,
                    size_t val_count)

函数参数和返回值含义如下:
map: 要操作的 regmap。
reg: 要写的第一个寄存器。
val: 要写的寄存器数据缓冲区。
val_count:要写的寄存器数量。
返回值: 0,写成功;其他值,读失败。
关于 regmap 常用到 API 函数就讲解到这里,还有很多其他功能的 API 函数,大家自行查阅 Linux 内核即可,内核里面对每个 API 函数都有详细的讲解。文章来源地址https://www.toymoban.com/news/detail-843570.html

到了这里,关于I.MX6ULL_Linux_驱动篇(57)linux Regmap API驱动的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • I.MX6ULL ARM驱动开发---网络设备驱动框架

      网络驱动是 linux 里面驱动三巨头之一,linux 下的网络功能非常强大,嵌入式 linux 中也常常用到网络功能。前面我们已经讲过了字符设备驱动和块设备驱动,本章我们就来学习一下 linux 里面的网络设备驱动。   网络设备驱动程序的体系结构分为4层,依次为网络协议驱

    2023年04月17日
    浏览(16)
  • 012——LED模块驱动开发(基于I.MX6uLL)

    目录 一、 硬件原理图 二、 驱动程序 三、 应用程序 四、 Makefile 五、操作         又是非常经典的点灯环节 ,每次学新语言第一步都是hello world,拿到新板子或者学习新的操作系统,第一步就是点灯。         LED 的驱动方式,常见的有四种。 ① 使用引脚输出 3.3V 点

    2024年04月13日
    浏览(19)
  • 016——DHT11驱动开发(基于I.MX6uLL)

    目录 一、 模块介绍 1.1 简介 1.2 电路描述 1.3 通信协议 二、 驱动程序 三、 应用程序 四、 上机实验         DHT11 是一款可测量温度和湿度的传感器。比如市面上一些空气加湿器,会测量空气中湿度,再根据测量结果决定是否继续加湿。DHT11 数字温湿度传感器是一款含有已

    2024年04月16日
    浏览(12)
  • i.MX6ULL移植NXP官方Linux内核imx_5.4.47_2.2.0

    系统:Ubuntu18.04 参考资料:百问网 IMX6ULL开发板(从零移植篇-预览版)-V0.1,正点原子驱动开发指南 开发板:100ask i.MX6ULL PRO 交叉编译工具链的获取就不写了 打开 .bashrc 文件。 vi ~/.bashrc 。在该文件最后面添加如下(根据自己的交叉编译工具链) (1)直接从官网下载,非常慢而

    2024年02月12日
    浏览(25)
  • 【Linux 裸机篇(五)】I.MX6ULL BSP工程管理下的 Makefile编写、链接脚本

    文件夹 描述 bsp 存放驱动文件 imx6ul 存放跟芯片有关的文件,比如 NXP 官方的 SDK库文件 obj 存放编译生成的.o 文件 project 存放 start.S 和 main.c 文件,也就是应用文件 行 描述 1~7 定义了一些变量,除了第 2 行以外其它的都是跟编译器有关的,如果使用其它编译器的话只需要修改第

    2023年04月20日
    浏览(21)
  • 018——红外遥控模块驱动开发(基于HS0038和I.MX6uLL)

    目录 一、 模块介绍 1.1 简介 1.2 协议 二、 驱动代码 三、 应用代码 四、 实验 五、 程序优化         红外遥控被广泛应用于家用电器、工业控制和智能仪器系统中,像我们熟知的有电视机盒子遥控器、空调遥控器。红外遥控器系统分为发送端和接收端,如图下图所示。

    2024年04月16日
    浏览(16)
  • 017——DS18B20驱动开发(基于I.MX6uLL)

    目录 一、 模块介绍 1.1 简介 1.2 主要特点 1.3 存储器介绍 1.4 时序 1.5 命令 1.5.1 命令大全    1.5.2 命令使用 1.5.3 使用示例 1.6 原理图 二、 驱动程序 三、 应用程序 四、 测试         DS18B20 温度传感器具有线路简单、体积小的特点,用来测量温度非常简单,在一根通信线上

    2024年04月12日
    浏览(13)
  • i.MX6ULL驱动开发 | 27 - 使用WM8960 CODEC播放音频

    WM8960是欧胜公司(wolfson)的一款低功耗、高质量的立体声音频编解码芯片。 其内部集成D类喇叭功放,每个通道可以驱动一个1W喇叭(8Ω),内部集成3个立体声输入源,可以灵活配置,拥有一路完整的麦克风接口。 WM8960内部ADC和DAC都为24位,主要特性如下: DAC的SNR(信噪比)

    2024年02月02日
    浏览(18)
  • i.MX 6ULL 驱动开发 二十九:向 Linux 内核中添加自己编写驱动

    Linux 内核编译流程如下: 1、配置 Linux 内核。 2、编译 Linux 内核。 说明:进入 Linux 内核源码,使用 make help 参看相关配置。 1、 menuconfig 它本身是一个软件,只提供图形界面配置的一些逻辑,并不负责提供内容。 2、 menuconfig 是内核源码树的各目录下的 kconfig 提供的。 3、 m

    2023年04月10日
    浏览(53)
  • I.MX6ull UART

     一 简介 UART 全称叫做串行接口,通常也叫做 COM 接口,串行接口指的是数据一个一个的顺序传输,通信线路简单。使用两条线即可实现双向通信,一条用于发送,一条用于接收。串口通 信距离远 ,但是速 度相对会低 ,串口是一种很常用的工业接口。I.MX6U 自带的 UART 外设

    2024年02月09日
    浏览(15)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包