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

MCU 接続ガイド

適用注意

本ガイドは、MCU が Klipper と正常に接続できない問題を調査および解決するためのものです。

準備と注意事項​

  • 推奨しないホスト機: Redmi スマートフォン、WiFi ドングル、セットトップボックスなどの使用は避けてください。これらのデバイスは、カスタムまたは修正されたシステムを採用していることが多く、MCU を正しく認識できない可能性があります。
  • 下位機の数を確認: 使用する下位機（ツールボードなど）の数を事前に確認してください。複数の下位機があると接続に影響することがあります。
  • 配線の簡略化: マザーボードとツールボードから、データケーブル以外のすべての配線を一時的に取り外し、必要なデータ接続のみを残して干渉を排除することをお勧めします。
  • 推奨操作インターフェース: Fluidd インターフェースの使用を推奨します。MCU の接続状態がより直感的に表示されます。

第一步：設定のバックアップとリセット​

1. ホスト機インターフェースにアクセス​

ブラウザにホスト機の IP アドレス（例：192.168.101.179）を入力してアクセスします。

Loading...

2. 設定ファイルの場所を特定​

WEB インターフェースに入り、左側のサイドバーで設定オプションを見つけます：

Fluidd ユーザー: ... をクリックし、printer.cfg を見つけます。

Loading...

Mainsail ユーザー: 機械をクリックし、printer.cfg を見つけます。

Loading...

3. 設定ファイルをバックアップ​

printer.cfg ファイルを右クリックし、Duplicate を選択してコピーし、コピーの名前を次のように変更します：

printer_Backup.cfg

Fluidd 操作例:

Loading...

Mainsail 操作例:

Loading...

4. 設定ファイルをリセット​

printer.cfg を再度開き、すべての内容を消去し、以下の基本設定を貼り付けます：

[mcu]
serial: /tmp/klipper_host_mcu

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

5. 保存して再起動​

  • 右上の SAVE & RESTART をクリックすると、Klipper は設定を保存してサービスを再起動します。
  • エラーが発生した場合は、とりあえず無視してください。
  • その後、すべてのデバイス（ホスト機とすべての下位機を含む）の電源を完全にオフにしてください。
  • 重要: 完全に電源をオフにすることが必須です。そうしないと、以降の手順を進めることができません。

第二步：デバイスの検出とファームウェアタイプの確認​

前提条件​

  • メインデバイスの順序: 最初の MCU はマザーボードである必要があり、ツールボードであってはなりません。
  • ファームウェアタイプ: FLY マザーボードのファームウェアが USB ファームウェア または USB ブリッジ CAN ファームウェア であることを確認してください。本ガイドは他のタイプには適用されません。
  • 接続方法: まず SSH に接続してください。この操作はネットワーク経由で行う必要があります。

操作手順​

  1. デバイス検出の実行

    • SSH 接続が成功したら、次のコマンドを実行します： 
      lsusb
    • システムは認識されたすべての USB デバイスをリスト表示します。

  2. コマンド異常への対処

    • lsusb コマンドが存在しないと表示された場合は、先にインストールします： 
      sudo apt-get install usbutils
    • 実行後、デバイスが何も表示されない場合は、ホスト機の交換を検討してください。

  3. デバイス情報の識別 以下の図を参考に、lsusb の出力結果からデバイスを識別します：

    Loading...
    Loading...

  4. ファームウェアタイプの検証

    • 書き込んだファームウェアに基づいて、lsusb の結果で以下のキー情報を確認します：
      • USB ファームウェア: 1d50:614e と表示されるはずです
      • USB ブリッジ CAN ファームウェア: 1d50:606f と表示されるはずです
      • USB Katapult ファームウェア: 1d50:6177 と表示されるはずです
      • RS232 アダプター (UTOR と併用、または D8 および D8PRO マザーボード使用時): 1a86:7523 と表示されるはずです (G2T と併用の場合はこの手順は不要です)

第三步：デバイス ID の検索​

重要事項​

  • 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 デバイス システムタイプに応じて、対応するコマンドを選択して CAN ID を検索します：

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

RS232 ファームウェアデバイス 次のコマンドを実行して RS232 デバイスパスを検索します：

ls /dev/serial/by-path/*

結果の解釈と処理​

USB ID 検索結果​

コマンド実行後、端末には以下のようなデバイス ID が表示されます（これは例です）：

  • ✅ そのまま使用可能: ID が usb- フィールドの後に Klipper と表示されている場合

  • ⚠️ ファームウェアの書き換えが必要: ID が usb- フィールドの後に katapult と表示されている場合

    Loading...

CAN ID 検索結果​

コマンド実行後、実際の状況に応じて判断します：

  • ✅ そのまま使用可能: 表示された ID の末尾 Application: フィールドに Klipper と表示されている場合。
  • ⚠️ ファームウェアの書き換えが必要: 表示された ID の末尾 Application: フィールドに CANBOOT または Katapult と表示されている場合。
  • ❌ デバイスが見つからない: Total 0 uuids found と表示された場合、考えられる原因は次のとおりです：
    • CAN ネットワーク設定の誤り
    • CAN レートの不一致（ホスト機、マザーボード、ツールボードのレートが一致していることを確認してください）
    • その ID が既に使用されている（設定で無効にしてから、シャットダウンし、電源をオフにして再起動する必要があります）
Loading...

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

第四步：メイン MCU の ID を設定​

準備作業

設定を開始する前に、ツールボードとホスト機またはマザーボードの接続を外していることを確認してください。デバイス認識の競合を避けるためです。

printer.cfg ファイルを再度開き、[mcu] セクション内の serial: /tmp/klipper_host_mcu 設定行を見つけます。

接続方法に応じて、以下の該当する方法を参照して設定します：

serial: の後の /tmp/klipper_host_mcu を、検索した USB ID に置き換えます。

設定例:

# 検索した USB ID:
# /dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00

# 設定を次のように変更:
[mcu]
serial: /dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00

設定を保存し、Klipper サービスを再起動します。

第五步：メイン MCU 接続の確認​

メイン MCU の設定後、接続が成功したか確認する必要があります：

  1. Fluidd インターフェースを開き、左側メニューの System をクリックします
  2. MCU 情報を確認: Mcu Information の下にある Micro-Controller 情報を見つけます
  3. メインコントローラーの型番を確認: 表示された型番が、マザーボードの実際のメインコントローラーの型番と一致していることを確認します
確認ポイント
  • メインコントローラーが STM32H723 の場合、Micro-Controller は H723 関連の型番を表示する必要があります
  • 正しく表示されない場合、または認識できない場合は、前の設定手順を確認してください
Loading...

第六步：ツールボード MCU の追加​

メイン MCU の確認が成功したら、ツールボードを追加できます：

  1. ツールボードを再接続: ツールボードのデータケーブルをホスト機またはマザーボードに再接続します
  2. 設定ファイルを編集: printer.cfg ファイルの一番下にツールボード設定を追加します
  3. ツールボード ID を設定: ツールボードのファームウェアタイプに応じて、新しく追加した設定セクションに対応する ID を追加します
MCU 命名について

設定内の mcu1、mcu2 などの名前は、異なるデバイスを一時的に区別するためのものです。これらの名前は完全にカスタマイズ可能で、設定ファイル内で一意であることだけを確認してください。

設定形式:

[mcu mcu1]
# ここにツールボードの ID 設定を追加します

設定例:

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

注意事項:

  • 各 MCU は一意の ID を使用する必要があります。ツールボード ID がメイン MCU および他のデバイスと異なることを確認してください
  • MCU 名は完全にカスタマイズ可能です（例：toolboard、extruder_mcu など）。設定内で一意であることだけを確認してください
  • 前述の手順で確認した有効なツールボード ID を必ず使用してください
  • RS232 デバイスは、baud: 250000 と restart_method: command パラメータを設定する必要があります
  • 複数のツールボードを設定する場合は、各デバイスに異なる名前を付けて区別できるようにしてください

設定が完了したら、保存して Klipper サービスを再起動します。

第七步：すべての MCU 接続を確認​

ツールボードを追加して Klipper を再起動した後、すべての MCU の接続状態を再度確認する必要があります：

  1. Fluidd インターフェースを開き、左側メニューの System をクリックします
  2. MCU 情報を確認: Mcu Information の下で、すべての MCU が正しく認識されていることを確認します
  3. 各 MCU の状態を確認: メイン MCU とツールボードが接続状態で表示されていることを確認します
確認ポイント
  • メイン MCU とすべてのツールボードがリストに表示されている必要があります
  • 各 MCU の接続状態は「接続済み」である必要があります
  • いずれかの MCU が表示されない、または接続に失敗した場合は、その設定と物理的な接続を確認してください
Loading...

第八步：ファームウェアバージョンの確認​

すべての MCU 接続が完了したら、ファームウェアバージョンの互換性を確認する必要があります：

  1. Fluidd インターフェースを開き、左側メニューの System をクリックします
  2. バージョン情報を確認: Mcu Information の下にある Version フィールドを見つけます
  3. バージョンの一致性を確認: すべての MCU のファームウェアバージョンが、ホスト機の Klipper バージョンと一致していることを確認します
バージョン互換性について
  • カスタムコンパイルファームウェア: プリセットされたカスタムデバイスを除き、自分でコンパイルしたファームウェアはホスト機の Klipper バージョンと一致している必要があります
  • Fly-FAST システム: FAST システムのファームウェアバージョンはシステムバージョンと一致しており、コンパイルされた Klipper ファームウェアはシステムバージョンと一致します
  • バージョン不一致の結果: 異なるバージョンのファームウェアは、機能異常、通信失敗、またはシステムの不安定性を引き起こす可能性があります

確認ポイント:

  • メイン MCU とすべてのツールボードの Version 情報が表示され、バージョンが一致している必要があります
  • バージョンが一致しない場合は、該当するファームウェアを再書き込みする必要があります

第九步：設定ファイルの復元と更新​

すべての 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
    # 実際に検索したメイン MCU の USB ID に置き換えてください

    CAN 接続設定:

    [mcu]
    canbus_uuid: 688e89f0e401
    # 実際に検索したメイン MCU の CAN UUID に置き換えてください

  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 を使用することを確認してください
  • 複数のツールボードを設定する場合は、各 [mcu] セクションの ID を一つずつ更新してください
  • RS232 ツールボードには、baud: 250000 と restart_method: command パラメータを含める必要があります
  • 設定を復元すると、既存のプリンターパラメータ（ステッピングモーター、リミットスイッチなどの設定）は変更されません

これで、MCU 接続のトラブルシューティングと設定の復元はすべて完了です。

Loading...