如何刷写固件

  less than a minute  

当您对键盘配置文件（如键位映射、功能或设备设置）进行无法动态更新的更改时，需要刷写固件。本指南涵盖了向NXTKB键盘刷写固件的完整过程。

何时需要刷写固件

当出现以下情况时，您需要刷写固件：

• 您已修改配置仓库中的键位映射文件
• 您已更新配置文件（例如sweep.conf）
• 您需要重置蓝牙配对信息或其他存储信息（如从zmk studio更新的键位映射）

注意: 如果您只需要更改键位映射，请考虑使用ZMK Studio，它允许在不重新刷写固件的情况下更新键位映射。

刷写固件步骤

1. 获取固件文件

您可以通过两种方法获取固件文件：

选项A: 从GitHub Actions获取（推荐）

• 将更改推送到您的fork配置仓库后
• GitHub Actions将自动构建固件
• 从工作流工件中下载.uf2文件

选项B: 从官方发布版本获取

• 从官方仓库发布版本下载预构建固件：
  • Sweep-Pro 发布版本
  • zmk-config-4-ferris-sweep 发布版本

选项C: 自行构建

• 有关自定义构建，请参阅自行构建固件

2. 使用USB连接键盘半体

1. 使用USB-C线缆将键盘的左侧或右侧半体连接到您的计算机
2. 对于大多数更改（如键位映射更新），您只需刷写主键盘（左侧）半体。

3. 进入引导加载程序模式

在要刷写的半体上进入引导加载程序模式：

• 方法1: 按下&bootloader键（需要键盘已连接到设备以进行输入）
• 方法2: 双击键盘上的物理复位按钮
• 方法3: 如果复位按钮不起作用，快速短接复位按钮两次
• 方法4: 作为最后手段，快速短接控制器的GND和RST引脚两次（左上角第二和第三个引脚）

注意: 当键盘进入引导加载程序模式时，它将显示为名为"NICENANO"或类似的可移动驱动器。

4. 刷写固件

1. 进入引导加载程序模式后，键盘将显示为可移动驱动器

2. 将相应的.uf2文件复制到驱动器：

   • xxx-left-xxx.uf2 → 用于左侧半体
   • xxx-right-xxx.uf2 → 用于右侧半体
   • xxx-reset-xxx.uf2 → 用于两个半体，清除蓝牙配对信息（当半体无法连接时使用）

3. 复制文件后，键盘将自动重启

4. 如有需要，重复操作另一侧半体

版本历史

请定期查看固件刷写流程的新功能和改进。