固件编译说明

重要安全提示

为确保系统稳定运行,请务必遵循以下固件使用原则:

• 固件编译一致性:Klipper固件必须由您当前使用的上位机进行编译。使用他人编译的或版本不匹配的固件,可能导致不可预见的系统故障。
• 硬件平台规范:强烈建议使用标准的上位机硬件。避免采用经非官方魔改的设备(例如某些机顶盒、WiFi棒子或特定型号的红米设备),这些设备可能存在兼容性与稳定性风险。
• 虚拟化环境限制:不建议在虚拟机中运行上位机系统,这可能会引入性能与实时性干扰,影响打印质量。

固件类型说明

• Katapult / HID 模式

  • 功能:这两种模式功能相同,均可实现无接触烧录(无需插拔内存卡,直接通过上位机更新固件)。
  • 说明:HID 是 FLY 板载上位机所使用的 Bootloader,其本质与 Katapult 相同。
  • 重要提示:使用Katapult时,若刷入错误固件导致主板无响应,请找到主板上的重置按键并快速双击两次,即可重新进入 Katapult 模式再次烧录。

• Bootloader 模式

  • 功能:传统的通过内存卡进行烧录的方式。
  • 优点:此方式容错性强,若不慎刷写错误,可通过重新烧录内存卡再次尝试,无需担心主板“变砖”。

固件编译指南

编译准备与建议

• 为最大限度保证编译成功,推荐使用 MobaXterm 作为您的SSH客户端。据用户反馈,某些SSH工具可能导致未知的编译错误。
• 重要配置项:在编译配置界面,请务必勾选 Enable extra low-level configuration options 选项,否则部分高级设置将不会显示。

启动引脚配置 (GPIO pins to set at micro-controller startup)

重要提示

• 此选项用于在微控制器启动时,强制设置特定GPIO引脚的电平状态。
• 需要切换英文输入法,否则无法编译固件

• 配置语法:

  • 在引脚前添加 ! 表示启动时将该引脚拉低(低电平),不加 ! 则表示拉高(高电平)。
  • STM32系列:引脚号必须大写(如 !PF8 或 PF8)。
  • RP2040系列:引脚号必须小写(如 !gpio5 或 gpio5)。

• 多引脚配置:如需配置多个引脚,请用英文逗号 , 分隔。

  • 示例:!gpio5,!gpio19,gpio24 表示启动时将 gpio5 和 gpio19 拉低,同时将 gpio24 拉高。

安全性说明

您配置的 GPIO pins to set at micro-controller startup 仅在 Klipper 启动连接前生效。一旦 Klipper 完成连接并正常运行时,此设置不会影响引脚的其他任何操作,可安全使用。

刷写失败恢复与通用保护

• 刷错固件的保护:Katapult、HID 和 Bootloader 这三类固件本身具有保护机制。只要不进入特殊的 DFU 模式进行烧录,即使刷错了主固件,它们也不会被覆盖,主板不会“变砖”。
• 刷写完成后的必要操作:任何固件烧录完成后,请务必将下位机彻底断电一次(拔掉电源线),再重新上电,以确保新固件被正确加载并稳定运行。

固件烧录说明

烧录前须知

• 设备识别:使用 Katapult 烧录时,请确保上位机能识别到设备。若无法找到设备,请快速双击主板上的重置按键以重新进入烧录模式。
• 遵循规范:请严格遵循官方教程的烧录方法,使用其他未经验证的方式可能导致设备损坏。
• 编译检查:烧录前,请务必确认固件没有编译错误,错误的固件文件将导致烧录失败或设备无法正常工作。

Katapult 固件刷错恢复

1. 找到主板上的物理重置按钮并快速双击。
2. 正常情况下,Fly主板中会有一个LED指示灯开始闪烁,表示已成功进入 Katapult 模式。
3. 此时可清除主板上的错误固件,并重新烧录正确的 Klipper 固件。

Bootloader 固件刷错恢复

1. 将存有正确固件的 TF 卡重新插入主板。
2. 若无法刷入,请先完全断电,插入 TF 卡后再重新上电。
3. 保持通电约 5 秒,即可完成自动刷写。

---