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

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

• На заводе Micro4 уже предустановлена прошивка Katapult для подключения USB, вам не нужно устанавливать её снова

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

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

Важные моменты для системы FlyOS-Armbian и обычных систем

заметка

• Важные моменты для системы FlyOS-Armbian и обычных систем
  • Обычные компьютеры, такие как Raspberry Pi, FLY Pi и т.д., относятся к этому типу
  • Не используйте пользователя ROOT для любых действий на этом компьютере
  • Используйте обычного пользователя
  • Способ переключения пользователя: для системы FlyOS-Armbian используйте команду su fly, чтобы переключиться на обычного пользователя
  • Для других систем используйте команду su <имя пользователя вашего компьютера>, чтобы переключиться на обычного пользователя

  su <имя пользователя вашего компьютера>

Важные моменты для системы FlyOS-FAST

заметка

• Важные моменты для системы FlyOS-FAST
  • Имя пользователя по умолчанию для системы FAST — root, пароль — mellow
  • Компиляция прошивки должна выполняться только пользователем root
  • Система FAST имеет только пользователя ROOT, вам не нужно переключаться на другого пользователя!!!

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

• Убедитесь, что хост-компьютер может нормально подключаться к сети
• Перед компиляцией прошивки необходимо использовать 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, появится Сохранить конфигурацию, нажмите теперь Y
  
• Теперь конфигурация сохранена и вы вернулись в командную строку
• Введите следующую команду для начала компиляции, процесс занимает некоторое время

make -j4

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

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

Проверьте, вошли ли вы в режим загрузки

• Подключите плату к компьютеру с помощью кабеля 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

  

• Используйте следующую команду для поиска идентификатора вашего устройства. Должен отобразиться идентификатор, как показано на изображении ниже (примечание: показанный идентификатор приведен только в качестве примера, идентификатор каждой платы различается)

  ls /dev/serial/by-id/*

  

• Для прошивки прошивки используйте следующий код. Убедитесь, что прошивка уже скомпилирована, замените <ваш идентификатор платы> на идентификатор, полученный на предыдущем шаге

Метод прошивки для Fly-Armbian и обычного хост-компьютера

~/klippy-env/bin/python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<ваш идентификатор платы>

Метод прошивки для Fly-FAST

python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<ваш идентификатор платы>

• См. ниже справочное изображение:

  

• Результат после прошивки:

  

Обновление прошивки

Обновление USB-прошивки

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

  ls /dev/serial/by-id/*

Примечание

В нижнем изображении /dev/serial/by-id/usb-katapult_rp2040_E662549553642032-if00 — это идентификатор платы

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

  cd ~/klipper/ && make flash FLASH_DEVICE=<ваш идентификатор платы>

  

Обновление прошивки CAN-моста

• Для обновления прошивки CAN-моста USB после компиляции новой прошивки необходимо выполнить следующую команду, чтобы перезагрузить в Katapult. (Как показано на изображении ниже, идентификатор на изображении приведен только в качестве примера, используйте идентификатор из вашего конфигурационного файла)

Примечание

• <CANBUS UUID> — это UUID CANBUS вашей платы в вашем конфигурационном файле printer.cfg

Метод перезагрузки в режим прошивки для Fly-Armbian и обычного хост-компьютера

• Замените <ваш идентификатор платы> на идентификатор, полученный на предыдущем шаге

  ~/klippy-env/bin/python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <CANBUS UUID>

Метод перезагрузки в режим прошивки для Fly-FAST

• Замените <ваш идентификатор платы> на идентификатор, полученный на предыдущем шаге

  python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <CANBUS UUID>

Примечание

• На изображении ниже f95cee90e1f9 — это UUID CANBUS вашей платы

• После перезагрузки в Katapult используйте следующую команду для поиска идентификатора вашей платы. Должен отобразиться идентификатор, как показано на изображении ниже (примечание: показанный идентификатор приведен только в качестве примера, идентификатор каждой платы различается)

  ls /dev/serial/by-id/*

Примечание

На изображении ниже /dev/serial/by-id/usb-Klipper_stm32f072xb_43002C000951324757373520-if00 — это идентификатор платы

• Убедитесь, что новая прошивка уже скомпилирована перед выполнением команды прошивки. Замените <ваш идентификатор платы> на идентификатор, полученный на предыдущем шаге

  cd ~/klipper/ && make flash FLASH_DEVICE=<ваш идентификатор платы>

  

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

• Отключите питание платы, затем подайте его снова и дважды быстро нажмите кнопку сброса (reset), чтобы снова войти в режим прошивки.
• Либо перепрошейте плату Katapult с помощью Windows/хост-компьютера Прошить Katapult прошивку