feat: 添加 BLE HID 键盘支持与配置

- 在 sdkconfig.defaults 中更新 BLE 配置以支持 HID 键盘功能 - 新增 ble_hid.c 和 ble_hid.h 文件，实现 BLE HID 键盘的核心功能 - 更新 CMakeLists.txt，包含新的服务文件以支持 BLE HID - 修改 ui_handlers.c，响应启动按钮事件以发送 HID 按键 - 更新 ble_manager.c，初始化 BLE HID 功能并处理连接状态 - 新增 esp_hid_gap.c 和 esp_hid_gap.h 文件，管理 BLE HID 的 GAP 相关功能
2026-07-02 00:20:52 +08:00
parent 52546e35fe
commit 68dd7e95ab
8 changed files with 1645 additions and 209 deletions
@@ -0,0 +1,86 @@
+/*
+ * SPDX-FileCopyrightText: 2021-2023 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Unlicense OR CC0-1.0
+ */
+
+#ifndef _ESP_HID_GAP_H_
+#define _ESP_HID_GAP_H_
+
+#define HIDD_IDLE_MODE 0x00
+#define HIDD_BLE_MODE 0x01
+#define HIDD_BT_MODE 0x02
+#define HIDD_BTDM_MODE 0x03
+
+#if CONFIG_BT_HID_DEVICE_ENABLED
+#if CONFIG_BT_BLE_ENABLED
+#define HID_DEV_MODE HIDD_BTDM_MODE
+#else
+#define HID_DEV_MODE HIDD_BT_MODE
+#endif
+#elif CONFIG_BT_BLE_ENABLED
+#define HID_DEV_MODE HIDD_BLE_MODE
+#elif CONFIG_BT_NIMBLE_ENABLED
+#define HID_DEV_MODE HIDD_BLE_MODE
+#else
+#define HID_DEV_MODE HIDD_IDLE_MODE
+#endif
+
+#include "esp_err.h"
+#include "esp_log.h"
+
+#include "esp_bt.h"
+#if !CONFIG_BT_NIMBLE_ENABLED
+#include "esp_bt_defs.h"
+#include "esp_bt_main.h"
+#include "esp_gap_bt_api.h"
+#endif
+#include "esp_hid_common.h"
+#if CONFIG_BT_BLE_ENABLED
+#include "esp_gattc_api.h"
+#include "esp_gatt_defs.h"
+#include "esp_gap_ble_api.h"
+#endif
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#if !CONFIG_BT_NIMBLE_ENABLED
+typedef struct esp_hidh_scan_result_s {
+    struct esp_hidh_scan_result_s *next;
+
+    esp_bd_addr_t bda;
+    const char *name;
+    int8_t rssi;
+    esp_hid_usage_t usage;
+    esp_hid_transport_t transport; //BT, BLE or USB
+    union {
+        struct {
+            esp_bt_cod_t cod;
+            esp_bt_uuid_t uuid;
+        } bt;
+        struct {
+            esp_ble_addr_type_t addr_type;
+            uint16_t appearance;
+        } ble;
+    };
+} esp_hid_scan_result_t;
+
+esp_err_t esp_hid_scan(uint32_t seconds, size_t *num_results, esp_hid_scan_result_t **results);
+void esp_hid_scan_results_free(esp_hid_scan_result_t *results);
+const char *ble_addr_type_str(esp_ble_addr_type_t ble_addr_type);
+void print_uuid(esp_bt_uuid_t *uuid);
+#endif
+
+esp_err_t esp_hid_gap_init(uint8_t mode);
+esp_err_t esp_hid_gap_deinit(void);
+
+esp_err_t esp_hid_ble_gap_adv_init(uint16_t appearance, const char *device_name);
+esp_err_t esp_hid_ble_gap_adv_start(void);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* _ESP_HIDH_GAP_H_ */