Подключение к Klipperr
- Эта инструкция содержит только метод подключения к klipper
- Любые другие макросы для настройки и использования необходимо писать самостоятельно
Загрузка BL
Вход в режим загрузки
- Есть два способа войти в режим загрузки
- Первый: при полном отключении питания платы нажмите и удерживайте кнопку BOOT, затем подключите кабель с передачей данных к плате и к вашему устройству
- Второй: после подключения кабеля с передачей данных к плате и к вашему устройству нажмите и удерживайте кнопку BOOT, затем нажмите и отпустите кнопку RST, а затем отпустите кнопку BOOT
Загрузка прошивки
- Инструкция по загрузке на Windows
- Инструкция по загрузке на ПК
- Прошивка BL буфера
- Яндекс.Диск:Ссылка для скачивания на Яндекс.Диске
- GOOGLE Диск:GOOGLE Диск
::::опасность Важно
- Возможны проблемы совместимости системы, используйте USB2.0 на ПК для прошивки
- Если всё ещё не получается выполнить прошивку, попробуйте использовать программу верхнего уровня для прошивки
::::
- Скачать инструмент для прошивки адрес скачивания
- Необходимо скачать
SetupSTM32CubeProgrammer
иSTM32 DFU драйвер
- Скопируйте предварительно скомпилированный firmware (klipper.bin) или заранее скомпилированный firmware
Katapult
в произвольную директорию на компьютер - Подключите основную плату к компьютеру с помощью Type-C кабеля, убедитесь, что выполнено: переход в режим прошивки DFU
- В STM32CubeProgrammer выберите режим USB и обновите подключение
- Если не появляется окно с ошибкой, то подключение успешно.
:::+опасность Предупреждение
Если появится содержимое, как показано ниже, это проблема с компьютером или программным обеспечением, используйте программу верхнего уровня для прошивки: инструкция по прошивке через программу верхнего уровня
:::
- Нажмите на значок загрузки слева и отметьте несколько пунктов
- Нажмите на кнопку
Browse
, указанную стрелкой, затем выберите firmware, которое нужно прошить - Выберите
Start address
и введите0x08000000
- Нажмите на
Start automatic mode
внизу для начала прошивки firmware - Появление нижеследующего уведомления означает завершение прошивки firmware
- Нажмите на значок загрузки слева и отметьте несколько пунктов
- Установка инструмента прошивки
- Для FLY ПО не требуется установка инструмента прошивки
- Если вам нужно установить, обратите внимание: ПО должно иметь доступ к интернету для нормальной установки
- Если уже установлено, повторная установка не требуется
sudo apt update
sudo apt install dfu-util -y
- Выполните следующую команду для проверки успешного подключения.
lsusb
- Если DFU устройство не обнаружено, попробуйте снова войти в режим прошивки
- Из-за особенностей версии системы может отображаться другое название; наличие
0483:df11
указывает на успешный вход в режим прошивки

- Получение предварительно скомпилированного ПО
- Здесь находятся предварительно скомпилированные версии ПО
- Обратите внимание: ПО должно иметь доступ к интернету для установки
- Для загрузки пакета ПО выполните следующую команду (если из-за проблем с сетью ПО не может быть получен, обратитесь к администратору в группу обслуживания клиентов)
cd && git clone https://github.com/FengHua741/FLY_Katapult.git
- Если пакет ПО уже скачан, рекомендуется обновить пакет перед выполнением дальнейших действий
cd ~/FLY_Katapult && git pull
- Загрузка прошивки
Нужно загрузить только одну из прошивок
- Ниже приведены команды для загрузки прошивки
sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D ~/FLY_Katapult/BL/buffer/FLY_BUFFER
-
Если появится надпись
File downloaded successfully
в указанном месте, значит загрузка прошла успешно
После завершения загрузки необходимо полностью отключить питание платы.
Компиляция USB-прошивки
Начало компиляции
-
Требуется ПК с установленным и запущенным сервисом
klipper
Подключение через SSH по сети -
Убедитесь, что устройство правильно подключено к ПК
-
Важно: используйте обычный ПК, например, Raspberry Pi или FLY-пай. Если вы используете модифицированный ПК (например, Wi-Fi адаптер, Redmi и т.д.), то из-за большого количества проблем мы не сможем предоставить вам техническую поддержку
заметка -
Для переключения с пользователя ROOT на обычного пользователя введите следующую команду
-
Не используйте пользователя ROOT
-
Для пользователя fly просто введите:
su fly
. Для других пользователей замените<ваше имя пользователя>
на имя пользователя вашего ПК!
su <имя пользователя вашего ПК>
:::
- 请确保上位机可以正常联网
- 固件编译前需要使用SSH通过网络登录上位机
- 请不要使用串口工具登录上位机
Klipper固件编译和配置页面操作说明
请确保键盘输入法为半角模式,即英文模式
- 键盘上键
↑
,下键↓
,用于上下移动光标来选中菜单项 - 确认键
Enter
或 空格键Space
,用于勾选菜单或进入子菜单 - 退出键
ESC
,用于返回上一级菜单 Q
键,用于退出Klipper固件配置页面Y
键,在退出Klipper固件配置页面时,如果有提示,则点击Y
键保存配置文件
如果配置页面选项比较少,请先勾选[ ] Enable extra low-level configuration options
,用于显示部分隐藏选项
Вот описание процесса компиляции прошивки:
-
Подключитесь к 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 года все D5, выпущенные после этой даты, уже имеют установленную прошивку Katapult
- После подключения платы к компьютеру с помощью кабеля TypeC, нажмите дважды на кнопку reset, тогда на плате загорится светодиод.
- Если светодиод не мигает, перезагрузите прошивку Katapult:Загрузка прошивки Katapult
- Если светодиод не мигает, выполните следующий шаг после загрузки прошивки Katapult

Проверьте, находится ли в режиме загрузки
- Убедитесь, что хостовое устройство подключено к сети и что кабель данных, соединяющий хостовое устройство с целевым устройством, имеет функцию передачи данных.
- После SSH-подключения к хостовому устройству введите команду
lsusb
и нажмите Enter. Если появляется информация, выделенная на нижеприведенном изображении, можно переходить к следующему шагу.- Если нет никакого ответа, это проблема системы хостового устройства, и мы бессильны. Вам нужно заменить систему, которая работает нормально, или заменить хостовое устройство.
- Если появляется сообщение об отсутствии команды
lsusb
, выполните следующую команду для установки:sudo apt-get install usbutils
1d50:6177
является устройством, которое вам нужно использовать.- Некоторые хостовые устройства могут не показывать или частично показывать устройство из-за проблем с системой.
- Если команда
lsusb
показывает устройство, но без1d50:6177
, попробуйте заменить кабель данных и подключить материнскую плату к другому USB-порту хостового устройства.
- Если вы ранее выполнили вышеуказанные шаги и успешно прошили фирменное ПО Klipper, а материнская плата работает нормально, и вам нужно только обновить фирменное ПО Klipper, просто ознакомьтесь с разделом «Обновление прошивки» в правом меню этой страницы.
Перед выполнением следующего шага обязательно необходимо найти устройство 1d50:6177
.
Загрузка прошивки
- При установке программы для прошивки необходимо подключение к интернету. Убедитесь, что ваш ПК успешно подключен к сети.
- Если программа уже установлена, повторная установка не требуется.
Начало прошивки
- Если ПК не является 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
Поиск USB ID
- Откройте браузер и в адресной строке введите IP-адрес главного устройства, например, мой IP-адрес главного устройства —
192.168.101.179
. Просто введите его и нажмите Enter.

- Откройте веб-интерфейс главного устройства. В левом боковом меню найдите раздел конфигурации:
![]() |
![]() |
- Нажмите на
printer.cfg
, затем нажмите справа сверху на «DEVICES»
![]() | ![]() |
- Нажмите на «SERIAL» и обновите страницу
![]() |
![]() |
- Скопируйте ID, нажав на указатель для копирования
![]() |
![]() |
Заполнение USB ID
- Закройте «DEVICES» и заполните ID
- Измените в файле конфигурации:
[mcu]
serial: /tmp/klipper_host_mcu
на
[mcu host]
serial: /tmp/klipper_host_mcu
- Добавьте:
[mcu]
serial: <вставьте здесь только что полученный ID>
![]() |
![]() |
- Заполните ID в конфигурации
- После заполнения ID нажмите в правом верхнем углу на «SAVE & RESTART »
![]() | ![]() |
- Если Klipper показывает сообщение «ADC out of range», это нормально. Подключите нагревательный стол и термисторы к материнской плате и настройте выводы датчиков температуры для сопла и нагревательного стола, затем сохраните и перезагрузите.
Внимание: Все ID, указанные в документации, являются примерами. У каждой материнской платы ID различаются. Пожалуйста, используйте фактические полученные ID.