Перейти к основному содержанию

Руководство по использованию функции печати с USB-накопителя

FLYOS-FAST автоматически монтирует USB-накопитель, что позволяет просматривать и печатать находящиеся на нём G-code файлы через веб-файловый менеджер или на экране самого устройства. Данная статья проверена на образах v1.3.10 для H3, H5, H618 и на образе v1.4.0 для H618.

Принцип работы​

Раздел USB-накопителя монтируется как папка, начинающаяся с U_, в каталог G-code. При начале печати система сначала копирует полный файл локально:

/usr/share/printer_data/gcodes/.UDISK/tmp.gcode

После завершения копирования Klipper выполняет печать из этого временного файла; при следующей печати с USB-накопителя он будет перезаписан.

Дождитесь завершения копирования, прежде чем извлекать USB-накопитель

Отображение «Печать» на веб-странице не означает, что файл уже скопирован. Дождитесь появления в консоли сообщения 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 3.0. Подключайте USB-накопитель к порту USB 2.0 и не используйте USB-накопители стандарта USB 3.0; при использовании 3.0 скорость передачи становится очень низкой, а время ожидания копирования заметно увеличивается.

Скрытые расширения в Windows

В проводнике включите отображение расширений файлов и убедитесь, что расширение действительно .gcode, .g или .gco, чтобы избежать появления модель.gcode.txt.

Порядок действий​

  1. Скопируйте G-code, созданный слайсером, на USB-накопитель.
  2. Вставьте USB-накопитель в USB-порт хост-компьютера.
  3. Откройте список файлов в Fluidd, Mainsail или на экране устройства и найдите папку, начинающуюся с U_; если она не появилась сразу, обновите список.
  4. Войдите в эту папку, выберите файл G-code, проверьте информацию предпросмотра и нажмите «Начать печать» только один раз.
  5. Дождитесь сообщения консоли о завершении копирования — после этого система автоматически начнёт печать.

Во время копирования не нажимайте «Начать печать» повторно и не выбирайте второй файл с USB-накопителя: все задания печати с USB используют один и тот же tmp.gcode, и при одновременном копировании они перезапишут друг друга.

Извлечение накопителя и ограничения​

  • После подтверждения завершения копирования можно извлечь USB-накопитель; печать продолжит чтение локальных временных файлов. Не извлекайте, пока в консоли отображается Copying file.
  • Не извлекайте накопитель, если индикатор прогресса копирования полностью отсутствует: некоторые корпуса USB-жёстких дисков или SSD могут не распознаваться как съёмные устройства, и Klipper будет читать внешние файлы напрямую.
  • Если веб-интерфейс выполняет загрузку, удаление или переименование на USB-накопителе, дождитесь завершения операции, прежде чем извлекать его.
  • USB-накопитель без таблицы разделов может не отображаться; можно заново разметить и отформатировать его. Два USB-накопителя с полностью идентичными производителем, моделью, ёмкостью и структурой разделов могут быть смонтированы в один каталог и конфликтовать.
  • Автоматическое распознавание охватывает только типичные разделы с однозначным номером (например, /dev/sda1); специальные устройства с несколькими разделами могут монтироваться не полностью.
  • Чем больше файл, тем дольше ожидание копирования перед началом печати, и это зависит от оставшегося локального пространства на хост-компьютере.

Часто задаваемые вопросы​

Файл виден, но печать не начинается​

Убедитесь, что расширение — .gcode, .g или .gco, и файл корректно отображается в слайсере; проверьте свободное место:

df -h /usr/share/printer_data/gcodes

Затем просмотрите ошибки копирования или открытия в журнале Klipper:

tail -n 100 /usr/share/printer_data/logs/klippy.log

Загрузка через веб-интерфейс работает, а с USB-накопителя — нет​

Некоторые слайсеры сохраняют китайские комментарии в кодировке GBK или ANSI, а файл с USB-накопителя сначала копируется в .UDISK/tmp.gcode и затем строго читается как UTF-8; при встрече байтов, не являющихся UTF-8, может возникнуть ошибка:

UnicodeDecodeError: 'utf-8' codec can't decode byte

Китайское имя файла обычно не является причиной; переименование в английское также не изменит внутреннюю кодировку файла. Выполните одно из следующих действий:

  1. Повторно экспортируйте в слайсере, установив кодировку UTF-8.
  2. Сохраните весь файл в UTF-8 с помощью редактора, поддерживающего преобразование кодировок; не меняйте только расширение.
  3. Если выбор кодировки недоступен, удалите не-UTF-8 китайские комментарии в начале файла и сохраните; не изменяйте команды движения, температуры и экструзии.
  4. В качестве временного решения загрузите файл через веб-интерфейс в локальный каталог G-code, а затем запустите печать.

После неудачного копирования постоянно отображается «Печать»​

Убедитесь, что принтер не выполняет нагрев или движение, затем перезапустите Klipper:

systemctl restart klipper

Повторно вставьте USB-накопитель и попробуйте снова; если проблема повторяется, замените USB-накопитель и предоставьте технической поддержке следующие два журнала:

/var/log/flyos-auto-mount.log
/usr/share/printer_data/logs/klippy.log
Loading...