Перейти к основному содержанию

Руководство по использованию системы 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 не использует виртуальную среду Python venv, рекомендованную Klipper, а использует глобальную среду 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, а затем перепрошейте прошивку управляющего устройства.
Loading...