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

Инструкция по компиляции прошивки

Важное предупреждение по безопасности

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

  • Согласованность компиляции прошивки: Прошивка Klipper должна быть скомпилирована на главном компьютере, который вы используете в данный момент. Использование прошивки, скомпилированной кем-то другим или с несовпадающей версией, может привести к непредвиденным системным сбоям.
  • Стандарты аппаратной платформы: Настоятельно рекомендуется использовать стандартное оборудование главного компьютера. Избегайте использования неофициально модифицированных устройств (например, некоторых телеприставок, WiFi-адаптеров или устройств Redmi определенных моделей), так как эти устройства могут иметь риски совместимости и стабильности.
  • Ограничения виртуализации: Не рекомендуется запускать систему главного компьютера на виртуальной машине, так как это может привести к снижению производительности и проблемам с работой в реальном времени, влияя на качество печати.

Описание типов прошивки​

  • Режим Katapult / HID

    • Функция: Оба режима имеют одинаковую функциональность и позволяют выполнять бесконтактную прошивку (обновление прошивки напрямую через главный компьютер без извлечения карты памяти).
    • Пояснение: HID — это загрузчик, используемый во встроенном главном компьютере FLY, и по своей сути он идентичен Katapult.
    • Важное примечание: При использовании Katapult, если после прошивки ошибочной прошивки плата не отвечает, найдите кнопку сброса на плате и быстро дважды нажмите на нее, чтобы снова войти в режим Katapult для повторной прошивки.

  • Режим Bootloader

    • Функция: Традиционный способ прошивки через карту памяти.
    • Преимущество: Этот метод обладает высокой отказоустойчивостью. Если прошивка записана ошибочно, можно попробовать снова, перезаписав карту памяти, не опасаясь превратить плату в "кирпич".

Руководство по компиляции прошивки​

Подготовка и рекомендации по компиляции
  • Для максимального обеспечения успеха компиляции рекомендуется использовать MobaXterm в качестве SSH-клиента. Согласно отзывам пользователей, некоторые другие SSH-инструменты могут вызывать необъяснимые ошибки компиляции.
  • Важный параметр конфигурации: В интерфейсе конфигурации компиляции обязательно установите флажок Enable extra low-level configuration options, иначе некоторые расширенные настройки не будут отображаться.

Конфигурация начальных пинов (GPIO pins to set at micro-controller startup)​

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

  • Синтаксис конфигурации:

    • Добавление ! перед именем пина означает, что при запуске этот пин будет установлен в низкий уровень (логический 0). Отсутствие ! означает установку в высокий уровень (логическая 1).
    • Серия STM32: Номера пинов должны быть написаны в верхнем регистре. Указывайте в соответствии с документацией вашей платы.
    • Серия RP2040: Номера пинов должны быть написаны в нижнем регистре. Указывайте в соответствии с документацией вашей платы.

  • Конфигурация нескольких пинов: Для настройки нескольких пинов разделите их запятой ,.

    • Пример: !<pin_a>,!<pin_b>,<pin_c> означает, что при запуске первые два пина будут установлены в низкий уровень, а третий пин — в высокий уровень.
Пояснение по безопасности

Настроенные вами GPIO pins to set at micro-controller startup действуют только до того, как Klipper установит соединение и запустится. После того как Klipper успешно подключится и будет работать в обычном режиме, эта настройка не влияет на любые другие операции с пинами и является безопасной для использования.

Восстановление после неудачной прошивки и общая защита
  • Защита от ошибочной прошивки: Прошивки типов Katapult, HID и Bootloader имеют встроенный механизм защиты. Пока вы не войдете в специальный режим DFU для прошивки, даже если вы прошьете ошибочную основную прошивку, эти загрузчики не будут перезаписаны, и плата не превратится в "кирпич".
  • Необходимое действие после прошивки: После завершения прошивки любой прошивки обязательно полностью обесточьте подчиненный компьютер (отключите кабель питания), а затем снова подайте питание, чтобы новая прошивка была правильно загружена и работала стабильно.

Инструкция по прошивке​

Что нужно знать перед прошивкой
  • Идентификация устройства: При прошивке с использованием Katapult убедитесь, что главный компьютер обнаруживает устройство. Если устройство не найдено, быстро дважды нажмите кнопку сброса на плате, чтобы снова войти в режим прошивки. Или перепрошейте BL-прошивку платы.
  • Соблюдение правил: Строго следуйте официальному руководству по прошивке. Использование других непроверенных методов может привести к повреждению оборудования.
  • Проверка компиляции: Перед прошивкой обязательно убедитесь, что в прошивке нет ошибок компиляции. Ошибочный файл прошивки приведет к сбою прошивки или устройство не будет работать должным образом.

Восстановление после ошибочной прошивки прошивки Katapult​

  1. Найдите физическую кнопку сброса на плате и быстро дважды нажмите на нее.
  2. В нормальной ситуации на плате Fly начнет мигать светодиодный индикатор, что означает успешный вход в режим Katapult.
  3. Теперь можно войти в режим Katapult и перепрошить правильную прошивку Klipper.

Восстановление после ошибочной прошивки прошивки Bootloader​

  1. Вставьте TF-карту с правильной прошивкой обратно в плату.
  2. Если прошивка не выполняется, сначала полностью обесточьте плату, вставьте TF-карту и снова подайте питание.
  3. Оставьте питание включенным примерно на 5 секунд, после чего автоматическая прошивка завершится.

Установка зависимостей для прошивки через Katapult​

Важно
  • Если вы используете не официальный главный компьютер Fly, обязательно выполните следующие команды для установки пакетов зависимостей для прошивки!
  • Выберите один из двух репозиториев ниже.
  • Репозиторий на GitHub 
    cd && git clone https://github.com/Arksine/katapult.git
  • Зеркальный репозиторий для Китая 
    cd && git clone https://cnb.cool/3dmellow/public/katapult
Loading...
Loading...