外部ドライバ問題のトラブルシューティング
このページでは、外部ドライバ設定後に発生する、回転しない、一方向のみ回転、振動、脱調、モデルの傾き、5V昇圧モジュールの異常などの問題をトラブルシューティングします。
配線と設定：外部ドライバ使用チュートリアル
クイック診断
以下の現象が発生する場合、通常はモジュールタイプ、信号レベル、enable_pin、step_pulse_duration、パルス極性、または配線順序に関連しています：
- モーターが全く回転しない
- モーターが一方向のみ回転し、逆方向コマンドが無効
- モーターの振動、異音、または方向異常
- 印刷モデルのずれ、レイヤーシフト
- モデルの傾き、特に方向転換後に位置が不安定
- 5V昇圧モジュール使用後にコンソールコマンドがエラーになる、またはモジュール外観異常
- 設定に対応軸のTMCドライバ設定セクションが残っている
外部ドライバ、5V昇圧モジュール、プラグ、配線順序の確認や交換、またはケーブル交換を行う前には、プリンターを完全にシャットダウンし、電源を切断してください。通電状態で昇圧モジュールや外部ドライバの信号線を抜き差ししたり、露出端子に触れたりしないでください。
TMC設定残存チェック
外部ドライバ使用後、対応軸には [stepper_*] 設定のみを残してください。同じ軸のTMC設定セクションは削除するか、まとめてコメントアウトしてください：
[stepper_x]
step_pin: PA2
dir_pin: PA3
enable_pin: !PA8
microsteps: 16
step_pulse_duration: 0.000005
# 以下のTMC設定は使用しなくなったので、削除するかまとめてコメントアウトしてください
#[tmc2209 stepper_x]
#uart_pin: PA10
#run_current: 0.8
よく確認が必要な設定セクションは以下を含みます：
[tmc2209 stepper_x][tmc5160 stepper_x][tmc2209 stepper_y][tmc5160 stepper_y][tmc2209 extruder][tmc5160 extruder]
対応軸のTMC設定を残していると、KlipperはそのTMCドライバの初期化を試み続け、通信エラー、設定エラー、またはモーターの正常動作不能を引き起こす可能性があります。
モジュールタイプと信号レベルチェック
外部ドライバ中継モジュールには主に2つのタイプがあります。実際に使用しているものを先に確認してください：
| モジュールタイプ | 出力レベル | 適用状況 |
|---|---|---|
| 通常スルーモジュール | マザーボード本来の出力が 3.3V の場合、モジュールも 3.3V を出力；マザーボード本来の出力が 5V の場合、モジュールも 5V を出力 | マザーボードの信号レベルが既に外部ドライバの入力要件を満たしている場合に適用 |
| 5V昇圧モジュール | マザーボード本来の出力が 3.3V の場合、5V に昇圧；マザーボード本来の出力が 5V の場合、5V のまま | 外部ドライバが 5V 入力を必要とするが、マザーボードの駆動信号が 3.3V の場合に適用 |
外部ドライバが 3.3V のSTEP、DIR、またはEN信号を安定して認識できない場合、モーターが回転しない、一方向のみ回転する、方向が制御不能、または断続的な脱調が発生する可能性があります。Dシリーズ、Cシリーズマザーボードで外部ドライバを使用する場合、ドライバが 5V 入力を要求するなら、5V昇圧モジュールを使用する必要があります。通常のスルーモジュールは 3.3V 信号を 5V に昇圧しません。
STEP、DIR、ENの低電圧信号を測定する必要がある場合、テストリードで隣接ピンをショートさせないようにしてください。測定方法に不慣れな場合は、モジュールの型番、マザーボードの説明、および完成品モジュールの交換によって優先的に確認し、露出端子には触れないでください。
5Vモジュールテスト手順
このチェックは5V昇圧モジュールを使用しているユーザー（Dシリーズ、Cシリーズマザーボード）のみを対象としています。通常モジュールユーザーはこのセクションをスキップしてください。
一般ユーザーは通電状態でテストリードをモジュールやマザーボードの露出ピンに接触させないでください。露出ピンの電気的チェックは、アフターサービスに連絡するか、電気的経験を持つ担当者が行ってください。
5V昇圧モジュールをマザーボードに取り付けた後、直ちに外部ドライバを接続しないでください。以下の手順に従って、モジュール、設定、およびケーブルに明らかな異常がないことを確認してください。
テスト設定の追加
以下の設定を printer.cfg ファイルに追加し、ピンを実際に使用するドライバポートのピンに変更することを忘れないでください：
[output_pin STEP]
pin: PC14
[output_pin DIR]
pin: PC13
[output_pin EN]
pin: PC15
- サンプルの
PC14、PC13、PC15を実際に使用するドライバポートのピンに置き換えてください。 - 例えばX軸ドライバポートを使用する場合、マザーボードの回路図を参照して、対応するSTEP、DIR、ENのピン番号を見つけてください。
電源オフでのモジュールとケーブルの確認
- 5V昇圧モジュールの取り付け方向がマザーボードのシルク印刷や説明書と一致していることを確認してください。
- EN、PUL、DIR、GNDなどの配線順序が選択した配線方法と一致していることを確認してください。
- メーカー提供の完成品モジュールと完成品ケーブルを優先して使用し、自分で配線を変更しないでください。
- 外部ドライバはまだ接続しないでください。設定や配線順序の誤りによるドライバの損傷を防ぐためです。
ソフトウェア出力チェック
- MainsailまたはFluiddインターフェースでコンソールにアクセスしてください。
- 現時点では外部ドライバやその他の実行デバイスが接続されていないことを確認し、以下のコマンドを順に実行して、コンソールにエラーがないことを確認してください：
SET_PIN PIN=EN VALUE=1
SET_PIN PIN=EN VALUE=0
SET_PIN PIN=STEP VALUE=1
SET_PIN PIN=STEP VALUE=0
SET_PIN PIN=DIR VALUE=1
SET_PIN PIN=DIR VALUE=0
- コマンドがエラーになる場合、まず
printer.cfgのピン名と実際のドライバポートが一致しているか確認してください。
テスト結果の判断
| チェック項目 | 正常結果 | 異常結果 | 対応策 |
|---|---|---|---|
| モジュールの向きと配線順序 | マザーボードのシルク印刷、説明書と一致 | 逆挿し、位置ずれ、または配線順序不一致 | 完全に電源を切った後、再度取り付けるか、完成品ケーブルと交換 |
| コンソールコマンド | SET_PIN コマンドがエラーなし | ピンが存在しない、またはコマンド失敗 | printer.cfg のピン設定を確認 |
| モジュール/ケーブル外観 | 発熱、異臭、破損、緩みなし | 発熱、異臭、破損、緩み | すぐに電源を切り、モジュールまたはケーブルを交換 |
外観、配線順序、設定がすべて正常であることを確認したら、まず完全に電源を切り、その後正式なドライバ配線を行ってください。
イネーブルピン判断方法
外部ドライバのEN（Enable）ピンの有効レベルは様々です。設定前に確認が必要です：
| 配線状況 | enable_pin の記述 | 説明 |
|---|---|---|
| EN- をマザーボード信号線に接続、ドライバはLowレベルでイネーブル | Loading... | ほとんどの外部ドライバはLowレベルアクティブのため、! を追加 |
| EN- をマザーボード信号線に接続、ドライバはHighレベルでイネーブル | Loading... | 一部のドライバはHighレベルアクティブのため、! を追加しない |
| EN+ をコモンアノード/VCCに接続済みで、電源投入と同時にイネーブル | enable_pin 行全体を削除 | ドライバは常時イネーブルで、ソフトウェア制御不要 |
enable_pin のデフォルトはHighレベルアクティブを意味し、先頭の ! はLowレベルアクティブを意味します。多くの外部ドライバのENはLowレベルアクティブ（Active Low）であり、このようなドライバは通常 enable_pin: !PA8 と記述する必要があります。ドライバがHighレベルアクティブ（Active High）の場合は、enable_pin: PA8 と記述します。
step_pulse_duration と方向タイミング
Klipperは非TMCドライバに対してデフォルトで step_pulse_duration: 0.000002（2µs）とします。このパラメータは同時にstepパルス幅とdir方向切替え遅延を制約し、dirタイミングは常にstepパルスの立ち上がりエッジを基準とします。
ドライバがstepの立ち上がりエッジからdir変化までに少なくとも10µsの間隔を要求する場合、次の設定が必要です：
step_pulse_duration: 0.000010
値の推奨事項：
- 外部ドライバのマニュアルにある
Minimum Step Pulse WidthまたはDirection Setup Timeパラメータを確認してください。 - 両方のパラメータが存在する場合、時間が大きい方の値を優先し、適切に余裕を持たせて設定してください。
- マニュアルに明記がない場合は、
0.000005から徐々に大きくしてテストしてください。
よくある現象の対応
レイヤーシフト / 脱調
考えられる原因：step_pulse_duration が短すぎて、外部ドライバがstepパルスを確実に認識できていない。
対処方法：
- まず を試すLoading...
- まだ問題がある場合は、に調整Loading...
- それでも無効な場合は、またはLoading...まで継続して調整Loading...
調整のたびに設定を保存してKlipperを再起動し（FIRMWARE_RESTART）、印刷テストを行ってください。
モデルの傾き（方向転換異常）
考えられる原因：DIR方向信号が外部ドライバに安定して認識されていない、または step_pulse_duration が短すぎて方向転換タイミングが不安定。
対処方法：
- モジュールのタイプが正しいことを確認し、上記のモジュールタイプと信号レベルチェックを参照してください。
- マザーボード出力が
3.3Vでドライバが5V入力を要求する場合、5V昇圧モジュールに交換してください。 - 電源を切り、DIR配線がドライバのDIR対応端子に接続されているか確認してください。
dir_pinピンが実際に使用しているドライバポートの方向ピンであるか確認してください。step_pulse_durationを適宜増やし、設定を保存してKlipperを再起動しテストしてください。
一方向のみの回転 / 方向が制御不能
考えられる原因：DIR方向信号が外部ドライバーに安定して認識されていない。モジュールタイプの不一致、3.3V信号の昇圧不足、DIR配線の誤り、またはdir_pinの設定ミスが一般的。
確認手順：
- モジュールタイプが正しいことを確認。上記のモジュールタイプと信号レベル確認を参照。
- マザーボード出力が
3.3Vでドライバーが5V入力を必要とする場合、5V昇圧モジュールに交換する。 - 電源を切った状態で、DIR配線がドライバーのDIR/PUL端子に正しく接続されているか確認。
dir_pinピンが実際に使用している駆動ポートの方向ピンと一致しているか照合。- 実際の方向に応じて、
dir_pinの前に!を追加または削除する。
モーターが回転しない / 振動
確認手順：
- モジュールタイプが正しいことを確認。上記のモジュールタイプと信号レベル確認を参照。
enable_pinの極性が正しいことを確認。上記の有効ピン判断方法を参照。- 対応する軸のTMC設定が削除または全体コメントアウトされていることを確認。上記のTMC設定残存確認を参照。
step_pulse_durationが十分に大きく設定されていることを確認。- ドライバーのディップスイッチによるマイクロステップ設定とKlipperの
microstepsが一致していることを確認。 - 電源を切った状態で、PUL/DIR/EN配線が選択した接続方式と一致しているか確認。