1 /* 代码作者为广州友善之臂公司，我只是在自己的学习过程中加入了注释
2 * 如需转载，敬请注明出处:
www.imganquan.org 3 * 如果您发现了什么错误，请您及时通知我改正，联系方式为
imganquan@gmail.com 4 * 2009.08.25
5 * */
6 #include <linux/module.h>
7 #include <linux/kernel.h>
8 #include <linux/fs.h>
9 #include <linux/init.h>
10 #include <linux/delay.h>
11 #include <linux/poll.h>
12 #include <linux/irq.h>
13 #include <asm/irq.h>
14 #include <linux/interrupt.h>
15 #include <asm/uaccess.h>
16 #include <mach/regs-gpio.h>
17 #include <mach/hardware.h>
18 #include <linux/platform_device.h>
19 #include <linux/cdev.h>
20 #include <linux/miscdevice.h>
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
.irq < 0) { /* 这里应该是为QQ2440写的 */
106 continue;
107 }
108 /* request_irq完成两个功能： 1.申请中断号 2.注册中断处理函数 */
109 err = request_irq(button_irqs.irq, /* 申请的中断号 */
110 buttons_interrupt, /* 中断处理函数 */
111 IRQ_TYPE_EDGE_BOTH, /* 设置中断信号线状态 */
112 button_irqs.name, /* 申请中断的设备名 */
113 (void *)&button_irqs); /* 用来识别哪个设备产生中断 */
114 if (err) /* 申请中断号出错，退出循环 */
115 break;
116 }
117
118 if (err) { /* 出错则释放已经申请成功的中断号 */
119 i--;
120 for (; i >= 0; i--) {
121 if (button_irqs.irq < 0) {
122 continue;
123 }
124 disable_irq(button_irqs.irq); /* 禁用中断信号线 */
125 free_irq(button_irqs.irq, (void *)&button_irqs); /* 释放中断号，并且注销中断处理函数 */
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.irq < 0) { /* 这里应该是QQ2440用的 */
141 continue;
142 }
143 /* 释放中断号，并且注销中断处理函数 */
144 free_irq(button_irqs.irq, (void *)&button_irqs);
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."); /* 作者信息 */
