乾坤合一~Linux设备驱动之USB主机和设备驱动

struct usb device descriptor 

  { 

      _ _u8 bLength; // 述符长度 

      _ _u8 bDescriptorType; // 述符类型编号 
   
      _ _le16 bcdUSB; //USB版本号 

      _ _u8 bDeviceClass; //USB分配的设备类code 

      _ _u8 bDeviceSubClass;// USB 分配的子类code 

      _ _u8 bDeviceProtocol; //USB 分配的协议code 

      _ _u8 bMaxPacketSize0; //endpoint0 最大包大小 
 
      _ _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; //Set Configuration命令需要的参数值 

    _ _u8  iConfiguration; // 述该配置的字符串的索引值 

    _ _ u8 bmAttributes; //供电模式的选择 
 
    _ _u8 bMaxPower; //设备从总线提取的最大电流 

 } _ _attribute_ _ ((packed)); 

struct usb interface descriptor 

      { 

       _ _u8 bLength;            // 述符长度 

       _ _u8 bDescriptorType; // 述符类型 

       _ _ u8 bInterfaceNumber;     // 接口的编号 
       _ _u8 bAlternateSetting; //备用的接口 述符编号 
       _ _u8 bNumEndpoints;        //该接口使用的端点数，不包括端点0 
         
        _ _ u8 bInterfaceClass;      //接口类型 
         
        _ _ u8 bInterfaceSubClass; //接口子类型 
        
        _ _ u8 bInterfaceProtocol; //接口所遵循的协议 
 
        _ _ u8  iInterface; // 述该接口的字符串索引值 
     } _ _attribute_ _ ((packed)); 

struct usb endpoint descriptor 
      { 
       _ _u8 bLength; // 述符长度 
       _ _u8 bDescriptorType; // 述符类型 
       _ _u8  bEndpointAddress; //端点地址：0 ～3 位是端点号，第 7 位是方向 (0-OUT,1-IN) 
       
       _ _ u8 bmAttributes; //端点属性：bit[0:1] 的值为00表示控制，为01表示同步，为02表示批量，为03表示中 
         
       _ _le16 wMaxPacketSize; //// 本端点接收或发送的最大信息包的大小 
        
       _ _u8 bInterval;      //轮询数据传送端点的时间间隔 
                             //对于批量传送的端点以及控制传送的端点，此域忽略 
                            //对于同步传送的端点，此域必须为1 
                            //对于中 传送的端点，此域值的范围为1～255 
        
       _ _u8 bRefresh; 
       _ _u8 bSynchAddress; 
     } _ _attribute_ _ ((packed)); 

struct usb string descriptor 
      { 
        _ _u8 bLength; // 述符长度 
        _ _u8 bDescriptorType; // 述符类型 
        _ _le16 wData [1];        /* 以UTF-16LE编码 */ 
      } _ _attribute_ _ ((packed)); 

struct usb hcd 

      { 

        /* 管理 “家务” */ 

        struct usb bus self; 
 
        const char *product desc; /* 产品/厂商字符串 */ 

        char irq descr [24]; /* 驱动 + 总线 # */ 
 
         struct timer list rh timer; /* 根Hub 轮询 */ 
                         
         struct urb *status urb; /* 目前的状态urb */ 
      
        /* 硬件信息/状态 */ 
                          
        const struct hc driver *driver; /* 硬件特定的钩子函数 */ 
      
        /* 需要维护的标志 */ 
        unsigned long flags; 
                        
        #define HCD FLAG HW ACCESSIBLE  0x00000001 
                       
        #define HCD FLAG SAW IRQ            0x00000002 
      
        unsigned rh_registered: 1; /* 根Hub 注册？ */ 
      
        /* 下一个标志的采用只是 “权益之计”，当所有HCDs 支持新的根Hub 轮询机制后将移除 */ 
                
        unsigned uses new polling: 1; 
                        
        unsigned poll rh: 1; /* 轮询根Hub 状态? */ 
                         
        unsigned poll pending: 1; /* 状态已经改变? */ 
      
        int irq; /* 被分配的irq */ 

        void _ _iomem *regs; /* 设备内存和I/O */ 

        u64 rsrc start; /* 内存和I/O资源开始位置 */ 

        u64 rsrc len; /* 内存和I/O资源长度 */ 

        unsigned power budget; /* mA, 0 = 无限制 */ 

        #define HCD BUFFER POOLS            4 

        struct dma pool *pool[HCD BUFFER POOLS]; 

        int state; 

        #define     ACTIVE                 0x01 

        #define     SUSPEND                0x04 

        #define     TRANSIENT              0x80 

        #define HC STATE HALT              0 
      
        #define HC STATE RUNNING            (   ACTIVE) 
 
        #define HC STATE QUIESCING   (       SUSPEND|     TRANSIENT|    ACTIVE) 

        #define HC STATE RESUMING           (   SUSPEND|    TRANSIENT) 

        #define HC STATE SUSPENDED          (   SUSPEND) 

        #define HC IS RUNNING (state) ((state) &          ACTIVE) 

        #define HC IS SUSPENDED(state) ((state) &           SUSPEND) 

        /* 主机控制器驱动的私有数据 */ 

　　　　 unsigned long hcd priv [0]    attribute    ((aligned (sizeof(unsigned long)))); 

      };   

struct urb 

　　{ 

        /* 私有的：只能由USB核心和主机控制器访问的字段 */ 
        struct kref kref; /*urb 引用计数 */ 
        
        spinlock t lock; /* urb锁 */ 
        void *hcpriv; /* 主机控制器私有数据 */ 
        int bandwidth; /* INT/ISO请求的带宽 */ 
             
        atomic t use count; /* 并发传输计数 */ 
        u8 reject; /* 传输将失败*/ 

       /* 公共的： 可以被驱动使用的字段 */ 
               
       struct list head urb list; /* 链表头*/ 
               
       struct usb device *dev; /* 关联的USB 设备 */ 
       unsigned int pipe; /* 管道信息 */ 
       int status; /* URB 的当前状态 */ unsigned int transfer flags; /* URB SHORT NOT OK | ...*/ 

 　　　　void *transfer buffer; /* 发送数据到设备或从设备接收数据的缓冲区 */

 　　　　dma addr t transfer dma; /*用来以DMA 方式向设备传输数据的缓冲区 */

 　　　　int transfer buffer length;/*transfer buffer 或 transfer dma 指向缓冲区的大小 */ 

 　　　　int actual length; /* URB 结束后，发送或接收数据的实际长度 */

 　　　　unsigned char *setup packet; /* 指向控制URB 的设置数据包的指针*/

 　　　　dma addr t setup dma; /*控制URB 的设置数据包的DMA 缓冲区*/

 　　　　int start frame; /*等时传输中用于设置或返回初始帧*/

 　　　　int number of packets; /*等时传输中等时缓冲区数据 */
 　　　　int interval; /* URB被轮询到的时间间隔 （对中 和等时urb 有效） */

 　　　　int error count; /* 等时传输错误数量 */
 　　　　void *context; /* completion 函数上下文 */

 　　　　usb complete t complete; /* 当URB 被完全传输或发生错误时，被调用 */

 　　　　struct usb iso packet descriptor iso frame desc[0];
 　　　　/*单个URB 一次可定义多个等时传输时，描述各个等时传输 */

 　　};