OTA システム更新ガイド
このドキュメントでは、FlyOS-Fast システムの OTA(Over-The-Air)更新機能について詳しく説明し、安全かつ便利にシステムをアップグレードするための手順を提供します。
バージョンサポートに関する説明
- V1.3.0 以降: OTA オンライン更新機能をサポート
- V1.3.3 以降: USB メモリによるシステム更新方法を追加
- V1.3.10 以降: アップグレードパッケージが MCU ファームウェアの同期更新を必要とする場合、OTA 後の初回起動段階で対応マザーボードのUSBファームウェアを自動更新できます
プリインストールサービスのバージョンに関する説明
FlyOS-Fast システムには、Klipper、RRF、Mainsail、Fluidd、Moonraker、KlipperScreen などの主要サービスが内蔵されており、これらのサービスはシステムパッケージ作成時に以下のバージョン管理戦略に従います:
ターゲットを絞った最適化
当社は、Klipper、Mainsail、Fluidd、Moonraker、KlipperScreen などのコアサービスに対して、システムの安定性とプリント性能を向上させるための特別な最適化を実施しています。
これらのサービスを手動でアップグレードまたは置き換えないでください。手動で切り替えると、ターゲットを絞った最適化が無効になり、システムの安定性や機能の互換性に影響を与える可能性があります。更新が必要な場合は、公式の OTA 方式で最新バージョンを取得してください。
更新ポリシー
システム OTA パッケージには、適合・テスト済みのシステムコンポーネントが同時に提供されます。リリースバージョンは、各上流プロジェクトの最新コミットと完全に一致することを保証するものではありません。FlyOS-Fast の更新ログに記載されている内容を基準としてください。
注意事項
システムコンポーネント間には連携関係があるため、OTA 以外で Klipper、Moonraker、ウェブインターフェース、またはスクリーンサービスを個別に置き換えないでください。特定のバージョンが必要な場合は、テクニカルサポートにお問い合わせください。
更新方法の選択
- ネットワークオンライン更新
- 手動更新
- USBメモリオフライン更新
ネットワーク更新の条件
- デバイスがインターネットに接続されている
- システムバージョンが
V1.3.0以上
操作手順
- ブラウザで
http://[デバイスIPアドレス]:9998にアクセス - システムが利用可能な更新を自動的に確認します
- 新しいバージョンがある場合、「更新」 ボタンをクリックしてアップグレードを開始
- システムが自動的にダウンロード・インストールするのを待ちます
ヒント: 更新中は電源を切ったり、印刷操作を行わないでください
ローカルアップグレードパッケージのアップロード
デバイスがオンライン更新ソースからバージョンを取得できない場合、OTA管理ページでローカルアップグレードパッケージをアップロードすることもできます:
- ブラウザで
http://[デバイスIPアドレス]:9998にアクセスします。 - 手動アップグレードパッケージアップロード エリアを見つけ、アップグレードパッケージをアップロードボックスにドラッグするか、ファイルを参照 をクリックしてファイルを選択します。
.full.fupまたは.diff.fupで終わるアップグレードパッケージを選択します。他の拡張子はページで拒否されます。- ページがファイルの検証とアップロードを完了するのを待ち、ファイル名、デバイスモデル、バージョン情報が正しいことを確認します。
- アップロードして更新 をクリックし、確認プロンプトの後で更新を開始します。
- アップロード、検証、書き込み、再起動がすべて完了するまで待ち、その後再度Webページにアクセスします。
.full.fupは完全なシステムパッケージで、通常はクロスバージョンアップグレードやシステム復元に使用されます。.diff.fupは差分アップグレードパッケージで、明示的に対応するソースバージョンにのみ使用できます。- アップグレードパッケージはデバイスモデルとシステムパーティションに一致する必要があります。他のデバイスのファイルをアップロードしないでください。
- アップロードと書き込み中は安定した電源を維持し、ページを閉じたり、ネットワークを切断したり、USBメモリを抜いたり、デバイスを手動で再起動したりしないでください。
準備作業
USBメモリ更新の条件
- システムバージョンが
V1.3.3以上
USBメモリの要件
- インターフェースタイプ: USB 2.0のUSBメモリまたはカードリーダーを使用する必要があります
- ストレージ容量: 少なくとも8GBの空き容量
- 互換性のヒント: USB 3.0デバイス(青色のインターフェース)はアップグレードが遅くなる可能性があります
システムパッケージのダウンロード
デバイスモデルに応じて対応するシステム完全アップグレードパッケージをダウンロードしてください:
ダウンロードページへ更新フロー
ステップ1:アップグレードファイルの準備
- システムダウンロードページにアクセスして、対応するデバイスのアップグレードパッケージを取得します
- ダウンロードした
.full.fupファイルをUSBメモリのルートディレクトリにコピーします
- アップグレードパッケージがデバイスモデルと完全に一致することを確認してください
- ファイルが一致しない場合、USBメモリを挿入してもシステムは何も表示しません
ステップ2:更新のトリガー
- 準備したUSBメモリをデバイスのUSBインターフェースに挿入します
- システムが更新ファイルを検出すると、自動的に更新プロンプトが表示されます
プロンプト表示位置:
- Web管理インターフェース: Mainsail / Fluidd インターフェース
- WiScreen 7インチスクリーン: 専用シリアルスクリーン
- KlipperScreen: 更新プロンプトは表示されません。Webインターフェースをご使用ください
ステップ3:更新の実行
更新プロンプトが表示された画面で 「更新を開始」 ボタンをクリックすると、システムがアップグレードプロセス全体を自動的に完了します。
更新時の注意事項
一般的な安全上のヒント
- 更新前にすべてのプリントタスクを一時停止してください
- デバイスへの安定した電源供給を確保し、予期しない停電を避けてください
- 重要な設定ファイルは事前にバックアップすることをお勧めします
更新後の操作
- ページの指示に従って、システムが更新と再起動を完了するのを待ちます。アップグレードパッケージが MCU の更新を要求する場合、システムは対応マザーボードのUSBファームウェアのみを自動処理します
- 更新中は安定した電源を維持し、デバイスの電源を切ったり、プリントを開始したり、手動で再起動したりしないでください
- ウェブページに再アクセスした後、システムバージョンおよび Klipper、Moonraker の接続状態を確認してください
- 自動更新のサポート範囲外のマザーボードとファームウェアは、対応する製品チュートリアルに従って手動で更新する必要があります
OTA 後の MCU ファームウェア自動更新
OTA の MCU ファームウェア自動更新機能は、以下のマザーボードのみをサポートします:
- FLY-C8
- FLY-C5
- FLY-C8P
- FLY-GEMINI V3
上記のマザーボードは USB 通信ファームウェア を使用する必要があります。他のマザーボード、CAN ファームウェア、USB から CAN へのファームウェア、CAN ツールボード、およびその他の外部 MCU は、OTA 自動ファームウェア更新をサポートしていません。
サポート範囲外のデバイスは、対応する製品ドキュメントに従って手動でファームウェアをコンパイルおよび書き込みしてください。
アップグレードパッケージが対応マザーボードの MCU ファームウェアの更新を必要とする場合、システムは OTA 後の初回起動段階で自動的に処理します。OTA を開始する前に、マザーボードの USB 接続が正常であることを確認し、更新完了後に Klipper が正常に接続できるかを確認してください。
MCU の自動更新中は、電源を切ったり、再起動したり、プリントを開始したり、USB ケーブルを抜き差ししたりしないでください。書き込みが中断されると MCU に接続できなくなる可能性があり、対応するマザーボードのファームウェア書き込みチュートリアルに従って手動で復旧する必要があります。
上記の手順により、FlyOS-Fast システムの OTA 更新を簡単に完了できます。