本文介绍Linux内核中输入设备及RTC设备驱动的设计与实现。详细分析了输入设备驱动的分层结构、API使用方法及GPIO按键驱动的具体实现过程。同时，深入探讨了RTC设备驱动的通用层与底层实现细节。
输入设备驱动
输入设备（如按键、键盘、触摸屏、鼠标等）是典型的字符设备，其一般的工作机理是底层在按键、触摸等动作发送时产生一个中断（或驱动通过timer 定时查询），然后CPU通过SPI、I2 C或外部存储器总线读取键值、坐标等数据，放入1个缓冲区，字符设备驱动管理该缓冲区，而驱动的read()接口让用户可以读取键值、坐标等数据。
|
|
图2 Linux输入设备驱动的分层 输入核心提供了底层输入设备驱动程序所需的API，如分配/释放一个输入设备： struct input_dev *input_allocate_device(void); void input_free_device(struct input_dev *dev); input_allocate_device()返回的是1个input_dev的结构体，此结构体用于表征1个输入设备。 注册/注销输入设备用的如下接口： int __must_check input_register_device(struct input_dev *); void input_unregister_device(struct input_dev *); 报告输入事件用的如下接口： /* 报告指定type、code的输入事件 */ void input_event(struct input_dev *dev, unsigned int type, unsigned int code, int value); /* 报告键值 */ void input_report_key(struct input_dev *dev, unsigned int code, int value); /* 报告相对坐标 */ void input_report_rel(struct input_dev *dev, unsigned int code, int value); /* 报告绝对坐标 */ void input_report_abs(struct input_dev *dev, unsigned int code, int value); /* 报告同步事件 */ void input_sync(struct input_dev *dev); 而所有的输入事件，内核都用统一的数据结构来描述，这个数据结构是input_event，形如代码清单7。 代码清单7 input_event结构体 1 struct input_event { 2 struct timeval time; 3 __u16 type; 4 __u16 code; 5 __s32 value; 6 }; drivers/input/keyboard/gpio_keys.c基于input架构实现了一个通用的GPIO按键驱动。该驱动基于 platform_driver架构，名为“gpio-keys”。它将硬件相关的信息（如使用的GPIO号，电平等）屏蔽在板文件 platform_device的platform_data中，因此该驱动可应用于各个处理器，具有良好的跨平台性。代码清单8列出了该驱动的 probe()函数。 代码清单8 GPIO按键驱动的probe()函数 1 static int __devinit gpio_keys_probe(struct platform_device *pdev) 2 { 3 struct gpio_keys_platform_data *pdata = pdev->dev.platform_data; 4 struct gpio_keys_drvdata *ddata; 5 struct input_dev *input; 6 int i, error; 7 int wakeup = 0; 8 9 ddata = kzalloc(sizeof(struct gpio_keys_drvdata) + 10 pdata->nbuttons * sizeof(struct gpio_button_data), 11 GFP_KERNEL); 12 input = input_allocate_device(); 13 if (!ddata || !input) { 14 error = -ENOMEM; 15 goto fail1; 16 } 17 18 platform_set_drvdata(pdev, ddata); 19 20 input->name = pdev->name; 21 input->phys = "gpio-keys/input0"; 22 input->dev.parent = &pdev->dev; 23 24 input->id.bustype = BUS_HOST; 25 input->id.vendor = 0x0001; 26 input->id.product = 0x0001; 27 input->id.version = 0x0100; 28 29 ddata->input = input; 30 31 for (i = 0; i < pdata->nbuttons; i++) { 32 struct gpio_keys_button *button = &pdata->buttons[i]; 33 struct gpio_button_data *bdata = &ddata->data[i]; 34 int irq; 35 unsigned int type = button->type ?: EV_KEY; 36 37 bdata->input = input; 38 bdata->button = button; 39 setup_timer(&bdata->timer, 40 gpio_check_button, (unsigned long)bdata); 41 42 ... 43 error = request_irq(irq, gpio_keys_isr, 44 IRQF_SAMPLE_RANDOM | IRQF_TRIGGER_RISING | 45 IRQF_TRIGGER_FALLING, 46 button->desc ? button->desc : "gpio_keys", 47 bdata); 48 if (error) { 49 ... 50 } 51 52 if (button->wakeup) 53 wakeup = 1; 54 55 input_set_capability(input, type, button->code); 56 } 57 58 error = input_register_device(input); 59 if (error) { 60 pr_err("gpio-keys: Unable to register input device, " 61 "error: %d/n", error); 62 goto fail2; 63 } 64 65 device_init_wakeup(&pdev->dev, wakeup); 66 67 return 0; 68 ... 69 } 上述代码的第12行分配了1个输入设备，第20~27行初始化了该input_dev的一些属性，第58行注册了这个输入设备。第31~56行则申请了此GPIO按键设备需要的中断号，并初始化了timer。第55行设置此输入设备可告知的事情。 在注册输入设备后，底层输入设备驱动的核心工作只剩下在按键、触摸等人为动作发生的时候，报告事件。代码清单9列出了GPIO按键中断发生时的事件报告代码。 代码清单9 GPIO按键中断发生时的事件报告 1 static void gpio_keys_report_event(struct gpio_button_data *bdata) 2 { 3 struct gpio_keys_button *button = bdata->button; 4 struct input_dev *input = bdata->input; 5 unsigned int type = button->type ?: EV_KEY; 6 int state = (gpio_get_value(button->gpio) ? 1 : 0) ^ button->active_low; 7 8 input_event(input, type, button->code, !!state); 9 input_sync(input); 10 } 11 12 static irqreturn_t gpio_keys_isr(int irq, void *dev_id) 13 { 14 struct gpio_button_data *bdata = dev_id; 15 struct gpio_keys_button *button = bdata->button; 16 17 BUG_ON(irq != gpio_to_irq(button->gpio)); 18 19 if (button->debounce_interval) 20 mod_timer(&bdata->timer, 21 jiffies + msecs_to_jiffies(button->debounce_interval)); 22 else 23 gpio_keys_report_event(bdata); 24 25 return IRQ_HANDLED; 26 } 第8行是报告键值，而第9行是1个同步事件，暗示前面报告的消息属于1个消息组。譬如用户在报告完X坐标后，又报告Y坐标，之后报告1个同步事件，应用程序即可知道前面报告的X、Y这2个事件属于1组，它会将2者联合起来形成1个（X,Y）的坐标。 代码清单8第2行获取platform_data，而platform_data实际上是定义GPIO按键硬件信息的数组，第31行的for循环工具这些信息申请GPIO并初始化中断，对于LDD6140电路板而言，这些信息如代码清单10。 代码清单10 LDD6410开发板GPIO按键的platform_data 1 static struct gpio_keys_button ldd6410_buttons[] = {
2 { 3 .gpio = S3C64XX_GPN(0), 4 .code = KEY_DOWN, 5 .desc = "Down", 6 .active_low = 1, 7 }, 8 { 9 .gpio = S3C64XX_GPN(1), 10 .code = KEY_ENTER, 11 .desc = "Enter", 12 .active_low = 1, 13 .wakeup = 1, 14 }, 15 { 16 .gpio = S3C64XX_GPN(2), 17 .code = KEY_HOME, 18 .desc = "Home", 19 .active_low = 1, 20 }, 21 { 22 .gpio = S3C64XX_GPN(3), 23 .code = KEY_POWER, 24 .desc = "Power", 25 .active_low = 1, 26 .wakeup = 1, 27 }, 28 { 29 .gpio = S3C64XX_GPN(4), 30 .code = KEY_TAB, 31 .desc = "Tab", 32 .active_low = 1, 33 }, 34 { 35 .gpio = S3C64XX_GPN(5), 36 .code = KEY_MENU, 37 .desc = "Menu", 38 .active_low = 1, 39 }, 40 }; 41 42 static struct gpio_keys_platform_data ldd6410_button_data = { 43 .buttons = ldd6410_buttons, 44 .nbuttons = ARRAY_SIZE(ldd6410_buttons), 45 }; 46 47 static struct platform_device ldd6410_device_button = { 48 .name = "gpio-keys", 49 .id = -1, 50 .dev = { 51 .platform_data = &ldd6410_button_data, 52 } 53 };
关于Input设备，说明： （1）ls -l /dev/input，得到设备名称和属性，注意此处没有input号这种Input层分配的内容，以event为主。如： # ls -l /dev/input 如果这么些设备中无法确认哪个是目前在用的设备？可以采用这种方式：cat他们，然后操作鼠标或者键盘，哪个输出乱码就是用的哪个。 （2）cat /proc/bus/input/devices，主要信息是： N: Name="s3c-keypad-rev0000" N: Name="S3C TouchScreen" N: Name="ADXL34x accelerometer" 分配的Input节点全在Sysfs上，真正的设备dev在Handlers上。 （3）ls -l /sys/class/input，类设备信息： drwxr-xr-x root root 1970-01-01 00:00 mice
crw-rw---- root input 13, 66 1970-01-01 00:00 event2
crw-rw---- root input 13, 33 1970-01-01 00:00 mouse1
crwxrwxrwx root input 13, 65 1970-01-01 00:00 event1
crw-rw---- root input 13, 32 1970-01-01 00:00 mouse0
crw-rw---- root input 13, 64 1970-01-01 00:00 event0
crw-rw---- root input 13, 63 1970-01-01 00:00 mice
P: Phys=s3c-keypad/input0
S: Sysfs=/class/input/input0
H: Handlers=kbd event0
P: Phys=input(ts)
S: Sysfs=/class/input/input1
U: Uniq=
H: Handlers=kbd mouse0 event1
P: Phys=1-0053/input0
S: Sysfs=/class/input/input2
U: Uniq=
H: Handlers=mouse1 event2
drwxr-xr-x root root 1970-01-01 00:00 input0
lrwxrwxrwx root root 1970-01-01 00:04 event0 -> input0/event0
drwxr-xr-x root root 1970-01-01 00:00 input1
lrwxrwxrwx root root 1970-01-01 00:04 mouse0 -> input1/mouse0
lrwxrwxrwx root root 1970-01-01 00:04 event1 -> input1/event1
drwxr-xr-x root root 1970-01-01 00:00 input2
lrwxrwxrwx root root 1970-01-01 00:04 mouse1 -> input2/mouse1
lrwxrwxrwx root root 1970-01-01 00:04 event2 -> input2/event2
1.3 RTC设备驱动
RTC（实时钟）借助电池供电，在系统掉电的情况下依然可以行走。它通常还具有产生周期中断以及产生闹钟（alarm）中断的能力，是一种典型的字符设备。作为一种字符设备驱动，RTC需要有file_operations中接口函数的实现，如open()、release()、read()、 poll()、ioctl()等，而典型的IOCTL包括RTC_SET_TIME、RTC_ALM_READ、RTC_ALM_SET、 RTC_IRQP_SET、RTC_IRQP_READ等，这些对于所有的RTC是通用的，只有底层的具体实现是设备相关的。
因此，drivers/rtc/rtc-dev.c实现了RTC驱动通用的字符设备驱动层，它实现了file_opearations的成员函数以及一些关于RTC的通用的控制代码，并向底层导出rtc_device_register()、rtc_device_unregister()用于注册和注销RTC；导出rtc_class_ops结构体用于描述底层的RTC硬件操作。这一RTC通用层实现的结果是，底层的RTC驱动不再需要关心RTC 作为字符设备驱动的具体实现，也无需关心一些通用的RTC控制逻辑，图3表明了这种关系。
图3 Linux RTC设备驱动的分层
drivers/rtc/rtc-s3c.c实现了S3C6410的RTC驱动，其注册RTC以及绑定的rtc_class_ops的代码如代码清单11。
代码清单11 S3C6410 RTC驱动的rtc_class_ops实例与RTC注册
1 static const struct rtc_class_ops s3c_rtcops = {
2 .open = s3c_rtc_open,
3 .release = s3c_rtc_release,
4 .ioctl = s3c_rtc_ioctl,
5 .read_time = s3c_rtc_gettime,
6 .set_time = s3c_rtc_settime,
7 .read_alarm = s3c_rtc_getalarm,
8 .set_alarm = s3c_rtc_setalarm,
9 .irq_set_freq = s3c_rtc_setfreq,
10 .irq_set_state = s3c_rtc_setpie,
11 .proc = s3c_rtc_proc,
12 };
13
14 static int s3c_rtc_probe(struct platform_device *pdev)
15 {
16 ...
17 rtc = rtc_device_register("s3c", &pdev->dev, &s3c_rtcops,
18 THIS_MODULE);
19 ...
20 }
扫一扫
1167
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
