FLYOS-FAST システム設定ガイド
本ガイドは、FLYOS-FASTのデバイスプラットフォーム、ネットワーク、印刷環境、スクリーン、カメラ、CAN通信を設定するためのものです。H3、H5、H618のシステムサービスは使い方が似ていますが、ハードウェア関連のオプションはプラットフォーム間でコピーすることはできません。
設定前の確認
開始する前に以下の情報を確認してください:
| 項目 | 確認が必要な内容 |
|---|---|
| システムイメージ | イメージプラットフォームがデバイスチップと一致していること:H3、H5 または H618 |
| デバイスモデル | 正しい board を選択するために使用 |
| 印刷環境 | Klipper または RRF のどちらを使用するか |
| ローカルディスプレイ | 画面なし、HDMI、FLY-TFT、USBスクリーン、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 Web インターフェース
Fluidd または Mainsail を選択します。このオプションは、Klipper モードでデフォルトで使用される Web インターフェースにのみ影響します。
ローカルディスプレイ
実際に接続されているディスプレイインターフェースを選択し、KlipperScreen または FLY Screen を有効にするか決定します。両方を同時に有効にした場合、システムは KlipperScreen を優先して起動します。FLY Screen を使用する場合は KlipperScreen をオフにしてください。
ステップ3:詳細設定を完了する
プリンター名
識別しやすいプリンター名を設定します。英字、数字、ハイフン、アンダースコアのみを使用することを推奨します。
カメラサービス
必要に応じて Crowsnest を有効にします。v1.4.0 で GoCam を使用する場合は、書き込み完了後に config.txt で crowsnest=0、gocam=1 になっていることを確認してください。2つのサービスを同時に有効にしないでください。
言語とタイムゾーン
システムの初期言語と実際のタイムゾーンを選択します。システムがネットワークに接続されると、そのタイムゾーンに基づいて時刻が表示されます。
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 Web UI とカメラ
| 設定項目 | デフォルト値 | 選択可能な値 | 説明 |
|---|---|---|---|
klipper_webui | fluidd | fluidd、mainsail | Klipper モードで使用する Web インターフェース |
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 を優先して起動します。スクリーン型番、インターフェース方向、シリアルパスは対応する製品ドキュメントに従ってください。
ウェブとカメラ
| 設定項目 | デフォルト値 | 選択可能な値 | 説明 |
|---|---|---|---|
klipper_webui | fluidd | fluidd、mainsail | Klipper モードでデフォルト使用するウェブインターフェース |
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 は実際の表示インターフェースを選択する必要がある |
| USB スクリーンを使用 | klipper_screen=1、fly_screen=0 または fly_screen=1、klipper_screen=0 | screen= の設定は不要;v1.4.0 以上のシステムが必要 |
| 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または直接接続アドレスを使用してアクセスできます 10.10.10.1 ウェブページを開く |
| デバイスプラットフォーム | シリアルポート、SPIおよびオンボード機能は実際の製品と一致します |
| 印刷サービス | KlipperまたはRRFは選択した環境のみを起動 |
| 画面 | 表示、タッチおよび回転方向が正常です |
| カメラ | Crowsnest または GoCam のいずれか1つだけを実行 |
| CAN | すべてのノードが照会可能であり、レート不一致のエラーがないこと。 |
一度に関連するオプションのグループだけを変更します。異常が発生した場合は、まずそのグループの設定を復元し、同時に変更しないでください。 board、画面、CANおよび高度なハードウェアパラメータを、問題の原因を判断できなくならないように。