USB 總線引出兩個重要的鏈表！

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

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

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

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

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

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

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

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

?

以下是完全注釋后的鼠標(biāo)驅(qū)動程序代碼 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)嵌一個 USB 設(shè)備結(jié)構(gòu)體來描述其 USB 屬性 */?
??? struct usb_device *usbdev;??
??? /* USB 鼠標(biāo)同時(shí)又是一種輸入設(shè)備，需要內(nèi)嵌一個輸入設(shè)備結(jié)構(gòu)體來描述其輸入設(shè)備的屬性 */?
??? struct input_dev *dev;????
??? /* URB 請求包結(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ū)動程序保存一些數(shù)據(jù)。比如在這個回調(diào)函數(shù)的形參沒有傳遞在 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)建一個局部 mouse 指針指向在 probe?
???? * 函數(shù)中為 mouse 申請的那塊內(nèi)存，那塊內(nèi)存保存著非常重要數(shù)據(jù)。?
???? * 當(dāng) urb 通過 USB core 提交給 hc 之后，如果結(jié)果正常，mouse->data 指向的內(nèi)存區(qū)域?qū)⒈４嬷髽?biāo)的按鍵?
???? * 和移動坐標(biāo)信息，系統(tǒng)則依靠這些信息對鼠標(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 出錯信息表示 urb 被 usb_unlink_urb 函數(shù)給 unlink 了，ENOENT 出錯信息表示 urb 被??
???? * usb_kill_urb 函數(shù)給 kill 了。usb_kill_urb 表示徹底結(jié)束 urb 的生命周期，而 usb_unlink_urb 則?
???? * 是停止 urb，這個函數(shù)不等 urb 完全終止就會返回給回調(diào)函數(shù)。這在運(yùn)行中斷處理程序時(shí)或者等待某自旋鎖?
???? * 時(shí)非常有用，在這兩種情況下是不能睡眠的，而等待一個 urb 完全停止很可能會出現(xiàn)睡眠的情況。?
???? * ESHUTDOWN 這種錯誤表示 USB 主控制器驅(qū)動程序發(fā)生了嚴(yán)重的錯誤，或者提交完 urb 的一瞬間設(shè)備被拔出。?
???? * 遇見除了以上三種錯誤以外的錯誤，將申請重傳 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個字節(jié)：bit 0、1、2、3、4分別代表左、右、中、SIDE、EXTRA鍵的按下情況；?
???? * data 數(shù)組的第1個字節(jié)：表示鼠標(biāo)的水平位移；?
???? * data 數(shù)組的第2個字節(jié)：表示鼠標(biāo)的垂直位移；?
???? * data 數(shù)組的第3個字節(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)事件，包括按鍵信息、絕對坐標(biāo)信息和滾輪信息，輸入子?
???? * 系統(tǒng)正是通過這個同步信號來在多個完整事件報(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 請求塊，這樣又會?
???? * 調(diào)用新的回調(diào)函數(shù)，周而復(fù)始。?
???? * 在回調(diào)函數(shù)中提交 urb 一定只能是 GFP_ATOMIC 優(yōu)先級的，因?yàn)?urb 回調(diào)函數(shù)運(yùn)行于中斷上下文中，在提?
???? * 交 urb 過程中可能會需要申請內(nèi)存、保持信號量，這些操作或許會導(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);??
}??
?
/*?
?* 打開鼠標(biāo)設(shè)備時(shí)，開始提交在 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ū)動程序的探測函數(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 是通過接口結(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)僅有一個 interrupt 類型的 in 端點(diǎn)，不滿足此要求的設(shè)備均報(bào)錯 */?
??? if (interface->desc.bNumEndpoints != 1)??
??????? return -ENODEV;??
?
??? endpoint = &interface->endpoint[0].desc;??
??? if (!usb_endpoint_is_int_in(endpoint))??
??????? return -ENODEV;??
?
??? /*?
???? * 返回對應(yīng)端點(diǎn)能夠傳輸?shù)淖畲蟮臄?shù)據(jù)包，鼠標(biāo)的返回的最大數(shù)據(jù)包為4個字節(jié)，數(shù)據(jù)包具體內(nèi)容在 urb?
???? * 回調(diào)函數(shù)中有詳細(xì)說明。?
???? */?
??? 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;??
?
??? /*?
???? * 申請內(nèi)存空間用于數(shù)據(jù)傳輸，data 為指向該空間的地址，data_dma 則是這塊內(nèi)存空間的 dma 映射，?
???? * 即這塊內(nèi)存空間對應(yīng)的 dma 地址。在使用 dma 傳輸?shù)那闆r下，則使用 data_dma 指向的 dma 區(qū)域，?
???? * 否則使用 data 指向的普通內(nèi)存區(qū)域進(jìn)行傳輸。?
???? * GFP_ATOMIC 表示不等待，GFP_KERNEL 是普通的優(yōu)先級，可以睡眠等待，由于鼠標(biāo)使用中斷傳輸方式，?
???? * 不允許睡眠狀態(tài)，data 又是周期性獲取鼠標(biāo)事件的存儲區(qū)，因此使用 GFP_ATOMIC 優(yōu)先級，如果不能?
???? * 分配到內(nèi)存則立即返回 0。?
???? */?
??? mouse->data = usb_buffer_alloc(dev, 8, GFP_ATOMIC, &mouse->data_dma);??
??? if (!mouse->data)??
??????? goto fail1;??
?
??? /*?
???? * 為 urb 結(jié)構(gòu)體申請內(nèi)存空間，第一個參數(shù)表示等時(shí)傳輸時(shí)需要傳送包的數(shù)量，其它傳輸方式則為0。?
???? * 申請的內(nèi)存將通過下面即將見到的 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 用來獲取 USB 設(shè)備在 Sysfs 中的路徑，格式?
???? * 為：usb-usb 總線號-路徑名。?
???? */?
??? 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)體，用來存儲廠商、設(shè)備類型和設(shè)備的編號，這個函數(shù)是將設(shè)備描述符?
???? * 中的編號賦給內(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 用來描述事件，EV_KEY 是按鍵事件，EV_REL 是相對坐標(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 用于表示相對坐標(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);??
??? /* 中鍵滾輪的滾動值 */?
??? input_dev->relbit[0] |= BIT(REL_WHEEL);??
?
??? /* input_dev 的 private 數(shù)據(jù)項(xiàng)用于表示當(dāng)前輸入設(shè)備的種類，這里將鼠標(biāo)結(jié)構(gòu)體對象賦給它 */?
??? input_dev->private = mouse;??
??? /* 填充輸入設(shè)備打開函數(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 包含一個即將傳輸?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)注冊輸入設(shè)備 */?
??? input_register_device(mouse->dev);??
?
??? /*?
???? * 一般在 probe 函數(shù)中，都需要將設(shè)備相關(guān)信息保存在一個 usb_interface 結(jié)構(gòu)體中，以便以后通過?
???? * 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 存儲空間 */?
??????? usb_free_urb(mouse->irq);??
??????? /* 釋放存放鼠標(biāo)事件的 data 存儲空間 */?
??????? usb_buffer_free(interface_to_usbdev(intf), 8, mouse->data, mouse->data_dma);??
??????? /* 釋放存放鼠標(biāo)結(jié)構(gòu)體的存儲空間 */?
??????? kfree(mouse);??
??? }??
}??
?
/*?
?* usb_device_id 結(jié)構(gòu)體用于表示該驅(qū)動程序所支持的設(shè)備，USB_INTERFACE_INFO 可以用來匹配特定類型的接口，?
?* 這個宏的參數(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 */?
};??
?
/*?
?* 這個宏用來讓運(yùn)行在用戶空間的程序知道這個驅(qū)動程序能夠支持的設(shè)備，對于 USB 驅(qū)動程序來說，第一個參數(shù)必須?
?* 是 usb。?
?*/?
MODULE_DEVICE_TABLE (usb, usb_mouse_id_table);??
?
/*?
?* 鼠標(biāo)驅(qū)動程序結(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ū)動程序生命周期的開始點(diǎn)，向 USB core 注冊這個鼠標(biāo)驅(qū)動程序。?
?*/?
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ū)動程序生命周期的結(jié)束點(diǎn)，向 USB core 注銷這個鼠標(biāo)驅(qū)動程序。?
?*/?
static void __exit usb_mouse_exit(void)??
{??
??? usb_deregister(&usb_mouse_driver);??
}??
?
module_init(usb_mouse_init);??
module_exit(usb_mouse_exit);