メインコンテンツにスキップ

MCU ID 設定

このページでは、Klipper におけるメインボード、ツールボード、CAN デバイス、およびホスト MCU の ID 記入ルールについて集中的に説明します。接続関連の問題を設定する際は、まず通信方式を確認し、対応する serial: または canbus_uuid: を記入してください。

バックアップや最小構成から完全に調査する必要がある場合: メイン MCU 接続ガイド

MCU ID の確認​

ID を記入する前に、SSH でホストにログインし、対応するコマンドを実行して実際のデバイス識別子を取得する必要があります。

USB デバイス​

ls /dev/serial/by-id/*

出力例（usb-Klipper_... は Klipper ファームウェアモードでの ID）：

/dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00
ファームウェア ID と書き込み ID の区別
  • Klipper ファームウェア ID 例：usb-Klipper_stm32h723xx_12345-if00
  • 書き込みモード ID 例：usb-katapult_stm32h723xx_12345-if00（katapult を含む）
  • 書き込みモード ID 例：usb-STM32_Bootloader_xxxxxxxxxxxx（Bootloader を含む）

設定ファイルでは Klipper ファームウェアモードの ID を使用する必要があります。書き込みモードの ID しか見えない場合、ツールボードが Klipper ファームウェアの動作状態に入っていないことを意味します。

CAN デバイス​

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

出力例：

Found canbus_uuid=688e89f0e402, Application: Klipper
複数の CAN UUID

Application が CANBOOT または Katapult と表示される UUID は書き込みモードでの ID であり、printer.cfg に直接使用することはできません。詳細な調査については CAN ネットワークと ID 検索 を参照してください。

ホスト MCU​

ホストの Linux プロセスを使用して MCU（[mcu host]）をシミュレートする場合、そのシリアルポートは固定です：

[mcu host]
serial: /tmp/klipper_host_mcu

RS232 デバイス​

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

出力例：

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

ツールボード設定: ツールボード MCU の追加とクロスボード設定

MCU ID 設定説明​

Klipper における MCU ID とは、[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
ホスト MCUserial:serial: /tmp/klipper_host_mcu

記入ルール：

  1. メインボードはデフォルトで [mcu] を使用し、ツールボードや拡張ボードは [mcu tool]、[mcu toolboard] などのカスタム名を使用します。
  2. USB ファームウェアは serial: のみ、CAN ファームウェアは canbus_uuid: のみを記入し、同じ [mcu] 内に両方を同時に保持しないでください。
  3. 複数 MCU のマシンでは、各 [mcu xxx] がそれぞれ独自の実際の ID を使用する必要があり、同じ USB ID や CAN UUID をコピーしないでください。
  4. [mcu xxx] の名前はピン接頭辞に影響します。例えば、[mcu tool] のピンは tool:gpio13 のように記述します。名前の大文字小文字は統一してください。
  5. ドキュメントの例にある xxxxxxxx はそのまま使用できず、実際に検索した ID に置き換える必要があります。
  6. RS232 デバイスでは、serial: の他に通常 baud: 250000 と restart_method: command の記入も必要です。対応する製品ドキュメントに従ってください。

よくあるエラー：

  • 書き込みモードの ID（katapult、canboot を含む ID など）を Klipper ファームウェアの ID として使用する。
  • USB ファームウェアに canbus_uuid: を設定する、または CAN ファームウェアに古い serial: を残す。
  • RS232 デバイスでパスのみを記入し、必要な baud: や restart_method: を省略する。
  • ツールボードを [mcu] として設定し、メインボードの MCU 設定を上書きする。
  • ピン接頭辞と MCU 名が一致しない。例えば、設定が [mcu toolboard] なのにピンが tool:gpio13 と記述されている。

USB ID の確認方法：USB ファームウェアでは、ls /dev/serial/by-id/* を実行して ID を取得できます。

CAN ID の確認方法：CAN ネットワークと ID 検索

RS232 パス確認方法：ls -l /dev/serial/by-path/ を実行して安定したデバイスパスを取得します。

ツールボード設定：ツールボード MCU 追加とボード間設定

複数 MCU 設定例​

USB メインボード + CAN ツールボード​

USB メインボードは serial: で接続し、CAN ツールボードは canbus_uuid: で接続します：

[mcu]
serial: /dev/serial/by-id/usb-Klipper_xxxxxxxxxxxx

[mcu tool]
canbus_uuid: xxxxxxxxxxxx

[temperature_sensor ToolBoard]
sensor_type: temperature_mcu
sensor_mcu: tool

USB メインボード + USB ツールボード​

両方とも serial: で接続し、異なる ID で区別します：

[mcu]
serial: /dev/serial/by-id/usb-Klipper_mainboard_xxxxxxxxxxxx

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

CAN メインボード + CAN ツールボード​

両方とも canbus_uuid: を使用し、各 UUID は異なる必要があります：

[mcu]
canbus_uuid: aabbccddeeff

[mcu toolboard]
canbus_uuid: 112233445566

ホスト MCU + USB メインボード​

ホストは Linux プロセス MCU を実行し、メインボードは USB で接続します：

[mcu host]
serial: /tmp/klipper_host_mcu

[mcu]
serial: /dev/serial/by-id/usb-Klipper_xxxxxxxxxxxx

よくある誤り​

誤った方法正しい方法
書き込みモード ID を Klipper ID として使用するデバイスが Klipper ファームウェアに入ってから ID を確認する
USB ファームウェアに serial: と canbus_uuid: の両方を記入するUSB ファームウェアは serial: のみ、CAN ファームウェアは canbus_uuid: のみ記入する
ツールボードを [mcu] と記述し、メインボード設定を上書きするツールボードには [mcu toolboard] などのカスタム名を使用する
複数の MCU が同じ ID を共有する各 MCU は独自の一意の ID を使用する必要がある
ピン接頭辞と MCU 名が一致しない[mcu toolboard] のピンは toolboard:PA0 と記述し、名前の大文字小文字を一致させる
ドキュメント内の xxxxxxxx をそのままコピーして使用する実際に検索した実際の ID に置き換える必要がある

調査エントリ​

問題の症状調査エントリ
USB ID が見つからない、または [Errno 2]一般的なエラー概要
CAN UUID が無効、またはデバイスがオンラインでないCAN ネットワークと ID 検索
複数 MCU の切断、設定を更新できないシステム、パフォーマンス、サービスエラー
ツールボードの追加、クロスボードのピン設定ツールボード MCU の追加とクロスボード設定
ピン接頭辞、重複ピン、または MCU 名のエラー設定関連エラー
Loading...