重要なお知らせ
- このチュートリアルはツールボードの配線とID検索に特化しており、関連する手順はメインボードには適用されませんので、注意して区別してください。
- ツールボードを使用しない場合は、このチュートリアルを無視してください。
ツールボードIDの読み取りと確認
- USB IDの取得
- CANBus UUIDの取得
- RS232の使用方法
- データ転送機能を持つデータケーブルを準備してください。特に長い場合は、フェライトコア付きのデータケーブルの使用をお勧めします。
- USBデータケーブルを使用してツールボードを上位機に接続します。
マザーボードUSB IDの取得
注意事項
マザーボードのUSBケーブルを接続または挿し直す必要がある場合は、先にプリンターの電源を完全に切り、電源供給を切断してください。通電状態でのケーブルの抜き差しは行わないでください。
- SSHで上位機にログインし、検索コマンドを実行する必要があります。
- 操作前に、マザーボードにUSBファームウェアが書き込まれていること、およびType-Cデータケーブルで上位機のUSBインターフェースに接続されていることを確認してください。
- 本チュートリアルはマザーボードのUSB IDの検索のみを対象としており、ツールボードIDの検索には適用されません。
- ツールボードデバイスについては、対応する製品ドキュメントのUSBまたはCAN ID取得チュートリアルをご参照ください。
操作手順
USBデバイスIDの検索
SSHで上位機にログインし、以下のコマンドを実行してすべてのUSBシリアルデバイスIDを一覧表示します:
ls /dev/serial/by-id/*
使用できないID
コマンド実行後、以下の2種類のIDは使用しないでください:
| IDの特徴 | 理由 | 例 |
|---|---|---|
usb-1a86_USB_Serial-if00-port0 | CH340などの汎用シリアルチップのデフォルト名であり、Klipperマザーボードの接続アドレスとして使用できません | /dev/serial/by-id/usb-1a86_USB_Serial-if00-port0 |
katapultを含む | デバイスがKatapult書き込みモードであり、先にKlipperファームウェアを書き込む必要があります | /dev/serial/by-id/usb-katapult_xxxxxxxxxxxx |
検索結果
通常、端末には以下の画像のようなデバイスパスが表示されます。画像内のIDは形式の例としてのみ示されています。
有効なIDが見つからない場合:デバイスのファームウェアと接続の問題のトラブルシューティングを確認
コマンドが複数の有効なIDを返す場合は、マザーボードのMCUモデルと、抜き差し前後のデバイスリストの変化を組み合わせて、マザーボードに対応する完全なデバイスパスを確認してください。
USB IDを設定ファイルに記入する
FluiddまたはMainsailで printer.cfg を開きます:
Fluidd:左側の Loading... | Mainsail:左側の「マシン」をクリックし、 Loading... |
ドキュメント内のデバイスパスはすべて例です。各マザーボードのUSB IDは異なる可能性があるため、SSHコマンドが返した実際のパスを完全にコピーしてください。
[mcu] 設定セクションを見つけ、serial を先ほど照会した完全なデバイスパスに変更します:
[mcu]
serial: /dev/serial/by-id/usb-Klipper_xxxxxxxxxxxx
USBファームウェアを使用する場合は serial を設定し、同じ [mcu] 設定セクションに canbus_uuid を同時に記入しないでください。
設定位置は以下の画像を参照してください:
| Fluidd設定例 Loading... | Mainsail設定例 Loading... |
変更が完了したら、右上隅の SAVE & RESTART をクリックして設定を保存し、Klipperを再起動します。
-
IDを検索する前に、XT30データケーブルを使用してツールボードをUTOCまたはブリッジファームウェアが書き込まれたメインボードに接続します。以下は参考配線図です。
-
ディップスイッチが適切な位置に設定されているか確認してください。
Loading... -
電源を切った状態で、CAN HとCAN Lの間の抵抗値をテスターで測定し、約
60Ωであることを確認してください。120Ωの場合は120Ωジャンパーを接続し、約40Ωの場合はジャンパーを取り外してください。Loading...CANBus UUID の取得
準備作業
重要な前提条件- ツールボードの状態: ツールボードに
Klipper-canファームウェアが書き込まれているか、Katapult-canモードであることを確認してください - 注意事項: 本チュートリアルはツールボードIDの検索のみを対象としており、マザーボードIDの検索には適用されません
- 接続要件: ツールボードは以下のいずれかのデバイスに接続されている必要があります:
UTOCモジュールUSBブリッジCANファームウェアが書き込まれたマザーボード
- 最終接続: 上記のデバイスは上位機に接続されている必要があります
CANネットワーク設定要件
- デフォルト設定: 本チュートリアルでは、上位機にCANネットワークがすでに設定されていることを前提としています
- Flyユーザー: Fly上位機を使用しFly-FASTシステムを実行している場合、CANはデフォルトで設定されています(速度1Mbps)
- 初回使用時: 必ず以下のチュートリアルを先にご確認ください: CAN設定チュートリアル
SSHへの接続
- ネットワーク経由でSSHにログインしてください(シリアルポートでのログインは使用しないでください)
- 上位機とCANネットワークデバイスが正常に接続されていることを確認してください
CAN IDの検索
- 一般的な上位機での検索コマンド
~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0
- FLY上位機での検索コマンド
python3 ~/klipper/scripts/canbus_query.py can0
検索結果の説明
CANID- 注意事項: マザーボードIDは以前のドキュメントでKlipperに設定済みのため、通常はマザーボードの
CANIDを検索することはできません - 迅速な確認方法:確認が必要な場合は、まずマザーボードとツールボード間のCAN接続線を外し、その後検索を再実行してください
- 検索コマンド実行後、以下の状況が発生する可能性があります:
表示結果 状態の説明 後続の操作 Application: KlipperデバイスにKlipperファームウェアが書き込まれています このIDを直接使用可能 Application: CANBOOTまたはKatapultデバイスがBootloaderモードです Klipperファームウェアを書き込む必要があります Total 0 uuids foundデバイスが見つかりません 以下の問題を確認してください:
1. CANネットワーク設定が正しいか
2. CAN速度が一致しているか(デフォルト1Mbps)
3. 設定でこのIDがすでに使用されているか(使用されている場合はコメントアウトして保存し、電源を切って再起動する必要があります)Loading...重複IDについてデバイスIDが
printer.cfgですでに設定されている場合、検索結果には表示されません。再検索が必要な場合は、以下の手順を実行してください:- 設定ファイルで該当デバイスIDをコメントアウトします
- 設定を保存してKlipperを再起動します
- すべてのデバイスの電源を切って再起動します
CANデバイスIDの設定
1. 設定ファイルの取得
使用しているWebインターフェースに応じて、
printer.cfg設定ファイルを見つけます:Fluidd
左側のナビゲーションバーにあるアイコンをクリックし、{...}printer.cfgを見つけますLoading...Mainsail
上部ナビゲーションバーのマシンをクリックし、printer.cfgを見つけますLoading...2. デバイス設定の追加
printer.cfgにツールボード設定を追加します:[mcu toolboard]canbus_uuid: <ここに取得したIDを記入>設定の説明toolboardはツールボードの名前で、実際の状況に応じて変更してください- マザーボードIDの場合は、設定セクションは
[mcu]になります - 通常の設定では、マザーボードは
[mcu]、ツールボードは[mcu toolboard]を使用します
3. 保存して再起動
- 右上隅の SAVE & RESTART ボタンをクリックします
- システムが自動的に設定を保存し、Klipperを再起動します
Loading...注意ドキュメントに記載されているすべてのIDは例であり、実際の各マザーボードのIDはそれぞれ異なります。実際に取得したIDに基づいて修正・記入してください。
- ツールボードの状態: ツールボードに
-
IDを検索する前に、XT30データケーブルを使用してツールボードをUTORまたはG2Tに接続します。以下は参考配線図です。
-
ディップスイッチが適切な位置に設定されているか確認してください。
Loading...ツールボードのRS232 ID検索
注意事項
重要な準備- ファームウェア要件:
ツールボードにはRS232ファームウェアを書き込む必要があります。書き込んでいないと通信できません。 - 強制グランド共有:
⚠️ ツールボードを接続する前に、ツールボードとマザーボードのGNDを必ず接続してください(同じ24V/12V電源を共有すれば実現できます)。
RS232注意事項
- D8、D8PRO、C8Pを除き、他のマザーボードはRS232インターフェースをサポートしていません。
- サポートしていないマザーボードは
G2TまたはUTORを使用して接続する必要があります。
RS232 ID検索
- ブラウザを開き、アドレスバーに上位機のIPアドレスを入力します。例えば、私の上位機IPが
192.168.101.179の場合、直接入力してEnterキーを押します。
Loading...- 上位機のWEBインターフェースを開き、左側のサイドバーの構成オプションで以下を探します:
- fluiddの場合:
{…}、クリックして入ると、printer.cfgが見つかります。
Loading...- mainsailの場合:
マシン、クリックして入ると、printer.cfgが見つかります。
Loading...3.
printer.cfgをクリックして入った後、右上のDEVICESをクリックします。Loading...Loading...4.
SERIALをクリックし、その後更新します。- fluiddの更新
Loading...- mainsailの更新
Loading...5.IDをコピーします。矢印が指す部分をクリックしてコピーします。
- fluiddでは、
ch341-uartが存在するか確認し、Path_by_hardwareをクリックします。これがRS232_IDです。
Loading...- mainsailでは、
CH341-UARTが存在するか確認し、Path_by_hardwareをクリックします。これがRS232_IDです。
Loading...注意事項UTORを使用してツールボードを接続する場合、通常は2つのRS232_IDが表示されます。それぞれ試してください。
ツールボードのRS232 IDを記入
-
以下は参考構成です。
注意事項- 以下の構成中の
toolboardはツールボード名です。別の名前の場合は、対応する名前に置き換えてください。
危険[mcu toolboard]serial: <ここを先ほど取得したIDに置き換えてください>baud: 250000restart_method: command- ツールボードの
IDを追加する場合は、必ず[mcu toolboard]の後にserial:を付け、その後に検索したツールボードのIDを追加します。
- 以下は参考構成です。
- 本チュートリアルはツールボードIDの検索と構成に関するものです。通常は、既にマザーボードに正常に接続されていることを前提としています。
- マザーボードは必ず
[mcu]であり、ツールボードは[mcu toolboard]です。 - 右上の
SAVE & RESTARTをクリックすると、自動的に保存されklipperが再起動します。
- 以下の構成中の
危険注意:ドキュメントに記載されているすべてのIDはサンプルです。実際の各マザーボードのIDは異なりますので、実際に取得したIDを記入してください。
- ファームウェア要件: