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.

Плагины и среда 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, учётные данные облачных сервисов, токены и другую конфиденциальную информацию.

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

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

Журнал	Путь
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, учётные данные облачных служб, токены и другую конфиденциальную информацию.