STM32 USB HID键盘例程
7 r. r$ H, F! d
! Z% ?# w, h7 B5 O$ X. f最全USB HID开发资料，悉心整理一个月，亲自测试

; o/ t  l9 J7 x# n3 M# g0 p8 d9 S. D% s  W8 t通过STM32CUbeMX建立USB HID的双向通讯实验成功
! P. O  i# Y5 W- M. @# ?
7 |9 {7 C& E# _+ e
发现很多人对STM32的USB通信很感兴趣。要将USB的通信协议搞懂确实是一个比较漫长的过程。但是USB的HID通信无论是上位机的设计还是STM32程序的编程都非常的简单。只是我想很多人都不知道而已。这篇文章的目的是让大家以最短的时间将USB加到你的设备中。如果想学得更深就靠大家。
3 M; G( V1 X  R
- m. i$ w) Y* i# {, vHID只是适合低速传输，其理论上可以达到64KB/S，但多由于windows系统和硬件的关系一般达不到这个传输数度。但这个速度对于一般系统的控制和数据传输都已经足够了，而且是免驱，省去了很多麻烦。如果您需要高速传输可参考我的另外一篇文章《STM32的USB例程修改步骤》文章在

& e  R7 O# X7 d8 k# h一、安装完MDK后请打开C:/Keil/ARM/Examples/ST/STM32F10xUSBLib/Demos路径，将Custom_HID在同一个目录下复制一份，如果你要放到其他路径你需要在MDK Options for target的C/C++中添加USB的头文件路径（MDK下的/INC/ST/STM32F10x/USB）。
4 L- D- g8 P  i& e
+ G$ R) N+ h2 m" _/ p! ^! }7 z4 Q二、打开usb_desc.c文件，该文件主要包含的端点描述符、设备描述符、配置描述符和字符描述符等。具体请大家参考其他资料了，这里主要说几个常用。
3 P8 l" H6 Z! r; Z- D5 F6 z2 w
u8 DeviceDescriptor[SIZ_DEVICE_DESC]为USB设备描述符。当中的
% P* J, \. i3 O5 q" X$ `0x83, /*idVendor (0x0483)*/
0x04,
0x50, /*idProduct = 0x5750*/
0 U8 ?) h  `% V" o0x57,
4 N( H( f$ |- a/ }; ?9 N$ W//idVender字段。厂商ID号，我们这里取0x0483，仅供实验用。
7 @1 ^5 I7 |- I' \//实际产品不能随便使用厂商ID号，必须跟USB协会申请厂商ID号。
//注意小端模式，低字节在先。
7 s9 J, C$ ]6 Q; d3 C//idProduct字段。产品ID号，我们这里取0x5750。
//注意小端模式，低字节应该在前。
+ H8 \- i- U) r  Q6 s% q$ A: t. e

const u8 ConfigDescriptor[SIZ_CONFIG_DESC]是配置描述符，注意如下
& a# C7 x0 s) N  T" x6 ^! r0 H

1. USB_ENDPOINT_DESCRIPTOR_TYPE, /* bDescriptorType: */
   
2. 0x81, /* bEndpointAddress: Endpoint Address (IN) */
   
3. 0x03, /* bmAttributes: Interrupt endpoint */
   : W# I, E" F1 w+ E2 J
4. 0x02, /* wMaxPacketSize: 2 Bytes max */
   
5. 0x00,
   
6. 0x20, /* bInterval: Polling Interval (32 ms) */
   1 m! W/ l8 F+ k& |# o# g/ J8 q6 ^
7. /* 34 */
   8 A% r4 ?) @# ^6 G* j! u- x
8. 0x07, /* bLength: Endpoint Descriptor size */
   
9. USB_ENDPOINT_DESCRIPTOR_TYPE, /* bDescriptorType: */
   
10. /* Endpoint descriptor type */
    
11. 0x01, /* bEndpointAddress: */
    
12. /* Endpoint Address (OUT) */
    3 ?8 s" K+ |- M9 |. g
13. 0x03, /* bmAttributes: Interrupt endpoint */
    
14. 0x02, /* wMaxPacketSize: 2 Bytes max */
    
15. 0x00,
    
16. 0x20, /* bInterval: Polling Interval (20 ms) */

复制代码

+ i0 u  t# r. Y) K' v, Z0 u上面包含了“输入端点描述符”和“输出端点描述符”。
' z' j; b5 p) I/ c9 [  a//wMaxPacketSize字段。该端点的最大包长。
//bInterval字段。端点查询的时间，

- \$ X' i* F0 R) p& d为了实现更高速的通信我们修改如下：
" U5 P) S0 y0 Y& L5 q7 ~0 _

1. /******************** Descriptor of endpoint ********************/
   
2. /* 27 */
   6 e4 R" `* j8 M& C# m* t
3. 0x07, /*bLength: Endpoint Descriptor size*/
   
4. USB_ENDPOINT_DESCRIPTOR_TYPE, /*bDescriptorType:*/
   
5. 0x81, /*bEndpointAddress: Endpoint Address (IN)*/
   
6. 0x03, /*bmAttributes: Interrupt endpoint*/
   , K( V% ~! G, A- ^3 o, L# @
7. 0x40, /*wMaxPacketSize: 64 Byte max */
   
8. 0x00,
   ( j7 G# V  y/ v* T% f9 X9 Z3 f8 `4 S
9. 0x0A, /*bInterval: Polling Interval (10 ms)*/
   
10. /* 34 */
    
11. /******************** Descriptor of endpoint ********************/
    
12. /* 27 */
    
13. 0x07, /*bLength: Endpoint Descriptor size*/
    
14. USB_ENDPOINT_DESCRIPTOR_TYPE, /*bDescriptorType:*/
    7 C4 k9 z1 L# O! L2 W+ L
15. 0x01, /*bEndpointAddress: Endpoint Address (OUT)*/
    
16. 0x03, /*bmAttributes: Interrupt endpoint*/
    
17. 0x40, /*wMaxPacketSize: 64 Byte max */
    
18. 0x00,
    & L2 Y6 {) \* V( w2 C
19. 0x0A, /*bInterval: Polling Interval (10 ms)*/
    
20. 
    , @0 d3 W; O, q5 `
21. const u8 ReportDescriptor[SIZ_REPORT_DESC]为HID专用的报告描述符，具体的大家就参考资料了，这里可以直接复制了。
    
22. const u8 CustomHID_ReportDescriptor[CUSTOMHID_SIZ_REPORT_DESC] =
    
23. {
    6 v# E2 r( s: p! G4 t
24. 0x05, 0xFF, // USAGE_PAGE(User define)
    " z- n* I; q6 T: H
25. 0x09, 0xFF, // USAGE(User define)
    
26. 0xa1, 0x01, // COLLECTION (Application)
    
27. 0x05, 0x01, // USAGE_PAGE(1)
    
28. 0x19, 0x00, // USAGE_MINIMUM(0)
    
29. 0x29, 0xFF, // USAGE_MAXIMUM(255)
    
30. 0x15, 0x00, // LOGICAL_MINIMUM (0)
    
31. 0x25, 0xFF, // LOGICAL_MAXIMUM (255)
    9 P1 k! ~& ^( L: ?( X0 P
32. 0x75, 0x08, // REPORT_SIZE (8)
    0 d& M$ P! {/ k. }1 J! J: i# |7 d
33. 0x95, 0x40, // REPORT_COUNT (64)
    
34. 0x81, 0x02, // INPUT (Data,Var,Abs)
    " \) W9 L& J8 s* S1 s1 k% o
35. 0x05, 0x02, // USAGE_PAGE(2)
    5 b7 u. [8 S6 s4 p
36. 0x19, 0x00, // USAGE_MINIMUM (0)
    
37. 0x29, 0xFF, // USAGE_MAXIMUM (255)
    6 U; S7 [' o# }/ T
38. 0x15, 0x00, // LOGICAL_MINIMUM (0)
    
39. 0x25, 0xFF, // LOGICAL_MAXIMUM (255)
    
40. 0x95, 0x08, // REPORT_COUNT (8)
    ( F7 g5 I( c/ W
41. 0x75, 0x40, // REPORT_SIZE (64)
    ; L  S- X# _+ {) W' D/ ]
42. 0x91, 0x02, // OUTPUT (Data,Var,Abs)
    : c" g; t8 |* S2 Z. W
43. 0xc0 // END_COLLECTION
    0 a/ D. I0 A& M  \8 |4 B/ u
44. }; /* ReportDescriptor */
    
45. 
    
46. const u8 CustomHID_StringVendor[CUSTOMHID_SIZ_STRING_VENDOR]
    $ H9 N: G/ N& D) J* s) U& a& C
47. const u8 StringProduct[SIZ_STRING_PRODUCT]
    
48. const u8 StringSerial[SIZ_STRING_SERIAL]

复制代码

' _$ G# L6 i; y/ J: }8 N( r分别是“厂商字符”、“产品字符”、“产品序列号”，这些将在USB HID设备加载的时候显示。但是这需要这些字符要求为Unicode编码，你需要将你要显示的字符先转为Unicode编码。最好大家还要根据各个数组的长度修改如下定义。

1 z# r; g- l+ H* E

1. #define CUSTOMHID_SIZ_REPORT_DESC 39
   1 G/ J  w$ ]3 q  c: Y
2. #define CUSTOMHID_SIZ_STRING_VENDOR 64
   
3. #define CUSTOMHID_SIZ_STRING_PRODUCT 28
   . r: u" y- w% _; t) J7 S
4. #define CUSTOMHID_SIZ_STRING_SERIAL 26

复制代码

三、打开hw_config.c文件，将那些没有的函数删除，只保留如下函数
5 V7 m. g" a! r9 L  Ra) Set_System(void)
b) void Set_USBClock(void)
c) void USB_Interrupts_Config(void)
/ Y% V; G9 P% d5 _4 y$ vd) void USB_Cable_Config (FunctionalState NewState)
特别要注意最后一个函数，其主要作用是控制USB的上拉电阻，让电脑检测USB设备是否连接的。


1 x$ j. a" e( F四、打开stm32f10x_it.c文件，把EXTI15_10_IRQHandler等中断内的代码删除。
打开usb_prop.c文件，修改如下：
5 D. n4 y' e: P% q% [" E4 @

1. void CustomHID_Reset(void)
   
2. {
   + R. L: Q. p% T/ [& v4 W
3. /* Set Joystick_DEVICE as not configured */
   
4. pInformation->Current_Configuration = 0;
   % |( }1 \) I! ?: d' @% F
5. pInformation->Current_Interface = 0;/*the default Interface*/
   
6. SetBTABLE(BTABLE_ADDRESS);
   
7. 
   
8. /* Initialize Endpoint 0 */
   . N( i' _$ j' Z1 x
9. SetEPType(ENDP0, EP_CONTROL);
   2 m1 ~6 [( a, g0 D( Z9 b. w2 j
10. SetEPTxStatus(ENDP0, EP_TX_STALL);
    ; i" L. R" ?, b- q4 q
11. SetEPRxAddr(ENDP0, ENDP0_RXADDR);
    
12. SetEPTxAddr(ENDP0, ENDP0_TXADDR);
    5 W. H4 n( X/ x# ]6 V
13. Clear_Status_Out(ENDP0);
    
14. SetEPRxCount(ENDP0, Device_Property.MaxPacketSize);
    # c, A' |7 L$ R" f2 N  t
15. SetEPRxValid(ENDP0);
    
16. 
    ( J; R; B' E3 m; \" o
17. /* Initialize Endpoint 1 */
    
18. SetEPType(ENDP1, EP_INTERRUPT);
    
19. SetEPTxAddr(ENDP1, ENDP1_TXADDR);
    8 g% \$ L+ u8 s+ g
20. SetEPTxCount(ENDP1, 64);
    * C, q& o9 U, o% a9 P
21. SetEPRxStatus(ENDP1, EP_RX_DIS);
    
22. SetEPTxStatus(ENDP1, EP_TX_NAK);
    5 _+ P4 w* W/ Z+ f+ d) X
23. 
    / U% d+ k% J/ A1 j6 B) `+ a' |) N( M1 j
24. /* Initialize Endpoint 1 */
    # Y1 t: p; G' u3 u( |
25. // SetEPType(ENDP1, EP_INTERRUPT);
    ; g1 P6 a, \) a$ V: o7 G
26. SetEPRxAddr(ENDP1, ENDP1_RXADDR);
    ' m  z. c2 \7 G" T
27. SetEPRxCount(ENDP1, 64);
    
28. // SetEPTxStatus(ENDP1, EP_TX_DIS);
    4 E: K: M0 E" }
29. SetEPRxStatus(ENDP1, EP_RX_VALID);
    
30. /* Set this device to response on default address */
      M' D. L  _3 b* d* g
31. SetDeviceAddress(0);
    
32. }

复制代码

# H7 I1 H1 @! o五、usb_endp.c文件

1. void EP1_OUT_Callback(void)
   / A! g+ ]2 C' L1 u
2. {
   ( X& i5 d3 ]7 u2 X) m  p
3. 这些写接收代码
   
4. }

复制代码

六、数据发送和接收，举例说明
5 \6 N+ ~' d) V- V- Y1、数据接收

1. u8 DataLen;
   
2. DataLen = GetEPRxCount(ENDP1);
   
3. PMAToUserBufferCopy(TX1_buffer, ENDP1_RXADDR, DataLen);
   - x! y) i' m" R
4. SetEPRxValid(ENDP1);
   ( r5 x/ g; ~. d1 G: @1 L, [. ?
5. USART1_Send(DataLen);
   4 y/ U" @- K) b+ g
6. count_out = 1;

复制代码

  x: E: a) B: G8 Y2、数据发送

1. UserToPMABufferCopy(InBuffer, GetEPTxAddr(ENDP1), 64);
   # A' ~+ M* `* L1 `! v5 h
2. SetEPTxCount(ENDP1, 64);
   . \" ?" o2 `9 g9 E8 @% X2 M* u6 q
3. SetEPTxValid(ENDP1);

复制代码

8 S2 f! |1 A7 C9 h9 G如果你发送数据较为频繁，每次发送前应使用GetEPTxStatus(ENDP1)检测上次发送是否完成。如果端点状态处于EP_TX_VALID，说明发送未结束，如果端点状态处于EP_TX_NAK，说明发送结束。


! \: q0 a. g1 Q8 {( s/ J(by xidongs)

谢谢，已经移植可以识别，但是上位机软件怎么写啊

没有看到你最后写的 发送数据 写在哪个函数啊

有没有上位机软件的编写方法

谢谢分享，标记一下

谢谢分享，标记一下

谢谢分享. 学习了

谢谢，分享

支持下，标记下！

感谢分享

谢谢分享，标记一下

很不错很不错啊

正好在学习这一块，感谢分享~

牛逼了啊,谢谢

好东西

啊士大夫随风倒