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

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