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

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

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

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

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

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

  • Режим Katapult / HID

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

  • Режим Bootloader

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

Руководство по сборке прошивки​

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

Конфигурация пинов запуска (GPIO pins to set at micro-controller startup)​

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

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

    • Добавление ! перед номером пина означает установку низкого уровня (LOW) при запуске, отсутствие ! означает установку высокого уровня (HIGH).
    • Серия STM32: Номера выводов обязательно должны быть в верхнем регистре (например, !PF8 или PF8).
    • Серия RP2040: Номера выводов обязательно должны быть в нижнем регистре (например, !gpio5 или gpio5).

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

    • Пример: !gpio5,!gpio19,gpio24 означает установку низкого уровня на gpio5 и gpio19 и высокого уровня на gpio24 при запуске.
Пояснение по безопасности

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

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

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

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

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

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

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

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

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

⚠️ Важно
  • Если вы используете неофициальный хост-компьютер Fly, обязательно выполните следующие команды для установки пакетов зависимостей для прошивки!
  • Достаточно выбрать один из репозиториев ниже.
  • Репозиторий git 
    cd && git clone https://github.com/Arksine/katapult.git
  • Репозиторий gitee 
    cd && git clone https://gitee.com/MrCakeFuck/katapult.git
Loading...
Loading...