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

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

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

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

  • Согласованность компиляции прошивки: Прошивка Klipper должна быть скомпилирована на том основном компьютере, который вы используете. Использование прошивки, скомпилированной другим лицом или с несовпадающей версией, может привести к непредвиденным системным сбоям.
  • Стандарты аппаратной платформы: Настоятельно рекомендуется использовать стандартное аппаратное обеспечение для основного компьютера. Избегайте использования неофициально модифицированных устройств (например, некоторых TV-приставок, Wi-Fi-стиков или определенных моделей устройств 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: Номера выводов обязательно должны быть заглавными (например, !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, обязательно выполните следующие команды для установки пакетов зависимостей для прошивки!
  • Выберите один из двух репозиториев ниже.
  • Репозиторий GitHub 
    cd && git clone https://github.com/Arksine/katapult.git
  • Репозиторий Gitee 
    cd && git clone https://gitee.com/MrCakeFuck/katapult.git
Loading...
Loading...