前言
+ X2 n0 W! \! i- L; W9 O理解 STM32F103 上 USB 模块的端点资源，灵活在应用中的配置。

问题
某客户使用 STM32F103 的 USB 模块做设备时和上位机 PC 连接时碰到一个问题：PC 端驱动已经固
定好，是对下位机 USB 设备上的地址编号为 0x0A 和 0x0B 的两个端点通信，从 0x0A 端点读取数据，
向 0x0B 端点写数据。而 STM32F103 的 USB 模块只有 8 个双向端点，能否支持这样的寻址。

+ T' |+ e! M  O& Y1 @6 S5 P1. 问题调研
1 ~# j/ ~: `7 F6 g0 @% s8 _6 W   我们先来看看 STM32F103 上的 USB 端点资源。从 STM32F103 参考手册（RM0008）可知，一共有8 个双向端点，对应 8 个寄存器来控制其属性和表征其状态。如下图，可知每一对端点必须配置成相同的端点地址，这个地址位域是 4 位，取值从 0x0 到 0x0F 范围。

( B) k. x( l" K5 j$ V8 d
5 w/ ?$ G* f; k! k
3 K1 ~- }2 n/ {: W0 t% m   和以下摘录的 USB 规范符合：
* m( W) x4 V$ x. d, D


1 U6 F* w0 |5 M" J3 h   客户使用的是 STSW-STM32121（STM32F10x, STM32L1xx and STM32F3xx 全速 USB 设备库），那么应该修改哪些代码呢？
3 x* w% `3 {" ?/ c  }: i$ |' J1 o9 X2. 问题分析
5 U. O' C- j+ o7 i/ G# i   首先，USB 设备通过端点描述符向主机 PC 报告它所使用的端点有哪些：每个端点的地址（即 USB 规范里，以及参考手册的寄存器中规定的那 4 位地址域）、传输方向、传输类型、最大包长等。以STSW-STM32121 库中的 Mass_Storage 例程为例，需要把中的端点描述符做如下修改：0x0A 地址的端点作为 IN 端点（PC 从它读取数据），0x0B 地址的端点作为 OUT 端点（PC 向它写据）。

1. const uint8_t MASS_ConfigDescriptor[MASS_SIZ_CONFIG_DESC] =
   
2. {
   
3. 。。。。。。
   
4. /* 18 */
   
5. 0x07, /*Endpoint descriptor length = 7*/
   ! ]6 d) V- U  a3 A
6. 0x05, /*Endpoint descriptor type */
   7 N6 X, v! L: V3 k5 {
7. 0x8A, //0x81, /*Endpoint address (IN, address 1) */
   
8. 0x02, /*Bulk endpoint type */
   & g+ D' z* ]1 ], U5 P9 j
9. 0x40, /*Maximum packet size (64 bytes) */
   8 Q6 b( u5 v0 b$ C
10. 0x00,
    # l* J+ n; g; }/ S+ `- \
11. 0x00, /*Polling interval in milliseconds */
    & T. X4 U! j- C
12. /* 25 */
    
13. 0x07, /*Endpoint descriptor length = 7 */
    
14. 0x05, /*Endpoint descriptor type */
    0 A4 V& R& A+ z3 o5 a( ]
15. 0x0B, //0x02, /*Endpoint address (OUT, address 2) */
    
16. 0x02, /*Bulk endpoint type */
    
17. 0x40, /*Maximum packet size (64 bytes) */
    
18. 0x00,
    
19. 0x00 /*Polling interval in milliseconds*/
    9 a! U) e- ^$ u: `( D2 K
20. /*32*/
    
21. };
    ! ]9 r$ }& P& k. z) S4 V

复制代码

* P, {4 _! ~2 G接下来就是考虑使用 STM32F103 USB 模块提供的 8 个双向端点的哪个端点了。我们刚才从参考手册
关于寄存器描述的截图中看到，每一对端点具有相同的地址。在库函数里，对端点寄存器的地址位域
的操作在这里：
% M4 P' b- C) E

1. void SetDeviceAddress(uint8_t Val)
   / p) V' J9 p  ~# E) l, ?7 ?
2. {
   + p" D' q' O- n5 S- c/ }) w
3. uint32_t i;
   
4. uint32_t nEP = Device_Table.Total_Endpoint;
   8 z- E: `  w- o3 b; |/ Z2 r1 y
5. /* set address in every used endpoint */
   
6. for (i = 0; i < nEP; i++)
   , b! ?8 o! P: q4 Y/ @6 Q
7. {
   : r( v8 w' f( T$ i$ y
8. _SetEPAddress((uint8_t)i, (uint8_t)i);
   
9. } /* for */
   
10. _SetDADDR(Val | DADDR_EF); /* set device address and enable function */
    1 |5 p' Q3 g0 F7 b7 ~# t' Z! x
11. }
    9 v4 L9 k9 m5 [$ `) k

复制代码

这个函数的名称是“设置(USB)设备地址”，但是其中除了最后一句是在设置 USB 设备的地址，前面
的 for 循环是在设置该设备内的端点地址。

% [. x0 ]  y" _0 A3 v' E3 l- \8 g   从以上绿色标注的代码段可以看到，库代码固定给 1 号端点”0x01”这个地址，2 号端点”0x02”这个地址，以此类推。这里的”1 号”、”2 号”指的是端点的编号，对应的就是之前提到的 8 个寄存器的编号，即下图中的 n=0~7。n 在这里就是端点的编号。
# E( A" `5 P$ q, O

* |  [4 ]1 o& z1 I! Z
   那么在这个应用中，需要用到地址为 0x0A 和 0x0B 的两个端点，但是端点编号最多只能到 7，因此需要修改库代码中关于端点地址设置的地方如下：这里，我们使用编号为 1 和 2 的两个端点。
) ^1 z$ j2 x5 h% G   为啥不用编号 0？因为编号 0 默认给双向 0 端点，即用于控制传输的 0 端点。
   为啥用 2 个编号？因为这里需要 2 个不同的端点地址，必须用 2 个编号。一个编号对应的 2 个端点必须共享同样的端点地址。

1. void SetDeviceAddress(uint8_t Val)
   " r- D0 l9 h6 j' H
2. {
   
3. /* set address in every used endpoint */
   
4. _SetEPAddress((uint8_t)0, (uint8_t)0);
   % B. u' P/ |: ?$ q6 i/ ]# [: U$ B
5. _SetEPAddress((uint8_t)1, (uint8_t)0x0A); // 1 号端点是 0x8A,即地址为 A 的 IN 端点
   
6. _SetEPAddress((uint8_t)2, (uint8_t)0x0B); // 2 号端点是 0x0B,即地址位 B 的 OUT 端点
   
7. _SetDADDR(Val | DADDR_EF); /* set device address and enable function */
   
8. }

复制代码

  既然这里指定了使用编号 1 和编号 2 的端点，那么需要在中设置这两个端点的硬件收发缓冲区地址
4 `- ?; v  G7 `: t7 u" l

1. /* EP0 */
   3 B( I8 G2 @- Y) `! }8 D' G6 }* b
2. /* rx/tx buffer base address */
   - ?# w* p! l* ~. p) c2 C
3. #define ENDP0_RXADDR (0x18)
   3 y# m) l" k! F1 [
4. #define ENDP0_TXADDR (0x58)
   
5. /* 1 号端点，IN 端点，发送缓冲区如下 */
   ( A& q$ B* Q+ a. O8 `: `
6. #define ENDP1_TXADDR (0x98)
   & l" }8 t3 ]+ S0 ^4 F  g7 D' g$ S$ z
7. /* 2 号端点，OUT 端点，接收缓冲区如下 */

复制代码

   当然如果你很任性，一定要使用编号为 6 和 7 的端点，也可以，那么代码就如下修改：

1.    void SetDeviceAddress(uint8_t Val)
   : N9 T) O% u$ l, j
2.    {
     I6 g: |2 x( }- I6 \
3.    /* set address in every used endpoint */
   
4.    _SetEPAddress((uint8_t)0, (uint8_t)0);
   4 L- P6 y  Q1 v2 A) A# F
5.    _SetEPAddress((uint8_t)6, (uint8_t)0x0A);
   & N; K- A9 [  v* p
6.    _SetEPAddress((uint8_t)7, (uint8_t)0x0B);
   
7.    _SetDADDR(Val | DADDR_EF); /* set device address and enable function */
   ) j. F" w$ v$ j) G% g
8.    }

复制代码

. V, |/ r' {6 S' z   相应地，需要在中指明编号为 6 和 7 的这两个端点的硬件收发缓冲区地址。那么如法炮
   制做如下修改，就可以了吗？就可以了吗？就可以了吗？
# V: d) o$ K2 g9 j3 M7 @$ o! y

1.    /* EP0 */
   
2.    /* rx/tx buffer base address */
   1 |( v" u0 m$ h, {  A
3.    #define ENDP0_RXADDR (0x18)
   ' Z. D  e3 _3 Z' m
4.    #define ENDP0_TXADDR (0x58)
   
5.    /* 6 号端点，IN 端点，发送缓冲区如下 */
   
6.    #define ENDP6_TXADDR (0x98)
   2 O0 Q! |" k  V7 P" w! u, [6 w
7.    /* 7 号端点，OUT 端点，接收缓冲区如下 */
   / |4 X) Q# c4 K& d" Z' @
8.    #define ENDP7_RXADDR (0xD8)

复制代码

   答案是否定的！以下的代码才 OK。欲知详情，请参考下一条应用技巧《STM32F103 上 USB 模块的
   包缓冲区详解》

1.    /* EP0 */
   
2.    /* rx/tx buffer base address */
   
3.    #define ENDP0_RXADDR (0x40)
   # P7 o% r5 J, @2 J. ]- V1 O6 k- a" U
4.    #define ENDP0_TXADDR (0x80)
   
5.    /* 6 号端点，IN 端点，发送缓冲区如下 */
   
6.    #define ENDP6_TXADDR (0xC0)
   
7.    /* 7 号端点，OUT 端点，接收缓冲区如下 */

复制代码

2 r( u7 O  J0 q, u/ a' P
  h4 h* z) Z: I. |; o2 q