urb

本文轉載自：https://blog.csdn.net/u012719256/article/details/53156373  

一、概念介紹

urb用作usb總線和usb設備驅動之間的數據傳輸，可以理解爲一個notifer，由從設備發起提交一個請求等待主設備處理，而不能主動通知主設備，主設備處理完成後回調完成函數
—— 設備驅動需要構建、提交urb，且提交一次只會處理一次，所以需要不斷提交。
—— 每提交一次可以從端點描述符中獲取或者寫入數據信息。
—— urb結構包含數據傳輸的三要素：源、目的、長度，傳輸完成後執行回調函數。
二、相關函數
2.1 申請urb結構

struct urb * = usb_alloc_urb(0, GFP_KERNEL);

  

2.1填充urb函數

usb_fill_control_urb   // 控制傳輸urb填充
usb_fill_bulk_urb      // 批量傳輸urb填充
usb_fill_int_urb       // 中斷傳輸urb填充

usb_fill_int_urb(struct urb *urb,                       // urb
                    struct usb_device *dev,
                    unsigned int pipe,                  // 源：usb設備的一個端點地址對應的pipe
                    void *transfer_buffer,              // 目的：保存數據的buffer
                    int buffer_length,
                    usb_complete_t complete_fn,         // 傳輸完成函數（一般都在裏邊再次提交urb）
                    void *context,                      // null
                    int interval)                       // 中斷時間間隔 endpoint->bInterval

 

2.3 提交urb

usb_submit_urb(struct urb *urb, gfp_t mem_flags)                    

三、demo usb鼠標驅動
 

/*
 * drivers\hid\usbhid\usbmouse.c
 */

#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 char *usb_buf;
static dma_addr_t usb_buf_phys;
static int len;
static struct urb *uk_urb;

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_DEVICE(0x1234,0x5678)},
    { } /* Terminating entry */
};

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 = interface_to_usbdev(intf);
    struct usb_host_interface *interface;
    struct usb_endpoint_descriptor *endpoint;
    int pipe;

    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);
}

/* 1. 分配/設置usb_driver */
static struct usb_driver usbmouse_as_key_driver = {
    .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_driver);
    return 0;
}

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

module_init(usbmouse_as_key_init);
module_exit(usbmouse_as_key_exit);

MODULE_LICENSE("GPL");