よくあるエラーメッセージ
接続問題
mcu 'xxx': Unable to connect
エラーメッセージ：ホストコンピューターがマザーボードを見つけられないか、接続できません。
エラー原因：Klipperホストコンピューターがマザーボードとの通信接続を確立できません。複数の原因が考えられます。
解決方法： まずKlippy.logファイルを確認し、一番下までスクロールして、具体的なエラーメッセージに応じて対応してください：
-
[Errno 2]エラーが発生する場合：検出されたデバイスIDがprinter.cfgファイルに追加されていないことを意味します。Loading... -
serialhdl.error: mcu 'xxx': Serial connection closedエラーが発生する場合：CAN IDが見つからないか、誤って入力されていることを意味します。IDを再検索し、正しく入力する必要があります。Loading... -
mcu 'mcu': Unable to open CAN port: [Errno 19] No such deviceエラーが発生する場合：UTOCデバイスがないか、CANブリッジファームウェアが書き込まれていないマザーボードがあることを意味します。Loading... -
mcu 'mcu': Unable to open CAN port: Failed to transmit: [Errno 100] Network is downエラーが発生する場合：CANネットワークが正しく設定されていないか、CAN0インターフェースが起動していないことを意味します。 -
mcu 'mcu': Unable to open CAN port: Failed to transmit: [Errno 105] Network is downエラーが発生する場合：CANネットワークキャッシュが小さすぎるため、キャッシュサイズを増やす必要があります。
[Errno 105] Network is downおよび[Errno 100] Network is downエラーの詳細な設定方法については、CAN設定ドキュメントを参照してください。
mcu 'mcu': Invalid CAN uuid
エラーメッセージ：CAN UUIDが無効であるか、認識できません。
エラー原因：CAN IDが正しく入力されていないか、誤って入力されているため、KlipperがCANデバイスを認識できません。
解決方法：CANデバイスIDを再検索し、printer.cfg設定ファイルに正しく入力する必要があります。
Option 'serial' in section 'mcu' must be specified
エラーメッセージ：mcu設定セクションで'serial'オプションを指定する必要があります。
エラー原因：USBデバイスIDが正しく入力されていないか、誤って入力されているため、KlipperがUSB接続されたマザーボードを認識できません。
解決方法：USBデバイスIDを再検索し、printer.cfg設定ファイルのmcuセクションに正しく入力する必要があります。
設定競合問題
homing override method always homes X and Y before homing Z. The safe_z_home
エラーメッセージ：セーフZホームとホーミングオーバーライド設定が競合しています。
エラー原因：[safe_z_home]と[homing_override]の2つの機能モジュールが重複して設定され、ホーミングロジックが競合しています。
解決方法：いずれかの機能モジュールのみを設定し、もう一方の設定を削除してください。実際のニーズに応じて、[safe_z_home]または[homing_override]のどちらかを残すように選択してください。
温度検出問題
Error 'XXX mcu' shutdown: ADC out of range…
エラーメッセージ：ADC（アナログ-デジタル変換器）が測定範囲を超え、温度検出に異常が発生しました。
エラー原因：Klipperが設定された最大または最小しきい値を超える温度を検出しました。これは通常、サーミスタの断線、短絡、または配線ミスが原因です。システムは安全のためシャットダウンプロテクションモードに入ります。
解決方法：
まず設定ファイルでmin_temp:を検索し、最小温度を-235に変更してから、max_temp:を検索し、最大温度を500に変更します。診断のために一時的に温度制限を緩和します。次に、サーミスタの型式が正しいか、サーミスタのピン設定が正しいか、サーミスタに短絡問題がないかを確認します。問題を特定して解決した後は、必ず温度制限を元の安全な値に戻してください。
パフォーマンスとタイムアウト問題
MCU 'mcu' shutdown: Timer too close
エラーメッセージ：MCUタイマーが近すぎるため、システムがタイムアウトしました。
エラー原因：主な原因は、下位機（MCU）の処理オーバーロードまたは上位機（メインコントローラー）の応答タイムアウトであり、タイマー間隔が小さすぎてタスクを正常に処理できません。
解決方法： まず、ステッピングモーターのマイクロステップ設定を下げて、各ステップパルスの処理負荷を減らします。次に、印刷速度を下げてシステム全体の負荷を軽減します。問題が続く場合は、上位機システムの再インストールとファームウェアの再書き込みを検討してください。
Raspberry Piユーザーの場合は、以下の方法を使用してNTP時刻同期サービスを確認および無効にすることで、システム時刻同期による干渉を減らすこともできます：
sudo timedatectl status | grep "NTP service"
sudo timedatectl set-ntp false
上記のコマンドは、まずNTPサービスの状態を確認し、次にNTP同期機能を無効にします。