FLYOS-FAST Частые вопросы и устранение неполадок

На этой странице собраны сведения об ограничениях системы FLYOS-FAST, путях к конфигурационным файлам, способах обновления и типовых неисправностях. Полные пошаговые инструкции по конкретным функциям приведены в соответствующих документах по ссылкам, чтобы избежать дублирования информации в FAQ.

Рекомендуемый порядок поиска неисправностей

1. Записывайте полный текст ошибки с веб-страницы или из терминала, а не только последнюю строку.
2. Определите, какие конфигурации, плагины или системные параметры были изменены перед возникновением проблемы.
3. Проверьте дисковое пространство, состояние служб и соответствующие журналы.
4. Перед перезапуском служб или управляющего компьютера убедитесь, что принтер не выполняет печать, нагрев или перемещение.

Система и учетная запись

Почему можно использовать только пользователя root?

FLYOS-FAST — это облегченная система, предназначенная для устройств управления печатью. Она использует однопользовательский режим управления, и root является единственной интерактивной учетной записью администратора. Система не поддерживает создание других пользователей или переключение на них.

Почему нельзя использовать apt или dpkg?

FLYOS-FAST не предоставляет среду управления пакетами, характерную для традиционных дистрибутивов Linux, поэтому для установки или обновления программного обеспечения нельзя использовать следующие команды:

apt update
apt install
dpkg -i

Не копируйте пакеты программного обеспечения или системные библиотеки из других систем Linux. Дополнительные зависимости должны быть явно указаны в инструкциях по установке плагинов; при отсутствии общих зависимостей сообщите об этом в службу технической поддержки.

Почему системные каталоги отображаются как доступные только для чтения?

Основная система использует файловую систему только для чтения и обновляется целиком через полный образ или OTA. Не пытайтесь перемонтировать корневой каталог и напрямую изменять системные файлы, так как это может привести к сбою обновления или потере изменений после перезагрузки.

Пользовательские конфигурации, плагины и данные печати должны храниться в постоянных каталогах.

Файлы и конфигурация

Где хранятся часто используемые файлы?

Содержимое	Путь в режиме Klipper	Описание
Конфигурация принтера	/usr/share/printer_data/config/	Содержит printer.cfg, конфигурацию Moonraker и камеры
G-code файлы	/usr/share/printer_data/gcodes/	Точка входа для файлов, загруженных через веб-интерфейс и печати с USB-накопителя
Журналы работы	/usr/share/printer_data/logs/	Журналы Klipper, Moonraker, экрана и камеры
Плагины и исходный код	/data/	Пользовательские плагины должны размещаться здесь единообразно
Исходный код Klipper	/data/klipper/	Каталог Klipper, предустановленный в системе
Артефакты сборки	/data/klipper/out/	Выходной каталог после завершения компиляции прошивки

Каталог данных режима RRF — /opt/dsf/, не смешивайте пути конфигурации Klipper и RRF.

Пути конфигурации RRF и распространённые ошибки: См. устранение неполадок в режиме RRF

Какие каталоги сохраняются постоянно?

Система сохраняет /etc, /data, /root, а также каталог данных текущего режима печати. Даже если эти каталоги сохраняются, перед выполнением OTA или повторной прошивкой необходимо отдельно создать резервную копию конфигурации принтера.

Как изменить конфигурацию системы FLYOS-FAST?

Модель системы, сеть, экран и переключатели служб единообразно управляются в FlyOS-Conf/config.txt. После запуска системы их также можно изменить через .flyos-config/sys-config.conf в веб-интерфейсе.

Метод настройки и область применения: См. руководство по настройке системы FLYOS-FAST

Почему изменения конфигурации не вступают в силу?

Для разных конфигураций требуются разные действия для применения:

Что изменено	Действие для применения
printer.cfg и фрагменты конфигурации Klipper	Выполнить Сохранить и перезапустить в веб-интерфейсе
moonraker.conf	Перезапустить Moonraker
config.txt или sys-config.conf	Перезапустить весь хост-компьютер
Исходный код плагина или символические ссылки	Перезапустить соответствующую службу согласно руководству плагина

Если после перезапуска изменения всё ещё не вступили в силу, убедитесь, что файл сохранён, конфигурационные параметры не дублируются, и проверьте журналы соответствующей службы.

Режим RRF

Что делать, если в режиме RRF DCS постоянно отключается и появляется сообщение M550 о несоответствии имени машины?

В режиме RRF возникают следующие явления:

• Веб-страница DWC постоянно показывает Connection interrupted, DCS has been stopped.
• В журнале запуска появляется Error in start-up file config.g line 3: M550: Machine name must consist of the same letters and digits as configured by the Linux hostname.
• DCS (Duet Control Server) не может нормально запуститься, веб-страница не подключается.

Причина

RRF требует, чтобы имя машины, заданное в M550 P"..." в config.g, полностью совпадало с hostname системы Linux (содержало только те же буквы и цифры). При несовпадении DCS отказывается запускаться и постоянно перезагружается с повторным подключением.

printer_name используется только при первом запуске для инициализации hostname. Если впоследствии hostname был изменён вручную без синхронного изменения config.g, или был скопирован config.g с другого устройства, возникает эта ошибка.

Шаги по поиску и устранению неисправности:

1. Подключитесь к управляющему компьютеру через SSH и проверьте текущий hostname Linux:

   hostname

2. Проверьте текущее значение M550 в конфигурационном файле RRF:

   cat /opt/dsf/sd/sys/config.g | grep M550

3. Измените M550, чтобы оно совпадало с hostname. Например, если hostname — fly-c5, следует изменить на:

   M550 P"fly-c5"

4. После сохранения файла перезапустите DCS на веб-странице DWC или напрямую перезагрузите управляющий компьютер.

Ограничение на символы в имени

Имя машины в M550 может содержать только буквы и цифры, не допускаются пробелы, символы подчёркивания, китайские иероглифы или другие специальные символы. При необходимости изменения hostname следует синхронно обновить M550 в config.g, чтобы они совпадали.

Где находятся конфигурационные файлы в режиме RRF?

Все конфигурационные файлы RRF находятся в каталоге /opt/dsf/sd/sys/, основные файлы включают:

Файл	Назначение
config.g	Основной файл конфигурации запуска, содержит M550 (имя машины) и другие ключевые настройки
board.txt	Конфигурация платы (сеть, SPI и т. д.)
deploy.d	Каталог скриптов развёртывания

G-code файлы хранятся в /opt/dsf/sd/gcodes/, файлы для печати с USB-накопителя также монтируются по этому пути. Не путайте путь конфигурации Klipper (/usr/share/printer_data/) с RRF.

Обновление системы и прошивка

Как обновлять систему?

FLYOS-FAST следует обновлять через системный OTA или путём повторной записи официального образа соответствующего устройства. Не используйте сторонние скрипты обновления системы для замены ключевых файлов.

Обновление онлайн и с USB-накопителя: Смотреть руководство по OTA-обновлению системы

Повторная запись системы: Смотреть руководство по записи системного образа

Удалит ли OTA конфигурацию принтера?

Обычное OTA сохраняет /data и каталог данных принтера, но в следующих случаях всё же могут возникнуть проблемы с конфигурацией:

• Пользователь самостоятельно заменил Klipper, Moonraker или другие предустановленные компоненты.
• Пользовательские файлы перекрыли новые файлы, предоставляемые OTA.
• Во время обновления было прервано питание.
• Перед обновлением было недостаточно места на диске или файловая система уже была повреждена.

Перед обновлением скачайте или скопируйте резервную копию printer_data/config. Поддерживайте стабильное питание во время обновления и перезагрузки, не выполняйте печать.

Можно ли обновить Klipper или Moonraker отдельно?

Не рекомендуется. Klipper, Moonraker, веб-интерфейс и служба экрана в системе адаптированы как единый набор; замена одного компонента отдельно может нарушить пути, интерфейсы расширений или механизм обновления. Используйте общий метод обновления, предоставляемый системой.

Что делать, если после OTA версии MCU не совпадают?

OTA поддерживает автоматическое обновление только USB-прошивки материнских плат FLY-C8, FLY-C5, FLY-C8P и FLY-GEMINI V3. Другие материнские платы, CAN-прошивка, платы инструментов и другие внешние MCU не поддерживают автоматическое обновление и требуют ручной прошивки согласно руководству соответствующего продукта.

Область автоматического обновления и способ проверки: Смотреть примечания по обновлению прошивки MCU после OTA

Где найти файлы после компиляции прошивки?

Результаты компиляции находятся в:

/data/klipper/out/

Фактический файл может быть klipper.bin или klipper.uf2, в зависимости от архитектуры MCU и конфигурации загрузчика.

Примечания по компиляции прошивки: Смотреть руководство по компиляции прошивки Klipper

Ограничения компиляции FLYOS-FAST: Смотреть примечания по компиляции прошивки FLYOS-FAST

Плагины и среда Python

Почему не найден ~/klippy-env/bin/python?

FLYOS-FAST использует системный Python, а не распространенное виртуальное окружение klippy-env. В командах следует заменять путь к интерпретатору Python и путь к Klipper на фактические системные пути. Например, при запросе CAN UUID используйте:

python /data/klipper/scripts/canbus_query.py can0

Не заменяйте только команду Python, сохраняя ошибочный путь ~/klipper/.

Куда следует устанавливать плагины?

Репозитории плагинов следует размещать в /data/. При добавлении файлов расширений в Klipper предпочтительно использовать символические ссылки, сначала уточните имена файлов и зависимости, требуемые инструкцией к плагину, и не копируйте весь каталог плагина в Klipper.

Правила установки и существующие руководства по плагинам: См. инструкцию по установке плагинов

Что делать, если плагин не работает после установки?

Проверьте по порядку:

1. Был ли полностью успешным этап загрузки из сети.

2. Существует ли файл плагина в /data/.

3. Указывает ли символическая ссылка на правильный файл:

   readlink -f /data/klipper/klippy/extras/файл_плагина.py

4. Загружена ли конфигурация плагина в printer.cfg.

5. Появляются ли в журнале Klipper ошибки об отсутствующих модулях, зависимостях или параметрах конфигурации.

Не удаляйте конфигурации безопасности и не отключайте защиту Klipper по температуре, концевым выключателям и нагреву, чтобы обойти ошибки.

Веб-интерфейс и сеть

Какие есть точки входа в веб-интерфейс?

Функция	Адрес	Условия использования
Fluidd или Mainsail	http://IP-адрес_устройства/	Нормальный запуск в режиме Klipper
Страница управления OTA	http://IP-адрес_устройства:9998/	Сеть управляющего компьютера работает
Страница управления GoCam	http://IP-адрес_устройства:8080/	GoCam включен

Почему не удается получить доступ к IP-адрес_устройства:9999?

FLYOS-FAST по умолчанию не предоставляет веб-сервис fly-tools, поэтому отсутствие ответа от порта 9999 является нормальным. Для настройки системы и операций с прошивкой используйте соответствующую документацию FLYOS-FAST и команды SSH.

Как проверить, если основная веб-страница недоступна?

1. Убедитесь, что компьютер и управляющий компьютер находятся в одной локальной сети.

2. Проверьте адрес устройства в маршрутизаторе, чтобы не обращаться к старому IP-адресу, который мог измениться.

3. Проверьте текущий сетевой адрес через SSH:

   ip -br addr

4. Проверьте наличие служб, которые не запустились:

   systemctl --failed --no-pager

5. Если SSH также недоступен, сначала проверьте, завершилась ли загрузка системы, затем проверьте сетевой кабель, конфигурацию Wi-Fi и питание.

Способ подключения по SSH: См. руководство по подключению к управляющему компьютеру по SSH

Печать, USB-накопитель и камера

USB-накопитель определяется, но печать не запускается. Что делать?

Проверьте файловую систему, расширение G-code, свободное место на устройстве и кодировку файла. Некоторые G-code файлы не в кодировке UTF-8 могут привести к ситуации, когда «локальная загрузка работает, но с USB-накопителя не запускается».

Печать с USB и проверка кодировки: См. руководство по использованию функции печати с USB-накопителя

Нет изображения с камеры. Что делать?

Сначала убедитесь, что камера поддерживает протокол UVC, затем проверьте, включена ли служба камеры, правильно ли указан узел устройства и поддерживает ли камера требуемое разрешение. Не запускайте одновременно две службы, использующие одну и ту же камеру.

Подключение и настройка камеры: Как подключить и использовать камеру

Что делать, если при замедленной съёмке не создаётся изображение?

Сначала напрямую откройте адрес снимка в браузере, чтобы убедиться, что одно изображение возвращается. При изменении сервиса камеры необходимо синхронно изменить snapshoturl в moonraker.conf.

Адрес снимка и проверка журналов: Функция замедленной съёмки

С чего начать диагностику после ошибки Klipper?

В первую очередь запишите исходное сообщение об ошибке, отображаемое на веб-странице, и проверьте самое первое исключение в klippy.log. Последнее сообщение о разрыве соединения или перезапуске обычно является лишь последующим явлением, а не первопричиной.

Индекс ошибок Klipper: Частые ошибки Klipper

Журналы и техническая поддержка

Где находятся основные журналы?

Журнал	Путь
Klipper	/usr/share/printer_data/logs/klippy.log
Moonraker	/usr/share/printer_data/logs/moonraker.log
KlipperScreen	/usr/share/printer_data/logs/klipperscreen.log
Crowsnest	/usr/share/printer_data/logs/crowsnest.log
GoCam	/usr/share/printer_data/logs/gocam.log
Автомонтирование USB-накопителя	/var/log/flyos-auto-mount.log

Для просмотра только последних записей можно использовать:

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

Проверка состояния основных служб:

systemctl status klipper moonraker --no-pager

Проверка системных ресурсов:

uptime
free -h
df -h

Что необходимо предоставить при обращении в техническую поддержку?

Пожалуйста, постарайтесь предоставить сразу:

• Конкретные модели управляющего компьютера и платы управления.
• Номер версии FLYOS-FAST.
• Действия или изменения, выполненные перед возникновением проблемы.
• Полный скриншот ошибки с веб-страницы.
• Полные журналы klippy.log, moonraker.log или соответствующих служб.
• Можно ли стабильно воспроизвести проблему и сохраняется ли она после перезапуска.

Не предоставляйте только последние несколько строк обрезанного журнала, иначе реальная первая ошибка может быть не видна. Перед отправкой конфигурации и журналов удалите пароли Wi-Fi, учётные данные облачных сервисов, токены и другую конфиденциальную информацию.