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.

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

Система сохраняет /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	Перезагрузите весь управляющий компьютер
Исходный код плагина или символические ссылки	Перезапустите соответствующую службу согласно инструкции к плагину

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

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

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

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

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