メインコンテンツにスキップ

Klipperバージョン切替ガイド

適用条件

本書はFLYOS-FASTにのみ適用されます。以下の操作は、サードパーティ製Klipperブランチを必須とするプラグインとの互換性を確保するためのものであり、通常のアップグレード方法として推奨されるものではありません。

重要な機能変更

KalicoまたはKlipper公式版に切り替えると、FLYOS-FASTの印刷再開機能やUSBメモリ印刷などのカスタム機能が無効になります。これらの機能が必要な場合は、システム標準搭載のKlipperを維持してください。

切替前に /usr/share/printer_data/config をバックアップしてください。対象バージョンのダウンロードと実行ディレクトリの置き換えは必ず別々に行い、ネットワーク中断により不完全な /data/klipper が残らないようにしてください。

Kalicoのインストール​

Kalicoの取得または更新​

この手順ではGitHubへの接続が必要ですが、現在使用中の /data/klipper は変更されません。

cd /data
if [ -d /data/kalico/.git ]; then
  git -C /data/kalico pull --ff-only
else
  git clone https://github.com/KalicoCrew/kalico.git /data/kalico
fi
Loading...

実行ディレクトリの切り替え​

取得が成功し、/data/klipper-flyos-fast が存在しないことを確認してから実行してください：

systemctl stop klipper
mv /data/klipper /data/klipper-flyos-fast
mv /data/kalico /data/klipper
systemctl start klipper
systemctl is-active klipper
Loading...

active が返ってきた場合はサービスが起動したことのみを意味します。Klipperのログを確認し、プリンター設定にバージョン互換性エラーがないことを確認してください。

Klipper公式版のインストール​

公式版の取得または更新​

cd /data
if [ -d /data/klipper-upstream/.git ]; then
  git -C /data/klipper-upstream pull --ff-only
else
  git clone https://github.com/Klipper3d/klipper.git /data/klipper-upstream
fi
Loading...

実行ディレクトリの切り替え​

取得が成功し、/data/klipper-flyos-fast が存在しないことを確認してから実行してください：

systemctl stop klipper
mv /data/klipper /data/klipper-flyos-fast
mv /data/klipper-upstream /data/klipper
systemctl start klipper
systemctl is-active klipper
Loading...

FLYOS-FAST標準搭載Klipperの復元​

復元前に、/data/klipper-flyos-fast が切り替え時に保存された元のディレクトリであることを確認してください：

systemctl stop klipper
mv /data/klipper "/data/klipper-third-party-$(date +%Y%m%d-%H%M%S)"
mv /data/klipper-flyos-fast /data/klipper
systemctl start klipper
systemctl is-active klipper

復元に成功すると、サービスステータスは active に戻り、FLYOS-FASTのカスタム機能も再びシステム標準実装を使用します。現在のサードパーティディレクトリはタイムスタンプ名で保持され、直接削除されることはありません。

Loading...