制作基于ESP32的自定义键盘可以分为以下步骤，以下是详细指南：

材料清单：

• ESP32开发板（如ESP32-WROOM或ESP32-S3，后者支持USB HID更便捷）
• 机械轴/薄膜按键（推荐Cherry MX兼容轴体）
• 1N4148二极管（每个按键1个，用于防鬼键）
• 导线（建议使用镀锡铜线或漆包线）
• 键盘矩阵PCB或洞洞板（也可3D打印外壳）
• 可选：RGB LED（WS2812B灯带）、旋钮编码器
• 焊接工具（电烙铁、焊锡、吸锡器）
• Type-C接口模块（如需有线连接）

制作步骤：

1. 电路设计

   • 规划按键矩阵（例如6行x14列的84键布局）
   • 每个按键串联二极管，方向统一（阴极朝向行）
   • 使用Kle布局编辑器（http://www.keyboard-layout-editor.com）设计键位

2. 硬件焊接

   ESP32引脚分配示例：
   - 行线：GPIO13,12,14,27,26,25
   - 列线：GPIO15,2,4,16,17,5,18,19,21,22,23,32,33,35

   • 使用跳线连接矩阵行列到ESP32
   • 添加10kΩ上拉电阻到行线

3. 固件开发

   • 使用Arduino IDE：

     
     #include <BleKeyboard.h>
     BleKeyboard bleKeyboard("MyKeyboard");

   void setup() { // 初始化GPIO为输入带上拉 for(int pin : rowPins) pinMode(pin, INPUT_PULLUP); for(int pin : colPins) pinMode(pin, INPUT); }

   void loop() { scanMatrix(); delay(10); }

   void scanMatrix(){ for(int col=0; col<COLS; col++){ digitalWrite(colPins[col], LOW); for(int row=0; row<ROWS; row++){ if(!digitalRead(rowPins[row])){ bleKeyboard.press(KEYMAP[row][col]); } } digitalWrite(colPins[col], HIGH); } }

   
   - 或使用QMK固件（需配置编译环境）

4. 高级功能扩展

   • 添加旋钮编码器：连接CLK、DT到GPIO，实现音量调节
   • RGB背光控制：使用FastLED库驱动WS2812B
   • 添加EEPROM存储层配置
   • 启用深度睡眠（蓝牙模式省电）

5. 外壳制作

   • 使用Fusion 360设计，3D打印或CNC加工
   • 建议层结构：定位板+消音棉+硅胶垫
   • 开源方案推荐：https://github.com/ai03-2725/ergogen

注意事项：

1. 蓝牙模式需遵守HID协议规范
2. 使用PlatformIO管理依赖库更便捷
3. 矩阵扫描频率建议在100-1000Hz之间
4. 添加TVS二极管防止静电损坏

调试技巧：

• 用逻辑分析仪捕获矩阵扫描信号
• 使用Wireshark捕获蓝牙HID数据包
• 串口打印按键扫描码

完成后的键盘可实现：

• 蓝牙/USB双模连接
• 宏定义编程
• 多层键位切换
• 实时电量显示（需接电池）

进阶建议：探索VIA/QMK配置器实现免编程定制，或尝试实现Zen模式（https://zmk.dev）