跳到主要内容

AVR 旧版 BLE 固件

本页描述 ATmega32U4 键盘搭配 nRF51822 无线模块、运行旧版 Adafruit Bluefruit LE 固件（下称「旧版 BLE 固件」）时的公共操作与限制，适用于 G60、Kamilia、Command65、 Manta 40s（Hotswap/Solderable/Ortho）和 Skog Reboot 的旧版 BLE 固件后端。

:::info 第三方名称说明

本文中的 Adafruit 与 Bluefruit 名称仅用于准确识别旧版第三方固件、兼容协议和配套 工具。相关键盘和 nRF51822 无线模块并非 Adafruit 原装产品，本项目与 Adafruit Industries 没有隶属、授权、赞助或认可关系。Bluefruit 是 Adafruit Industries 的商标。

:::

工作原理​

  • AVR（ATmega32U4）负责矩阵扫描与键盘状态。
  • nRF51822 模块负责 BLE 无线传输，AVR 通过 UART 以 AT 文本命令控制模块。
  • 模块运行旧版 Adafruit Bluefruit LE application，并使用 S110 SoftDevice 8.0.0。

无线功能键​

旧版 BLE 固件后端提供以下功能键（具体放置位置见机型页）：

键名功能
BLE1 ~ BLE5切换到 BLE 通道 1~5
PAIR进入配对模式
CLR清除配对记录
RST重置模块
TOG在 USB 与无线之间切换
BT蓝牙相关操作的组合入口（部分机型）
USB切换到 USB 模式

配对​

  1. 按 PAIR 进入配对模式。
  2. 在主机上搜索并连接对应设备名。
  3. 成功配对后，键盘可被该主机记住；切换到其他通道前建议先断开当前连接。

配对状态保存在模块内。CLR 会清除已有配对记录，清除后需重新配对。

限制与注意事项​

  • 旧版 BLE 固件使用 Bluefruit AT 文本协议，高速连续输入时 UART 有丢字符风险；如需稳定 高速输入，优先使用有线模式。
  • 每次按键必须正确发送「按下」与「抬起」两个 HID report，否则可能出现 粘键（主机认为按键一直按住）。
  • 旧版 BLE 固件不支持本仓库 DuoChord 的二进制协议与五槽位管理，两者固件 不互通。
  • 从旧版 BLE 固件迁移到 DuoChord 需要按固定顺序操作，见 旧版 BLE 固件 → DuoChord 首次迁移。

故障排查入口​