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

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

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

• Единообразие прошивки: прошивка Klipper должна собираться с помощью хост-машины, которую вы в данный момент используете. Использование чужой прошивки или прошивки несовместимой версии может привести к непредсказуемым сбоям системы.
• Требования к аппаратной платформе: настоятельно рекомендуется использовать стандартное оборудование хост-машины. Избегайте использования модифицированных неофициальных устройств (например, некоторых моделей приставок, 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 при запуске микроконтроллера.
• Для корректной сборки необходимо переключиться на английскую раскладку клавиатуры, иначе сборка прошивки будет невозможна

• Синтаксис настройки:

  • Добавление ! перед номером вывода означает, что он будет установлен в низкий уровень (низкое напряжение) при запуске, отсутствие ! означает высокий уровень (высокое напряжение).
  • Для серии 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. Если прошивка не выполняется, сначала полностью отключите питание, вставьте карту памяти и снова включите питание.
3. Удерживайте питание около 5 секунд, автоматическая прошивка будет выполнена.