使用ESP32制作键盘可分为蓝牙HID和USB HID两种方案，以下是分步指南：

方案一：蓝牙键盘（适用于所有ESP32型号）

1. 硬件准备

   • ESP32开发板（任何型号，如ESP32-WROOM）
   • 按键/矩阵键盘：连接GPIO引脚（需设置上拉/下拉电阻）
   • 供电：USB或电池（如锂电池）

2. 软件配置

   • 安装库：Arduino IDE中安装 ESP32 BLE Keyboard 库。

   • 示例代码：

     #include <BleKeyboard.h>
     BleKeyboard bleKeyboard("ESP32键盘"); // 设置设备名称
     
     void setup() {
     pinMode(BUTTON_PIN, INPUT_PULLUP); // 按键接GPIO（内部上拉）
     bleKeyboard.begin();
     }
     
     void loop() {
     if (digitalRead(BUTTON_PIN) == LOW) { // 检测按键按下
      delay(50); // 消抖
      if (digitalRead(BUTTON_PIN) == LOW) {
        bleKeyboard.print("A"); // 发送字符'A'
        // bleKeyboard.press(KEY_LEFT_CTRL); // 组合键示例：Ctrl+C
        // bleKeyboard.press('c');
        // bleKeyboard.releaseAll();
      }
     }
     }

3. 功能扩展

   • 多按键支持：使用bleKeyboard.press()处理组合键。
   • 多媒体键：如bleKeyboard.write(KEY_MEDIA_VOLUME_UP)。

4. 测试

   • 烧录程序后，手机/电脑搜索蓝牙设备“ESP32键盘”并配对，测试按键输入。

方案二：USB键盘（仅限ESP32-S2/S3）

1. 硬件准备

   • ESP32-S2/S3开发板（需支持USB OTG）
   • 按键连接至GPIO

2. 软件配置

   • 安装库：使用 USBHIDKeyboard 库（需配置Arduino为ESP32-S2/S3开发板）。

   • 示例代码：

     #include <USBHIDKeyboard.h>
     USBHIDKeyboard Keyboard;
     
     void setup() {
     pinMode(BUTTON_PIN, INPUT_PULLUP);
     Keyboard.begin();
     }
     
     void loop() {
     if (digitalRead(BUTTON_PIN) == LOW) {
      delay(50);
      if (digitalRead(BUTTON_PIN) == LOW) {
        Keyboard.println("Hello World!"); // 输入文本
      }
     }
     }

3. 测试

   • 通过USB连接电脑，ESP32会自动识别为键盘，按下按键测试输入。

常见问题处理

• 按键抖动：增加消抖延迟（如50ms）。
• 连接失败：检查蓝牙/USB驱动，确认HID描述符正确。
• 键值错误：参考HID键码表发送正确扫描码。

根据需求选择方案，蓝牙适合无线场景，USB适合即插即用。需注意ESP32型号及对应库的兼容性。