Руководство и примечания по использованию системы 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 основного компьютера.
• Важные напоминания:
  • Перед запуском обновления системы убедитесь, что все задачи печати приостановлены.
  • Во время обновления системные службы будут перезапущены, не выполняйте никаких операций печати, иначе это может привести к сбою печати или потере контроля над оборудованием.

Обновление с помощью прошивки

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

Различия в путях и средах

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

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

/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.

2. Почему в системе нет возможности обновлять компоненты Klipper и другие компоненты с помощью одного щелчка мыши?

• Причина: Klipper, Moonraker и другие ключевые компоненты, предустановленные в системе FAST, являются модифицированными и глубоко оптимизированными версиями, разработанными нами, и отличаются от официальных версий upstream.
• Рекомендации:
  • Мы настоятельно рекомендуем не обновлять эти компоненты вручную через командную строку, так как это может привести к нестабильной работе системы, сбоям функций или потере оптимизаций.
  • Обновления функций и исправления безопасности для всех ключевых компонентов можно выполнить только с помощью OTA или повторной прошивкой последнего образа.