断电关机与断电续打

重要须知

• 断电关机与断电续打功能互相冲突，无法同时启用。
• 若仅启用断电关机功能，则无法使用断电续打功能。
• 断电续打需要 Klipper 保持正常连接。功能触发后，系统会自动进入关机流程。

功能配置

• 断电关机
• 断电续打

配置断电关机

进入设备配置

1. 在浏览器地址栏输入设备 IP 地址，例如 http://<device_ip>/。
2. 显示隐藏文件。
   • Fluidd：取消勾选“筛选隐藏的文件和文件夹”。
   • Mainsail：勾选“显示隐藏文件”。

Fluidd 隐藏文件设置：

Loading...

Mainsail 隐藏文件设置：

Loading...

修改配置文件

1. 找到并进入 .flyos-config 文件夹。
2. 打开 sys-config.conf 文件。该文件是 FlyOS-Conf 磁盘中 config.txt 的软链接。

Loading...

3. 找到 shutdown_pin_state 与 shutdown_pin 配置项，修改为：

shutdown_pin_state=1
shutdown_pin=<shutdown_gpio>

4. 确保 shutdown_pin=none 已被删除或注释。
5. 保存修改后的配置文件并重启系统。

Loading...

配置断电续打

关闭断电关机

须知

• 需要关闭断电关机，否则无法使用断电续打功能。
• 断电续打中包含保存进度后自动关机功能。
• 请确认没有其他供电接到上位机上，否则可能无法正常关机。

1. 在浏览器地址栏输入设备 IP 地址，例如 http://<device_ip>/。
2. 显示隐藏文件。
   • Fluidd：取消勾选“筛选隐藏的文件和文件夹”。
   • Mainsail：勾选“显示隐藏文件”。
3. 进入 .flyos-config 文件夹，打开 sys-config.conf 文件。
4. 找到 shutdown_pin_state 与 shutdown_pin 配置项，并在这两个配置前面添加 # 进行注释。
5. 保存修改后的配置文件并重启系统。

Loading...

添加断电续打配置

1. 在打印机配置页面中，找到或创建 plr.cfg 文件。
2. 清空文件内容，粘贴以下配置。
3. 请根据实际设备修改 power_pin 参数。必须使用上位机 GPIO 或产品推荐的引脚，不能使用下位机（MCU/工具板）的引脚。

[mcu host]
serial: /tmp/klipper_host_mcu

[power_loss_resume]
power_pin: <power_loss_pin>
is_shutdown: True
paused_recover_z: -2.0
start_gcode:
    M118 开始续打： {PLR.print_stats.filename}
    M118 中断位置： X:[{PLR.POS_X}] Y:[{PLR.POS_Y}] Z:[{PLR.POS_Z}] E:[{PLR.POS_E}]
    {% for name, heater in PLR.heaters.items() %}
        {% if heater.target > 0 %}
            M118 设置加热器[{heater.name}] 目标温度： {heater.target}
            SET_HEATER_TEMPERATURE HEATER="{heater.name}" TARGET={heater.target}
        {% endif %}
    {% endfor %}
    {% if PLR.toolhead.extruder in PLR.heaters and PLR.heaters[PLR.toolhead.extruder].target > 0 %}
        {% set extruder = PLR.heaters[PLR.toolhead.extruder] %}
        M118 等待[{extruder.name}]到达目标温度： {extruder.target}
        TEMPERATURE_WAIT SENSOR="{extruder.name}" MINIMUM={extruder.target-5} MAXIMUM={extruder.target+5}
    {% endif %}
    G91                             ; 相对坐标
    G1 Z2 F100                      ; 抬升Z，准备X,Y归零
    G90                             ; 绝对坐标
    G28 X                           ; 归零X
    G28 Y                           ; 归零Y
    M83                             ; 相对挤出
    # G1 E0.5 F400                   ; 挤出一点
layer_count: 2
layer_change_gcode:
    M118 恢复打印速度
    M106 S{PLR.fan_speed}
    M220 S{PLR.move_speed_percent}
    M221 S{PLR.extrude_speed_percent}
shutdown_gcode:
    M118 电源电压低，关机
    # M112

包含配置文件

打开 printer.cfg 文件，在文件最前面添加：

[include plr.cfg]

保存并重启 Klipper。

配置归位覆盖

重要注意事项

• 如果使用 [homing_override]，不要在配置中随意设置归位位置。
• 不正确的配置可能导致断电续打失败。

[force_move]
enable_force_move: true

[homing_override]
axes: z
gcode:
    {% set max_x = printer.configfile.config["stepper_x"]["position_max"]|float %}
    {% set max_y = printer.configfile.config["stepper_y"]["position_max"]|float %}
    {% if 'z' not in printer.toolhead.homed_axes %}
        SET_KINEMATIC_POSITION Z=0
        G90
        G0 Z5 F600
    {% endif %}
    {% set home_all = 'X' not in params and 'Y' not in params and 'Z' not in params %}

    {% if home_all or 'X' in params %}
        G28 X
    {% endif %}

    {% if home_all or 'Y' in params %}
        G28 Y
    {% endif %}

    {% if home_all or 'Z' in params %}
        G0 X{max_x / 2} Y{max_y / 2} F3600
        G28 Z
        G1 Z10 F2000
    {% endif %}

功能测试

模拟断电测试

1. 开始打印任意文件。
2. 在打印过程中点击紧急停机按钮，模拟断电情况。
3. 点击固件重启，等待 Klipper 重新连接。
4. 观察网页界面是否出现弹窗提示。
5. 后续可进行真实断电测试验证功能可靠性。

真实断电测试

1. 确认上位机旁的指示灯状态，正常运行时应有 LED 闪烁。
2. 在设备正常运行状态下直接断开电源。
3. 观察指示灯是否在 5 秒内完全熄灭。
4. 等待至少 5 秒后重新接通电源。
5. 如果出现续打弹窗，说明断电续打功能正常。