停電時シャットダウンと停電復帰印刷

ご注意

1. 機能の概念とフロー

停電時シャットダウン
- 概念: 異常な停電を検出すると、システムは現在の印刷状態を保存せず、直接安全にシャットダウンを実行します。
- 復旧フロー: 電力が回復した後、デバイスは自動的に再起動し待機状態になります。以前の印刷ジョブは中止されており、新しい印刷を手動で開始する必要があります。
停電復帰印刷
- 概念: 異常な停電を検出すると、システムは直ちに現在の印刷進捗(位置、レイヤー高さなど)を保存し、その後シャットダウンします。
- 復旧フロー: 電力が回復した後、通常はユーザーの確認が必要で、デバイスは停電時の位置から未完了の印刷を継続して完了することができます。

2. コアルール

停電時シャットダウンと停電復帰印刷は相互排他的な機能であり、同時に有効化することはできません。
停電時シャットダウン機能を有効にすると、停電復帰印刷機能は自動的に無効になります。

3. 選択方法

「停電時シャットダウン」を選択: 電気の安全性をより重視する場合、または電力回復後にデバイスが自動的に起動して待機し、中断された印刷を復旧する必要がない場合は、この機能を有効にしてください。
「停電復帰印刷」を選択: 長時間を要し、失敗が許されない印刷タスクを頻繁に行い、停電後に中断点から印刷を再開したい場合は、この機能を有効にしてください。

設定

停電時シャットダウン
停電復帰印刷

電源切断シャットダウンの設定

注意

電源切断シャットダウンの設定方法

ブラウザのアドレス欄に装置のIPアドレスを入力します。例:http://192.168.6.179
設定ページへアクセス
- ブラウザで装置のIPアドレスを開きます。例:http://192.168.1.2/
- 左図のように、Fluiddでは「非表示のファイルやフォルダをフィルタリングする」のチェックを解除してください。
- 右図のように、Mainsailでは「隠しファイルを表示する」にチェックを入れてください。
Loading...
Loading...
- すると.flyos-configフォルダが見えるようになります。このフォルダ内にsys-config.confというファイルがあります。
- sys-config.confファイルは、リムーバブルディスクFlyOS-Conf内の設定ファイルconfig.txtへのシンボリックリンクです。
Loading...
- sys-config.confファイルを開き、shutdown_pin_state と shutdown_pin= の設定を探して、以下の設定に変更してください。
- なお、shutdown_pin=none は削除するか、先頭に # を追加してください。

shutdown_pin_state=1
shutdown_pin=PI4

その後、保存 -> 閉じる を選択し、システムを再起動してください。

電源シャットダウンの無効化

注意

断電継続印刷を使用するには、電源シャットダウンを無効にする必要があります。
断電継続印刷機能には、進捗を保存した後に自動的にシャットダウンする機能があります。
上位コンピュータに他の電源が接続されていないことを確認してください。そうでない場合、電源が入らなくなります。

ブラウザのアドレスバーにデバイスのIPアドレスを入力します。例:http://192.168.6.179
設定ページへアクセスします。
- ブラウザでデバイスのIPアドレスを開きます。例:http://192.168.1.2/
- 左図のように、Fluiddでは「隠しファイルやフォルダを非表示」のチェックを外します。
- 右図のように、Mainsailでは「隠しファイルを表示」にチェックを入れます。
Loading...
Loading...
- この状態で.flyos-configフォルダが見えるようになります。このフォルダ内にsys-config.confファイルがあります。
- sys-config.confファイルは、リムーバブルディスクFlyOS-Conf内の設定ファイルconfig.txtへのシンボリックリンクです。
Loading...
- sys-config.confファイルを開き、「shutdown_pin_state」と「shutdown_pin=」の設定を探します。
- これらの設定の前に#を追加します。
- 次に「保存」->「閉じる」を行い、その後再起動してください。
Loading...

plr.cfg 設定ファイル

プリンター設定ページで、plr.cfg ファイルを見つけます。
中身を空にして、以下の設定を貼り付けます。
設定ファイルの内容は以下の通りです:

[mcu host]   
serial: /tmp/klipper_host_mcu

[power_loss_resume]
power_pin: host:gpiochip1/gpio8
is_shutdown: True # シャットダウン操作を実行するかどうか、デフォルトは有効
paused_recover_z: -2.0 # 停止時に印刷が一時停止していた場合、印刷再開時のZ軸移動距離、デフォルトは移動なし
start_gcode:
    # 印刷再開前に実行するGコード
    # 停電前に保存されたすべてのパラメータは{PLR}で取得可能
    # M118 {PLR}を使用してすべての利用可能なパラメータを出力できます
    # M118 {PLR}
    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 Y                         ; XYを原点復帰
    M83                             ; 相対押出
    # G1 E0.5 F400                   ; 少し押出
layer_count: 2 # 指定された層数を印刷再開後にlayer_change_gcodeを実行
layer_change_gcode:                
    # {layer_count}層を印刷再開した後に実行するGコード
    M118 印刷速度を復元
    M106 S{PLR.fan_speed}             ; パーツ冷却ファンをオン
    M220 S{PLR.move_speed_percent}    ; 要求速度パーセンテージを設定
    M221 S{PLR.extrude_speed_percent} ; 要求押出速度パーセンテージを設定
shutdown_gcode:
    # シャットダウン前に実行するGコード
    M118 電源電圧低下、シャットダウン
    # M112 ; 緊急停止

上記の設定ファイルを保存した後
printer.cfg ファイルを開き、ファイルの先頭に以下の内容を追加します:
```
[include plr.cfg]
```
右上の保存して再起動をクリックします。
これで、Klipperの停電復帰機能の設定が完了しました。

`[homing_override]`についての説明

注意

[homing_override]を使用する場合、[homing_override]内でホーム位置を任意に設定しないでください。これによる電源復帰後の印刷再開失敗については一切責任を負いません。
以下に[homing_override]の設定説明があります。

説明
- [force_move]: 強制移動機能を有効にし、指定位置への強制移動を許可します。
- [force_move]は[homing_override]内のset_position_z機能に代わるものです。この設定に従わない場合、電源復帰後の印刷再開が失敗する可能性があります。
- 以下の[homing_override]設定は、電源復帰後にZ軸を正しくホーム位置に戻すためのものです。

[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 %}

リフトアップについての説明
- この設定は、Z軸がホーム位置に戻っていない場合のみ実行される動作です。通常の使用には影響しません。
```
{% if 'z' not in printer.toolhead.homed_axes %}
    SET_KINEMATIC_POSITION Z=0
    G90
    G0 Z5 F600
{% endif %}
```

`[gcode_macro _CLIENT_VARIABLE]` の設定についての説明

設定に [gcode_macro _CLIENT_VARIABLE] マクロが含まれており、以下の変数が設定されている場合:
参考

[gcode_macro _CLIENT_VARIABLE]
variable_use_custom_pos: True    # カスタム位置を有効にする
variable_custom_park_dz: 5       # カスタムパーク高さオフセットを設定

[power_loss_resume] モジュール内の paused_recover_z パラメータ値を、上記のオフセット値と符号が反対になるように調整する必要があります。

設定の対応関係

マクロ変数	一時停止/再開モジュールパラメータ	対応関係
`variable_custom_park_dz: 5`	`paused_recover_z: -5`	符号が反対、数値は同じ
`variable_custom_park_dz: -3`	`paused_recover_z: 3`	符号が反対、数値は同じ

設定例

[gcode_macro _CLIENT_VARIABLE]
variable_use_custom_pos: True
variable_custom_park_dz: 5

[power_loss_resume]
paused_recover_z: -5

重要: この対応関係を維持しない場合、電源復帰後の印刷再開または一時停止からの復帰時にZ軸高さの計算が誤り、印刷に影響する可能性があります。

テスト

ステップ1: 緊急停止による電源断のシミュレーション

任意のファイルの印刷を開始し、印刷中に 緊急停止 ボタンをクリックして、電源断の状況をシミュレートします。
再度 ファームウェア再起動 をクリックし、Klipperが再接続して正常に復旧するのを待ちます。
ウェブインターフェースにポップアップ通知が表示されるか観察します。表示されれば、電源復帰後の印刷再開機能が正常に動作しています。
その後、実際の電源断状況をテストして、機能の信頼性をさらに検証できます。

ステップ2: 実際の電源断シミュレーションと機能検証

テスト準備: システムが正常に起動しKlipperに接続された後、ホストコンピュータ横のインジケータランプの状態を確認します。通常、システム稼働中はLEDが点滅しており、このインジケータランプが後続で観察する重要な指標となります。
デバイスが正常に動作しKlipperに接続されている状態で、直接電源を切り、実際の電源断シナリオをシミュレートします。
直ちにホストコンピュータ横のインジケータランプが 5秒以内に完全に消灯するか を確認します。
- 消灯した場合: 電源断シャットダウン機能が正常に動作しています。次のステップに進んでください。
- 消灯しなかった場合: 自動シャットダウン機能が有効になっていないことを示します。通常、関連する設定（kppmの配線や設定など）に誤りがあるため、重点的にチェックし、問題を解決する必要があります。
少なくとも5秒待機した後、電源を再投入し、Klipperが自動的に再接続して正常に動作を再開するか観察します。（データ保存とシャットダウンには3-5秒かかります）
ウェブインターフェースを確認します
- ポップアップ通知が表示された場合: 電源復帰後の印刷再開機能が正常に起動・動作していることを示します。
- 何も通知がない場合: 電源復帰後の印刷再開機能が期待通りに起動していないことを示します。上記の現象に基づいて、関連する設定を体系的に確認してください。

設定​

電源切断シャットダウンの設定​

電源シャットダウンの無効化​

plr.cfg 設定ファイル​

[homing_override]についての説明​

[gcode_macro _CLIENT_VARIABLE] の設定についての説明​

設定の対応関係​

設定例​

テスト​

ステップ1: 緊急停止による電源断のシミュレーション​

ステップ2: 実際の電源断シミュレーションと機能検証​

設定

電源切断シャットダウンの設定

電源シャットダウンの無効化

plr.cfg 設定ファイル

`[homing_override]`についての説明

`[gcode_macro _CLIENT_VARIABLE]` の設定についての説明

設定の対応関係

設定例

テスト

ステップ1: 緊急停止による電源断のシミュレーション

ステップ2: 実際の電源断シミュレーションと機能検証