よくあるエラー概要
このページは、Klipper のよくあるエラーを素早く特定するためのものです。まず klippy.log で完全なエラーキーワードを見つけてから、対応するカテゴリのページに移動して対処してください。
ハードウェアテスト方法
本ドキュメントでは、一般的なハードウェアモジュールの最小限のテスト方法を収録しています。トラブルシューティング時に個々のハードウェアを分離し、問題が設定、配線、モジュール本体、またはマザーボードポートのいずれに起因するかを確認するために使用します。
MCU ID 設定
このページでは、Klipperにおけるメインボード、ツールボード、CANデバイス、およびホストMCUのID記入ルールについてまとめて説明します。接続関連の問題が発生した場合は、まず通信方式を確認し、その後に対応する serial を記入してください。
ペリフェラルとドライバのテスト
この記事では、ステッピングドライバ、CANツールボードなどのペリフェラルモジュールが正常に動作するかどうかを検証します。テストの考え方は基本的なI/Oテストと同じで、最小限のKlipper設定を使用して個々のハードウェアを分離します。
設定クラスのエラー
このページでは、設定セクションの競合、パラメータのスペルミス、includeファイル、および SAVE_CONFIG に関連する問題をまとめています。設定変更後は、まず klippy.log の最初の設定エラーを確認し、その後1つずつ対応してください。
TMC エラー調査
技術的背景
運動とレベリングエラー
このページでは、移動範囲、ホーミング、リミット、プローブ、メッシュベッド、マルチZレベリングに関するエラーをまとめています。配線、プラグ、手動での機械調整を行う場合は、必ず電源を切ってから作業してください。
温度と押出エラー
このページでは、温度センサー、ヒーター、ヒートベッド、押出、フィラメント切れ検出に関するエラーをまとめています。温度保護関連のエラーは、まずハードウェアと温度曲線を確認し、保護を無効にして問題を回避しないでください。
加速度センサーテストとキャリブレーション
依存パッケージのインストール
システムとタイムアウトエラー
このページでは、通信タイムアウト、MCU タイマーエラー、上位機のパフォーマンス、ファームウェア書き込み、Klipper サービスの起動に関する問題をまとめています。
CANネットワークとID検索
本記事では、CANネットワーク設定、CAN0状態確認、CAN UUID検索、および一般的なCANエラーに関するトラブルシューティングについて説明します。
CAN エラー調査
本記事では、CANネットワークの一般的なエラー、通信異常の調査、およびCAN IDが見つからない場合の調査手順について説明します。
円弧フィットに関する提案
本稿では、Klipper における [gcode_arcs]、G2 / G3 円弧指令、およびスライサーの円弧フィットの取舍選択について説明します。日常的な 3D プリントでは、Klipper 側の円弧フィットを品質やパフォーマンス向上の主要な手段として推奨しません。
ホーミングタイムアウト問題
問題の説明
共振補償と圧力アドバンス
このページでは、Input Shaper（共振補償）とPressure Advance（圧力アドバンス）に関連する設定エラーと調整の異常をまとめています。加速度計のハードウェア接続と通信エラーについては、加速度計テストとキャリブレーションを参照してください。
EDDY 問題集
ホーミング時にエラー Error during homing z: Eddy current sensor error が発生する
EDDY TAP モード
このページでは、EDDY を TAP モードで使用する際のデバッグ手順、確認順序、および一般的な問題のトラブルシューティングについて説明します。TAP モードは、ノズルがベッドに軽く接触することでトリガーしきい値を判断します。デバッグ時には、ノズル、ヒートベッド、Z 軸の動作状態に注意してください。
外部ドライバトラブルシューティング
このページでは、外部ドライバ設定後に発生する、回転しない、一方向のみ回転、振動、脱調、モデルの傾き、5V昇圧モジュールの異常などの問題をトラブルシューティングします。
よく使うデバッグコマンドのエントリ
よく使う Klipper コンソールのデバッグコマンドは、FAQと設定リファレンスの重複を避けるため、参考設定ディレクトリに一元管理されています。
Load Cell プローブトラブルシューティング
この記事は、Klipperの loadcell / loadcell_probe 関連キーワードと基本的なトラブルシューティングの方向性を記録するためのものです。Load Cellプローブはまだ比較的新しい方式であり、一般ユーザーは個別のコミュニティ設定を基に圧力センサーを独自に改造しないでください。製品ドキュメント、公式Klipperドキュメント、またはメーカー提供の完全な設定を優先的に使用してください。
BLTouch の設定とトラブルシューティング
bltouch-guide}