FLYOS-FAST システム設定ガイド
このガイドは、FLYOS-FAST のデバイスプラットフォーム、ネットワーク、印刷環境、スクリーン、カメラ、CAN 通信を設定するためのものです。H3、H5、H618 のシステムサービスは使用方法が似ていますが、ハードウェア関連のオプションはプラットフォーム間でのコピーができません。
設定前の確認
開始する前に、以下の情報を確認してください:
| 項目 | 確認する内容 |
|---|---|
| システムイメージ | イメージプラットフォームがデバイスチップと一致している:H3、H5 または H618 |
| デバイスモデル | 正しい board を選択するため |
| 印刷環境 | Klipper を使用するか RRF を使用するか |
| ローカル表示 | スクリーンなし、HDMI、FLY-TFT、KlipperScreen、FLY Screen またはシリアルスクリーン |
| カメラ | 無効、Crowsnest、または FLYOS-FAST v1.4.0 ベータ版の GoCam |
| CAN レート | マザーボード、ツールボード、システムが統一して 1000000、500000 または 250000 |
board を設定board はシリアルポート、SPI、スクリーン、オンボード MCU などのハードウェア設定に影響します。誤った選択は、インターフェースの使用不可、スクリーン異常、初回起動時のファームウェア処理エラーを引き起こす可能性があります。完全な設定をコピーしてからデバイス名を変更するのではなく、現在のイメージの元の config.txt から項目ごとに設定を開始してください。
推奨される設定順序
- デバイスに一致するシステムイメージと
boardを選択します。 - Wi-Fi、タイムゾーン、プリンター名を設定します。
printer=klipperまたはprinter=rrfを選択します。- 実際のスクリーンタイプとスクリーン UI を選択します。
- 必要に応じてカメラまたは Moon2UART を有効にし、項目ごとにテストします。
- CAN を使用する場合は、すべてのデバイスのレートを統一して設定します。
- 保存後に再起動し、サービスとハードウェアインターフェースを項目ごとに確認します。
設定方法の選択
- Config Myprint
- 設定ファイルを直接編集
Config Myprintを使用したシステムカードの設定
Config Myprintは、初回起動前にシステムカードをグラフィカルに設定するのに適しています。書き込み済みのシステムカードをコンピューターに接続し、ソフトウェアを開いてFlyOS-Confパーティションが認識されるのを待ちます。
ソフトウェアで利用可能なオプションは、テストイメージの更新より遅れる場合があります。書き込み完了後、FlyOS-Conf/config.txtを開き、board、スクリーン、カメラ、CANレートが実際のデバイスと一致しているか確認してください。ソフトウェアに表示されない新しい設定項目は手動で追加し、類似した名前で代用しないでください。
ステップ1:システム設定を有効化
システム設定の有効化スイッチをオンにします。
ステップ2:基本設定を完了
設定ファイル管理
- プリンター設定ファイルを保存するフォルダーのみを選択し、個別のファイルは選択しないでください。
- ソフトウェアは選択したフォルダー内の設定をシステムカードにコピーし、初回起動時にロードします。
- 書き込み前に、フォルダー内に他のプリンターの
printer.cfgや重複した設定がないことを確認してください。
Wi-Fiネットワーク
利用可能なWi-Fi名とパスワードを入力します。有線ネットワークを使用する場合や、後でWi-Fiを設定する場合は空白のままにできます。
Klipperウェブインターフェース
FluiddまたはMainsailを選択します。このオプションはKlipperモードでデフォルト使用されるウェブインターフェースにのみ影響します。
ローカルディスプレイ
実際に接続されているディスプレイインターフェースを選択し、KlipperScreenまたはFLY Screenを有効にするか決定します。両方が同時に有効な場合、システムはKlipperScreenを優先的に起動します。FLY Screenを使用する場合はKlipperScreenを無効にしてください。
ステップ3:詳細設定を完了
プリンター名
識別しやすいプリンター名を設定します。英字、数字、ハイフン、アンダースコアのみを使用することをお勧めします。
カメラサービス
必要に応じてCrowsnestを有効にします。v1.4.0テスト版イメージでGoCamを使用する場合は、書き込み完了後にconfig.txtでcrowsnest=0、gocam=1であることを確認してください。両方のサービスを同時に有効にしないでください。
言語とタイムゾーン
システムの初期言語と実際のタイムゾーンを選択します。システムがネットワークに接続されると、このタイムゾーンに基づいて時間が表示されます。
CAN通信レート
マザーボードおよびすべてのCANツールボードのファームウェアと一致するレートを選択します。一般的な値は1000000、500000、250000で、同じCANバスで異なるレートを混在させることはできません。
ステップ4:書き込みと確認
すべての設定が完了したら、手動で設定を書き込むをクリックします。インターフェースでオプションを選択しただけで書き込みをクリックしない場合、設定はシステムカードに保存されません。
書き込み完了後、以下の確認を実行します:
FlyOS-Conf/config.txtを開きます。boardが実際のデバイスと完全に一致していることを確認します。- 必要な画面UIとカメラサービスのみが有効になっていることを確認します。
canbus_bitrateがすべてのCANデバイスのファームウェアと一致していることを確認します。- 保存後、システムカードを安全に取り出し、ターゲットデバイスに挿入して起動します。
設定ファイルの修正
FLYOS-FAST のシステム設定ファイルは、場所によって異なる名前で表示されますが、実際には同じ設定を指しています:
| 使用場面 | ファイルの場所 | 適用状況 |
|---|---|---|
| システムカードをPCに接続 | FlyOS-Conf/config.txt | 初回起動前にネットワーク、デバイスモデル、初期化オプションを設定 |
| Linuxシステム内部 | /config/config.txt | SSHで設定を確認 |
| Fluidd / Mainsail | .flyos-config/sys-config.conf | システム起動後にオンラインで毎回起動時に読み込まれるオプションを変更 |
- 元の設定ファイルを先にバックアップしてください。
key=value形式を維持し、key: valueに変更しないでください。- 同じ名前の設定項目を重複して追加しないでください。変更が必要な場合は元の値を直接編集してください。
- ブラウザのWebページ翻訳機能を使用して設定を編集しないでください。設定内容が書き換えられるのを防ぐためです。
- 名前とパスはできるだけ英字、数字、ハイフン、アンダースコアのみを使用してください。
######### PLEASE DO NOT EDIT THE FOLLOWING #########の後の内容は変更しないでください。
- 初回起動前にシステムカードを変更
- システム起動後にWebページで変更
- イメージ書き込み完了後、システムカードをPCに再接続します。
FlyOS-Confというリムーバブルディスクを開きます。- プレーンテキストエディタで
config.txtを開きます。 - 実際のデバイスに応じて
boardを変更し、Wi-Fi、印刷モード、スクリーン、CANレートを設定します。 - ファイルを保存し、システムカードを安全に取り出してからデバイスに挿入して起動します。
language、printer_name、firmware などの初期化項目はここで変更してください。システムが初回起動を完了した後にこれらの値を編集しても、初期化プロセスは再実行されません。
- PCと上位機が同じネットワークに接続されていることを確認します。
- ブラウザでデバイスのIPアドレスを開きます(例:
http://192.168.1.2/)。 - Fluiddで「隠しファイルとフォルダーをフィルタリング」のチェックを外すか、Mainsailで「隠しファイルを表示」にチェックを入れます。
Loading... | Loading... |
.flyos-configフォルダー内のsys-config.confを開きます。
- 必要な設定項目を変更して保存します。
- 上位機を完全に再起動し、システムサービスとハードウェア設定を再読み込みします。
Webページ方式は、毎回起動時に読み込まれる設定の変更に適しています。初回起動をすでに逃した初期化項目は、再起動だけでは再実行できません。各機能の専用の変更方法を使用してください。
保存後の確認
再起動後、少なくとも以下の項目を確認してください:
- Webページが正常に開き、印刷モードとWebページのインターフェース選択が正しいこと。
- ローカルスクリーン、タッチ方向、スクリーンUIが正常であること。
- カメラ、Moon2UARTなどのオプションサービスが、必要な1つのみ起動していること。
- CANを使用する場合、システムレートがマザーボード、ツールボードのファームウェアレートと完全に一致していること。
- KlipperまたはRRFが対応するコントロールボードに正常に接続できること。
変更後にシステムが正常に起動しない場合は、システムカードをPCに接続し、変更前の config.txt に戻してから、項目ごとに変更と検証を行ってください。
プラットフォーム別の設定項目
- H618:C5 / C8P / Pi V3
- H3 / H5 デバイス
H618 設定項目
以下のデフォルト値と選択可能な値は、H618 v1.3.10 正式イメージ内の FlyOS-Conf/config.txt に基づいて確認済みです。v1.4.0 テストイメージで新規追加された設定は個別に注記します。
ワイヤレスネットワーク
WIFI_SSID と WIFI_PASS は起動のたびに読み込まれます。オープンネットワークを使用する場合、パスワードは空欄のままでかまいません。暗号化ネットワークを使用する場合は、両方の項目を入力してください。
| 設定項目 | デフォルト値 | 選択可能な値 | 説明 |
|---|---|---|---|
WIFI_SSID | 空 | Wi-Fi 名 | 入力すると、システム起動時に自動的にこのネットワークに接続します |
WIFI_PASS | 空 | Wi-Fi パスワード | オープンネットワークの場合は空欄でかまいません |
初回起動設定
language、printer_name、firmware は、完全イメージ書き込み後の初回起動フローでのみ使用されます。システムの初回起動が完了した後、これらの項目を変更しても初期化は再実行されません。
| 設定項目 | デフォルト値 | 選択可能な値 | 説明 |
|---|---|---|---|
language | zh-CN | zh-CN、en、ja、ko など、イメージに記載されている言語コード | Fluidd と Mainsail の初期言語を設定します |
printer_name | 空 | 特殊文字を含まない任意の名前 | 初期プリンター名を設定します |
firmware | /usr/lib/firmware/klipper/stm32h723-128k-usb.bin | イメージ内のファームウェアパス、または /config/klipper.bin | C5、C5 V1.1、C8P は初回起動時に board に基づいてオンボード MCU を自動書き込みできます。Pi V3 はこの項目で外部マザーボードを書き込みません |
自動書き込みは、初回起動マーカーが存在し、board と firmware が両方とも有効で、ファームウェアファイルが存在する場合にのみ実行されます。再書き込みのために手動で初回起動マーカーを作成しないでください。その後のファームウェアメンテナンスは、対応するマザーボードのファームウェア書き込みチュートリアルを使用してください。
システムとマザーボード
以下の設定は起動のたびに読み込まれます。
| 設定項目 | デフォルト値 | 選択可能な値 | 説明 |
|---|---|---|---|
board | none | fly-c5、fly-c5-v1.1、fly-c8p、fly-pi-v3 | 実際のデバイスモデルを選択します。この値は H618 のシリアルポートと SPI ペリフェラル設定に影響します |
localtime | Asia/Shanghai | 世界のタイムゾーン名 | ネットワーク時刻同期後に使用されるシステムタイムゾーン |
printer | klipper | klipper、rrf | 起動するプリント制御環境を選択します |
console | serial | serial、both | システムコンソールを設定します。明確な要件がない限りデフォルトを維持してください |
canbus_bitrate | 1000000 | 1000000、500000、250000 | システム CAN インターフェースのレートを設定します。バス上のすべての CAN デバイスと一致している必要があります |
board の正しい選択イメージの元の設定は board=none で、デバイスはまずハードウェア識別結果の読み取りを試みます。それでも識別できない場合、H618 v1.3.10 は fly-c5 にフォールバックします。そのため、C8P、C5 V1.1、Pi V3 ユーザーは初回起動前に自分のデバイスモデルを明確に選択し、フォールバック値に依存しないでください。
異なる board 値で有効になる H618 ペリフェラルは以下のとおりです。この表は誤った選択の影響を説明するためだけのものであり、これらのシリアルポートや SPI インターフェースを他の用途に自由に変更できることを意味するものではありません。
board 設定値 | システムで有効になるオンボードペリフェラル |
|---|---|
fly-c5 | UART1 |
fly-c5-v1.1 | UART1、SPI1.2 |
fly-c8p | UART1、UART3、UART4、SPI1.2 |
fly-pi-v3 | UART1、UART3、UART4、SPI1.2 |
スクリーンとインターフェース
| 設定項目 | デフォルト値 | 選択可能な値 | 説明 |
|---|---|---|---|
screen | hdmi | none、hdmi、fly-tft-v2-r、fly-tft-v2-c | 表示インターフェースを選択します。none はローカル表示出力を無効にします |
rotate | auto | auto、0、90、180、270 | auto の場合、HDMI はデフォルトで 0 度、FLY-TFT はデフォルトで 90 度です。HDMI 表示とタッチ方向にも手動角度が適用されます |
klipper_screen | 0 | 0、1 | Klipper モードで KlipperScreen を有効にします |
fly_screen | 0 | 0、1 | Klipper モードで FLY Screen を有効にします |
moon2uart | 0 | 0、1 | Moon2UART シリアルスクリーンサービスを有効にします |
m2u_port | /dev/ttyS1 | 実際のシリアルデバイスパス | Moon2UART が使用するシリアルポート |
m2u_baud | 115200 | スクリーンが必要とするボーレート | Moon2UART シリアル通信レート |
klipper_screen=1 と fly_screen=1 が同時に設定されている場合、システムは KlipperScreen を優先して起動します。FLY Screen を使用する場合は、klipper_screen=0、fly_screen=1 を設定してください。
旧バージョンから OTA アップグレードした後、config.txt に fly_screen、m2u_port、m2u_baud が含まれていない場合があります。対応する機能が必要な場合は、上表を参照して設定項目を追加してください。
Klipper ウェブインターフェースとカメラ
| 設定項目 | デフォルト値 | 選択可能な値 | 説明 |
|---|---|---|---|
klipper_webui | fluidd | fluidd、mainsail | Klipper モードで使用するウェブインターフェース |
crowsnest | 0 | 0、1 | カメラサービスを有効または無効にします |
| 設定項目 | デフォルト値 | 選択可能な値 | 説明 |
|---|---|---|---|
gocam | 0 | 0、1 | GoCam UVC カメラサービスを有効にします |
v1.3.10 正式版には gocam はありません。v1.4.0 テスト版で crowsnest=1 と gocam=1 が同時に設定されている場合、システムは Crowsnest を優先して起動します。GoCam を使用する場合は、crowsnest=0、gocam=1 を明確に設定してください。
GoCam の使用方法: GoCam カメラサービスを参照
停電シャットダウン
H618 v1.3.10 の元の設定では、shutdown_pin_state と shutdown_pin はデフォルトでコメントアウトされており、停電シャットダウン検出は有効になっていません。製品やハードウェアバージョンによってトリガーレベルが異なる場合があります。対応する製品の「停電シャットダウンと停電再開印刷」ドキュメントに従って入力し、他のデバイスの値を直接コピーしないでください。
停電シャットダウンと停電再開印刷は同時に有効にできません。停電再開印刷が必要な場合は、停電シャットダウン検出をオフのままにしてください。
詳細設定
| 設定項目 | デフォルト値 | 選択可能な値 | 説明 |
|---|---|---|---|
spidev | spidev0.0 | 製品ドキュメントで明確に指定された SPI デバイスの組み合わせ | Linux ユーザー空間に提供する SPI デバイスを制御します |
spidev、overlays などの項目は、基盤となるハードウェアの有効化に使用されます。製品チュートリアルで明確な要求がない限り、イメージのデフォルト値を維持し、######### PLEASE DO NOT EDIT THE FOLLOWING ######### 以降の内容を変更しないでください。
H3/H5設定項目
以下の設定は、H3、H5 v1.3.10正式イメージ内の FlyOS-Conf/config.txt に照合して確認済みです。両プラットフォームのサービス設定はほぼ同じですが、board、画面モデル、および基盤ハードウェアオプションは混用できません。
ワイヤレスネットワーク
| 設定項目 | デフォルト値 | 選択可能な値 | 説明 |
|---|---|---|---|
WIFI_SSID | 空 | Wi-Fi名 | 入力後、システム起動時にそのネットワークへの接続を試みます |
WIFI_PASS | 空 | Wi-Fiパスワード | オープンネットワークの場合は空のままにできます |
これらの2項目は起動のたびに読み込まれます。名前やパスワードにスペースや特殊文字が含まれる場合は、イメージ内の二重引用符形式を維持してください。
初回起動設定
| 設定項目 | デフォルト値 | 選択可能な値 | 説明 |
|---|---|---|---|
language | zh-CN | イメージに記載された言語コード | FluiddとMainsailの初期言語を設定します |
printer_name | 空 | 特殊文字を含まない名前 | 初期プリンター名を設定します |
firmware | デフォルトでは無効 | 製品ドキュメントで指定されたファームウェアパス | 対応製品が初回起動時の書き込みを明確にサポートする場合のみ使用します |
language、printer_name、firmware は、完全イメージ書き込み後の初回起動フローでのみ使用されます。firmware のコメントを自分で解除したり、他の製品のファームウェアパスをコピーしたりしないでください。
デバイスプラットフォームと board
| イメージプラットフォーム | デバイス | board 設定値 |
|---|---|---|
| H5 | FLY-Pi | fly-pi |
| H5 | FLY-Pi V2 | fly-pi-v2 |
| H5 | FLY-Gemini V1 | fly-gemini-v1 |
| H5 | FLY-Gemini V2 | fly-gemini-v2 |
| H5 | FLY-Gemini V3 | fly-gemini-v3 |
| H5 | FLY-C8 | fly-c8 |
| H3 | FLY-Lite2 | fly-lite2 |
| H3 | FLY-Lite2.1 | fly-lite2.1 |
| H3 | FLY-MiniPad | fly-minipad |
H5イメージはH3の board を使用できず、H3イメージもH5の board を使用できません。起動スクリプトは現在のプラットフォームに属さないデバイス値を拒否します。初回起動前に実際のデバイスを明確に入力し、イメージのデフォルト値に依存しないでください。
H5 v1.3.10イメージの元のデフォルト値は board=fly-pi-v2、H3 v1.3.10イメージの元のデフォルト値は board=fly-lite2.1 です。実際のデバイスがこれらのモデルに正確に対応する場合のみ、デフォルト値を保持できます。
システムと通信
| 設定項目 | デフォルト値 | 選択可能な値 | 説明 |
|---|---|---|---|
localtime | Asia/Shanghai | 世界のタイムゾーン名 | ネットワーク時刻同期後に使用するシステムタイムゾーン |
console | serial | serial、both | システムコンソールモード。明確な必要性がない限りデフォルトを維持します |
printer | klipper | klipper、rrf | KlipperまたはRRFプリント環境の起動を選択します |
canbus_bitrate | 1000000 | 1000000、500000、250000 | システムCANレート。バス上のすべてのデバイスと一致している必要があります |
画面タイプ
| イメージプラットフォーム | screen 選択可能な値 |
|---|---|
| H5 | none、hdmi、fly-tft-v1、fly-tft-v2-r、fly-tft-v2-c |
| H3 | none、hdmi、fly-tft-v1、fly-minipad-r、fly-minipad-c、fly-tft-v2-r、fly-tft-v2-c |
| 設定項目 | デフォルト値 | 選択可能な値 | 説明 |
|---|---|---|---|
screen | hdmi | 上表で現在のプラットフォームがサポートする値 | 表示インターフェースを選択します。none はローカル表示出力を無効にします |
rotate | auto | auto、0、90、180、270 | auto の場合、HDMIはデフォルトで 0 度、TFTはデフォルトで 90 度を使用します |
klipper_screen | 0 | 0、1 | KlipperモードでKlipperScreenを有効にします |
fly_screen | 0 | 0、1 | KlipperモードでFLY Screenを有効にします |
moon2uart | 0 | 0、1 | Moon2UARTシリアル画面サービスを有効にします |
m2u_port | /dev/ttyS1 | 製品ドキュメントで指定されたシリアルパス | Moon2UARTが使用するシリアルポート |
m2u_baud | 115200 | 画面が必要とするボーレート | Moon2UARTシリアルレート |
klipper_screen=1 と fly_screen=1 が同時に設定された場合、システムはKlipperScreenを優先して起動します。画面モデル、インターフェース方向、シリアルパスは対応する製品ドキュメントに従ってください。
Webインターフェースとカメラ
| 設定項目 | デフォルト値 | 選択可能な値 | 説明 |
|---|---|---|---|
klipper_webui | fluidd | fluidd、mainsail | Klipperモードでデフォルトで使用するWebインターフェース |
crowsnest | 0 | 0、1 | Crowsnestカメラサービスの有効/無効を切り替えます |
H3、H5 v1.3.10正式イメージには gocam 設定項目はありません。v1.4.0テスト版イメージの設定をそのまま流用しないでください。
電源断シャットダウンと詳細設定
shutdown_pin_state、shutdown_pin、spidev、overlays は、特定のデバイスハードウェアに関連します。対応する製品ドキュメントで明確な値が示されている場合のみ変更でき、他のマザーボード、他のハードウェアバージョン、または他のチッププラットフォームの設定をコピーしないでください。
電源断シャットダウンと電源断後の印刷再開は同時に有効にできません。電源断後の印刷再開が必要な場合は、対応する製品チュートリアルに従って電源断シャットダウン検出を無効にしてください。
よく使う機能の組み合わせ
| 目的 | 主要な設定 | 注意事項 |
|---|---|---|
| ウェブのみ使用、ローカルスクリーンなし | screen=none、klipper_screen=0、fly_screen=0 | Moon2UART シリアルスクリーンは必要に応じて個別に有効化可能 |
| HDMI + KlipperScreen | screen=hdmi、klipper_screen=1、fly_screen=0 | rotate で表示とタッチ方向を設定 |
| FLY Screen を使用 | klipper_screen=0、fly_screen=1 | screen は実際の表示インターフェースを選択する必要があります |
| Crowsnest を使用 | crowsnest=1 | v1.4.0 ベータ版では gocam=0 を維持してください |
| GoCam を使用 | crowsnest=0、gocam=1 | v1.4.0 ベータ版イメージのみ対象;チュートリアルを見る |
| Moon2UART を使用 | moon2uart=1 | m2u_port と m2u_baud も同時に確認 |
| CAN を使用 | 統一された canbus_bitrate を設定 | システム、マザーボード、すべての CAN ノードで一致させる必要があります |
再起動後の完了チェック
| チェック項目 | 正常な結果 |
|---|---|
| ネットワーク | デバイス IP、local.klipper.cn、または直接接続アドレスでウェブページを開ける |
| デバイスプラットフォーム | シリアルポート、SPI、オンボード機能が実際の製品と一致している |
| 印刷サービス | Klipper または RRF の選択した環境のみが起動する |
| スクリーン | 表示、タッチ、回転方向が正常 |
| カメラ | Crowsnest または GoCam の選択した一方のみが動作する |
| CAN | すべてのノードが照会可能で、レート不一致のエラーがない |
一度に変更するのは関連する設定グループのみにしてください。異常が発生した場合は、まずそのグループの設定を元に戻してください。board、スクリーン、CAN、高度なハードウェアパラメータを同時に変更すると、問題の発生源を特定できない可能性があります。