Компиляция прошивки через USB
Начало компиляции
-
Требуется ПК с установленным и запущенным сервисом
klipper
Подключение через SSH по сети -
Убедитесь, что устройство правильно подключено к ПК
-
Важно: используйте обычный ПК, например, Raspberry Pi или FLY-пай. Если вы используете модифицированный ПК (например, Wi-Fi адаптер, Redmi и т.д.), то из-за большого количества проблем мы не сможем предоставить вам техническую поддержку
заметка -
Для переключения с пользователя ROOT на обычного пользователя введите следующую команду
-
Не используйте пользователя ROOT
-
Для пользователя fly просто введите:
su fly
. Для других пользователей замените<ваше имя пользователя>
на имя пользователя вашего ПК!
su <имя пользователя вашего ПК>
:::
- Убедитесь, что хост-компьютер может нормально подключаться к сети
- Перед компиляцией прошивки необходимо использовать SSH через сеть для входа на хост-компьютер
- Не используйте инструменты последовательного порта для входа на хост-компьютер
Инструкция по компиляции прошивки Klipper и работе с конфигурационной страницей
Убедитесь, что режим ввода клавиатуры установлен в полуширинный (английский режим)
- Клавиша
↑
, клавиша↓
на клавиатуре используются для перемещения курсора вверх или вниз для выбора пунктов меню - Клавиша подтверждения
Enter
или пробелSpace
используется для выбора пунктов меню или перехода к подменю - Клавиша выхода
ESC
используется для возврата на предыдущий уровень меню - Клавиша
Q
используется для выхода из конфигурационной страницы прошивки Klipper - При выходе из конфигурационной страницы прошивки 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
Проверка режима записи
- Убедитесь, что хост-компьютер подключен к сети и шнур, соединяющий хост-компьютер с устройством, имеет функцию передачи данных.
- Подключитесь по SSH к хост-компьютеру и введите команду
lsusb
, затем нажмите Enter. Если появится информация, заключенная в круглые скобки на изображении ниже, можно переходить к следующему шагу.- Если не получено никакой информации, это может быть проблема с системой хост-компьютера. Мы не можем помочь вам в этом случае, вам нужно заменить рабочую систему или хост-компьютер.
- Если отсутствует команда
lsusb
, выполните следующую команду для установки:sudo apt-get install usbutils
- ID, показанный в красной рамке, может служить ориентиром, но он не является фиксированным и может меняться. Последовательность
OpenMoko, Inc. stm32f072xx
после суффикса имеет признаки определения, гдеXX
означает переменную.- Некоторые хост-компьютеры могут показывать недостаточно данных или вообще ничего из-за системных проблем.
Запись прошивки
- При установке программы для прошивки необходимо подключение к интернету. Убедитесь, что ваш ПК успешно подключен к сети.
- Если программа уже установлена, повторная установка не требуется.
Начало прошивки
- Если ПК не является 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-прошивки
- Обновление прошивки CAN моста
-
Используйте следующие команды для поиска 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-моста необходимо после компиляции последней версии прошивки ввести следующую команду для перезагрузки в 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