Linux USB Gadget--设备枚举

 前面介绍了Linux USB Gadget的软件结构与各软件层的整合过程。经过各种注册函数，Gadget功能驱动层，USB设备层与UDC底层结合在了一起形成了一个完整的USB设备。而这个设备已经准备好了接受主机的枚举。在介绍USB设备枚举之前。先熟悉一下各层通信所用的数据结构，在USB主机端编写USB设备驱动程序，最重要的结构就是URB了，我们只需要将各种URB提交给USB核心，核心就会自动给我们的数据发送到指定的设备。而对于设备端也有这样一个类似的重要的数据结构。这个数据结构就是urt--usb_request。每一个端点都有一个urt链表，上面挂着各种urt。在底层的UDC的中断处理程序中，针对不同的端点调用不同的处理函数，总之是处理端点上的urt链表，处理完一个urt就调用预先设置好的回调函数。这就是设备端数据处理的流程。下面分析一下usb_request结构：

[cpp]  view plain copy

1. struct usb_request {  
2.     void            *buf;  
3.     unsigned        length;  
4.     dma_addr_t      dma;  
5.   
6.     unsigned        no_interrupt:1;  
7.     unsigned        zero:1;  
8.     unsigned        short_not_ok:1;  
9.   
10.     void            (*complete)(struct usb_ep *ep,  
11.                     struct usb_request *req);  
12.     void            *context;  
13.     struct list_head    list;  
14.   
15.     int         status;  
16.     unsigned        actual;  
17. };  

    （1）buf 字段是要接受或者发送数据存储的地方，而length代表了数据的长度。
    （2）dma 是dma_addr_t类型的，有DMA传输有关。虽然s3c2440的USB设备控制器支持DMA操作，但是底层UDC驱动没有实现，所以不用管这个字段了。
    （3）三个位域分别代表了：
    （4）(*complete)(struct usb_ep *ep, struct usb_request *req); 这个是回调函数，在端点处理完一个urt的时候调用，非常重要
    （5）context
    （6）list 作用是将自己链接在端点链表
    （7）status 状态
    （8）actual 实际传输的字节
一. USB设备枚举
        分析完urt，那么就实际进入主机识别USB设备的最关键的设备枚举。这里主要分析设备怎么相应主机，对于主机究竟是怎么完成这些操作的还的找一种主机控制器来研究一下。首先先回顾一下USB设备枚举都要完成那些步骤吧：
（1）设备插入主机，主机检测到设备。复位设备
（2）主机向设备控制端点发送Get_Descriptor来了解设备默认管道的大小。
（3）主机指定一个地址，发送Set_Address标准请求设置设备的地址
（4）主机使用新的地址，再次发送Get_Descriptor或得各种描述符
（5）主机加载一个USB设备驱动
（6）USB设备驱动再发送Set_Confuration标准设备请求配置设备
        以上就是USB设备枚举的过程。USB设备必须正确的相应主机的要求才能顺利的完成设备枚举。我们知道USB是主从式总线结构，全部通信都是由主机发起，设备没有一点自主权。s3c2440 USB设备控制器，当主机向USB设备发送一个包时，USB设备控制器就会产生相应的中断。当出现传输错误的时候，也会以中断的形式来通知。所以理解USB设备控制器的中断是理解USB通信过程的关键。在s3c2410_udc.c在设备初始化的时候已经注册了中断处理程序：

[cpp]  view plain copy

1. static irqreturn_t s3c2410_udc_irq(int dummy, void *_dev)  
2. {  
3. //这个是在设备控制器初始化的时候注册中断处理程序的语句：retval = request_irq(IRQ_USBD, s3c2410_udc_irq, IRQF_DISABLED, gadget_name, udc); 最后一个参数udc是一个struct s3c2410_udc  
4. //的结构体，代表了一个USB设备控制器也就是s3c2410的设备控制器，这个结构体指针指向了一个已经初始化好了的struct s3c2410_udc变量。所以在中断处理程序开始在参数中提取了这个指针。    
5.     struct s3c2410_udc *dev = _dev;  
6.     int usb_status;  
7.     int usbd_status;  
8.     int pwr_reg;  
9.     int ep0csr;  
10.     int i;  
11.     u32 idx;  
12.     unsigned long flags;  
13. //自旋锁，保护dev这个结构避免并发引起的竞态，因为是单处理器。这里的自旋锁退化成了一个禁止内核抢占的开关，上锁就是禁止内核抢占  
14.     spin_lock_irqsave(&dev->lock, flags);  
15.   
16.     /* Driver connected ? */  
17. //当没有初始化好USB设备而发生中断时，清除中断标志  
18.     if (!dev->driver) {  
19.         /* Clear interrupts */  
20.         udc_write(udc_read(S3C2410_UDC_USB_INT_REG),  
21.                 S3C2410_UDC_USB_INT_REG);  
22.         udc_write(udc_read(S3C2410_UDC_EP_INT_REG),  
23.                 S3C2410_UDC_EP_INT_REG);  
24.     }  
25. //s3c2440 USB设备控制器，因为有五个端点，每个端点的寄存器都相似。所以硬件设计的时候将寄存器分组了，名称一样但是物理寄存器不同。S3C2410_UDC_INDEX_REG寄存器代表了哪个组  
26.     /* Save index */  
27.     idx = udc_read(S3C2410_UDC_INDEX_REG);  
28. //读取状态寄存器的值到局部变量中  
29.     /* Read status registers */  
30.     usb_status = udc_read(S3C2410_UDC_USB_INT_REG);  
31.     usbd_status = udc_read(S3C2410_UDC_EP_INT_REG);  
32.     pwr_reg = udc_read(S3C2410_UDC_PWR_REG);  
33. //  
34.     udc_writeb(base_addr, S3C2410_UDC_INDEX_EP0, S3C2410_UDC_INDEX_REG);  
35.     ep0csr = udc_read(S3C2410_UDC_IN_CSR1_REG);  
36. //打印调试信息  
37.     dprintk(DEBUG_NORMAL, "usbs=%02x, usbds=%02x, pwr=%02x ep0csr=%02x\n",  
38.         usb_status, usbd_status, pwr_reg, ep0csr);  
39.   
40.     /* 
41.      * Now, handle interrupts. There's two types : 
42.      * - Reset, Resume, Suspend coming -> usb_int_reg 
43.      * - EP -> ep_int_reg 
44.      */  
45. //下面就是不同的中断处理，复位对应这设备枚举的（1）  
46.     /* RESET */  
47.     if (usb_status & S3C2410_UDC_USBINT_RESET) {  
48.         /* two kind of reset : 
49.          * - reset start -> pwr reg = 8 
50.          * - reset end   -> pwr reg = 0 
51.          **/  
52.         dprintk(DEBUG_NORMAL, "USB reset csr %x pwr %x\n",  
53.             ep0csr, pwr_reg);  
54.   
55.         dev->gadget.speed = USB_SPEED_UNKNOWN;  
56.         udc_write(0x00, S3C2410_UDC_INDEX_REG);  
57.         udc_write((dev->ep[0].ep.maxpacket & 0x7ff) >> 3,  
58.                 S3C2410_UDC_MAXP_REG);  
59.         dev->address = 0;  
60.   
61.         dev->ep0state = EP0_IDLE;  
62.         dev->gadget.speed = USB_SPEED_FULL;  
63.   
64.         /* clear interrupt */  
65.         udc_write(S3C2410_UDC_USBINT_RESET,  
66.                 S3C2410_UDC_USB_INT_REG);  
67.   
68.         udc_write(idx, S3C2410_UDC_INDEX_REG);  
69.         spin_unlock_irqrestore(&dev->lock, flags);  
70.         return IRQ_HANDLED;  
71.     }  
72.   
73.     /* RESUME */  
74.     if (usb_status & S3C2410_UDC_USBINT_RESUME) {  
75.         dprintk(DEBUG_NORMAL, "USB resume\n");  
76.   
77.         /* clear interrupt */  
78.         udc_write(S3C2410_UDC_USBINT_RESUME,  
79.                 S3C2410_UDC_USB_INT_REG);  
80.   
81.         if (dev->gadget.speed != USB_SPEED_UNKNOWN  
82.                 && dev->driver  
83.                 && dev->driver->resume)  
84.             dev->driver->resume(&dev->gadget);  
85.     }  
86.   
87.     /* SUSPEND */  
88.     if (usb_status & S3C2410_UDC_USBINT_SUSPEND) {  
89.         dprintk(DEBUG_NORMAL, "USB suspend\n");  
90.   
91.         /* clear interrupt */  
92.         udc_write(S3C2410_UDC_USBINT_SUSPEND,  
93.                 S3C2410_UDC_USB_INT_REG);  
94.   
95.         if (dev->gadget.speed != USB_SPEED_UNKNOWN  
96.                 && dev->driver  
97.                 && dev->driver->suspend)  
98.             dev->driver->suspend(&dev->gadget);  
99.   
100.         dev->ep0state = EP0_IDLE;  
101.     }  
102.   
103.     /* EP */  
104.     /* control traffic */  
105.     /* check on ep0csr != 0 is not a good idea as clearing in_pkt_ready 
106.      * generate an interrupt 
107.      */  
108.     if (usbd_status & S3C2410_UDC_INT_EP0) {  
109.         dprintk(DEBUG_VERBOSE, "USB ep0 irq\n");  
110.         /* Clear the interrupt bit by setting it to 1 */  
111.         udc_write(S3C2410_UDC_INT_EP0, S3C2410_UDC_EP_INT_REG);  
112.         s3c2410_udc_handle_ep0(dev);  
113.     }  
114.   
115.     /* endpoint data transfers */  
116.     for (i = 1; i < S3C2410_ENDPOINTS; i++) {  
117.         u32 tmp = 1 << i;  
118.         if (usbd_status & tmp) {  
119.             dprintk(DEBUG_VERBOSE, "USB ep%d irq\n", i);  
120.   
121.             /* Clear the interrupt bit by setting it to 1 */  
122.             udc_write(tmp, S3C2410_UDC_EP_INT_REG);  
123.             s3c2410_udc_handle_ep(&dev->ep[i]);  
124.         }  
125.     }  
126.   
127.     dprintk(DEBUG_VERBOSE, "irq: %d s3c2410_udc_done.\n", IRQ_USBD);  
128.   
129.     /* Restore old index */  
130.     udc_write(idx, S3C2410_UDC_INDEX_REG);  
131.   
132.     spin_unlock_irqrestore(&dev->lock, flags);  
133.   
134.     return IRQ_HANDLED;  
135. }  

        这个函数根据不同的中断类型进行处理。设备枚举的时候USB设备控制器产生的中断都是端点0的，所以调用s3c2410_udc_handle_ep0(dev)函数。这个函数也定义在s3c2410_udc.c中，如下:

[cpp]  view plain copy

1. static void s3c2410_udc_handle_ep0(struct s3c2410_udc *dev)  
2. {  
3.     u32         ep0csr;  
4.     struct s3c2410_ep   *ep = &dev->ep[0];  
5.     struct s3c2410_request  *req;  
6.     struct usb_ctrlrequest  crq;  
7.   
8.     if (list_empty(&ep->queue))  
9.         req = NULL;  
10.     else  
11.         req = list_entry(ep->queue.next, struct s3c2410_request, queue);  
12.   
13.     /* We make the assumption that S3C2410_UDC_IN_CSR1_REG equal to 
14.      * S3C2410_UDC_EP0_CSR_REG when index is zero */  
15.   
16.     udc_write(0, S3C2410_UDC_INDEX_REG);  
17.     ep0csr = udc_read(S3C2410_UDC_IN_CSR1_REG);  
18.   
19.     dprintk(DEBUG_NORMAL, "ep0csr %x ep0state %s\n",  
20.         ep0csr, ep0states[dev->ep0state]);  
21.   
22.     /* clear stall status */  
23.     if (ep0csr & S3C2410_UDC_EP0_CSR_SENTSTL) {  
24.         s3c2410_udc_nuke(dev, ep, -EPIPE);  
25.         dprintk(DEBUG_NORMAL, "... clear SENT_STALL ...\n");  
26.         s3c2410_udc_clear_ep0_sst(base_addr);  
27.         dev->ep0state = EP0_IDLE;  
28.         return;  
29.     }  
30.   
31.     /* clear setup end */  
32.     if (ep0csr & S3C2410_UDC_EP0_CSR_SE) {  
33.         dprintk(DEBUG_NORMAL, "... serviced SETUP_END ...\n");  
34.         s3c2410_udc_nuke(dev, ep, 0);  
35.         s3c2410_udc_clear_ep0_se(base_addr);  
36.         dev->ep0state = EP0_IDLE;  
37.     }  
38.   
39.     switch (dev->ep0state) {  
40.     case EP0_IDLE:  
41.         s3c2410_udc_handle_ep0_idle(dev, ep, &crq, ep0csr);  
42.         break;  
43.   
44.     case EP0_IN_DATA_PHASE:         /* GET_DESCRIPTOR etc */  
45.         dprintk(DEBUG_NORMAL, "EP0_IN_DATA_PHASE ... what now?\n");  
46.         if (!(ep0csr & S3C2410_UDC_EP0_CSR_IPKRDY) && req) {  
47.             s3c2410_udc_write_fifo(ep, req);  
48.         }  
49.         break;  
50.   
51.     case EP0_OUT_DATA_PHASE:        /* SET_DESCRIPTOR etc */  
52.         dprintk(DEBUG_NORMAL, "EP0_OUT_DATA_PHASE ... what now?\n");  
53.         if ((ep0csr & S3C2410_UDC_EP0_CSR_OPKRDY) && req ) {  
54.             s3c2410_udc_read_fifo(ep,req);  
55.         }  
56.         break;  
57.   
58.     case EP0_END_XFER:  
59.         dprintk(DEBUG_NORMAL, "EP0_END_XFER ... what now?\n");  
60.         dev->ep0state = EP0_IDLE;  
61.         break;  
62.   
63.     case EP0_STALL:  
64.         dprintk(DEBUG_NORMAL, "EP0_STALL ... what now?\n");  
65.         dev->ep0state = EP0_IDLE;  
66.         break;  
67.     }  
68. }  

        看这个函数之前，先要看一个struct s3c2410_ep这个数据结构，这个数据结构代表一个s3c2410 usb设备控制器的一个端点。结构如下： 

[cpp]  view plain copy

1. struct s3c2410_ep {  
2.     struct list_head        queue;  
3.     unsigned long           last_io;    /* jiffies timestamp */  
4.     struct usb_gadget       *gadget;  
5.     struct s3c2410_udc      *dev;  
6.     const struct usb_endpoint_descriptor *desc;  
7.     struct usb_ep           ep;  
8.     u8              num;  
9.   
10.     unsigned short          fifo_size;  
11.     u8              bEndpointAddress;  
12.     u8              bmAttributes;  
13.   
14.     unsigned            halted : 1;  
15.     unsigned            already_seen : 1;  
16.     unsigned            setup_stage : 1;  
17. };  

        这结构的成员一部分是在定义的时候静态初始化的，端点0在定义的时候如下初始化：

[cpp]  view plain copy

1. .ep[0] = {  
2.     .num        = 0,  
3.     .ep = {  
4.         .name       = ep0name,  
5.         .ops        = &s3c2410_ep_ops,  
6.         .maxpacket  = EP0_FIFO_SIZE,  
7.     },  
8.     .dev        = &memory,  
9. },  

        看完struct s3c2410_ep结构后，再来分析s3c2410_udc_handle_ep0这个函数。函数首先判断ep的queue是否为空，这个字段链接了struct s3c2410_request结构的链表，struct s3c2410_request是struct usb_request的简单封装，代表一个一次usb传输。如果不为空那么，取到这个成员赋值给req变量。接下来读取端点0的状态寄存器EP0_CSR，这个寄存器反映了端点0的状态。将端点0的状态读到ep0csr局部变量中。这时在中断处理程序中。按照USB设备枚举的过程，最先发生的中断是复位。然后USB主机就会发起一次控制传输来获得设备描述符。这个控制传输是Get_Descriptor标准设备请求。我们知道USB控制传输有数据传输的分为三个阶段，没有数据传输的分为两个阶段。而Get_Descriptor是有数据传输的，USB设备要返回设备描述符号。所以有三个阶段：分别是建立阶段，数据阶段，状态阶段。建立阶段分为三个USB数据包：分别是setup包，data包，与握手包。当建立阶段完毕后，data包的数据会写入端点0的FIFO，s3c2410 USB设备控制器就会产生中断，对应的EP0_CSR的SETUP_END 位就会置位。这时可以判断这个状态。然后调用相应的函数读取在FIFO的数据，判断是控制传输的类型，然后针对不同的类型采取不同的操作，或接受数据，或发送数据。现在针对Get_Descriptor这个USB标准请求来分析一下s3c2410_udc_handle_ep0函数中代码的执行：
（1）首先，建立阶段完成中断，执行如下代码：

[cpp]  view plain copy

1.       if (ep0csr & S3C2410_UDC_EP0_CSR_SE) {  
2. dprintk(DEBUG_NORMAL, "... serviced SETUP_END ...\n");  
3. s3c2410_udc_nuke(dev, ep, 0);  
4. s3c2410_udc_clear_ep0_se(base_addr);  
5. dev->ep0state = EP0_IDLE;  
6.    

（2）然后，因为dev->ep0state = EP0_IDLE所以执行如下代码：

[cpp]  view plain copy

1. case EP0_IDLE:  
2.     s3c2410_udc_handle_ep0_idle(dev, ep, &crq, ep0csr);  
3.     break;  

        s3c2410_udc_handle_ep0_idle函数也定义在s3c2410_udc.c中，如下：

[cpp]  view plain copy

1. static void s3c2410_udc_handle_ep0_idle(struct s3c2410_udc *dev,  
2.                     struct s3c2410_ep *ep,  
3.                     struct usb_ctrlrequest *crq,  
4.                     u32 ep0csr)  
5. {  
6.     int len, ret, tmp;  
7.   
8.     /* start control request? */  
9.     if (!(ep0csr & S3C2410_UDC_EP0_CSR_OPKRDY))  
10.         return;  
11.   
12.     s3c2410_udc_nuke(dev, ep, -EPROTO);  
13.   
14.     len = s3c2410_udc_read_fifo_crq(crq);  
15.     if (len != sizeof(*crq)) {  
16.         dprintk(DEBUG_NORMAL, "setup begin: fifo READ ERROR"  
17.             " wanted %d bytes got %d. Stalling out...\n",  
18.             sizeof(*crq), len);  
19.         s3c2410_udc_set_ep0_ss(base_addr);  
20.         return;  
21.     }  
22.   
23.     dprintk(DEBUG_NORMAL, "bRequest = %d bRequestType %d wLength = %d\n",  
24.         crq->bRequest, crq->bRequestType, crq->wLength);  
25.   
26.     /* cope with automagic for some standard requests. */  
27.     dev->req_std = (crq->bRequestType & USB_TYPE_MASK)  
28.         == USB_TYPE_STANDARD;  
29.     dev->req_config = 0;  
30.     dev->req_pending = 1;  
31.   
32.     switch (crq->bRequest) {  
33.     case USB_REQ_SET_CONFIGURATION:  
34.         dprintk(DEBUG_NORMAL, "USB_REQ_SET_CONFIGURATION ... \n");  
35.   
36.         if (crq->bRequestType == USB_RECIP_DEVICE) {  
37.             dev->req_config = 1;  
38.             s3c2410_udc_set_ep0_de_out(base_addr);  
39.         }  
40.         break;  
41.   
42.     case USB_REQ_SET_INTERFACE:  
43.         dprintk(DEBUG_NORMAL, "USB_REQ_SET_INTERFACE ... \n");  
44.   
45.         if (crq->bRequestType == USB_RECIP_INTERFACE) {  
46.             dev->req_config = 1;  
47.             s3c2410_udc_set_ep0_de_out(base_addr);  
48.         }  
49.         break;  
50.   
51.     case USB_REQ_SET_ADDRESS:  
52.         dprintk(DEBUG_NORMAL, "USB_REQ_SET_ADDRESS ... \n");  
53.   
54.         if (crq->bRequestType == USB_RECIP_DEVICE) {  
55.             tmp = crq->wValue & 0x7F;  
56.             dev->address = tmp;  
57.             udc_write((tmp | S3C2410_UDC_FUNCADDR_UPDATE),  
58.                     S3C2410_UDC_FUNC_ADDR_REG);  
59.             s3c2410_udc_set_ep0_de_out(base_addr);  
60.             return;  
61.         }  
62.         break;  
63.   
64.     case USB_REQ_GET_STATUS:  
65.         dprintk(DEBUG_NORMAL, "USB_REQ_GET_STATUS ... \n");  
66.         s3c2410_udc_clear_ep0_opr(base_addr);  
67.   
68.         if (dev->req_std) {  
69.             if (!s3c2410_udc_get_status(dev, crq)) {  
70.                 return;  
71.             }  
72.         }  
73.         break;  
74.   
75.     case USB_REQ_CLEAR_FEATURE:  
76.         s3c2410_udc_clear_ep0_opr(base_addr);  
77.   
78.         if (crq->bRequestType != USB_RECIP_ENDPOINT)  
79.             break;  
80.   
81.         if (crq->wValue != USB_ENDPOINT_HALT || crq->wLength != 0)  
82.             break;  
83.   
84.         s3c2410_udc_set_halt(&dev->ep[crq->wIndex & 0x7f].ep, 0);  
85.         s3c2410_udc_set_ep0_de_out(base_addr);  
86.         return;  
87.   
88.     case USB_REQ_SET_FEATURE:  
89.         s3c2410_udc_clear_ep0_opr(base_addr);  
90.   
91.         if (crq->bRequestType != USB_RECIP_ENDPOINT)  
92.             break;  
93.   
94.         if (crq->wValue != USB_ENDPOINT_HALT || crq->wLength != 0)  
95.             break;  
96.   
97.         s3c2410_udc_set_halt(&dev->ep[crq->wIndex & 0x7f].ep, 1);  
98.         s3c2410_udc_set_ep0_de_out(base_addr);  
99.         return;  
100.   
101.     default:  
102.         s3c2410_udc_clear_ep0_opr(base_addr);  
103.         break;  
104.     }  
105.   
106.     if (crq->bRequestType & USB_DIR_IN)  
107.         dev->ep0state = EP0_IN_DATA_PHASE;  
108.     else  
109.         dev->ep0state = EP0_OUT_DATA_PHASE;  
110.   
111.     ret = dev->driver->setup(&dev->gadget, crq);  
112.     if (ret < 0) {  
113.         if (dev->req_config) {  
114.             dprintk(DEBUG_NORMAL, "config change %02x fail %d?\n",  
115.                 crq->bRequest, ret);  
116.             return;  
117.         }  
118.   
119.         if (ret == -EOPNOTSUPP)  
120.             dprintk(DEBUG_NORMAL, "Operation not supported\n");  
121.         else  
122.             dprintk(DEBUG_NORMAL,  
123.                 "dev->driver->setup failed. (%d)\n", ret);  
124.   
125.         udelay(5);  
126.         s3c2410_udc_set_ep0_ss(base_addr);  
127.         s3c2410_udc_set_ep0_de_out(base_addr);  
128.         dev->ep0state = EP0_IDLE;  
129.         /* deferred i/o == no response yet */  
130.     } else if (dev->req_pending) {  
131.         dprintk(DEBUG_VERBOSE, "dev->req_pending... what now?\n");  
132.         dev->req_pending=0;  
133.     }  
134.   
135.     dprintk(DEBUG_VERBOSE, "ep0state %s\n", ep0states[dev->ep0state]);  
136. }  

        这个函数所做的主要工作就是读取端点0 FIFO中的数据，这里的数据就是控制传输的类型。然后通过一个switch语句来判断到底是什么控制传输。根据控制传输的不同类型采用不同的操作。这里我们假设的是Get_Descriptor。那么switch语句都不执行，执行下面的语句，这些是针对有数据传输的控制传输。Get_Descriptor的方向是IN，所以dev->ep0state = EP0_IN_DATA_PHASE设备端点状态。然后执行下面的预计 ret = dev->driver->setup(&dev->gadget, crq);在这里dev->driver->setup已经初始化好了是composite_setup，在composite.c中定义，如下：

[cpp]  view plain copy

1. static int  
2. composite_setup(struct usb_gadget *gadget, const struct usb_ctrlrequest *ctrl)  
3. {  
4.     struct usb_composite_dev    *cdev = get_gadget_data(gadget);  
5.     struct usb_request      *req = cdev->req;  
6.     int             value = -EOPNOTSUPP;  
7.     u16             w_index = le16_to_cpu(ctrl->wIndex);  
8.     u8              intf = w_index & 0xFF;  
9.     u16             w_value = le16_to_cpu(ctrl->wValue);  
10.     u16             w_length = le16_to_cpu(ctrl->wLength);  
11.     struct usb_function     *f = NULL;  
12.   
13.     /* partial re-init of the response message; the function or the 
14.      * gadget might need to intercept e.g. a control-OUT completion 
15.      * when we delegate to it. 
16.      */  
17.     req->zero = 0;  
18.     req->complete = composite_setup_complete;  
19.     req->length = USB_BUFSIZ;  
20.     gadget->ep0->driver_data = cdev;  
21.   
22.     switch (ctrl->bRequest) {  
23.   
24.     /* we handle all standard USB descriptors */  
25.     case USB_REQ_GET_DESCRIPTOR:  
26.         if (ctrl->bRequestType != USB_DIR_IN)  
27.             goto unknown;  
28.         switch (w_value >> 8) {  
29.   
30.         case USB_DT_DEVICE:  
31.             cdev->desc.bNumConfigurations =  
32.                 count_configs(cdev, USB_DT_DEVICE);  
33.             value = min(w_length, (u16) sizeof cdev->desc);  
34.             memcpy(req->buf, &cdev->desc, value);  
35.             break;  
36.         case USB_DT_DEVICE_QUALIFIER:  
37.             if (!gadget_is_dualspeed(gadget))  
38.                 break;  
39.             device_qual(cdev);  
40.             value = min_t(int, w_length,  
41.                 sizeof(struct usb_qualifier_descriptor));  
42.             break;  
43.         case USB_DT_OTHER_SPEED_CONFIG:  
44.             if (!gadget_is_dualspeed(gadget))  
45.                 break;  
46.             /* FALLTHROUGH */  
47.         case USB_DT_CONFIG:  
48.             value = config_desc(cdev, w_value);  
49.             if (value >= 0)  
50.                 value = min(w_length, (u16) value);  
51.             break;  
52.         case USB_DT_STRING:  
53.             value = get_string(cdev, req->buf,  
54.                     w_index, w_value & 0xff);  
55.             if (value >= 0)  
56.                 value = min(w_length, (u16) value);  
57.             break;  
58.         }  
59.         break;  
60.   
61.     /* any number of configs can work */  
62.     case USB_REQ_SET_CONFIGURATION:  
63.         if (ctrl->bRequestType != 0)  
64.             goto unknown;  
65.         if (gadget_is_otg(gadget)) {  
66.             if (gadget->a_hnp_support)  
67.                 DBG(cdev, "HNP available\n");  
68.             else if (gadget->a_alt_hnp_support)  
69.                 DBG(cdev, "HNP on another port\n");  
70.             else  
71.                 VDBG(cdev, "HNP inactive\n");  
72.         }  
73.         spin_lock(&cdev->lock);  
74.         value = set_config(cdev, ctrl, w_value);  
75.         spin_unlock(&cdev->lock);  
76.         break;  
77.     case USB_REQ_GET_CONFIGURATION:  
78.         if (ctrl->bRequestType != USB_DIR_IN)  
79.             goto unknown;  
80.         if (cdev->config)  
81.             *(u8 *)req->buf = cdev->config->bConfigurationValue;  
82.         else  
83.             *(u8 *)req->buf = 0;  
84.         value = min(w_length, (u16) 1);  
85.         break;  
86.   
87.     /* function drivers must handle get/set altsetting; if there's 
88.      * no get() method, we know only altsetting zero works. 
89.      */  
90.     case USB_REQ_SET_INTERFACE:  
91.         if (ctrl->bRequestType != USB_RECIP_INTERFACE)  
92.             goto unknown;  
93.         if (!cdev->config || w_index >= MAX_CONFIG_INTERFACES)  
94.             break;  
95.         f = cdev->config->interface[intf];  
96.         if (!f)  
97.             break;  
98.         if (w_value && !f->set_alt)  
99.             break;  
100.         value = f->set_alt(f, w_index, w_value);  
101.         break;  
102.     case USB_REQ_GET_INTERFACE:  
103.         if (ctrl->bRequestType != (USB_DIR_IN|USB_RECIP_INTERFACE))  
104.             goto unknown;  
105.         if (!cdev->config || w_index >= MAX_CONFIG_INTERFACES)  
106.             break;  
107.         f = cdev->config->interface[intf];  
108.         if (!f)  
109.             break;  
110.         /* lots of interfaces only need altsetting zero... */  
111.         value = f->get_alt ? f->get_alt(f, w_index) : 0;  
112.         if (value < 0)  
113.             break;  
114.         *((u8 *)req->buf) = value;  
115.         value = min(w_length, (u16) 1);  
116.         break;  
117.     default:  
118. unknown:  
119.         VDBG(cdev,  
120.             "non-core control req%02x.%02x v%04x i%04x l%d\n",  
121.             ctrl->bRequestType, ctrl->bRequest,  
122.             w_value, w_index, w_length);  
123.   
124.         /* functions always handle their interfaces ... punt other 
125.          * recipients (endpoint, other, WUSB, ...) to the current 
126.          * configuration code. 
127.          * 
128.          * REVISIT it could make sense to let the composite device 
129.          * take such requests too, if that's ever needed:  to work 
130.          * in config 0, etc. 
131.          */  
132.         if ((ctrl->bRequestType & USB_RECIP_MASK)  
133.                 == USB_RECIP_INTERFACE) {  
134.             f = cdev->config->interface[intf];  
135.             if (f && f->setup)  
136.                 value = f->setup(f, ctrl);  
137.             else  
138.                 f = NULL;  
139.         }  
140.         if (value < 0 && !f) {  
141.             struct usb_configuration    *c;  
142.   
143.             c = cdev->config;  
144.             if (c && c->setup)  
145.                 value = c->setup(c, ctrl);  
146.         }  
147.   
148.         goto done;  
149.     }  
150.   
151.     /* respond with data transfer before status phase? */  
152.     if (value >= 0) {  
153.         req->length = value;  
154.         req->zero = value < w_length;  
155.         value = usb_ep_queue(gadget->ep0, req, GFP_ATOMIC);  
156.         if (value < 0) {  
157.             DBG(cdev, "ep_queue --> %d\n", value);  
158.             req->status = 0;  
159.             composite_setup_complete(gadget->ep0, req);  
160.         }  
161.     }  
162.   
163. done:  
164.     /* device either stalls (value < 0) or reports success */  
165.     return value;  
166. }  

        这个函数首先提取出USB控制请求的各个字段，然后初始化了端点0的struct usb_request结构。设置了完成回调函数composite_setup_complete。这时通过switch语句来判断是何种控制传输。比如这里是Get_Descriptor，而且设备枚举的时候这时只获取设备描述符的前八个字节以了解端点0的FIFO深度。所以下面的代码执行：

[cpp]  view plain copy

1. cdev->desc.bNumConfigurations =  
2.     count_configs(cdev, USB_DT_DEVICE);  
3. value = min(w_length, (u16) sizeof cdev->desc);  
4. memcpy(req->buf, &cdev->desc, value);  

        这段代码就是复制设备描述符到req的缓冲区。然后执行下面的代码：

[cpp]  view plain copy

1. if (value >= 0) {  
2.     req->length = value;  
3.     req->zero = value < w_length;  
4.     value = usb_ep_queue(gadget->ep0, req, GFP_ATOMIC);  
5.     if (value < 0) {  
6.         DBG(cdev, "ep_queue --> %d\n", value);  
7.         req->status = 0;  
8.         composite_setup_complete(gadget->ep0, req);  
9.     }  
10. }  

        这时value不为0，所以if里面的语句执行。usb_ep_queue函数主要作用就是将req中的数据写入到FIFO中。函数如下定义：

[cpp]  view plain copy

1. static int s3c2410_udc_queue(struct usb_ep *_ep, struct usb_request *_req,  
2.         gfp_t gfp_flags)  
3. {  
4.     struct s3c2410_request  *req = to_s3c2410_req(_req);  
5.     struct s3c2410_ep   *ep = to_s3c2410_ep(_ep);  
6.     struct s3c2410_udc  *dev;  
7.     u32         ep_csr = 0;  
8.     int         fifo_count = 0;  
9.     unsigned long       flags;  
10.   
11.     if (unlikely (!_ep || (!ep->desc && ep->ep.name != ep0name))) {  
12.         dprintk(DEBUG_NORMAL, "%s: invalid args\n", __func__);  
13.         return -EINVAL;  
14.     }  
15.   
16.     dev = ep->dev;  
17.     if (unlikely (!dev->driver  
18.             || dev->gadget.speed == USB_SPEED_UNKNOWN)) {  
19.         return -ESHUTDOWN;  
20.     }  
21. //以上检查参数合法性  
22.     local_irq_save (flags);  
23.   
24.     if (unlikely(!_req || !_req->complete  
25.             || !_req->buf || !list_empty(&req->queue))) {  
26.         if (!_req)  
27.             dprintk(DEBUG_NORMAL, "%s: 1 X X X\n", __func__);  
28.         else {  
29.             dprintk(DEBUG_NORMAL, "%s: 0 %01d %01d %01d\n",  
30.                 __func__, !_req->complete,!_req->buf,  
31.                 !list_empty(&req->queue));  
32.         }  
33.   
34.         local_irq_restore(flags);  
35.         return -EINVAL;  
36.     }  
37.   
38.     _req->status = -EINPROGRESS;  
39.     _req->actual = 0;  
40. //表示传输正在处理中  
41.     dprintk(DEBUG_VERBOSE, "%s: ep%x len %d\n",  
42.          __func__, ep->bEndpointAddress, _req->length);  
43.   
44.     if (ep->bEndpointAddress) { //以下是针对普通端点的，对于端点0执行else以后的语句  
45.         udc_write(ep->bEndpointAddress & 0x7F, S3C2410_UDC_INDEX_REG);  
46.         ep_csr = udc_read((ep->bEndpointAddress & USB_DIR_IN)  
47.                 ? S3C2410_UDC_IN_CSR1_REG  
48.                 : S3C2410_UDC_OUT_CSR1_REG);  
49.   
50.         fifo_count = s3c2410_udc_fifo_count_out();  
51.     } else { //端点0  
52.         udc_write(0, S3C2410_UDC_INDEX_REG);  
53.         ep_csr = udc_read(S3C2410_UDC_IN_CSR1_REG);  
54.         fifo_count = s3c2410_udc_fifo_count_out(); //读出当前fifo的位置  
55.     }  
56.   
57.     /* kickstart this i/o queue? */  
58.     if (list_empty(&ep->queue) && !ep->halted) { //如果端点的urt链表为空,而端点正常，执行下面的语句，这正是目前的情况，所以下面的语句执行  
59.         if (ep->bEndpointAddress == 0 /* ep0 */) {  
60.             switch (dev->ep0state) {  
61.             case EP0_IN_DATA_PHASE: //对于Get_Descriptor，在s3c2410_udc_handle_ep0_idle中已经设置dev->ep0state为EP0_IN_DATA_PHASE了所以下面的代码执行  
62.                 if (!(ep_csr&S3C2410_UDC_EP0_CSR_IPKRDY)  
63.                         && s3c2410_udc_write_fifo(ep,  
64.                             req)) {  
65.                     dev->ep0state = EP0_IDLE;  
66.                     req = NULL;  
67.                 }  
68.                 break;  
69.           //以上代码才真正的将urt的数据写入USB设备控制器端点0的FIFO，这里有一个条件就是S3C2410_UDC_EP0_CSR_IPKRDY应该为0，USB设备控制器将FIFO中的内容发送出去会设置S3C2410_UDC_EP0_CSR_IPKRDY  
70.           //为0，当我们将数据写入FIFO中，设置S3C2410_UDC_EP0_CSR_IPKRDY为1。s3c2410_udc_write_fifo函数完成的就是这个功能  
71.             case EP0_OUT_DATA_PHASE:  
72.                 if ((!_req->length)  
73.                     || ((ep_csr & S3C2410_UDC_OCSR1_PKTRDY)  
74.                         && s3c2410_udc_read_fifo(ep,  
75.                             req))) {  
76.                     dev->ep0state = EP0_IDLE;  
77.                     req = NULL;  
78.                 }  
79.                 break;  
80.   
81.             default:  
82.                 local_irq_restore(flags);  
83.                 return -EL2HLT;  
84.             }  
85.         } else if ((ep->bEndpointAddress & USB_DIR_IN) != 0  
86.                 && (!(ep_csr&S3C2410_UDC_OCSR1_PKTRDY))  
87.                 && s3c2410_udc_write_fifo(ep, req)) {  
88.             req = NULL;  
89.         } else if ((ep_csr & S3C2410_UDC_OCSR1_PKTRDY)  
90.                 && fifo_count  
91.                 && s3c2410_udc_read_fifo(ep, req)) {  
92.             req = NULL;  
93.         }  
94.     }  
95.   
96.     /* pio or dma irq handler advances the queue. */  
97.     if (likely (req != 0)) //对于控制传输这时req为0所以一下代码不执行，这里likely说明req不为0的情况居多，这是针对普通端点来说的  
98.         list_add_tail(&req->queue, &ep->queue);  
99.   
100.     local_irq_restore(flags);  
101.   
102.     dprintk(DEBUG_VERBOSE, "%s ok\n", __func__);  
103.     return 0;  
104. }  

        函数返回到了composite_setup中，再把代码贴上来：

[cpp]  view plain copy

1. if (value >= 0) {  
2.     req->length = value;  
3.     req->zero = value < w_length;  
4.     value = usb_ep_queue(gadget->ep0, req, GFP_ATOMIC);  
5.     if (value < 0) {  
6.         DBG(cdev, "ep_queue --> %d\n", value);  
7.         req->status = 0;  
8.         composite_setup_complete(gadget->ep0, req);  
9.     }  
10. }  

        现在执行到了if (value < 0) { 这里对于上面的分析value是0所以下面的代码不执行。composite_setup函数也就返回了。返回到了 s3c2410_udc_handle_ep0_idle。因为没有出错， s3c2410_udc_handle_ep0_idle函数也返回了。返回到了s3c2410_udc_handle_ep0中，这时dev->ep0state还是EP0_IDLE状态。所以s3c2410_udc_handle_ep0也返回了。最后中断返回完成了这个控制传输。至于控制传输的状态阶段是由硬件来完成的。当我们向FIFO中写入了全部的数据，就可以设置EP0_CSR寄存器的DATA_END为1，硬件将自动完成状态阶段。还有一点，控制传输的urt回调函数非常简单，只打印一些调试信息，当最后一次调用s3c2410_udc_read_fifo时，s3c2410_udc_read_fifo会在函数里面调用urt的回调函数。

        以上分析了USB设备枚举过程中的第二步：Get_Descriptor阶段的控制传输。其他的步骤大同小异，都是主机端发起，然后USB设备通过中端来处理。依次经过文中最前面提到的六步，USB主机就识别咱们的设备了 。

转自：http://blog.csdn.net/yaozhenguo2006/article/details/7748896