Bluetooth LE Keyboard library for the ESP32 (Arduino IDE compatible)
ESP32-BLE-Keyboard
ESP32
⭐☆☆☆☆ (1/5)
已发布
项目简介
ESP32蓝牙低功耗键盘库，兼容Arduino IDE。
ESP32-BLE-Keyboard 是一个专为 ESP32 微控制器设计的开源库，它能让 ESP32 摇身一变，成为一个功能完整的蓝牙键盘。这个项目巧妙地利用了 ESP32 内置的蓝牙低功耗（BLE）功能，解决了在没有物理键盘或传统 USB 连接的情况下，需要无线输入控制的需求。其核心价值在于，开发者可以用极低的成本，将任何 ESP32 开发板变成一个可编程的蓝牙输入设备。
标签
项目特点
兼容Arduino IDE，上手门槛低，几行代码即可实现蓝牙键盘功能
支持标准按键、修饰键（Ctrl/Alt/Shift等）、多媒体键和特殊功能键
支持Unicode字符发送，可输入中文、日文等多语言文本
支持电池电量报告，可模拟带电池的蓝牙键盘设备
支持多设备连接和重连，可自定义设备名称和制造商信息
基于ESP32原生蓝牙协议栈，延迟低、兼容性好
技术规格
| 支持平台 | |
|---|---|
| 开发环境 | |
| 蓝牙协议 | |
| 按键类型 | |
| Unicode支持 | |
| 电池报告 | |
| 设备名称 | |
| 制造商信息 | |
| 最大连接数 | |
| 库依赖 |
项目资源
物料清单 (BOM)
| 物料名称 | 数量 | 参考价格 | 备注 |
|---|---|---|---|
| ESP32开发板（如NodeMCU-32S、ESP32-DevKitC） | 1 | — | 推荐4MB以上Flash |
| Micro USB或USB-C数据线 | 1 | — | 用于供电和程序上传 |
| 按键/开关 | 若干 | — | 如需物理按键输入 |
| 锂电池（3.7V） | 1 | — | 如需无线供电 |
| 电池管理模块（如TP4056） | 1 | — | 如需充电功能 |
所需工具
| 工具 | 用途 | 是否必需 |
|---|---|---|
| Arduino IDE | 编写、编译、上传代码 | ✅ 是 |
| ESP32板支持包 | 使Arduino IDE支持ESP32 | ✅ 是 |
| USB数据线 | 连接ESP32到电脑 | ✅ 是 |
| 串口监视器 | 调试输出查看 | ▢ 推荐 |
| 蓝牙调试工具（如nRF Connect） | 验证蓝牙服务与特征值 | ▢ 推荐 |
能力画像
**记忆与知识检索**：2/5 — 项目本身不涉及知识库或检索功能，但需要查阅BLE HID协议文档。
**动手与操作**：4/5 — 需要焊接、接线、硬件搭建，以及烧录固件等动手操作。
**编程与算法**：3/5 — 主要涉及Arduino代码编写，逻辑简单，但需理解BLE通信和HID协议。
**设计与建模**：1/5 — 无需3D建模或电路设计，可直接使用现成开发板。
**实验与调试**：4/5 — 需要反复调试按键映射、蓝牙连接稳定性，使用串口和蓝牙工具排查问题。
**协作与分享**：3/5 — 可通过GitHub提交Issue、PR，或分享自己的按键映射配置。
**学习与研究**：4/5 — 适合学习BLE协议、HID设备原理、ESP32低功耗蓝牙开发。
**系统集成**：3/5 — 可与其他传感器、执行器组合，构建自动化输入系统。
所需技能
基础Arduino编程（setup/loop、数字IO）
了解ESP32开发板的基本使用（安装板支持包、选择端口、烧录）
了解蓝牙低功耗（BLE）基本概念（可选但有助于调试）
会使用串口监视器查看调试信息
基础电路知识（接线、供电）
适用场景
制作自定义蓝牙键盘（如机械键盘客制化）
为平板或手机开发外接输入设备
自动化测试中的按键模拟（如自动填写表单）
辅助技术（为行动不便者制作专用输入器）
智能家居控制面板（通过按键触发场景）
教育演示（展示BLE HID协议原理）