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

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