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 /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...