Важное примечание

Внимание

Данное руководство посвящено подключению платы инструментов и поиску её ID. Соответствующие шаги не применимы к основной плате, обратите на это внимание.
Если вы не используете плату инструментов, проигнорируйте это руководство.

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

Получение USB ID
Получение CANBus UUID
Использование RS232

Подготовьте USB-кабель с функцией передачи данных. Для очень длинных кабелей рекомендуется использовать кабель с ферритовым кольцом.
Подключите плату инструментов к хост-компьютеру с помощью USB-кабеля.

Примечания

Важно

Необходимо подключиться к хост-компьютеру через SSH, используйте сетевой способ подключения к хост-компьютеру (например, Raspberry Pi)
Перед началом работы убедитесь, что на материнскую плату прошита USB-прошивка
Данное руководство применимо только для поиска ID материнской платы, не подходит для поиска ID инструментальной платы
Убедитесь, что материнская плата подключена через TYPEC к USB-порту хост-компьютера
Для просмотра ID инструментальной платы обратитесь к соответствующим руководствам в каталоге соответствующего продукта

Шаги выполнения

Поиск ID USB-устройства

Выполните следующую команду для вывода списка всех ID последовательных USB-устройств:
```
ls /dev/serial/by-id/*
```

⚠️ Важное замечание: Недопустимые ID

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

Особенности ID	Пояснение причины	Пример
`usb-1a86_USB_Serial-if00-port0`	Это имя по умолчанию для универсальных чипов последовательных интерфейсов, таких как CH340, недопустимо для конфигурации.	/dev/serial/by-id/usb-1a86_USB_Serial-if00-port0
Содержит `katapult`	Указывает, что устройство находится в режиме прошивки, необходимо сначала прошить прошивку Klipper перед использованием.	/dev/serial/by-id/usb-katapult_xxxxxxxxxxxx

Результат выполнения:

Нормальная ситуация: В терминале отобразится ID, похожий на приведенный ниже (изображение ниже только для примера)
Loading...
Поиск и устранение неисправностей

Обработка нескольких ID

Если появилось несколько ID, выберите соответствующий ID в зависимости от модели MCU вашей материнской платы

Введите ID USB в конфигурацию

В fluidd: {…}, нажмите на него, чтобы найти printer.cfg

В mainsail: Машина, нажмите на нее, чтобы найти printer.cfg

Примечание: Все ID в документе приведены для примера, фактические ID каждой материнской платы различаются, вносите изменения на основе полученного ID.

Заполнение USB ID

Найдите [mcu], затем замените

Необходимо знать

Измените в файле конфигурации:
Не настраивайте canbus_uuid:

[mcu]
serial: <замените на ID, который вы только что получили>

Справочный пример

Справочный пример для fluidd

Справочный пример для mainsail

Нажмите SAVE & RESTART в правом верхнем углу, после нажатия автоматически сохранится и перезапустится Klipper

Перед поиском ID подключите плату инструментов к UTOC или к основной плате с прошитым мостовым ПО с помощью кабеля XT30. Ниже приведена схема подключения для справки.
Убедитесь, что переключатели (DIP-переключатели) установлены в соответствующие положения.

Loading...

Убедитесь, что при отключенном питании сопротивление между CAN H и CAN L, измеренное мультиметром, составляет около 60Ω. Если оно равно 120Ω, необходимо установить перемычку 120Ω. Если около 40Ω, перемычку необходимо удалить.

Полное руководство по настройке платы CAN

Подготовка

Важные условия

Состояние платы: Убедитесь, что плата прошита прошивкой Klipper-can или находится в режиме Katapult-can
Примечание: Данное руководство предназначено только для поиска ID платы инструмента, не подходит для поиска ID материнской платы
Требования к подключению: Плата инструмента должна быть подключена к одному из следующих устройств:
- Модуль UTOC
- Материнская плата с прошивкой USB-мост CAN
Конечное подключение: Указанные выше устройства должны быть подключены к верхнему компьютеру

Требования к настройке CAN-сети

Конфигурация по умолчанию: Данное руководство предполагает, что CAN-сеть уже настроена на верхнем компьютере
Пользователи Fly: Если используется Fly-верхний компьютер и система Fly-FAST, CAN настроен по умолчанию (скорость 1 Мбит/с)
Первое использование: Обязательно ознакомьтесь с руководством ниже: Руководство по настройке CAN

Подключение SSH

Войдите в SSH через сеть (не используйте последовательный порт)
Убедитесь, что верхний компьютер и устройства CAN-сети подключены нормально

Поиск CAN ID

Команда поиска для обычного верхнего компьютера
```
~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0
```
Команда поиска для FLY-верхнего компьютера
```
python3 ~/klipper/scripts/canbus_query.py can0
```

Описание результатов поиска

CANID

Примечание: ID материнской платы уже настроен в Klipper в предыдущих документах, в обычных условиях невозможно найти CANID материнской платы
Быстрый метод проверки: Если необходимо подтвердить, сначала отключите CAN-кабель между материнской платой и платой инструмента, затем повторно выполните поиск

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

Результат	Описание состояния	Дальнейшие действия
`Application: Klipper`	Устройство прошито прошивкой Klipper	Можно использовать данный ID
`Application: CANBOOT` или `Katapult`	Устройство находится в режиме загрузчика	Необходимо прошить прошивку Klipper перед использованием
`Total 0 uuids found`	Устройства не найдены	Проверьте следующие проблемы: 1. Правильно ли настроена CAN-сеть 2. Совпадает ли скорость CAN (по умолчанию 1 Мбит/с) 3. Не используется ли данный ID в конфигурации (необходимо закомментировать, затем сохранить и перезагрузить с выключением питания)

О повторяющихся ID

Если ID устройства уже настроен в printer.cfg, он не будет отображаться в результатах поиска. Для повторного поиска необходимо:

Закомментировать ID устройства в файле конфигурации
Сохранить конфигурацию и перезапустить Klipper
Выключить и включить питание всех устройств

Настройка ID CAN-устройства

1. Получение файла конфигурации

В зависимости от используемого веб-интерфейса найдите файл printer.cfg:

Fluidd
Нажмите на значок {...} на левой панели навигации, найдите printer.cfg

Mainsail
Нажмите на Машина на верхней панели навигации, найдите printer.cfg

2. Добавление конфигурации устройства

Добавьте конфигурацию платы инструмента в printer.cfg:

[mcu toolboard]
canbus_uuid: <здесь укажите найденный ID>

Пояснение к конфигурации

toolboard — это имя платы инструмента, измените в соответствии с реальной ситуацией
Если это ID материнской платы, раздел конфигурации должен быть [mcu]
В нормальной конфигурации материнская плата использует [mcu], а плата инструмента — [mcu toolboard]

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

Нажмите кнопку SAVE & RESTART в правом верхнем углу
Система автоматически сохранит конфигурацию и перезапустит Klipper

Внимание

Все ID, указанные в документации, являются примерами. Фактические ID каждой материнской платы отличаются. Измените их в соответствии с реально полученным ID.

Перед поиском ID подключите плату инструментов к UTOR или G2T с помощью кабеля XT30. Ниже приведена схема подключения для справки.

Убедитесь, что переключатели (DIP-переключатели) установлены в соответствующие положения.

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

Меры предосторожности

Важная подготовка

Требования к прошивке:
Панель инструментов должна быть прошита RS232-прошивкой, иначе связь невозможна
Обязательное соединение GND:
⚠️ Перед подключением панели инструментов необходимо соединить GND панели и материнской платы (достаточно использовать общий источник питания 24V/12V)

Меры предосторожности по RS232

RS232 поддерживается только на платах D8, D8PRO и C8P, остальные платы не поддерживают RS232
Для неподдерживаемых плат необходимо использовать G2T или UTOR для подключения

Поиск RS232 ID

Откройте браузер, введите IP-адрес верхнего компьютера в адресной строке, например, мой верхний компьютер имеет IP 192.168.101.179, просто введите и нажмите Enter

Откройте WEB-интерфейс верхнего компьютера, в боковом меню слева найдите параметры конфигурации:

В fluidd: {…}, нажмите на него, затем найдите printer.cfg

В mainsail: Машина, нажмите на нее, затем найдите printer.cfg

Нажмите на printer.cfg, затем нажмите DEVICES в правом верхнем углу

Нажмите SERIAL, затем обновите

Обновление в fluidd

Обновление в mainsail

Скопируйте ID, нажав на указанную стрелку

В fluidd убедитесь, что существует ch341-uart, затем нажмите Path_by_hardware — это и есть RS232_ID

В mainsail убедитесь, что существует CH341-UART, затем нажмите Path_by_hardware — это и есть RS232_ID

Примечания

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

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

Ниже приведена примерная конфигурация
Примечания
- toolboard в конфигурации ниже — это название панели инструментов, если у вас другое название, замените его на соответствующее
Опасность
[mcu toolboard] serial: <замените на ID, который вы только что нашли> baud: 250000 restart_method: command
- При добавлении ID панели инструментов обязательно используйте [mcu toolboard], затем serial: и найденный ID панели инструментов
- Ниже приведена примерная конфигурация
- Обратите внимание, что данное руководство предназначено для поиска и настройки ID панели инструментов, при нормальном состоянии она уже должна быть подключена к материнской плате
- Материнская плата всегда имеет обозначение [mcu], а панель инструментов — [mcu toolboard]
- Нажмите SAVE & RESTART в правом верхнем углу, после нажатия конфигурация автоматически сохранится и klipper перезапустится

Опасность

Внимание: все ID, указанные в документации, являются примерами, фактические ID каждой платы различны. Пожалуйста, введите фактически полученный ID.

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

Примечания​

Шаги выполнения​

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

⚠️ Важное замечание: Недопустимые ID​

Результат выполнения:​

Введите ID USB в конфигурацию​

Заполнение USB ID​

Полное руководство по настройке платы CAN​

Подготовка​

Требования к настройке CAN-сети​

Подключение SSH​

Поиск CAN ID​

Описание результатов поиска​

Настройка ID CAN-устройства​

1. Получение файла конфигурации​

2. Добавление конфигурации устройства​

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

Поиск RS232 ID панели инструментов​

Меры предосторожности​

Меры предосторожности по RS232​

Поиск RS232 ID​

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

Примечания

Шаги выполнения

Поиск ID USB-устройства

⚠️ Важное замечание: Недопустимые ID

Результат выполнения:

Введите ID USB в конфигурацию

Заполнение USB ID

Полное руководство по настройке платы CAN

Подготовка

Требования к настройке CAN-сети

Подключение SSH

Поиск CAN ID

Описание результатов поиска

Настройка ID CAN-устройства

1. Получение файла конфигурации

2. Добавление конфигурации устройства

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

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

Меры предосторожности

Меры предосторожности по RS232

Поиск RS232 ID

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