platform 设备树 点灯

设备树下platform框架下的驱动编写

前面已经介绍了platform的相关基础概念，但是对于具体的驱动编写并没有进行深入分析和总结，因此这一篇博客重在通过驱动的编写来增强对Platform框架的理解。

设备树下的Platform驱动简介

platform驱动框架分为总线,设备和驱动，其中总线不需要我们这些驱动程序员去管理，这个是Linux内核提供的，我们在编写驱动的时候只要关注设备和驱动的具体实现即可，当内核在解析设备树的时候会自动帮我们创建一个platform_device对象，那么在编写基于设备树的platform驱动的时候我们需要注意几点:

设备树中创建节点

设备树创建节点就是为了描述设备信息，这也是它存在的意义，因此compatible属性的值很重要，比如这里描述了led这个设备

led{
	compatible = "mizar,led";
	status = "okay";
	default-state = "on";
	led-gpio = <&gpio0 50 GPIO_ACTIVE_HIGH>
};

这里compatible的属性值是"mizar,led"，那么对应的编写驱动里面of_match_table属性表要有"mizar,led"。

/* 这里注意of_device_id的最后一个元素一定要为空 */
static const struct of_device_id leds_of_match[] = {
    {.compatible = "mizar,led"},
    {/* Sentinel */}
};
/* 使用者额个函数主要作用是声明一下leds_of_match这个匹配表
*  主要是用在热拔插设备
*/
MODULE_DEVICE_TABLE(of,leds_of_match);

static struct platform_driver leds_platform_driver = {
    .driver = {
        .name			="mizar-led",
        .of_match_table = leds_of_match,		//绑定信息就好了
    },
    .probe				=leds_probe,
    .remove				=leds_remove,
};

编写platform驱动程序

#include <linux/module.h>
#include <linux/of_gpio.h>
#include <linux/cdev.h>
#include <linux/uaccess.h>
#include <linux/platform_device.h>

#define MYLED_CNT	1
#define MYLED_NAME	"myled"

/* led 设备结构体 */
struct myled_dev{
    dev_t dev;
    struct cdev cdev;
    struct class *class;
    struct device *device;
    int led_gpio;
};

static struct myled_dev myled;

static int myled_open(struct inode *inode,struct file *filp){
    return 0;
}

static ssize_t myled_write(struct file *filp,const char __user *buf,size_t cnt,loff_t *offt)
{
    int ret;
    char kern_buf[1];
    ret = copy_from_user(kern_buf,buf,cnt);
    if(0 > ret){
        printk(KERN_ERR"myled:Failed to copy data from user buffer\r\n");
        return -EFAULT;
    }
    
    if(0 == kern_buf[0])
        gpio_set_value(myled.led_gpio,1);
    else if(1 == kern_buf[0])
        gpio_set_value(myled.led_gpio,0);
    
    return 0;
}

static int myled_init(struct device_node *nd){
    const char *str;
    int val;
    int ret;
    
    /* 从设备树中获取GPIO */
    myled.led_gpio = of_get_named_gpio(nd,"led-gpio",0);
    if(!gpio_is_valid(myled.led_gpio)){
        printk(KERN_ERR"myled:Failed to get led-gpio\n");
        return -EINVAL;
    }
    
    /* 申请使用GPIO */
    ret = gpio_request(myled.led_gpio,"PS_LED0 gpio");
    if(ret){
        printk(KERN_ERR"myled:Failed to request led-gpio\n");
        return ret;
    }
    
    /* 确定led初始状态 */
    ret = of_property_read_string(nd,"default-state",&str);
    if(!ret){
        if(!strcmp(str,"on"))
            val = 0;
        else
            val = 1;
    }
    
    else
        val = 1;
    
    /* 设置gpio模式和初始电平状态 */
    gpio_direvtion_output(myled.led_gpio,val);
    return 0;
}

/* led设备操作函数 */
static struct file_operations myled_ops = {
    .owner = THIS_MODULE,
    .open = myled_open,
    .write = myled_write,
};

static int myled_probe(struct platform_device *pdev){
    int ret;
    printk(KERN_INFO"myled:led driver and device has matched!\r\n");
    
	/* led 初始化 */
    ret = myled_init(pdev->dev.of_node);
    if(ret)
        return ret;
    
    
    ret = alloc_chrdev_region(&myled.devid,0,MYLED_CNT,MYLED_NAME);
    if(ret){
        goto out1;
    }
    /* 初始化cdev */
    myled.cdev.owner = THIS_MODULE;
    cdev_init(&myled.cdev,&myled_fops);
    
    /* 添加cdev */
    ret = cdev_add(&myled.cdev,myled_devid,MYLED_CNT);
    if(ret)
        goto out2;
    
    /* 创建类class */
    myled.class = class_create(THIS_MODULE,MYLED_NAME);
    if(IS_ERR(myled.class)){
        ret = PTR_ERR(myled.class);
        goto out3;
    }
    
    /* 创建设备 */
    myled.device = device_create(myled.class,&pdev->dev,
                                myled.devid,NULL,MYLED_NAME);
    if(IS_ERR(myled.device)){
        ret = PTR_ERR(myled.device);
        goto out4;
    }
    
    return 0;
    
 out4:
    class_destroy(myled.class);
    
 out3:
    cdev_del(&myled.cdev);
    
 out2:
    unregister_chrdev_region(myled.devid,MYLED_CNT);
    
 out1:
    gpio_free(myled.led_gpio);
    return ret;
    
}

static int myled_remove(struct platform_device *dev){
    printk(KERN_INFO"myled:led platform driver remove!\r\n");
    
    /* 注销设备 */
    device_destroy(myled.class,myled.devid);
    /* 注销类 */
    class_destroy(myled.class);
    /* 删除cdev */
    cdev_del(&myled.cdev);
   	/* 注销设备号 */
    unregister_chrdev_region(myled.devid,MYLED_CNT);
    /* 删除地址映射 */
    gpio_free(myled.led_gpio);
    
    return 0;
}

/* 匹配列表 */
static const of_device_id led_of_match[] = {
    {.compatible = "mizar,led"},
    {/* sentinel */}
};

/* platform驱动结构体 */
static struct platform_driver myled_driver = {
    .driver = {
        .name				="zynq-led",
        .of_match_table		="led_of_match",
    },
    .probe = myled_probe,
    .remove = myled_remove,  
};

/* 执行init 和 exit函数胡 */
module_platform_driver(myled_driver);
//或者
static int __init myled_driver_init(void){
    return platform_driver_register(&myled_driver);
}

static void __exit myled_driver_exit(void){
    platform_driver_unregister(&myled_driver);
}

module_init(myled_driver_init);
module_exit(myled_driver_init);

MODULE_AUTHOR("XXX");
MODULE_DESCRIPTION("LED Platform drivr");
MODULE_LICENSE("GPL");

总结

又到了关键的总结，关于点灯的总结并没有什么好说的，主要是可以和之前led驱动程序作对比，理解一下platform的优势，这里也许看不出，但是后面写一些模块的驱动的时候就会非常明显。我们应该需要了解它，增强自己写代码和阅读代码的能力。