Компиляция прошивки для USB

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

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

Примечания

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

---

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

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

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

• Обычная система (официальная система Raspberry Pi и т.п.)
  Запрещено использовать root, необходимо переключиться на обычного пользователя:

  su <имя_пользователя>

• FLY хост-компьютер (система FlyOS-FAST)
  Поддерживается только вход от пользователя root (пароль: mellow)

---

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

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

Клавиша	Функция
↑ / ↓	Перемещение курсора вверх/вниз, выбор пункта меню
Enter / Пробел	Подтверждение выбора, отметка опции или вход в подменю
ESC	Возврат в предыдущее меню
Q	Выход из интерфейса конфигурации
Y	При выходе, если есть подсказка, нажмите Y для сохранения конфигурации

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

Ниже описано, как компилировать прошивку:

1. Подключитесь по 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.

2. Настройте параметры по порядку, следуя приведенному ниже списку, переходя к следующему пункту только после завершения предыдущего.

   1启用 Enable extra low-level configuration options

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   [Space/Enter] Toggle/enter[?] Help[/] Search

   [Q] Quit (prompts for save)[Esc] Leave menu

   2Micro-controller Architecture 选择 Raspberry Pi RP2040/RP235x

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->

   [Space/Enter] Toggle/enter[?] Help[/] Search

   [Q] Quit (prompts for save)[Esc] Leave menu

   3Processor model 选择 rp2040

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->

   Processor model (rp2040) --->

   [Space/Enter] Toggle/enter[?] Help[/] Search

   [Q] Quit (prompts for save)[Esc] Leave menu

   4Bootloader offset 选择 16KiB bootloader

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->

   Processor model (rp2040) --->

   Bootloader offset (16KiB bootloader) --->

   [Space/Enter] Toggle/enter[?] Help[/] Search

   [Q] Quit (prompts for save)[Esc] Leave menu

   5Communication Interface 选择 USBSERIAL

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->

   Processor model (rp2040) --->

   Bootloader offset (16KiB bootloader) --->

   Communication Interface (USBSERIAL) --->

   [Space/Enter] Toggle/enter[?] Help[/] Search

   [Q] Quit (prompts for save)[Esc] Leave menu

   6启用 Optimize stepper code for 'step on both edges'

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->

   Processor model (rp2040) --->

   Bootloader offset (16KiB bootloader) --->

   Communication Interface (USBSERIAL) --->

   USB ids --->

   [*] Optimize stepper code for 'step on both edges'

   [Space/Enter] Toggle/enter[?] Help[/] Search

   [Q] Quit (prompts for save)[Esc] Leave menu

   7按 Q 键退出配置界面

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->

   Processor model (rp2040) --->

   Bootloader offset (16KiB bootloader) --->

   Communication Interface (USBSERIAL) --->

   USB ids --->

   [*] Optimize stepper code for 'step on both edges'

   () GPIO pins to set at micro-controller startup

   [Space/Enter] Toggle/enter[?] Help[/] Search

   [Q] Quit (prompts for save)[Esc] Leave menu

   GPIO 状态说明：GPIO state at micro-controller startup 是 FLYOS-Klipper 的扩展功能，本页面仅作说明。普通固件编译请保持 Not set，无需进入或修改；如需了解全部 GPIO 启动状态，请查看 GPIO 启动状态使用说明。

   8出现 Save configuration 时按 Y 保存配置

   Quit

   Save configuration?

   (Y)es(N)o(C)ancel

3. После завершения двух последних шагов выше нажмите Q для выхода из интерфейса конфигурации, затем нажмите Y для сохранения настроек.

4. Вернувшись в командную строку, введите следующую команду и нажмите Enter, чтобы начать компиляцию:

   make -j4

   root@flyos-11e5f8 ~/klipper # make -j4

   Compiling out/src/rp2040/bootrom.o

   Compiling out/src/rp2040/usbserial.o

   Compiling out/src/generic/usb_cdc.o

   Compiling out/src/rp2040/chipid.o

   Compiling out/src/rp2040/hard_pwm.o

   Compiling out/src/rp2040/spi.o

   Compiling out/src/rp2040/i2c.o

   Preprocessing out/src/rp2040/rpxxxx_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 与系统版本变化。

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

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

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

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

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

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

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

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

Выберите способ прошивки в зависимости от текущего состояния устройства:

您的下位机现在是什么状态

Частые причины сбоев

Симптом	Возможная причина	Действие
usb-katapult_ не обнаружен	Устройство не в режиме Katapult, кабель только для зарядки или неисправен USB-порт	Дважды нажмите RST; проверьте наличие 1d50:6177 через lsusb; замените кабель и USB-порт
Invalid firmware path '...'	Путь, указанный в -f, не существует, или прошивка ещё не собрана	Вернитесь к шагу сборки и убедитесь, что файл ~/klipper/out/klipper.bin существует
Unable to open serial port	Последовательный порт занят службой Klipper	Выполните sudo systemctl stop klipper и повторите попытку
Device is not Katapult, exiting...	Устройство не находится в режиме Katapult	Дважды нажмите RST для повторного входа; если не помогает, обратитесь к документации по восстановлению Bootloader для вашего продукта
Flash Tool Error с Traceback	Проблемы с кабелем, питанием или несоответствие типа прошивки	Сохраните полный вывод и проверьте, не прошита ли ошибочно прошивка USB / USB-мост CAN
Прошивка успешна, но Klipper не подключается	Тип прошивки не соответствует подключению, или [mcu] не обновлён	Убедитесь, должно быть usb-Klipper_ или canbus_uuid, и измените [mcu]
Двойное нажатие RST не даёт индикации, 1d50:6177 так и не появляется	Возможно, Katapult повреждён	Обратитесь к документации по восстановлению Bootloader (Katapult) для вашего продукта

Поиск USB ID после записи

После завершения записи прошивки и вновь подключения питания к материнской плате продолжите поиск USB ID.

Способ получения USB ID