よくあるエラー概要
このページは、Klipper のよくあるエラーを迅速に特定するためのものです。まず klippy.log で完全なエラーキーワードを見つけてから、対応するカテゴリページに進んで対処してください。
ハードウェアテスト方法
本ドキュメントでは、一般的なハードウェアモジュールの最小限のテスト方法を収録しています。トラブルシューティング時に個々のハードウェアを分離し、問題が設定、配線、モジュール本体、またはマザーボードポートのいずれに起因するかを確認するために使用します。
MCU ID 設定
このページでは、Klipper におけるメインボード、ツールボード、CAN デバイス、およびホスト MCU の ID 記入ルールについて集中的に説明します。接続関連の問題を設定する際は、まず通信方式を確認し、対応する serial を記入してください。
ペリフェラルとドライバのテスト
この記事では、ステッピングドライバ、CANツールボードなどのペリフェラルモジュールが正常に動作するかどうかを検証します。テストの考え方は基本的なI/Oテストと同じで、最小限のKlipper設定を使用して個々のハードウェアを分離します。
設定関連エラー
このページでは、設定セクションの競合、パラメータのスペルミス、include ファイル、SAVE_CONFIG に関連する問題をまとめています。設定を変更した後は、まず klippy.log の最初の設定エラーを確認し、その後1つずつ処理してください。
TMC エラー調査
技術的背景
運動とレベリングのエラー
本ページでは、移動範囲、ホーミング、エンドストップ、プローブ、ベッドメッシュ、複数 Z 軸のレベリングに関するエラーをまとめます。配線、コネクタ、手動での機械調整を伴う場合は、必ず電源を切ってから作業してください。
プローブ校正ツール
Klipper のプローブ Z オフセット、Z エンドストップ、ベッドメッシュ、Delta 校正などのコマンドは、最終的にすべて同じ手動プロービングのフローに入ります。これは manualprobe モジュールが提供しているもので、このモジュールは**Klipper が自動的にロード**するため printer.cfg に書く必要も設定項目もありません。実際に設定が必要なのは [probe]（または [bltouch]）と [stepperz] です。
温度と押出エラー
このページでは、温度センサー、ヒーター、ヒートベッド、押出、フィラメント切れ検出に関するエラーをまとめています。温度保護関連のエラーは、まずハードウェアと温度曲線を確認し、保護を無効にして問題を回避しないでください。
加速度計テストと校正
依存パッケージのインストール
システム・タイムアウトエラー
このページでは、ホーミング時の通信タイムアウト、MCUタイマーエラー、ホストPCのパフォーマンス、ファームウェア書き込み、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}
EDDY I2C ピンと設定
この文書では、FLY-EDDY シリーズ（EDDY-M / EDDY-F）センサーの I2C ピン定義、2つの接続方法のピン対応表と配線手順、および probeeddycurrent に必要な I2C 関連の設定項目について説明します。
RP2040ファームウェアが起動しない問題の修正
RP2040コントローラーを搭載したFLYツールボード（FLY-SHT36、FLY-SB2040、FLY-MMUなど）で、自作コンパイルしたKatapult / Klipperファームウェア後に起動しない、起動が不安定になる問題が発生した場合の修復方法です。出荷時ファームウェアはメーカーが提供しており、自作コンパイルしたファームウェアで問題が発生した場合のみ、このページを参照してください。