嵌入式Linux设备驱动程序开发指南19（Linux设备驱动使用regmap）——读书笔记
Linux设备驱动使用regmap
- 十九、Linux设备驱动使用regmap
-
- 19.1 简介
- 19.2 regmap实现
- 19.3 通过regmap 访问SPI IIO设备驱动
-
- 19.3.1 模块分析
- 19.3.2 regmap SPI驱动代码
十九、Linux设备驱动使用regmap
19.1 简介
Linux有I2C和SPI等这样的子系统，这些系统连接依附总线上的设备，这些设备有个共同点，就是对连接到它们的设备进行寄存器读写。这往往会导致子系统存在冗余代码。为了避免这种情况，将代码提取出来，简化驱动开发和维护，Linux从3.1开始引入新的内核API，称为regmap。
regmap子系统负责调用相关SPI或I2C子系统。
案例使用ADXL345加速度计，对该器件，驱动实现两个简单驱动，一个支持I2C总线的驱动，另一个是支持SPI总线的驱动，regmap_config结构对寄存器进行配置，以使用接下来的函数对寄存器映射进行初始化。
基于SPI，regmap初始化，如下：
devm_regmap_init_spi(spi, &adxl345_spi_regmap_config);
基于I2C，regmap初始化，如下：
devm_regmap_init_i2c(i2c, &adxl345_i2c_regmap_config);
基于SPI寄存器映射配置和初始化，如下：
static const struct regmap_config adxl345_spi_regmap_config = {
.reg_bits = 8,
.val_bits = 8,
/* Setting bits 7 and 6 enables multiple-byte read */
.read_flag_mask = BIT(7) | BIT(6),
};
static int adxl345_spi_probe(struct spi_device *spi)
{
struct regmap *regmap;
/* get the id from the driver structure to use the name */
const struct spi_device_id *id = spi_get_device_id(spi);
regmap = devm_regmap_init_spi(spi, &adxl345_spi_regmap_config);
if (IS_ERR(regmap)) {
dev_err(&spi->dev, "Error initializing spi regmap: %ld\n",
PTR_ERR(regmap));
return PTR_ERR(regmap);
}
return adxl345_core_probe(&spi->dev, regmap, id->name);
}
19.2 regmap实现
在include/linux/regmap.h中，有两个重要的结构，
regmap_config
regmap
19.3 通过regmap 访问SPI IIO设备驱动
设备选用ADXL345，使用regmap API来访问。
通过驱动程序ISR中调用iio_push_event()函数实现中断检测后发送到用户态。
每个IIO缓冲条目捕获的三个周轴值，通过iio-trig-hrtimer或iio-trig-sysfs触发器。
驱动主要内容如下：
19.3.1 模块分析
头文件包含，如下：
#include 定义ADXL345设备寄存器，如下：
/* ADXL345 Register Map */
#define DEVID 0x00 /* R Device ID */
#define THRESH_TAP 0x1D /* R/W Tap threshold */
#define DUR 0x21 /* R/W Tap duration */
#define TAP_AXES 0x2A /* R/W Axis control for tap/double tap */
#define ACT_TAP_STATUS 0x2B /* R Source of tap/double tap */
#define BW_RATE 0x2C /* R/W Data rate and power mode control */
#define POWER_CTL 0x2D /* R/W Power saving features control */
#define INT_ENABLE 0x2E /* R/W Interrupt enable control */
#define INT_MAP 0x2F /* R/W Interrupt mapping control */
#define INT_SOURCE 0x30 /* R Source of interrupts */
#define DATA_FORMAT 0x31 /* R/W Data format control */
#define DATAX0 0x32 /* R X-Axis Data 0 */
#define DATAX1 0x33 /* R X-Axis Data 1 */
#define DATAY0 0x34 /* R Y-Axis Data 0 */
#define DATAY1 0x35 /* R Y-Axis Data 1 */
#define DATAZ0 0x36 /* R Z-Axis Data 0 */
#define DATAZ1 0x37 /* R Z-Axis Data 1 */
#define FIFO_CTL 0x38 /* R/W FIFO control */
#define FIFO_STATUS 0x39 /* R FIFO status */
创建执行ADXL345操作的寄存器，并传递给驱动中的某些函数，如下：
/*
* we will get the gpio using an index added to gpio
* name in the device tree. We can get also without
* this index
*/
#define ADXL345_GPIO_NAME "int"
/* DEVIDs */
#define ID_ADXL345 0xE5
/* INT_ENABLE/INT_MAP/INT_SOURCE Bits */
#define SINGLE_TAP (1 << 6)
#define WATERMARK (1 << 1)
/* TAP_AXES Bits */
#define TAP_X_EN (1 << 2)
#define TAP_Y_EN (1 << 1)
#define TAP_Z_EN (1 << 0)
创建iio_info数据结构声明IIO内核将用于设备的回调函数，如下：
static const struct iio_info adxl345_info = {
.driver_module = THIS_MODULE,
.read_raw = adxl345_read_raw,
.write_raw = adxl345_write_raw,
.read_event_value = adxl345_read_event,
.write_event_value = adxl345_write_event,
};
adxl345_read_raw()函数详细，共享sysfs属性，如下：
static int adxl345_read_raw(struct iio_dev *indio_dev,
struct iio_chan_spec const *chan,
int *val, int *val2, long mask)
{
struct adxl345_data *data = iio_priv(indio_dev);
__le16 regval;
int ret;
switch (mask) {
case IIO_CHAN_INFO_RAW:
/*
* Data is stored in adjacent registers:
* ADXL345_REG_DATA(X0/Y0/Z0) contain the least significant byte
* and ADXL345_REG_DATA(X0/Y0/Z0) + 1 the most significant byte
* we are reading 2 bytes and storing in a __le16
*/
ret = regmap_bulk_read(data->regmap, chan->address, ®val,
sizeof(regval));
if (ret < 0)
return ret;
*val = sign_extend32(le16_to_cpu(regval), 12);
return IIO_VAL_INT;
case IIO_CHAN_INFO_SCALE:
*val = 0;
*val2 = adxl345_uscale;
return IIO_VAL_INT_PLUS_MICRO;
default:
return -EINVAL;
}
}
adxl345_write_raw()函数调用regmap_write()函数访问ADXL345，如下：
static int adxl345_write_raw(struct iio_dev *indio_dev,
struct iio_chan_spec const *chan,
int val, int val2, long mask)
{
struct adxl345_data *data = iio_priv(indio_dev);
switch (mask) {
case IIO_CHAN_INFO_SAMP_FREQ:
data->data_rate = RATE(val);
return regmap_write(data->regmap, BW_RATE,
data->data_rate | (data->low_power_mode ? LOW_POWER : 0));
default :
return -EINVAL;
}
}
adxl345_read_event()函数。
adxl345_core_probe()函数申请一个线性化中断，中申请devm_iio_triggered_buffer_setup()分配一个IIo触发缓冲区
adxl345_spi_probe()函数
19.3.2 regmap SPI驱动代码
#include 感谢阅读，祝君成功！
-by aiziyou