よくあるエラー概要

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

クイックインデックス

エラータイプ	よくあるキーワード	調査エントリ
接続問題	Unable to connect、Invalid CAN uuid、Lost communication、MCU Protocol error、/dev/serial/by-id、Unable to issue reset command、Got EOF when reading from device	このページの接続問題、MCU ID 設定、CAN ネットワークと ID 検索
設定問題	not valid、not a valid config section、must be specified、Unable to parse、SAVE_CONFIG、Option conflict、virtual_sdcard、pause_resume、display_status	設定関連エラー
マクロとスライサーコマンド	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、virtual_endstop、Unknown pin chip name、Homing failed due to printer shutdown	モーション、リミット、レベリングエラー、リミットなしホーミングの調査
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、no samples between time、SVD did not converge	モーション、リミット、レベリングエラー、BLTouch 設定と調査
温度/加熱	ADC out of range、not heating at expected rate、Verify heater、temperature、Thermocouple reader fault	温度、加熱、押出エラー
押出問題	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、Move queue overflow、stepcompress、Rescheduled timer、restarting too fast、SD busy、Unhandled exception during run、hard pwm event、Can't reset time when stepper active	システム、パフォーマンス、サービスエラー
TMC ドライバー	Unable to read tmc uart、Unable to write tmc spi、GSTAT、coil short circuit、tmcuart_response	TMC エラー調査
CAN ネットワーク	bytes_invalid、Network is down、No buffer space available、Invalid CAN uuid、USB CANBUS bridge、BUS-OFF	CAN ネットワークと ID 検索、CAN エラー調査
センサー周辺機器	Invalid adxl345 id、No data、Insufficient axis、Eddy current sensor error、Invalid read data、load_cell_probe、START_READ_NACK、I2C、BUS_TIMEOUT	加速度計テストとキャリブレーション、EDDY 問題集、Load Cell プローブ調査、このページの I2C 通信エラー
共振補償とプレッシャーアドバンス	shaper_freq、input_shaper、pressure_advance、smooth_time、accel_chip、TEST_RESONANCES、SHAPER_CALIBRATE	共振補償とプレッシャーアドバンス

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

エラー方向	推奨リファレンス
設定構文、インデント、コメント、ピン重複	設定変更の説明
ホーミング方向、軸方向、強制移動	ホーミングと方向調整ガイド
リミット、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設定。

Serial connection closed

エラー情報：mcu 'xxx': Serial connection closed、KlipperとMCUのシリアル接続が予期せず切断されました。

よくある原因：

• USBケーブルの接触不良または品質が悪い。
• CANブリッジデバイス（UTOCなど）の電源供給が不安定、またはファームウェアの異常。
• マザーボードの電源供給の変動によりMCUが再起動。
• CANネットワーク通信の異常により、デバイスがオフラインになる。

解決方法：

1. 電源を切り、USB / CANケーブルを抜き差しし、信頼性の高い接続ケーブルに交換します。
2. CANブリッジデバイスの電源供給とファームウェアの状態を確認し、必要に応じてCAN IDを再検索します。
3. マザーボードの電源供給が安定していることを確認し、大電力デバイスと電源回路を共有しないようにします。
4. 問題が繰り返し発生する場合は、CANエラー調査 と Lost communication with MCU を参照してさらに調査します。

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にリセットコマンドを発行できない

エラー情報：Unable to issue reset command on MCU 'xxx'。ログには通常、webhooks client ...: Disconnected と Restarting printer が伴います。

エラーの性質：このエラーは通常、最初のエラーではなく、MCUがオフライン、電源断、または通信断になった後、KlipperがMCUにリセットコマンドを送信しようとして失敗した際の後続の通知です。調査時には、より早い時点で発生した最初の真のエラー（Lost communication with MCU、Timer too close、Verify heater、TMCエラーなど）を遡って確認してください。

一般的な原因：

• 先行してMCUがオフライン、USB / CAN通信が中断、またはファームウェアがクラッシュし、リセットコマンドが届かない。
• マザーボード、ツールボード、または周辺MCUへの電力供給が不足し、リセット中に電源が落ちる。
• USBケーブル、CANケーブルの接触不良またはケーブル損傷。
• MCUが高負荷タスク（加熱、多点ベッドメッシュなど）を実行中に強制リセットされた。
• ホストとMCU間の信号に強い干渉（モーター線、ヒーター線が通信線に近接）がある。

解決方法：

電源オフ操作

USB / CANケーブルの抜き差し、ケーブルチェック、または配線の整理を行う前に、プリンターの電源を完全に切り、電源供給を遮断してください。通電状態でケーブルを抜き差ししたり、端子に触れたりしないでください。

1. klippy.log を開き、Unable to issue reset command の前に最初の真のエラーを見つけ、対応する分類に従って調査します。
2. 電源を切った後、USB / CANケーブルを抜き差しし、信頼性の高い既製ケーブルに交換して、接続が確実であることを確認します。
3. マザーボード、ツールボードへの電力供給が安定しているか確認し、モーターやヒートベッドなどの大電力機器と不安定な電源回路を共有しないようにします。
4. USB / CAN通信線がモーター線、ヒーター線、ヒートベッド線から離れていることを確認します。
5. FIRMWARE_RESTART を実行し、必要に応じて本体の電源を10秒間切り、再度電源を入れます。
6. 問題が繰り返し発生する場合は、Lost communication with MCU と CANエラー調査 を参照して調査を続けます。

デバイスからの読み取り時にEOFを検出

エラー情報：Got EOF when reading from device。ログには通常、Attempting MCU 'xxx' reset command の後に表示され、ホストがMCUへのリセットを開始した時点で、シリアル / USB接続がすでに切断されていることを示します。

エラーの性質：これはホストOS（Linux）層で返されるエラーであり、Klipperは pyserial が読み取ったファイル終端記号（EOF）をそのまま報告しているだけです。これはUSB / シリアルリンクが物理的に切断されたか、デバイスが消えたことを示しており、設定パラメータの問題ではありません。

一般的な原因：

• USBケーブルの品質が悪い、接触不良、USBポートの電力供給不足により、リセット中にデバイスがオフラインになる。
• マザーボード、ツールボードへの電力供給変動により、MCUがリセットまたは電源断となり、デバイスがシステムから消える。
• ホストのUSBコントローラー異常、USBポート障害、またはシステムのUSBスリープポリシー。
• CANツールボードがUSBブリッジ経由の場合、ブリッジデバイスがオフラインになる（この場合、ログに Unable to issue reset command on MCU が同時に表示されることがあります）。

解決方法：

電源オフ操作

USB / CANケーブルの抜き差し、電源線のチェック、またはケーブル交換を行う前に、プリンターの電源を完全に切り、電源供給を遮断してください。

1. 最初にどのMCUでエラーが発生しているかを確認し、対応するUSB / CAN接続リンクを検査します。
2. 電源を切った後、USBケーブルを抜き差しし、高品質のUSBケーブルに交換して、ホストの別のUSBポートでテストします。
3. ls /dev/serial/by-id/* を実行し、デバイスがシステム内にまだ存在するか確認します。デバイスが消えている場合は、電力供給、ケーブル、またはMCUリセットレベルの問題です。
4. マザーボード、ツールボードへの電力供給が安定しているか確認し、電源線の電圧降下が正常であることを確認します（電源を分解したり、商用電源配線を変更したりしないでください）。
5. ログに Unable to issue reset command on MCU が同時に表示される場合は、Unable to issue reset command も参照して処理します。
6. CANツールボード関連の場合は、CANエラー調査 に従ってバス状態を確認します。
7. 問題が繰り返し発生する場合は、Lost communication with MCU を参照して調査を続けます。

'xxx' 応答待ちタイムアウト

エラー情報：Timeout on wait for 'neopixel_result' response、Timeout on wait for 'trsync_state' response など。

一般的な原因：

• CAN / USB通信リンクが不安定で、MCUがホストの要求にタイムリーに応答しない。
• MCUの負荷が高すぎる（高速印刷 + 多軸連動 + 加速度計クエリの同時実行など）。
• Neopixel LEDの数が多すぎる、またはデータ線の品質が悪く、neopixel_result がタイムアウトする。
• MCUファームウェアのバージョンとホストが一致しない。

解決方法：

1. USB / CAN通信線の接続が確実か確認し、モーター線、ヒーター線などの干渉源からできるだけ離します。
2. Neopixelタイムアウトの場合は、LEDの数を減らすか、高品質のデータ線に交換し、data_pin 設定が正しいことを確認します。
3. すべてのMCUファームウェアのバージョンが一致していることを確認し、必要に応じて再コンパイルして書き込みます。
4. 印刷速度と加速度を下げて、再現するか観察します。

MCUプロトコルエラー

エラー情報：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 を実行し、再接続してテストします。

I2C通信エラー（START_READ_NACK / BUS_TIMEOUT）

エラー情報：MCU 'xxx' I2C request to addr 42 reports error START_READ_NACK、I2C request to addr 104 reports error START_READ_NACK、または I2C ... BUS_TIMEOUT。

一般的な原因：

• I2Cデバイスアドレスの設定が間違っている、またはバス上に対応するアドレスのデバイスがない。
• I2C配線の緩み、断線、またはSDA/SCLの接続逆転。
• プルアップ抵抗の欠如、またはバスが長すぎて信号が減衰する。
• センサーが準備完了になる前に読み取られた（例：電源投入直後に即座にクエリ）。
• 複数のI2Cデバイスアドレスが競合している。

解決方法：

電源オフ操作

I2C配線、センサーモジュール、またはプルアップ抵抗を確認する前に、プリンターの電源を完全に切り、電源供給を遮断してください。

1. 電源を切った後、I2C配線（SDA、SCL、VCC、GND）が確実に接続されているか確認し、逆接続がないことを確認します。
2. 設定のI2Cアドレスが実際のデバイスと一致しているか確認します。一般的なアドレス：ADXL345は 0x53（83）または 0x1D（29）、MPU6050は 0x68（104）。
3. I2Cバス上にプルアップ抵抗（通常4.7kΩ）があるか確認します。モジュールに内蔵されている場合は追加の必要はありません。
4. バスが長い場合（30cm以上）、配線を短くするか、I2Cレートを下げてみます。
5. 起動時に一度だけ発生する場合は、センサーの初期化遅延が考えられるため、その後安定して動作するか観察します。
6. 同じI2Cバス上に同じアドレスを使用するデバイスが2つないことを確認します。

EDDYプローブI2Cエラー：EDDY渦流プローブで BUS_TIMEOUT が発生する場合は、EDDY問題集 を参照してください。

特化FAQ

特化	エントリ
設定競合、パラメータ解析、SAVE_CONFIG	設定関連エラー
不明なコマンド、マクロテンプレート、スライサー開始G-code	設定関連エラー
動作、ホーミング、リミット、プローブ、ベッドメッシュレベリング	動作、リミット、レベリングエラー
センサーレスホーミング、virtual_endstop、DIAG感度	センサーレスホーミング調査、センサーレス使用
温度、加熱、押出、フィラメント切れ検知	温度、加熱、押出エラー
パフォーマンス、タイムアウト、ファームウェア、システムサービス	システム、パフォーマンス、サービスエラー
G2/G3、円弧フィッティング、スライサーパス精度	円弧フィッティング推奨
TMCドライバー通信、過熱、コイル問題	TMCエラー調査
CANネットワーク、UUID、bytes_invalid	CANネットワークとID検索
加速度計と共振テスト	加速度計テストとキャリブレーション
EDDY渦流プローブ	EDDY問題集
Load Cell、圧力センシングプローブ	Load Cellプローブ調査