嵌入式开发按键中断代码注释，韦东山第十二课third_drv

按键中断代码注释

//相关按键中断驱动代码

#include <linux/module.h>
#include <linux/kernel.h>
#include <linux/fs.h>
#include <linux/init.h>
#include <linux/delay.h>
#include <linux/irq.h>
#include <asm/uaccess.h>
#include <asm/irq.h>
#include <asm/io.h>
#include <asm/arch/regs-gpio.h>
#include <asm/hardware.h>


static struct class *thirddrv_class;//类   加载模块时，自动创建文件设备
static struct class_device	*thirddrv_class_dev;//类下面设备

//定义几个寄存器
volatile unsigned long *gpfcon;//IO口配置寄存器
volatile unsigned long *gpfdat;//IO口数据寄存器

volatile unsigned long *gpgcon;
volatile unsigned long *gpgdat;


static DECLARE_WAIT_QUEUE_HEAD(button_waitq);

/* 中断事件标志, 中断服务程序将它置1，third_drv_read将它清0 */
static volatile int ev_press = 0;//判断是否唤醒进程的标志参数

//引脚相关结构体
struct pin_desc{
	unsigned int pin;
	unsigned int key_val;
};


/* 键值: 按下时, 0x01, 0x02, 0x03, 0x04 */
/* 键值: 松开时, 0x81, 0x82, 0x83, 0x84 */
static unsigned char key_val;

struct pin_desc pins_desc[4] = {//引脚相关结构体，FL2440按键IO实例化
	{S3C2410_GPF0, 0x01},
	{S3C2410_GPF2, 0x02},
	{S3C2410_GPG3, 0x03},
	{S3C2410_GPG11, 0x04},
};


/*
  * 确定按键值
  */
static irqreturn_t buttons_irq(int irq, void *dev_id)//按键中断服务函数
{
	struct pin_desc * pindesc = (struct pin_desc *)dev_id;//引脚相关结构体参数传入，中断request_irq内核函数传入
	unsigned int pinval;//按键引脚状态
	
	pinval = s3c2410_gpio_getpin(pindesc->pin);//获得按键引脚电平

	if (pinval)//根据高低电平返回不同的键值
	{
		/* 松开 */
		key_val = 0x80 | pindesc->key_val;
	}
	else
	{
		/* 按下 */
		key_val = pindesc->key_val;
	}

    ev_press = 1; //  进程唤醒参数               /* 表示中断发生了 */
    wake_up_interruptible(&button_waitq);  //唤醒睡眠的read进程 /* 唤醒休眠的进程 */

	
	return IRQ_RETVAL(IRQ_HANDLED);
}

static int third_drv_open(struct inode *inode, struct file *file)//打开驱动设备文件
{
	/* 配置GPF0,2为输入引脚 */
	/* 配置GPG3,11为输入引脚 */
	request_irq(IRQ_EINT0,  buttons_irq, IRQT_BOTHEDGE, "S2", &pins_desc[0]);//linux驱动中断设置函数，十分重要，设置中断号，中断引脚，中断服务程序，及中断触发方式，名称。需要查看按键原理图，0、2设置为上升沿触发，3、4设置为上升沿下降沿都触发。
	request_irq(IRQ_EINT2,  buttons_irq, IRQT_BOTHEDGE, "S3", &pins_desc[1]);
	request_irq(IRQ_EINT11, buttons_irq, IRQT_BOTHEDGE, "S4", &pins_desc[2]);
	request_irq(IRQ_EINT19, buttons_irq, IRQT_BOTHEDGE, "S5", &pins_desc[3]);	

	return 0;
}

ssize_t third_drv_read(struct file *file, char __user *buf, size_t size, loff_t *ppos)
{
	if (size != 1)//只读一个状态，传入的
		return -EINVAL;

	/* 如果没有按键动作, 休眠 */
	wait_event_interruptible(button_waitq, ev_press);//如果ev_press为0，则进程进入休眠状态
        
        /* 如果有按键动作, 返回键值 */
        copy_to_user(buf, &keyval, 1);//当中断发生时，ev_press=1，唤醒进程。将按键键值返回用户空间
        ev_press=0;//设置参数归0

	
	return 1;
}


int third_drv_close(struct inode *inode, struct file *file)//关闭中断，释放中断引脚资源
{
	free_irq(IRQ_EINT0, &pins_desc[0]);
	free_irq(IRQ_EINT2, &pins_desc[1]);
	free_irq(IRQ_EINT11, &pins_desc[2]);
	free_irq(IRQ_EINT19, &pins_desc[3]);
	return 0;
}

//定义一个结构体
static struct file_operations sencod_drv_fops = {
    .owner   =  THIS_MODULE,    /* 这是一个宏，推向编译模块时自动创建的__this_module变量 */
    .open    =  third_drv_open,  //.open指向third_drv_open   
	.read	 =	third_drv_read,	   
	.release =  third_drv_close,	   
};

///应用程序和驱动程序通过类型和设备号对应起来
int major;//定义全局变量major
static int third_drv_init(void)//入口函数，向内核注册模块
{
	major = register_chrdev(0, "third_drv", &sencod_drv_fops);//把上面结构体放内核数组里的名为0的third_drv里

	thirddrv_class = class_create(THIS_MODULE, "third_drv");

	thirddrv_class_dev = class_device_create(thirddrv_class, NULL, MKDEV(major, 0), NULL, "buttons"); /* /dev/buttons *///创建设备

	gpfcon = (volatile unsigned long *)ioremap(0x56000050, 16);//物理地址映射成虚拟地址，物理地址：0x56000050，长度：16
	gpfdat = gpfcon + 1;

	gpgcon = (volatile unsigned long *)ioremap(0x56000060, 16);
	gpgdat = gpgcon + 1;

	return 0;
}

static void third_drv_exit(void)//出口函数，从内核卸载模块
{
	unregister_chrdev(major, "third_drv");//卸载驱动
	class_device_unregister(thirddrv_class_dev);//修饰一下
	class_destroy(thirddrv_class);
	iounmap(gpfcon);//去掉映射
	iounmap(gpgcon);
	return 0;
}

//修饰模块
module_init(third_drv_init);

module_exit(third_drv_exit);

MODULE_LICENSE("GPL");