diff --git a/docs/conf_common.py b/docs/conf_common.py index 6b9c6471d6..84220df9e0 100644 --- a/docs/conf_common.py +++ b/docs/conf_common.py @@ -39,6 +39,7 @@ BT_DOCS = ['api-guides/blufi.rst', CLASSIC_BT_DOCS = ['api-reference/bluetooth/classic_bt.rst', 'api-reference/bluetooth/esp_a2dp.rst', 'api-reference/bluetooth/esp_avrc.rst', + 'api-reference/bluetooth/esp_hidd.rst', 'api-reference/bluetooth/esp_hf_defs.rst', 'api-reference/bluetooth/esp_hf_client.rst', 'api-reference/bluetooth/esp_hf_ag.rst', diff --git a/docs/docs_not_updated/esp32c2.txt b/docs/docs_not_updated/esp32c2.txt index 0ccd87bfb8..c3ea4e20fe 100644 --- a/docs/docs_not_updated/esp32c2.txt +++ b/docs/docs_not_updated/esp32c2.txt @@ -153,6 +153,7 @@ api-reference/bluetooth/esp_a2dp api-reference/bluetooth/esp_blufi api-reference/bluetooth/bt_le api-reference/bluetooth/esp_hf_defs +api-reference/bluetooth/esp_hidd api-reference/bluetooth/esp_gap_bt api-reference/bluetooth/esp_gatt_defs api-reference/bluetooth/esp-ble-mesh diff --git a/docs/doxygen/Doxyfile b/docs/doxygen/Doxyfile index e1e1132197..77c3ad1954 100644 --- a/docs/doxygen/Doxyfile +++ b/docs/doxygen/Doxyfile @@ -55,6 +55,7 @@ INPUT = \ $(PROJECT_PATH)/components/bt/host/bluedroid/api/include/api/esp_hf_client_api.h \ $(PROJECT_PATH)/components/bt/host/bluedroid/api/include/api/esp_hf_defs.h \ $(PROJECT_PATH)/components/bt/host/bluedroid/api/include/api/esp_spp_api.h \ + $(PROJECT_PATH)/components/bt/host/bluedroid/api/include/api/esp_hidd_api.h \ $(PROJECT_PATH)/components/bt/host/nimble/esp-hci/include/esp_nimble_hci.h \ $(PROJECT_PATH)/components/bt/include/esp32/include/esp_bt.h \ $(PROJECT_PATH)/components/console/esp_console.h \ diff --git a/docs/en/api-reference/bluetooth/classic_bt.rst b/docs/en/api-reference/bluetooth/classic_bt.rst index 5ddd4f7ffa..d1d78fbf9c 100644 --- a/docs/en/api-reference/bluetooth/classic_bt.rst +++ b/docs/en/api-reference/bluetooth/classic_bt.rst @@ -11,3 +11,4 @@ CLASSIC BT BT HFP Define BT HFP Client BT HFP AG + BT HID DEVICE diff --git a/docs/en/api-reference/bluetooth/esp_hidd.rst b/docs/en/api-reference/bluetooth/esp_hidd.rst new file mode 100644 index 0000000000..55e529df7d --- /dev/null +++ b/docs/en/api-reference/bluetooth/esp_hidd.rst @@ -0,0 +1,19 @@ +Bluetooth HID Device API +======================== + +Overview +-------- + +A Bluetooth HID device is a device providing the service of human or other data input and output to and from a Bluetooth HID Host. Users can use the Bluetooth HID Device APIs to make devices like keyboards, mice, joysticks and so on. + +Application Example +------------------- + +Check :example:`bluetooth/bluedroid/classic_bt` folder in ESP-IDF examples, which contains the following application: + +* This is an example of Bluetooth HID mouse device. The device running this example can be discovered and connected by a Bluetooth HID Host device such as a PC, and the pointer will move left and right after HID connection is established - :example:`bluetooth/bluedroid/classic_bt/bt_hid_mouse_device` + +API Reference +------------- + +.. include-build-file:: inc/esp_hidd_api.inc diff --git a/docs/zh_CN/api-reference/bluetooth/esp_hidd.rst b/docs/zh_CN/api-reference/bluetooth/esp_hidd.rst new file mode 100644 index 0000000000..8140f3552e --- /dev/null +++ b/docs/zh_CN/api-reference/bluetooth/esp_hidd.rst @@ -0,0 +1 @@ +.. include:: ../../../en/api-reference/bluetooth/esp_hidd.rst