Компиляция прошивки через USB

Начало компиляции

• Требуется ПК с установленным и запущенным сервисом klipper Подключение через SSH по сети

• Убедитесь, что устройство правильно подключено к ПК

• Важно: используйте обычный ПК, например, Raspberry Pi или FLY-пай. Если вы используете модифицированный ПК (например, Wi-Fi адаптер, Redmi и т.д.), то из-за большого количества проблем мы не сможем предоставить вам техническую поддержку

  заметка

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

• Не используйте пользователя ROOT

• Для пользователя fly просто введите: su fly. Для других пользователей замените <ваше имя пользователя> на имя пользователя вашего ПК!

su <имя пользователя вашего ПК>

:::

подсказывать

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

Инструкция по компиляции прошивки Klipper и работе с конфигурационной страницей

подсказывать

Убедитесь, что режим ввода клавиатуры установлен в полуширинный (английский режим)

1. Клавиша ↑, клавиша ↓ на клавиатуре используются для перемещения курсора вверх или вниз для выбора пунктов меню
2. Клавиша подтверждения Enter или пробел Space используется для выбора пунктов меню или перехода к подменю
3. Клавиша выхода ESC используется для возврата на предыдущий уровень меню
4. Клавиша Q используется для выхода из конфигурационной страницы прошивки Klipper
5. При выходе из конфигурационной страницы прошивки Klipper, если появляется запрос, нажмите клавишу Y, чтобы сохранить файл конфигурации

заметка

Если в конфигурационном окне доступны не все параметры, сначала выберите пункт [ ] Включить дополнительные настройки низкого уровня, чтобы отобразить некоторые скрытые параметры

Вот описание процесса компиляции прошивки:

• Подключитесь к SSH и введите следующую команду и нажмите Enter:

  cd ~/klipper && rm -rf ~/klipper/.config && rm -rf ~/klipper/out && make menuconfig

• Где rm -rf ~/klipper/.config && rm -rf ~/klipper/out — это удаление предыдущих данных компиляции и прошивки, а make menuconfig — это команда для компиляции прошивки, после выполнения которой должен появиться нижеследующий интерфейс:

  

• Выберите Enable extra low-level configuration options и нажмите Enter

  

• Перейдите в меню Micro-controller Architecture и выберите STMicroelectronics STM32, затем нажмите Enter

  

• Перейдите в меню Processor model, выберите STM32F072 и нажмите Enter

  

• Выберите Bootloader offset, выберите: 8KiB bootloader

  

• В разделе Communication interface выберите: USB (on PA11/PA12) и нажмите Enter

  

• Проверьте соответствие следующей картинке, убедитесь, что все настройки совпадают с изображением, прежде чем продолжить:

  

• Нажмите клавишу Q, появится запрос Save configuration, затем нажмите Y

  

• Теперь конфигурация должна быть сохранена и вы должны вернуться к командной строке

• Введите make -j4, чтобы начать компиляцию, процесс займет некоторое время

  

• Если в конце выводится следующее содержимое, то компиляция успешно завершена

  Linking out/klipper.elf
  Creating hex file out/klipper.bin

Переход в режим записи

Подсказка

После 1 сентября 2024 года出厂的所有 D7 уже имеют записанную прошивку Katapult

• Подключите основную плату к хост-компьютеру с помощью Type-C кабеля, затем дважды нажмите кнопку reset, при этом на материнской плате будут мигать светодиоды.

Предупреждение

• Если светодиоды не мигают, повторите запись прошивки Katapult:Записать прошивку Katapult
• Если светодиоды не мигают, после записи прошивки Katapult выполните следующий шаг

Проверка входа в режим записи

• Убедитесь, что хост-компьютер подключен к сети и что кабель для передачи данных между хост-компьютером и устройством работает нормально.
• После подключения к хост-компьютеру через SSH введите команду lsusb и нажмите Enter. Если появляется информация, заключенная в красный прямоугольник на изображении ниже, можно переходить к следующему шагу.
  • Если никакой информации не выводится, это может быть проблема системы хост-компьютера, мы ничего не можем сделать, вам нужно заменить систему или хост-компьютер, которые точно работают.
  • Если сообщается об отсутствии команды lsusb, выполните эту команду для установки:

    sudo apt-get install usbutils

    
• ID, показанный в красном прямоугольнике, является ссылкой, но он не фиксирован и может изменяться. Следует учитывать суффикс stm32f072xx после OpenMoko, Inc..
  • На некоторых хост-компьютерах из-за системных проблем может отсутствовать полное отображение или вообще не отображаться.

Запись прошивки

подсказывать

• При установке программы для прошивки необходимо подключение к интернету. Убедитесь, что ваш ПК успешно подключен к сети.
• Если программа уже установлена, повторная установка не требуется.

Начало прошивки

Предупреждение

• Если ПК не является fly-ПК, обязательно выполните следующую команду для установки зависимостей прошивки!

    cd && git clone https://github.com/Arksine/katapult.git

• Для использования внутри Китая используйте эту команду:

  cd && git clone https://gitee.com/MrCakeFuck/katapult.git

• Используйте нижеследующие команды для поиска ID устройства, должно появиться изображение с указанным ID (примечание: приведенный на рисунке ID является примером, каждый основной плат должен иметь уникальный ID)

  ls /dev/serial/by-id/*

  

• Для прошивки используйте следующий код, убедитесь, что фиксированная прошивка уже скомпилирована, замените <ID вашей платы> на ID, найденный на предыдущем шаге

  ~/klippy-env/bin/python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<ID вашей платы>

Для системы fast используйте эту команду для прошивки, замените <ID вашей платы> на ID, найденный на предыдущем шаге

python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<ID вашей платы>

• Ниже приведен пример:

  

• Пример завершения прошивки:

  

Обновление прошивки

Обновление USB-прошивки

• Используйте следующие команды для поиска ID вашей платы, должно появиться изображение с указанным ID (примечание: приведенный на рисунке ID является примером, каждый основной плат должен иметь уникальный ID)

  ls /dev/serial/by-id/*

Внимание

На рисунке ниже /dev/serial/by-id/usb-katapult_rp2040_E662549553642032-if00 является ID платы

• Для обновления USB-прошивки необходимо после компиляции последней версии прошивки ввести следующую команду, замените <ID вашей платы> на ID, найденный на предыдущем шаге

  cd ~/klipper/ && make flash FLASH_DEVICE=<ID вашей платы>

  

Обновление прошивки CAN моста

• Для обновления CAN-моста необходимо после компиляции последней версии прошивки ввести следующую команду для перезагрузки в Katapult. (На рисунке ниже показан пример, ID в примере являются условными, используйте ID из вашего конфигурационного файла)

Внимание

• <Ваш UUID CANBUS> — это UUID CANBUS в файле конфигурации printer.cfg

~/klippy-env/bin/python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <Ваш UUID CANBUS>

Для системы fast используйте эту команду для прошивки, замените <ID вашей платы> на ID, найденный на предыдущем шаге

python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <Ваш UUID CANBUS>

Внимание

• На рисунке ниже f95cee90e1f9 является UUID CANBUS платы

• После перезагрузки в Katapult используйте следующие команды для поиска ID вашей платы, должно появиться изображение с указанным ID (примечание: приведенный на рисунке ID является примером, каждый основной плат должен иметь уникальный ID)

  ls /dev/serial/by-id/*

Внимание

На рисунке ниже /dev/serial/by-id/usb-Klipper_stm32f072xb_43002C000951324757373520-if00 является ID платы

• Убедитесь, что новая прошивка скомпилирована перед выполнением команды прошивки. замените <ID вашей платы> на ID, найденный на предыдущем шаге

  cd ~/klipper/ && make flash FLASH_DEVICE=<ID вашей платы>

  

Решение при ошибке прошивки

• Отключите питание платы, включите его снова и быстро дважды нажмите кнопку reset, чтобы снова войти в режим прошивки.
• Или воспользуйтесь ПК Windows/управляющей программой для повторной прошивки платы katapult. Прошивка платы katapult