USB 匯流排引出兩個重要的鏈表！
一個 USB 匯流排引出兩個重要的鏈表，一個為 USB 設備鏈表，一個為 USB 驅動鏈表。設備鏈表包含各種系統中的 USB 設備以及這些設備的所有介面，驅動鏈表包含 USB 設備驅動程序（usb device driver）和 USB 驅動程序（usb driver）。
USB 設備驅動程序（usb device driver）和 USB 驅動程序（usb driver）的區別是什麼？
USB 設備驅動程序包含 USB 設備的一些通用特性，將與所有 USB 設備相匹配。在 USB core 定義了：struct usb_device_driver usb_generic_driver。usb_generic_driver 是 USB 子系統中唯一的一個設備驅動程序對象。而 USB 驅動程序則是與介面相匹配，介面是一個完成特定功能的端點的集合。
設備是如何添加到設備鏈表上去的？
在設備插入 USB 控制器之後，USB core 即會將設備在系統中註冊，添加到 USB 設備鏈表上去。
USB 設備驅動程序（usb device driver）是如何添加到驅動鏈表上去的？
在系統啟動註冊 USB core 時，USB 設備驅動程序即將被註冊，也就添加到驅動鏈表上去了。
介面是如何添加到設備鏈表上去的？
在 USB 設備驅動程序和 USB 設備的匹配之後，USB core 會對設備進行配置，分析設備的結構之後會將設備所有介面都添加到設備鏈表上去。比如滑鼠設備中有一個介面，USB core 對滑鼠設備配置后，會將這個介面添加到設備鏈表上去。
USB 驅動程序（usb driver）是如何添加到驅動鏈表上去的？
在每個 USB 驅動程序的被註冊時，USB 驅動程序即會添加到驅動鏈表上去。比如滑鼠驅動程序，usb_mouse_init 函數將通過 usb_register(&usb_mouse_driver) 將滑鼠驅動程序註冊到 USB core 中，然後就添加到驅動鏈表中去了。其中 usb_mouse_driver 是描述滑鼠驅動程序的結構體。
已配置狀態（configured status）之後話
當滑鼠的設備、介面都添加到設備鏈表，並且滑鼠驅動程序也添加到驅動鏈表上去了， 系統就進入一種叫做已配置（configured）的狀態。要達到已配置狀態，將經歷複雜的過程，USB core 為 USB 設備奉獻著無怨無悔。在這個過程中，系統將會建立起該設備的的設備、配置、介面、設置、端點的描述信息，它們分別被 usb_device、usb_configuration、usb_interface、usb_host_interface、 usb_host_endpoint 結構體描述。
設備達到已配置狀態后，首先當然就要進行 USB 驅動程序和相應介面的配對，對於滑鼠設備來說則是滑鼠驅動程序和滑鼠中的介面的配對。USB core 會調用 usb_device_match 函數，通過比較設備中的介面信息和 USB 驅動程序中的 id_table，來初步決定該 USB 驅動程序是不是跟相應介面相匹配。通過這一道關卡后，USB core 會認為這個設備應該由這個驅動程序負責。
然而，僅僅這一步是不夠的，接著，將會調用 USB 驅動程序中的 probe 函數對相應介面進行進一步檢查。如果該驅動程序確實適合設備介面，對設備做一些初始化工作，分配 urb 準備數據傳輸。
當 滑鼠設備在用戶空間打開時，將提交 probe 函數構建的 urb 請求塊，urb 將開始為傳送數據而忙碌了。urb 請求塊就像一個裝東西的“袋子”，USB 驅動程序把“空袋子”提交給 USB core，然後再交給主控制器，主控制器把數據放入這個“袋子”后再將裝滿數據的“袋子”通過 USB core 交還給 USB 驅動程序，這樣一次數據傳輸就完成了。
以下是完全註釋后的滑鼠驅動程序代碼 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 <linux/kernel.h>
#include <linux/slab.h>
#include <linux/module.h>
#include <linux/init.h>
#include <linux/usb/input.h>
#include <linux/hid.h>
/*
* Version Information
*/
#define DRIVER_VERSION "v1.6"
#define DRIVER_AUTHOR "Vojtech Pavlik <vojtech@ucw.cz>"
#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);
/*
* 滑鼠結構體，用於描述滑鼠設備。
*/
struct usb_mouse
{
/* 滑鼠設備的名稱，包括生產廠商、
產品類別、產品等信息 */
char name[128];
/* 設備節點名稱 */
char phys[64];
/* USB 滑鼠是一種 USB 設備，需要內嵌一個 USB 設備結構體來描述其 USB 屬性 */
struct usb_device *usbdev;
/* USB 滑鼠同時又是一種輸入設備，需要內嵌一個輸入設備結構體來描述其輸入設備的屬性 */
struct input_dev *dev;
/* URB 請求包結構體，用於傳送數據 */
struct urb *irq;
/* 普通傳輸用的地址 */
signed char *data;
/* dma 傳輸用的地址 */
dma_addr_t data_dma;
};
/*
* urb 回調函數，在完成提交 urb 后，urb 回調函數將被調用。
* 此函數作為 usb_fill_int_urb 函數的形參，為構建的 urb 制定的回調函數。
*/
static void usb_mouse_irq(struct urb *urb)
{
/*
* urb 中的 context 指針用於為 USB 驅動程序保存一些數據。比如在這個回調函數的形參沒有傳遞在 probe
* 中為 mouse 結構體分配的那塊內存的地址指針，而又需要用到那塊內存區域中的數據，context 指針則幫了
* 大忙了！
* 在填充 urb 時將 context 指針指向 mouse 結構體數據區，在這又創建一個局部 mouse 指針指向在 probe
* 函數中為 mouse 申請的那塊內存，那塊內存保存著非常重要數據。
* 當 urb 通過 USB core 提交給 hc 之後，如果結果正常，mouse->data 指向的內存區域將保存著滑鼠的按鍵
* 和移動坐標信息，系統則依靠這些信息對滑鼠的行為作出反應。
* mouse 中內嵌的 dev 指針，指向 input_dev 所屬於的內存區域。
*/
struct usb_mouse *mouse = urb->context;
signed char *data = mouse->data;
struct input_dev *dev = mouse->dev;
int status;
/*
* status 值為 0 表示 urb 成功
返回，直接跳出循環把滑鼠事件報告給輸入子系統。
* ECONNRESET 出錯信息表示 urb 被 usb_unlink_urb 函數給 unlink 了，ENOENT 出錯信息表示 urb 被
* usb_kill_urb 函數給 kill 了。usb_kill_urb 表示徹底結束 urb 的生命周期，而 usb_unlink_urb 則
* 是停止 urb，這個函數不等 urb 完全終止就會返回給回調函數。這在運行中斷處理程序時或者等待某自旋鎖
* 時非常有用，在這兩種情況下是不能睡眠的，而等待一個 urb 完全停止很可能會出現睡眠的情況。
* ESHUTDOWN 這種錯誤表示 USB 主控制器驅動程序發生了嚴重的錯誤，或者提交完 urb 的一瞬間設備被拔出。
* 遇見除了以上三種錯誤以外的錯誤，將申請重傳 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;
}
/*
* 向輸入子系統彙報滑鼠事件情況，以便作出反應。
* data 數組的第0個位元組：bit 0、1、2、3、4分別代表左、右、中、SIDE、EXTRA鍵的按下情況；
* data 數組的第1個位元組：表示滑鼠的水平位移；
* data 數組的第2個位元組：表示滑鼠的垂直位移；
* data 數組的第3個位元組：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);
