内核LED驱动程序笔记

        内核驱动程序的开发，一直都是比较难。对于初学者来说，要想一步就可以理解是比较难的，所以一般学习都是从最简单的驱动开始学起，这样一步一步来，由浅入深，循序渐进地学习，是比较好方法。特别是当自己发现可以理解一个驱动的程序代码是如何实现，至少是可以理解它的工作过程时，对自己是有多么大的鼓励和信心。对以后更加深入地学习其它的知识是很有帮助的，下面我们就以最简单的LED驱动为例，结合代码看应该比较容易入手，好开始吧。

       这里的内核版本是Linux-2.6.30.4，基于TQ2440开发板。这个驱动程序是在/driver/char/EmbedSKy_gpio.c文件中：

/*************************************

NAME:EmbedSky_hello.c
COPYRIGHT:www.embedsky.net

*************************************/

#include <linux/miscdevice.h>
#include <linux/delay.h>
#include <asm/irq.h>
#include <mach/regs-gpio.h>
#include <mach/hardware.h>
#include <linux/kernel.h>
#include <linux/module.h>
#include <linux/init.h>
#include <linux/mm.h>
#include <linux/fs.h>
#include <linux/types.h>
#include <linux/delay.h>
#include <linux/moduleparam.h>
#include <linux/slab.h>
#include <linux/errno.h>
#include <linux/ioctl.h>
#include <linux/cdev.h>
#include <linux/string.h>
#include <linux/list.h>
#include <linux/pci.h>
#include <asm/uaccess.h>
#include <asm/atomic.h>
#include <asm/unistd.h>


#define DEVICE_NAME "GPIO-Control"

/* 应用程序执行ioctl(fd, cmd, arg)时的第2个参数 */
#define IOCTL_GPIO_ON	1     //宏定义，表示灯亮
#define IOCTL_GPIO_OFF	0     //宏定义，表示灯灭

                                      /* 用来指定LED所用的GPIO引脚 */
static unsigned long gpio_table [] =
{
	S3C2410_GPB5,    //控制LED的IO口，不同开发板可能会不同，要根据电路原理图来确定
	S3C2410_GPB6,
	S3C2410_GPB7,
	S3C2410_GPB8,
};

/* 用来指定GPIO引脚的功能：输出 */
static unsigned int gpio_cfg_table [] =
{
	S3C2410_GPB5_OUTP,    //通过控制IO口的CON寄存器来配置为输出
	S3C2410_GPB6_OUTP,
	S3C2410_GPB7_OUTP,
	S3C2410_GPB8_OUTP,
};

static int tq2440_gpio_ioctl(struct inode *inode, struct file *file, unsigned int cmd, unsigned long arg) /*应用程序对设备文件/dev/EmbedSKy-leds执行ioctl（）时就会调用EmbedSky_ioctl函数*/
{
	if (arg > 4)
	{
		return -EINVAL;
	}

	switch(cmd)
	{
		case IOCTL_GPIO_ON:
			s3c2410_gpio_setpin(gpio_table[arg], 0);//设定指定引脚的输出电平为0
			return 0;

		case IOCTL_GPIO_OFF:
			
			s3c2410_gpio_setpin(gpio_table[arg], 1);//设定指定引脚输出电平为1
			return 0;

		default:
			return -EINVAL;
	}
}

static struct file_operations dev_fops = {  /*这个结构是字符设备驱动程序的核心，当应用程序操作设备文件时所调用的open,read,write函数时最终都会调用这个结构中指定的对应函数*/
	.owner	=	THIS_MODULE, //这是一个宏，指向编译模块时自动创建的_this_module变量
	.ioctl	=	tq2440_gpio_ioctl,
};

static struct miscdevice misc = {
	.minor = MISC_DYNAMIC_MINOR,  //次设备号，用来区别不同的LED
	.name = DEVICE_NAME,
	.fops = &dev_fops,
};

static int __init dev_init(void)  //初始化函数
{
	int ret;

	int i;
	
	for (i = 0; i < 4; i++)  //控制四个LED灯
	{
		s3c2410_gpio_cfgpin(gpio_table[i], gpio_cfg_table[i]);
		s3c2410_gpio_setpin(gpio_table[i], 0);
	}

	ret = misc_register(&misc);

	printk (DEVICE_NAME" initialized\n");

	return ret;
}

static void __exit dev_exit(void) //释放系统资源
{
	misc_deregister(&misc);
}

module_init(dev_init);  //初始宏，内部含有指向初始化函数的函数指针
module_exit(dev_exit);  //御载宏，内部含有指向御载函数的函数指针，释放模块占用的系统资源

MODULE_LICENSE("GPL");  //授权
MODULE_AUTHOR("www.embedsky.net");
MODULE_DESCRIPTION("GPIO control for EmbedSky SKY2440/TQ2440 Board");