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: No such file or directory
解決策: 上表に従って、コマンド内のPythonインタープリタのパスを置き換えてください。
コンポーネントインストールガイド
このドキュメントでは、FASTシステムにKlipperプラグインをインストールする一般的な方法を説明します。
一般的なインストール手順
ほとんどのKlipperプラグインは、以下の簡単な手順でインストールできます。
-
コンポーネントを
/dataディレクトリにダウンロードcd /datagit clone [プラグインリポジトリURL] -
必要な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...