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

Область применения

Данное руководство предназначено для устранения неполадок, когда основной MCU не может корректно подключиться к Klipper. Если устройство подключается正常но, и вам нужно лишь заменить или дополнить MCU ID, перейдите непосредственно к разделу Конфигурация MCU ID, не очищая существующую конфигурацию.

Порядок устранения неполадок

1. Создайте резервную копию текущего printer.cfg.
2. Включайте минимальную тестовую конфигурацию только в том случае, если невозможно进入 Klipper.
3. Определите тип прошивки, работающей на плате в данный момент.
4. Запросите реальный MCU ID и запишите его во временную конфигурацию для проверки подключения.
5. Восстановите полную конфигурацию, обновив в ней только параметры подключения MCU.

Проверяйте только одно устройство за раз

При подключении нескольких USB/CAN-устройств легко по ошибке вписать ID инструментальной платы в [mcu] основной платы. На этапе устранения неполадок рекомендуется проверять только основную плату, а инструментальные платы добавлять по одной лишь после успешного подтверждения.

Шаг первый: Создание резервной копии текущей конфигурации

1. Вход в менеджер файлов конфигурации

Введите IP-адрес хоста в браузере. Пользователи Fluidd нажимают на ... слева, пользователи Mainsail нажимают Машина, затем находят printer.cfg.

Loading...

Loading...

Loading...

2. Создание резервной копии

Щелкните правой кнопкой мыши по printer.cfg, выберите Duplicate и переименуйте копию в:

printer_Backup.cfg

Пример для Fluidd:

Loading...

Пример для Mainsail:

Loading...

Не пропускайте резервное копирование

Последующая минимальная конфигурация предназначена только для тестирования подключения и не может заменить официальную конфигурацию принтера. Продолжайте только после того, как убедитесь, что printer_Backup.cfg существует и его содержимое полно.

Проверьте include с подстановочными знаками

Если в официальной конфигурации используется [include *.cfg], printer_Backup.cfg в том же каталоге также может быть загружен. Переместите резервную копию в подкаталог, который не соответствует этому правилу, или сохраните её с расширением .txt, чтобы избежать дублирования секций конфигурации.

Шаг второй: Включение минимальной тестовой конфигурации по мере необходимости

Когда этот шаг можно пропустить

Если Klipper в настоящее время正常но запускается и подключается, и вам нужно только изменить MCU ID, сохраните полную конфигурацию и переходите сразу к Шагу третьему.

Когда ошибочная конфигурация или несколько устройств мешают запуску Klipper, можно временно заменить содержимое printer.cfg на следующую минимальную конфигурацию:

[mcu]
serial: /tmp/klipper_host_mcu

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

Нажмите SAVE & RESTART для сохранения. /tmp/klipper_host_mcu здесь — это временный адрес подключения Host MCU хоста, используемый только для запуска минимальной конфигурации, это не реальный USB ID платы.

Работы при отключенном питании

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

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

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

Сначала войдите на хост по Руководству по SSH-подключению, затем выполните:

lsusb

Определите текущий режим устройства по выводу:

VID:PID	Статус устройства	Следующий шаг
1d50:614e	Прошивка Klipper USB	Запрос USB ID
1d50:606f	Прошивка USB-to-CAN моста	Запрос CAN UUID
1d50:6177	Режим прошивки Katapult	Сначала прошейте или запустите прошивку Klipper
1a86:7523	USB-адаптер последовательного порта	Запрос пути RS232

Loading...

Loading...

Если отображается lsusb: command not found, установите usbutils:

sudo apt-get update
sudo apt-get install usbutils

lsusb не показывает целевое устройство

Сначала убедитесь, что плата正常но запитывается, кабель данных поддерживает связь, а режим прошивки корректен. Не угадывайте ID по названию устройства и не записывайте ID режима Katapult/Bootloader в printer.cfg.

Шаг четвертый: Запрос и заполнение MCU ID

USB-платы

ls /dev/serial/by-id/*

Вывод должен содержать usb-Klipper_.... Устройства, содержащие katapult или Bootloader, все еще находятся в режиме прошивки и не могут использоваться как ID для работы Klipper.

CAN-платы

• Обычный Linux-хост
• Хост FlyOS-FAST / FLY

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

python3 ~/klipper/scripts/canbus_query.py can0

В конфигурацию можно записывать только UUID, соответствующий Application: Klipper. Если отображается Total 0 uuids found, перейдите к разделу Поиск CAN-сети и ID для дальнейшего устранения неполадок.

Устройства RS232

ls -l /dev/serial/by-path/

Следующие правила используют общее содержимое с FAQ:

Пояснение по настройке ID MCU

ID MCU в Klipper относится к идентификационной информации, используемой для подключения платы управления в секциях конфигурации [mcu] или [mcu xxx]. В зависимости от способа связи запись различается:

Способ подключения	Элемент конфигурации	Пример
USB прошивка	serial:	serial: /dev/serial/by-id/usb-Klipper_xxxxxxxxxxxx
CAN прошивка	canbus_uuid:	canbus_uuid: xxxxxxxxxxxx
Устройство RS232	serial:	serial: /dev/serial/by-path/xxxxxxxxxxxx
MCU хост-компьютера	serial:	serial: /tmp/klipper_host_mcu

Правила заполнения:

1. Основная плата по умолчанию использует [mcu], а инструментальная или расширительная плата использует пользовательские имена, такие как [mcu tool], [mcu toolboard].
2. Для USB прошивки заполняется только serial:, для CAN прошивки — только canbus_uuid:, не оставляйте оба элемента одновременно в одном [mcu].
3. В машинах с несколькими MCU каждый [mcu xxx] должен использовать свой реальный идентификатор, не копируйте один и тот же USB ID или CAN UUID.
4. Имя [mcu xxx] влияет на префикс выводов, например, для [mcu tool] вывод должен быть записан как tool:gpio13; регистр имени должен быть согласован.
5. xxxxxxxx в примерах документации нельзя использовать напрямую, его необходимо заменить на фактический найденный идентификатор.
6. Для устройств RS232, помимо serial:, обычно также необходимо указать baud: 250000 и restart_method: command; следуйте документации соответствующего продукта.

Частые ошибки:

• Использование ID режима прошивки (например, ID, содержащий katapult, canboot) в качестве ID прошивки Klipper.
• В USB прошивке указан canbus_uuid:, или в CAN прошивке остался старый serial:.
• Устройство RS232 заполнено только путём, при этом пропущены необходимые baud: или restart_method:.
• Инструментальная плата настроена как [mcu], что перекрывает конфигурацию MCU основной платы.
• Префикс вывода не соответствует имени MCU, например, конфигурация [mcu toolboard], а вывод записан как tool:gpio13.

Запрос USB ID: Для USB прошивки выполните ls /dev/serial/by-id/* для получения идентификатора.

Запрос CAN ID: Поиск сети CAN и идентификатора

Запрос пути RS232: Выполните ls -l /dev/serial/by-path/ для получения стабильного пути к устройству.

Конфигурация инструментальной платы: Добавление MCU инструментальной платы и кросс-платная конфигурация

Полные инструкции по запросу и примеры с несколькими MCU: Конфигурация MCU ID

Шаг пятый: Проверка основного MCU

Обновите адрес подключения в [mcu] на только что полученный реальный ID. Если на втором шаге была включена минимальная конфигурация, замените в ней /tmp/klipper_host_mcu; если сохранили официальную конфигурацию, измените только serial: или canbus_uuid: в существующем [mcu], не трогая другие параметры.

• USB-плата
• CAN-плата

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

[mcu]
canbus_uuid: 688e89f0e401

Нажмите SAVE & RESTART. После успешного подключения:

1. Откройте страницу System в Fluidd.
2. Найдите основной MCU в Mcu Information.
3. Сверьте Micro-Controller с фактической моделью основного контроллера платы.

Ключевые моменты проверки

• [mcu] должен соответствовать основной плате, а не отображаться как модель инструментальной платы.
• Версии прошивок всех MCU должны быть совместимы с текущей системой Klipper.
• Если подключение по-прежнему не удается, перейдите в раздел Устранение неполадок подключения согласно тексту ошибки.

Loading...

Шаг шестой: Восстановление полной конфигурации принтера

Обязательно восстановите официальную конфигурацию

Если на втором шаге была включена минимальная конфигурация, после завершения проверки подключения необходимо восстановить официальную конфигурацию. Не используйте длительное время тестовую конфигурацию, содержащую только [mcu] и kinematics: none.

Использование минимальной конфигурации

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

1. Переименуйте текущий временный printer.cfg в printer_MCU_Test.txt, сохранив его для повторной проверки и избегая загрузки через подстановочный знак *.cfg.
2. Скопируйте предыдущий printer_Backup.cfg и назовите копию printer.cfg.
3. Откройте восстановленный printer.cfg и найдите исходный блок конфигурации [mcu].
4. Обновите только serial: или canbus_uuid:, не перезаписывая параметры шаговых двигателей, нагревателей, концевых выключателей и другие параметры принтера.
5. Нажмите SAVE & RESTART, затем снова войдите в Mcu Information для подтверждения подключения.

Если резервная копия отсутствует или её содержимое неполное, сначала восстановите полную конфигурацию из истории конфигураций, не продолжая перезаписывать текущий файл.

Пропуск минимальной конфигурации

Текущий printer.cfg уже является официальной конфигурацией, переименование или восстановление файла не требуется. Подтвердите успешное подключение MCU и сохраните резервную копию, созданную на первом шаге.

Шаг седьмой: Добавление инструментальной платы

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

Инструментальная плата и конфигурация с несколькими MCU: Добавление MCU инструментальной платы и межплатная конфигурация