Linux USB鼠標(biāo)驅(qū)動(dòng)程序詳解

USB 總線引出兩個(gè)重要的鏈表！

一個(gè) USB 總線引出兩個(gè)重要的鏈表，一個(gè)為 USB 設(shè)備鏈表，一個(gè)為 USB 驅(qū)動(dòng)鏈表。設(shè)備鏈表包含各種系統(tǒng)中的 USB 設(shè)備以及這些設(shè)備的所有接口，驅(qū)動(dòng)鏈表包含 USB 設(shè)備驅(qū)動(dòng)程序（usb device driver）和 USB 驅(qū)動(dòng)程序（usb driver）。

USB 設(shè)備驅(qū)動(dòng)程序（usb device driver）和 USB 驅(qū)動(dòng)程序（usb driver）的區(qū)別是什么？

USB 設(shè)備驅(qū)動(dòng)程序包含 USB 設(shè)備的一些通用特性，將與所有 USB 設(shè)備相匹配。在 USB core 定義了：struct usb_device_driver usb_generic_driver。usb_generic_driver 是 USB 子系統(tǒng)中唯一的一個(gè)設(shè)備驅(qū)動(dòng)程序?qū)ο蟆６?USB 驅(qū)動(dòng)程序則是與接口相匹配，接口是一個(gè)完成特定功能的端點(diǎn)的集合。

設(shè)備是如何添加到設(shè)備鏈表上去的？
在設(shè)備插入 USB 控制器之后，USB core 即會(huì)將設(shè)備在系統(tǒng)中注冊(cè)，添加到 USB 設(shè)備鏈表上去。

USB 設(shè)備驅(qū)動(dòng)程序（usb device driver）是如何添加到驅(qū)動(dòng)鏈表上去的？
在系統(tǒng)啟動(dòng)注冊(cè) USB core 時(shí)，USB 設(shè)備驅(qū)動(dòng)程序即將被注冊(cè)，也就添加到驅(qū)動(dòng)鏈表上去了。

接口是如何添加到設(shè)備鏈表上去的？
在 USB 設(shè)備驅(qū)動(dòng)程序和 USB 設(shè)備的匹配之后，USB core 會(huì)對(duì)設(shè)備進(jìn)行配置，分析設(shè)備的結(jié)構(gòu)之后會(huì)將設(shè)備所有接口都添加到設(shè)備鏈表上去。比如鼠標(biāo)設(shè)備中有一個(gè)接口，USB core 對(duì)鼠標(biāo)設(shè)備配置后，會(huì)將這個(gè)接口添加到設(shè)備鏈表上去。

USB 驅(qū)動(dòng)程序（usb driver）是如何添加到驅(qū)動(dòng)鏈表上去的？
在每個(gè) USB 驅(qū)動(dòng)程序的被注冊(cè)時(shí)，USB 驅(qū)動(dòng)程序即會(huì)添加到驅(qū)動(dòng)鏈表上去。比如鼠標(biāo)驅(qū)動(dòng)程序，usb_mouse_init 函數(shù)將通過(guò) usb_register(&usb_mouse_driver) 將鼠標(biāo)驅(qū)動(dòng)程序注冊(cè)到 USB core 中，然后就添加到驅(qū)動(dòng)鏈表中去了。其中 usb_mouse_driver 是描述鼠標(biāo)驅(qū)動(dòng)程序的結(jié)構(gòu)體。

已配置狀態(tài)（configured status）之后話
當(dāng)鼠標(biāo)的設(shè)備、接口都添加到設(shè)備鏈表，并且鼠標(biāo)驅(qū)動(dòng)程序也添加到驅(qū)動(dòng)鏈表上去了， 系統(tǒng)就進(jìn)入一種叫做已配置（configured）的狀態(tài)。要達(dá)到已配置狀態(tài)，將經(jīng)歷復(fù)雜的過(guò)程，USB core 為 USB 設(shè)備奉獻(xiàn)著無(wú)怨無(wú)悔。在這個(gè)過(guò)程中，系統(tǒng)將會(huì)建立起該設(shè)備的的設(shè)備、配置、接口、設(shè)置、端點(diǎn)的描述信息，它們分別被 usb_device、usb_configuration、usb_interface、usb_host_interface、 usb_host_endpoint 結(jié)構(gòu)體描述。
設(shè)備達(dá)到已配置狀態(tài)后，首先當(dāng)然就要進(jìn)行 USB 驅(qū)動(dòng)程序和相應(yīng)接口的配對(duì)，對(duì)于鼠標(biāo)設(shè)備來(lái)說(shuō)則是鼠標(biāo)驅(qū)動(dòng)程序和鼠標(biāo)中的接口的配對(duì)。USB core 會(huì)調(diào)用 usb_device_match 函數(shù)，通過(guò)比較設(shè)備中的接口信息和 USB 驅(qū)動(dòng)程序中的 id_table，來(lái)初步?jīng)Q定該 USB 驅(qū)動(dòng)程序是不是跟相應(yīng)接口相匹配。通過(guò)這一道關(guān)卡后，USB core 會(huì)認(rèn)為這個(gè)設(shè)備應(yīng)該由這個(gè)驅(qū)動(dòng)程序負(fù)責(zé)。
然而，僅僅這一步是不夠的，接著，將會(huì)調(diào)用 USB 驅(qū)動(dòng)程序中的 probe 函數(shù)對(duì)相應(yīng)接口進(jìn)行進(jìn)一步檢查。如果該驅(qū)動(dòng)程序確實(shí)適合設(shè)備接口，對(duì)設(shè)備做一些初始化工作，分配 urb 準(zhǔn)備數(shù)據(jù)傳輸。
當(dāng) 鼠標(biāo)設(shè)備在用戶空間打開(kāi)時(shí)，將提交 probe 函數(shù)構(gòu)建的 urb 請(qǐng)求塊，urb 將開(kāi)始為傳送數(shù)據(jù)而忙碌了。urb 請(qǐng)求塊就像一個(gè)裝東西的“袋子”，USB 驅(qū)動(dòng)程序把“空袋子”提交給 USB core，然后再交給主控制器，主控制器把數(shù)據(jù)放入這個(gè)“袋子”后再將裝滿數(shù)據(jù)的“袋子”通過(guò) USB core 交還給 USB 驅(qū)動(dòng)程序，這樣一次數(shù)據(jù)傳輸就完成了。

?

以下是完全注釋后的鼠標(biāo)驅(qū)動(dòng)程序代碼 usbmouse.c

view plaincopy to clipboardprint?
/*?
?* $Id: usbmouse.c,v 1.15 2001/12/27 10:37:41 vojtech Exp $?
?*?
?*? Copyright (c) 1999-2001 Vojtech Pavlik?

?*?
?*? USB HIDBP Mouse support?
?*/?
?
#include ???
#include ???
#include ???
#include ???
#include ???
#include ???
?
/*?
?* Version Information?
?*/?
#define DRIVER_VERSION "v1.6"???
#define DRIVER_AUTHOR "Vojtech Pavlik "???
#define DRIVER_DESC "USB HID Boot Protocol mouse driver"???
#define DRIVER_LICENSE "GPL"???
?
MODULE_AUTHOR(DRIVER_AUTHOR);??
MODULE_DESCRIPTION(DRIVER_DESC);??
MODULE_LICENSE(DRIVER_LICENSE);??
?
/*?
?* 鼠標(biāo)結(jié)構(gòu)體，用于描述鼠標(biāo)設(shè)備。?
?*/?
struct usb_mouse???
{??
??? /* 鼠標(biāo)設(shè)備的名稱，包括生產(chǎn)廠商、產(chǎn)品類別、產(chǎn)品等信息 */?
??? char name[128];???
??? /* 設(shè)備節(jié)點(diǎn)名稱 */?
??? char phys[64];????
??? /* USB 鼠標(biāo)是一種 USB 設(shè)備，需要內(nèi)嵌一個(gè) USB 設(shè)備結(jié)構(gòu)體來(lái)描述其 USB 屬性 */?
??? struct usb_device *usbdev;??
??? /* USB 鼠標(biāo)同時(shí)又是一種輸入設(shè)備，需要內(nèi)嵌一個(gè)輸入設(shè)備結(jié)構(gòu)體來(lái)描述其輸入設(shè)備的屬性 */?
??? struct input_dev *dev;????
??? /* URB 請(qǐng)求包結(jié)構(gòu)體，用于傳送數(shù)據(jù) */?
??? struct urb *irq;??
??? /* 普通傳輸用的地址 */?
??? signed char *data;??
??? /* dma 傳輸用的地址 */?
??? dma_addr_t data_dma;??????????
};??
?
/*?
?* urb 回調(diào)函數(shù)，在完成提交 urb 后，urb 回調(diào)函數(shù)將被調(diào)用。?
?* 此函數(shù)作為 usb_fill_int_urb 函數(shù)的形參，為構(gòu)建的 urb 制定的回調(diào)函數(shù)。?
?*/?
static void usb_mouse_irq(struct urb *urb)??
{??
??? /*?
???? * urb 中的 context 指針用于為 USB 驅(qū)動(dòng)程序保存一些數(shù)據(jù)。比如在這個(gè)回調(diào)函數(shù)的形參沒(méi)有傳遞在 probe?
???? * 中為 mouse 結(jié)構(gòu)體分配的那塊內(nèi)存的地址指針，而又需要用到那塊內(nèi)存區(qū)域中的數(shù)據(jù)，context 指針則幫了?
???? * 大忙了！?
???? * 在填充 urb 時(shí)將 context 指針指向 mouse 結(jié)構(gòu)體數(shù)據(jù)區(qū)，在這又創(chuàng)建一個(gè)局部 mouse 指針指向在 probe?
???? * 函數(shù)中為 mouse 申請(qǐng)的那塊內(nèi)存，那塊內(nèi)存保存著非常重要數(shù)據(jù)。?
???? * 當(dāng) urb 通過(guò) USB core 提交給 hc 之后，如果結(jié)果正常，mouse->data 指向的內(nèi)存區(qū)域?qū)⒈４嬷髽?biāo)的按鍵?
???? * 和移動(dòng)坐標(biāo)信息，系統(tǒng)則依靠這些信息對(duì)鼠標(biāo)的行為作出反應(yīng)。??
???? * mouse 中內(nèi)嵌的 dev 指針，指向 input_dev 所屬于的內(nèi)存區(qū)域。?
???? */?
??? struct usb_mouse *mouse = urb->context;??
??? signed char *data = mouse->data;??
??? struct input_dev *dev = mouse->dev;??
??? int status;??
?
??? /*?
???? * status 值為 0 表示 urb 成功返回，直接跳出循環(huán)把鼠標(biāo)事件報(bào)告給輸入子系統(tǒng)。?
???? * ECONNRESET 出錯(cuò)信息表示 urb 被 usb_unlink_urb 函數(shù)給 unlink 了，ENOENT 出錯(cuò)信息表示 urb 被??
???? * usb_kill_urb 函數(shù)給 kill 了。usb_kill_urb 表示徹底結(jié)束 urb 的生命周期，而 usb_unlink_urb 則?
???? * 是停止 urb，這個(gè)函數(shù)不等 urb 完全終止就會(huì)返回給回調(diào)函數(shù)。這在運(yùn)行中斷處理程序時(shí)或者等待某自旋鎖?
???? * 時(shí)非常有用，在這兩種情況下是不能睡眠的，而等待一個(gè) urb 完全停止很可能會(huì)出現(xiàn)睡眠的情況。?
???? * ESHUTDOWN 這種錯(cuò)誤表示 USB 主控制器驅(qū)動(dòng)程序發(fā)生了嚴(yán)重的錯(cuò)誤，或者提交完 urb 的一瞬間設(shè)備被拔出。?
???? * 遇見(jiàn)除了以上三種錯(cuò)誤以外的錯(cuò)誤，將申請(qǐng)重傳 urb。?
???? */?
??? switch (urb->status)??
??? {??
??? case 0:???? /* success */?
??????? break;??
??? case -ECONNRESET:?? /* unlink */?
??? case -ENOENT:??
??? case -ESHUTDOWN:??
??????? return;??
??? /* -EPIPE:? should clear the halt */?
??? default:??????? /* error */?
??????? goto resubmit;??
??? }??
?
??? /*?
???? * 向輸入子系統(tǒng)匯報(bào)鼠標(biāo)事件情況，以便作出反應(yīng)。?
???? * data 數(shù)組的第0個(gè)字節(jié)：bit 0、1、2、3、4分別代表左、右、中、SIDE、EXTRA鍵的按下情況；?
???? * data 數(shù)組的第1個(gè)字節(jié)：表示鼠標(biāo)的水平位移；?
???? * data 數(shù)組的第2個(gè)字節(jié)：表示鼠標(biāo)的垂直位移；?
???? * data 數(shù)組的第3個(gè)字節(jié)：REL_WHEEL位移。?
???? */?
??? input_report_key(dev, BTN_LEFT,?? data[0] & 0x01);??
??? input_report_key(dev, BTN_RIGHT,? data[0] & 0x02);??
??? input_report_key(dev, BTN_MIDDLE, data[0] & 0x04);??
??? input_report_key(dev, BTN_SIDE,?? data[0] & 0x08);??
??? input_report_key(dev, BTN_EXTRA,? data[0] & 0x10);??
??? input_report_rel(dev, REL_X,???? data[1]);??
??? input_report_rel(dev, REL_Y,???? data[2]);??
??? input_report_rel(dev, REL_WHEEL, data[3]);??
?
??? /*?
???? * 這里是用于事件同步。上面幾行是一次完整的鼠標(biāo)事件，包括按鍵信息、絕對(duì)坐標(biāo)信息和滾輪信息，輸入子?
???? * 系統(tǒng)正是通過(guò)這個(gè)同步信號(hào)來(lái)在多個(gè)完整事件報(bào)告中區(qū)分每一次完整事件報(bào)告。示意如下：?
???? * 按鍵信息 坐標(biāo)位移信息 滾輪信息 EV_SYC | 按鍵信息 坐標(biāo)位移信息 滾輪信息 EV_SYC ...?
???? */?
??? input_sync(dev);??
?
??? /*?
???? * 系統(tǒng)需要周期性不斷地獲取鼠標(biāo)的事件信息，因此在 urb 回調(diào)函數(shù)的末尾再次提交 urb 請(qǐng)求塊，這樣又會(huì)?
???? * 調(diào)用新的回調(diào)函數(shù)，周而復(fù)始。?
???? * 在回調(diào)函數(shù)中提交 urb 一定只能是 GFP_ATOMIC 優(yōu)先級(jí)的，因?yàn)?urb 回調(diào)函數(shù)運(yùn)行于中斷上下文中，在提?
???? * 交 urb 過(guò)程中可能會(huì)需要申請(qǐng)內(nèi)存、保持信號(hào)量，這些操作或許會(huì)導(dǎo)致 USB core 睡眠，一切導(dǎo)致睡眠的行?
???? * 為都是不允許的。?
???? */?
resubmit:??
??? status = usb_submit_urb (urb, GFP_ATOMIC);??
??? if (status)??
??????? err ("can't resubmit intr, %s-%s/input0, status %d",??
??????????????? mouse->usbdev->bus->bus_name,??
??????????????? mouse->usbdev->devpath, status);??
}??
?
/*?
?* 打開(kāi)鼠標(biāo)設(shè)備時(shí)，開(kāi)始提交在 probe 函數(shù)中構(gòu)建的 urb，進(jìn)入 urb 周期。?
?*/?
static int usb_mouse_open(struct input_dev *dev)??
{??
??? struct usb_mouse *mouse = dev->private;??
?
??? mouse->irq->dev = mouse->usbdev;??
??? if (usb_submit_urb(mouse->irq, GFP_KERNEL))??
??????? return -EIO;??
?
??? return 0;??
}??
?
/*?
?* 關(guān)閉鼠標(biāo)設(shè)備時(shí)，結(jié)束 urb 生命周期。?
?*/?
static void usb_mouse_close(struct input_dev *dev)??
{??
??? struct usb_mouse *mouse = dev->private;??
?
??? usb_kill_urb(mouse->irq);??
}??
?
/*?
?* 驅(qū)動(dòng)程序的探測(cè)函數(shù)?
?*/?
static int usb_mouse_probe(struct usb_interface *intf, const struct usb_device_id *id)??
{??
??? /*??
???? * 接口結(jié)構(gòu)體包含于設(shè)備結(jié)構(gòu)體中，interface_to_usbdev 是通過(guò)接口結(jié)構(gòu)體獲得它的設(shè)備結(jié)構(gòu)體。?
???? * usb_host_interface 是用于描述接口設(shè)置的結(jié)構(gòu)體，內(nèi)嵌在接口結(jié)構(gòu)體 usb_interface 中。?
???? * usb_endpoint_descriptor 是端點(diǎn)描述符結(jié)構(gòu)體，內(nèi)嵌在端點(diǎn)結(jié)構(gòu)體 usb_host_endpoint 中，而端點(diǎn)?
???? * 結(jié)構(gòu)體內(nèi)嵌在接口設(shè)置結(jié)構(gòu)體中。?
???? */?
??? struct usb_device *dev = interface_to_usbdev(intf);??
??? struct usb_host_interface *interface;??
??? struct usb_endpoint_descriptor *endpoint;??
??? struct usb_mouse *mouse;??
??? struct input_dev *input_dev;??
??? int pipe, maxp;??
?
??? interface = intf->cur_altsetting;??
?
??? /* 鼠標(biāo)僅有一個(gè) interrupt 類型的 in 端點(diǎn)，不滿足此要求的設(shè)備均報(bào)錯(cuò) */?
??? if (interface->desc.bNumEndpoints != 1)??
??????? return -ENODEV;??
?
??? endpoint = &interface->endpoint[0].desc;??
??? if (!usb_endpoint_is_int_in(endpoint))??
??????? return -ENODEV;??
?
??? /*?
???? * 返回對(duì)應(yīng)端點(diǎn)能夠傳輸?shù)淖畲蟮臄?shù)據(jù)包，鼠標(biāo)的返回的最大數(shù)據(jù)包為4個(gè)字節(jié)，數(shù)據(jù)包具體內(nèi)容在 urb?
???? * 回調(diào)函數(shù)中有詳細(xì)說(shuō)明。?
???? */?
??? pipe = usb_rcvintpipe(dev, endpoint->bEndpointAddress);??
??? maxp = usb_maxpacket(dev, pipe, usb_pipeout(pipe));??
?
??? /* 為 mouse 設(shè)備結(jié)構(gòu)體分配內(nèi)存 */?
??? mouse = kzalloc(sizeof(struct usb_mouse), GFP_KERNEL);??
??? /* input_dev */?
??? input_dev = input_allocate_device();??
??? if (!mouse || !input_dev)??
??????? goto fail1;??
?
??? /*?
???? * 申請(qǐng)內(nèi)存空間用于數(shù)據(jù)傳輸，data 為指向該空間的地址，data_dma 則是這塊內(nèi)存空間的 dma 映射，?
???? * 即這塊內(nèi)存空間對(duì)應(yīng)的 dma 地址。在使用 dma 傳輸?shù)那闆r下，則使用 data_dma 指向的 dma 區(qū)域，?
???? * 否則使用 data 指向的普通內(nèi)存區(qū)域進(jìn)行傳輸。?
???? * GFP_ATOMIC 表示不等待，GFP_KERNEL 是普通的優(yōu)先級(jí)，可以睡眠等待，由于鼠標(biāo)使用中斷傳輸方式，?
???? * 不允許睡眠狀態(tài)，data 又是周期性獲取鼠標(biāo)事件的存儲(chǔ)區(qū)，因此使用 GFP_ATOMIC 優(yōu)先級(jí)，如果不能?
???? * 分配到內(nèi)存則立即返回 0。?
???? */?
??? mouse->data = usb_buffer_alloc(dev, 8, GFP_ATOMIC, &mouse->data_dma);??
??? if (!mouse->data)??
??????? goto fail1;??
?
??? /*?
???? * 為 urb 結(jié)構(gòu)體申請(qǐng)內(nèi)存空間，第一個(gè)參數(shù)表示等時(shí)傳輸時(shí)需要傳送包的數(shù)量，其它傳輸方式則為0。?
???? * 申請(qǐng)的內(nèi)存將通過(guò)下面即將見(jiàn)到的 usb_fill_int_urb 函數(shù)進(jìn)行填充。??
???? */?
??? mouse->irq = usb_alloc_urb(0, GFP_KERNEL);??
??? if (!mouse->irq)??
??????? goto fail2;??
?
??? /* 填充 usb 設(shè)備結(jié)構(gòu)體和輸入設(shè)備結(jié)構(gòu)體 */?
??? mouse->usbdev = dev;??
??? mouse->dev = input_dev;??
?
??? /* 獲取鼠標(biāo)設(shè)備的名稱 */?
??? if (dev->manufacturer)??
??????? strlcpy(mouse->name, dev->manufacturer, sizeof(mouse->name));??
?
??? if (dev->product)???
??? {??
??????? if (dev->manufacturer)??
??????????? strlcat(mouse->name, " ", sizeof(mouse->name));??
??????? strlcat(mouse->name, dev->product, sizeof(mouse->name));??
??? }??
?
??? if (!strlen(mouse->name))??
??????? snprintf(mouse->name, sizeof(mouse->name),??
???????????? "USB HIDBP Mouse %04x:%04x",??
???????????? le16_to_cpu(dev->descriptor.idVendor),??
???????????? le16_to_cpu(dev->descriptor.idProduct));??
?
??? /*?
???? * 填充鼠標(biāo)設(shè)備結(jié)構(gòu)體中的節(jié)點(diǎn)名。usb_make_path 用來(lái)獲取 USB 設(shè)備在 Sysfs 中的路徑，格式?
???? * 為：usb-usb 總線號(hào)-路徑名。?
???? */?
??? usb_make_path(dev, mouse->phys, sizeof(mouse->phys));??
??? strlcat(mouse->phys, "/input0", sizeof(mouse->phys));??
?
??? /* 將鼠標(biāo)設(shè)備的名稱賦給鼠標(biāo)設(shè)備內(nèi)嵌的輸入子系統(tǒng)結(jié)構(gòu)體 */?
??? input_dev->name = mouse->name;??
??? /* 將鼠標(biāo)設(shè)備的設(shè)備節(jié)點(diǎn)名賦給鼠標(biāo)設(shè)備內(nèi)嵌的輸入子系統(tǒng)結(jié)構(gòu)體 */?
??? input_dev->phys = mouse->phys;??
??? /*?
???? * input_dev 中的 input_id 結(jié)構(gòu)體，用來(lái)存儲(chǔ)廠商、設(shè)備類型和設(shè)備的編號(hào)，這個(gè)函數(shù)是將設(shè)備描述符?
???? * 中的編號(hào)賦給內(nèi)嵌的輸入子系統(tǒng)結(jié)構(gòu)體?
???? */?
??? usb_to_input_id(dev, &input_dev->id);??
??? /* cdev 是設(shè)備所屬類別（class device） */?
??? input_dev->cdev.dev = &intf->dev;??
?
??? /* evbit 用來(lái)描述事件，EV_KEY 是按鍵事件，EV_REL 是相對(duì)坐標(biāo)事件 */?
??? input_dev->evbit[0] = BIT(EV_KEY) | BIT(EV_REL);??
??? /* keybit 表示鍵值，包括左鍵、右鍵和中鍵 */?
??? input_dev->keybit[LONG(BTN_MOUSE)] = BIT(BTN_LEFT) | BIT(BTN_RIGHT) | BIT(BTN_MIDDLE);??
??? /* relbit 用于表示相對(duì)坐標(biāo)值 */?
??? input_dev->relbit[0] = BIT(REL_X) | BIT(REL_Y);??
??? /* 有的鼠標(biāo)還有其它按鍵 */?
??? input_dev->keybit[LONG(BTN_MOUSE)] |= BIT(BTN_SIDE) | BIT(BTN_EXTRA);??
??? /* 中鍵滾輪的滾動(dòng)值 */?
??? input_dev->relbit[0] |= BIT(REL_WHEEL);??
?
??? /* input_dev 的 private 數(shù)據(jù)項(xiàng)用于表示當(dāng)前輸入設(shè)備的種類，這里將鼠標(biāo)結(jié)構(gòu)體對(duì)象賦給它 */?
??? input_dev->private = mouse;??
??? /* 填充輸入設(shè)備打開(kāi)函數(shù)指針 */?
??? input_dev->open = usb_mouse_open;??
??? /* 填充輸入設(shè)備關(guān)閉函數(shù)指針 */?
??? input_dev->close = usb_mouse_close;??
?
??? /*?
???? * 填充構(gòu)建 urb，將剛才填充好的 mouse 結(jié)構(gòu)體的數(shù)據(jù)填充進(jìn) urb 結(jié)構(gòu)體中，在 open 中遞交 urb。?
???? * 當(dāng) urb 包含一個(gè)即將傳輸?shù)?DMA 緩沖區(qū)時(shí)應(yīng)該設(shè)置 URB_NO_TRANSFER_DMA_MAP。USB核心使用?
???? * transfer_dma變量所指向的緩沖區(qū)，而不是transfer_buffer變量所指向的。?
???? * URB_NO_SETUP_DMA_MAP 用于 Setup 包，URB_NO_TRANSFER_DMA_MAP 用于所有 Data 包。?
???? */?
??? usb_fill_int_urb(mouse->irq, dev, pipe, mouse->data,??
???????????? (maxp > 8 ? 8 : maxp),??
???????????? usb_mouse_irq, mouse, endpoint->bInterval);??
??? mouse->irq->transfer_dma = mouse->data_dma;??
??? mouse->irq->transfer_flags |= URB_NO_TRANSFER_DMA_MAP;??
?
??? /* 向系統(tǒng)注冊(cè)輸入設(shè)備 */?
??? input_register_device(mouse->dev);??
?
??? /*?
???? * 一般在 probe 函數(shù)中，都需要將設(shè)備相關(guān)信息保存在一個(gè) usb_interface 結(jié)構(gòu)體中，以便以后通過(guò)?
???? * usb_get_intfdata 獲取使用。這里鼠標(biāo)設(shè)備結(jié)構(gòu)體信息將保存在 intf 接口結(jié)構(gòu)體內(nèi)嵌的設(shè)備結(jié)構(gòu)體中?
???? * 的 driver_data 數(shù)據(jù)成員中，即 intf->dev->dirver_data = mouse。?
???? */?
??? usb_set_intfdata(intf, mouse);??
??? return 0;??
?
fail2:? usb_buffer_free(dev, 8, mouse->data, mouse->data_dma);??
fail1:? input_free_device(input_dev);??
??? kfree(mouse);??
??? return -ENOMEM;??
}??
?
/*?
?* 鼠標(biāo)設(shè)備拔出時(shí)的處理函數(shù)?
?*/?
static void usb_mouse_disconnect(struct usb_interface *intf)??
{??
??? /* 獲取鼠標(biāo)設(shè)備結(jié)構(gòu)體 */?
??? struct usb_mouse *mouse = usb_get_intfdata (intf);??
?
??? /* intf->dev->dirver_data = NULL，將接口結(jié)構(gòu)體中的鼠標(biāo)設(shè)備指針置空。*/?
??? usb_set_intfdata(intf, NULL);??
??? if (mouse)??
??? {??
??????? /* 結(jié)束 urb 生命周期 */?
??????? usb_kill_urb(mouse->irq);??
??????? /* 將鼠標(biāo)設(shè)備從輸入子系統(tǒng)中注銷 */?
??????? input_unregister_device(mouse->dev);??
??????? /* 釋放 urb 存儲(chǔ)空間 */?
??????? usb_free_urb(mouse->irq);??
??????? /* 釋放存放鼠標(biāo)事件的 data 存儲(chǔ)空間 */?
??????? usb_buffer_free(interface_to_usbdev(intf), 8, mouse->data, mouse->data_dma);??
??????? /* 釋放存放鼠標(biāo)結(jié)構(gòu)體的存儲(chǔ)空間 */?
??????? kfree(mouse);??
??? }??
}??
?
/*?
?* usb_device_id 結(jié)構(gòu)體用于表示該驅(qū)動(dòng)程序所支持的設(shè)備，USB_INTERFACE_INFO 可以用來(lái)匹配特定類型的接口，?
?* 這個(gè)宏的參數(shù)意思為 (類別, 子類別, 協(xié)議)。?
?* USB_INTERFACE_CLASS_HID 表示是一種 HID (Human Interface Device)，即人機(jī)交互設(shè)備類別；?
?* USB_INTERFACE_SUBCLASS_BOOT 是子類別，表示是一種 boot 階段使用的 HID；?
?* USB_INTERFACE_PROTOCOL_MOUSE 表示是鼠標(biāo)設(shè)備，遵循鼠標(biāo)的協(xié)議。?
?*/?
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 */?
};??
?
/*?
?* 這個(gè)宏用來(lái)讓運(yùn)行在用戶空間的程序知道這個(gè)驅(qū)動(dòng)程序能夠支持的設(shè)備，對(duì)于 USB 驅(qū)動(dòng)程序來(lái)說(shuō)，第一個(gè)參數(shù)必須?
?* 是 usb。?
?*/?
MODULE_DEVICE_TABLE (usb, usb_mouse_id_table);??
?
/*?
?* 鼠標(biāo)驅(qū)動(dòng)程序結(jié)構(gòu)體?
?*/?
static struct usb_driver usb_mouse_driver = {??
??? .name?????? = "usbmouse",??
??? .probe????? = usb_mouse_probe,??
??? .disconnect = usb_mouse_disconnect,??
??? .id_table?? = usb_mouse_id_table,??
};??
?
/*?
?* 驅(qū)動(dòng)程序生命周期的開(kāi)始點(diǎn)，向 USB core 注冊(cè)這個(gè)鼠標(biāo)驅(qū)動(dòng)程序。?
?*/?
static int __init usb_mouse_init(void)??
{??
??? int retval = usb_register(&usb_mouse_driver);??
??? if (retval == 0)??
??????? info(DRIVER_VERSION ":" DRIVER_DESC);??
??? return retval;??
}??
?
/*?
?* 驅(qū)動(dòng)程序生命周期的結(jié)束點(diǎn)，向 USB core 注銷這個(gè)鼠標(biāo)驅(qū)動(dòng)程序。?
?*/?
static void __exit usb_mouse_exit(void)??
{??
??? usb_deregister(&usb_mouse_driver);??
}??
?
module_init(usb_mouse_init);??
module_exit(usb_mouse_exit);