Подключение Klipperr
- В данном руководстве описывается процесс прошивки буферной платы Fly-Buffer-Plus с использованием прошивки KLIPPER.
- После прошивки пины, отвечающие за давление, будут перекрыты.
- Чтобы восстановить предыдущую функциональность, необходимо либо написать свои макросы, либо перепрошить предыдущую прошивку.
- Все конфигурации и используемые макросы необходимо создавать самостоятельно.
Прошивка BL
Вход в режим прошивки
- Существует два способа входа в режим прошивки:
- Первый способ: полностью обесточьте плату, удерживайте кнопку BOOT и подключите кабель TYPE-C (с поддержкой передачи данных) к плате и вашему устройству.
- Второй способ: подключите кабель TYPE-C (с поддержкой передачи данных) к плате и вашему устройству, затем удерживайте кнопку BOOT, нажмите кнопку RST, отпустите кнопку RST, а затем отпустите кнопку BOOT.
Прошивка
- Руководство по прошивке на Windows
- Руководство по прошивке на верхнем уровне
- BL-прошивка для буферной платы
- Нажмите на ссылку ниже для загрузки
-
Loading...
- Возможно неудачное программирование по
USB3.0
, постарайтесь использоватьUSB2.0
на вашем компьютере для программирования - Если программирование все равно не удается, попробуйте использовать хост-компьютер для программирования
- Если появляется ошибка, показанная ниже, используйте USB-концентратор
- Инструмент программирования Ссылка для загрузки
- Необходимо загрузить
SetupSTM32CubeProgrammer
и драйверSTM32 DFU
- Скопируйте готовый прошивной файл
klipper.bin
,Katapult
илиMarlin
, созданный ранее, в любую директорию на вашем компьютере - Подключите основную плату к компьютеру с помощью кабеля Type-C, убедитесь, что вы вошли в режим программирования
dfu
- В программе STM32CubeProgrammer выберите режим USB и нажмите обновить, затем подключитесь
- Если окно ошибки не появилось, значит подключение успешно.
Предупреждение
Если отображается содержимое, как на изображении ниже, это означает проблему с компьютером или программой, выполните программирование с помощью хост-компьютера: Руководство по программированию с хост-компьютера
- Нажмите на значок загрузки слева и установите несколько флажков ниже
- Нажмите кнопку
Browse
, указанную стрелкой, и выберите нужный вам прошивной файл - Введите
0x08000000
в полеStart address
- Обратите внимание, если прошивка в формате
HEX
, вы можете пропустить этот шаг!!
- Обратите внимание, если прошивка в формате
- Нажмите кнопку
Start automatic mode
внизу, чтобы начать программирование прошивки - Появление уведомления, как на изображении ниже, означает, что прошивка успешно запрограммирована
- Установка инструмента прошивки
- Для 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 Pi и т.д. Если это модифицированный компьютер (например, Wi-Fi-палка, Redmi и т.д.), из-за большого количества проблем мы не можем предоставить техническую поддержку
- Важные моменты для системы FlyOS-Armbian и обычных систем
- Важные моменты для системы FlyOS-FAST
- Важные моменты для системы
FlyOS-Armbian
и обычных систем- Обычные компьютеры, такие как Raspberry Pi, FLY Pi и т.д., относятся к этому типу
- Не используйте пользователя
ROOT
для любых действий на этом компьютере - Используйте обычного пользователя
- Способ переключения пользователя: для системы
FlyOS-Armbian
используйте командуsu fly
, чтобы переключиться на обычного пользователя - Для других систем используйте команду
su <имя пользователя вашего компьютера>
, чтобы переключиться на обычного пользователя
su <имя пользователя вашего компьютера>
- Важные моменты для системы
FlyOS-FAST
- Имя пользователя по умолчанию для системы
FAST
—root
, пароль —mellow
- Компиляция прошивки должна выполняться только пользователем
root
- Система
FAST
имеет только пользователяROOT
, вам не нужно переключаться на другого пользователя!!!
- Имя пользователя по умолчанию для системы
- Убедитесь, что хост-компьютер может нормально подключаться к сети
- Перед компиляцией прошивки необходимо использовать 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
- Ниже приведена запись процесса компиляции прошивки:
Вход в режим прошивки
- Чтобы войти в режим прошивки, дважды нажмите кнопку
RST

Проверка входа в режим прошивки
- Убедитесь, что хостовое устройство подключено к сети и что кабель данных, соединяющий хостовое устройство с целевым устройством, имеет функцию передачи данных.
- После 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
, затем обновите- Обновление fluidd
- Обновление mainsail
-
Скопируйте ID, нажмите на стрелку, чтобы скопировать
- Проверьте, есть ли
ttyAMC
в fluidd и убедитесь, что Path by ID существует, это USBID
- Проверьте, есть ли
ttyAMC
в mainsail и убедитесь, что Path by ID существует, это USBID
- Проверьте, есть ли
Заполнение USB ID
-
Закройте
DEVICES
и введите IDВажно- В конфигурационном файле:
[mcu]
serial: /tmp/klipper_host_mcuизмените на
[mcu host]
serial: /tmp/klipper_host_mcu- Добавьте:
[mcu]
serial: <Здесь замените на ID, который вы только что запросили>- В fluidd найдите [MCU]
- В mainsail найдите [MCU]
-
Введите ID в конфигурацию
подсказывать- После ввода ID нажмите
SAVE & RESTART
в правом верхнем углу
- После ввода ID нажмите
-
Если Klipper выводит
ADC out of range
, это нормально. Подключите нагревательный стол и термистор к основной плате, настройте выводы термистора сопла и нагревательного стола, затем сохраните и перезапустите.
Примечание: Все ID в документе являются примерами. Фактические ID каждой основной платы различаются, пожалуйста, вводите фактически полученные ID.