码迷,mamicode.com
首页 > 其他好文 > 详细

I2C总线、设备、驱动

时间:2019-09-22 22:01:40      阅读:101      评论:0      收藏:0      [点我收藏+]

标签:并且   smo   echo   存在   word   tab   gis   tran   设备驱动   

I2C总线、设备、驱动

框架

I2C驱动框架可分为3个部分,分别是:I2C核心层、I2C总线驱动层(适配器层)以及I2C设备驱动层;

  • I2C核心层

    提供了统一的I2C操作函数,主要有两套函数smbus(system manager bus)和i2c_transfer;

    其中smbus是i2c_transfer的一小部分,有一些适配器只支持smbus,当驱动中只是用部分I2C协议功能时可使用smbus,具体使用可参考内核源码目录下:kernel/Documentation/i2c/smbus-protocol文档;

    在进行I2C设备的读写操作时,smbus提供了一系列的接口函数,可直接调用,而i2c_transfer需要构建i2c_msg,之后调用i2c_transfer函数进行操作;

  • I2C总线驱动层(适配器层)

    是对I2C硬件结构中(即主控芯片中I2C控制器)适配器的实现,主要包括I2C适配器数据结构i2c_adapter、I2C适配器的algorithm数据结构i2c_algorithm以及控制I2C适配器产生通信信号的函数;

  • I2C设备驱动层

    主要指的是对从设备硬件体系设备端的实现,设备一般挂接在受CPU控制的I2C适配器上,驱动部分主要包括了数据结构i2c_driver和i2c_client;

对于I2C设备驱动,在内核中有个i2c_bus_type结构体,定义如下:

struct bus_type i2c_bus_type = {
    .name       = "i2c",
    .match      = i2c_device_match,
    .probe      = i2c_device_probe,
    .remove     = i2c_device_remove,
    .shutdown   = i2c_device_shutdown,
    .pm         = &i2c_device_pm_ops,
};

在I2C总线中有两个链表,这两个链表分别存储着不同的“i2c_client”和“i2c_driver”;

当注册一个i2c_client时,会从i2c_driver所在的链表中将i2c-driver挨个取出与i2c_client进行比对,如果匹配,就调用对应i2c_driver中的probe函数(probe函数内部做什么事情自己随意定);

当注册一个i2c_driver时,会从i2c_client所在的链表中将i2c_client挨个取出与i2c_driver进行比对,如果匹配,就调用对应i2c_driver中的probe函数(probe函数内部做什么事情自己随意定);

i2c_client和i2c_driver的进行匹配判断时调用的函数时i2c_bus_type中的.match,匹配判断的规则是driver->id_table中的名字与client的名字是否相同,代码如下:

if (driver->id_table)
        return i2c_match_id(driver->id_table, client) != NULL;
/* i2c_match_id函数如下 */
static const struct i2c_device_id *i2c_match_id(const struct i2c_device_id *id,
                        const struct i2c_client *client)
{
    while (id->name[0]) {
        if (strcmp(client->name, id->name) == 0) /* 比对的关键所在name */
            return id;
        id++;
    }
    return NULL;
}

构建一个I2C设备

总共有四种方式,可参考文档:linux源码目录下/Documentation/i2c/instantiating-devices;

  • 第一种方法

    定义一个i2c_board_info结构体,例如:

    static struct i2c_board_info i2c_devs[] __initdata = {
      {
          I2C_BOARD_INFO("xxx", (0x74>>1)),
            .platform_data = &xxx_pdata,
      },
    };

    里面还有名字,设备地址;

    然后调用函数i2c_register_board_info()注册这个结构体,之后的函数调用处理如下:

    i2c_register_board_info
      /* 会在函数内部分配一个devinfo,然后根据i2c_register_board_info传入的参数
         * 来设置devinfo,最终添加到__i2c_board_list链表中
         */
      list_add_tail(&devinfo->list, &__i2c_board_list);

    搜索__i2c_board_list这个链表在什么地方用,发现是i2c_scan_static_board_info函数在调用,内部处理如下:

    /* 在函数i2c_scan_static_board_info中使用链表
     * 对链表中的每一个成员都调用i2c_new_device()
     */
    list_for_each_entry(devinfo, &__i2c_board_list, list) {
          if (devinfo->busnum == adapter->nr
                  && !i2c_new_device(adapter,
                          &devinfo->board_info))
    }

    其中调用的i2c_new_device()函数的作用是:根据i2c_board_info信息构造一个client,然后调用device_register()进行注册;

    那么,i2c_scan_static_board_info()函数是谁在调用?

    是i2c_register_adapter()函数在调用;

    总结:

    函数调用依次是:i2c_register_adapter() -> i2c_scan_static_board_info() -> i2c_new_device();

    当调用i2c_register_adapter()时,就会扫描挂在__i2c_board_list这个链表上的每个成员,并调用i2c_new_device()构造client,最终添加到i2c总线对应的设备链表中,并将i2c_driver中的每一项取出来比对,匹配上之后就调用i2c_driver中的probe函数;

    使用限制:

    必须在i2c_register_adapter之前就i2c_register_board_info()已经构造了i2c_board_info,所以不适合动态加载insmod;

  • 第二种方法

    直接使用i2c_new_device()或者i2c_new_probed_device();

    区别:

    i2c_new_device()不管设备地址对还是不对,都认为设备肯定存在;

    参考代码如下:

    /* at24cxx_dev.c 使用i2c_new_device */
    #include <linux/kernel.h>
    #include <linux/module.h>
    #include <linux/platform_device.h>
    #include <linux/i2c.h>
    #include <linux/err.h>
    #include <linux/regmap.h>
    #include <linux/slab.h>
    
    static struct i2c_board_info at24cxx_info = { 
      I2C_BOARD_INFO("at24c08", 0x50),
    };
    
    static struct i2c_client *at24cxx_client;
    
    static int at24cxx_dev_init(void)
    {
      struct i2c_adapter *i2c_adap;
    
      i2c_adap = i2c_get_adapter(0);
      at24cxx_client = i2c_new_device(i2c_adap, &at24cxx_info);
      i2c_put_adapter(i2c_adap);
    
      return 0;
    }
    
    static void at24cxx_dev_exit(void)
    {
      i2c_unregister_device(at24cxx_client);
    }
    
    module_init(at24cxx_dev_init);
    module_exit(at24cxx_dev_exit);
    MODULE_LICENSE("GPL");

    i2c_new_probed_device()先通过传入的或者默认的probe函数发送一个数据看设备有没有回应,来确认设备是否真实存在,之后才会调用i2c_new_device();

    /* at24cxx_dev.c 使用i2c_new_probed_device */
    #include <linux/kernel.h>
    #include <linux/module.h>
    #include <linux/platform_device.h>
    #include <linux/i2c.h>
    #include <linux/err.h>
    #include <linux/regmap.h>
    #include <linux/slab.h>
    
    static struct i2c_client *at24cxx_client;
    
    static const unsigned short addr_list[] = { 0x60, 0x50, I2C_CLIENT_END };
    
    static int at24cxx_dev_init(void)
    {
      struct i2c_adapter *i2c_adap;
      struct i2c_board_info at24cxx_info;
    
      memset(&at24cxx_info, 0, sizeof(struct i2c_board_info));    
      strlcpy(at24cxx_info.type, "at24c08", I2C_NAME_SIZE);
    
      i2c_adap = i2c_get_adapter(0);
      at24cxx_client = i2c_new_probed_device(i2c_adap, &at24cxx_info, addr_list, NULL);
      i2c_put_adapter(i2c_adap);
    
      if (at24cxx_client)
          return 0;
      else
          return -ENODEV;
    }
    
    static void at24cxx_dev_exit(void)
    {
      i2c_unregister_device(at24cxx_client);
    }
    
    module_init(at24cxx_dev_init);
    module_exit(at24cxx_dev_exit);
    MODULE_LICENSE("GPL");
  • 第三种方法

    从用户空间创建设备;

    创建设备:echo eeprom 0x50 > /sys/bus/i2c/devices/i2c-3/new_device

    其中“eeprom ”为设备名字,“0x50 ”为设备地址,最终会构造一个i2c_board_info,再调用i2c_new_device();

    删除设备:echo 0x50 > /sys/bus/i2c/devices/i2c-3/delete_device

    可参考内核源码目录下kernel/Documentation/i2c/dev-interface文档;

    通常,i2c设备由内核驱动程序控制,但它也是可以从用户空间访问适配器上的所有设备,通过/dev接口,这需要i2c-tools这个包的支持;

    注意:如果内核中已经有了(安装了)该设备的驱动程序,那么这种方法就不能使用了(在使用i2cdev_ioctl接口时,内部会调用i2cdev_check_addr()进行校验,如果这个设备地址已经有驱动绑定了,就会返回-EBUSY);

    具体参考代码如下:

    
    #include <stdio.h>
    #include <stdlib.h>
    #include <string.h>
    #include <sys/types.h>
    #include <sys/stat.h>
    #include <fcntl.h>
    #include "i2c-dev.h" /* 需要该文件支持,文件来自i2c-tools包,可网上下载 */
    
    /* i2c_usr_test </dev/i2c-0> <dev_addr> r addr
     * i2c_usr_test </dev/i2c-0> <dev_addr> w addr val
     */
    void print_usage(char *file)
    {
      printf("%s </dev/i2c-0> <dev_addr> r addr\n", file);
      printf("%s </dev/i2c-0> <dev_addr> w addr val\n", file);
    }
    
    int main(int argc, char **argv)
    {
      int fd;
      unsigned char addr, data;
      int dev_addr;
    
      if ((argc != 5) && (argc != 6))
      {
          print_usage(argv[0]);
          return -1;
      }
    
      fd = open(argv[1], O_RDWR);
      if (fd < 0)
      {
          printf("can't open %s\n", argv[1]);
          return -1;
      }
    
      dev_addr = strtoul(argv[2], NULL, 0);
      if (ioctl(fd, I2C_SLAVE, dev_addr) < 0)
      {    
          /* ERROR HANDLING; you can check errno to see what went wrong */    
          printf("set addr error!\n");
          return -1;
      }
    
      if (strcmp(argv[3], "r") == 0)
      {
          addr = strtoul(argv[4], NULL, 0);
    
          data = i2c_smbus_read_word_data(fd, addr);
    
          printf("data: %c, %d, 0x%2x\n", data, data, data);
      }
      else if ((strcmp(argv[3], "w") == 0) && (argc == 6))
      {
          addr = strtoul(argv[4], NULL, 0);
          data = strtoul(argv[5], NULL, 0);
          i2c_smbus_write_byte_data(fd, addr, data);      
      }
      else
      {
          print_usage(argv[0]);
          return -1;
      }
    
      return 0;
    }
  • 第四种方法

    前面三种方法都要事先确定好适配器(I2C控制器),同时也推荐使用前三种方法;

    第四种方法的参考代码如下:

    /* at24cxx_drv.c */
    #include <linux/kernel.h>
    #include <linux/module.h>
    #include <linux/platform_device.h>
    #include <linux/i2c.h>
    #include <linux/err.h>
    #include <linux/regmap.h>
    #include <linux/slab.h>
    
    static int __devinit at24cxx_probe(struct i2c_client *client,
                    const struct i2c_device_id *id)
    {
      printk("%s %s %d\n", __FILE__, __FUNCTION__, __LINE__);
      return 0;
    }
    
    static int __devexit at24cxx_remove(struct i2c_client *client)
    {
      printk("%s %s %d\n", __FILE__, __FUNCTION__, __LINE__);
      return 0;
    }
    
    static const struct i2c_device_id at24cxx_id_table[] = {
      { "at24c08", 0 },
      {}
    };
    
    static int at24cxx_detect(struct i2c_client *client,
                 struct i2c_board_info *info)
    {
      /* 能运行到这里, 表示该addr的设备是存在的
       * 但是有些设备单凭地址无法分辨(A芯片的地址是0x50, B芯片的地址也是0x50)
       * 还需要进一步读写I2C设备来分辨是哪款芯片
       * detect就是用来进一步分辨这个芯片是哪一款,并且设置info->type
       */
    
      printk("at24cxx_detect : addr = 0x%x\n", client->addr);
    
      /* 进一步判断是哪一款 */
    
      strlcpy(info->type, "at24c08", I2C_NAME_SIZE);
      return 0;
    }
    
    static const unsigned short addr_list[] = { 0x60, 0x50, I2C_CLIENT_END };
    
    /* 1. 分配/设置i2c_driver */
    static struct i2c_driver at24cxx_driver = {
      .class  = I2C_CLASS_HWMON, /* 表示去哪些适配器上找设备 */
      .driver = {
          .name   = "100ask",
          .owner  = THIS_MODULE,
      },
      .probe      = at24cxx_probe,
      .remove     = __devexit_p(at24cxx_remove),
      .id_table   = at24cxx_id_table,
      .detect     = at24cxx_detect,  /* 用这个函数来检测设备确实存在 */
      .address_list   = addr_list,   /* 这些设备的地址 */
    };
    
    static int at24cxx_drv_init(void)
    {
      /* 2. 注册i2c_driver */
      i2c_add_driver(&at24cxx_driver);
    
      return 0;
    }
    
    static void at24cxx_drv_exit(void)
    {
      i2c_del_driver(&at24cxx_driver);
    }
    
    module_init(at24cxx_drv_init);
    module_exit(at24cxx_drv_exit);
    MODULE_LICENSE("GPL");

注册I2C驱动

参考代码如下:

/* at24cxx_drv.c */
#include <linux/kernel.h>
#include <linux/module.h>
#include <linux/platform_device.h>
#include <linux/i2c.h>
#include <linux/err.h>
#include <linux/regmap.h>
#include <linux/slab.h>
#include <linux/fs.h>
#include <asm/uaccess.h>

static int major;
static struct class *class;
static struct i2c_client *at24cxx_client;

/* 传入: buf[0] : addr
 * 输出: buf[0] : data
 */
static ssize_t at24cxx_read(struct file * file, char __user *buf, size_t count, loff_t *off)
{
    unsigned char addr, data;
    
    copy_from_user(&addr, buf, 1);
    data = i2c_smbus_read_byte_data(at24cxx_client, addr);
    copy_to_user(buf, &data, 1);
    return 1;
}

/* buf[0] : addr
 * buf[1] : data
 */
static ssize_t at24cxx_write(struct file *file, const char __user *buf, size_t count, loff_t *off)
{
    unsigned char ker_buf[2];
    unsigned char addr, data;

    copy_from_user(ker_buf, buf, 2);
    addr = ker_buf[0];
    data = ker_buf[1];

    printk("addr = 0x%02x, data = 0x%02x\n", addr, data);

    if (!i2c_smbus_write_byte_data(at24cxx_client, addr, data))
        return 2;
    else
        return -EIO;    
}

static struct file_operations at24cxx_fops = {
    .owner = THIS_MODULE,
    .read  = at24cxx_read,
    .write = at24cxx_write,
};

static int __devinit at24cxx_probe(struct i2c_client *client,
                  const struct i2c_device_id *id)
{
    at24cxx_client = client;
        
    //printk("%s %s %d\n", __FILE__, __FUNCTION__, __LINE__);
    major = register_chrdev(0, "at24cxx", &at24cxx_fops);
    class = class_create(THIS_MODULE, "at24cxx");
    device_create(class, NULL, MKDEV(major, 0), NULL, "at24cxx"); /* /dev/at24cxx */
    return 0;
}

static int __devexit at24cxx_remove(struct i2c_client *client)
{
    //printk("%s %s %d\n", __FILE__, __FUNCTION__, __LINE__);
    device_destroy(class, MKDEV(major, 0));
    class_destroy(class);
    unregister_chrdev(major, "at24cxx");
    return 0;
}

static const struct i2c_device_id at24cxx_id_table[] = {
    { "at24c08", 0 },
    {}
};

/* 1. 分配/设置i2c_driver */
static struct i2c_driver at24cxx_driver = {
    .driver = {
        .name   = "100ask",
        .owner  = THIS_MODULE,
    },
    .probe      = at24cxx_probe,
    .remove     = __devexit_p(at24cxx_remove),
    .id_table   = at24cxx_id_table,
};

static int at24cxx_drv_init(void)
{
    /* 2. 注册i2c_driver */
    i2c_add_driver(&at24cxx_driver);
    
    return 0;
}

static void at24cxx_drv_exit(void)
{
    i2c_del_driver(&at24cxx_driver);
}

module_init(at24cxx_drv_init);
module_exit(at24cxx_drv_exit);
MODULE_LICENSE("GPL");

I2C总线、设备、驱动

标签:并且   smo   echo   存在   word   tab   gis   tran   设备驱动   

原文地址:https://www.cnblogs.com/jasontian996/p/11569067.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!