问题:某客户使用 STM32F4 的 OTG 库做 USB 主机控制 Wifi 网卡。使用 BULK 传输类型时,从数据读取数据时,如果设备返回需要把设备返回的 NAK 状态告知上层应用,该如何修改 OTG 库。
( @ z& d; O7 P8 h* a) e调研: w5 j1 f5 e+ f7 y
先来看看 OTG 库当前对 BULK 类型传输,IN 和 OUT 方向上的 NAK 的处理方式:
! U' F( y# P4 _. D, a% U- q- @ BULK IN 通道
; F- F5 L1 R" H" ]7 R) D @3 C - If (nak)
0 ~6 s7 ^0 v+ M# [9 Y& m, m - 重新使能该通道: CHENA=1, CHDIS=09 S$ ?/ K' f; u d
- 记录通道状态: Pdev->hostHC_Status[num] = HC_NAK
% e! @% ?4 |2 x. ~! P: n# P - 清零 NAK 位
9 q- z! ~" h2 t - 退出该中断处理程序(ISR)6 ]7 O& I$ R% ]' X5 ?7 q. Y" h, Q0 b
复制代码
: J* T* @5 k1 Y( [+ P) O3 B3 k' O. X* j
一旦重新使能该通道,主机硬件又自动发送 IN 令牌来企图从设备获取数据,直到设备准备好数据后,不再回复 NAK 握手,而是回复主机要获取的数据,然后主机硬件回复 ACK 来结束本次 transfer。
' [: |0 g& v! w0 _- l4 U/ YBULK IN 通道对 NAK 的处理和 CTRL IN 通道对 NAK 的处理,在 ISR 中是一样的;但是在驱动库里,对 CTRL IN 有超时限制,而对 BULK IN 没有。就是说对于常用来做枚举传输的 CTRL 传输,当启动从设备获取信息,但是久久未得的情况下,会走到 Timeout 的处理分支。从代码里我们可以看到
1 h8 ~$ D+ R" R+ E9 O- F9 V- <usbh_core.c>& |' F. p- u% @) [5 n+ M
- USBH_HandleControl()0 {! m) l1 R# K
- {9 h2 A# L9 H% N3 d
- case CTRL_DATA_IN : 发出 IN 令牌' w& I% C n, e# A1 T
- case CTRL_DATA_IN_WAIT :2 q7 i* C* d% A# N
- get_urb_state
! X+ n: @1 j) Y - if (done)3 H; ]" Y2 A) x) W3 p# ]
- if (stall); N4 k: l8 r, \! \1 b7 L
- if (error)1 i3 d# X7 h, R0 a C4 \+ B, d3 x
- if (超时) USBH Fail
复制代码 ' z0 Q: g3 o1 X) _1 D
+ k. d" q+ ?3 L- b3 w但是 BULK IN 通道对 NAK 的接收没有超时控制,因为 BULK 传输本身的性质就是不保证带宽的,即如果主机上有很多其他优先级更高的周期类型的传输(同步 ISO 传输和中断 INT 传输),则在 BULK传输有可能无限延迟。; q! K+ m, h5 u8 h6 I4 M6 Z
CTRL IN 对 NAK 有超时处理,那么 CTRL OUT 对 NAK 是如何处理的呢?
) V+ E" c2 t$ O1 M" l. p) q从代码里可以看到 CTRL OUT 收到 NAK 后会把该状态上传 APP,如图! r; G3 o) ?. h
- @ CTRL OUT 通道
; w8 K4 X7 [. C4 t- U - If (nak)
/ _( w9 S1 O! p0 `( z - 打开通道 halt 中断: CHMM @ OTG_FS_HCINTMSK
; T0 O5 q5 q5 n; w/ m$ v5 ^ - Halt 该通道: CHENA=0, CHDIS=1# B% u; b; ~$ [' o* j: E9 c# C
- 记录通道状态:Pdev->hostHC_Status[num] = HC_NAK
: }; I+ c$ O/ E+ O4 V0 N1 w - 错误计数清零# `' w% l& N n' k z% y
- 清零 NAK 标志:@HCINTx
6 {, R7 R& X$ @$ U7 K/ J - 退出该中断处理程序(ISR),又进入通道 halt 中断
. M" P9 k- V6 S8 \ - If (halt)
# P9 n$ e* b* w' Z( I& r - 关闭通道 halt 中断
* Z3 ?3 U" n1 ~; Q - 记录通道状态以上传 APP:Pdev->host.URB_State[num] = URB_NOTREADY
复制代码 然后在库代码处理控制传输时,如果检测到这个状态,就会重新发送 OUT 令牌和数据包,如图
" |8 g% ]+ n1 x8 R- <usbh_core.c>
6 C4 g2 l: J" E) M; x5 p - USBH_HandleControl()
) N4 S! E& W6 t* k+ r. S - {3 z: p% v& z( m' `5 x$ |" `
- case CTRL_DATA_OUT : 发出 OUT 令牌和数据包
' @; ~/ ?8 `& ]' ~! ^' n - case CTRL_DATA_OUT_WAIT :! I& a6 |# O8 T4 u2 J! u& r
- get_urb_state1 }# w K& b3 `- S# q1 V0 w
- if (done)- Z2 z" _0 k3 M V# h
- if (stall)9 W/ c; b/ G( ~
- if (error)' I8 r% C: a# \+ ^ e" v" V
- if (URB_NOTREADY) 回到之前的 case CTRL_DATA_OUT
复制代码 ' w% p# x* U/ i* R; G7 l$ Y
因此,当 CTRL IN 收到 NAK 后,如果想把状态上传给 App,则可以模仿 CTRL OUT 对 NAK 的处理。首先, ISR 中的处理可以模仿 CTRL OUT,在 BULK 传输的处理中,对每次发送 IN 令牌的地方(USBH_BulkReceiveData)查询传输状态,如果 URB_NOTREADY 就由 App 来决定如何处理。
0 O6 p( G9 t$ ? b" _* `0 ]# Q! c5 r1 S$ @3 |% a* b
处理:
# |/ E* f1 I) r基于 U 盘读写的例程,在每次 USBH_BulkReceiveData 之后检查状态,如果是 URB_NOTREADY 就重新发送 IN 令牌。于是全项目搜索 USBH_BulkReceiveData,有三个地方,且都在USBH_HandleBOTXfer()中调用,即在 BOT 传输中若干次读数据阶段(多次数据包整数长度读取和最后一次的尾巴数据读取)和 CSW 阶段的读取,如图:3 [/ J; {$ i [; \3 p) ]
- <usbh_core.c>
% r4 F( x' R+ f( Z ^5 \/ L, @6 L - USBH_MSC_HandleBOTXfer()
9 a) f. @/ U* `: K - {) I1 x" g# B6 k: i. y
- case USBH_MSC_BOT_DATAIN_STATE:8 P1 H" L1 ]6 V: c/ ]$ `
- if (URB_DONE)6 }5 [( K |% ?. R
- {& E2 k" ?; F; Y8 a: i( i
- if (剩余数据大于端点的 MPZ) USBH_BulkReceiveData(MPZ), _- e2 U7 X" H* n1 x$ ~
- if (剩余数据小于端点的 MPZ) USBH_BulkReceiveData(剩余数据量)
, h9 _( Q1 u/ W' C* X+ ^ - }) F1 Q3 D6 t( c# { T$ F
- case USBH_MSC_RECEIVE_CSW_STATE :
& T) ?# j |6 R. S - USBH_BulkReceiveData(13)
复制代码 需要对每次 BULK IN 传输后检测状态,如果收到 NAK 则重新发起刚才的那次 BULK IN 传输,如图:
- k, R; J0 a" K. y+ Z- <usbh_core.c>
2 o' Y. O- k& S9 q% i0 D, ` - USBH_MSC_HandleBOTXfer()$ B2 C! H( G6 j3 |* X
- {$ L, |1 Y1 d+ e- s. Y
- case USBH_MSC_BOT_DATAIN_STATE:. o( O0 l; ?( }6 a' N: e: i
- if (URB_DONE)$ J+ M) X: a! j7 u4 z' m
- {6 Q! h4 C6 M% c$ D; z1 r4 a
- if (剩余数据大于端点的 MPZ) USBH_BulkReceiveData(MPZ)9 l; Z- Y# T$ V9 b& n
- if (剩余数据小于端点的 MPZ) USBH_BulkReceiveData(剩余数据量)
4 a7 W$ C2 V- [. M4 v* i/ H - } d- A7 R. u+ i. n" V2 H: C
- If (URB_NOTREADY)
( ]" U7 X, D% K. V - {重新发起刚才的 BULK IN 传输}
; m& ~7 e$ h* _3 ^ o: u& A - case USBH_MSC_RECEIVE_CSW_STATE :
. i3 h: L" H5 J" b4 k& h8 C$ Q - USBH_BulkReceiveData(13)+ W6 x( C. x" v& v" ^3 V
- If (URB_NOTREADY)+ ^0 L) m9 t3 [: d2 I
- {重新发起刚才的 BULK IN 传输}
复制代码 经过以上修改,以 FS 和 HS 都能对 U 盘正确读取。
3 m# j$ r+ Y6 Z 修改后的固件代码,请参看附件压缩包。6 c6 J- \( N1 f2 K! Z0 h6 d: F
0 ~: w6 j, |9 c5 K, `7 G# X
$ K3 x9 H1 K! y8 E& \& E& F |