【IMX6ULL】Linux中的platform驱动

Linux中的platform驱动

platform 设备驱动，也叫做平台设备驱动。它来源于将驱动分离和分层的软件设计思路。

驱动的分离

​ 也就是将主机驱动和设备驱动分离，不同主机的同一类驱动提供统一的接口API，然后在写设备驱动的时候只要调用这些API函数就能完成驱动的编写。减少了编写驱动底层代码的时间。

驱动的分层

​ 分层即是将驱动分成不同的层次，每个层只要做自己的事。例如 input 子系统的最底层是设备原始驱动，负责获取输入设备的原始值，然后上传给核心层；核心层会处理这些数据，然后提供 file_operations 操作集合，而编写设备驱动时只需要处理好输入事件的上报过程即可。

这种主机驱动和设备驱动分离分层的操作，在多设备的情况下应该是具有明显优势。

platform总线

总线是连接处理器和一个或多个设备之间的一个通道，所有的设备都是通过这个总线连接在一起。下面是bus_type结构体的内容。

match函数：用来完成设备和驱动之间的匹配。

platform驱动

platform_driver 结构体表示 platform 驱动。

1. device_driver 相当于一个基类，而 platform_driver 则继承了这个类，然后添加了其它特有的属性。
2. probe 函数，当驱动与设备匹配成功以后 probe 函数就会执行。谁写驱动，probe内的内容就由谁写。
3. id_table表：总线匹配设备和驱动时会用到，没使用设备树时，驱动使用的匹配表。
   
   device_driver 结构体
   
   of_match_table ：即使用设备树的时候驱动使用的匹配表。

of_device_id 结构体：

其中 compatible 是设备树与匹配表相匹配的参数，两者之间的 compatible 成员相互比较，如果有相等的就说明设备和此驱动匹配成功。

struct of_device_id 
{ 
    char name[32];
    char type[32];
    char compatible[128];
    const void *data;
};

基于设备树的 platform 设备驱动

程序思路：在驱动加载模块中会利用函数 platform_driver_register(&led_driver) 注册 platform 设备驱动，函数内的参数则是设备驱动的结构体参数。当设备的device 和其对应的driver 在总线上完成配对之后，就会执行 probe 函数完成驱动注册剩下的工作。

#include <linux/types.h> 
#include <linux/kernel.h> 
#include <linux/delay.h> 
#include <linux/ide.h> 
#include <linux/init.h> 
#include <linux/module.h> 
#include <linux/errno.h> 
#include <linux/gpio.h> 
#include <linux/cdev.h>
#include <linux/device.h>
#include <linux/of_gpio.h>
#include <linux/semaphore.h>
#include <linux/timer.h>
#include <linux/irq.h>
#include <linux/wait.h>
#include <linux/poll.h>
#include <linux/fs.h>
#include <linux/fcntl.h>
#include <linux/platform_device.h>
#include <asm/mach/map.h>
#include <asm/uaccess.h>
#include <asm/io.h>

#define LEDDEV_CNT 1
#define LEDDEV_NAME "dtsplatled"
#define LEDOFF 0
#define LEDON  1

/* leddev 设备结构体 */
struct leddev_dev{
   dev_t devid;
   struct cdev cdev;
   struct class *class;
   struct device *device;
   struct device_node *nd;
   int major;
   int led0;
};

struct leddev_dev leddev;

void led0_switch(u8 sta)
{
   if (sta == LEDON )
       gpio_set_value(leddev.led0, 0);
   else if (sta == LEDOFF)
       gpio_set_value(leddev.led0, 1);
}

static int led_open(struct inode *inode, struct file *filp)
{
   filp->private_data = &leddev;
   return 0;
}

static ssize_t led_write(struct file* filp, const char __user *buf, size_t cnt, loff_t *offt)
{
   int retvalue;
   unsigned char databuf[2];
   unsigned char ledstat;

   retvalue = copy_from_user(databuf, buf, cnt);
   if (retvalue < 0)
   {
       printk("kernel write failed!\r\n");
       return -EFAULT;
   }
   
   ledstat = databuf[0];
   if (ledstat == LEDON)
   {
       led0_switch(LEDON);
   }
   else if (ledstat == LEDOFF)
   {
       led0_switch(LEDOFF);
   }
   return 0;
}

static struct file_operations led_fops = {
   .owner = THIS_MODULE,
   .open = led_open,
   .write = led_write,
};

/* flatform 驱动的 probe 函数，当驱动与设备匹配以后此函数就会执行 */
static int led_probe(struct platform_device *dev)
{
   printk("led driver and device was matched!\r\n");

   /* 1、设置设备号 */
   if (leddev.major)
   {
       leddev.devid = MKDEV(leddev.major, 0);
       register_chrdev_region(leddev.devid, LEDDEV_CNT, LEDDEV_NAME);
   }
   else
   {
       alloc_chrdev_region(&leddev.devid, 0, LEDDEV_CNT, LEDDEV_NAME);
       leddev.major = MAJOR(leddev.devid);
   }
   
   /* 2、注册设备 */
   cdev_init(&leddev.cdev, &led_fops);
   cdev_add(&leddev.cdev, leddev.devid, LEDDEV_CNT);

   /* 3. 创建类 */
   leddev.class = class_create(THIS_MODULE,LEDDEV_NAME);
   if (IS_ERR(leddev.class)) 
   {
       return PTR_ERR(leddev.class);
   }

   /* 4. 创建设备 */
   leddev.device = device_create(leddev.class, NULL, leddev.devid, NULL, LEDDEV_NAME);
   if (IS_ERR(leddev.device)) 
   {
       return PTR_ERR(leddev.device);
   }

   /* 5. 初始化节点 */
   leddev.nd = of_find_node_by_path("/gpioled");
   if (leddev.nd == NULL)
   {
       printk("gpioled node not find!\r\n");
       return -EINVAL;
   }

   leddev.led0 = of_get_named_gpio(leddev.nd, "led-gpio", 0);
   if (leddev.led0 < 0) 
   {
       printk("can't get led-gpio\r\n");
       return -EINVAL;
   }
   /* 申请IO */
   gpio_request(leddev.led0, "led0");

   /*设置为输出，默认高电平 */
   gpio_direction_output(leddev.led0, 1);
   return 0;
}

/* remove 函数，移除 platform 驱动的时候此函数会执行 */
static int led_remove(struct platform_device *dev)
{
   /* 卸载驱动的时候关闭 LED */
   gpio_set_value(leddev.led0, 1);
   
   /* 删除 cdev */
   cdev_del(&leddev.cdev);
   unregister_chrdev_region(leddev.devid, LEDDEV_CNT);
   device_destroy(leddev.class, leddev.devid);
   class_destroy(leddev.class);
   return 0;
}

/* 匹配列表，总线通过这个列表信息来匹配设备和驱动 */
static const struct of_device_id led_of_match[] = {
   { .compatible = "atkalpha-gpioled" },
   { /* Sentinel */ }
};

/* platform 驱动结构体 */
static struct platform_driver led_driver = {
   .driver = {
       .name = "imx6ul-led",
       .of_match_table = led_of_match,
   },
   .probe = led_probe,
   .remove = led_remove,
};

/* 驱动加载模块 */
static int __init leddriver_init(void)
{
   return platform_driver_register(&led_driver);
}


/* 驱动卸载模块 */
static void __exit leddriver_exit(void)
{
   platform_driver_unregister(&led_driver);
}

module_init(leddriver_init);
module_exit(leddriver_exit);
MODULE_LICENSE("GPL");
MODULE_AUTHOR("Swiler");