Руководство и примечания по использованию системы FAST

Характеристики системы и проектные особенности

1. Описание пользователей системы

• FAST система, стремясь к максимальной легковесности и безопасности, работает в режиме одного пользователя.
• Единственный пользователь: root
• Ограничения: система не поддерживает создание или переключение на другие учетные записи.

2. Управление пакетами

• Для обеспечения легковесности и быстрого запуска система FAST не имеет традиционных менеджеров пакетов, таких как apt, поэтому команды вроде apt update выполнять нельзя.
• Предустановленные программы: система уже содержит экосистему Klipper и часто используемые инструменты для повседневного обслуживания.
• Дополнительные пакеты: если у вас есть потребность в дополнительных пакетах программного обеспечения, пожалуйста, сообщите нам. Мы оценим их популярность и примем во внимание возможность предустановки в последующих версиях.

3. Файловая система и сохраняемость данных

• Доступные для изменения пути: чтобы обеспечить целостность ядра системы, в системе FAST разрешено изменять файлы только в каталогах /etc и /data.
• Ограничения: все другие каталоги системы доступны только для чтения, и любые изменения не будут сохранены. Пожалуйста, храните свои пользовательские настройки и данные в указанных выше двух каталогах.

4. Стратегия обновления системы

Система FAST поддерживает два способа обновления:

Онлайн-обновление через OTA (рекомендуется)

• Начиная с версии V1.3.0, система FAST поддерживает обновления по воздуху (OTA).
• Точка входа для обновления: вы можете получить доступ к странице обновления OTA, посетив порт IP-адрес основного компьютера:9998.
• Важные напоминания:
  • Перед началом обновления системы убедитесь, что все задачи печати приостановлены.
  • Во время обновления службы системы будут перезапущены, не выполняйте никаких операций печати, иначе это может привести к сбою печати или потере контроля над оборудованием.

Обновление прошивки (флеш-обновление)

• Сценарии применения: когда система не может загрузиться нормально.
• Важные предупреждения:
  • Перед прошивкой обязательно сделайте резервную копию настроек: процесс прошивки сотрет все пользовательские данные, поэтому обязательно заранее сохраните настройки принтера.
  • После прошивки необходимо вручную восстановить резервные копии конфигурационных файлов.
• Метод прошивки: пожалуйста, обратитесь к официальным инструкциям и инструментам прошивки.

Различия путей и окружения

Расположение сгенерированной прошивки

• В системе FAST, после успешной компиляции прошивки Klipper, файл прошивки будет находиться по следующему пути:

/data/klipper/out/

Расположение конфигурационных файлов

• В системе FAST

Версия прошивки	Путь к конфигурации Klipper	Путь к конфигурации RRF
Путь к конфигурационным файлам прошивки	Loading...	Loading...

Различия в окружении Python

Система FAST не использует рекомендованную Klipper-ом виртуальную среду Python venv, а применяет глобальную среду Python. Это приводит к необходимости корректировки команд, вызывающих Python-скрипты в окружении Klipper.

Основное изменение: замените ~/klippy-env/bin/python на python в команде.

Описание сценария	Команда стандартной системы	Команда системы FAST
Запрос UUID CANBUS	Loading...	Loading...

Частые проблемы: при выполнении команд вы можете столкнуться с следующей ошибкой:

-bash: ~/klippy-env/bin/python: No such file or directory

Решение: Как показано в таблице выше, замените путь к интерпретатору Python в команде.

Руководство по установке компонентов

Этот документ описывает общий метод установки плагинов Klipper в системе FAST.

Общие шаги установки

Большинство плагинов Klipper можно установить, выполнив следующие простые шаги:

1. Скачайте компонент в каталог /data

   cd /data
   git clone [адрес репозитория плагина]

2. Скопируйте необходимые Python-файлы в каталог расширений Klipper

   cp /data/[каталог плагина]/[главный файл плагина].py /data/klipper/klippy/extras/

3. Перезапустите службу Klipper, чтобы изменения вступили в силу

   systemctl restart klipper

Важные напоминания

• Выбор файлов: уточните в документации к плагину, какие конкретные Python-файлы нужно скопировать, не копируйте все .py файлы бездумно
• Проверка зависимостей: перед установкой убедитесь, что у плагина нет особых требований к зависимостям
• Совместимость версий: убедитесь, что версия плагина совместима с вашей версией Klipper

Описание зависимостей

Внимание: если вы используете FlyOS_FAST-V1.3.0 или новее, в системе уже предустановлены часто используемые зависимости, обычно дополнительная установка не требуется.

Примеры установки часто используемых компонентов

Beacon 3D датчик

cd /data && git clone https://github.com/beacon3d/beacon_klipper.git
cp /data/beacon_klipper/beacon.py /data/klipper/klippy/extras/

IDM или Scanner

cd /data && git clone https://gitee.com/NBTP/IDM.git
cp /data/IDM/idm.py /data/klipper/klippy/extras/
cp /data/IDM/scanner.py /data/klipper/klippy/extras/

Cartographer 3D

cd /data && git clone https://github.com/Cartographer3D/cartographer-klipper.git
cp /data/cartographer-klipper/idm.py /data/klipper/klippy/extras/
cp /data/cartographer-klipper/scanner.py /data/klipper/klippy/extras/
cp /data/cartographer-klipper/cartographer.py /data/klipper/klippy/extras/

Важные замечания

1. Расположение установки: все пользовательские компоненты устанавливайте в каталог /data
2. Проверка файлов: перед копированием убедитесь в назначении файлов, чтобы не перезаписать важные данные
3. Перезапуск службы: после установки необходимо перезапустить службу Klipper, чтобы изменения вступили в силу
4. Диагностика проблем: если после установки возникают аномалии, проверьте корректность скопированных файлов

Вопросы и ответы

1. Не могу получить доступ к fly-tools через браузер (порт 9999), что делать?

• Система FAST представляет собой высокоинтегрированную среду исполнения, в которую по умолчанию не установлено веб-приложение fly-tools, поэтому порт 9999 не имеет соответствующей службы. Это является нормальным проектным решением.

2. ⚠️ Важно: уведомление об обновлениях системных компонентов

• Klipper, Moonraker и другие компоненты системы FAST являются настроенными версиями, которые отличаются от официальных версий сообщества.

• 【Основное правило】Не обновляйте вручную через командную строку или любыми другими неофициальными способами, иначе вы можете нарушить системные оптимизации, что приведет к проблемам совместимости и сбоям функций.
• 【Правильный способ】Обновления всех компонентов должны выполняться только следующими официальными методами:
  • Используйте встроенную функцию онлайн-обновления OTA системы.
  • Либо перезапишите новейший образ системы целиком.

3. На что следует обратить внимание при выполнении OTA-обновления?

1. Безопасность конфигурационных файлов

• OTA-обновление спроектировано так, что ваши пользовательские конфигурационные файлы не будут перезаписаны или изменены

2. Что важно во время обновления

• Во время обновления убедитесь, что питание устройства стабильно
• Неожиданное отключение питания может привести к сбою обновления, в тяжелых случаях потребуется перезапись образа системы заново

3. Обработка пользовательского кода

• Если вы ранее изменяли конфигурационные файлы Klipper или устанавливали пользовательские плагины
• Во время OTA-обновления такие файлы будут автоматически пропущены, чтобы сохранить ваши изменения

4. Важное напоминание: обновление прошивки

• После каждого выполнения OTA-обновления обязательно вручную пересоберите прошивку Klipper и перезапишите прошивку контроллера