基于GPIO子系统的LED驱动程序

一、编写思路

GPIO像I2C、UART一样，要使用某个引脚，需要先把引脚配置为GPIO功能，这要使用Pinctrl子系统，只需要在设备树里指定就可以了。

• 在驱动代码上不需要做任何事情。GPIO本身需要确定引脚，这也需要在设备树里指定。
• 设备树节点会被内核转换为platform_device。
• 对应的，驱动代码中要注册一个platform_driver，在probe函数中：获得引脚、注册file_operations。
• 在file_operation中：设置方向、读写值。

1. 需要指定pinctrl-names、pinctrl-0。需要配置成什么状态，需要使用哪些引脚。
2. 然后再pinctrller下，创建一个子节点，把有些引脚配置成对应的功能。芯片公司一般会有现成的配置方法。比如工具、文档、设备树使用例子、百度搜索
3. 虽然设置好了引脚，但是还要告诉GPIO子系统，使用这个引脚。一般是xxx-gpios = <xxx引脚>;
   比如xxx-gpios = <&gpio5 0 GPIO_ACTIVE_HIGH>;一般情况配套的属性会有#gpio-cells = <2>;用2个整数描述引脚。
4. 最后加一个compatible属性来和驱动程序挂钩

既在GPIO中指定一个引脚，又在pinctroller中指定引脚的原因：
现在是在pinctroller系统里把引脚配置成GPIO，然后再GPIO子系统里指定使用哪个引脚。
这样耦合性就比较低，不会因为pinctroller的一点微小的改动导致内核驱动也会受影响。

二、设备树中添加Pinctrl信息

• 有些芯片公司会提供设备树的生成工具，自动生成子节点。
• 有些芯片功能则是文档，按照文档就能配置成想要的参数。参考资料一般在Documentation\devicetree\bindings\pinctrl目录下。
• 如果文档也没有那就只能参考源码中设备树的使用情况。源码一般在arch/arm/boot/dts目录下。
• 或者使用百度进行搜索参考。
  一般的pinctrl子节点样式如下：
  

在pinctrll里设置好子节点，子节点里设置引脚的属性，比如配置成GPIO
然后再client device节点中，添加pinctrl-names、pinctrl-0，指定状态和需要配置的引脚。

三、在设备树中添加GPIO信息

要再设备树中添加GPIO信息，先要查看电路原理图确定所用引脚，再再设备树中指定：
添加[name]-gpios属性，指定使用的是哪一个GPIO Controller里的哪一个引脚，包括一些Flag信息。如GPIO_ACTIVE_LOW等。还有#gpio-cell属性来指定需要多少个cell描述一个引脚。

示例如下：

四、编程示例

思路：

1. 定义、注册一个platform_driver
2. 在probe函数里
   • 根据platform_device的设备树信息确定GPIO：gpiod_get
   • 定义、注册一个file_operations结构体
   • 在file_operations中使用GPIO子系统的函数操作GPIO
     gpiod_direction_output、gpiod_set_value

#include <linux/module.h>
#include <linux/kernel.h>
#include <linux/fs.h>
#include <linux/errno.h>
#include <linux/major.h>
#include <linux/init.h>
#include <linux/device.h>
#include <linux/miscdevice.h>
#include <linux/uaccess.h>
#include <linux/gpio/consumer.h>
#include <linux/of.h>
#include <linux/platform_device.h>


static int major = 0;
static struct class *led_class;
struct gpio_desc *led_gpio;

static int led_drv_open(struct inode *node, struct file *file)
{
	printk("%s %s line %d\n", __FILE__, __FUNCTION__, __LINE__);
	/* 根据描述符初始化为输出 */
	gpiod_direction_output(led_gpio, 0);
	return 0;
}

static ssize_t led_drv_read(struct file *file, char __user *buf, size_t size, loff_t *offset)
{
	printk("%s %s line %d\n", __FILE__, __FUNCTION__, __LINE__);
	return 0;
}

static ssize_t led_drv_write(struct file *file, const char __user *buf, size_t size, loff_t *offset)
{
	int err;
	char status;

	printk("%s %s line %d\n", __FILE__, __FUNCTION__, __LINE__);
	err = copy_from_user(&status, buf, 1);
	printk("write status:%x \n", status);

	/* 从用户获取输出的值 */
	gpiod_set_value(led_gpio, status);
	
	return 1;
}

static int led_drv_close(struct inode *node, struct file *file)
{
	printk("%s %s line %d\n", __FILE__, __FUNCTION__, __LINE__);
	return 0;
}


static struct file_operations led_drv = {
	.owner = THIS_MODULE,
	.open = led_drv_open,
	.read = led_drv_read,
	.write = led_drv_write,
	.release = led_drv_close,
};


static const struct of_device_id myleds[] = {
	{ .compatible = "myled,led_drv"},
	{ },
};


static int chip_demoo_gpio_probe(struct platform_device *pdev)
{
	led_gpio = gpiod_get(&pdev->dev, "myled", 0);
	if(IS_ERR(led_gpio)) {
		dev_err(&pdev->dev, "Failed to get GPIO for led\n");
		return PTR_ERR(led_gpio);
	}

	major = register_chrdev(0, "myled", &led_drv);
	led_class = class_create(THIS_MODULE, "led_class");
	if(IS_ERR(led_class)) {
		unregister_chrdev(major, "myled");	
		gpiod_put(led_gpio);
		printk(KERN_WARNING "class create failed\n");
		return PTR_ERR(led_class);
	}

	device_create(led_class, NULL, MKDEV(major, 0), NULL, "myled%d", 0);

	return 0;
}

static int chip_demoo_gpio_remove(struct platform_device *pdev)
{
	device_destroy(led_class, MKDEV(major, 0));
	class_destroy(led_class); 
	unregister_chrdev(major, "myled");	
	gpiod_put(led_gpio);
	return 0;
}

static struct platform_driver chip_demoo_gpio_driver = {
	.probe    = chip_demoo_gpio_probe,
	.remove   = chip_demoo_gpio_remove,
	.driver   = {
		.name = "myled",
		.of_match_table = myleds,
	},
};

static int __init led_drv_init(void)
{
	int err;
	err = platform_driver_register(&chip_demoo_gpio_driver);

	printk("%s %sled_drv_init\n", __FILE__, __FUNCTION__);
	return 0;
}

static void __exit led_drv_exit(void)
{
	printk("%s %sled_drv_exit\n", __FILE__, __FUNCTION__);

	platform_driver_unregister(&chip_demoo_gpio_driver);
}

module_init(led_drv_init);
module_exit(led_drv_exit);
MODULE_LICENSE("GPL");
MODULE_AUTHOR("chen");

设备树配置：

/{
    myled {
        compatible = "myled,led_drv";
        label = "myled:yellow:user";
        myled-gpio = <&gpio8 2 GPIO_ACTIVE_LOW>;
        pinctrl-names = "default";
        pinctrl-0 = <&my_led>;
    };

&pinctrl {
    myled {
        my_led: my-led {
            rockchip,pins = <8 2 RK_FUNC_GPIO &pcfg_pull_none>;
        };
    };
};

}

在rk3288上，黄灯就能操作了