3步打造ESP32蓝牙控制中心：零基础玩转低成本无线输入设备

ESP32 Mouse/Keyboard for BLE HID是一个基于ESP32的蓝牙低能耗（BLE）人机交互设备（HID）开源方案，支持键盘和鼠标功能。该项目提供串行API与Adafruit EZKey HID兼容，允许外部模块控制，适合技术爱好者和DIY实践者打造个性化无线输入解决方案。通过不到50元的硬件成本，即可实现商业无线键鼠的核心功能，同时支持完全自定义扩展。

🚀 核心价值：为什么选择ESP32蓝牙控制方案

低成本高性价比

相比市售百元级无线键鼠套装，ESP32方案硬件成本仅需20-50元，且提供同等甚至更强的自定义功能。开源设计文件包含完整的PCB布局、BOM清单和3D打印模型，进一步降低制作门槛。

跨平台兼容性

该方案已在主流操作系统验证稳定运行：

• Windows 10/11：完美支持鼠标和键盘功能
• macOS (Mojave及以上)：全功能兼容
• Linux (Debian/Ubuntu)：即插即用
• Android (6.0+)：完整支持输入控制
• iOS/iPadOS (13.3+)：鼠标需辅助触控，键盘文本输入正常

⚠️ 注意：部分iPad设备可能显示蓝牙性能警告，这是ESP32的WiFi模块干扰导致，可忽略提示正常使用。

高度自定义能力

不仅支持标准输入功能，还可通过编程实现特殊按键组合、宏命令和传感器集成，满足个性化需求。

📱 应用场景：解锁ESP32蓝牙控制的无限可能

无障碍控制：为行动不便者打造专属输入方案

通过连接语音识别模块或眼动追踪传感器，将语音命令或眼球运动转换为鼠标和键盘指令，帮助行动不便人士实现电脑操作。例如：

• 语音转文字输入
• 眼动控制光标移动
• 呼吸传感器实现点击操作

智能家居：一键掌控家庭设备

将ESP32设备作为智能家居控制中心，通过自定义按键实现：

• 客厅影音系统遥控器
• 智能灯光场景切换
• 空调温度调节
• 窗帘开关控制

嵌入式调试：无外设环境下的系统配置

在树莓派无头系统或工业设备调试场景中，ESP32可作为临时输入设备，解决无键盘鼠标的配置难题。

图：ESP32蓝牙控制模块组装示意图，包含元件布局和焊接指南，适用于FlipMouse/FABI系统的蓝牙扩展

🛠️ 实施步骤：从零开始构建ESP32蓝牙输入设备

1️⃣ 开发环境搭建

首先获取项目源码并安装ESP-IDF框架：

# 克隆项目仓库
git clone --recursive https://gitcode.com/gh_mirrors/es/esp32_mouse_keyboard
cd esp32_mouse_keyboard
# 按照ESP-IDF官方文档安装工具链

2️⃣ 固件编译

使用IDF工具链或Makefile编译项目：

# 使用IDF工具链编译
idf.py build

# 或使用Makefile编译
make

3️⃣ 烧录与测试

将编译好的固件烧录到ESP32开发板：

# 替换(PORT)为实际串口，如COM3或/dev/ttyUSB0
idf.py -p (PORT) flash

# 烧录完成后启动监控终端
idf.py -p (PORT) monitor

在监控终端中输入以下指令测试基本功能：

• w/a/s/d：控制鼠标上/左/下/右移动
• l/r：鼠标左键/右键点击
• q：发送测试字符"y"

🔧 核心组件选型指南

必选核心组件

• ESP32-WROOM-32模块：提供蓝牙和WiFi功能，是整个系统的核心
• 3.3V LDO稳压器：确保稳定供电，推荐使用RT9193或同类器件
• 迷你USB接口：用于供电和数据传输

可选扩展组件

• CMM-4030D-261 I2S麦克风：支持语音控制功能
• LED指示灯：显示设备工作状态
• 按键：添加物理控制按钮

成本对比

组件	单价(元)	功能说明
ESP32开发板	25-40	核心控制单元
电容电阻套件	5-10	基础电路元件
USB数据线	3-5	烧录与供电
总计	33-55	完整功能实现

💡 功能扩展思路

自定义键盘布局

修改main/hid_dev.c文件可调整按键映射，支持不同语言布局或自定义快捷键。例如添加多媒体控制键或应用程序启动热键。

传感器集成

通过ESP32的GPIO接口连接各种传感器，实现创新交互方式：

• 加速度传感器：通过手势控制鼠标
• 距离传感器：实现空中鼠标功能
• 语音传感器：语音命令转键盘输入

多设备切换

扩展代码支持记忆多个蓝牙设备，通过按键实现快速切换控制对象。

🌟 社区案例展示

案例1：语音控制智能家居

一位社区用户将ESP32与语音识别模块结合，开发了语音控制的智能家居系统。通过特定语音指令，可实现：

• "打开电视"：自动切换HDMI输入并开启电视电源
• "调亮灯光"：逐步增加灯光亮度
• "播放音乐"：启动音乐播放器并播放指定 playlist

案例2：游戏辅助控制器

另一位开发者为格斗游戏设计了自定义控制器，通过ESP32实现：

• 一键连招宏
• 摇杆灵敏度调节
• 可编程快捷键

🤝 参与项目与获取支持

贡献代码

1. Fork项目仓库
2. 创建特性分支 git checkout -b feature/amazing-feature
3. 提交更改 git commit -m 'Add some amazing feature'
4. 推送到分支 git push origin feature/amazing-feature
5. 创建Pull Request

问题反馈

如果你在使用过程中遇到兼容性问题或功能bug，欢迎提交issue报告。也非常欢迎分享你的创新应用案例和功能建议。

立即动手打造你的ESP32蓝牙控制设备，开启无线输入的无限可能！如果这个项目对你有帮助，请给我们点个Star支持开源社区发展。

硬件设计遵循CERN OHL v1.2开源协议，软件部分采用MIT许可证，详细信息参见项目根目录下的LICENSE文件。