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

подсказывать

• Из-за проблем с предыдущими уроками, клиентам, купившим до 28 июня 2025 года, рекомендуется перепрошить BL-прошивку
• USB-акселерометр по умолчанию загружен прошивкой Klipper для USB-подключения
• Достаточно обновить прошивку
• Можно подключить компьютер и USB-акселерометр с помощью USB-кабеля

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

• Требуется ПК с установленным и запущенным сервисом klipper Подключение через SSH по сети

• Убедитесь, что устройство правильно подключено к ПК

• Важно: используйте обычный ПК, например, Raspberry Pi или FLY-пай. Если вы используете модифицированный ПК (например, Wi-Fi адаптер, Redmi и т.д.), то из-за большого количества проблем мы не сможем предоставить вам техническую поддержку

  заметка

• Для переключения с пользователя ROOT на обычного пользователя введите следующую команду

• Не используйте пользователя ROOT

• Для пользователя fly просто введите: su fly. Для других пользователей замените <ваше имя пользователя> на имя пользователя вашего ПК!

su <имя пользователя вашего ПК>

:::

подсказывать

• Убедитесь, что хост-компьютер может нормально подключаться к сети
• Перед компиляцией прошивки необходимо использовать SSH через сеть для входа на хост-компьютер
• Не используйте инструменты последовательного порта для входа на хост-компьютер

Инструкция по компиляции прошивки Klipper и работе с конфигурационной страницей

подсказывать

Убедитесь, что режим ввода клавиатуры установлен в полуширинный (английский режим)

1. Клавиша ↑, клавиша ↓ на клавиатуре используются для перемещения курсора вверх или вниз для выбора пунктов меню
2. Клавиша подтверждения Enter или пробел Space используется для выбора пунктов меню или перехода к подменю
3. Клавиша выхода ESC используется для возврата на предыдущий уровень меню
4. Клавиша Q используется для выхода из конфигурационной страницы прошивки Klipper
5. При выходе из конфигурационной страницы прошивки 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 и выберите Raspberry Pi RP2040/RP235x, затем нажмите Enter

  

• Выберите Bootloader offset, затем выберите: 16KiB bootloader

  

• В разделе Communication interface выберите: USBSERIAL

  

• Выберите GPIO пины для установки при запуске микроконтроллера, введите: gpio8
  
• Нажмите клавишу Q, появится Save configuration, нажмите затем Y

• Теперь конфигурация сохранена, и вы вернулись в командную строку
• Введите следующую команду для начала компиляции, процесс занимает некоторое время

make -j4

• Если в конце появится следующее сообщение, значит компиляция успешна

  Linking out/klipper.elf
  Creating bin file out/klipper.bin

Поиск устройства

• Убедитесь, что хостовое устройство подключено к сети и что кабель данных, соединяющий хостовое устройство с целевым устройством, имеет функцию передачи данных.
• После SSH-подключения к хостовому устройству введите команду lsusb и нажмите Enter. Если появляется информация, выделенная на нижеприведенном изображении, можно переходить к следующему шагу.
  • Если нет никакого ответа, это проблема системы хостового устройства, и мы бессильны. Вам нужно заменить систему, которая работает нормально, или заменить хостовое устройство.
  • Если появляется сообщение об отсутствии команды lsusb, выполните следующую команду для установки:

    sudo apt-get install usbutils

    
• 1d50:6177 является устройством, которое вам нужно использовать.
  • Некоторые хостовые устройства могут не показывать или частично показывать устройство из-за проблем с системой.
  • Если команда lsusb показывает устройство, но без 1d50:6177, попробуйте заменить кабель данных и подключить материнскую плату к другому USB-порту хостового устройства.
• Если вы ранее выполнили вышеуказанные шаги и успешно прошили фирменное ПО Klipper, а материнская плата работает нормально, и вам нужно только обновить фирменное ПО Klipper, просто ознакомьтесь с разделом «Обновление прошивки» в правом меню этой страницы.

Важно

Перед выполнением следующего шага обязательно необходимо найти устройство 1d50:6177.

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

Прошивка USB-программатора

• Используйте нижеследующую команду для поиска ID вашей материнской платы; должно появиться изображение с указанным ниже ID (обратите внимание: приведённый ниже ID является примером, каждый материнская плата имеет уникальный ID)

ls /dev/serial/by-id/*

Внимание

На следующем изображении показан пример ID /dev/serial/by-id/usb-Klipper_rp2040_12345-if00, который является ID вашей материнской платы.

• Для обновления USB-программатора потребуется ввести следующую команду после компиляции последней версии прошивки, заменив <ваш_ID_материнской_платы> на ID, полученный на предыдущем шаге

cd ~/klipper/ && make flash FLASH_DEVICE=<ваш_ID_материнской_платы>

Метод исправления ошибочной прошивки

• Нажмите и удерживайте кнопку для входа в режим DFU; компьютер автоматически определит устройство как новую флешку, куда нужно просто перетащить новую прошивку
• Используйте чистку прошивки в WINDOWS и затем повторно установите прошивку

Проверка запуска прошивки

• Если прошивка запустилась нормально, светодиод загорится