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。

日常连接与配对

旧版 Bluefruit 不提供 DuoChord 的五个独立主机槽位。不要把 DuoChord 的 BLE1～BLE5 / PAIR 操作直接套到这个后端。

1. 连接 USB 数据线，确认能够输入。
2. 同时按住 LShift + RShift，再按 B 切换 USB / 蓝牙输出；在主机蓝牙设置中搜索键盘并连接。
3. 旧配对阻碍连接时，保持 LShift + RShift，在 1 秒内按两次 Z，并在主机删除键盘旧记录后重新配对。该操作清除键盘端已有配对。

键位配置中可能另有 USB、BT、TOG、RST 功能键，位置以实际配置为准。需要五主机槽位时，使用DuoChord 迁移指南。

限制与注意事项

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

故障排查入口

• 无线连不上：看 故障排查 / 无线连接。
• 粘键或按键卡住：先用有线模式确认矩阵正常，再检查无线链路。
• 刷写失败：看 固件下载与刷写。