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

Эта страница предназначена для добавления платы инструментов, проверки состояния нескольких MCU и настройки межплатных выводов после успешного подключения главного MCU. Если вы еще не завершили проверку подключения главного MCU, сначала выполните Руководство по подключению MCU.

Предварительные требования

Перед добавлением платы инструментов убедитесь:

• Главный MCU прошел проверку подключения в соответствии с Руководством по подключению MCU.
• На плату инструментов прошита прошивка.
• Кабель данных платы инструментов подключен к соответствующему интерфейсу хост-компьютера или материнской платы (CAN/USB/RS232).

Запрос ID платы инструментов

Способ запроса ID платы инструментов зависит от ее коммуникационного интерфейса. Полные правила заполнения MCU ID см. в Конфигурация MCU ID. Ниже приведено краткое руководство:

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

Войдите на хост-компьютер по SSH и выполните следующую команду для просмотра всех USB-последовательных устройств:

ls /dev/serial/by-id/*

Пример вывода:

/dev/serial/by-id/usb-Klipper_stm32f446xx_54321-if00

Отличие прошивки Klipper от режима прошивки

ID в режиме прошивки обычно содержит katapult или stm32duino (например, usb-katapult_stm32f446xx_...). Убедитесь, что используется ID в режиме прошивки Klipper, а не ID в режиме прошивки.

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

• SSH командная строка
• FlyOS-FAST / FLY хост-компьютер

Войдите на хост-компьютер по SSH и выполните следующую команду для поиска UUID CAN-устройства:

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

Пример вывода:

Found canbus_uuid=688e89f0e402, Application: Klipper

На хост-компьютере FAST или FLY выполните поиск с помощью python3:

python3 ~/klipper/scripts/canbus_query.py can0

В системе FAST CAN0 предустановлен на скорость 1M, буфер 1024, обычно не требуется ручная настройка.

UUID CAN и UUID CANBoot

UUID прошивки Klipper на CAN-плате инструментов отличается от UUID прошивки CANBoot. Если в приложении отображается CANBOOT или Katapult, это означает, что устройство находится в режиме прошивки. Для подробного поиска неисправностей см. Сеть CAN и поиск ID.

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

Войдите на хост-компьютер по SSH и выполните следующую команду для просмотра пути к USB-последовательному устройству:

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

Пример вывода:

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

Примечания по настройке RS232

Для платы инструментов с RS232 необходимо дополнительно настроить параметры baud: 250000 и restart_method: command, иначе связь не будет работать.

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

После получения ID платы инструментов добавьте соответствующий раздел конфигурации MCU в конец файла printer.cfg:

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

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

[mcu toolboard]
canbus_uuid: 688e89f0e402

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

Правила именования

• Имя MCU может быть полностью произвольным, например toolboard, tool, extruder_mcu и т.д., главное, чтобы оно было уникальным в конфигурации.
• Имя MCU будет использоваться в качестве префикса для межплатных выводов, например, при ссылке на [mcu toolboard] пишется toolboard:PA0. Регистр имени должен совпадать.
• Имя и ID каждого MCU должны быть уникальными и не могут повторяться с главным MCU или другими платами инструментов.
• При настройке нескольких плат инструментов установите для каждого устройства разные имена для различения.

После завершения настройки нажмите SAVE & RESTART, чтобы сохранить и перезапустить Klipper.

Проверка подключения всех MCU

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

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

Loading...

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

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

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

Примечания о совместимости версий

• За исключением предварительно настроенных пользовательских устройств, все самостоятельно скомпилированные прошивки должны соответствовать версии Klipper на хост-компьютере.
• Версия прошивки системы FAST соответствует версии системы, скомпилированная прошивка Klipper соответствует версии системы.
• Разные версии прошивки могут привести к сбоям в работе, ошибкам связи или нестабильности системы.

Обновление основного конфигурационного файла

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

Если вы в Руководстве по подключению MCU создали резервную копию printer_Backup.cfg в соответствии с процедурой, этот раздел предназначен для записи проверенного MCU ID в полную конфигурацию. Если вы используете официальный конфигурационный файл, этот раздел можно пропустить.

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

1. Удалите текущий временный файл printer.cfg в интерфейсе управления конфигурацией.
2. Переименуйте ранее сохраненный printer_Backup.cfg в printer.cfg.
3. Откройте восстановленный printer.cfg, найдите разделы [mcu] и [mcu <имя>] и обновите их проверенными реальными ID.
4. Нажмите SAVE & RESTART, чтобы сохранить и перезапустить Klipper.

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

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

Межплатная конфигурация выводов для нескольких плат инструментов

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

Основной принцип

В конфигурации Klipper с несколькими MCU выводы в любом разделе конфигурации могут ссылаться на выводы любого определенного MCU напрямую в формате <имя_MCU>:<номер_вывода>, без дополнительной настройки. Klipper автоматически отправляет команды на соответствующий MCU через коммуникационную шину (CAN/USB/последовательный порт).

Типичный сценарий: нагрев на плате инструментов, датчик температуры на материнской плате

Предположим, конфигурация системы выглядит следующим образом:

• Главный MCU: запускает прошивку хоста Klipper на хост-компьютере, датчик температуры подключен к материнской плате.
• toolboard1: плата инструментов, нагреватель и шаговый двигатель экструдера подключены к плате инструментов.

Шаг 1: Определение всех MCU

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

[mcu toolboard1]
canbus_uuid: e51d5c71a901

Шаг 2: Прямое межплатное указание выводов в конфигурации

[extruder]
# Шаговый двигатель и нагрев используют выводы платы инструментов
step_pin: toolboard1:<step_pin>
dir_pin: toolboard1:<dir_pin>
enable_pin: !toolboard1:<enable_pin>
heater_pin: toolboard1:<heater_pin>

# Датчик температуры использует вывод материнской платы
sensor_type: ATC Semitec 104GT-2
sensor_pin: <sensor_pin>

rotation_distance: 22.44
gear_ratio: 50:17
microsteps: 16
full_steps_per_rotation: 200
nozzle_diameter: 0.400
filament_diameter: 1.75
min_temp: -235
max_temp: 350
max_power: 1.0
min_extrude_temp: 170
control: watermark

Правила именования выводов

• Формат вывода платы инструментов: <имя_MCU>:<номер_вывода>, например toolboard1:<heater_pin>.
• Выводы главного MCU могут быть записаны напрямую фактическим именем вывода, без префикса.
• Выводы в одном разделе конфигурации могут принадлежать разным MCU, Klipper автоматически обрабатывает межплатную связь.

Дополнительные примеры межплатной конфигурации

• Датчик температуры на второй плате инструментов
• Несколько экструдеров на разных платах инструментов
• Межплатное управление вентилятором

Нагреватель на первой плате инструментов, датчик температуры на второй плате инструментов:

[extruder]
step_pin: toolboard1:<step_pin>
heater_pin: toolboard1:<heater_pin>
sensor_type: ATC Semitec 104GT-2
sensor_pin: toolboard2:<sensor_pin>

Два экструдера подключены к разным платам инструментов:

[extruder]
step_pin: toolboard1:<step_pin>
heater_pin: toolboard1:<heater_pin>
sensor_pin: toolboard1:<sensor_pin>

[extruder1]
step_pin: toolboard2:<step_pin>
heater_pin: toolboard2:<heater_pin>
sensor_pin: toolboard2:<sensor_pin>

Экструдер на плате инструментов, вентилятор модели подключен к материнской плате:

[fan]
pin: <fan_pin>

[heater_fan throat_fan]
pin: toolboard1:<fan_pin>
heater: extruder
heater_temp: 50
fan_speed: 1.0

Примечания

• При межплатном указании выводов убедитесь, что соответствующий MCU правильно определен в конфигурационном файле с помощью [mcu <имя>].
• Регистр имени MCU должен совпадать, [mcu ToolBoard] и ссылка toolboard:PA0 приведут к ошибке.
• Рекомендуется подключать функционально связанные устройства (например, нагреватель и датчик температуры) к одной плате инструментов для достижения наилучшей скорости отклика и надежности.

Часто задаваемые вопросы

Проблема	Направление поиска
Плата инструментов не в сети	Проверьте подключение кабеля данных, убедитесь в правильности ID, различайте ID прошивки Klipper и ID режима прошивки
Конфликт имен/ID нескольких плат инструментов	Имя и ID каждого [mcu] должны быть уникальны, см. Конфигурация MCU ID
Несовпадение префикса вывода	Префикс вывода для [mcu toolboard] должен быть toolboard:, регистр имени должен совпадать
Несовместимость версий прошивки	Перекомпилируйте прошивку, чтобы она соответствовала версии Klipper на хост-компьютере
UUID CAN не найден	См. Сеть CAN и поиск ID
Сбой связи RS232	Проверьте, настроены ли baud: 250000 и restart_method: command