Руководство по подключению MCU

Примечание

Это руководство предназначено для устранения и решения проблем с подключением MCU к Klipper.

Подготовка и меры предосторожности

• Не рекомендуемые хост-устройства: избегайте использования таких устройств, как телефоны Redmi, Wi-Fi адаптеры, приставки и т.д. Они обычно используют модифицированные системы, которые могут не распознавать MCU.
• Подтвердите количество подчиненных устройств: заранее убедитесь в количестве используемых вами подчиненных контроллеров (например, плат инструментов). Несколько подчиненных устройств могут влиять на подключение.
• Упростите подключение проводов: временно удалите все провода с основной платы и платы инструментов, кроме необходимых для передачи данных, чтобы исключить помехи.
• Рекомендуемый интерфейс: рекомендуется использовать интерфейс Fluidd, так как он наглядно отображает состояние подключения MCU.

Шаг 1: Резервное копирование и сброс конфигурации

1. Открытие веб-интерфейса хост-устройства

Откройте браузер и введите IP-адрес хост-устройства (например: 192.168.101.179).

2. Поиск конфигурационного файла

В веб-интерфейсе найдите раздел конфигурации в левом боковом меню:

Пользователи Fluidd: нажмите ..., затем найдите printer.cfg.

Пользователи Mainsail: нажмите Машина, затем найдите printer.cfg.

3. Резервное копирование файла

Щелкните правой кнопкой мыши файл printer.cfg и выберите Duplicate для создания копии. Переименуйте копию в:

printer_Backup.cfg

Пример для Fluidd:

Пример для Mainsail:

4. Сброс конфигурации

Откройте файл printer.cfg, удалите всё его содержимое и вставьте следующую минимальную конфигурацию:

[mcu]
serial: /tmp/klipper_host_mcu

[printer]
kinematics: none
max_velocity: 200
max_accel: 1000

5. Сохранение и перезагрузка

• Нажмите SAVE & RESTART в правом верхнем углу. Klipper сохранит настройки и перезапустит службу.
• Если появятся ошибки, временно игнорируйте их.
• Отключите питание всех устройств (включая хост и все подчиненные устройства).
• Важно: убедитесь, что питание полностью отключено, иначе следующие шаги не будут выполнены.

---

Шаг 2: Обнаружение устройств и определение типа прошивки

Условия

• Порядок устройств: первым MCU должна быть основная плата, а не плата инструментов.
• Тип прошивки: убедитесь, что прошивка на вашей плате FLY — это USB прошивка или USB мост CAN прошивка. Это руководство не относится к другим типам.
• Способ подключения: сначала подключитесь через SSH, это должно быть сделано через сеть.

Шаги

1. Обнаружение устройств

   • После успешного подключения через SSH выполните следующую команду:

     lsusb

   • Система выведет список всех обнаруженных USB-устройств.

2. Обработка ошибок

   • Если команда lsusb отсутствует, установите её:

     sudo apt-get install usbutils

   • Если после выполнения команда не возвращает никаких устройств, попробуйте использовать другое хост-устройство.

3. Идентификация устройств См. изображения ниже, чтобы определить ваше устройство в выводе lsusb:

   
   

4. Проверка типа прошивки

   • В зависимости от установленной прошивки, в выводе lsusb должны быть следующие идентификаторы:
     • USB прошивка: 1d50:614e
     • USB мост CAN прошивка: 1d50:606f
     • USB Katapult прошивка: 1d50:6177
     • Адаптер RS232 (для UTOR или D8/D8PRO): 1a86:7523 (этот шаг не требуется для G2T)

---

Шаг 3: Поиск идентификаторов устройств

Важные замечания

• Поиск по USB ID: применим только к USB прошивке, не работает для CAN или RS232.
• Поиск по CAN ID: применим только к CAN-устройствам, не работает для USB или RS232.
• Поиск по RS232 ID: применим только к RS232 прошивке, не работает для USB или CAN.
• Особенности RS232: RS232 прошивка обычно используется только для плат инструментов, а не для главного MCU.

Выберите способ по типу прошивки

USB прошивка Выполните следующую команду для поиска USB ID:

ls /dev/serial/by-id/*

USB мост CAN Выберите соответствующую команду в зависимости от вашей системы:

Fly_Armbian или обычный хост

~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0

Fly_FAST система

python ~/klipper/scripts/canbus_query.py can0

RS232 прошивка Выполните следующую команду для поиска пути RS232:

ls /dev/serial/by-path/*

Расшифровка результатов

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

После выполнения команды в терминале отобразится подобный идентификатор (пример):

• ✅ Можно использовать: если в поле usb- указано Klipper
• ⚠️ Нужно перепрошить: если в поле usb- указано katapult

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

После выполнения команды:

• ✅ Можно использовать: если в поле Application: указано Klipper.
• ⚠️ Нужно перепрошить: если в поле Application: указано CANBOOT или Katapult.
• ❌ Устройство не найдено: если отображается Total 0 uuids found, возможные причины:
  • Ошибка настройки CAN-сети
  • Несоответствие скорости CAN (убедитесь, что скорость совпадает у хоста, основной платы и платы инструментов)
  • Идентификатор уже используется (отключите его в конфигурации, затем выключите питание и перезапустите)

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

После выполнения команды в терминале отобразится путь к устройству RS232 (пример):

• /dev/serial/by-path/platform-3f980000.usb-usb-0:1.2:1.0-port0

Особенности конфигурации RS232

Для RS232 устройства необходимо указать скорость передачи и способ перезагрузки:

[mcu toolboard]
serial: <замените на найденный путь RS232>
baud: 250000
restart_method: command

---

Шаг 4: Настройка идентификатора основного MCU

Подготовка

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

Откройте файл printer.cfg, найдите строку serial: /tmp/klipper_host_mcu в секции [mcu].

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

USB подключение

Замените /tmp/klipper_host_mcu в serial: на найденный USB ID.

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

# Найденный USB ID:
# /dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00

# Измененная конфигурация:
[mcu]
serial: /dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00

CAN подключение

Замените serial: /tmp/klipper_host_mcu на canbus_uuid: и укажите найденный CAN ID.

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

# Найденный CAN ID:
# 688e89f0e401

# Измененная конфигурация:
[mcu]
canbus_uuid: 688e89f0e401

Сохраните конфигурацию и перезапустите службу Klipper.

---

Шаг 5: Проверка подключения основного MCU

После настройки основного MCU проверьте подключение:

1. Откройте интерфейс Fluidd, нажмите System в левом меню
2. Проверьте информацию о MCU: в разделе Mcu Information найдите информацию о микроконтроллере
3. Сравните модель: убедитесь, что отображаемая модель совпадает с моделью вашего контроллера

Ключевые моменты

• Если ваш контроллер — STM32H723, в Micro-Controller должно отображаться H723
• Если отображается неверная модель или MCU не распознается, проверьте предыдущие шаги

---

Шаг 6: Добавление MCU платы инструментов

После успешной проверки основного MCU добавьте плату инструментов:

1. Подключите плату инструментов: снова подключите кабель платы инструментов к хосту или основной плате
2. Откройте файл printer.cfg: добавьте конфигурацию платы инструментов в конец файла
3. Укажите ID платы инструментов: в зависимости от типа прошивки добавьте соответствующий ID

Об именах MCU

Имена mcu1, mcu2 и т.д. используются только для различения устройств. Вы можете использовать любые уникальные имена.

Формат конфигурации:

[mcu mcu1]
# Укажите ID платы инструментов

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

USB плата инструментов

[mcu mcu1]
serial: /dev/serial/by-id/usb-Klipper_stm32f446xx_54321-if00

CAN плата инструментов

[mcu mcu1]
canbus_uuid: 688e89f0e402

RS232 плата инструментов

[mcu mcu1]
serial: /dev/serial/by-path/platform-3f980000.usb-usb-0:1.2:1.0-port0
baud: 250000
restart_method: command

Важно:

• Каждое MCU должно иметь уникальный ID. Убедитесь, что ID платы инструментов отличается от ID основного MCU и других устройств
• Имена MCU можно изменить (например, toolboard, extruder_mcu и т.д.), главное — уникальность
• Используйте только проверенные и найденные ранее ID платы инструментов
• Для RS232 необходимо указать параметры baud: 250000 и restart_method: command
• При настройке нескольких плат инструментов укажите разные имена для каждого устройства

После завершения сохраните и перезапустите Klipper.

---

Шаг 7: Проверка всех подключений MCU

После добавления платы инструментов и перезагрузки Klipper проверьте состояние всех MCU:

1. Откройте интерфейс Fluidd, нажмите System в левом меню
2. Проверьте информацию о MCU: убедитесь, что все MCU распознаны
3. Проверьте статус каждого MCU: основной MCU и плата инструментов должны отображаться как подключенные

Ключевые моменты

• Основной MCU и все платы инструментов должны быть в списке
• Статус каждого MCU должен быть "Подключено"
• Если какой-либо MCU не отображается или не подключается, проверьте конфигурацию и физическое подключение

---

Шаг 8: Проверка версии прошивки

После подключения всех MCU проверьте совместимость версий прошивки:

1. Откройте интерфейс Fluidd, нажмите System в левом меню
2. Проверьте версию: в разделе Mcu Information найдите поле Version
3. Сравните версии: убедитесь, что версия прошивки всех MCU совпадает с версией Klipper на хосте

Совместимость версий

• Самостоятельно скомпилированная прошивка: за исключением преднастроенных устройств, все самодельные прошивки должны соответствовать версии Klipper на хосте
• Система Fly-FAST: версия прошивки в системе FAST соответствует версии системы, скомпилированная прошивка Klipper соответствует версии системы
• Последствия несовпадения версий: несовпадающие версии могут привести к сбоям, проблемам с коммуникацией или нестабильной работе системы

Ключевые моменты:

• Поле Version для основного MCU и всех плат инструментов должно быть заполнено и совпадать
• Если версии не совпадают, перепрошейте соответствующие устройства

---

Шаг 9: Восстановление и обновление конфигурации

После успешного подключения всех MCU восстановите оригинальную конфигурацию и обновите настройки MCU:

1. Удалите текущий файл конфигурации

   • Найдите и удалите файл printer.cfg в интерфейсе управления конфигурацией

2. Восстановите резервную копию

   • Переименуйте файл printer_Backup.cfg в printer.cfg

3. Обновите настройки MCU

   • Откройте восстановленный файл printer.cfg
   • Найдите исходную секцию [mcu] и обновите её, используя найденные ранее ID:

   USB подключение:

   [mcu]
   serial: /dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00
   # Замените на реальный ID основного MCU

   CAN подключение:

   [mcu]
   canbus_uuid: 688e89f0e401
   # Замените на реальный CAN UUID основного MCU

4. Обновите настройки платы инструментов (если есть)

   • Найдите секции [mcu] для плат инструментов
   • Обновите ID в зависимости от способа подключения:

   USB плата инструментов:

   [mcu toolboard]
   serial: /dev/serial/by-id/usb-Klipper_stm32f446xx_54321-if00

   CAN плата инструментов:

   [mcu toolboard]
   canbus_uuid: 688e89f0e402

   RS232 плата инструментов:

   [mcu toolboard]
   serial: /dev/serial/by-path/platform-3f980000.usb-usb-0:1.2:1.0-port0
   baud: 250000
   restart_method: command

5. Сохраните и перезапустите

   • После обновления всех настроек MCU нажмите SAVE & RESTART, чтобы сохранить и перезапустить Klipper
   • Перейдите на страницу System, убедитесь, что все MCU подключены нормально

Важные советы

• Убедитесь, что вы используете реальные ID, найденные при тестировании подключения
• Если у вас несколько плат инструментов, обновите ID для каждой секции [mcu]
• Для RS232 плат инструментов обязательно указать параметры baud: 250000 и restart_method: command
• После восстановления конфигурации все настройки принтера (шаговые двигатели, концевые выключатели и т.д.) останутся без изменений

Теперь устранение проблемы с подключением MCU и восстановление конфигурации завершены.