USBメモリ印刷機能使用ガイド
FLYOS-FASTはUSBメモリを自動的にマウントし、Webファイルマネージャまたは本体画面でその中のG-codeを閲覧して印刷できます。本文はH3、H5、H618のv1.3.10イメージおよびH618 v1.4.0イメージに基づいて確認しています。
動作原理
USB メモリのパーティションは U_ で始まるフォルダとして G-code ディレクトリにマウントされます。印刷開始時、システムはまず完全なファイルをローカルにコピーします：
/usr/share/printer_data/gcodes/.UDISK/tmp.gcode
コピー完了後、Klipper はこの一時ファイルから印刷を実行します。次回の USB メモリ印刷時に上書きされます。
Web ページに「印刷中」と表示されても、ファイルのコピーが完了したことを意味しません。コンソールに Copy files from removable disk completed が表示されるか、プリンターが加熱・動作を開始してから抜いてください。コピー中に抜くと、今回の印刷を開始できなくなります。
ファイル要件
| 項目 | 対応範囲 | 推奨 |
|---|---|---|
| ファイルシステム | FAT32、exFAT、NTFS | FAT32 または exFAT を優先 |
| ファイル形式 | .gcode、.g、.gco | .gcode を優先 |
| ファイル位置 | ルートディレクトリまたは複数階層のフォルダ | モデル別に分類して保存 |
| ファイル名 | UTF-8、スペース、中国語に対応 | 短くシンプルにし、クロスプラットフォームでの利便性を確保 |
.stl、.obj などのモデルファイルやスライスプロジェクトファイルには対応していません。先にスライスソフトで G-code をエクスポートする必要があります。
本機能は USB 3.0 に対応していません。USB メモリは USB 2.0 ポートに接続してください。USB 3.0 の USB メモリも使用しないでください。3.0 を使用すると転送速度が非常に遅くなり、コピーの待ち時間が明らかに長くなります。
エクスプローラーで ファイル拡張子 にチェックを入れ、拡張子が確実に .gcode、.g または .gco であることを確認してください。モデル.gcode.txt のような状態を避けてください。
使用手順
- スライスで生成した G-code を USB メモリにコピーします。
- USB メモリを上位機の USB ポートに挿入します。
- Fluidd、Mainsail、または本体画面のファイル一覧を開き、
U_で始まるフォルダを探します。すぐに表示されない場合は一覧を更新してください。 - そのフォルダに入り G-code ファイルを選択し、プレビュー情報を確認した後、「印刷開始」を一度だけクリックします。
- コンソールにコピー完了の通知が表示されるまで待つと、システムがその後自動的に印刷を開始します。
コピー中は「印刷開始」を繰り返しクリックしないでください。また、2つ目の USB メモリ内のファイルを選択しないでください。すべての USB メモリ印刷は同じ tmp.gcode を共有しているため、同時にコピーすると互いに上書きされます。
USBメモリの取り外しと制限事項
- コピー完了を確認してからUSBメモリを抜いてください。印刷はローカルの一時ファイルを引き続き読み込みます。コンソールにまだ
Copying fileが表示されている間は抜かないでください。 - コピー進捗の表示がまったくない場合はUSBメモリを抜かないでください：一部のUSBハードディスクケースやSSDはリムーバブルデバイスとして認識されない場合があり、Klipperは外部ファイルを直接読み込みます。
- WebページがUSBメモリに対してアップロード、削除、または名前変更を実行している場合は、操作が完了するまで待ってから抜いてください。
- パーティションテーブルのないUSBメモリは表示されない場合があります。再パーティション化してフォーマットしてください。メーカー、型番、容量、パーティション構造が完全に同一の2つのUSBメモリは、同じディレクトリにマウントされて競合する可能性があります。
- 自動認識は一般的な単一数字パーティション（例：
/dev/sda1）のみに対応しています。特殊なマルチパーティションデバイスはマウントが不完全になる場合があります。 - ファイルが大きいほど、印刷開始前のコピー待ち時間が長くなり、ホストマシンのローカル空き容量に依存します。
よくある質問
ファイルは表示されるが印刷を開始できない
拡張子が .gcode、.g または .gco であること、およびファイルがスライサーソフトで正常にプレビューできることを確認してください。ローカルの空き容量を確認します：
df -h /usr/share/printer_data/gcodes
次に、Klipper ログのコピーまたはオープンエラーを確認します：
tail -n 100 /usr/share/printer_data/logs/klippy.log
Web アップロードでは印刷できるが、USB メモリではできない
一部のスライサーソフトは中国語コメントを GBK、ANSI で保存しますが、USB メモリのファイルはまず .UDISK/tmp.gcode にコピーされてから厳密に UTF-8 で読み取られるため、非 UTF-8 バイトに遭遇するとエラーが発生する場合があります：
UnicodeDecodeError: 'utf-8' codec can't decode byte
中国語のファイル名は通常原因ではなく、英語に変更してもファイル内部のエンコーディングは変わりません。以下のいずれかの方法で対処してください：
- スライサーソフトで再エクスポートし、エンコーディングを UTF-8 に設定する。
- エンコーディング変換に対応したエディタでファイル全体を UTF-8 として保存する。拡張子だけを変更しないでください。
- エンコーディングを選択できない場合は、ファイル先頭の非 UTF-8 中国語コメントを削除してから保存してください。移動・温度・押出指令は変更しないでください。
- 一時的な方法として、まず Web からローカルの G-code ディレクトリにアップロードしてから印刷することもできます。
コピー失敗後、ずっと「印刷中」と表示される
プリンタが加熱や移動を実行していないことを確認してから、Klipper を再起動します：
systemctl restart klipper
USB メモリを挿し直して再試行してください。繰り返し発生する場合は、USB メモリを交換し、テクニカルサポートに以下の 2 つのログを提供してください：
/var/log/flyos-auto-mount.log
/usr/share/printer_data/logs/klippy.log