Mini2440 按键驱动程序详解

1 /* 代码作者为广州友善之臂公司，我只是在自己的学习过程中加入了注释
　　 2 * 如需转载，敬请注明出处: www.imganquan.org
　　 3 * 如果您发现了什么错误，请您及时通知我改正，联系方式为imganquan@gmail.com
　　 4 * 2009.08.25
　　 5 * */
　　 6 #include 
　　 7 #include 
　　 8 #include 
　　 9 #include 
　　 10 #include 
　　 11 #include 
　　 12 #include 
　　 13 #include 
　　 14 #include 
　　 15 #include 
　　 16 #include 
　　 17 #include 
　　 18 #include 
　　 19 #include 
　　 20 #include 
　　 21 
　　 22 #define DEVICE_NAME "buttons" /* 设备名称 */
　　 23 
　　 24 struct button_irq_desc { /* 定义描述中断的结构体 */
　　 25 int irq; /* 中断号，中断号唯一表示一个中断 */
　　 26 
　　 27 int pin; /* 中断控制的寄存器
　　 28 * 该寄存器的值由中断引脚设置
　　 29 * 我们希望从该寄存器读出控制信息
　　 30 */
　　 31 
　　 32 int pin_setting; /* 中断的引脚 
　　 33 * 该引脚的电平由按键来控制
　　 34 * 从而最终我们由按键控制了寄存器的值
　　 35 */
　　 36 
　　 37 int number; /* 编号 */
　　 38 char *name; /* 名称 */
　　 39 };
　　 40 
　　 41 #if !defined (CONFIG_QQ2440_BUTTONS)
　　 42 static struct button_irq_desc button_irqs[] = {
　　 43 {IRQ_EINT8, S3C2410_GPG0, S3C2410_GPG0_EINT8, 0, "KEY0"},
　　 44 {IRQ_EINT11, S3C2410_GPG3, S3C2410_GPG3_EINT11, 1, "KEY1"},
　　 45 {IRQ_EINT13, S3C2410_GPG5, S3C2410_GPG5_EINT13, 2, "KEY2"},
　　 46 {IRQ_EINT14, S3C2410_GPG6, S3C2410_GPG6_EINT14, 3, "KEY3"},
　　 47 {IRQ_EINT15, S3C2410_GPG7, S3C2410_GPG7_EINT15, 4, "KEY4"},
　　 48 {IRQ_EINT19, S3C2410_GPG11, S3C2410_GPG11_EINT19, 5, "KEY5"},
　　 49 };
　　 50 #else /* means QQ */
　　 51 static struct button_irq_desc button_irqs[] = {
　　 52 {IRQ_EINT19, S3C2410_GPG11, S3C2410_GPG11_EINT19, 0, "KEY0"},
　　 53 {IRQ_EINT11, S3C2410_GPG3, S3C2410_GPG3_EINT11, 1, "KEY1"},
　　 54 {IRQ_EINT2, S3C2410_GPF2, S3C2410_GPF2_EINT2, 2, "KEY2"},
　　 55 {IRQ_EINT0, S3C2410_GPF0, S3C2410_GPF0_EINT0, 3, "KEY3"},
　　 56 {-1, -1, -1, 4, "KEY4"},
　　 57 {-1, -1, -1, 5, "KEY5"},
　　 58 };
　　 59 #endif
　　 60 
　　 61 /* 开发板上6个按钮的状态 */
　　 62 static volatile char key_values[] = { '0', '0', '0', '0', '0', '0' };
　　 63 
　　 64 static DECLARE_WAIT_QUEUE_HEAD(button_waitq); /* 创建了一个等待队列
　　 65 * 等待队列,是进程调度的一种重要方法
　　 66 * button_waitq表示按键等待的队列
　　 67 * 就是说,按键一按下,就会激活其等待队列里的进程,来做相应的处理
　　 68 * 按键的等待队列,或者说中断所设置的等待队列,
　　 69 * 是中断处理中非常重要的资源,它大大扩展了中断处理的能力
　　 70 * */
　　 71 
　　 72 static volatile int ev_press = 0; /* 用来标记硬件是否可用
　　 73 * 0表示key_values数组不可用
　　 74 * 1表示key_values数组可读可写
　　 75 * */
　　 76 
　　 77 static irqreturn_t buttons_interrupt(int irq, void *dev_id)
　　 78 {
　　 79 struct button_irq_desc *button_irqs = (struct button_irq_desc *)dev_id;
　　 80 int down;
　　 81 
　　 82 // udelay(0);
　　 83 down = !s3c2410_gpio_getpin(button_irqs->pin); /* 获得寄存器的值 */
　　 84 
　　 85 if (down != (key_values[button_irqs->number] & 1)) {/* 状态改变，按钮被按下，从这句可以看出
　　 86 * 当按钮没有被按下的时候，寄存器的值应该是1
　　 87 * 当按钮按在按下的状态，寄存器的值是0 
　　 88 * */
　　 89 
　　 90 key_values[button_irqs->number] = '0' + down; /* 如果key1被按下，则key_value[0]就变成'1' */
　　 91 
　　 92 ev_press = 1; /* 标有数据可读 */
　　 93 wake_up_interruptible(&button_waitq); /* 唤醒等待进程 */
　　 94 }
　　 95 
　　 96 return IRQ_RETVAL(IRQ_HANDLED); /* 这句意思未知 */
　　 97 }
　　 98 
　　 99 static int s3c24xx_buttons_open(struct inode *inode, struct file *file)
　　100 {
　　101 int i;
　　102 int err = 0;
　　103 
　　104 for (i = 0; i < sizeof(button_irqs) / sizeof(button_irqs[0]); i++) {
　　105 if (button_irqs[i].irq < 0) { /* 这里应该是为QQ2440写的 */
　　106 continue;
　　107 }
　　108 /* request_irq完成两个功能： 1.申请中断号 2.注册中断处理函数 */
　　109 err = request_irq(button_irqs[i].irq, /* 申请的中断号 */
　　110 buttons_interrupt, /* 中断处理函数 */
　　111 IRQ_TYPE_EDGE_BOTH, /* 设置中断信号线状态 */
　　112 button_irqs[i].name, /* 申请中断的设备名 */
　　113 (void *)&button_irqs[i]); /* 用来识别哪个设备产生中断 */
　　114 if (err) /* 申请中断号出错，退出循环 */
　　115 break;
　　116 }
　　117 
　　118 if (err) { /* 出错则释放已经申请成功的中断号 */
　　119 i--;
　　120 for (; i >= 0; i--) {
　　121 if (button_irqs[i].irq < 0) {
　　122 continue;
　　123 }
　　124 disable_irq(button_irqs[i].irq); /* 禁用中断信号线 */
　　125 free_irq(button_irqs[i].irq, (void *)&button_irqs[i]); /* 释放中断号，并且注销中断处理函数 */
　　126 }
　　127 return -EBUSY; /* 中断没有注册成功的返回 */
　　128 }
　　129 
　　130 ev_press = 1; /* 注册成功，标记硬件可用，即key_values数组可读可写 */
　　131 
　　132 return 0; /* 正常返回 */
　　133 }
　　134 
　　135 static int s3c24xx_buttons_close(struct inode *inode, struct file *file)
　　136 {
　　137 int i;
　　138 
　　139 for (i = 0; i < sizeof(button_irqs) / sizeof(button_irqs[0]); i++) {
　　140 if (button_irqs[i].irq < 0) { /* 这里应该是QQ2440用的 */
　　141 continue;
　　142 }
　　143 /* 释放中断号，并且注销中断处理函数 */
　　144 free_irq(button_irqs[i].irq, (void *)&button_irqs[i]);
　　145 }
　　146 
　　147 return 0;
　　148 }
　　149 
　　150 static int s3c24xx_buttons_read(struct file *filp, char __user * buff,
　　151 size_t count, loff_t * offp)
　　152 {
　　153 unsigned long err; /* copy_to_user()的返回值 */
　　154 
　　155 if (!ev_press) { /* 标志位是0，无数据 */
　　156 if (filp->f_flags & O_NONBLOCK)
　　157 return -EAGAIN;
　　158 else
　　159 /* 把读进程放入等待队列 */
　　160 wait_event_interruptible(button_waitq, ev_press);
　　161 }
　　162 
　　163 /* 下面的代码处理标志位是1时，即有数据可读 */
　　164 ev_press = 0; /* 把标志位置0 */
　　165 
　　166 /* 把数据拷贝到用户空间 */
　　167 err =
　　168 copy_to_user(buff, (const void *)key_values,
　　169 min(sizeof(key_values), count));
　　170 /* 如果不出错，就返回拷贝到用户空间的字节数 */
　　171 return err ? -EFAULT : min(sizeof(key_values), count);
　　172 }
　　173 
　　174 static unsigned int s3c24xx_buttons_poll(struct file *file,
　　175 struct poll_table_struct *wait)
　　176 {
　　177 unsigned int mask = 0;
　　178 poll_wait(file, &button_waitq, wait); /* 监视等待队列button_waitq，如果ev_press为1，就不再等待 */
　　179 if (ev_press)
　　180 mask |= POLLIN | POLLRDNORM;
　　181 return mask;
　　182 }
　　183 
　　184 /* 驱动对象*/
　　185 static struct file_operations dev_fops = {
　　186 .owner = THIS_MODULE,
　　187 .open = s3c24xx_buttons_open,
　　188 .release = s3c24xx_buttons_close,
　　189 .read = s3c24xx_buttons_read,
　　190 .poll = s3c24xx_buttons_poll,
　　191 };
　　192 
　　193 /* 设备对象*/
　　194 static struct miscdevice misc = {
　　195 .minor = MISC_DYNAMIC_MINOR, /* 动态设备号 */
　　196 .name = DEVICE_NAME, /* 设备名称 */
　　197 .fops = &dev_fops, /* 驱动对象 */
　　198 };
　　199 
　　200 static int __init dev_init(void)
　　201 { /* 设备初始化函数 */
　　202 int ret;
　　203 
　　204 ret = misc_register(&misc); /* 注册设备 */
　　205 
　　206 printk(DEVICE_NAME "/tinitialized/n"); /* dmesg */
　　207 
　　208 return ret;
　　209 }
　　210 
　　211 static void __exit dev_exit(void)
　　212 {
　　213 misc_deregister(&misc); /* 注销设备 */
　　214 }
　　215 
　　216 module_init(dev_init); /* 声明模块加载初始化函数 */
　　217 module_exit(dev_exit); /* 声明卸载模块清除函数 */
　　218 MODULE_LICENSE("GPL"); /* 许可证声明 */
　　219 MODULE_AUTHOR("FriendlyARM Inc."); /* 作者信息 */