MCU接続ガイド
本ガイドは、MCUがKlipperに正常に接続できない問題を調査・解決するためのものです。
準備と注意事項
- 推奨しない上位機種:Redmiスマートフォン、WiFiスティック、セットトップボックスなどの機器は避けてください。これらはカスタムまたは改造されたシステムを使用していることが多く、MCUを正しく認識できない可能性があります。
- 下位機の数を確認:使用する下位機(ツールボードなど)の数を事前に確認してください。複数の下位機が接続に影響を与える可能性があります。
- 配線を簡素化:マザーボードとツールボードからデータケーブル以外のすべての配線を一時的に取り外し、必要なデータ接続のみを残して干渉を排除することをお勧めします。
- 推奨操作画面:Fluidd画面の使用をお勧めします。MCUの接続状態をより直感的に表示できます。
ステップ1:設定のバックアップとリセット
1. 上位機の画面にアクセス
ブラウザに上位機のIPアドレスを入力してアクセスします。
2. 設定ファイルの場所を特定
WEB画面に入り、左サイドバーで設定オプションを見つけます:
Fluiddユーザー:...をクリックし、printer.cfgを見つけます。
Mainsailユーザー:マシンをクリックし、printer.cfgを見つけます。
3. 設定ファイルのバックアップ
printer.cfgファイルを右クリックし、Duplicateを選択してコピーし、コピーを次のようにリネームします:
printer_Backup.cfg
Fluidd操作例:
Mainsail操作例:
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接続 を行ってください。この操作はネットワーク経由で行う必要があります。
操作手順
-
デバイス検出の実行
- SSH接続に成功したら、以下のコマンドを実行します:
lsusb
- システムは認識されたすべてのUSBデバイスをリスト表示します。
- SSH接続に成功したら、以下のコマンドを実行します:
-
コマンド例外の処理
lsusbコマンドが存在しないと表示された場合は、まずインストールします:sudo apt-get install usbutils- 実行後、デバイスが何も表示されない場合は、上位機の交換を検討してください。
-
デバイス情報の識別 以下の図に従い、
lsusbの出力結果からデバイスを識別します:Loading...Loading... -
ファームウェアタイプの確認
- 書き込んだファームウェアに基づき、
lsusbの結果で以下のキー情報を照合します:- USBファームウェア:
1d50:614eが表示される必要があります - USBブリッジCANファームウェア:
1d50:606fが表示される必要があります - USB Katapultファームウェア:
1d50:6177が表示される必要があります - RS232アダプター (UTORまたはD8/D8PROマザーボードと併用):
1a86:7523が表示される必要があります (G2Tと併用の場合はこの手順は不要です)
- USBファームウェア:
- 書き込んだファームウェアに基づき、
ステップ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を検索するための対応するコマンドを選択します:
- 通常の上位機
- Fly_FASTシステム
~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0
python ~/klipper/scripts/canbus_query.py can0
RS232ファームウェアデバイス 以下のコマンドを実行してRS232デバイスパスを検索します:
ls /dev/serial/by-path/*
結果の解釈と処理
USB ID検索結果
コマンド実行後、端末に以下のようなデバイスIDが表示されます(これは例です):
- そのまま使用可能:
usb-フィールドの後にKlipperと表示される場合(例:usb-Klipper_stm32f407xx_...)、Klipperファームウェアが書き込まれています - ファームウェアの書き込みが必要:
usb-フィールドの後にkatapultと表示される場合(例:usb-katapult_stm32f407xx_...)、現在はブートローダーであり、Klipperファームウェアを書き込む必要があります - 認識不可:以下の例のIDで
usb-フィールドの後に1a86_USB_Serialと表示される場合、そのデバイスはCH340シリアル変換チップであり、Klipper/katapultファームウェアを実行するMCUではありません。対応するファームウェアを最初に書き込む必要があります
/dev/serial/by-id/usb-1a86_USB_Serial-if00-port0
- 正常な場合は以下の通りです
CAN ID検索結果
コマンド実行後、端末の戻り値に基づいて判断します:
- そのまま使用可能:表示されたIDの末尾
Application:フィールドがKlipperと表示される場合 - ファームウェアの書き込みが必要:表示されたIDの末尾
Application:フィールドがCANBOOTまたはKatapultと表示される場合 - デバイスが見つからない:
Total 0 uuids foundと表示された場合、考えられる原因は以下の通りです:- CANネットワーク設定の誤り
- CANレートの不一致(上位機、マザーボード、ツールボードのレートが一致していることを確認してください)
- そのIDが既に使用されている(設定でブロックし、その後シャットダウンして電源を切り、再起動する必要があります)
RS232 ID検索結果
コマンド実行後、端末にRS232デバイスパスが表示されます(これは例です):
- パスの例:
/dev/serial/by-path/platform-3f980000.usb-usb-0:1.2:1.0-port0
RS232デバイスを設定する際は、必ずボーレートと再起動方法を指定する必要があります:
[mcu toolboard]
serial: <ここを検索したRS232デバイスパスに置き換えます>
baud: 250000
restart_method: command
ステップ4:メインMCUのID設定
設定を開始する前に、ツールボードと上位機またはマザーボードの接続を切断して、デバイス認識の競合を回避してください。
printer.cfg ファイルを再度開き、[mcu] セクション内の serial: /tmp/klipper_host_mcu 設定行を見つけます。
接続方法に応じて、以下の対応する方法を参照して設定します:
- USB接続設定
- CAN接続設定
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
serial: /tmp/klipper_host_mcu 設定項目を canbus_uuid: に置き換え、検索したCAN IDを入力します。
設定例:
# 検索したCAN ID:
# 688e89f0e401
# 設定を次のように変更:
[mcu]
canbus_uuid: 688e89f0e401
設定を保存し、Klipperサービスを再起動します。
ステップ5:メインMCU接続の確認
メインMCUの設定が完了したら、接続が成功したかどうかを確認する必要があります:
- Fluidd画面を開き、左側のメニューで
Systemをクリックします - MCU情報の表示:
Mcu Informationの下にあるMicro-Controller情報を見つけます - メインコントローラーの型番を確認:表示された型番がマザーボードの実際のメインコントローラーの型番と一致することを確認します
- メインコントローラーがSTM32H723の場合、
Micro-ControllerにはH723関連の型番が表示される必要があります - 正しく表示されない場合や認識できない場合は、以前の設定手順を確認してください
ステップ6:ツールボードMCUの追加
メインMCUが正常に接続され、さらにツールボードの追加、複数MCUの設定、またはボード間ピン設定が必要な場合は、以下を参照してください:ツールボードMCUの追加とボード間設定。
以上で、メインMCU接続の調査は完了です。