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

MCU 接続ガイド

適用説明

このガイドは、MCUがKlipperに正常に接続できない問題のトラブルシューティングと解決に使用されます。

準備作業と注意事項​

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

ステップ1: 設定のバックアップとリセット​

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は設定を保存し、サービスを再起動します。
  • エラーが表示された場合は、一時的に無視してください。
  • その後、すべてのデバイス（ホストおよびすべてのサブデバイス）を完全に電源オフにしてください。
  • 重要: 完全に電源が切れていることを確認する必要があります。そうでないと、次の手順に進めません。

ステップ2: デバイスの検出とファームウェアタイプの確認​

前提条件​

  • メインデバイスの順序: 最初の 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と併用する場合はこの手順は不要です)

ステップ3: デバイス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

ステップ4: メイン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サービスを再起動してください。

ステップ5: メインMCU接続の確認​

メインMCUの設定が完了したら、接続が成功したかどうかを確認する必要があります:

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

ステップ6: ツールボード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サービスを再起動してください。

ステップ7: すべてのMCU接続の確認​

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

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

ステップ8: ファームウェアバージョンの確認​

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

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

確認ポイント:

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

ステップ9: 設定ファイルの復元と更新​

すべての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...