21ic电子技术开发论坛 › 单片机与嵌入式系统 › 极海MCU › APM32F072 USB键盘+鼠标
返回列表 发新帖我要提问本帖赏金: 40.00元(功能说明)

[APM32F0] APM32F072 USB键盘+鼠标

[复制链接]
 楼主| Peixu 发表于 2024-7-29 10:32 | 显示全部楼层 |阅读模式
<
复合设备, 键盘, 鼠标, USB, HID, APM32F072
本帖最后由 Peixu 于 2024-8-2 09:55 编辑

[url=home.php?mod=space&uid=760190]@21小跑堂 #申请原创#[/url]
这次给大家介绍一下如何用APM32F072的USB HID配置一个 USB键盘+鼠标 复合设备的过程。
首先我们需要1个USB键盘的例程（官方有例程）
第二步我们需要1个USB 鼠标的例程  （官方有例程）
第三步将他们结合起来变成USB 键盘+鼠标
6c3134e8113fa3cee16a342cd24e0b46
这里我们用USB鼠标的例程基础上添加键盘的功能。

第亿、打开USB_HID例程，修改USBD_ConfigDesc中的（USBD_CONFIG_DESCRIPTOR_SIZE）。
如下图所示的宏定义。配置集合的长度，由之前的34，改为41.
b533796f9ecc481e7c20be8e9197286c
9f543a4dbe6714d8498e7f72957a06a7
第二、USBD_ConfigDesc函数继续往下走找到
1、端点个数：由0x01变成0x02.
2、接口协议：由0x02（鼠标）变成0x01（键盘）。
这里主要还是以键盘功能为主，鼠标只是以一个附属功能加入到了键盘里。
945a29c3074c0df52e094d6ac24f94fa
3、在原来的鼠标例程上的最下面增加了一个输出端点的描述符：
69d7d43080d169dfe97005ddfd365bf7
第三，在usbd_hid.c修改USBD_HIDReportDesc函数报告描述符的长度：之前这里是鼠标的报告描述符，长度是74 改成117
dc4dd1cdba41ca1aa2d9ed882e34164e
40074b3b6b7c995465389f9c22a12b2f
接下来就是将键盘和鼠标的报告描述符合并为一个数组，分别在键盘和鼠标的报告描述符中放一个报告ID，
键盘的报告ID是1，鼠标的报告ID是2。这样USB主机就可以区分开收到的数据是键盘或是鼠标的数据。
c86a8bcfaf5b2922806966b45974dc75
47a6a32086f6b388f43f59914f6f3a18
这是加入后HID键盘+鼠标里的完整报告描述符
复制
  1. uint8_t USBD_HIDReportDesc[USBD_HID_MOUSE_REPORT_DESC_SIZE] =
    

  2. {
    


  3. 

  4.     0x05, 0x01,                    // USAGE_PAGE (Generic Desktop)
    

  5.     0x09, 0x06,                    // USAGE (Keyboard)
    

  6.     0xa1, 0x01,                    // COLLECTION (Application)
    

  7.     0x85, 0x01,                    //   REPORT_ID (1)
    

  8.     0x05, 0x07,                    //   USAGE_PAGE (Keyboard)
    

  9.     0x19, 0xe0,                    //   USAGE_MINIMUM (Keyboard LeftControl)
    

  10.     0x29, 0xe7,                    //   USAGE_MAXIMUM (Keyboard Right GUI)
    

  11.     0x15, 0x00,                    //   LOGICAL_MINIMUM (0)
    

  12.     0x25, 0x01,                    //   LOGICAL_MAXIMUM (1)
    

  13.     0x75, 0x01,                    //   REPORT_SIZE (1)
    

  14.     0x95, 0x08,                    //   REPORT_COUNT (8)
    

  15.     0x81, 0x02,                    //   INPUT (Data,Var,Abs)
    

  16.     0x95, 0x01,                    //   REPORT_COUNT (1)
    

  17.     0x75, 0x08,                    //   REPORT_SIZE (8)
    

  18.     0x81, 0x03,                    //   INPUT (Cnst,Var,Abs)
    

  19.     0x95, 0x05,                    //   REPORT_COUNT (5)
    

  20.     0x75, 0x01,                    //   REPORT_SIZE (1)
    

  21.     0x05, 0x08,                    //   USAGE_PAGE (LEDs)
    

  22.     0x19, 0x01,                    //   USAGE_MINIMUM (Num Lock)
    

  23.     0x29, 0x05,                    //   USAGE_MAXIMUM (Kana)
    

  24.     0x91, 0x02,                    //   OUTPUT (Data,Var,Abs)
    

  25.     0x95, 0x01,                    //   REPORT_COUNT (1)
    

  26.     0x75, 0x03,                    //   REPORT_SIZE (3)
    

  27.     0x91, 0x03,                    //   OUTPUT (Cnst,Var,Abs)
    

  28.     0x95, 0x06,                    //   REPORT_COUNT (6)
    

  29.     0x75, 0x08,                    //   REPORT_SIZE (8)
    

  30.     0x15, 0x00,                    //   LOGICAL_MINIMUM (0)
    

  31.     0x25, 0x65,                    //   LOGICAL_MAXIMUM (101)
    

  32.     0x05, 0x07,                    //   USAGE_PAGE (Keyboard)
    

  33.     0x19, 0x00,                    //   USAGE_MINIMUM (Reserved (no event indicated))
    

  34.     0x29, 0x65,                    //   USAGE_MAXIMUM (Keyboard Application)
    

  35.     0x81, 0x00,                    //   INPUT (Data,Ary,Abs)
    

  36.     0xc0,                           // END_COLLECTION
    

  37.                 
    

  38.     0x05, 0x01,                    // USAGE_PAGE (Generic Desktop)
    

  39.     0x09, 0x02,                    // USAGE (Mouse)
    

  40.     0xa1, 0x01,                    // COLLECTION (Application)
    

  41.     0x85, 0x02,                    //   REPORT_ID (2)
    

  42.     0x09, 0x01,                    //   USAGE (Pointer)
    

  43.     0xa1, 0x00,                    //   COLLECTION (Physical)
    

  44.     0x05, 0x09,                    //     USAGE_PAGE (Button)
    

  45.     0x19, 0x01,                    //     USAGE_MINIMUM (Button 1)
    

  46.     0x29, 0x03,                    //     USAGE_MAXIMUM (Button 3)
    

  47.     0x15, 0x00,                    //     LOGICAL_MINIMUM (0)
    

  48.     0x25, 0x01,                    //     LOGICAL_MAXIMUM (1)
    

  49.     0x95, 0x03,                    //     REPORT_COUNT (3)
    

  50.     0x75, 0x01,                    //     REPORT_SIZE (1)
    

  51.     0x81, 0x02,                    //     INPUT (Data,Var,Abs)
    

  52.     0x95, 0x01,                    //     REPORT_COUNT (1)
    

  53.     0x75, 0x05,                    //     REPORT_SIZE (5)
    

  54.     0x81, 0x03,                    //     INPUT (Cnst,Var,Abs)
    

  55.     0x05, 0x01,                    //     USAGE_PAGE (Generic Desktop)
    

  56.     0x09, 0x30,                    //     USAGE (X)
    

  57.     0x09, 0x31,                    //     USAGE (Y)
    

  58.     0x15, 0x81,                    //     LOGICAL_MINIMUM (-127)
    

  59.     0x25, 0x7f,                    //     LOGICAL_MAXIMUM (127)
    

  60.     0x75, 0x08,                    //     REPORT_SIZE (8)
    

  61.     0x95, 0x02,                    //     REPORT_COUNT (2)
    

  62.     0x81, 0x06,                    //     INPUT (Data,Var,Rel)
    

  63.     0xc0,                          //   END_COLLECTION
    

  64.     0xc0                           // END_COLLECTION
    

  65. };

这样，我们USB键盘+鼠标二合一就改好了， 那么需要怎么使用呢？
第三、鼠标和键盘的使用属性简单介绍：
1、Mouse 鼠标：
我们用的鼠标主要就四个属性：键位（左键、右键、中键），左右移动、上下移动、滑轮
第 1 个字节（buff[0]）：按钮状态    0x01左键   0x02右键   0x04中键（滚轮按钮）
第 2 个字节（buff[1]）：X 轴移动量
第 3 个字节（buff[2]）：Y 轴移动量
第 4 个字节（buff[3]）：滚轮移动量  0x01表示滚轮向前滚动一格；0xFF表示滚轮向后滚动一格；0x80是个中间值，不滚动。
以下是一个简单的鼠标使用发送函数示例：
复制
  1. void HidMouse_Write(uint8_t key)
    

  2. {
    

  3.     int8_t x = 0;
    

  4.     int8_t y = 0;
    

  5.         
    

  6.     int8_t Button = 0;
    

  7.     int8_t Wheel = 0;
    

  8.         
    

  9.     uint8_t buffer[4] = {0, 0, 0, 0};
    


  10. 

  11.     switch (key)
    

  12.     {
    

  13.         case HID_MOUSE_KEY_LEFT:
    

  14.             x -= 10;                        
    

  15.         break;
    


  16. 

  17.         case HID_MOUSE_KEY_RIGHT:
    

  18.             x += 10;
    

  19.         break;
    


  20. 

  21.         case HID_MOUSE_KEY_UP:
    

  22.             y -= 10;                
    

  23.         break;
    


  24. 

  25.         case HID_MOUSE_KEY_DOWN:
    

  26.             y += 10;
    

  27.         break;
    


  28. 

  29.         case HID_MOUSE_BUTTON:
    

  30.             Button = 0x01;                        //0x01左键   0x02右键   0x04中键（滚轮按钮）
    

  31.         break;
    

  32.                                 
    

  33.         case HID_MOUSE_WHEEL:
    

  34.             Wheel = 0xff;                //0x01表示滚轮向前滚动一格；0xFF表示滚轮向后滚动一格；0x80是个中间值，不滚动。
    

  35.         break;                                
    

  36.         default:
    

  37.             return;
    

  38.     }
    

  39.     buffer[0] = Button;
    

  40.     buffer[1] = x;
    

  41.     buffer[2] = y;
    

  42.     buffer[3] = Wheel;
    

  43.                 
    

  44.     s_statusEP = 0;
    


  45. 

  46.     USBD_TxData(USBD_EP_1, buffer, sizeof(buffer));
    

  47. }

2、Keyboard 键盘：
在键盘 HID 报告格式中，每个字节代表不同的含义：
第 1 个字节（buff[0]） 修饰键的状态（如 Ctrl、Alt、Shift 等）。
0x01 表示左 Ctrl 按下。
0x02 表示左 Shift 按下。
0x04 表示左 Alt 按下。
依此类推。
第 2 个字节（buff[1]）：保留字节，通常为 0，不使用。
第 3 到第 8 个字节（buff[2] - buff[7]）：按键代码，最多可以同时报告 6 个按键。
例如：
0x04 表示字母 'A' 键。
0x05 表示字母 'B' 键。
依此类推。
以下是一个简单的键盘使用发送函数示例：A-Z
复制
  1. void USB_DevUserApplication(void)
    

  2. {
    

  3.     static uint8_t userAppState = USER_APP_INIT;
    

  4.     static uint8_t interval = 0;
    

  5.     static uint8_t report[8] = { 0 };
    

  6.     static uint8_t i = 4;
    


  7. 

  8.     switch (userAppState)
    

  9.     {
    

  10.         case USER_APP_INIT:
    

  11.             interval = USBD_CUSTOM_HID_ReadInterval(&gUsbDeviceFS);
    


  12. 

  13.             report[0] = 0;
    

  14.             report[1] = 0;
    

  15.             report[2] = 0;
    

  16.             report[3] = 0;
    

  17.             userAppState = USER_APP_RUN;
    

  18.             break;
    


  19. 

  20.         case USER_APP_RUN:
    

  21.             if (!APM_MINI_PBGetState(BUTTON_KEY1))
    

  22.             {
    

  23.                 APM_DelayMs(10);
    

  24.                 if (!APM_MINI_PBGetState(BUTTON_KEY1))
    

  25.                 {
    

  26.                     if(i > 29)
    

  27.                     {
    

  28.                         i = 4;
    

  29.                         report[2] = KEYBOARD_ENTER;
    

  30.                         USBD_CUSTOM_HID_TxReport(&gUsbDeviceFS, (uint8_t*)report, 8);
    

  31.                         APM_DelayMs(20);
    

  32.                         report[2] = 0;
    

  33.                         USBD_CUSTOM_HID_TxReport(&gUsbDeviceFS, (uint8_t*)report, 8);
    

  34.                         APM_DelayMs(20);
    

  35.                     }
    

  36.                     
    

  37.                     report[2] = i;
    

  38.                     USBD_CUSTOM_HID_TxReport(&gUsbDeviceFS, (uint8_t*)report, 8);
    

  39.                     
    

  40.                     APM_DelayMs(20);
    

  41.                     
    

  42.                     report[2] = 0;
    

  43.                     USBD_CUSTOM_HID_TxReport(&gUsbDeviceFS, (uint8_t*)report, 8);
    

  44.                     
    

  45.                     i++;
    

  46.                     
    

  47.                     while(!APM_MINI_PBGetState(BUTTON_KEY1));
    

  48.                 }
    

  49.             }
    


  50. 

  51.             APM_DelayMs(interval);
    

  52.             break;
    

  53.     }
    

  54. }

现在我们将它结合起来向USB主机发送数据的时候就需要做出改变了，现在的数组的第一个元素是报告ID,后面才是键盘数据或鼠标数据。
在上面的两个示例中，USB键盘我们定义了一个8元素的数组，USB鼠标我们定义了一个4元素的数组。
现在我们需要一个数组，在同一时间的时候只发送一种数据，再加上报告ID，所以变成9个.
以下是一个简单的键+鼠标使用发送函数示例
复制
  1. void USB_DevUserApplication(void)
    

  2. {
    

  3.     static uint8_t userAppState = USER_APP_INIT;
    

  4.     static uint8_t interval = 0;
    


  5. 

  6.     uint8_t KeyBoard[9] = {1,0,0,0,0,0,0,0,0};
    

  7.     uint8_t Mouse[9] = {2,0,0,0,0,0,0,0,0};
    

  8.     static uint8_t i = 4;                
    


  9. 

  10.     switch (userAppState)
    

  11.     {
    

  12.         case USER_APP_INIT:
    

  13.             interval = USBD_HID_ReadInterval(&gUsbDeviceFS);
    


  14. 

  15.             KeyBoard[0] = 0;
    

  16.             KeyBoard[1] = 0;
    

  17.             KeyBoard[2] = 0;
    

  18.             KeyBoard[3] = 0;
    

  19.             userAppState = USER_APP_RUN;
    

  20.             break;
    


  21. 

  22.         case USER_APP_RUN:
    

  23.             if (!APM_MINI_PBGetState(BUTTON_KEY1))
    

  24.             {
    

  25.                 APM_DelayMs(10);
    

  26.                 if (!APM_MINI_PBGetState(BUTTON_KEY1))
    

  27.                 {
    

  28.                     if(i > 29)
    

  29.                     {
    

  30.                         i = 4;
    

  31.                         KeyBoard[3] = KEYBOARD_ENTER;
    

  32.                         USBD_HID_TxReport(&gUsbDeviceFS, (uint8_t*)KeyBoard, sizeof(KeyBoard));
    

  33.                         APM_DelayMs(20);
    

  34.                         KeyBoard[3] = 0;
    

  35.                         USBD_HID_TxReport(&gUsbDeviceFS, (uint8_t*)KeyBoard, sizeof(KeyBoard));
    

  36.                         APM_DelayMs(20);
    

  37.                     }
    

  38.                                                                                 KeyBoard[3] = i;
    

  39.                     USBD_HID_TxReport(&gUsbDeviceFS, (uint8_t*)KeyBoard, sizeof(KeyBoard));
    

  40.                     
    

  41.                     APM_DelayMs(20);
    

  42.                     
    

  43.                     KeyBoard[3] = 0;
    

  44.                     USBD_HID_TxReport(&gUsbDeviceFS, (uint8_t*)KeyBoard, sizeof(KeyBoard));
    

  45.                     
    

  46.                     i++;
    

  47.                     
    

  48.                     while(!APM_MINI_PBGetState(BUTTON_KEY1));
    

  49.                 }
    

  50.             }
    


  51. 

  52.             if (!APM_MINI_PBGetState(BUTTON_KEY2))
    

  53.             {
    

  54.                 APM_DelayMs(10);
    

  55.                 if (!APM_MINI_PBGetState(BUTTON_KEY2))
    

  56.                 {
    

  57.                                                                                 Mouse[3] -= 10;
    

  58.                     USBD_HID_TxReport(&gUsbDeviceFS, (uint8_t*)Mouse, sizeof(Mouse));
    

  59.                 }
    

  60.             }
    


  61. 

  62.             APM_DelayMs(interval);
    

  63.             break;
    

  64.     }
    

  65. }


回复 赏

举报

打赏榜单

21小跑堂 打赏了 40.00 元 2024-07-31
理由：恭喜通过原创审核！期待您更多的原创作品~

评论

21小跑堂
基于M32F072单片机移植USB键盘加鼠标复合驱动，过程讲解详细，代码展出完整。  发表于 2024-7-31 17:38

相关帖子
gouguoccc 发表于 2024-8-1 08:13 来自手机 | 显示全部楼层
我晕，一大饼代码还有乱码，看的心累啊。
回复 赏

举报

返回列表 发新帖
高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 注册

本版积分规则

Peixu

32

主题

58

帖子

0

粉丝
快速回复 在线客服 返回列表 返回顶部