Перейти к основному содержимому

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

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

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

  • Требуется ПК с установленным и запущенным сервисом 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. Y键，在退出Klipper固件配置页面时，如果有提示，则点击Y键保存配置文件
заметка

如果配置页面选项比较少，请先勾选[ ] Enable extra low-level configuration options，用于显示部分隐藏选项

Вот перевод:

Чтобы скомпилировать прошивку, выполните следующие шаги:

  • Подключитесь по SSH и введите следующую команду:

    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, затем нажмите Enter

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

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

  • Выберите GPIO пины, которые необходимо установить при старте микроконтроллера, введите: gpio24
  • Нажмите клавишу Q, чтобы появилось Сохранение конфигурации, затем нажмите клавишу Y
  • Теперь конфигурация должна быть сохранена и вы должны вернуться к командной строке
  • Введите make -j4 для начала компиляции, это займет некоторое время

  • В конце выводится следующее содержимое, что указывает на успешную компиляцию:

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

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

  • Убедитесь, что ПК может нормально подключаться к сети Интернет, и убедитесь, что периферийное устройство подключено к ПК с использованием кабеля, поддерживающего передачу данных.
  • После SSH-подключения к ПК введите команду lsusb и нажмите Enter. Если появляется информация, заключенная в круглые скобки на приведенном изображении, можно переходить к следующему шагу.
    • Если нет никакого вывода, это проблема системы ПК, и мы бессильны. Вам нужно заменить систему, которая работает корректно, или заменить ПК.
    • Если сообщается, что команда lsusb не найдена, выполните эту команду для установки: 
      sudo apt-get install usbutils
  • 1d50:614e принадлежит устройству, которое вы планируете использовать. Суффикс OpenMoko, Inc. stm32f407xx имеет некоторую справочную ценность, но не является основным критерием для определения.
    • Некоторые ПК могут отображать информацию неполностью или вообще не показывать из-за проблем с системой.
    • Если при вводе команды lsusb устройство отображается, но не указано 1d50:614e, попробуйте заменить кабель и подключить материнскую плату к другому USB-порту ПК.
  • Если вы ранее выполнили вышеописанные шаги и успешно прошили фирменное программное обеспечение Klipper, а материнская плата работает нормально, и вам нужно только обновить программное обеспечение Klipper, переходите к разделу "Обновление прошивки" в правом меню этой страницы.
Важные замечания

Действия можно продолжить только после того, как будет найдено одно из устройств 1d50:614e.

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

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

  • При установке плагина для прошивки убедитесь, что ваш ПК подключен к интернету
  • Если плагин уже установлен, повторная установка не требуется :::

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

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

  • Не настройте ПК Fly обязательно выполните следующую команду для установки зависимостей прошивки! В противном случае прошивка не будет выполнена!
cd && git clone https://github.com/Arksine/katapult.git

:::

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

    ls /dev/serial/by-id/*

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

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

  • Пример ниже

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

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

  • Используйте следующую команду для поиска ID вашей материнской платы, результат должен совпадать с показанным ниже (примечание: ID на изображении является примером, каждый материнская плата имеет уникальный ID)
ls /dev/serial/by-id/*

:::предупреждение На изображении показан ID /dev/serial/by-id/usb-katapult_rp2040_E662549553642032-if00 :::

  • Для обновления USB-прошивки после компиляции новой прошивки введите следующую команду, замените <ID_вашей_материнской_платы> на ID, полученный на предыдущем шаге
cd ~/klipper/ && make flash FLASH_DEVICE=<ID_вашей_материнской_платы>

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

  • Отключите питание материнской платы, затем включите ее и быстро нажмите два раза кнопку сброса
  • Или используйте очистку прошивки в WINDOWS и перепишите BL заново

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

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