自制Arduino适配器：Xbox 360手柄输入转Xbox One适配手游

可以通过兼容Arduino生态的ESP32开发板制作适配器，实现将Xbox 360手柄的输入转换为Xbox One控制器的HID信号，适配《使命召唤手游》这类仅识别特定手柄的移动端游戏。无需模拟主机加密握手，仅需在PC/手机端被识别为标准Xbox One HID设备即可。

现有GPT生成代码的核心问题 #

• USB主机无手柄驱动：仅初始化了USB主机和Hub，未添加Xbox 360手柄的HID驱动，无法读取原手柄的输入数据，当前仅能发送空报告。
• HID报告描述符不规范：提供的描述符是简化版，Xbox One控制器的标准HID报告包含更多轴数据（右摇杆、扳机键）、特殊按钮（菜单、视图键），且报告长度、数据位定义与Xbox 360完全不同。
• BLE特征UUID错误：Xbox One BLE HID的输入报告特征UUID应为00002a4d-0000-1000-8000-00805f9b34fb，而非自定义的00000001-...，错误UUID会导致系统无法识别设备类型。
• 缺失HID报告描述符特征：标准BLE HID设备必须包含报告描述符特征（UUID 00002a4b-0000-1000-8000-00805f9b34fb），否则系统无法解析HID数据格式。
• 无输入转换逻辑：未实现Xbox 360手柄数据到Xbox One报告格式的映射，当前仅发送空数据，无法完成手柄输入的转发。

代码修正方向 #

1. 添加Xbox 360手柄驱动 #

使用Xbox360Controller库（基于USB Host Shield）读取原手柄的按键、摇杆、扳机数据，需在代码开头添加相关库引用：

#include <Xbox360Controller.h>
Xbox360Controller xbox360(&Usb);

2. 替换标准Xbox One HID报告描述符 #

使用符合官方规范的描述符，包含完整的轴、按钮定义：

const uint8_t xbox_one_hid_report_desc[] = {
    0x05, 0x01,        // Usage Page (Generic Desktop)
    0x09, 0x05,        // Usage (Gamepad)
    0xA1, 0x01,        // Collection (Application)
    0x15, 0x00,        // Logical Minimum (0)
    0x25, 0x01,        // Logical Maximum (1)
    0x35, 0x00,        // Physical Minimum (0)
    0x45, 0x01,        // Physical Maximum (1)
    0x75, 0x01,        // Report Size (1)
    0x95, 0x0E,        // Report Count (14)
    0x05, 0x09,        // Usage Page (Button)
    0x19, 0x01,        // Usage Minimum (Button 1)
    0x29, 0x0E,        // Usage Maximum (Button 14)
    0x81, 0x02,        // Input (Data,Var,Abs)
    0x95, 0x02,        // Report Count (2)
    0x81, 0x01,        // Input (Cnst,Arr,Abs)
    0x05, 0x01,        // Usage Page (Generic Desktop)
    0x25, 0x7F,        // Logical Maximum (127)
    0x46, 0xFF, 0x00,  // Physical Maximum (255)
    0x75, 0x08,        // Report Size (8)
    0x95, 0x04,        // Report Count (4)
    0x09, 0x30,        // Usage (X)
    0x09, 0x31,        // Usage (Y)
    0x09, 0x32,        // Usage (Z)
    0x09, 0x35,        // Usage (Rz)
    0x81, 0x02,        // Input (Data,Var,Abs)
    0x06, 0x00, 0xFF,  // Usage Page (Vendor Defined)
    0x09, 0x20,        // Usage (Vendor Usage 1)
    0x75, 0x08,        // Report Size (8)
    0x95, 0x02,        // Report Count (2)
    0xB1, 0x02,        // Feature (Data,Var,Abs)
    0xC0               // End Collection
};

3. 修正BLE HID特征配置 #

添加报告描述符特征，并使用正确的输入报告UUID：

// 添加报告描述符特征
NimBLECharacteristic *pHIDReportDesc = pHIDService->createCharacteristic(
    "00002a4b-0000-1000-8000-00805f9b34fb",
    NIMBLE_PROPERTY::READ
);
pHIDReportDesc->setValue(xbox_one_hid_report_desc, sizeof(xbox_one_hid_report_desc));

// 输入报告特征（正确UUID）
pHIDReport = pHIDService->createCharacteristic(
    "00002a4d-0000-1000-8000-00805f9b34fb",
    NIMBLE_PROPERTY::NOTIFY
);

4. 添加输入映射逻辑 #

在loop()中读取Xbox 360手柄数据，转换为Xbox One报告格式后发送：

void loop() {
    Usb.Task();
    if (xbox360.isConnected()) {
        Xbox360Controller::Report report = xbox360.getReport();
        // 构建Xbox One报告
        uint8_t xbox_one_report[8] = {0};
        // 映射核心按键
        xbox_one_report[0] = (report.a ? 0x01 : 0) | (report.b ? 0x02 : 0) | 
                             (report.x ? 0x04 : 0) | (report.y ? 0x08 : 0);
        xbox_one_report[1] = (report.lb ? 0x10 : 0) | (report.rb ? 0x20 : 0) | 
                             (report.back ? 0x40 : 0) | (report.start ? 0x80 : 0);
        // 映射摇杆（Xbox 360的-127~127转为0~255）
        xbox_one_report[2] = report.leftX + 128;
        xbox_one_report[3] = report.leftY + 128;
        xbox_one_report[4] = report.rightX + 128;
        xbox_one_report[5] = report.rightY + 128;
        // 映射扳机
        xbox_one_report[6] = report.leftTrigger;
        xbox_one_report[7] = report.rightTrigger;
        // 发送报告
        pHIDReport->setValue(xbox_one_report, sizeof(xbox_one_report));
        pHIDReport->notify();
    }
    delay(10);
}

5. 硬件选型建议 #

使用带USB OTG功能的ESP32开发板（如ESP32-S3），无需额外USB Host Shield，可直接连接Xbox 360无线接收器或有线手柄。

内容的提问来源于stack exchange，提问作者Metaverse09