设为首页收藏本站
首页 > 论坛 > ESP32

[ESP8266/ESP32]USB 手柄改蓝牙 精华

zoologist | 高级技匠 | 创造力： | 帖子： | 发消息 | 串个门 | 加好友 | 打招呼
2022-9-26 15:58:19 [显示全部楼层]
2917浏览
10回复
0收藏
查看: 2917|回复: 10

[ESP8266/ESP32] USB 手柄改蓝牙

[复制链接]
之前介绍过一个USB键盘转蓝牙键盘的装置【参考1】，这次使用的同样的设计来实现USB游戏手柄改装为蓝牙游戏手柄。
具体硬件设计在【参考1】中：
USB 手柄改蓝牙图1
接下来我们完全聚焦在软件设计上：
首先，检查手上USB手柄的描述符。抓到的数据如下：

  
Usage Page (Generic Desktop)
  		  
05 01
  
  
Usage (Joystick)
  		  
09 04
  
  
Collection  (Application)
  		  
A1 01
  
  
    Collection  (Logical)
  		  
A1 02
  
  
        Report  Size (8)
  		  
75 08
  
  
        Report  Count (2)
  		  
95 02
  
  
        Logical  Minimum (0)
  		  
15 00
  
  
        Logical  Maximum (255)
  		  
26 FF 00
  
  
        Physical  Minimum (0)
  		  
35 00
  
  
        Physical  Maximum (255)
  		  
46 FF 00
  
  
        Usage  (X)
  		  
09 30
  
  
        Usage  (Y)
  		  
09 31
  
  
        Input (Data,Var,Abs,NWrp,Lin,Pref,NNul,Bit)
  		  
81 02
  
  
        Report  Count (1)
  		  
95 01
  
  
        Input (Cnst,Ary,Abs)
  		  
81 01
  
  
        Report  Count (2)
  		  
95 02
  
  
        Usage  (Z)
  		  
09 32
  
  
        Usage  (Rz)
  		  
09 35
  
  
        Input (Data,Var,Abs,NWrp,Lin,Pref,NNul,Bit)
  		  
81 02
  
  
        Report  Size (4)
  		  
75 04
  
  
        Report  Count (1)
  		  
95 01
  
  
        Logical  Maximum (7)
  		  
25 07
  
  
        Physical  Maximum (315)
  		  
46 3B 01
  
  
        Unit  (Eng Rot: Degree)
  		  
65 14
  
  
        Usage  (Hat Switch)
  		  
09 39
  
  
        Input (Data,Var,Abs,NWrp,Lin,Pref,Null,Bit)
  		  
81 42
  
  
        Unit  (None)
  		  
65 00
  
  
        Report  Size (1)
  		  
75 01
  
  
        Report  Count (12)
  		  
95 0C
  
  
        Logical  Maximum (1)
  		  
25 01
  
  
        Physical  Maximum (1)
  		  
45 01
  
  
        Usage  Page (Button)
  		  
05 09
  
  
        Usage  Minimum (Button 1)
  		  
19 01
  
  
        Usage  Maximum (Button 12)
  		  
29 0C
  
  
        Input (Data,Var,Abs,NWrp,Lin,Pref,NNul,Bit)
  		  
81 02
  
  
        Usage  Page (Vendor-Defined 1)
  		  
06 00 FF
  
  
        Report  Size (1)
  		  
75 01
  
  
        Report  Count (8)
  		  
95 08
  
  
        Logical  Maximum (1)
  		  
25 01
  
  
        Physical  Maximum (1)
  		  
45 01
  
  
        Usage  (Vendor-Defined 1)
  		  
09 01
  
  
        Input (Data,Var,Abs,NWrp,Lin,Pref,NNul,Bit)
  		  
81 02
  
  
    End  Collection
  		  
C0
  
  
    Collection  (Logical)
  		  
A1 02
  
  
        Report  Size (8)
  		  
75 08
  
  
        Report  Count (7)
  		  
95 07
  
  
        Physical  Maximum (255)
  		  
46 FF 00
  
  
        Logical  Maximum (255)
  		  
26 FF 00
  
  
        Usage  (Vendor-Defined 2)
  		  
09 02
  
  
        Output (Data,Var,Abs,NWrp,Lin,Pref,NNul,NVol,Bit)
  		  
91 02
  
  
    End  Collection
  		  
C0
  
  
End Collection
  		  
C0
  


使用逻辑分析仪可以看到Button6按下时，数据为 7F 7F 00 80 80 0F 02 00
USB 手柄改蓝牙图2
按下Button3时，数据为 7F 7F 00 80 80 4F 00 00
USB 手柄改蓝牙图3
按下Button9时，数据为 7F 7F 00 80 80 0F 10 00
USB 手柄改蓝牙图4
正常的做法是 USB Host 解析，然后从 BLE GamePad上发送出去，但是很明显这种方法非常麻烦。因此，这里研究一种直接将取得的数据转发出去的方法。
游戏手柄是 HID设备，蓝牙是在 USB协议推出之后才逐渐成熟的，因此这部分遵从了USBHID 的协议。在设备发现时，会传输一个类似 HID 描述符的东西给主机，告诉主机后面的数据格式。在 BLE 协议中，这个地方称作HIDreport map。
这里我们使用ESP32-BLE-Gamepad-master库来模拟BLE Gamepad。前面的HIDreport map代码可以在BleGamepad.cpp看到：



  1.    uint8_t *customHidReportDescriptor = new uint8_t[hidReportDescriptorSize];

  2.    memcpy(customHidReportDescriptor, tempHidReportDescriptor, hidReportDescriptorSize);

  3.   BleGamepadInstance->hid->reportMap((uint8_t*)customHidReportDescriptor, hidReportDescriptorSize);

  4.   BleGamepadInstance->hid->startServices();

复制代码
接下来就开始修改代码：
1.     用前面的 USB 手柄的 HID描述符替换库中的HIDReport Map。
  1. 0x05, 0x01,        // Usage Page (Generic Desktop Ctrls)

  2. 0x09, 0x04,        // Usage (Joystick)

  3. 0xA1, 0x01,        // Collection (Application)

  4. 0xA1, 0x02,        //   Collection (Logical)

  5. 0x75, 0x08,        //     Report Size (8)

  6. 0x95, 0x02,        //     Report Count (2)

  7. 0x15, 0x00,        //     Logical Minimum (0)

  8. 0x26, 0xFF, 0x00,  //     Logical Maximum (255)

  9. 0x35, 0x00,        //     Physical Minimum (0)

  10. 0x46, 0xFF, 0x00,  //     Physical Maximum (255)

  11. 0x09, 0x30,        //     Usage (X)

  12. 0x09, 0x31,        //     Usage (Y)

  13. 0x81, 0x02,        //     Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)

  14. 0x95, 0x01,        //     Report Count (1)

  15. 0x81, 0x01,        //     Input (Const,Array,Abs,No Wrap,Linear,Preferred State,No Null Position)

  16. 0x95, 0x02,        //     Report Count (2)

  17. 0x09, 0x32,        //     Usage (Z)

  18. 0x09, 0x35,        //     Usage (Rz)

  19. 0x81, 0x02,        //     Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)

  20. 0x75, 0x04,        //     Report Size (4)

  21. 0x95, 0x01,        //     Report Count (1)

  22. 0x25, 0x07,        //     Logical Maximum (7)

  23. 0x46, 0x3B, 0x01,  //     Physical Maximum (315)

  24. 0x65, 0x14,        //     Unit (System: English Rotation, Length: Centimeter)

  25. 0x09, 0x39,        //     Usage (Hat switch)

  26. 0x81, 0x42,        //     Input (Data,Var,Abs,No Wrap,Linear,Preferred State,Null State)

  27. 0x65, 0x00,        //     Unit (None)

  28. 0x75, 0x01,        //     Report Size (1)

  29. 0x95, 0x0C,        //     Report Count (12)

  30. 0x25, 0x01,        //     Logical Maximum (1)

  31. 0x45, 0x01,        //     Physical Maximum (1)

  32. 0x05, 0x09,        //     Usage Page (Button)

  33. 0x19, 0x01,        //     Usage Minimum (0x01)

  34. 0x29, 0x0C,        //     Usage Maximum (0x0C)

  35. 0x81, 0x02,        //     Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)

  36. 0x06, 0x00, 0xFF,  //     Usage Page (Vendor Defined 0xFF00)

  37. 0x75, 0x01,        //     Report Size (1)

  38. 0x95, 0x08,        //     Report Count (8)

  39. 0x25, 0x01,        //     Logical Maximum (1)

  40. 0x45, 0x01,        //     Physical Maximum (1)

  41. 0x09, 0x01,        //     Usage (0x01)

  42. 0x81, 0x02,        //     Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)

  43. 0xC0,              //   End Collection

  44. 0xA1, 0x02,        //   Collection (Logical)

  45. 0x75, 0x08,        //     Report Size (8)

  46. 0x95, 0x07,        //     Report Count (7)

  47. 0x46, 0xFF, 0x00,  //     Physical Maximum (255)

  48. 0x26, 0xFF, 0x00,  //     Logical Maximum (255)

  49. 0x09, 0x02,        //     Usage (0x02)

  50. 0x91, 0x02,        //     Output (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)

  51. 0xC0,              //   End Collection

  52. 0xC0,              // End Collection

复制代码
2.     直接用上述数据替换之后无法正常工作，现象是系统能够发现手柄，但是系统自带的 Game Controller 中的手柄无法正常出现按键。经过研究发现ESP32-BLE-Gamepad能够正常工作的代码中，REPORTMAP多一个REPORTID。因此修改上面的代码如下：


  1. 0x05, 0x01,        // Usage Page (Generic Desktop Ctrls)

  2. 0x85, 0x03,        // Report ID

  3. 0x09, 0x04,        // Usage (Joystick)

  4. 0xA1, 0x01,        // Collection (Application)

  5. 0xA1, 0x02,        //   Collection (Logical)

  6. 0x75, 0x08,        //     Report Size (8)

复制代码
在英文中，有 JoyStick 和Gamepad的区别，前者可以理解为飞行摇杆这种；后者可以理解为玩拳皇这种的手柄）。

3.1.     接下来我们还要在 BLE GAMEPAD 库中添加一个转发的函数，将收到的 buffer完整的从 BLE 发送出去，代码如下：
  1. void BleGamepad::MySendReport(uint8_t *buffer)

  2. {

  3.         if (this->isConnected())

  4.         {

  5.                 this->inputGamepad->setValue(buffer, 8);

  6.                 this->inputGamepad->notify();

  7.         }

  8. }

复制代码

4.1.     最终代码如下：
  1. #include <BleGamepad.h>

  2. 

  3. #include <elapsedMillis.h>

  4. #include <usb/usb_host.h>

  5. #include "show_desc.hpp"

  6. #include "usbhhelp.hpp"

  7. 

  8. BleGamepad bleGamepad;

  9. 

  10. bool isGamepad = false;

  11. bool isGamepadReady = false;

  12. uint8_t GamepadInterval;

  13. bool isGamepadPolling = false;

  14. elapsedMillis GamepadTimer;

  15. 

  16. uint8_t Button[8];

  17. 

  18. const size_t Gamepad_IN_BUFFER_SIZE = 8;

  19. usb_transfer_t *GamepadIn = NULL;

  20. 

  21. void Gamepad_transfer_cb(usb_transfer_t *transfer)

  22. {

  23.   if (Device_Handle == transfer->device_handle) {

  24.     isGamepadPolling = false;

  25.     if (transfer->status == 0) {

  26.       if (transfer->actual_num_bytes == 8) {

  27.         uint8_t *const p = transfer->data_buffer;

  28.         //ESP_LOGI("", "HID report: %02x %02x %02x %02x %02x %02x %02x %02x",

  29.         //         p[0], p[1], p[2], p[3], p[4], p[5], p[6], p[7]);

  30.         if (bleGamepad.isConnected())

  31.         {

  32.           if (memcmp(p, Button, 8) != 0) {

  33.             ESP_LOGI("", "HID report: %02x %02x %02x %02x %02x %02x %02x %02x",

  34.                      p[0], p[1], p[2], p[3], p[4], p[5], p[6], p[7]);

  35.             memcpy(Button,p,8);

  36.             bleGamepad.MySendReport(Button);

  37.           }

  38.         }

  39.       }

  40.       else {

  41.         ESP_LOGI("", "Gamepad boot hid transfer too short or long");

  42.       }

  43.     }

  44.     else {

  45.       ESP_LOGI("", "transfer->status %d", transfer->status);

  46.     }

  47.   }

  48. }

  49. 

  50. void check_interface_desc_boot_Gamepad(const void *p)

  51. {

  52.   const usb_intf_desc_t *intf = (const usb_intf_desc_t *)p;

  53. 

  54.   if ((intf->bInterfaceClass == USB_CLASS_HID) &&

  55.       (intf->bInterfaceSubClass == 0x00) &&

  56.       (intf->bInterfaceProtocol == 0x00)) {

  57.     isGamepad = true;

  58.     ESP_LOGI("", "Claiming a boot Gamepad!");

  59.     esp_err_t err = usb_host_interface_claim(Client_Handle, Device_Handle,

  60.                     intf->bInterfaceNumber, intf->bAlternateSetting);

  61.     if (err != ESP_OK) ESP_LOGI("", "usb_host_interface_claim failed: %x", err);

  62.   }

  63. }

  64. 

  65. void prepare_endpoint(const void *p)

  66. {

  67.   const usb_ep_desc_t *endpoint = (const usb_ep_desc_t *)p;

  68.   esp_err_t err;

  69. 

  70.   // must be interrupt for HID

  71.   if ((endpoint->bmAttributes & USB_BM_ATTRIBUTES_XFERTYPE_MASK) != USB_BM_ATTRIBUTES_XFER_INT) {

  72.     ESP_LOGI("", "Not interrupt endpoint: 0x%02x", endpoint->bmAttributes);

  73.     return;

  74.   }

  75.   if (endpoint->bEndpointAddress & USB_B_ENDPOINT_ADDRESS_EP_DIR_MASK) {

  76.     err = usb_host_transfer_alloc(Gamepad_IN_BUFFER_SIZE, 0, &GamepadIn);

  77.     if (err != ESP_OK) {

  78.       GamepadIn = NULL;

  79.       ESP_LOGI("", "usb_host_transfer_alloc In fail: %x", err);

  80.       return;

  81.     }

  82.     GamepadIn->device_handle = Device_Handle;

  83.     GamepadIn->bEndpointAddress = endpoint->bEndpointAddress;

  84.     GamepadIn->callback = Gamepad_transfer_cb;

  85.     GamepadIn->context = NULL;

  86.     isGamepadReady = true;

  87.     GamepadInterval = endpoint->bInterval;

  88.     ESP_LOGI("", "USB boot Gamepad ready");

  89.   }

  90.   else {

  91.     ESP_LOGI("", "Ignoring interrupt Out endpoint");

  92.   }

  93. }

  94. 

  95. void show_config_desc_full(const usb_config_desc_t *config_desc)

  96. {

  97.   // Full decode of config desc.

  98.   const uint8_t *p = &config_desc->val[0];

  99.   static uint8_t USB_Class = 0;

  100.   uint8_t bLength;

  101.   for (int i = 0; i < config_desc->wTotalLength; i += bLength, p += bLength) {

  102.     bLength = *p;

  103.     if ((i + bLength) <= config_desc->wTotalLength) {

  104.       const uint8_t bDescriptorType = *(p + 1);

  105.       switch (bDescriptorType) {

  106.         case USB_B_DESCRIPTOR_TYPE_DEVICE:

  107.           ESP_LOGI("", "USB Device Descriptor should not appear in config");

  108.           break;

  109.         case USB_B_DESCRIPTOR_TYPE_CONFIGURATION:

  110.           show_config_desc(p);

  111.           break;

  112.         case USB_B_DESCRIPTOR_TYPE_STRING:

  113.           ESP_LOGI("", "USB string desc TBD");

  114.           break;

  115.         case USB_B_DESCRIPTOR_TYPE_INTERFACE:

  116.           USB_Class = show_interface_desc(p);

  117.           check_interface_desc_boot_Gamepad(p);

  118.           break;

  119.         case USB_B_DESCRIPTOR_TYPE_ENDPOINT:

  120.           show_endpoint_desc(p);

  121.           if (isGamepad && GamepadIn == NULL) prepare_endpoint(p);

  122.           break;

  123.         case USB_B_DESCRIPTOR_TYPE_DEVICE_QUALIFIER:

  124.           // Should not be config config?

  125.           ESP_LOGI("", "USB device qual desc TBD");

  126.           break;

  127.         case USB_B_DESCRIPTOR_TYPE_OTHER_SPEED_CONFIGURATION:

  128.           // Should not be config config?

  129.           ESP_LOGI("", "USB Other Speed TBD");

  130.           break;

  131.         case USB_B_DESCRIPTOR_TYPE_INTERFACE_POWER:

  132.           // Should not be config config?

  133.           ESP_LOGI("", "USB Interface Power TBD");

  134.           break;

  135.         case 0x21:

  136.           if (USB_Class == USB_CLASS_HID) {

  137.             show_hid_desc(p);

  138.           }

  139.           break;

  140.         default:

  141.           ESP_LOGI("", "Unknown USB Descriptor Type: 0x%x", bDescriptorType);

  142.           break;

  143.       }

  144.     }

  145.     else {

  146.       ESP_LOGI("", "USB Descriptor invalid");

  147.       return;

  148.     }

  149.   }

  150. }

  151. 

  152. void setup()

  153. {

  154.   usbh_setup(show_config_desc_full);

  155.   bleGamepad.begin();

  156. }

  157. 

  158. void loop()

  159. {

  160.   usbh_task();

  161. 

  162.   if (isGamepadReady && !isGamepadPolling && (GamepadTimer > GamepadInterval)) {

  163.     GamepadIn->num_bytes = 8;

  164.     esp_err_t err = usb_host_transfer_submit(GamepadIn);

  165.     if (err != ESP_OK) {

  166.       ESP_LOGI("", "usb_host_transfer_submit In fail: %x", err);

  167.     }

  168.     isGamepadPolling = true;

  169.     GamepadTimer = 0;

  170.   }

  171. }

复制代码
参考：
2.     在线 HID Descriptor 分析工具 http://eleccelerator.com/usbdescreqparser/

回复

使用道具 举报

精彩评论(10)

zoologist  高级技匠
 楼主|

发表于 2022-9-26 16:03:13

修改后的库

完整的代码：

回复

使用道具 举报

glwz007  初级技匠

发表于 2022-10-16 15:22:16

我有一个2.4G的无线键盘，接收器丢了，能不能反向改装为有线键盘？
回复

使用道具 举报

zoologist  高级技匠
 楼主|

发表于 2022-10-16 19:09:47

glwz007 发表于 2022-10-16 15:22
我有一个2.4G的无线键盘，接收器丢了，能不能反向改装为有线键盘？

这个应该可以，只是比较折腾，拆开之后重新焊接解析键盘矩阵

更简单的方法是直接买个同型号的接收器，配对一下就能用
回复

使用道具 举报

赤星三春牛！  初级技神

发表于 2022-10-23 09:36:15

厉害厉害
回复

使用道具 举报

赤星三春牛！  初级技神

发表于 2022-10-23 09:37:18

回复

使用道具 举报

赤星三春牛！  初级技神

发表于 2022-10-23 09:38:20

点赞！！
回复

使用道具 举报

zoologist  高级技匠
 楼主|

发表于 2023-6-24 10:12:41

修改后的库

Modified——ESP32-BLE-Gamepad-master.zip

26.04 KB, 下载次数: 62
回复

使用道具 举报

SamToT  学徒

发表于 2024-4-16 17:24:27

为什么不用代码直接获取设备描述符然后替换到HIDReport Map中呢
回复

使用道具 举报

zoologist  高级技匠
 楼主|

发表于 2024-4-18 11:08:00

SamToT 发表于 2024-4-16 17:24
为什么不用代码直接获取设备描述符然后替换到HIDReport Map中呢

可以，应该没问题
回复

使用道具 举报

_深蓝_  中级技师

发表于 7 天前

很显然，我们小白是看不懂的，膜拜
回复

使用道具 举报

高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

为本项目制作心愿单
购买心愿单
心愿单 编辑
[[wsData.name]]

硬件清单

  • [[d.name]]
btnicon
我也要做!
点击进入购买页面
撰写新帖
关于楼主
勋章墙
创客造 编辑选择奖 编辑选择奖

楼主的其它帖子

background 创造力兑换 background 心愿单 background 创客导航
上海智位机器人股份有限公司 沪ICP备09038501号-4

© 2013-2024 Comsenz Inc. Powered by Discuz! X3.4 Licensed

mail