esp32_hid_device 调试遇到的一些问题
nimble to windows10 22h2
esp_hid_device 的keyboardReportMap在win10 22h2 csr4.0 下好像识别不了，
Windows（和大多数 BIOS/UEFI）只认 6-byte key array 的 HID Keyboard 描述符。如果不是 6 个字节，Windows HID 驱动就会认为这不是标准键盘 → 不会加载通用键盘驱动。
可行的keyboardReportMap 如下
// HID Report Map characteristic value
static const uint8_t keyboardReportMap[] = {0x05, 0x01, // Usage Pg (Generic Desktop)0x09, 0x06, // Usage (Keyboard)0xA1, 0x01, // Collection: (Application)//0x05, 0x07, // Usage Pg (Key Codes)0x19, 0xE0, // Usage Min (224)0x29, 0xE7, // Usage Max (231)0x15, 0x00, // Log Min (0)0x25, 0x01, // Log Max (1)//// Modifier byte0x75, 0x01, // Report Size (1)0x95, 0x08, // Report Count (8)0x81, 0x02, // Input: (Data, Variable, Absolute)//// Reserved byte0x95, 0x01, // Report Count (1)0x75, 0x08, // Report Size (8)0x81, 0x01, // Input: (Constant)//// LED report0x95, 0x05, // Report Count (5)0x75, 0x01, // Report Size (1)0x05, 0x08, // Usage Pg (LEDs)0x19, 0x01, // Usage Min (1)0x29, 0x05, // Usage Max (5)0x91, 0x02, // Output: (Data, Variable, Absolute)//// LED report padding0x95, 0x01, // Report Count (1)0x75, 0x03, // Report Size (3)0x91, 0x01, // Output: (Constant)//// Key arrays (6 bytes)0x95, 0x06, // Report Count (6)0x75, 0x08, // Report Size (8)0x15, 0x00, // Log Min (0)0x25, 0x65, // Log Max (101)0x05, 0x07, // Usage Pg (Key Codes)0x19, 0x00, // Usage Min (0)0x29, 0x65, // Usage Max (101)0x81, 0x00, // Input: (Data, Array)//0xC0 // End Collection
};
//report id 使用 0
esp_hidd_dev_input_set(s_ble_hid_param.hid_dev, 0, 0, buffer, 8);
在 BLE HID Profile（特别是 HID over GATT）里，很多低版本蓝牙栈（尤其是老的 Android、一些老的蓝牙适配器）确实 只支持单一 Report ID = 0，也就是说：
- 如果 HID Report Map 里定义了
0x85, <ReportID>，主机可能会解析失败，或者直接不识别。 - 最稳妥的做法就是 不加 Report ID（即只用默认的
report_id = 0）。
nimble to ios18
nimble hid_device 配对过程不触发输入Pin，连上了也会输入无反应。
原因在于 iOS 对 BLE 安全性要求严格，尤其是 HID（键盘/鼠标）类设备。
在 NimBLE 中：
sdkconfig默认 NIMBLE_SM_LVL=0 时，ESP32 允许 低安全级别配对。
iOS 对 HID 设备要求 至少 MITM 保护，否则它不会弹出 Passkey 或 Numeric Comparison，连接后键盘输入无反应。
修改sdkconfig中nimble项的sm lvl 为2 (默认为0）
提升到 SM_LVL=2 → iOS 认为安全性满足要求 → 才会显示 Passkey/Numeric Comparison 对话框。
因为 iOS HID 要求至少 加密 + MITM，SM_LVL=2 正好满足这个条件。
nimble to android
fields.appearance 改为ESP_HID_APPEARANCE_KEYBOARD时, android 手机配对时闪退（s7edge android 8.0.0)
// fields.appearance = ESP_HID_APPEARANCE_GENERIC;fields.appearance = ESP_HID_APPEARANCE_KEYBOARD;