企业官网建设流程全解析

如果你最近在折腾客制化键盘、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 SoC，Cortex-M4F 内核，主频 64 MHz，Flash 1 MB，RAM 256 KB，最关键的是它内置了完整的 BLE 协议栈，而且有成熟的 USB HID 和 BLE HID 参考实现。相比 ESP32，nRF52840 的 BLE 功耗低得多，深度睡眠时电流可以到微安级别，非常适合电池供电的键盘。相比 RP2040（树莓派 Pico 那颗芯片），nRF52840 原生支持 BLE，不需要外挂蓝牙模块，集成度更高。

如果你手头没有 nRF52840 板子，用 ESP32 也能做出来。ESP32 的 NimBLE 协议栈同样支持 HID Over GATT，而且 ESP32 性能更强、Wi-Fi 也能用，但代价是功耗偏高，跑 BLE 键盘可能需要频繁充电。这里列个对比表格供参考。

硬件上，除了主控板，还需要按键。Adafruit 教程里用的是机械按键开关，但实际复现时，矩阵键盘、弧形按键、触摸按键板都能换上去。我自己验证过用 3x4 薄膜键盘矩阵接 nRF52840，效果也一样。

3.2 固件准备：用 CircuitPython 还是 Arduino

Adafruit 生态里有一套非常顺滑的上手路径，就是 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 的蓝牙连接在供电电压波动时可能静默断连，表现为主机端还能看到设备但按鍵无效，这种状态很容易让人误判成代码问题。另外，养成每改一个功能就检查一次蓝牙连接状态的习惯，能省掉大量无意义的“为什么又连不上”的排查时间。这套方案能走多远，很大程度上取决于你往里面填多少自己的场景。