USB HID Feature Report使用故障：摇杆设备校准通信问题排查

首先，你的INPUT报告正常工作说明基础的HID枚举和报告结构没问题，FEATURE报告失效的核心问题集中在报告描述符的定义和设备端处理逻辑上，以下是具体排查点和修复方案：

1. 报告描述符的核心错误修复 #

（1）替换Undefined Usage为有效控件Usage #

当前FEATURE报告使用0x09, 0x00（Undefined Usage），主机无法识别该报告的用途，会直接忽略或拒绝交互。由于你需要传输Rx/Ry/Rz的校准数据，建议复用对应轴的Usage：

// 替换原FEATURE部分的Usage定义
0x09, 0x33, // Usage (Rx 校准参数)
0x09, 0x34, // Usage (Ry 校准参数)
0x09, 0x35, // Usage (Rz 校准参数)

这样主机能明确映射每个字段到对应的轴校准项，PC端软件也能正确解析数据。

（2）调整Report Count匹配实际需求 #

原FEATURE报告的0x95, 0x20（Report Count=32）会生成64字节的报告，远超校准所需的3个16位字段（6字节），不仅增加传输复杂度，还可能触发设备端缓冲区溢出。修改为：

0x95, 0x03, // Report Count (3) 与INPUT报告保持一致

（3）修正FEATURE报告的完整描述符 #

修复后的FEATURE部分描述符如下，替换原对应段即可：

0x09, 0x33, // Usage (Rx)
0x09, 0x34, // Usage (Ry)
0x09, 0x35, // Usage (Rz)
0x15, 0x00, // Logical Minimum (0)
0x26, 0x00, 0x10, // Logical Maximum (4096)
0x75, 0x10, // Report Size (16)
0x95, 0x03, // Report Count (3)
0xB1, 0x02, // Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)

2. 设备端M-Stack逻辑验证 #

（1）确认Feature报告回调函数实现 #

在M-Stack的HID驱动代码中，需要实现HID_Feature_Set和HID_Feature_Get回调，处理主机发送的校准数据和返回当前校准值：

// 示例回调框架（根据M-Stack版本调整）
void HID_Feature_Set(uint8_t reportID, uint8_t* data, uint16_t len)
{
    if(reportID == 0 && len == 6) // 无Report ID，长度6字节
    {
        // 保存Rx/Ry/Rz校准数据到变量或EEPROM
        rx_cal = (data[1] << 8) | data[0];
        ry_cal = (data[3] << 8) | data[2];
        rz_cal = (data[5] << 8) | data[4];
    }
}

void HID_Feature_Get(uint8_t reportID, uint8_t* data, uint16_t* len)
{
    if(reportID == 0)
    {
        // 填充当前校准数据到返回缓冲区
        data[0] = rx_cal & 0xFF;
        data[1] = rx_cal >> 8;
        data[2] = ry_cal & 0xFF;
        data[3] = ry_cal >> 8;
        data[4] = rz_cal & 0xFF;
        data[5] = rz_cal >> 8;
        *len = 6;
    }
}

（2）验证端点0缓冲区大小 #

确保M-Stack配置中端点0的最大包长设置为64字节（Full Speed默认值），如果你的代码中修改过该值，需调整回支持至少6字节的传输。

3. HIDAPITESTER测试命令调整 #

使用修复后的描述符后，测试FEATURE报告的命令需匹配6字节的长度：

• 发送校准数据（例如Rx=0x100, Ry=0x200, Rz=0x300）：

hidapitester --vid <你的设备VID> --pid <你的设备PID> --feature-output 0x00 0x00 0x01 0x00 0x02 0x00 0x03

• 读取校准数据：

hidapitester --vid <你的设备VID> --pid <你的设备PID> --feature-input 0x00

4. 其他注意事项 #

• 若需要将校准数据永久保存到PIC18F2458的EEPROM，需将FEATURE的Flags字节改为0x82（开启Non-volatile属性），并在HID_Feature_Set中添加EEPROM写入逻辑。
• 避免随意修改描述符的其他部分（如INPUT报告段），否则可能导致设备枚举失败，当前INPUT报告正常工作，说明这部分是兼容的。

内容的提问来源于stack exchange，提问作者Richard Závodný