您的位置:

Regmap全面解析

一、Regmap SPI

Regmap是一个与设备寄存器通讯的抽象层,它可以用作寄存器I/O,收发I2C/SPI数据,读取/写入寄存器等。Regmap的一大优势是可以支持多种通讯总线,包括I2C、SPI、MMIO等。在SPI总线上使用Regmap时,需要通过spi_new_device函数来注册spi_device,同时提供寄存器编码信息和相关回调函数。以下是SPI接口的使用示例:


static int regmap_spi_probe(struct spi_device *spi)
{
    int ret = 0;
    struct regmap_config config = {
        .reg_bits = 8,
        .val_bits = 8,
    };
    struct regmap *regmap;
    
    regmap = devm_regmap_init_spi(spi, &config);
    if (IS_ERR(regmap)) {
        return PTR_ERR(regmap);
    }
    
    /* Do something with regmap */
    
    return ret;
}
static struct spi_driver regmap_spi_driver = {
    .driver     = {
        .name   = "regmap-spi",
        .owner  = THIS_MODULE,
    },
    .probe      = regmap_spi_probe,
};
module_spi_driver(regmap_spi_driver);

二、Regmap子系统详解

Regmap子系统是Regmap的一个重要组成部分,它维护了一个通过Regmap接口访问的设备寄存器映射表,将硬件寄存器和内存地址进行匹配。Regmap的客户端通过调用regmap_read/regmap_write函数来进行读写操作。以下是Regmap子系统的使用示例:


static const struct regmap_config my_config = {
    .name       = "my-config",
    .val_bits   = 8,
    .reg_bits   = 8,
};

static int regmap_probe(struct spi_device *spi)
{
    struct regmap *regmap;

    regmap = devm_regmap_init_spi(spi, &my_config);
    if (IS_ERR(regmap))
        return PTR_ERR(regmap);

    /* Do something with regmap */

    return 0;
}

static struct spi_driver regmap_driver = {
    .driver = {
        .name   = "my-regmap",
        .owner  = THIS_MODULE,
    },
    .probe  = regmap_probe,
};
module_spi_driver(regmap_driver);

三、Regmap_read

Regmap_read函数是Regmap的一个基本函数,用于从硬件寄存器中读取数据。以下是Regmap_read的代码示例:


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

其中map是Regmap的实例,reg是寄存器地址,val是存放读取结果的指针。使用时,可以通过函数返回值来判断读取结果是否正确。以下是使用Regmap_read的示例:


static int my_driver_probe(struct platform_device *pdev)
{
    int ret;
    struct regmap *map;
    unsigned int val;

    /* Initialize regmap with appropriate config */

    ret = regmap_read(map, 0x10, &val);
    if (ret) {
        dev_err(&pdev->dev, "Failed to read from reg 0x10: %d\n", ret);
        return ret;
    }

    /* Do something with the read value */

    return 0;
}

四、Regmap_write

Regmap_write函数是Regmap的另一个基本函数,用于向硬件寄存器中写入数据。以下是Regmap_write的代码示例:


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

其中map是Regmap的实例,reg是寄存器地址,val是要写入的数据。使用时,同样可以通过函数返回值来判断写入结果是否正确。以下是使用Regmap_write的示例:


static int my_driver_probe(struct platform_device *pdev)
{
    int ret;
    struct regmap *map;

    /* Initialize regmap with appropriate config */

    ret = regmap_write(map, 0x10, 0x1234);
    if (ret) {
        dev_err(&pdev->dev, "Failed to write to reg 0x10: %d\n", ret);
        return ret;
    }

    /* Do something after write operation */

    return 0;
}

五、Regmap_写16位

Regmap_写16位函数是Regmap的一个特殊函数,专门用于向寄存器中写入16位数据。如果使用Regmap_write函数写入16位数据,将需要两次写入操作。以下是Regmap_写16位的代码示例:


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

其中map是Regmap的实例,reg是寄存器地址,val是要写入的数据。同样可以通过函数返回值来判断写入结果是否正确。以下是使用Regmap_写16位的示例:


static int my_driver_probe(struct platform_device *pdev)
{
    int ret;
    struct regmap *map;

    /* Initialize regmap with appropriate config */

    ret = regmap_write16(map, 0x10, 0x1234);
    if (ret) {
        dev_err(&pdev->dev, "Failed to write to reg 0x10: %d\n", ret);
        return ret;
    }

    /* Do something after write operation */

    return 0;
}

六、Regmap使用的多吗

Regmap是一个非常流行和广泛使用的Linux内核组件,因为它可以让驱动程序更加灵活地与具体硬件平台进行通讯。如果硬件平台发生变化,只需更新Regmap的配置和映射表即可,而不需要修改驱动程序本身。Regmap的使用频率非常高,被广泛应用于各种硬件设备的驱动程序中,例如I2C、SPI、MMIO、PCI和USB等。

七、Regmap_init_mmio

Regmap_init_mmio函数用于初始化Regmap的实例,并与内存映射IO(MMIO)地址等参数进行关联。以下是Regmap_init_mmio的代码示例:


struct regmap *regmap_init_mmio(const char *name,
                                void __iomem *base,
                                const struct regmap_config *config)

其中name是Regmap的名字,base是内存映射的地址,config确定了Regmap的配置。使用示例如下:


static int my_driver_probe(struct platform_device *pdev)
{
    int ret;
    struct regmap *map;
    void __iomem *base;

    /* Initialize base and map */

    map = regmap_init_mmio("my-regmap", base, &my_config);
    if (IS_ERR(map)) {
        dev_err(&pdev->dev, "Failed to init regmap: %ld\n", PTR_ERR(map));
        return PTR_ERR(map);
    }

    /* Do something after initialization */

    return 0;
}

八、Regmap_update_bits

Regmap_update_bits函数用于将指定寄存器的指定位的值更新为指定值。以下是Regmap_update_bits的代码示例:


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

其中map是Regmap的实例,reg是寄存器地址,mask是待更新的位掩码,val是待更新的值。使用示例如下:


static int my_driver_probe(struct platform_device *pdev)
{
    int ret;
    struct regmap *map;

    /* Initialize regmap with appropriate config */

    /* Update bits of register 0x10 from bit 4 to bit 7 to value 0x7 */
    ret = regmap_update_bits(map, 0x10, 0xf0, 0x70);
    if (ret) {
        dev_err(&pdev->dev, "Failed to update bits: %d\n", ret);
        return ret;
    }

    /* Do something after bits update */

    return 0;
}

九、Regmap_read_devmem2

Regmap_read_devmem2函数用于从指定内存地址读取数据。以下是Regmap_read_devmem2的代码示例:


int regmap_read_devmem2(unsigned int base_addr, unsigned int reg, unsigned int *val)

其中base_addr是内存地址,reg是寄存器地址,val是指向读取值的指针。使用示例如下:


static int my_driver_probe(struct platform_device *pdev)
{
    int ret;
    unsigned int val;

    /* Read from a specific memory address */
    ret = regmap_read_devmem2(0x80000000, 0x10, &val);
    if (ret) {
        dev_err(&pdev->dev, "Failed to read from memory: %d\n", ret);
        return ret;
    }

    /* Do something with the read value */

    return 0;
}

十、Regmap_add_irq_chip

Regmap_add_irq_chip函数用于将一个硬件中断代码(ISR)与一个设备相关联。以下是Regmap_add_irq_chip的代码示例:


int regmap_add_irq_chip(struct device *dev, unsigned int irq,
                        struct regmap *regmap,
                        irq_flow_handler_t handler,
                        void *data)

其中dev是设备结构体指针,irq是中断号,regmap是Regmap的实例,handler是中断处理函数,data是中断处理函数的私有数据。使用示例如下:


static int my_driver_probe(struct platform_device *pdev)
{
    int ret;
    struct regmap *map;

    /* Initialize regmap with appropriate config */

    /* Add an IRQ chip for this device */
    ret = regmap_add_irq_chip(&pdev->dev, irq_num, map, my_isr, my_data);
    if (ret) {
        dev_err(&pdev->dev, "Failed to add IRQ chip: %d\n", ret);
        return ret;
    }

    /* Do something after IRQ chip added */

    return 0;
}