Настройка Klipper для кабельного подключения

Важно

Перед подключением к Klipper необходимо сначала загрузить прошивку в STM32F072; в противном случае кабельное подключение не будет работать

Начать компиляцию

Краткое руководство по компиляции прошивки

Примечания

Сеть: Убедитесь, что хост-компьютер (Raspberry Pi и т.п.) подключен к сети.
Способ входа: Необходимо входить через SSH по сети, последовательный порт отключен.
Раскладка клавиатуры: Держите клавиатуру в английском полуширинном режиме

Вход по SSH и переключение пользователей

Используйте MobaXterm, PuTTY и другие инструменты для входа по SSH на хост-компьютер.

Переключение пользователя:

Обычная система (официальная система Raspberry Pi и т.п.)
Запрещено использовать root, необходимо переключиться на обычного пользователя:
```
su <имя_пользователя>
```
FLY хост-компьютер (система FlyOS-FAST)
Поддерживается только вход от пользователя root (пароль: mellow)

Руководство по компиляции прошивки

В интерфейсе конфигурации прошивки Klipper поддерживается только управление с клавиатуры, мышь использовать нельзя.

Клавиша	Функция
↑ / ↓	Перемещение курсора вверх/вниз, выбор пункта меню
Enter / Пробел	Подтверждение выбора, отметка опции или вход в подменю
ESC	Возврат в предыдущее меню
Q	Выход из интерфейса конфигурации
Y	При выходе, если есть подсказка, нажмите 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 используется для открытия интерфейса конфигурации прошивки Klipper.
Настройте параметры по порядку, следуя приведенному ниже списку, переходя к следующему пункту только после завершения предыдущего.

1启用 Enable extra low-level configuration options
(Top)
Klipper Firmware Configuration
[*] Enable extra low-level configuration options
2Micro-controller Architecture 选择 STMicroelectronics STM32
(Top)
Klipper Firmware Configuration
[*] Enable extra low-level configuration options
Micro-controller Architecture (STMicroelectronics STM32) --->
3Processor model 选择 STM32F072
(Top)
Klipper Firmware Configuration
[*] Enable extra low-level configuration options
Micro-controller Architecture (STMicroelectronics STM32) --->
Processor model (STM32F072) --->
4Bootloader offset 选择 No bootloader
(Top)
Klipper Firmware Configuration
[*] Enable extra low-level configuration options
Micro-controller Architecture (STMicroelectronics STM32) --->
Processor model (STM32F072) --->
Bootloader offset (No bootloader) --->
5Clock Reference 选择 8 MHz crystal
(Top)
Klipper Firmware Configuration
[*] Enable extra low-level configuration options
Micro-controller Architecture (STMicroelectronics STM32) --->
Processor model (STM32F072) --->
Bootloader offset (No bootloader) --->
Clock Reference (8 MHz crystal) --->
6Communication interface 选择 USB (on PA11/PA12)
(Top)
Klipper Firmware Configuration
[*] Enable extra low-level configuration options
Micro-controller Architecture (STMicroelectronics STM32) --->
Processor model (STM32F072) --->
Bootloader offset (No bootloader) --->
Clock Reference (8 MHz crystal) --->
Communication interface (USB (on PA11/PA12)) --->
7启用 Optimize stepper code for 'step on both edges'
(Top)
Klipper Firmware Configuration
[*] Enable extra low-level configuration options
Micro-controller Architecture (STMicroelectronics STM32) --->
Processor model (STM32F072) --->
Bootloader offset (No bootloader) --->
Clock Reference (8 MHz crystal) --->
Communication interface (USB (on PA11/PA12)) --->
USB ids --->
[*] Optimize stepper code for 'step on both edges'
8按 Q 键退出配置界面
(Top)
Klipper Firmware Configuration
[*] Enable extra low-level configuration options
Micro-controller Architecture (STMicroelectronics STM32) --->
Processor model (STM32F072) --->
Bootloader offset (No bootloader) --->
Clock Reference (8 MHz crystal) --->
Communication interface (USB (on PA11/PA12)) --->
USB ids --->
[*] Optimize stepper code for 'step on both edges'
() GPIO pins to set at micro-controller startup
GPIO 状态说明：GPIO state at micro-controller startup 是 FLYOS-Klipper 的扩展功能，本页面仅作说明。普通固件编译请保持 Not set，无需进入或修改；如需了解全部 GPIO 启动状态，请查看 GPIO 启动状态使用说明。
9出现 Save configuration 时按 Y 保存配置
Quit
Save configuration?
(Y)es(N)o(C)ancel
После завершения двух последних шагов выше нажмите Q для выхода из интерфейса конфигурации, затем нажмите Y для сохранения настроек.
Вернувшись в командную строку, введите следующую команду и нажмите Enter, чтобы начать компиляцию:
```
make -j4
```
root@flyos-11e5f8 ~/klipper # make -j4
Compiling out/src/stm32/stm32f0_adc.o
Compiling out/src/stm32/spi.o
Compiling out/src/stm32/stm32f0_i2c.o
Compiling out/src/stm32/usbfs.o
Compiling out/src/stm32/chipid.o
Compiling out/src/generic/usb_cdc.o
Compiling out/src/stm32/hard_pwm.o
Preprocessing out/src/generic/armcm_link.ld
Building out/compile_time_request.o
Version: XXXX
Linking out/klipper.elf
Creating bin file out/klipper.bin
终端末尾出现 Linking out/klipper.elf 和 Creating bin file out/klipper.bin，即表示编译成功。实际编译时，部分 Compiling 行和 Version 会随 Klipper 与系统版本变化。

Войти в режим загрузки прошивки

При отключенном питании AirClick удерживайте кнопку BOOT на STM32, чтобы соединить порт загрузки STM32 через Type-C с компьютером
Loading...

Загрузка прошивки

Установка инструмента для прошивки
- Для верхнего компьютера FLY установка инструмента для прошивки не требуется.
- Если вам нужно установить, обратите внимание: верхний компьютер должен иметь доступ в Интернет для корректной установки.
- Если уже установлено, установка не требуется.
```
sudo apt update
sudo apt install dfu-util -y
```
Выполните следующую команду, чтобы проверить, выполнено ли подключение.
```
lsusb
```
- Если устройства DFU нет, попробуйте снова войти в режим прошивки.
- Из-за различий в версиях системы может отображаться другое имя, если присутствует 0483:df11, это означает вход в режим прошивки.
  
  Loading...
Прошивка микропрограммы
- Выполните следующий код для начала прошивки, замените <полный путь к файлу микропрограммы> на фактический путь к файлу микропрограммы.
```
sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D <полный путь к файлу микропрограммы>
```
Если появится содержимое, как на изображении ниже File downloaded successfully, прошивка выполнена успешно.

Loading...

Совет
После завершения прошивки необходимо полностью отключить питание материнской платы один раз.

Поиск USBID

Необходимо подключить порт загрузки AirClick к USB-порту компьютера; не удерживайте кнопку BOOT, иначе ID не будет обнаружен
Loading...

Получение USB ID материнской платы

Меры предосторожности

Отключение питания

При необходимости подключения или повторного подключения USB-кабеля материнской платы сначала полностью выключите принтер и отключите источник питания. Не вставляйте и не извлекайте кабели при включенном питании.

Область применения

Поисковые команды необходимо выполнять после входа на верхний компьютер через SSH.
Перед выполнением операций убедитесь, что на материнскую плату прошита USB-прошивка и она подключена через кабель Type-C к USB-порту верхнего компьютера.
Данное руководство предназначено только для поиска USB ID материнской платы и не подходит для поиска ID инструментальных плат.
Для инструментальных плат используйте руководство по получению USB или CAN ID из соответствующей документации продукта.

Шаги выполнения

Поиск ID USB-устройства

Войдите на верхний компьютер через SSH и выполните следующую команду для вывода списка всех ID USB-последовательных устройств:

ls /dev/serial/by-id/*

Недопустимые ID

После выполнения команды избегайте использования следующих двух типов ID:

Характеристика ID	Причина	Пример
`usb-1a86_USB_Serial-if00-port0`	Стандартное имя чипов универсальных последовательных интерфейсов, таких как CH340, не может использоваться в качестве адреса подключения материнской платы Klipper	`/dev/serial/by-id/usb-1a86_USB_Serial-if00-port0`
Содержит `katapult`	Устройство находится в режиме прошивки Katapult, требуется сначала прошить прошивку Klipper	`/dev/serial/by-id/usb-katapult_xxxxxxxxxxxx`

Результаты поиска

В обычных условиях терминал отобразит путь к устройству, как показано на рисунке ниже. ID на изображении приведены только в качестве примера формата.

Не удалось найти доступный ID: Просмотр устранения неполадок с прошивкой и подключением устройства

Появилось несколько ID

Если команда возвращает несколько доступных ID, сопоставьте модель MCU материнской платы и изменения в списке устройств до и после подключения/отключения, чтобы определить полный путь к устройству материнской платы.

Заполнение USB ID в конфигурации

Откройте printer.cfg в Fluidd или Mainsail:

Fluidd: Нажмите на значок {…} слева, затем откройте printer.cfg.

Mainsail: Нажмите на "Машина" слева, затем откройте printer.cfg.

ID должен быть фактическим результатом поиска

Пути к устройствам в документации приведены в качестве примеров. USB ID каждой материнской платы может отличаться. Скопируйте полный фактический путь, возвращенный командой SSH.

Найдите секцию конфигурации [mcu] и измените serial на полный путь к устройству, полученный ранее:

[mcu]
serial: /dev/serial/by-id/usb-Klipper_xxxxxxxxxxxx

При использовании USB-прошивки необходимо настроить serial, не заполняйте одновременно canbus_uuid в той же секции конфигурации [mcu].

Расположение конфигурации можно посмотреть на рисунке ниже:

Пример конфигурации Fluidd

Пример конфигурации Mainsail

После завершения изменений нажмите SAVE & RESTART в правом верхнем углу, чтобы сохранить конфигурацию и перезапустить Klipper.

Начать компиляцию​

Краткое руководство по компиляции прошивки​

Примечания​

Вход по SSH и переключение пользователей​

Переключение пользователя:​

Руководство по компиляции прошивки​

Начало компиляции прошивки​

Войти в режим загрузки прошивки​

Загрузка прошивки​

Поиск USBID​

Получение USB ID материнской платы​

Меры предосторожности​

Шаги выполнения​

Поиск ID USB-устройства​

Недопустимые ID​

Результаты поиска​

Заполнение USB ID в конфигурации​