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. なぜ9999ポートのfly-toolsにアクセスできないのですか？
FASTシステムはコア実行環境としてデフォルトで fly-tools ウェブツールをプリインストールしていません。
2. なぜシステムはKlipperなどのコンポーネントをワンクリックで更新するウェブ機能を提供しないのですか？
- 理由: FASTシステム内にプリインストールされているKlipper、Moonrakerなどのコアコンポーネントは、すべて深く最適化され、二次開発されたカスタムバージョンであり、公式のバージョンとは異なります。
- 推奨事項:
- これらのコンポーネントをコマンドラインで手動更新しないことを強く推奨します。これにより、システムが不安定になったり、機能が異常になったり、最適化が無効になる可能性があります。
- すべてのコアコンポーネントの機能更新およびセキュリティ修正は、
OTAまたは最新のイメージを再焼込みして更新する必要があります。
Loading...