From f20f53f153bfaa15adcbc86aa7afe6bb7cd7db3a Mon Sep 17 00:00:00 2001 From: liqigan Date: Tue, 27 May 2025 11:12:04 +0800 Subject: [PATCH] docs(bt/bluedroid): Updated HID Device connect API description Closes https://github.com/espressif/esp-idf/issues/16020 --- components/bt/host/bluedroid/api/include/api/esp_hidd_api.h | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/components/bt/host/bluedroid/api/include/api/esp_hidd_api.h b/components/bt/host/bluedroid/api/include/api/esp_hidd_api.h index 5250779d0d..f16bbcb0fa 100644 --- a/components/bt/host/bluedroid/api/include/api/esp_hidd_api.h +++ b/components/bt/host/bluedroid/api/include/api/esp_hidd_api.h @@ -345,6 +345,11 @@ esp_err_t esp_bt_hid_device_unregister_app(void); * called after esp_bt_hid_device_init(). When the operation is complete, the callback function will * be called with ESP_HIDD_OPEN_EVT. * + * @note The connection between the HID Host and the HID Device is established as a virtual cable by default. + * A new HID Host connection request will only be accepted after the previous HID Host has been + * explicitly unplugged. For details on disconnection and virtual cable unplugging, please refer to API + * `esp_bt_hid_device_disconnect` and `esp_bt_hid_device_virtual_cable_unplug`. + * * @param[in] bd_addr: Remote host bluetooth device address. * * @return