HID设置端点5及端点6失效 (IEC-452)

[qunkejiang]

Answers checklist.

• I have read the component documentation ESP-IDF Components and the issue is not addressed there.
• I am using target and esp-idf version as defined in component's idf_component.yml
• I have searched the issue tracker for a similar issue and not found any related issue.

Which component are you using? If you choose Other, provide details in More Information.

host/hid

ESP-IDF version.

V5.4.1

Development Kit.

ESP32S3

Used Component version.

espressif/esp_tinyusb: "^1.1"

More Information.

我有个应用需要用到5个端点，将HID设置到端点5后，设置无效，程序为官方的tusb_hid_example_main，端点设置为0x81到0x84都可以，0x85和0x86无效

[github-actions]

Hi @qunkejiang! Please be aware that the following suggestions are generated by a bot and haven't been fact-checked by Espressif Systems. We hope that this message will help you until an Espressif Engineer looks at your issue.

---

你这个现象其实和当前 USB Device Stack 的「端点数量上限」有关，而不是 HID 配置本身的问题。

在 ESP32‑S3 的 USB Device Stack 说明里，已经明确了可用端点数量的限制：最多 6 个端点，其中包括控制端点 EP0 在内，非控制端点只支持 5 个 IN/OUT 端点加 1 个 IN 端点，总数是固定受限的。[USB device stack]

• Multiple supported device classes (CDC, HID, MIDI, MSC)
• Composite devices
• Vendor specific classes
• Maximum of 6 endpoints
  • 5 IN/OUT endpoints
  • 1 IN endpoints [USB device stack]

因此在使用 TinyUSB / esp_tinyusb 时：

• EP0（控制端点）会固定占用一个端点号；
• 其他类（CDC、MSC 等）如果同时开启，也会占用若干端点；
• 当你尝试再把 HID 放到端点号 0x85 / 0x86 时，实际上已经超出了硬件 + Device Stack 能支持的端点资源，因此“设置无效”的现象是符合当前设计限制的。

你目前的测试情况（0x81–0x84 可用，0x85/0x86 不工作）就很像是已经到达上限后的行为。

建议：

1. 尽量把 HID 的端点号安排在前面几个可用端点范围内（如 0x81–0x84），并控制整个设备（包括其它类）的端点总数不超过上述限制；
2. 如果是复合设备（CDC + HID + 其它），需要重新规划各类的端点占用，保证 EP0 + 所有 IN/OUT 端点之和不超出 USB Device Stack 规定的上限；
3. 目前提供的文档中没有提到可以通过配置放宽 ESP32‑S3 端点数量限制，说明这是受硬件/底层实现约束的，不能简单通过修改 HID 描述符来突破。

如果你能贴一下完整的配置（包括 CDC / MSC 等是否同时启用）和 USB 描述符结构，在端点规划上还能进一步帮你一起做一下“端点预算”，看是否有重新分配的空间。

[qunkejiang]

我的端点设置是这样的
#define ADDR_HID_IN 0x85
#define ADDR_WEBUSB_IN 0x83
#define ADDR_WEBUSB_OUT 0x04
#define ADDR_XINPUT_IN 0x81
#define ADDR_XINPUT_OUT 0x02
最大端点没有超过6个，且输入端点没有超过5个，所以应该是支持的，实际上可以用官方的官方的tusb_hid_example_main例程复现，把第55行的代码改为TUD_HID_DESCRIPTOR(0, 4, false, sizeof(hid_report_descriptor), 0x85, 16, 10), 这样只开了一个端点依然是失败的。

[tore-espressif]

Hello and thank you for the issue!
The configuration that you are using should indeed work. We will double check

[qunkejiang]

谢谢，完整的代码在这里https://github.com/qunkejiang/alpakka_qk,如果要最简单的测试代码，可以用V5.4.1版本内的tusb_hid_example_main例程复现，我测试的结果是只要4以上的端点都是无法使用的。