前言2 r- ^" c9 e7 _* }
理解 STM32F103 上 USB 模块的端点资源,灵活在应用中的配置。
$ b; O) B3 d' N9 Z% j, t0 X
1 K5 v7 K% z' T5 K: a2 r问题7 k: X9 N5 `6 C! p7 [4 E% k
某客户使用 STM32F103 的 USB 模块做设备时和上位机 PC 连接时碰到一个问题:PC 端驱动已经固
( \* e2 q' _0 `5 _7 n- g! Q5 Y定好,是对下位机 USB 设备上的地址编号为 0x0A 和 0x0B 的两个端点通信,从 0x0A 端点读取数据,) b% D0 `; P( L& _6 }7 u
向 0x0B 端点写数据。而 STM32F103 的 USB 模块只有 8 个双向端点,能否支持这样的寻址。
) {1 ^7 C8 i- E; b+ d3 S3 S0 c; {( u T; A$ F3 j/ k
1. 问题调研2 U+ C% C% R* T4 ?4 I; H- ^% \
我们先来看看 STM32F103 上的 USB 端点资源。从 STM32F103 参考手册(RM0008)可知,一共有8 个双向端点,对应 8 个寄存器来控制其属性和表征其状态。如下图,可知每一对端点必须配置成相同的端点地址,这个地址位域是 4 位,取值从 0x0 到 0x0F 范围。6 h, c7 h1 G5 D a* |! h
% C' Z) W9 M6 j7 b- b
' W0 ?( ]' j$ M- s3 a+ n) J0 G' I7 \' |: v$ v+ Q4 a2 ]2 `0 d
和以下摘录的 USB 规范符合:
) q3 C- ^) C }% f% U( d. O8 [) T& \, K" N
+ U+ i) I5 `! T: p1 T* N' u
2 a! e; |4 d. J# N/ s 客户使用的是 STSW-STM32121(STM32F10x, STM32L1xx and STM32F3xx 全速 USB 设备库),那么应该修改哪些代码呢?
5 c. b1 ]9 D3 J+ l& ]5 o2. 问题分析; C5 h' L+ q0 m+ @, E
首先,USB 设备通过端点描述符向主机 PC 报告它所使用的端点有哪些:每个端点的地址(即 USB 规范里,以及参考手册的寄存器中规定的那 4 位地址域)、传输方向、传输类型、最大包长等。以STSW-STM32121 库中的 Mass_Storage 例程为例,需要把中的端点描述符做如下修改:0x0A 地址的端点作为 IN 端点(PC 从它读取数据),0x0B 地址的端点作为 OUT 端点(PC 向它写据)。
5 U4 {7 {8 x1 @# f6 J5 j- const uint8_t MASS_ConfigDescriptor[MASS_SIZ_CONFIG_DESC] =
/ a3 M) L& E' Q. w4 a - {/ |$ D: ~% p9 c8 \! V$ q6 X8 Q
- 。。。。。。+ H$ A6 e" B( N- f1 g9 v; H
- /* 18 */
/ b7 M$ F3 o1 n: z9 Z( A; y - 0x07, /*Endpoint descriptor length = 7*/
* f: k' u' Q6 G& g - 0x05, /*Endpoint descriptor type */% U+ Y& Z/ p+ c4 z% Q- n; z
- 0x8A, //0x81, /*Endpoint address (IN, address 1) */" K/ d! ?5 v4 f: u7 B
- 0x02, /*Bulk endpoint type */
7 T- a" N$ \% N - 0x40, /*Maximum packet size (64 bytes) */8 g/ M1 y! y- K' f* D9 m
- 0x00,
8 n3 ?6 N' \) C. e - 0x00, /*Polling interval in milliseconds */5 r, E' }) g& S# d
- /* 25 */. V" t. C; l, V2 Q( }8 J' y: B; I
- 0x07, /*Endpoint descriptor length = 7 */- d( I0 M7 p2 b7 F. f% ~
- 0x05, /*Endpoint descriptor type */
# O( P2 s) A2 O/ K: _ - 0x0B, //0x02, /*Endpoint address (OUT, address 2) */7 N; x, s& q8 Z: y! x5 `' r
- 0x02, /*Bulk endpoint type */
, e; @* {0 h. }: Y - 0x40, /*Maximum packet size (64 bytes) */1 H+ |" F& O6 q$ F" Y# r
- 0x00,6 S% p l# U0 D" _
- 0x00 /*Polling interval in milliseconds*/! D- b- P4 J. U) t& {- |
- /*32*/
4 W9 B4 T" r$ h; ]/ s I6 J - };
- z5 r# C1 Q7 M1 I" z
复制代码 * I! [- f' d" \$ ]
接下来就是考虑使用 STM32F103 USB 模块提供的 8 个双向端点的哪个端点了。我们刚才从参考手册* {, X. a+ G5 B6 B8 M! _
关于寄存器描述的截图中看到,每一对端点具有相同的地址。在库函数里,对端点寄存器的地址位域
# u" f' d. ?9 |7 q" W7 T的操作在这里:8 H1 Z4 S2 l/ _2 t( w2 d0 q& T
- void SetDeviceAddress(uint8_t Val)
' P' h% m. y: w' O - {
- Q9 N7 @) e4 A- }* O$ } - uint32_t i;
5 F4 N6 ^, g; `+ ~ - uint32_t nEP = Device_Table.Total_Endpoint;, h6 t Z2 C o
- /* set address in every used endpoint */
L. [. t- k! u$ x( o- v - for (i = 0; i < nEP; i++)9 E' x ]$ Z( Y/ {9 O5 [# F* ]
- {3 Y0 o$ p* v9 X+ e% Z
- _SetEPAddress((uint8_t)i, (uint8_t)i);
+ f6 f$ u) M! Z+ E6 s% H6 p - } /* for */
- B3 b& q: }0 l2 }7 R8 ? - _SetDADDR(Val | DADDR_EF); /* set device address and enable function */: @- y+ V$ P! U6 g0 g# _ z
- }* N) I4 J0 z |) k
复制代码 这个函数的名称是“设置(USB)设备地址”,但是其中除了最后一句是在设置 USB 设备的地址,前面- ~5 \7 j% }5 o
的 for 循环是在设置该设备内的端点地址。7 ?3 r$ I' v% x$ {5 }
5 k$ G) X: O) B' w8 M 从以上绿色标注的代码段可以看到,库代码固定给 1 号端点”0x01”这个地址,2 号端点”0x02”这个地址,以此类推。这里的”1 号”、”2 号”指的是端点的编号,对应的就是之前提到的 8 个寄存器的编号,即下图中的 n=0~7。n 在这里就是端点的编号。. x, S2 n1 v- q P, g9 E1 S, z
! D8 G& c4 u! h9 v3 A
9 C, Y: q5 j8 V6 Y2 C7 H: o
' R& O6 m# X0 g8 ?0 V/ O
那么在这个应用中,需要用到地址为 0x0A 和 0x0B 的两个端点,但是端点编号最多只能到 7,因此需要修改库代码中关于端点地址设置的地方如下:这里,我们使用编号为 1 和 2 的两个端点。
9 l, Q" M' c4 ~9 Z# P7 M$ ] 为啥不用编号 0?因为编号 0 默认给双向 0 端点,即用于控制传输的 0 端点。4 i8 Q' n# ^& R) W7 [& Q: |$ R
为啥用 2 个编号?因为这里需要 2 个不同的端点地址,必须用 2 个编号。一个编号对应的 2 个端点必须共享同样的端点地址。
5 F0 ?" E/ N0 @+ w: n; Z; B" Q$ z- void SetDeviceAddress(uint8_t Val)
, c, P) P% J) g! ?! G- f' o - {" `6 L6 J! A4 @) W" ^
- /* set address in every used endpoint */
3 p3 V: Y' G/ Y8 {! A - _SetEPAddress((uint8_t)0, (uint8_t)0);; P; @5 l. f3 F7 B% c
- _SetEPAddress((uint8_t)1, (uint8_t)0x0A); // 1 号端点是 0x8A,即地址为 A 的 IN 端点
% K, @8 Z; {% ~; T s9 x - _SetEPAddress((uint8_t)2, (uint8_t)0x0B); // 2 号端点是 0x0B,即地址位 B 的 OUT 端点8 g- d' f- i2 A) m7 s
- _SetDADDR(Val | DADDR_EF); /* set device address and enable function */: z# ~* L7 O/ C9 ]( r: u
- }
复制代码 既然这里指定了使用编号 1 和编号 2 的端点,那么需要在中设置这两个端点的硬件收发缓冲区地址6 M1 v9 J' ^2 I5 E8 W! Y
- /* EP0 */
, ]+ l. g: D* U1 J' ?& I& H( P - /* rx/tx buffer base address */
2 q! @/ O8 g6 r: v* D5 ~ - #define ENDP0_RXADDR (0x18)
/ N8 W9 u& G: i! e; s - #define ENDP0_TXADDR (0x58)9 Z1 G, M0 H: v8 A' o0 x; A {
- /* 1 号端点,IN 端点,发送缓冲区如下 */
H* S9 x& J$ T: S i8 S ] - #define ENDP1_TXADDR (0x98)
# V# @1 J5 {4 [4 R% ~ - /* 2 号端点,OUT 端点,接收缓冲区如下 */
复制代码
" a e% a7 M0 C3 P% r3 M6 x [) f 当然如果你很任性,一定要使用编号为 6 和 7 的端点,也可以,那么代码就如下修改:
6 d' ]: E. c( d4 Z+ f$ x3 x- void SetDeviceAddress(uint8_t Val)
/ G6 f% J( {( u1 |% H+ Z - {
7 Y7 b F) |5 \9 B+ g6 D - /* set address in every used endpoint */
1 F0 F9 e% v/ w* ~7 V - _SetEPAddress((uint8_t)0, (uint8_t)0);
9 ~2 m9 m) [4 @7 O0 ] - _SetEPAddress((uint8_t)6, (uint8_t)0x0A);* G) x7 q2 D+ N+ G
- _SetEPAddress((uint8_t)7, (uint8_t)0x0B);$ E/ C5 D: g! c
- _SetDADDR(Val | DADDR_EF); /* set device address and enable function */
2 \ v0 u) m. i7 X, v, |4 F - }
复制代码 # K) x8 \# ^/ I
相应地,需要在中指明编号为 6 和 7 的这两个端点的硬件收发缓冲区地址。那么如法炮
& t S% }( C8 B' [ 制做如下修改,就可以了吗?就可以了吗?就可以了吗?% m6 @2 {( f6 p1 n7 E9 p
- /* EP0 */- W/ n- s ]- j3 \4 U0 I( \
- /* rx/tx buffer base address */
* `: {( [2 K5 F5 ~ - #define ENDP0_RXADDR (0x18)( b( r% N3 Z& U. j0 z; q$ E8 T
- #define ENDP0_TXADDR (0x58). F" {1 h; l# c& _
- /* 6 号端点,IN 端点,发送缓冲区如下 */
" h+ _) S+ m9 N( ~( X; y& L& a - #define ENDP6_TXADDR (0x98)
# B" M6 T8 C6 {5 ?' V5 h - /* 7 号端点,OUT 端点,接收缓冲区如下 */( p. n* n) r' C& X+ V5 |" M% M
- #define ENDP7_RXADDR (0xD8)
复制代码 # o+ j' ~8 f3 s1 J
答案是否定的!以下的代码才 OK。欲知详情,请参考下一条应用技巧《STM32F103 上 USB 模块的
8 d* r( p; e* V; @* |- d0 I# y- J 包缓冲区详解》
: L& I# ]0 Z$ A, ]% |- /* EP0 */5 k4 g0 m5 M5 K. P
- /* rx/tx buffer base address */
2 o4 q+ |! h. `% ?* C( [( R. k8 o - #define ENDP0_RXADDR (0x40)
1 b5 F+ O- m/ A- @; } - #define ENDP0_TXADDR (0x80)
$ ]( _& E0 ?, [& y; O - /* 6 号端点,IN 端点,发送缓冲区如下 */ ~9 X: { W/ z! l' Y* w
- #define ENDP6_TXADDR (0xC0)
7 ~4 w7 _9 w" z$ c% O) [1 t - /* 7 号端点,OUT 端点,接收缓冲区如下 */
复制代码
7 g9 N- Y! Q! M1 g$ M. D/ u7 a, y! L- J s3 K. ?5 i
|