跳到主要内容

DFU / UF2 刷机：从下载到验证

刷写前：下载正确文件​

正常使用和改键不用先刷机。需要升级时，先确认 PCB 丝印、revision、布局和当前无线后端；在 VIA / Vial 导出键位备份。去下载中心直接找到对应行下载：

PCB文件与工具
G60、Kamilia、Command65 / PE、旧 Manta AVR、Skog Reboot、F60 rev1AVR .hex，用 QMK Toolbox
F60 rev2 / rev3 / rev M / F60w、Manta40 rev2 / Ortho.uf2，TinyUF2 磁盘复制

:::danger 固件不可混刷 PCB revision、Ortho / 非 Ortho、Bluefruit / DuoChord / CH592 的固件不能互刷。DuoChord 的 nRF application .hex 虽然同为 HEX，不能用 QMK Toolbox 刷进 AVR。旧版 BLE 首次迁移必须先 AVR 后 nRF。 :::

进入刷写模式​

  1. 用 USB 数据线连接电脑。优先使用 VIA / Vial 中已经配置的 Reset / QK_BOOT 键进入引导模式。
  2. 若默认 Bootmagic 未被关闭，可断开 USB，按住 Esc 再插 USB，保持约 1 秒后松开。特殊布局先核对对应机型手册。
  3. 若以上方式不能用，按机型说明使用 PCB 标注的 RESET 按钮。不同 bootloader 对单击 / 双击的要求可能不同，勿把电源键当成 RESET。
  4. AVR DFU：QMK Toolbox 日志应显示 DFU 设备连接，键盘暂时不能正常打字；TinyUF2：系统出现临时 USB 磁盘。没有出现对应现象就不要继续写入。

AVR：用 QMK Toolbox 写入 HEX​

  1. 从 QMK Toolbox 官方发布页下载适合系统的版本并打开；Windows 首次运行时按提示安装刷写驱动。
  2. 点击 Open，选中与你的 PCB 匹配的 AVR .hex；如界面要求 MCU，按机型主控选择（多数为 ATmega32U4，Skog Reboot 按 rev 选择 AT90USB646 / AT90USB1286）。
  3. 按上一节进入 DFU，等待 Toolbox 确认设备连接，再点击 Flash。
  4. 等待擦除、写入和校验完成。期间保持供电。成功后键盘通常会重启；若仍在 DFU，可在确认完成后重新插拔 USB。
  5. 在文本编辑器测试按键和 Fn 层，无线机型再测试连接。

TinyUF2：复制 UF2 到临时磁盘​

  1. 按上面的方式进入 TinyUF2，等待电脑出现 USB 磁盘。
  2. 把完全匹配的 .uf2 复制到该磁盘；不用 QMK Toolbox，也不要把 HEX 或 VIA JSON 复制进去。
  3. 等待复制结束、键盘自动重启，临时磁盘随之消失。
  4. 测试输入、Fn 层和无线连接（如适用）。仅在固件兼容时恢复键位备份。

没成功时先检查​

  • 没有 DFU 设备 / UF2 磁盘：换数据线和 USB 接口，确认 Bootmagic 或 Reset 键是否可用，不要仅凭键盘不打字判断已进入引导。
  • Toolbox 看不到已连接的 DFU 设备：检查刷写驱动；按 QMK 官方刷写说明排查。
  • 有 UF2 磁盘但复制后无正常输入：重新核对文件、PCB revision 和布局，不要轮流尝试其他型号固件。
  • AVR 已更新但旧版 BLE 迁移未完成：继续六步迁移指南，不要跳过 nRF application 更新。