前面说了USB鼠标，这次趁热打铁，说一下USB键盘。依然只说如何修改，不说背后的原理。原因你懂的，涉及的知识点太多了。

会不会写成USB三部曲？    不知道

猜猜我下一步再写个啥？

0 y5 X9 C6 |- V6 [8 D9 U

生成工程

+ t% x, Y6 K" x6 b2 Q$ o, q

首先，STM32CubeMX的配置部分不说了，和USB鼠标部分的一样。唯一需要注意的一点是，VID和PID这两个值要改一下，否则主机（也就是电脑）会以为你还是鼠标。
1 f5 R3 L* V: f9 _- ?

$ n9 u# p# [3 K; |( X9 ]% d6 g1 N( v

修改usbd_hid.c文件

% R7 [0 c: [: ~# A, H9 J) H' M  F

其次，生成工程后打开，修改usbd_hid.c文件。配置集合（USBD_HID_CfgFSDesc）要做一些改动，首先是长度：
+ o$ D, [; M* {, b; z

这是个宏定义，之前是34，现在变成41.

然后是端点数，之前是1，现在改成2.

接着是接口协议，之前是2（鼠标），现在改成1（键盘）。

再接着是报告描述符长度：

之前是：HID_MOUSE_REPORT_DESC_SIZE，长度是74，现在改成：

HID_KEYBOARD_REPORT_DESC_SIZE，长度63.

- Z; g- l6 `1 V/ G. R' k

还有就是端点每次发送的数据包长度：

之前是4，不够用了，现在改成16.

最后配置集合中增加一部分端点描述符，因为USB键盘对主机来说，不光有输入，还有输出。所以，增加的这部分端点描述符，用来描述输出。

1. 
     j2 }# F9 D5 j* p7 d! t  z
2. /******************** Descriptor of Mouse Output endpoint ********************/
   3 b0 K: \/ W& ^! E
3.   0x07,          /*bLength: Endpoint Descriptor size*/
   
4.   USB_DESC_TYPE_ENDPOINT, /*bDescriptorType:*/
   . ^3 y- y  U0 S$ d; [
5.   0x01,
   8 V6 M& T  ?3 _9 T. i* f' l& G
6.   0x03,          /*bmAttributes: Interrupt endpoint*/
   1 N$ S0 D: |: \6 j7 u) f
7.   0x10,
   8 i- F' D4 n7 M! r; F* n
8.   0x00,
   ) _0 k, O& S" o3 _
9.   HID_FS_BINTERVAL,          /*bInterval: Polling Interval */

复制代码

修改HID描述符

( I1 g- q4 b1 k/ i: o9 v

修改HID描述符中的报告描述符长度：

上面提到了，之前是鼠标描述符，长度74，现在改成键盘描述符，长度63.

生成键盘的报告描述符

把USB鼠标的报告描述符删掉，换成USB键盘的报告描述符。
$ |9 C" O, ?7 P3 J( [/ d3 y

不会写USB键盘的报告描述符怎么办？

USB官方提供了一个USB报告描述符自动配置的工具，打开！里面有各种例程，我们直接复制一个USB键盘的报告描述符即可。

生成.h文件如下：

1. 
   
2. __ALIGN_BEGIN static uint8_t HID_KEYBOARD_ReportDesc[HID_KEYBOARD_REPORT_DESC_SIZE]  __ALIGN_END =
   7 o. V- r; ~6 H; t
3. {
   * }! ~* \3 E$ K' y: g
4.     0x05, 0x01,                    // USAGE_PAGE (Generic Desktop)
   
5.     0x09, 0x06,                    // USAGE (Keyboard)
   9 X! v7 s# ~0 W- l* E
6.     0xa1, 0x01,                    // COLLECTION (Application)
   
7.     0x05, 0x07,                    //   USAGE_PAGE (Keyboard)
   , i) r( p2 ~! J# Z0 ^2 m- u
8.     0x19, 0xe0,                    //   USAGE_MINIMUM (Keyboard LeftControl)
   3 m, K+ m$ n0 C
9.     0x29, 0xe7,                    //   USAGE_MAXIMUM (Keyboard Right GUI)
   1 S: Z! H) r7 ]& B" @  c3 o! j
10.     0x15, 0x00,                    //   LOGICAL_MINIMUM (0)
    
11.     0x25, 0x01,                    //   LOGICAL_MAXIMUM (1)
    
12.     0x75, 0x01,                    //   REPORT_SIZE (1)
    * s. l' [- X2 v4 `" I" z
13.     0x95, 0x08,                    //   REPORT_COUNT (8)
    
14.     0x81, 0x02,                    //   INPUT (Data,Var,Abs)
    6 j: i% r( H8 X+ e  M0 L2 i
15.     0x95, 0x01,                    //   REPORT_COUNT (1)
    
16.     0x75, 0x08,                    //   REPORT_SIZE (8)
    
17.     0x81, 0x03,                    //   INPUT (Cnst,Var,Abs)
    
18.     0x95, 0x05,                    //   REPORT_COUNT (5)
    
19.     0x75, 0x01,                    //   REPORT_SIZE (1)
    0 |# _. I. X, H8 \3 C( k  f
20.     0x05, 0x08,                    //   USAGE_PAGE (LEDs)
    
21.     0x19, 0x01,                    //   USAGE_MINIMUM (Num Lock)
    5 _! |/ u; g8 u; F- p* }8 f
22.     0x29, 0x05,                    //   USAGE_MAXIMUM (Kana)
    % h( x' a% [, Z  e* [3 a6 c
23.     0x91, 0x02,                    //   OUTPUT (Data,Var,Abs)
    $ w3 C' }: a8 V! A4 f
24.     0x95, 0x01,                    //   REPORT_COUNT (1)
    
25.     0x75, 0x03,                    //   REPORT_SIZE (3)
    
26.     0x91, 0x03,                    //   OUTPUT (Cnst,Var,Abs)
    
27.     0x95, 0x06,                    //   REPORT_COUNT (6)
    ; o! X) B( l; ?. b
28.     0x75, 0x08,                    //   REPORT_SIZE (8)
    ! k$ l2 y5 V, \) F/ F# `0 X: o5 Z
29.     0x15, 0x00,                    //   LOGICAL_MINIMUM (0)
    % @/ i1 e2 w$ p+ A
30.     0x25, 0x65,                    //   LOGICAL_MAXIMUM (101)
    
31.     0x05, 0x07,                    //   USAGE_PAGE (Keyboard)
    
32.     0x19, 0x00,                    //   USAGE_MINIMUM (Reserved (no event indicated))
    
33.     0x29, 0x65,                    //   USAGE_MAXIMUM (Keyboard Application)
    # y- S3 A0 Q" u2 e4 X: E3 e
34.     0x81, 0x00,                    //   INPUT (Data,Ary,Abs)
    
35.     0xc0                           // END_COLLECTION
    % ~$ z0 W5 ^; m( G; i  e: V
36. };

复制代码

  j+ G$ t, C+ h

! q2 F6 i1 z/ ?

修改函数USBD_HID_Setup

& r/ g% ?8 Z3 O3 ~" a& B+ H

第五，函数USBD_HID_Setup中，需要修改一部分代码：

获取报告描述符的部分，之前这里是鼠标的报告描述符信息，现在换成了键盘的。

, E# F7 `8 s9 C! W

修改main.c文件

main.c文件中，添加头文件，并定义相关的数组：

1. <font color="#001000"><font style="background-color:rgb(255, 255, 255)"><font face="Tahoma">
   ' |: B1 A0 l# [" r
2. /* Private includes ----------------------------------------------------------*/
   ! u2 P4 U' g( K% \/ h! D4 a: L& F
3. /* USER CODE BEGIN Includes */
   " ]' ]# ]7 {( Y! s
4. #include "usbd_hid.h"
   
5. /* USER CODE END Includes */
   
6. 
   $ N& ]: O; U3 g7 I, ?  E1 L0 p
7. 
   
8. /* Private typedef -----------------------------------------------------------*/
   : [4 ~9 S8 {: U
9. /* USER CODE BEGIN PTD */
   
10. uint8_t KeyBoard[8] = {0,0,4,0,0,0,0,0};
    + Q1 N* _. f( l9 o9 k
11. uint8_t KeyBoard01[8] = {0,0,0,0,0,0,0,0};
      K7 O6 b5 w+ D/ J) d
12. extern USBD_HandleTypeDef hUsbDeviceFS;</font></font></font><font color="#001000"><font style="background-color:rgb(255, 255, 255)">
    6 ~+ j+ V7 O9 Q( m" C5 Q4 y
13. </font></font>

复制代码

修改主函数

. \- K  C3 d* V+ Z

第七，主函数中循环发送英文字母A~Z。

1. <font color="#001000"><font style="background-color:rgb(255, 255, 255)"><font face="Tahoma">
   
2. while (1)
   
3.   {
   
4.     /* USER CODE END WHILE */
   ) F$ x' b0 e. C. ?! C8 t& f
5. 
   
6. 
   $ x. I( l: b: [* v( C
7.     /* USER CODE BEGIN 3 */
   ( P5 D4 I% ]0 e% _* Q# ^( ^
8.     if(KeyBoard[2] >= 29)
   
9.     {
   
10.       KeyBoard[2] = 4;
    & s  y7 `5 d8 p& K
11.     }
    
12.     else
    
13.     {
    
14.       KeyBoard[2]++;
    ; p, s7 M, K6 {
15.     }
    
16.     USBD_HID_SendReport(&hUsbDeviceFS,(uint8_t*)&KeyBoard01,sizeof(KeyBoard));
      u+ V. ]* K' @( Z2 `
17.     HAL_Delay(15);
    
18.     USBD_HID_SendReport(&hUsbDeviceFS,(uint8_t*)&KeyBoard,sizeof(KeyBoard01));
      ]( Y+ I3 C$ |  P- w: Y
19.     HAL_Delay(15);
    , ]# b% @# W& a' {7 r; l
20.     USBD_HID_SendReport(&hUsbDeviceFS,(uint8_t*)&KeyBoard01,sizeof(KeyBoard));
    7 `7 r$ `) m. Y% K) x0 O
21.     HAL_Delay(1000);
    
22.   }</font></font></font>
    

复制代码

& w. r- e  W7 t1 W

为什么4~29对应英文字母A~Z？

USB官网的文件hut1_12v2中，对键盘的每个按键对应的值，都有一个详细的定义，看第53页，我这里截一部分图：

4 |- c& S% ~) ~9 g. G1 ]- X

最后，保存、编译、下载、上电！新建一个TXT文档，看键盘自动输出字母，爽不爽？

: x9 J8 l0 v! P! B  e

" w& E1 G" C; i, [

基于STM32CUBE的USB鼠标键盘二合一
$ i, D; B0 I8 K0 S: c
" q4 r( ~( e5 ~0 {4 t1 E% c& n3 e
% F2 a* ~7 R& E" t0 ]

首先，在5.3.0版本的STM32CubeMX上选择STM32F103C8T6芯片。具体操作和USB鼠标的操作一样，这里就不重复了。
/ k& b& w' w" V. M% Z# m

同理，VID和PID要和之前的设备不一样。设置完成以后，直接生成工程。

第二，修改usbd_hid.c中的配置集合（USBD_HID_CfgFSDesc）。如下图所示，框住的地方是个宏定义。配置集合的长度，由之前的34，变为41.

端点个数，由1变成2.

接口协议，由2（鼠标）变成1（键盘）。

有的小伙伴会奇怪，我们不是鼠标键盘二合一吗？怎么还是键盘？

作为一个技术人员，我们要学会透过现象看本质。虽然表明上是鼠标与键盘二合一，但实际上是以键盘功能为主，而鼠标以一个附属功能加入到了键盘里。所以，这里虽然选的是键盘，但最终的效果是键盘鼠标功能都有。

好了，继续！

跟USB键盘的部分一样，配置集合最下面，增加一个输出端点的描述符：

1. <font color="#001000"><font style="background-color:rgb(255, 255, 255)"><font face="Tahoma">
   * L" l- A: ~" L' k+ J: n) S& `/ U
2. /******************** Descriptor of Mouse Output endpoint ********************/
   
3.   0x07,          /*bLength: Endpoint Descriptor size*/
   
4.   USB_DESC_TYPE_ENDPOINT, /*bDescriptorType:*/
   5 y4 ]5 u2 n8 s6 \0 s8 @
5.   0x01,
   
6.   0x03,          /*bmAttributes: Interrupt endpoint*/
   
7.   0x10,
   ( _" @1 V. E( y) e
8.   0x00,
   8 r; s* k0 k3 ?% A' j3 G" k9 d* q, r  C
9.   HID_FS_BINTERVAL,          /*bInterval: Polling Interval */</font></font></font>
   

复制代码

5 H+ g! k. V$ P9 d6 y& E: f9 s& o

第三，修改HID描述符中，报告描述符的长度：

之前这里是鼠标的报告描述符，长度有74.现在变成了117.

为什么是117？

看下文！

' i- U  g7 C) G  U

第四，修改报告描述符。STM32CubeMX工具自动生成的工程里，报告描述符是鼠标的。现在我们要实现的是键盘与鼠标二合一，要修改的核心位置就是报告描述符这里。

- Z) R- O3 p3 h; W) r

简单来说，就是把前面两个例程中的报告描述符合二为一。一个数组里面，上面放键盘的报告描述符，下面放鼠标的报告描述符。

! E( m* v* h; i4 F/ I4 _/ M# z

这样的话，对USB主机（也就是电脑）来说，它收到的数据，有可能是鼠标的数据，也有可能是键盘的数据。那，怎么区分？

方法就是分别在键盘与鼠标的报告描述符中放一个报告ID，键盘的报告ID是1，鼠标的报告ID是2.    两个报告描述符，一个长65，一个长62，加起来117.

向USB主机发送数据的时候，数组的第一个元素是报告ID,后面才是键盘数据或鼠标数据。实现前面两节的例程的时候，USB键盘我们定义了一个8元素的数组，USB鼠标我们定义了一个4元素的数组。现在我们只需要一个数组，它同一时间，只发送一种数据，所以大小为8，然后，还要包含报告ID，所以变成9.

在USB协议中，报告ID默认是数组的第一个元素。明白了这一点，我们可以去修改main.c文件了。

第五，添加头文件，并定义相关的数组。

1. <font color="#001000"><font style="background-color:rgb(255, 255, 255)"><font face="Tahoma">
   
2. /* Private includes ----------------------------------------------------------*/
   
3. /* USER CODE BEGIN Includes */
   3 [0 k" F. A* L4 q1 w( u3 q& c
4. #include "usbd_hid.h"
   % ?4 V: p1 x# t2 O4 _
5. /* USER CODE END Includes */
   ( h5 _/ ], q, E* @9 s; q
6. 
   
7. 
   
8. /* Private typedef -----------------------------------------------------------*/
   
9. /* USER CODE BEGIN PTD */
   
10. uint8_t KeyBoard[9] = {1,0,0,4,0,0,0,0,0};
    
11. uint8_t KeyBoard01[9] = {1,0,0,0,0,0,0,0,0};
    6 |* e' b3 t1 C) p! U. J! e
12. uint8_t Mouse[9] = {2,0,0,0,0,0,0,0,0};
    ; f* I6 K% S; h5 r
13. extern USBD_HandleTypeDef hUsbDeviceFS;</font></font></font><font color="#001000"><font style="background-color:rgb(255, 255, 255)">
    
14. </font></font>

复制代码

! j. f, G* f2 R

KeyBoard 数组第一个元素是1，Mouse 数组第一个元素是2，这两个值分别对应键盘和鼠标的报告ID。KeyBoard01这个数组是为了表示键盘没有被按下的状态。

0 q9 N  d+ K/ j1 N0 k

第六，修改主函数。循环输出a到z字母，同时，鼠标左键每隔1秒触发一下。

1. 
   " p+ T! O4 @; T, K8 ]+ ~# {) ?
2.    /* USER CODE BEGIN 3 */
   ; a" ~- G& k' l0 U4 s
3.     if(KeyBoard[3] >= 29)
   # G3 D6 @6 p. a* P
4.     {
   
5.       KeyBoard[3] = 4;
   
6.     }
   
7.     else
   
8.     {
   
9.       KeyBoard[3]++;
   
10.     }
    - C3 o' m2 H/ d  \2 {% t* y3 I
11.     USBD_HID_SendReport(&hUsbDeviceFS,(uint8_t*)&KeyBoard01,sizeof(KeyBoard));
    ) G5 H5 s' r) X% K
12.     HAL_Delay(15);
    7 Y* P( |2 k( a4 g
13.     USBD_HID_SendReport(&hUsbDeviceFS,(uint8_t*)&KeyBoard,sizeof(KeyBoard));
    5 h/ M1 k, @$ {5 M8 C
14.     HAL_Delay(15);
    5 }! c; R+ O$ G2 j
15.     USBD_HID_SendReport(&hUsbDeviceFS,(uint8_t*)&KeyBoard01,sizeof(KeyBoard));
    + R9 c% \4 u0 k' y' Y4 C
16.     HAL_Delay(1000);
    
17. 
    " {7 x" m. K9 y" r
18.     Mouse[1] = 0x01;
    2 t9 i3 J) S& a- u% Q9 C& Z, m. \& g
19.     USBD_HID_SendReport(&hUsbDeviceFS,(uint8_t*)&Mouse,sizeof(Mouse));
    
20.     HAL_Delay(1000);
    : E9 N. X' ~6 x3 [' @) T
21.     Mouse[1] = 0x00;
    / `* e: g# s. |# h
22.     USBD_HID_SendReport(&hUsbDeviceFS,(uint8_t*)&Mouse,sizeof(Mouse));
    
23.     HAL_Delay(1000);

复制代码

最后，保存、编译、下载、上电！新建一个TXT文档，可以看到字母自动输出，同时鼠标左键每隔1秒被触发一下。

谢谢分享！

感谢分享

厉害，谢谢分享