USB驱动程序

先提出一个现象：把USB设备接到PC
1. 右下角弹出”发现android phone”
2. 跳出一个对话框，提示你安装驱动程序

问1. 既然还没有”驱动程序”，为何能知道是”android phone”
答1. windows里已经有了USB的总线驱动程序，接入USB设备后，是”总线驱动程序”知道你是”android phone”，提示你安装的是”设备驱动程序”

问2. USB设备种类非常多，为什么一接入电脑，就能识别出来？
答2. PC和USB设备都得遵守一些规范。
比如：USB设备接入电脑后，PC机会发出”你是什么”？
USB设备就必须回答”我是xxx”
USB总线驱动程序会发出某些命令想获取设备信息(描述符)，
USB设备必须返回”描述符”给PC

问3. PC机上接有非常多的USB设备，怎么分辨它们？
USB接口只有4条线: 5V,GND,D-,D+
答3. 每一个USB设备接入PC时，USB总线驱动程序都会给它分配一个编号
接在USB总线上的每一个USB设备都有自己的编号(地址)
PC机想访问某个USB设备时，发出的命令都含有对应的编号(地址)

问4. USB设备刚接入PC时，还没有编号；那么PC怎么把”分配的编号”告诉它？
答4. 新接入的USB设备的默认编号是0，在未分配新编号前，PC使用0编号和它通信。

问5. 为什么一接入USB设备，PC机就能发现它？
答5. PC的USB口内部，D-和D+接有15K的下拉电阻，未接USB设备时为低电平
USB设备的USB口内部，D-或D+接有1.5K的上拉电阻；它一接入PC，就会把PC USB口的D-或D+拉高，从硬件的角度通知PC有新设备接入

其他概念:
1. USB是主从结构的
所有的USB传输，都是从USB主机这方发起；USB设备没有”主动”通知USB主机的能力。
例子：USB鼠标滑动一下立刻产生数据，但是它没有能力通知PC机来读数据，只能被动地等得PC机来读。

2.USB的传输类型:
a. 控制传输：可靠，时间有保证，比如：USB设备的识别过程
b. 批量传输: 可靠, 时间没有保证, 比如：U盘
c. 中断传输：可靠，实时，比如：USB鼠标
d. 实时传输：不可靠，实时，比如：USB摄像头

3.USB传输的对象：端点(endpoint)
我们说”读U盘”、”写U盘”，可以细化为：把数据写到U盘的端点1，从U盘的端点2里读出数据
除了端点0外，每一个端点只支持一个方向的数据传输
端点0用于控制传输，既能输出也能输入

4.每一个端点都有传输类型，传输方向

5.术语里、程序里说的输入(IN)、输出(OUT) “都是” 基于USB主机的立场说的。
比如鼠标的数据是从鼠标传到PC机, 对应的端点称为”输入端点”

6.USB总线驱动程序的作用
a. 识别USB设备
b. 查找并安装对应的设备驱动程序
c. 提供USB读写函数

UHCI: intel, 低速(1.5Mbps)/全速(12Mbps)
OHCI: microsoft 低速/全速
EHCI: 高速(480Mbps)

USB总线驱动程序的作用
1. 识别USB设备
1.1 分配地址
1.2 并告诉USB设备(set address)
1.3 发出命令获取描述符
描述符的信息可以在include\linux\usb\Ch9.h看到
2. 查找并安装对应的设备驱动程序
3. 提供USB读写函数

把USB设备接到开发板上，看输出信息:
usb 1-1: new full speed USB device using s3c2410-ohci and address 2
usb 1-1: configuration #1 chosen from 1 choice
scsi0 : SCSI emulation for USB Mass Storage devices
scsi 0:0:0:0: Direct-Access HTC Android Phone 0100 PQ: 0 ANSI: 2
sd 0:0:0:0: [sda] Attached SCSI removable disk
拔掉
usb 1-1: USB disconnect, address 2

我们可以先找到这些语句是在哪里打印的，然后顺藤摸瓜，弄清楚整个流程。
在内核目录下搜:
grep “USB device using” * -nR
drivers/usb/core/hub.c:2186: “%s %s speed %sUSB device using %s and address %d\n”,

这句话在hub_port_init 中打印出来，hub_port_init< —hub_port_connect_change< —hub_events< —hub_thread< —kick_khubd< —hub_irq。就是这样一个调用过程，这个中断是主机控制器里注册的中断。

USB总线驱动程序是如何识别USB设备的呢？从hub_port_connect_change开始分析：

hub_port_connect_change         
    udev = usb_alloc_dev(hdev, hdev->bus, port1);
                    dev->dev.bus = &usb_bus_type;               
    choose_address(udev); // 给新设备分配编号(地址)
    hub_port_init   // usb 1-1: new full speed USB device using s3c2410-ohci and address 3

        hub_set_address  // 把编号(地址)告诉USB设备

        usb_get_device_descriptor(udev, 8); // 获取设备描述符
        retval = usb_get_device_descriptor(udev, USB_DT_DEVICE_SIZE);

        usb_new_device(udev)   // 把所有的描述符都读出来，并解析
            err = usb_get_configuration(udev); // 把所有的描述符都读出来
            usb_parse_configuration //解析

            device_add  // 把device放入usb_bus_type的dev链表, 
                                        // 从usb_bus_type的driver链表里取出usb_driver，
                                        // 把usb_interface和usb_driver的id_table比较
                                        // 如果能匹配，调用usb_driver的probe

在choose_address中，可以看到，最多支持127个设备（1-127），设备编号从1开始分配，分配到127之后再从1开始。注意，这只是分配，还没有把告诉USB设备呢。通过hub_set_address 把编号(地址)告诉USB设备。
什么是设备描述符呢？

struct usb_device_descriptor {
    __u8  bLength;
    __u8  bDescriptorType;

    __le16 bcdUSB;//USB版本号
    __u8  bDeviceClass;//类
    __u8  bDeviceSubClass;//子类
    __u8  bDeviceProtocol;//协议
    __u8  bMaxPacketSize0;//最大包大小0
    __le16 idVendor;
    __le16 idProduct;
    __le16 bcdDevice;
    __u8  iManufacturer;
    __u8  iProduct;
    __u8  iSerialNumber;
    __u8  bNumConfigurations;//表示这个设备有多少种配置，对应配置描述符
} __attribute__ ((packed));

什么是配置描述符？

struct usb_config_descriptor {
    __u8  bLength;//这个描述符的长度
    __u8  bDescriptorType;//类型

    __le16 wTotalLength;//所有的长度，是接口描述符和端点描述符的总长度
    __u8  bNumInterfaces;//接口的个数
    __u8  bConfigurationValue;
    __u8  iConfiguration;
    __u8  bmAttributes;
    __u8  bMaxPower;
} __attribute__ ((packed));

什么是接口描述符？

struct usb_interface_descriptor {
    __u8  bLength;
    __u8  bDescriptorType;

    __u8  bInterfaceNumber;
    __u8  bAlternateSetting;
    __u8  bNumEndpoints;//表示这个接口下的端点的个数
    __u8  bInterfaceClass;
    __u8  bInterfaceSubClass;
    __u8  bInterfaceProtocol;
    __u8  iInterface;
} __attribute__ ((packed));

什么是端点描述符？

struct usb_endpoint_descriptor {
    __u8  bLength;
    __u8  bDescriptorType;

    __u8  bEndpointAddress;//端点的地址（端点的编号）
    __u8  bmAttributes;//属性，表示它是哪一种类型的端点
    __le16 wMaxPacketSize;//最大包大小，一次性可以给或者读多少数据
    __u8  bInterval;//表示查询有多频繁

    /* NOTE:  these two are _only_ in audio endpoints. */
    /* use USB_DT_ENDPOINT*_SIZE in bLength, not sizeof. */
    __u8  bRefresh;
    __u8  bSynchAddress;
} __attribute__ ((packed));

这几个描述符之间有什么联系呢？请看下图：

一个usb驱动设备可能有多个驱动程序。每一个硬件都有一个设备描述符，一个设备下可能有多个配置，一个配置里面可能有多个接口，接口是逻辑上的设备，比如USB声卡既可以录音也可以播放。我们写驱动程序的时候，目标是给逻辑接口写的。

注意，前面提到过一句usb_get_device_descriptor(udev, 8); // 获取设备描述符
为什么是8个字节呢？因为不知道端点0一次性传输多少数据，而读到usb_device_descriptor 这个结构体的前八个字节（bMaxPacketSize0之前）之后，以后就可以尽快的从里面得到数据了。紧接着下一句就是重读的过程。

接下来是usb_new_device，然后把所有的描述符读出来并解析。再是添加设备，把device放入usb_bus_type的dev链表，从usb_bus_type的driver链表里取出usb_driver， 把usb_interface和usb_driver的id_table比较， 如果能匹配，调用usb_driver的probe。如下图：

USB总线驱动程序工作的流程大概就是这样。

下面开始写USB设备驱动程序。我们的目的是：按下左键+右键+滚轮==>l+s+enter

怎么写USB设备驱动程序？
1. 分配/设置usb_driver结构体
.id_table
.probe
.disconnect
2. 注册

先写一个最简单的程序，这个程序是按照USB总线驱动设备的框架写的：

#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>

static int usbmouse_as_key_probe(struct usb_interface *intf, const struct usb_device_id *id)
{

    printk("found usb_mouse\n");
    return 0;
}
static void usbmouse_as_key_disconnect(struct usb_interface *intf)
{
        printk("disconnect usb_mouse\n");

}

static struct usb_device_id usbmouse_as_key_id_table [] = {
    { USB_INTERFACE_INFO(USB_INTERFACE_CLASS_HID, USB_INTERFACE_SUBCLASS_BOOT,
        USB_INTERFACE_PROTOCOL_MOUSE) },
    { } /*在这里可以自定义你的类型 */
};


/* 分配/设置usb_driver */
static struct usb_driver usbmouse_as_key = {
    .name       = "usbmouse_as_key",
    .probe      = usbmouse_as_key_probe,
    .disconnect = usbmouse_as_key_disconnect,
    .id_table   = usbmouse_as_key_id_table,
};


static int usbmouse_as_key_init(void)
{
    /* 2.注册 */
    usb_register(&usbmouse_as_key);

    return 0;
}

static void usbmouse_as_key_exit(void)
{
    usb_deregister(&usbmouse_as_key);
}




module_init(usbmouse_as_key_init);
module_exit(usbmouse_as_key_exit);

MODULE_LICENSE("GPL");

其中，id_table表示的含义是只要是HID类，子类是BOOT类，协议是鼠标，就可以支持这个设备。

再来写第二个驱动程序。

#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>

static struct input_dev *uk_dev;
static int len;
static char *usb_buf;
static dma_addr_t *usb_buf_phys;

static struct urb *uk_urb;

static void usbmouse_as_key_irq(struct urb *urb)
{
    int i;
    static int cnt = 0;
    printk("data cnt %d: ", ++cnt);
    for (i = 0; i < len; i++)
    {
        printk("%02x ", usb_buf[i]);
    }
    printk("\n");

    /* 重新提交urb */
    usb_submit_urb(uk_urb, GFP_KERNEL);
}

static int usbmouse_as_key_probe(struct usb_interface *intf, const struct usb_device_id *id)
{

    struct usb_device *dev;
    struct usb_host_interface *interface;
    struct usb_endpoint_descriptor *endpoint;
    int pipe;
    dev = interface_to_usbdev(intf);//得到设备描述符
    interface = intf->cur_altsetting;//得到接口描述符
    endpoint = &interface->endpoint[0].desc;//得到端点描述符



    /*a.分配一个input_dev*/
    uk_dev = input_allocate_device();

    /*b.设置*/
    /*b.1能产生哪类事件*/
    set_bit(EV_KEY, uk_dev->evbit);
    set_bit(EV_REP, uk_dev->evbit);

    /* b.2 能产生哪些事件 */
    set_bit(KEY_L, uk_dev->keybit);
    set_bit(KEY_S, uk_dev->keybit);
    set_bit(KEY_ENTER, uk_dev->keybit);


    /*c.注册*/
    input_register_device(uk_dev);

    /* d. 硬件相关操作 */
    /* 数据传输3要素: 源,目的,长度 */
    /* 源: USB设备的某个端点 */
    pipe = usb_rcvintpipe(dev, endpoint->bEndpointAddress);

    /* 长度: 在端点描述符里定义*/
    len = endpoint->wMaxPacketSize;

    /* 目的: */
    usb_buf = usb_buffer_alloc(dev, len, GFP_ATOMIC, &usb_buf_phys);

    /* 使用"3要素" */
    /* 分配usb request block */
    uk_urb = usb_alloc_urb(0, GFP_KERNEL);
    /* 使用"3要素设置urb" */
    usb_fill_int_urb(uk_urb, dev, pipe, usb_buf, len, usbmouse_as_key_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;
}



static void usbmouse_as_key_disconnect(struct usb_interface *intf)
{
    struct usb_device *dev = interface_to_usbdev(intf);

    //printk("disconnect usbmouse!\n");
    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);
}

static struct usb_device_id usbmouse_as_key_id_table [] = {
    { USB_INTERFACE_INFO(USB_INTERFACE_CLASS_HID, USB_INTERFACE_SUBCLASS_BOOT,
        USB_INTERFACE_PROTOCOL_MOUSE) },
    { } /* Terminating entry */
};


/* 分配/设置鍀sb_driver */
static struct usb_driver usbmouse_as_key = {
    .name       = "usbmouse_as_key",
    .probe      = usbmouse_as_key_probe,
    .disconnect = usbmouse_as_key_disconnect,
    .id_table   = usbmouse_as_key_id_table,
};


static int usbmouse_as_key_init(void)
{
    /* 2.注册 */
    usb_register(&usbmouse_as_key);

    return 0;
}

static void usbmouse_as_key_exit(void)
{
    usb_deregister(&usbmouse_as_key);
}




module_init(usbmouse_as_key_init);
module_exit(usbmouse_as_key_exit);

MODULE_LICENSE("GPL");

当什么时候产生中断呢？这个中断不是鼠标产生的，而是USB主机控制器产生的，当它查询到鼠标动作之后发出中断。当把这个程序编译后，可以得到usb_buf里的内容。
USB鼠标数据含义（只写出data[0]）：
bit0-左键, 1-按下, 0-松开
bit1-右键, 1-按下, 0-松开
bit2-中键, 1-按下, 0-松开

这样，我们就可以根据具体的信息来实现我们想要的操作了。

static void usbmouse_as_key_irq(struct urb *urb)
{
    static unsigned char pre_val;
#if 0   
    int i;
    static int cnt = 0;
    printk("data cnt %d: ", ++cnt);
    for (i = 0; i < len; i++)
    {
        printk("%02x ", usb_buf[i]);
    }
    printk("\n");
#endif
    /* USB鼠标数据含义
     * usb_buf[0]: bit0-左键, 1-按下, 0-松开
     *             bit1-右键, 1-按下, 0-松开
     *             bit2-中键, 1-按下, 0-松开 
     *
     */
    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);
}

pre_val的值初始化为0，所以一旦不和usb_buf相等，则说明产生了数据。

安装 驱动之后，cat /dev/tty1，可以输入ls和回车