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