Руководство и примечания по использованию системы 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 и перезалейте ее на микроконтроллер