声明:本文章是看完韦东山老师的usb鼠标驱动视频所写的关于usb鼠标的驱动,因此如果有相关内容与其他网友相同,敬请原谅。同时我还是想说本文只是总结自己的学习所得,同时也将自己所学到的知识写下来,所以如果这篇文章对你有帮助,那是我的荣幸。
在介绍驱动程序前我想向大家介绍一下usb_bus_type(usb总线驱动类),内核中有不同的总线类型,不同的总线有不同的匹配方式,如我们前面所学的platform_bus_type是使用名字来匹配的,而这里要讲的
usb_bus_type的匹配是通过id_table来匹配的,但是各种总线的匹配流程大致还是一样的。
因为要想将设备和驱动通过总线连接起来就不可避免的用到了match函数。就像你要相亲你就要将你的要求都写出来,而女方也要将自己对另一半的要求写出来,然后你们双方都把各自的请求交给婚介所,而婚介所所做的事就是将你的要求与每一个女士的请求进行比较,注意这里就用到了比较(match),当他们发现有一个女士满足你的要求,而你也正好满足这个女士的要求时,他就会对你说“给你匹配到了合适的女士”,而同时他也会对那位女士说“给你匹配到了合适的男士”,然后就安排你们相亲了。而我们的总线——设备——驱动模型就类似这个相亲模型。其中你是设备,那些女士是驱动,而婚介所就是总线了。
有了上面的例子,我们结合这个例子分析一下这个匹配流程:
上面这幅图就将,usb_bus_type的框架大致描绘出来了,下面我们详细的说一下。如上图所示,总线模型的最主要部分就是位于上层的总线,总线中有一个match函数,他会将通过usb_new_device向上注册的usb_interface和通过usb_register向上注册的usb_driver中的id_table一一比较(
这个过程就类似于你和那些女士分别向婚介所投递个人信息),当发现设备和驱动匹配时,他就会调用的driver中的probe函数(
这就相当于当发现你与其中一位女士匹配时就会通知你们相亲)。很多朋友可能会问“
两个人相亲他们匹配的可能是性格,三观,收入等等,而设备和驱动他们匹配的是什么那?”,我们说了,不同的总线类型匹配的标准不一样,但总要有个可以匹配的吧。是的,
在usb总线类型中,我们匹配的是id_table,可能很多人会问可以讲的细点吗?
就像你说的相亲的时候匹配三观,可三观太大了,可以细分一下吗?,这个是可以的我们打开id_table的代码就会发现有:
static struct usb_device_id usb_mouse_id_table [] = {
{ USB_INTERFACE_INFO(USB_INTERFACE_CLASS_HID, USB_INTERFACE_SUBCLASS_BOOT,
USB_INTERFACE_PROTOCOL_MOUSE) },
{ } /* Terminating entry */
};
#define USB_INTERFACE_INFO(cl,sc,pr)
.match_flags = USB_DEVICE_ID_MATCH_INT_INFO, .bInterfaceClass = (cl),
.bInterfaceSubClass = (sc), .bInterfaceProtocol = (pr)
上面就是详细的比较类型了,他们有接口类,接口子类,以及接口协议,三部分组成。不过你还可以加附加条件比如:
{USB_DEVICE(设备ID,产品ID)},
这样就可以在原有的基础上缩小范围了。
而具体的代码描述为:
在hub.c的hub_port_connect_change函数中,有udev = usb_alloc_dev(hdev, hdev->bus, port1);而usb_alloc_dev就是分配一个设备结构体,而这个设备中都分配了什么那?我们可以进去看一下,我们可以在usb_alloc_dev函数中看到这样的代码:
dev->dev.bus = &usb_bus_type;
这行代码就定义了usb_bus_type,那么我们进去看看这个总线中又定义了什么:
struct bus_type usb_bus_type = {
.name = "usb",
.match = usb_device_match, //非常重要的match函数
.uevent = usb_uevent,
.suspend = usb_suspend,
.resume = usb_resume,
};
我们可以从中看到一个match函数,我们在前面说过,虽然不同的总线他们匹配的数据可能不一样,但是他们的大致过程是一样的。下面我们进入usb_device_match函数中:
static int usb_device_match(struct device *dev, struct device_driver *drv)
intf = to_usb_interface(dev);
usb_drv = to_usb_driver(drv);
id = usb_match_id(intf, usb_drv->id_table);
通过上面的代码我们就可以知道他们所匹配的是dev的信息和id_table的 信息。
有了上面的了解,我们现在来写一个简单的usb鼠标驱动,我们的目标是:当按下左键时上报按键L,当按下右键时上报S,中键ENTRR。
从上面的目标可以看出我们需要用到输入子系统来上报按键。从usb_bus_type中我们知道usb的总线和设备部分已经写好,而我们可以做的就是写出驱动程序,下面我们开始写驱动程序。与其他的驱动程序一样,我们还是先搭好这个驱动程序的框架,然后在向其中填入想要做的事情的代码,而usb驱动的框架为:
1.分配/设置usb_driver结构体
2.在入口函数中注册这个结构体,在出口函数中注销这个结构体
而详细的代码为:
static struct usb_driver usb_mouse_drv = { /* 分配设置usb_driver结构体 */
.name = "usbmouse",
.probe = usb_mouse_probe,
.disconnect = usb_mouse_disconnect,
.id_table = usb_mouse_id_table,
};
int usb_drv_init(void)
{
usb_register(&usb_mouse_drv); /* 注册usb_driver结构体 */
return 0;
}
void usb_drv_exit(void)
{
usb_deregister(&usb_mouse_drv);/* 注销usb_driver结构体 */
}
通过上面的代码我们可以看出,usb_driver结构体中有id_table(用于匹配设备),probe函数(当匹配成功时调用),disconnect函数(当匹配的设备离开时调用),注意:这三个是必不可少的。而其他的选项则是可以选择的。在上面我已经说过id_table了。所以这里并不详细说,只是介绍一下他的内容,代码如下:
static struct usb_device_id usb_mouse_id_table [] = {
{ USB_INTERFACE_INFO(USB_INTERFACE_CLASS_HID, USB_INTERFACE_SUBCLASS_BOOT,
USB_INTERFACE_PROTOCOL_MOUSE) },
{ } /* Terminating entry */
};
而其中USB_INTERFACE_INFO是一个宏:
/**
* USB_INTERFACE_INFO - macro used to describe a class of usb interfaces
* @cl: bInterfaceClass value
* @sc: bInterfaceSubClass value
* @pr: bInterfaceProtocol value
*
* This macro is used to create a struct usb_device_id that matches a
* specific class of interfaces.
*/
#define USB_INTERFACE_INFO(cl,sc,pr)
.match_flags = USB_DEVICE_ID_MATCH_INT_INFO, .bInterfaceClass = (cl),
.bInterfaceSubClass = (sc), .bInterfaceProtocol = (pr)
通过介绍上面的注解可以看出,他提供的是 接口类,接口子类,和接口协议。所以你可以提供相应的这三项来进行匹配。同时如果你对厂家ID和设备ID有其他的要求也可以通过id_table中的USB_DEVICE选项设置。
写好id_table 后设备就可以与驱动程序进行匹配了,那么我们接下来就应该写匹配成功后要进入的probe函数了。
那么进入probe后我们应该干什么那?我们要想一下自己的目的是通过按下鼠标实现按键功能,既然是按键功能就要用到输入子系统了,那么输入子系统的框架又是什么那?
1.分配 input_dev结构体
2.设置input_dev结构体
3.注册input_dev结构体
4.硬件相关的操作
此处硬件相关的操作与以往不同,以前的按键,触摸屏是通过读寄存器或者ADC值,而现在的硬件相关操作是在usb驱动框架中的操作,所以此处应当由usb总线驱动提供usb读写函数来进行数据传输。
下面是probe函数的代码:
int usb_mouse_probe (struct usb_interface *intf,
const struct usb_device_id *id)
{
struct usb_device *dev = interface_to_usbdev(intf);
struct usb_host_interface *interface;
struct usb_endpoint_descriptor *endpoint;
interface = intf->cur_altsetting;
endpoint = &interface->endpoint[0].desc;
/*1 分配一个input_dev结构体 */
uk_dev = input_allocate_device();
/*2 设置 */
/*2.1 产生哪类事件 */
set_bit(EV_KEY,uk_dev->evbit); //产生按键类事件
set_bit(EV_REP,uk_dev->evbit); //产生重复类事件
/*2.2 产生这类事件中的那个 */
set_bit(KEY_L,uk_dev->keybit); //按键类中的按键L
set_bit(KEY_S,uk_dev->keybit); //按键类中的按键S
set_bit(KEY_ENTER,uk_dev->keybit); //按键类中的按键ENTER
/*3 注册 */
input_register_device(uk_dev);
/*4 硬件相关设置:通过使用USB设备总线获取读写函数 */
/* 数据传输三要素:源,目的,长度 */
/* 源:USB设备的某个端点 */
pipe = usb_rcvintpipe(dev, endpoint->bEndpointAddress);
/* 长度 */
len = endpoint->wMaxPacketSize;
/* 目的: */
usb_buf = usb_buffer_alloc(dev,len,GFP_KERNEL,&usb_buf_phys);
/* 使用三要素 */
/* 分配一个urb(USB request block) */
uk_urb = usb_alloc_urb(0,GFP_KERNEL);
/* 设置使用urb */
usb_fill_int_urb(uk_urb, dev, pipe, usb_buf,
len,
usb_mouse_irq, NULL, endpoint->bInterval);
uk_urb->transfer_dma = usb_buf_phys;
uk_urb->transfer_flags |= URB_NO_TRANSFER_DMA_MAP;
/* 使用urb */
usb_submit_urb(uk_urb,GFP_KERNEL);
return 0;
}
上面的程序已经说明了input_dev的框架,只是有些同学可能会问这代码中的第四部分是怎么回事?
这就要介绍另一个非常有用的结构体
USB请求块(USB request block,URB),URB是USB设备驱动中用来描述与USB设备通信所用的基本载体和核心数据结构,与网络设备驱动中的sk_buff结构体类似,是USB主机与设备之间传输数据的封装。
一个urb包含了执行usb传输所需要的所有信息。当要进行
数据传输时,需要分配一个urb结构体,对其进行初始化,然后将其提交给usb核心。
USB核心对urb进行解析,将控制信息提交给主机控制器,由主机控制器负责数据到设备的传输。这时,驱动程序只需等待,当数据回传到主机控制器后,会转发给USB核心,唤醒等待的驱动程序,由驱动程序完成剩下的工作。
更为具体地说,Linux中的设备驱动程序只要为每一次请求准备一个urb结构体,然后把它填充好,就可以调用函数usb_submit_urb()提交给USB核心。然后USB核心将urb传递给USB主机控制器,最终传递给USB设备。USB设备获得urb结构体后,会解析这个结构体,并以相反的路线将数据返回给
Linux内核。
注:上面的描述是从百度百科抄来的,我看他写的比较简单就抄下来分享给大家了。
写完这些我们就应该完成usb_fill_int_urb函数中的usb_mouse_irq函数了,也许有些朋友可能会问这是中断函数吗?我的回答是这是中断函数,只不过这是主机控制器产生的中断而不是从机设备:
像上面这个示意图一样,主机控制器不断的查询usb设备获得数据后将数据放入buffer中,然后主机控制器就会产生一个中断从而使是上面的这个usb_mouse_irq函数被调用。
而在usb_mouse_irq函数中要做的就是将将获得的按键值上报:
static void usb_mouse_irq(struct urb *urb)
{
static unsigned char pre_val;
if((pre_val & (1<<0)) != (usb_buf[0] & (1<<0))){
/* 左键发生了变化 */
input_event(uk_dev,EV_KEY,KEY_L,usb_buf[0] & (1<<0) ? 1 : 0);
input_sync(uk_dev);
}
if((pre_val & (1<<1)) != (usb_buf[0] & (1<<1))){
/* 右键发生了变化 */
input_event(uk_dev,EV_KEY,KEY_S,usb_buf[0] & (1<<1) ? 1 : 0);
input_sync(uk_dev);
}
if((pre_val & (1<<2)) != (usb_buf[0] & (1<<2))){
/* 中键发生了变化 */
input_event(uk_dev,EV_KEY,KEY_ENTER,usb_buf[0] & (1<<2) ? 1 : 0);
input_sync(uk_dev);
}
pre_val = usb_buf[0];
/* 从新提交urb */
usb_submit_urb(uk_urb,GFP_KERNEL);
}
上面就是这个驱动的主要部分了,但是当设备离开时会调用相应的disconnect函数,下面我们来写disconcert函数:
void usb_mouse_disconnect(struct usb_interface *intf)
{
struct usb_device *dev = interface_to_usbdev(intf);
usb_kill_urb(uk_urb);
usb_free_urb(uk_urb);
usb_buffer_free(dev,len, usb_buf, usb_buf_phys);
input_unregister_device(uk_dev);
input_free_device(uk_dev);
}
完成disconnect函数,这个驱动程序就算完成了。
而这里还有几篇文章是我参考过得:
ARM-Linux开发之USB驱动鼠标控制 :这篇文章也是按韦东山老师的方式所写的驱动
嵌入式Linux USB驱动开发之教你一步步编写USB驱动程序
嵌入式linux下usb驱动开发方法--看完少走弯路 :这篇文章虽然文字不多,对学习usb驱动的很有帮助
嵌入式Linux驱动学习之路(二十)USB设备驱动:这篇文章是对老师上课内容的总结,并有完整的代码
:这篇文章是一篇很好的就是usb鼠标的文章。