FASTシステム使用ガイドと注意事項
システム特徴と設計説明
1. システムユーザー説明
- FASTシステムは極限まで軽量化と安全性を追求しており、シングルユーザーモードを採用しています。
- 唯一のユーザー:
root - 制限: システムは他のユーザーを作成または切り替えることをサポートしていません。
2. パッケージ管理
FASTシステムは軽量性と高速起動を維持するため、aptなどの従来のパッケージマネージャーを統合しておらず、したがってapt updateなどのコマンドを実行することはできません。- プリインストール済みソフトウェア: システムにはKlipperエコシステムおよび日常メンテナンスに必要な一般的なツールが既に内蔵されています。
- ソフトウェア要件: その他のソフトウェアパッケージが必要な場合は、ぜひご意見をお聞かせください。汎用性を評価し、今後のバージョンにプリインストールを検討いたします。
3. ファイルシステムと永続化
- 変更可能なパス: システムコアの完全性を確保するため、FASTシステムは
/etcおよび/dataディレクトリ以下のファイルのみ変更を許可しています。 - 制限説明: システム内の他のディレクトリはすべて読み取り専用であり、いかなる変更も保存されません。カスタム設定やデータは上記の2つの指定されたディレクトリに保存してください。
4. システムアップデートポリシー
FASTシステムは2種類のアップデート方式をサポートしています:
OTAオンラインアップデート（推奨）
V1.3.0以降、FASTシステムはOTAアップグレードをサポートします。- アップデート入口: 上位コンピュータの
IPアドレス:9998ポートにアクセスして、システムOTAアップグレードページに入ることができます。 - 重要なお知らせ:
- システムアップデートを開始する前に、すべての印刷タスクを一時停止していることを確認してください。
- アップデート中、システムサービスが再起動します。印刷操作を行わないでください。さもなければ印刷失敗やハードウェアの暴走が発生する可能性があります。
フラッシュアップデート
- 適用シナリオ: システムが正常に起動できない場合
- 重要な警告:
- フラッシュ前に設定をバックアップしてください: フラッシュプロセスではすべてのユーザー情報が削除されるため、プリンターシステムの設定を事前にバックアップしてください。
- フラッシュ完了後、手動でバックアップした設定ファイルを復元する必要があります。
- フラッシュ方法: 公式に提供されたフラッシュ手順およびツールを参照してください。
パスと環境の違い
ファームウェア生成場所
- FASTシステムにおいて、Klipperファームウェアが正常にコンパイルされた後、生成されるファームウェアファイルは以下の場所にあります:
/data/klipper/out/
設定ファイルの場所
- FASTシステムにおいて
| ファームウェアバージョン | Klipper設定パス | RRF設定パス |
|---|---|---|
| ファームウェア設定パス | Loading... | Loading... |
Python環境の違い
FASTシステムでは、Klipper公式推奨のPython venv仮想環境ではなく、グローバルなPython環境を使用しています。このため、Klipper環境下のPythonスクリプトを実行する必要があるすべてのコマンドを調整する必要があります。
主要な修正点: コマンド中の ~/klippy-env/bin/python を python に置き換えてください。
| シナリオ説明 | 標準システムコマンド | FASTシステムコマンド |
|---|---|---|
| CANBUS UUIDの照会 | Loading... | Loading... |
よくある問題: コマンドを実行する際に、以下のようなエラーが発生することがあります:
-bash: ~/klippy-env/bin/python: そのようなファイルやディレクトリはありません
解決策: 上記の表に従い、コマンド内のPythonインタプリタパスを置き換えてください。
コンポーネントインストールガイド
本ドキュメントでは、FASTシステムにKlipperプラグインをインストールするための一般的な方法について説明します。
一般的なインストール手順
ほとんどのKlipperプラグインは以下の簡単な手順でインストールできます:
-
/dataディレクトリにコンポーネントをダウンロードcd /data
git clone [プラグインリポジトリアドレス] -
必要なPythonファイルをKlipper拡張ディレクトリにコピー
cp /data/[プラグインディレクトリ]/[プラグインメインファイル].py /data/klipper/klippy/extras/ -
Klipperサービスを再起動して有効化
systemctl restart klipper
重要な注意事項
- ファイル選択: プラグインのドキュメントを参照し、コピーする具体的なPythonファイルを確認してください。すべての.pyファイルを無条件にコピーしないでください。
- 依存関係の確認: インストール前にプラグインに特別な依存関係があるかどうかを確認してください。
- バージョン互換性: 使用しているKlipperバージョンとプラグインバージョンが互換性があることを確認してください。
依存関係に関する説明
注意: FlyOS_FAST-V1.3.0 またはそれ以降のバージョンを使用している場合、システムには一般的な依存関係が既に内蔵されているため、通常は追加インストールは不要です。
一般的なコンポーネントインストール例
Beacon 3Dプローブ
cd /data && git clone https://github.com/beacon3d/beacon_klipper.git
cp /data/beacon_klipper/beacon.py /data/klipper/klippy/extras/
IDM または Scanner
cd /data && git clone https://gitee.com/NBTP/IDM.git
cp /data/IDM/idm.py /data/klipper/klippy/extras/
cp /data/IDM/scanner.py /data/klipper/klippy/extras/
Cartographer 3D
cd /data && git clone https://github.com/Cartographer3D/cartographer-klipper.git
cp /data/cartographer-klipper/idm.py /data/klipper/klippy/extras/
cp /data/cartographer-klipper/scanner.py /data/klipper/klippy/extras/
cp /data/cartographer-klipper/cartographer.py /data/klipper/klippy/extras/
注意事項
- インストール場所: すべてのカスタムコンポーネントは
/dataディレクトリに統一してインストールしてください。 - ファイル確認: コピーする前にファイルの用途を確認し、重要なファイルを誤って上書きしないようにしてください。
- サービス再起動: インストール完了後、Klipperサービスを再起動して効力を発揮させます。
- 問題のトラブルシューティング: インストール後に異常が発生した場合は、コピーしたファイルが正しいかを確認してください。
よくある質問
1. ブラウザで fly-tools (ポート 9999) にアクセスできない場合はどうすればいいですか？
- FAST システムは高度に統合されたコア実行環境であり、デフォルトでは
fly-toolsウェブツールはプリインストールされておらず、そのため 9999 ポートにはサービスが応答しません。これは正常な設計です。
2. ⚠️ 重要: システムコンポーネント更新に関する説明
- FAST システム内の Klipper、Moonraker などはすべてカスタムバージョンであり、コミュニティ公式バージョンとは異なります。
- 【重要な原則】コマンドラインやその他の非公式ルートからの手動更新は行わないでください。さもなければシステムの最適化が破壊され、互換性の問題や機能障害が発生します。
- 【正しい方法】すべてのコンポーネントの更新は次の公式手段で行う必要があります:
- システムに内蔵されている OTA オンライン更新 機能を使用。
- または、最新版のシステムイメージ を再書き込みしてください。
3. OTA 更新時に注意すべき点は？
1. 設定ファイルの安全性
- OTA 更新は特別に設計されており、ユーザーの個人設定ファイルを上書きまたは変更することはありません。
2. 更新中の注意点
- 更新中はデバイスへの安定した電源供給を確保してください。
- 意図しない電源遮断により更新が失敗する場合があり、深刻な場合はシステムを再書き込みする必要があります。
3. カスタムコードの処理
- Klipper設定ファイルを変更したり、カスタムプラグインをインストールしている場合、
- OTA 更新時に該当ファイルは自動的にスキップされ、ユーザーの変更が保持されます。
4. 重要な注意: ファームウェア更新
- OTA 更新を実行した後は、必ず手動でklipperファームウェアをコンパイルし、下位コンピュータのファームウェアを再書き込みしてください。
Loading...