如果你最近在折腾客制化键盘、ESP32 或者各种 DIY 外设大概率已经刷到过 Adafruit Learning System 发布蓝牙 HID 键盘控制器这套教程的消息。这个项目本身看着不复杂就是把普通按键变成一台蓝牙键盘但真往里挖会发现它牵扯到 HID 协议、BLE 通信、低功耗设计、PCB 布局、固件底层调用等一系列东西。这篇文章我就顺着这套方案把来龙去脉拆开讲讲从核心原理到实际复现再到常见坑位排查一次说清楚。Adafruit Learning System 是 Adafruit 官方出的教程平台长期更新各种电子 DIY 项目这套蓝牙 HID 键盘控制器教程属于其中比较典型的一类用它的开发板或模块把物理按键变成通过蓝牙连接的远程键盘。适合谁看不只是想搞个无线键盘的人刚入门单片机、想搞懂 HID 协议、准备做体感控制器、媒体控制器、甚至无障碍辅助输入设备的人都能从这套方案里找到对应的技术落点。铺垫不多说直接进入正文。1. 项目底层逻辑这套蓝牙 HID 键盘控制器到底做了什么1.1 标题拆解每一个关键词都不是白给的先把这个标题掰开看。“Adafruit Learning System”指的是这套方案的发布平台和生态背景意味着它不是一个孤立的原理图或代码仓库而是一整套从硬件接线、固件烧录到调试方法的完整教程。“Bluetooth”是传输层说明键盘不是走传统 USB 线而是通过蓝牙无线连接主机。“HID”是这套方案最核心的部分全称 Human Interface Device俗称人机交互设备鼠标、键盘、游戏手柄都属于这一类。“Keyboard Controller”则限定了它的最终形态是一个负责采集按键输入、翻译成 HID 报告、发送给主机的控制器。这几个词合在一起项目技术画像就清晰了一块低功耗蓝牙 MCU通过 GPIO 扫描按键矩阵把按键动作编码成符合 Bluetooth HID 规范的报告再通过 BLE GATT 服务发送给电脑、平板或手机。所谓“键盘”本质上是把物理动作变成标准 HID 报文。1.2 它解决的核心痛点无线化、兼容性、快速原型验证为什么要用蓝牙 HID 键盘而不是直接上现成的罗技、雷柏因为后者是消费级成品固件封闭、按键逻辑固定、无法自定义。对于开发者来说很多时候需要的不是一个键盘而是一个“能伪装成键盘的控制器”。举个例子你想做一个脚踏翻页器左边踏板是 PageUp右边踏板是 PageDown或者想做一个带旋钮的媒体控制台旋转调节音量按下暂停播放甚至做一个自定义宏键盘一个键触发一串快捷键。这些都是标准的 HID 键盘应用场景用现成键盘无法实现但用这套 Adafruit 方案就能在几个小时内把原型跑起来。它解决的核心问题就是把“物理按键输入”和“主机端看到的标准按键事件”之间的桥梁交给开发者自己掌控。蓝牙相比 USB 带来的额外价值是摆脱线缆束缚适合遥控演示、沙发上网、树莓派调试这类场景。Adafruit 这套教程选的硬件方案在功耗、开发上手难度、生态成熟度之间做了一个比较均衡的取舍。1.3 为什么 Adafruit 这套方案值得参考市面上做蓝牙键盘的教程并不少很多人用 ESP32 也能做出来但 Adafruit 这套方案有几个优势是别的教程替代不了的。第一它把 HID 报告协议封装得很干净。你不用从零去啃蓝牙 SIG 那几百页的 HID Over GATT Profile 规范也不需要手动拼 HID report descriptor至少在初级篇里不需要。Adafruit 的 BLE HID 库已经把键盘、媒体、消费控制等常用报告格式封装好了你只需要调用 API 发送按键码。第二它的教程结构是渐进式的。从最基础的单个按键开始逐步扩展到矩阵扫描、多层按键映射、LED 状态反馈最后到低功耗设计每一步都有明确的实验现象方便定位问题。第三它的硬件生态对应关系清晰。教程里涉及的开发板、按键模块、锂电池充电板在 Adafruit 官网上都有对应产品原理图、引脚定义、封装库全部开源不会出现买了板子但找不到引脚定义的情况。2. HID 协议原理为什么键盘能被电脑认出来2.1 从 USB HID 到蓝牙 HID同一个协议家族的延展很多教程上来就让人复制代码烧录把 HID 当黑盒。但如果不理解 HID 的原理后面写自定义设备、调描述符、修兼容性问题时就会非常痛苦。HID 的本质是设备和主机之间用一组固定格式的“报告”来交换输入输出数据。在 USB 时代每个 HID 设备都需要提供一个 HID 描述符HID Descriptor描述这个设备是什么、有几个按键、按键报告的数据格式长什么样。电脑通过操作系统自带的 HID 驱动解析这些描述符然后自动把设备识别成键盘、鼠标或游戏杆。这就是为什么你把一个普通 USB 键盘插到任何电脑上都能直接用不需要装驱动因为键盘的 HID 描述符声明了自己是键盘并按标准格式发送按键报告。蓝牙 HID 走的是同样的逻辑只是传输层从 USB 换成了 BLE。蓝牙制定了一个专门用于承载 HID 数据的规范叫 HID Over GATT Profile简称 HOGP。HOGP 在 BLE 的 GATT 协议栈上面定义了 HID 服务HID Service服务里有报告映射、HID 信息、报告特征值等几个关键属性。设备通过这些属性把和 USB HID 几乎完全相同格式的报告数据通过 BLE 发出去。2.2 HID Report Descriptor 在蓝牙场景里的变化这里要展开说一个很多新手栽跟头的地方HID Descriptor 到底要不要自己写、怎么写。在 Adafruit 这套方案里如果你用的是 nRF52840 系列板子加官方 Adafruit Bluefruit 库库内部已经帮你定义好了 HID 服务的报告映射键盘报告、消费控制报告都在里面你只需要调用 sendKey 之类的函数。但如果你用的是更底层的 Zephyr RTOS或者自己用 ESP32 的 NimBLE 协议栈裸写那你就必须自己构造 HID report descriptor。举个例子一个 6 键无冲突键盘的 report descriptor 核心部分大致是static const uint8_t hid_report_descriptor[] { 0x05, 0x01, // Usage Page (Generic Desktop) 0x09, 0x06, // Usage (Keyboard) 0xA1, 0x01, // Collection (Application) 0x05, 0x07, // Usage Page (Key Codes) 0x19, 0xE0, // Usage Minimum (224) 0x29, 0xE7, // Usage Maximum (231) 0x15, 0x00, // Logical Minimum (0) 0x25, 0x01, // Logical Maximum (1) 0x75, 0x01, // Report Size (1) 0x95, 0x08, // Report Count (8) 0x81, 0x02, // Input (Data, Variable, Absolute) ... };这段描述符声明了 8 个修饰键位Ctrl、Shift、Alt、GUI然后后面还会声明 6 个普通按键的数组每个按键占 8 位。主机通过解析这段二进制数据就能知道这个设备会发送按键码最多同时按 6 个普通键加若干修饰键。Adafruit 库把这个过程封装了但你自己做自定义设备或者排查莫名其妙的兼容性问题时一定要能读懂这段描述符。2.3 蓝牙键盘的报文格式一次按键的完整生命周期从物理按键到电脑屏幕上的字符走过的完整链路是这样的按键闭合MCU 检测到 GPIO 电平变化经过消抖后MCU 确认按键状态按键扫描函数把当前按下的所有键更新到键盘报告缓冲区BLE 协议栈把这个报告通过 HID 服务的报告特征值发送给主机主机端的蓝牙协议栈收到报告后把它转交给系统的 HID 驱动解析出按键码系统再根据当前输入法和应用上下文生成字符或触发功能。整个过程中最容易出问题的环节是报告格式对不对。比如你在报告里声明了 6 键无冲突但一次发送了 7 个按键码主机端会直接丢弃这个非法报告。在 Adafruit 的 HID 键盘例程里库会自动处理越界问题但如果你自己实现报告拼接就必须严格按描述符里声明的长度来填充。2.4 为什么 HID 是“免驱”的操作系统层面的匹配逻辑很多人会觉得免驱是理所当然的但背后的机制值得说清楚。操作系统内置了 HID 类驱动这个驱动不针对特定品牌或型号而是针对“HID Protocol”本身。当设备枚举USB或连接BLE成功后系统会索取设备的 HID 描述符。如果描述符里写着 Usage Page 是 Generic Desktop、Usage 是 Keyboard系统就把这个设备归入键盘类由通用 HID 驱动接管。之后设备发来的 Input Report系统按键盘格式解析翻译成标准的系统键盘事件。这套机制意味着只要你的描述符声明得正确任何操作系统——Windows、macOS、Linux、Android、iOS——都能在不装第三方驱动的情况下识别你的蓝牙键盘。这也是我在做自定义控制器时最看重的一点通过 HID 协议你的设备天然跨平台。Adafruit 这套方案直接把这份跨平台能力继承了下来。3. 实操复现从零搭建一台蓝牙 HID 键盘控制器3.1 硬件选型与理由Adafruit 教程里主推的是 nRF52840 芯片方案具体可以是 Adafruit 自己的 Feather nRF52840 Express、ItsyBitsy nRF52840 Express也可以玩 CircuitPlayground Bluefruit。选 nRF52840 不是偶然。nRF52840 是 Nordic 公司的高端 BLE SoCCortex-M4F 内核主频 64 MHzFlash 1 MBRAM 256 KB最关键的是它内置了完整的 BLE 协议栈而且有成熟的 USB HID 和 BLE HID 参考实现。相比 ESP32nRF52840 的 BLE 功耗低得多深度睡眠时电流可以到微安级别非常适合电池供电的键盘。相比 RP2040树莓派 Pico 那颗芯片nRF52840 原生支持 BLE不需要外挂蓝牙模块集成度更高。如果你手头没有 nRF52840 板子用 ESP32 也能做出来。ESP32 的 NimBLE 协议栈同样支持 HID Over GATT而且 ESP32 性能更强、Wi-Fi 也能用但代价是功耗偏高跑 BLE 键盘可能需要频繁充电。这里列个对比表格供参考。方案BLE 支持方式功耗价格上手难度适用场景nRF52840 Bluefruit 库原生 BLE库封装完整极低纽扣电池可跑中低适合新手电池供电的键盘、可穿戴控制器ESP32 NimBLE原生 BLE需自己搭 HID 服务较高约 nRF 的 3 到 5 倍低中开发调试、功能验证、需要 Wi-Fi 的场景RP2040 外挂 BLE 模块需外部模块通过 UART/SPI 控制中等取决于模块低较高已有 RP2040 板子且想扩展蓝牙硬件上除了主控板还需要按键。Adafruit 教程里用的是机械按键开关但实际复现时矩阵键盘、弧形按键、触摸按键板都能换上去。我自己验证过用 3x4 薄膜键盘矩阵接 nRF52840效果也一样。3.2 固件准备用 CircuitPython 还是 ArduinoAdafruit 生态里有一套非常顺滑的上手路径就是 CircuitPython。CircuitPython 是 MicroPython 的一个分支Adafruit 深度维护支持 USB HID 和 BLE HID 的直接调用。对于这个项目CircuitPython 的 adafruit_hid 库和 adafruit_ble 库已经封装好了几乎所有底层细节。用 CircuitPython 的好处是代码更新不需要重新编译把 .py 文件拷到开发板的 CIRCUITPY 盘符里重启就生效。改一个按键映射只需要编辑文本文件。这对于原型验证来说是巨大的效率提升。我自己早期做键盘时用 Arduino 写 C改一次配列要重新编译烧录迭代慢。后来切到 CircuitPython改按键逻辑基本是秒级迭代。Arduino 方案则适合对性能和底层的控制力要求更高的场景比如要做超低功耗的睡眠唤醒或者要把按键扫描间隔优化到极致的项目。两个方案 Adafruit 教程都有覆盖我建议第一个项目用 CircuitPython 跑通全流程再考虑要不要下钻到 Arduino 或 Zephyr。如果选择用 Arduino IDE需要安装 Adafruit nRF52 BSP然后在库管理器里安装 Adafruit Bluefruit nRF52 Libraries。这个库里面自带的 blehid_keyboard.ino 例程就是最直接的起点#include bluefruit.h BLEHidAdafruit blehid; void setup() { Bluefruit.begin(); Bluefruit.setName(Adafruit Keyboard); blehid.begin(); pinMode(10, INPUT_PULLUP); } void loop() { if (digitalRead(10) LOW) { blehid.keyPress(HID_KEY_A); delay(20); blehid.keyRelease(); } }这段代码的逻辑很清楚初始化蓝牙和 HID 服务设置设备名检测引脚 10 的电平按下时发送 A 键松开时释放。烧录完成后在手机或电脑的蓝牙设置里搜索“Adafruit Keyboard”配对后打开任意文本编辑器短接引脚 10 到 GND就能看到字母 A 被打出来。3.3 按键矩阵扫描从单个按键到全键盘单个按键只是演示实际键盘至少是 3x3 或 4x4 的矩阵布局。矩阵扫描的原理是行线设为输出列线设为输入逐行拉低逐列读取。当某个按键按下时对应的行和列接通该列的输入电平会被拉低。通过行列组合就能定位到具体按键。矩阵扫描最需要注意的是二极管。每个按键串联一个 1N4148 之类的开关二极管方向是阳极接行线、阴极接列线。二极管的作用是防止按键串扰也就是所谓的鬼键问题。如果不加二极管多个按键同时按下时电流会通过其他按键倒灌导致 MCU 误判为没按下的键也被按下。Adafruit 教程里对单个按键的讲解没有展开矩阵但当你把按键数扩展到两位数时这步躲不过去。扫描代码的核心思路是轮询import board import digitalio import time import usb_hid from adafruit_hid.keyboard import Keyboard from adafruit_hid.keycode import Keycode ROW_PINS [board.D5, board.D6, board.D7] COL_PINS [board.D9, board.D10, board.D11] rows [digitalio.DigitalInOut(p) for p in ROW_PINS] cols [digitalio.DigitalInOut(p) for p in COL_PINS] key_map [ [Keycode.A, Keycode.B, Keycode.C], [Keycode.D, Keycode.E, Keycode.F], [Keycode.G, Keycode.H, Keycode.I], ] kbd Keyboard(usb_hid.devices) for row in rows: row.direction digitalio.Direction.OUTPUT row.value True for col in cols: col.direction digitalio.Direction.INPUT col.pull digitalio.Pull.DOWN while True: for r_idx, row in enumerate(rows): row.value False time.sleep(0.002) for c_idx, col in enumerate(cols): if col.value: kbd.press(key_map[r_idx][c_idx]) time.sleep(0.05) kbd.release(key_map[r_idx][c_idx]) row.value True这里要注意两点。第一行线逐行拉低的时间间隔不能太短至少留 2ms 让电平稳定否则在长距离走线上会出现误读。第二每个按键的 press 和 release 之间要加延迟不然主机端可能把快速按下又释放当成噪声忽略掉这是我实际测试中遇到的第一个坑。3.4 配对与重连机制BLE 键盘最容易被低估的部分键盘不是一次性消费品蓝牙配对的持久性和重连稳定性直接影响体验。Adafruit 的 BLE 库默认支持 bonding绑定也就是配对后主机会保存密钥下次连接不需要重新输入配对码。这个机制在低功耗蓝牙里叫“白名单 加密重连”核心是设备端要保存主机的地址和长期密钥LTK。在 CircuitPython 里配对信息默认存到 flash 上所以你拔电再上电不用重新配对。但有一个细节要特别注意如果你同时修改了设备名称和 HID 服务定义有些操作系统会认为这是一个新设备要求重新配对。这不算 bug是 BLE 规范里关于服务变更指示Service Changed Indication的正常行为。我调试时遇到过几次改完代码后蓝牙连不上排查半天发现是名字改动动了服务特征值的句柄范围导致旧主机的缓存失效。解决办法就是删除主机端旧配对记录重新配对一次。4. 常见问题与排查技巧实战中的坑位清单4.1 配对失败或连接不上先分清是广播问题还是服务问题这个项目里排查频率最高的问题就是死活连不上。按我的经验按下面顺序检查能解决 90% 的情况。第一确认设备是否在广播。手机打开 nRF Connect 或 LightBlue 这类 BLE 调试工具扫描看能不能看到你的设备名称。如果连名字都看不到说明问题出在广播层。常见原因是初始化顺序不对或者 BLE 协议栈没成功启动。Adafruit 库例程里 Bluefruit.begin() 后面一般跟一个 delay(500)看起来多余但某些板子供电不稳定时协议栈初始化需要更长的时间这个延时能避开随机失败。第二如果能看到广播但配对失败多半是 HID 服务没有注册完整。检查 ser. 或者 blehid.begin() 是否在 Bluefruit.begin() 之后调用并且中间没有异常。HOGP 服务对特征值的完整性要求比较高漏注册一个报告特征值可能不会报错但主机端会拒绝对接。第三如果配对过程中手机弹了 PIN 码输入框但键盘没有对应输入界面说明设备设置成了需要配对认证但没提供输入方式。Adafruit 库默认是 Just Works 配对也就是不需要确认如果你的代码里改了安全模式就要注意这个问题。4.2 输入延迟高、按键有随机丢失BLE 键盘的输入延迟比 USB 键盘高是物理层面的客观事实但如果高到明显打字不跟手或者按键随机丢失就需要优化。首先是连接间隔Connection Interval的设置。BLE 连接后主从设备之间并不是随时都在传数据而是按照协商好的时间间隔周期性通信。默认连接间隔可能被设成 30ms 甚至 50ms这会导致每次按键事件最多要等一个间隔才能发出去。Adafruit Bluefruit 库允许你通过 Bluefruit.setConnInterval(6, 12) 把连接间隔设为 7.5ms 到 15ms 之间延迟体感会好很多。代价是功耗会有可见增加因为设备需要更频繁地唤醒收发数据。其次是报告发送的频率。在 CircuitPython 的 HID 键盘例程里如果你在按键扫描循环里每轮都重新发送整包报告即使状态没变化也会产生大量冗余 BLE 流量。更好的做法是只有在按键状态发生变化时才发送报告。按位比较上一次报告和当前报告的差异然后再决定是否发送。这个优化能显著降低 BLE 空口占用率减少丢包概率。4.3 电池续航差关掉一切不该开的功能Adafruit 教程里涉及低功耗的内容相对靠后但如果你做的不是实验室玩具而是想日用这块必须重视。nRF52840 的硬件底子很好深度睡眠电流低于 1uA但前提是你把外设都关干净。第一个功耗黑洞是板上自带的 RGB LED。Adafruit 的 Feather 和 ItsyBitsy 板子默认上电后 LED 驱动部分处于活动状态如果你用 CircuitPython 写死循环LED 即使不闪驱动电路也在消耗电流。在低功耗配置时需要显式关闭板载 LED 的电源或设置成高阻态。第二个功耗黑洞是按键扫描轮询。如果扫描频率太高MCU 没法进入睡眠模式。一个常见做法是用支持唤醒的 GPIO 引脚接按键阵列当没有任何按键按下时让 MCU 进入睡眠按键按下时通过外部中断唤醒再执行扫描和发送。nRF52840 支持从事件驱动的 GPIO 中断唤醒这样待机电流能从毫安级降到微安级。第三个功耗黑洞是蓝牙连接保持。键盘如果长时间不操作可以让它主动断开 BLE 连接进入深度睡眠靠某个专用按键唤醒重连。比如在 loop 里记录最后一次按键时间超过 10 分钟没有按键事件就调用 Bluefruit.disconnect()然后进入睡眠。这个策略能大幅延长电池寿命。4.4 HID 描述符相关问题的判断方法如果你自己构造了 HID 报告描述符出现兼容性问题时需要用工具确认描述符内容是否符合预期。Adafruit 自带库的情况相对简单但如果你换用标准 BLE 工具链比如 ESP32 NimBLE 或 Zephyr那就不能依赖库的封装了。Linux 下可以用 bluetoothctl 连接设备然后通过 btmon 抓取 HCI 日志查看 HID 报告映射和输入报告的字节流。Windows 下可以用 USB 树状视图工具或蓝牙 LE Explorer 应用查看 SDP 服务和 GATT 特征。如果你发现主机收到的报告长度和你发送的不一致多半是报告映射里声明的大小和实际发送的缓冲区长度不匹配这是最典型的 HID 描述符错误。4.5 关于“bluetooth le spam”和“hid调试助手”这类工具的用法调试 BLE HID 设备工具选对能省一半时间。我常用的组合是 nRF Connect手机端 Wireshark配合 BLE 抓包器 LightBlue备用扫描。nRF Connect 可以查看设备广播数据、连接后浏览 GATT 服务、甚至直接向某个特征值写入数据用于模拟主机发给设备的数据。对于 HID 键盘你可以主动向 HID 控制特征值写入 Set_Protocol 或者 Set_Idle 之类的命令测试设备是否正确响应。“ble le spam”这类工具本质上也是 BLE 扫描仪但它更侧重于向指定设备发送大量广播包或连接请求用于压力测试。我的建议是除非你在做测试专用的抗干扰验证否则不要对日常使用的蓝牙设备做这类操作容易把扬声器、耳机等设备的蓝牙连接干扰瘫痪。常规 HID 调试不需要到这个强度。5. 进阶方向从键盘控制器走向通用输入设备平台5.1 一个框架兼容 N 种 HID 设备形态键盘控制器只是 HID 的一个起点。把 report descriptor 改一下同一个硬件就能变成鼠标、游戏手柄、媒体遥控器、甚至自定义的消费类控制设备。Adafruit 的库对鼠标和媒体控制也有现成的类比如 BLEHidAdafruit 里可以直接调用 mouseMove 来模拟鼠标指针移动用 consumerPress 来发送音量加减、播放暂停这些媒体控制指令。实际应用里我见过有人把 nRF52840 键盘控制器改装成“比赛宏操作板”用一排按键触发 CS 游戏里的组合操作也有人做成盲文输入的辅助设备通过几个物理按键组合编码再用 HID 键盘输出完整的字符序列。这些本质上都没有跳出 HID 的框架只是把输入逻辑换了个皮。5.2 与 USB HID 的双模设计Adafruit 的 nRF52840 板子自带 USB 接口这意味着你可以做双模键盘通过 USB 连接时走 USB HID拔掉 USB 走 BLE。这种设计在客制化键盘圈已经是标准配置了但自己动手做时需要注意两个模式切换的问题。首先是功耗管理。USB 连接状态下MCU 可以由 USB 供电同时给电池充电断开 USB 后切换到电池供电同时断开 USB HID 端点启用 BLE HID。nRF52840 的 USB 控制器有 VBUS 检测功能可以通过读取 USB 电源状态引脚来判断当前供电方式。其次是报告通道的切换。如果键盘同时把按键事件发给 USB 和 BLE会造成重复输入。正确的做法是在发送代码里加一个当前模式标志位根据是插电还是电池工作决定走哪条通道。这个小逻辑看着简单但我见过有不少人在调试时遇到“插着 USB 结果蓝牙也收到按键”的困惑本质就是通道隔离没做好。5.3 用蓝牙 HID 做非键盘输入传感器数据流一个容易被忽略的方向是用 HID 通道传非键盘数据。HID 协议本身并不限制数据类型只要你在 report descriptor 里声明一个自定义的 Usage Page就能定义自己的报告格式。举个例子把 GPS 模块接到 nRF52840通过 BLE HID 的自定义报告把经纬度数据打包发给电脑。主机端写一个小程序监听 HID 设备解析自定义报告里的坐标数据。这样做的优势是不需要写蓝牙驱动的串口对应关系HID 设备天然免驱跨平台通用性极好。不过要注意的是HID 的传输带宽不高适合小数据量周期性上报不适合传音频或者大流量传感器数据。5.4 学习路线建议从 Copy 到 Modify 再到 Create如果你完全没接触过 HID我建议按这条线走第一步按 Adafruit 教程原封不动跑通蓝牙键盘例程感受“按键 - 无线 - 电脑显示”的完整链路。第二步改按键映射把 A 改成 B把单个按键改成矩阵理解键码和扫描的关系。第三步尝试自定义 HID report descriptor在电脑上从一个普通用户的角度变成开发者视角。第四步加入低功耗策略用万用表测睡眠电流做出能装电池长期跑的设备。最后尝试脱离 Adafruit 库用底层协议栈重写一遍这时候你就真正吃透了这套方案。6. 我的一些实操体会这套 Adafruit 蓝牙 HID 键盘控制器方案技术上不算高不可攀但它把 HID 这层 Windows 和 Linux 开发文档里写得人云亦云的协议用几个按键和一个蓝牙连接变得具体可见。我自己做过的类似项目里最大的心得是先把 USB HID 跑通再切蓝牙 HID会大大降低排查难度。USB 链路有系统日志、有驱动界面、有稳定的工具链先把按键逻辑和描述符调对了再把它平移成 BLE HID很多玄学问题就不存在了。最后再分享一个小技巧。如果你用的是 CircuitPython开发调试时不要接锂电池直接用 USB 供电因为 CircuitPython 的蓝牙连接在供电电压波动时可能静默断连表现为主机端还能看到设备但按鍵无效这种状态很容易让人误判成代码问题。另外养成每改一个功能就检查一次蓝牙连接状态的习惯能省掉大量无意义的“为什么又连不上”的排查时间。这套方案能走多远很大程度上取决于你往里面填多少自己的场景。