|
SETUP事件正确接收后,根据该事件提供的请求类型进行对主机的响应。SETUP数据结构的wLength字段说明的是请求返回或者提供的数据长度。 - v: G. G& k1 D6 m5 G. o 如果判断出的请求信息错误或者说不被支持,STM32 USB设备需要中断此次请求: + L" I' Z4 u A& E& m' R ^ SetEPR_RXStatus(ENDP0, EP_RX_VALID); SetEPR_TXStatus(ENDP0, EP_TX_STALL); 正确获取到请求信息后,如果wLength为0,设备需要发送一个0长度数据包以响应主机: // ***************************************************************************** 7 F6 b2 F' z! ? // Function Name : SETUP0_Trans0Data // Description : o$ D7 e6 L: b // Input : ; L0 M! @, d! m1 ~ // Output : ! ^; u7 y/ l5 f) E; T2 b% X // Return : % \. p+ f/ r1 l3 Q8 p7 i // ***************************************************************************** RESULT SETUP0_Trans0Data(void) * W- u2 k7 A0 N { ! a" n9 R- Z, z7 m" c8 b$ o // Send 0-length data frame as ACK to host SetBuffDescTable_TXCount(ENDP0, 0); SetEPR_RXStatus(ENDP0, EP_RX_NAK); SetEPR_TXStatus(ENDP0, EP_TX_VALID); return RESULT_SUCCESS; } 如果wLength不为0,设备则需要根据请求的数据长度发送数据包以响应主机: 0 x- X9 {+ M8 e4 I% B3 ?1 j // ***************************************************************************** & o- J7 Q; v8 }) R- m X4 B3 Y0 ~ // Function Name : SETUP0_TransData // Description : & N$ E1 `% \, v% J // Input : // Output : 6 Y! i: u7 ^' r" z) K8 g" } // Return : ; J) B1 M0 o3 Q& y4 M! r2 N // ***************************************************************************** RESULT SETUP0_TransData(void) R8 u' N { O1 O { 2 t% f! E3 U" Z; ]; F. D unsigned short wLength = vsDeviceInfo.TransInfo.wLength; Z+ r1 U8 c3 U( v unsigned short wOffset = vsDeviceInfo.TransInfo.wOffset; unsigned short wMaxSize = vsDeviceInfo.TransInfo.wPacketSize; + |, \/ |9 F, T* `2 W if(wLength) { . j- v/ x5 c3 N% P8 D2 K1 M if(wLength > wMaxSize) { wLength = wMaxSize; 1 c/ W. I7 [" U( \" u2 G. {# D( C } N) \1 E; B! w: y) P 4 Y, m3 X2 A9 c" S# E3 j // Copy the transfer buffer to the endpoint0's buffer BufferCopy_UserToPMA( vsDeviceInfo.TransInfo.pBuffer+wOffset, // transfer buffer GetBuffDescTable_TXAddr(ENDP0), // endpoint 0 TX address + J5 [7 x6 x3 {2 R8 L% |, h wLength); ! O* o8 Y7 r4 p# x5 D ) a* }4 r5 f/ n SetBuffDescTable_TXCount(ENDP0, wLength); 0 W; `/ f2 T8 O SetEPR_RXStatus(ENDP0, EP_RX_NAK); SetEPR_TXStatus(ENDP0, EP_TX_VALID); 4 ~+ Z! l( Z+ o % e2 \- t% y, {" B* m& o5 t% f // Update the data lengths vsDeviceInfo.TransInfo.wLength -= wLength; x3 p( ]* U5 K* B( G vsDeviceInfo.TransInfo.wOffset += wLength; , G4 _% t, |1 A5 x/ i. ~ return RESULT_LASTDATA; ( ]% _' O1 }9 S, t6 z8 e: N! @+ G } ! O( S; l) Z$ [% M; [ 1 F" q* I4 Q. D return RESULT_SUCCESS; } 如果发送的数据长度大于端点设置的最大数据包长度,数据将分割为若干次发送,记录发送数据的状态包含在结构体TRANSFER_INFO中: // ***************************************************************************** ! O# w- m( w/ q' F- k" ~ // TRANSFER_INFO ! S4 ~+ l- U+ x( _7 ?, ` // ***************************************************************************** typedef struct _TRANSFER_INFO 5 [# V+ f* {" v' R { unsigned short wLength; // total lengths data will be transmit - U! Y1 a q, F' y6 N; F. ^2 X% @ unsigned short wOffset; // number of data be transmited 3 n' \ F7 g# `# Y/ A) D4 N, ? unsigned short wPacketSize; // endpoints packet max size ) P0 |" b/ V) u6 ~& J, f# a0 K9 {! J unsigned char* pBuffer; // address of data buffer , s: J% Z) E- } } 1 ?( n; c/ M& }" R/ Q- o TRANSFER_INFO, / Z) D. v2 }8 P( F! z' a *PTRANSFER_INFO; 8 Y- D% d; ^! }/ l3 M* r TRANSFER_INFO.wLength记录发送的数据长度,如果非0,表示有数据需要被发送。 % _% P3 L. l- W0 K& X9 B+ ^ TRANSFER_INFO.wOffset记录已发送的数据长度,用以确定数据缓冲TRANSFER_INFO.pBuffer的偏移量。 需要了解的一点:USB主机向USB设备正确发送一请求后(这部分的处理由硬件完成),USB主机将间隔若干次的向USB设备索取响应数据,STM32 USB TX状态为NAK说明不响应USB主机,USB主机在超时后退出此次请求;TX状态为STLL说明中断此次请求,USB主机将无条件退出请求;TX状态为 VALID说明设备已准备好数据发送,USB主机将从USB设备读取数据。 以非0长度数据请求的GET_DESCRIPTOR请求为例的响应过程: CTR_SETUP0()->SETUP0_Data()->SR_GetDescriptor()->SETUP0_TransData() 1 u M) E* a8 T& J9 U* B/ Z 1 o" P& A9 w- k+ M: I) _& J% Z& u4 x RESULT SR_GetDescriptor(void) { // RequestType: device->host, standard request and device recipient 4 {8 {6 Y# G2 a! y$ _4 i6 A- j if(vsDeviceInfo.SetupData.bmRequestType == RT_D2H_STANDARD_DEVICE) ; O: E! l+ h' R$ j0 F; H { 2 E3 u. u( m$ d7 ? D // SetupData.wValue.b.MSB: descriptor type & _$ Z1 F8 e8 ` // SetupData.wValue.b.LSB: descriptor index 4 H: ?$ ?, n8 M9 S# b# o switch(vsDeviceInfo.SetupData.wValue.b.MSB) * v7 d g4 z: [ { % f0 S3 M. ?7 ] case DESCRIPTOR_DEVICE: return SR_GetDescriptor_Device(); case DESCRIPTOR_CONFIG: return SR_GetDescriptor_Config(); case DESCRIPTOR_STRING: return SR_GetDescriptor_String(); ' \ X2 u, S4 J! J9 ~ default: return RESULT_UNSUPPORT; } 1 }7 {. ?* T$ q2 g( @; ?( {, F; ] } return RESULT_UNSUPPORT; } + P( i: N- Z1 s' e GET_DESCRIPTOR请求属于USB协议中的标准请求(standard request)并且数据方向为设备至主机(device->host),分设备描述符、配置描述符、字符串描述符三种。已设备描述符为例: RESULT SR_GetDescriptor_Device(void) { // Assigned the device descriptor to the transfer vsDeviceInfo.TransInfo.wOffset = 0; vsDeviceInfo.TransInfo.wPacketSize = ENDP0_PACKETSIZE; vsDeviceInfo.TransInfo.pBuffer = DescBuffer_Device.pBuff; 8 i- [0 u3 @8 D4 ~3 S vsDeviceInfo.TransInfo.wLength = DescBuffer_Device.wLen; ! j' B$ S0 a! J c; `) g7 V: _( | vsDeviceInfo.eControlState = CS_GET_DESCRIPTOR; 9 Q |. m; ^* |( R r" _ if(vsDeviceInfo.TransInfo.wLength > vsDeviceInfo.SetupData.wLength.w) { vsDeviceInfo.TransInfo.wLength = vsDeviceInfo.SetupData.wLength.w; # q0 X! w, i" d4 C1 W7 W } 8 C" }( D/ e+ C3 y, F& P* U return SETUP0_TransData(); } 这里说明了发送数据的长度、缓冲、偏移、端点包大小以及当前的控制状态,并说明了如果发送的数据长度超出请求的数据长度,则将舍弃超出的部分。数据配置好后,调用SETUP0_TransData()进行数据发送。 % A% p' E3 W% m0 ^4 |5 ~* t8 j 在USB主机查询到USB设备准备就绪后,将读取出这些数据,完成后,USB设备将产生IN事件,此时将响应CTR_IN0()函数: $ N0 z b8 F. ~8 H // ***************************************************************************** // Function Name : CTR_IN // Description : // Input : & v: ^0 b1 y1 Z# {: G( m O // Output : 5 n! X* v9 B) d- a/ a5 ~ // Return : // ***************************************************************************** 2 R+ ?2 Q; J' ?- ]5 a0 Y1 ] void CTR_IN0(void) / u! y) q' [5 X( z { switch(vsDeviceInfo.eControlState) $ l6 w: ]5 m: ]6 X { case CS_GET_DESCRIPTOR: if(SETUP0_TransData() == RESULT_SUCCESS) { * S& u& b! z! {6 m; u6 B { SetEPR_TXStatus(ENDP0, EP_TX_NAK); SetEPR_RXStatus(ENDP0, EP_RX_VALID); 7 F- j" I0 p, F: {$ l1 T } : c' A# V, E' U break; / D7 [" b% `) i" P+ D. E7 h case CS_SET_ADDRESS: 2 s% ~2 X& X# v M( k( u SetEPR_TXStatus(ENDP0, EP_TX_NAK); + z- V7 L1 s0 r: h+ I# j6 [. I SetEPR_RXStatus(ENDP0, EP_RX_VALID); 0 a- {9 a' a8 J# W; W+ }, L$ m SetDADDR(0x0080 | vsDeviceInfo.bDeviceAddress); 5 n' U r* w" ? vsDeviceInfo.eDeviceState = DS_ADDRESSED; % o: Z3 B% { a. { break; case CS_SET_CONFIGURATION: $ d$ G9 Y8 ?+ i" M SetEPR_TXStatus(ENDP0, EP_TX_NAK); , ?2 ?: q" B6 l0 o SetEPR_RXStatus(ENDP0, EP_RX_VALID); " T: }) n8 Q0 \* D" J7 N. ^) E" ~ vsDeviceInfo.eDeviceState = DS_CONFIGURED; 5 `0 H6 o& o' }8 z2 R* \. ~" j break; : A# k9 J0 C( f! b default: . E* }/ q. W5 k' k* q y5 k break; , F! J6 Q: {& s s5 e3 r9 [ } 5 M1 y# ?7 v8 ^4 n } 再这如果响应GET_DESCRIPTOR请求发送的数据如果全部发送完毕,SETUP0_TransData()返回RESULT_SUCCESS,并设置TX状态为NAK;否则返回RESULT_LASTDATA,将继续发送剩余的数据直到数据全部被发送。至此,整个的GET_DESCRIPTOR请求过程完成。 0长度的数据请求在发送0长度数据响应后,因为不存在可能还未传送的数据,因而IN事件后直接结束此次请求。 在数据方向为USB主机->USB设备时,如果正确接收到数据,将响应CTR_OUT0()函数,处理过程类同CTR_IN0()函数。 8 \% K5 h T: b, t9 A 在USB设备的枚举过程中,USB的一些描述符数据结构需要了解,具体在USB协议中有详细的说明,在usb_desc(.c/.h)文件中,定义了这些结构,这些结构是特定的: , W+ ^+ I* a( K0 Q, V+ I ! F0 q4 L0 g0 y" K. o- D* e 设备描述符:长度、格式固定,其中VENDOR_ID与PRODUCT_ID决定上位机驱动的识别。设备分属类别决定了设备的性质,如果为自定义USB设备,设备分属类别值为0,同时上位机驱动必须配合编写;如果为标准USB设备,则必须使用这些标准设备的驱动、数据结构等等,条件是你必须了解这些标准设备的一些信息,好处是省去一些麻烦的驱动编写。 const unsigned char cbDescriptor_Device[DESC_SIZE_DEVICE] = { DESC_SIZE_DEVICE, // bLength: 18 * y2 |' {* i: q! t& Q. [ DESCRIPTOR_DEVICE, // descriptor type ) e$ U6 N# B0 {4 T% S4 g 0x00, // bcdUSB LSB: USB release number -> USB2.0 0x02, // bcdUSB MSB: USB release number -> USB2.0 % ]+ G) ?9 M- [1 I/ { 0x00, // bDeviceClass: Class information in the interface descriptors 1 j; Y/ I) h/ A, Y$ C 0x00, // bDeviceSubClass: 0x00, // bDeviceProtocol: 8 u* s9 `) ?; x3 @4 ^' } 0x40, // bMaxPacketSize0: LowS(8), FullS(8,16,32,64), HighS(64) % d' N) {; R1 G LOWORD(VENDOR_ID), // idVendor LSB: HIWORD(VENDOR_ID), // idVendor MSB: LOWORD(PRODUCT_ID), // idProduct LSB: HIWORD(PRODUCT_ID), // idProduct MSB: 2 k+ ~/ i9 x3 }$ a0 u6 z LOWORD(DEVICE_VERSION), // bcdDevice LSB: + f$ A! Y+ g3 o8 G" q q HIWORD(DEVICE_VERSION), // bcdDevice MSB: & C5 O3 l- @8 c8 `& a& ~. W( E 9 i0 v% M! q) l: M% j! n/ E 0x01, // iManufacturer: Index of string descriptor describing manufacturer 1 K) n) k+ _: `( |+ z9 H h: u1 D 0x02, // iProduct: Index of string descriptor describing product + P$ i3 W G/ U, p5 g3 g 0x03, // iSerialNumber: Index of string descriptor describing the device serial number 4 Y( s+ Z7 L4 l4 _+ k & e7 { ?& y3 q7 I3 z" T. f, n5 C, Y 0x01 // bNumConfigurations: number of configurations }; 5 `, i6 G: w6 w. T4 d* T + T5 `1 k5 n1 u 配置描述符:前9个字节格式固定,后面紧跟的各种描述结构跟实际配置有关,每增加一种描述结构,该描述结构的第一字节说明了结构的长度,第二直接说明了结构的类型。在配置描述符中一般包含配置描述、接口描述、端点描述,如果需要同样可增加自定义的描述。使用标准USB设备类别时,配置描述符的结构也必须满足此类标准设备的数据结构。 + [" p# F: H, C5 R' U; R const unsigned char cbDescriptor_Config[DESC_SIZE_CONFIG] = 9 n4 ~( O$ C/ J8 H" P$ C" p { " C' d! @! d* N3 h! c a/ R1 y // Descriptor of configuration 0x09, // lengths $ L9 S: Y0 `2 L* h& { v/ u DESCRIPTOR_CONFIG, // descriptor type 6 E$ p' g4 {- G DESC_SIZE_CONFIG, // Total configuration descriptor lengths LSB $ P( G1 _/ M- `0 }- V% L 0x00, // Total configuration descriptor lengths MSB 0x01, // bNumInterfaces: Total number of interfaces 0x01, // bConfigurationValue: Configuration value " I3 h* C$ d W, g8 @+ f& k5 H 0x00, // iConfiguration: Index of string descriptor describing the configuration 8 k' a. c4 U% R' J0 U2 m" @0 E- s2 C 6 |$ h/ j8 y' n" r1 O" V 0xA0, // bmAttributes: bus powered // bit 4...0 : Reserved, set to 0 1 M2 O9 ^& A- {* Q+ x // bit 5 : Remote wakeup (1:yes) 7 N! [" c, d: x S- o8 w [ // bit 6 : Self power (1:yes) - T& e$ W( A, q0 I" N // bit 7 : Reserved, set to 1 7 c" c6 `, J4 K; @' _$ Z 3 m! T' ~4 H( o- I5 S4 n1 Y 0x32, // bMaxPower: this current is used for detecting Vbus = 100mA & F4 i& I, f N, c( f# y5 w # Y: N/ b0 _. M n3 V7 P- t4 i 5 ?' z2 D# U( k0 ~0 o0 y. f2 G // Descriptor of interface - k: a- ]- R$ y( D' |- o" b 0x09, + ^% `; {! ~! d$ _: r DESCRIPTOR_INTERFACE, 4 p- f/ B, Q5 ~6 P4 v6 K, d 0x00, // bInterfaceNumber: Number of Interface 0x00, // bAlternateSetting: Alternate setting ; R7 q+ g& K, p. ^) U2 i: q ( F4 ]- G( T4 O- n# y7 M 0x02, // bNumEndpoints: Number of endpoints except EP0 0x00, // bInterfaceClass: 0x00, // bInterfaceSubClass: ! s5 F3 T; ]$ h 0x00, // nInterfaceProtocol: ) t' ?7 [6 P3 C8 N+ T# _% G1 ? 0x00, // iInterface: Index of string descriptor describing the interface 9 P+ k. u2 P6 W7 l c& Y8 B) q; h // Descriptor of endpoint1 OUT 0x07, DESCRIPTOR_ENDPOINT, 0x01, // bEndpointAddress // bit 3...0 : the endpoint number ! j& H! ]+ d/ B0 F# _" z // bit 6...4 : reserved // bit 7 : 0(OUT), 1(IN) 0x03, // bmAttributes ; x4 O3 D3 z9 @8 a4 Z/ C, b$ G // bit 1...0 : Transfer type // 00(CONTROL), 01(ISOCHRONOUS), 10(BULK), 11(INTERRUPT) ! D. e- r/ d; }* b) _ // bit 3...2 : Synchronization type // 00(No Synch), 01(Asynchronous), 10(Adaptive), 11(Synchronous) // bit 5...4 : Endpoint Usage type 9 u/ S# U+ n+ M+ n- }% j // 00(data), 01(Feedback), 10(Implicit feedback data endpoint), 11(Reserved) // bit 7...6 : Reserved, must be zero % {3 ?" W/ P* R; g; B 0x40, // packet size LSB / l: s2 b3 X3 f 0x00, // packet size MSB , }$ m# K2 C" i: A8 i' _) J+ a0 o 0x20, // polling interval time: 32ms / G7 Z5 ~; C9 }5 X 8 E! e B; V1 e. B' W // Descriptor of endpoint2 IN 7 t. j) [% w! K3 W3 \$ o 0x07, DESCRIPTOR_ENDPOINT, 1 B0 A: H' k7 B: a 0x82, // bEndpointAddress // bit 3...0 : the endpoint number & |/ {( L. I( ~* ]* ] // bit 6...4 : reserved ! w. R6 O8 ^8 c8 |) ]. H/ O3 Q // bit 7 : 0(OUT), 1(IN) ! k) V# M5 }. L4 I' E8 l" ] 0x03, // bmAttributes 6 e5 l2 u& }' N0 W @# e) ^/ N. L' S // bit 1...0 : Transfer type // 00(CONTROL), 01(ISOCHRONOUS), 10(BULK), 11(INTERRUPT) ! _9 O4 I5 e v, c8 V5 ?% `# S // bit 3...2 : Synchronization type W- U6 r Q7 _( o1 W; y- q // 00(No Synch), 01(Asynchronous), 10(Adaptive), 11(Synchronous) $ n; b# ]1 J5 v' v // bit 5...4 : Endpoint Usage type 4 I3 k- U* ]) N // 00(data), 01(Feedback), 10(Implicit feedback data endpoint), 11(Reserved) % |! `' f8 K9 C7 E // bit 7...6 : Reserved, must be zero ! s7 M0 x9 k- P. w5 x$ y( C! B 0x40, // packet size LSB 0x00, // packet size MSB 0x20 // polling interval time: 32ms : O: O5 B( _+ r( }/ ~ }; ( O) Q0 z: Q0 F3 l # x- R y) G9 e7 u# d# u" S0 [9 D 字符串描述符:定义了与设备有关的一些信息,常见的为以下四种,如果有需要,同样可以定义自己的字符串描述符。 , X: }( u% p8 x( G* [ const unsigned char cbDescriptor_StringLangID[DESC_SIZE_STRING_LANGID] = { DESC_SIZE_STRING_LANGID, // bLength DESCRIPTOR_STRING, // bDescriptorType = String Descriptor Q( | [4 q5 d4 F6 f, g0 i" x ) i4 U1 ^" \8 u, X$ m: e! V- T 0x09, // LangID LSB: 0x04 // LangID MSB: 0x0409(U.S. English) 8 B1 ^1 A1 P& p& v }; 2 ?0 Z4 m- I5 X5 y' ?9 k N# z 7 ^/ D7 L5 L7 o$ u2 l2 Z const unsigned char cbDescriptor_StringVendor[DESC_SIZE_STRING_VENDOR] = ( ]6 Z% f* P0 u5 f( T { 3 R) X/ ]; K7 y0 | DESC_SIZE_STRING_VENDOR, // bLength ) h2 H- y+ i: ]4 s DESCRIPTOR_STRING, // bDescriptorType = String Descriptor - b% U$ O: |8 a+ j& T // String: "LaBiXiaoXiaoXin" 'L',0, 'a',0, 'B',0, 'i',0, 'X',0, 'i',0, 'a',0, 'o',0, 'X',0, 'i',0, 'a',0, 'o',0, 'X',0, 'i',0, 'n',0 6 Y$ f0 y+ o+ [4 s' s }; ?( H1 |% c/ L& ?& } ) M. U h" O6 n$ L/ u const unsigned char cbDescriptor_StringProduct[DESC_SIZE_STRING_PRODUCT] = - u' M3 h" D+ }& }/ w0 V { 7 f0 O% r7 W# V$ g/ s! I( V& I DESC_SIZE_STRING_PRODUCT, // bLength 7 s0 Y, }3 r- w, h DESCRIPTOR_STRING, // bDescriptorType = String Descriptor // String: "STM32 ezUSB-CORE V1.01" " v3 o1 T* f2 z 'S',0, 'T',0, 'M',0, '3',0, '2',0, ' ',0, 'e',0, 'z',0, 'U',0, 'S',0, 'B',0, 0 b+ Q" w3 n) q9 C0 J; p; y% d '-',0, 'C',0, 'O',0, 'R',0, 'E',0, ' ',0, 'V',0, '1',0, '.',0, '0',0, '1',0 }; 8 }% T( n, o: S- I+ @6 d6 r const unsigned char cbDescriptor_StringSerial[DESC_SIZE_STRING_SERIAL] = { 8 X7 W k) w) [6 a! O0 P DESC_SIZE_STRING_SERIAL, // bLength 4 z) q) v5 O# p5 z: r. y$ B DESCRIPTOR_STRING, // bDescriptorType = String Descriptor & p- F& ~9 ]& t+ ~' o3 J1 B9 Z$ z, X * u G: i% r* ~6 r // String: "ezUSB-CORE Demo 2008/11/18" , N4 Q) o1 k3 ?( O" J# [3 G i$ n; L4 }, J 'e',0, 'z',0, 'U',0, 'S',0, 'B',0, '-',0, 'C',0, 'O',0, 'R',0, 'E',0, ' ',0, 'D',0, 'e',0, 'm',0, 'o',0, ' ',0, '2',0, '0',0, '0',0, '8',0, '/',0, '1',0, '1',0, '/',0, '1',0, '8',0 }; 0 ~: t& z' P8 _* B# a' d& p 了解这些描述符的用法以及作用,最好的方法的是编写自定义的USB上位机驱动以及应用程序,这样你可以深刻了解USB设备与主机间的数据交换方式以及实现手段,下篇将开始介绍USB上位机驱动以及应用程序的编写以及开发环境的建立,STM32 USB设备的固件程序如有什么疑问,请朋友们多花几分种时间留言、讨论,共同学习与进步。 |
最全USB HID开发资料,悉心整理一个月,亲自测试
【源码】STLINK-V3MINI 高速USB仿真器,成功改刷【高速CMSIS-DAP】
STM32 USB CDC 虚拟多串口
实战经验 | 选择USBX模块生成USB CDC ACM无PD的项目
STM32 USB HID键盘例程
刘氓兔的杂谈【001】-片上USB 高速PHY
【经验分享】在进行 USB CDC 类开发时,无法发送 64整数倍的数据
在线直播|无需编写任何代码即可在STM32上实现USB-C Power Delivery
圈圈发布USB图书第二版有感,以及分享一些我学习USB过程...
USB Audio设计与实现
微信公众号
手机版
回复:基于STM32的USB程序开发笔记(五) ——USB设备的枚举(下)
RE:基于STM32的USB程序开发笔记(五) ——USB设备的枚举(下)
RE:基于STM32的USB程序开发笔记(五) ——USB设备的枚举(下)