よくあるエラー概要

このページでは、Klipperのよくあるエラーを素早く特定できます。まず klippy.log でエラーキーワード全体を見つけてから、対応するカテゴリページに進んで対処してください。

クイックインデックス

エラーの種類	よくあるキーワード	調査エントリー
接続問題	Unable to connect、Invalid CAN uuid、Lost communication、MCU Protocol error、/dev/serial/by-id	本ページ接続問題、MCU ID 設定、CAN ネットワークとID検索
設定問題	not valid、not a valid config section、must be specified、Unable to parse、SAVE_CONFIG、Option conflict	設定関連エラー
マクロとスライサーコマンド	Unknown command、Error evaluating 'gcode_macro、jinja2.exceptions.UndefinedError、dict object has no attribute	設定関連エラー
動作・原点復帰	Move out of range、Must home axis first、No trigger、Endstop still triggered	動作、エンドストップ、レベリングエラー
G-code 解析	Unable to parse move、Invalid speed、Machine does not support G20、G2/G3	動作、エンドストップ、レベリングエラー、円弧フィッティングの提案
プローブレベリング	Probe triggered、No trigger on probe、samples_tolerance、bed_mesh、BLTouch failed、Z_TILT、QUAD_GANTRY_LEVEL	動作、エンドストップ、レベリングエラー
温度・加熱	ADC out of range、not heating at expected rate、Verify heater、temperature	温度、加熱、押出エラー
押出問題	Extrude below minimum temp、Extrude only move too long、Move exceeds maximum extrusion、Filament sensor、M600	温度、加熱、押出エラー
パフォーマンス・タイムアウト	Timer too close、Missed scheduling、Stepper too far in past、Rescheduled timer、restarting too fast、SD busy	システム、パフォーマンス、サービスエラー
TMC ドライバー	Unable to read tmc uart、Unable to write tmc spi、GSTAT、coil short circuit	TMC エラー調査
CAN ネットワーク	bytes_invalid、Network is down、No buffer space available、Invalid CAN uuid	CAN ネットワークとID検索
センサー周辺機器	Invalid adxl345 id、No data、Insufficient axis、Eddy current sensor error、Invalid read data	加速度計テストとキャリブレーション、EDDY 問題集

関連設定ページクイックリファレンス

エラー方向	推奨参考
設定構文、インデント、コメント、ピン重複	設定変更の説明
原点復帰方向、軸方向、強制移動	原点復帰と方向調整ガイド
エンドストップ、TAP、光電リミット、近接スイッチ	エンドストップ関連
エンドストップなし原点復帰、仮想エンドストップ感度	エンドストップなしの使用
加熱、PID、昇温遅い、温度保護	加熱関連、verify_heater 最適化、M109 最適化
ファン設定、ドライブファン、7040 ファン	ファンリファレンス設定
押出機パラメータ、回転距離、押出設定	押出機リファレンス設定、マシンキャリブレーション
開始/終了マクロ、一時停止・再開、レベリング・メッシュマクロ	マクロ紹介
よく使うデバッグコマンド、プローブ、共振補償	よく使うデバッグコマンド

接続問題

MCU ID 設定説明

KlipperのMCU IDとは、[mcu] または [mcu xxx] 設定セクションで制御ボード接続の識別情報を指します。通信方式によって記述方法が異なります：

接続方式	設定項目	例
USB ファームウェア	serial:	serial: /dev/serial/by-id/usb-Klipper_xxxxxxxxxxxx
CAN ファームウェア	canbus_uuid:	canbus_uuid: xxxxxxxxxxxx
ホストPC MCU	serial:	serial: /tmp/klipper_host_mcu

記入ルール：

1. マザーボードはデフォルトで [mcu] を使用し、ツールボードや拡張ボードには [mcu tool]、[mcu toolboard] などのカスタム名称を使用します。
2. USB ファームウェアは serial: のみ、CAN ファームウェアは canbus_uuid: のみを記入し、同一 [mcu] 内に両方の項目を併記しないでください。
3. 複数MCU構成のマシンでは、各 [mcu xxx] に実際のIDを使用し、同一のUSB IDやCAN UUIDをコピーして使用しないでください。
4. [mcu xxx] の名称はピン接頭辞に影響します。例：[mcu tool] のピンは tool:gpio13 と記述します。名称の大文字小文字は統一してください。
5. ドキュメント例の xxxxxxxx はそのまま使用できず、実際に検出したIDに置き換える必要があります。

よくあるエラー：

• 書き込みモードのID（例：katapult、canboot を含むID）をKlipperファームウェアのIDとして誤って使用する。
• USB ファームウェアに canbus_uuid: を設定する、またはCAN ファームウェアに古い serial: を残す。
• ツールボードを [mcu] と設定し、マザーボードのMCU設定を上書きしてしまう。
• ピン接頭辞とMCU名称が一致しない。例：設定が [mcu toolboard] であるのに、ピンが tool:gpio13 と記述されている。

USB ID 確認：USB ファームウェアは ls /dev/serial/by-id/* を実行してIDを取得します。

CAN ID 確認：CAN ネットワークとID検索

ツールボード設定：ツールボードMCU追加とクロスボード設定

mcu 'xxx': Unable to connect

エラー情報：上位コンピューターがマザーボードを見つけられない、または接続できない。

Loading...

よくある原因：

• USB デバイス ID が未入力、または入力間違い。
• CAN UUID が未入力、入力間違い、またはデバイスがオンラインでない。
• UTOC、USB ケーブル、CAN ブリッジファームウェア、または電源供給の異常。
• CAN0 が起動していない、または CAN ネットワーク設定の異常。

対処方法：

1. klippy.log を開いて一番下までスクロールし、具体的なエラー情報を確認する。

2. [Errno 2] が表示された場合、通常は検出された USB デバイス ID を printer.cfg に追加していないことを意味する。

   Loading...

3. Serial connection closed が表示された場合、通常は CAN ID を再検索し、CAN ネットワークを確認する必要がある。

   Loading...

4. Unable to open CAN port: [Errno 19] No such device が表示された場合、通常は UTOC デバイス、USB ブリッジ CAN ファームウェア、または CAN0 デバイスが不足していることを意味する。

   Loading...

5. [Errno 100] Network is down または [Errno 105] No buffer space available が表示された場合、CAN ネットワークとID検索 に従って CAN0 設定を再確認する。

mcu 'mcu': Invalid CAN uuid

エラー情報：CAN UUID が無効、または認識できない。

Loading...

エラー原因：canbus_uuid: の入力間違い、デバイスがオンラインでない、または CAN ネットワークが正常に通信していない。

解決方法：

1. CAN ネットワークとID検索 に従って CAN UUID を再検索する。
2. printer.cfg に実際に検出された UUID が入力されていることを確認する。
3. 同じ [mcu] に serial: と canbus_uuid: が両方有効になっていないことを確認する。
4. CAN-H、CAN-L、終端抵抗、電源供給、ファームウェアの CAN レートを確認する。

Option 'serial' in section 'mcu' must be specified

エラー情報：[mcu] 設定セクションで serial を指定する必要がある。

Loading...

エラー原因：USB ファームウェア接続時に serial: が入力されていない、または [mcu] 設定セクションが誤って削除されている。

解決方法：

1. USB デバイス ID を再検索する。
2. printer.cfg の [mcu] 設定セクションに以下を入力する：

[mcu]
serial: /dev/serial/by-id/実際に検出されたID

3. 保存して Klipper を再起動する。

現在のマザーボードに CAN ファームウェアが書き込まれている場合は、canbus_uuid: を使用し、serial: は入力しないでください。

USB ID が見つからない / システムサービスの干渉

エラー情報：ls /dev/serial/by-id/* を実行しても出力がない、または No such file or directory と表示される。Klipper 接続時に mcu 'xxx': Unable to open serial port、[Errno 2] No such file or directory が表示される、または USB マザーボードがシステム上で繰り返し切断・再接続される。

よくある原因：

• マザーボードが Klipper ファームウェア実行状態になっておらず、Katapult / CanBoot / DFU などの書き込みモードのままである。
• USB ケーブル、USB ポート、上位コンピューターの電源供給、またはマザーボードの電源供給に異常がある。
• Debian 11 Bullseye の一部の udev バージョンに問題があり、/dev/serial/by-id/ デバイスパスが生成されない可能性がある。
• デスクトップ版 Linux には ModemManager や BRLtty がインストールされている可能性があり、これらのサービスがシリアルポートデバイスを占有し、Klipper がマザーボードに安定して接続できなくなる可能性がある。

調査方法：

電源オフ作業

USB ケーブルの抜き差し、マザーボード電源ケーブルの確認、USB/CAN ケーブルハーネスの整理を行う前には、必ずプリンターの電源を完全に切り、電源供給を遮断してください。通電状態でインターフェースの配線順序を整理したり、端子に触れたりしないでください。

1. まず、マザーボードに Klipper ファームウェアが書き込まれ実行されていることを確認します。USB ID には usb-Klipper が含まれている必要があります。katapult、canboot、Bootloader、DFU モードの ID を printer.cfg に書き込まないでください。
2. 電源を切り、信頼性の高い USB データケーブルと上位コンピューターの USB ポートに交換し、再び電源を入れてから ls /dev/serial/by-id/* を再実行します。
3. Debian 11 Bullseye、旧バージョンの MainsailOS / FluiddPi / Armbian などを使用している場合は、次のコマンドを実行して udev のバージョンを確認します。

apt-cache policy udev

4. Debian 11 の udev の問題であることが確認できた場合は、システムの通常のアップデートソースから優先的に udev をアップグレードするか、新しいシステムイメージに交換します。
5. シリアルポートを占有する可能性のあるサービスが存在するか確認します。

systemctl list-units --all | grep -Ei 'ModemManager|brltty'

6. これらのサービスがインストールされていることが確認でき、現在の上位コンピューターにモデムや点字端末機能が必要ない場合は、前のコマンドで表示された完全なユニット名をコマンドに置き換えて、サービスを停止・無効化した後、システムを再起動します。

sudo systemctl disable --now ModemManager.service
sudo systemctl disable --now brltty.service
sudo systemctl disable --now brltty.path

7. 完了後、USB ID を再確認し、printer.cfg の [mcu] の serial: が実際の出力と一致していることを確認します。

関連設定の参考：MCU ID 設定。

Lost communication with MCU

エラー情報：Klipper と MCU の通信が中断。ログに Lost communication with MCU、Lost communication with mcu、または類似のメッセージが表示される可能性がある。

よくあるシナリオ：原点復帰や移動中に、エンドストップスイッチが作動すると、マザーボードやツールボードが切断される。再起動すると再接続される。

よくある原因：

• エンドストップスイッチの配線ミス。作動時に信号ピンが電源またはグランドに異常短絡する。
• 3線式エンドストップ、光電リミット、またはホールリミット使用時に、電源、グランド、信号線の順序を間違えている。
• エンドストップのケーブルハーネスの被覆損傷、ケーブル圧着、またはケーブルベア動作時の短絡。
• エンドストップ作動時にマザーボードの電源供給が変動し、MCU が再起動するか、USB/CAN 通信が中断する。
• MCU と上位コンピューター間の USB/CAN 通信線が強力なノイズ源の近くを通っている。エンドストップ作動や動作時に切断が発生しやすくなる。
• 設定内のエンドストップピンが実際の配線と一致しておらず、間違ったインターフェースが作動している。

調査方法：

電源オフ作業

エンドストップケーブルの抜き差し、配線順序の確認、ケーブルベアハーネスの確認、またはテスターを使用した導通・抵抗測定を行う前には、必ずプリンターの電源を完全に切り、電源供給を遮断してください。テスターの抵抗/導通レンジは電源オフ状態でのみ使用可能で、通電状態での抵抗測定や短絡テストは禁止です。

1. 電源を切り、エンドストップスイッチの配線順序、特に3線式エンドストップの VCC、GND、Signal が間違っていないか確認します。
2. 電源を切り、該当するエンドストップケーブルを一時的に抜き、再度しっかりと取り付けてから電源を入れ、マザーボードが切断されないかテストします。
3. 電源を切り、テスターの導通/抵抗レンジを使用して、エンドストップ作動前後で短絡がないか確認します。特に信号ピンが電源に接続されていないか重点的に確認します。
4. ケーブルベア、コネクタ、ケーブルハーネスの屈曲部分を確認し、作動や移動時にケーブルが圧着されて短絡しないことを確認します。
5. MCU と上位コンピューター間の USB/CAN 通信線を確認し、可能な限りモーター線、加熱線、ヒーターベッド線、電源線から遠ざけます。
6. マシンの筐体、電源、またはシールドが適切にアースされていない場合、干渉を受けやすくなる可能性があります。メーカーが指定するアースポイントとコンセントの状態のみを確認し、電源を自分で分解したり、商用電源のアース線を変更したりしないでください。
7. 設定内のエンドストップピンがマザーボードのドキュメントおよび実際の配線と一致していることを確認します。
8. 問題修正後、QUERY_ENDSTOPS を実行し、エンドストップの状態が open から TRIGGERED に正常に変化することを確認します。

関連設定の参考：エンドストップ関連、電源配線の説明。

MCU Protocol error

エラー情報：MCU プロトコルエラー。ログに MCU Protocol error、Unknown command、Command format mismatch が表示される可能性がある。

Loading...

よくある原因：

• 上位コンピューターの Klipper を更新したが、マザーボードやツールボードのファームウェアを再コンパイルして書き込んでいない。
• マザーボード、ツールボード、EDDY、ADXL などの周辺 MCU のファームウェアバージョンが上位コンピューターの Klipper と一致していない。
• カスタムシステムやサードパーティプラグインを使用した結果、Klipper ホスト側と MCU でサポートされるコマンドに不一致が生じている。

解決方法：

1. 最近 Klipper、システムイメージ、またはプラグインを更新したか確認する。
2. 全ての MCU の Klipper ファームウェアを再コンパイルして書き込む。
3. ツールボード、EDDY、ADXL などの周辺 MCU がある場合は、対応する周辺ファームウェアも同時に更新する。
4. カスタムシステムを使用している場合は、そのシステムが現在の Klipper バージョンをサポートしているか確認する。
5. 書き込み完了後、FIRMWARE_RESTART を実行し、再接続してテストする。

個別 FAQ

項目	エントリー
設定競合、パラメータ解析、SAVE_CONFIG	設定関連エラー
不明なコマンド、マクロテンプレート、スライサー開始 G-code	設定関連エラー
動作、原点復帰、エンドストップ、プローブ、ベッドメッシュレベリング	動作、エンドストップ、レベリングエラー
温度、加熱、押出、フィラメント切れ検出	温度、加熱、押出エラー
パフォーマンス、タイムアウト、ファームウェア、システムサービス	システム、パフォーマンス、サービスエラー
G2/G3、円弧フィッティング、スライサーパス精度	円弧フィッティングの提案
TMC ドライバー通信、過熱、コイル問題	TMC エラー調査
CAN ネットワーク、UUID、bytes_invalid	CAN ネットワークとID検索
加速度計と共振テスト	加速度計テストとキャリブレーション
EDDY 渦電流プローブ	EDDY 問題集