EDDY センサーに関するFAQ解決ガイド
EDDY センサーよくある質問
ホーミング時に Error during homing z: Eddy current sensor error が発生する
このエラーが発生した場合は、順番に調査してください。
Klipper またはシステムを更新する
EDDY の Z ホーミング機能には以前互換性の問題があり、2026年1月6日の Klipper アップデートで最適化されました。
- 一般的なホスト機:Klipper を最新の安定版に更新してください。
- FLY ホスト機:システムバージョンを V1.3.5 以降にアップグレードしてください。
更新完了後、EDDY の再較正が必要です。
ドライブ電流を調整する
printer.cfgファイルを開きます。- 設定の最下部にある
reg_drive_current =パラメータを見つけます。 - 現在の値を
1増減させます。例:15を16または14に変更します。 - 計算結果を直接入力してください。
15+1のような計算式は入力しないでください。 - ファイルを保存してプリンターを再起動し、ホーミングを再テストします。
プローブオフセットを調整する
更新とドライブ電流の調整後も効果がない場合は、descend_z を確認してください。
printer.cfg内の[probe_eddy_current fly_eddy_probe]設定セクションを見つけます。descend_z:を適切に大きくします。デフォルト値は通常0.5ですが、まず2.0または2.5を試してください。- このパラメータはこの設定セクション内に1箇所のみ記述してください。重複して設定しないでください。
- 推奨値は
3.0を超えないようにしてください。最終的な値はマシン構造とプローブ取り付け高さに基づいて決定します。 - 保存してプリンターを再起動し、ホーミングを再テストします。
Klipper 2026年3月以降の [probe_eddy_current] 設定では descend_z を使用します。旧設定の z_offset は廃止され、将来のバージョンでサポートが削除される可能性があります。チュートリアル、旧設定、スクリーンショットに z_offset と記載されている場合は、descend_z に変更してください。
Amplitude Low/High warning が表示される
エラーメッセージ:my_eddy_probe: Amplitude Low/High warning (36)、Amplitude Low/High warning (48) など。括弧内の数字は実測の振幅値です。
一般的な原因:
reg_drive_currentの設定が不適切で、センサーの発振振幅が理想的な範囲を超えている。- プローブとヒートベッドの間隔(スタンドオフ)が大きすぎる、または小さすぎる。
- プローブの取り付けが緩んでいる、またはヒートベッド表面が平らでない。
解決方法:
- ドライブ電流の較正を再実行します:
LDC_CALIBRATE_DRIVE_CURRENT CHIP=fly_eddy_probe、次にSAVE_CONFIG。 - 較正後も警告が続く場合は、上記の「ドライブ電流を調整する」セクションに従って
reg_drive_currentを手動で微調整します(毎回±1)。 - プローブの取り付けがしっかりしているか確認し、プローブ底面とヒートベッド表面の間隔は 0.3–1.0 mm を推奨します。
- ヒートベッドが平らな金属表面であり、反りや凹凸がないことを確認します。
- 警告が特定の位置でのみ発生する場合は、ヒートベッドの局所的な凹凸が原因の可能性があります。別の位置で再較正を試してください。
!! probe_eddy_current sensor not in valid range が表示される
このエラーは、プローブの読み取り値が有効範囲を超えていることを示します。一般的な原因は、EDDY プローブを有効にした後、他の設定セクションのプローブ高さが期待通りに適用されず、プローブが物理的な測定範囲を超えて移動することです。
以下の場所を重点的に確認してください:
[probe_eddy_current fly_eddy_probe][bed_mesh][z_tilt]または[quad_gantry_level]- カスタムのホーミング、レベリング、ベッドメッシュマクロ
処理方法:
- すべてのプローブ動作の下降高さが EDDY の有効範囲内にあることを確認します。
- 複数のマクロや設定セクションが同じ高さパラメータを重複して上書きしないようにします。
- 変更後、保存して Klipper を再起動し、ホーミングまたはレベリングを再実行します。
Eddy I2C STATUS/DATA error または Invalid read data が表示される
この種のエラーは、EDDY と MCU 間の通信または読み取り値の異常を示します。
一般的な原因:
- EDDY の配線、コネクタ、またははんだ付け箇所の接触不良。
- I2C 配線が長すぎる、配線の品質が悪い、またはモーター線・ヒーター線と並行に配線され干渉している。
- I2C レートが高すぎて、現在の配線と環境では不安定。
- プローブへの電源供給が不安定。
処理方法:
EDDY の配線を抜き差しする、配線を整理する、またはコネクタを確認する前に、プリンターの電源を完全に切り、電源供給を切断してください。通電状態でセンサーを抜き差ししたり、端子に触れたりしないでください。
- 電源を切り、EDDY の配線を抜き差しし、端子が緩んでいないか確認します。
- EDDY の通信線をモーター線、ヒーター線、ヒートベッド線から離します。
- ハードウェア I2C を使用している場合は、I2C レートを下げてみてください。それでも不安定な場合はソフトウェア I2C をテストします。
- 市販の完成品ケーブルへの交換、ポート変更、センサー交換によるクロステストを優先してください。露出端子の電気的検査は、カスタマーサポートまたは専門家に依頼してください。
- 変更後、ホーミングまたは
PROBE_EDDY_CURRENT_CALIBRATEを再実行します。
I2C ピンと配線:EDDY I2C ピンと設定説明
Unable to obtain probe_eddy_current sensor readings が表示される
このエラーは、Klipper が規定時間内に有効な EDDY センサーデータを取得できなかったことを示します。
一般的な原因:
- センサーの通信線が断線している、または設定されたバス/ピンが誤っている。
- プローブが金属ベッド面から離れすぎており、読み取り値が有効範囲にない。
reg_drive_currentが不適切で、センサーの周波数範囲が十分でない。- ドライブ電流の較正または Z 高さの較正がまだ完了していない。
処理方法:
EDDY のバス、ピン配線を確認したり、センサーケーブルを交換する前に、プリンターの電源を完全に切り、電源供給を切断してください。通電状態でセンサーを抜き差ししないでください。
- 電源を切り、
[probe_eddy_current fly_eddy_probe]内のバスとピン設定が実際の配線と一致していることを確認します。 - プリントヘッドをヒートベッド中央に移動し、EDDY が金属ベッド面の上方にあることを確認します。
LDC_CALIBRATE_DRIVE_CURRENT CHIP=fly_eddy_probeを再実行し、SAVE_CONFIGを実行します。PROBE_EDDY_CURRENT_CALIBRATE CHIP=fly_eddy_probeを再実行します。- ホーミング時のみ発生する場合は、この文書の上部にある「ホーミング時のエラー」セクションに従って
reg_drive_currentとdescend_zを調整します。
MCU Protocol error: Unknown command i2c_write
エラーメッセージ:MCU Protocol error、mcu 'eddy': Unknown command: i2c_write、Command format mismatch。
この種のエラーは通常、EDDY / RP2040 周辺 MCU ファームウェアとホスト機の Klipper バージョンが一致していないことを示します。一般的なシナリオは、ホスト機の Klipper を更新したが、EDDY ファームウェアを再コンパイルして書き込んでいない場合です。また、EDDY ファームウェアがホスト機の Klipper より新しい場合、ホスト側が周辺ファームウェアが使用する新しいコマンドを認識できない可能性もあります。
処理方法:
klippy.log内のGit versionとLoaded MCU 'eddy' ... versionを確認し、ホスト機と EDDY ファームウェアが同じ Klipper バージョンからのものであるか確認します。- EDDY が接続されている MCU ファームウェアを再コンパイルして書き込みます。書き込み方法は、対応するツールボードまたは EDDY 製品ドキュメントに従ってください。
- サードパーティの統合システムまたはメーカーカスタム Klipper を使用している場合は、そのシステムが現在の EDDY ファームウェアをサポートしているか確認してください。不明な場合は、同じシステムが提供するファームウェアパッケージを優先的に使用してください。
- 書き込み完了後、
FIRMWARE_RESTARTを実行し、EDDY のドライブ電流と高さの較正を再実行します。
一般的なバージョン調査:MCU Protocol error
TAP モードのトリガー異常
EDDY の METHOD=tap を使用する際、プローブが早期に停止する、ベッド面に接触しても停止しない、または結果が明らかに不安定な場合、通常は tap_threshold とノズル/ベッド面の状態に関連しています。
詳細な手順:EDDY TAP モードデバッグ方法
TAP テストではノズルがヒートベッドに接近または接触します。実行前にノズルとベッド面が清潔であること、手や工具が動作領域から離れていることを確認し、緊急停止に備えてください。
調査のポイント:
- ノズルとベッド面が清潔であることを確認します。ノズルの残留物は TAP 結果に直接影響します。
- TAP を開始する前に、ノズルとベッド面の距離は数ミリメートル範囲内に保つことをお勧めします。近すぎたり遠すぎたりしないでください。
- ベッド面に接触せずに停止する場合、
tap_thresholdが低すぎる可能性があります。適切に大きくしてください。 - ベッド面に接触しても停止しない場合、
tap_thresholdが高すぎる可能性があります。すぐに停止して閾値を下げてください。 - 調整後、
PROBE_EDDY_CURRENT_TAP_CALIBRATEを再実行し、成功したらSAVE_CONFIGを実行します。
ホーミング / TAP 時に Timer too close が発生する
エラーメッセージ:MCU 'xxx' shutdown: Timer too close。
エラーの性質:EDDY のホーミング、TAP、または Z_TILT_ADJUST は trsync タイマー同期メカニズムを使用しており、特定の条件下でクロックの巻き戻りが発生する可能性があります。Klipper の上流開発者は関連するケース(ログ内の trsync クロック巻き戻り、32ビットオーバーフロー)を確認しており、既知の未修正の問題であり、断続的に発生し、再現が不安定です。必ずしも配線やハードウェアの損傷を意味するわけではありません。
よくある原因:
- EDDYホーミング / TAP の trsync タイミング同期が特定条件下でクロックバックする。
- CANツールボード環境で発生しやすく、エラー前後に
Stats行にCAN再送信またはホスト側負荷スパイクが同時に現れることがある。 - サードパーティプラグイン(自動速度調整、自動チューニング、モーター同期など)を重ねた場合、発生確率が上昇する。
処理方法:
- Klipper を更新し、すべてのMCUファームウェアを再書き込みして、ホスト、ツールボード、EDDY MCUのバージョンが一致していることを確認する。
Z_TILT_ADJUSTは一時的にMETHOD=scanに切り替えることができる。スキャンモードは trsync パスを使用しないため、発生確率を大幅に低下させられる。- 起動マクロを簡素化し、繰り返しのホーミング、繰り返しのTAP、連続ベッドスキャン動作を避けて、トリガー機会を減らす。
- サードパーティプラグイン(自動速度調整、自動チューニングなど)を一つずつ無効化して再テストし、プラグインの組み合わせが原因か確認する。
- CAN再送信または通信異常が同時に見られる場合は、CAN エラー調査 に従って配線とバス状態を確認する。
TAP 専用調査:EDDY TAP / Z_TILT が Timer too close をトリガー
システム系調査:Timer too close
ベッドスキャン / レベリング中に stepcompress 内部エラーが発生
エラーメッセージ:Internal error in stepcompress、Error in syncemitter 'xxx' step generation、Exception in flush_handler。
EDDY高速ベッドスキャン、BED_MESH_CALIBRATE、Z_TILT_ADJUST またはスキャナーによるベッドスキャン時に、動作キューとEDDYサンプリングが重なりステップ生成で内部例外が発生すると、このようなエラーが現れる可能性がある。
処理方法:
- 完全な
klippy.logを保存し、エラー前後の Python Traceback と実行中のコマンドを確認する。 - ベッドスキャン速度、プローブ点数、補間密度、EDDYスキャンパラメータを下げて再テストする。
- サードパーティのスキャナー、自動速度調整、自動レベリング強化などのプラグインを一時的に無効化し、オリジナルのKlipperで再テストする。
- Klipperを更新後、すべてのMCUファームウェアを再書き込みする。
温度ドリフトによる初層の不安定さ
EDDYは渦電流センサーであり、ベッド温度、ノズル温度、センサーコイル温度、近くの金属部品の温度変化が測定結果に影響を与える。典型的な症状は:コールドスタート時のキャリブレーションは正常だが、加熱後のプリントで初層が高すぎる、または低すぎる。
処理方法:
- 実際のプリント温度に近い状態でEDDYキャリブレーションを実施する。
- プリント前に熱ベッドとノズル温度が安定してからホーミング、レベリング、またはベッドスキャンを行う。
- EDDYに温度センサーがある場合、
[temperature_probe]を設定し、温度ドリフト補償を行う。 - 密閉筐体のマシンは、筐体内温度が安定してから精密キャリブレーションを実施することを推奨。
descend_z デバッグの提案
多くのデバッグ事例において、[probe_eddy_current fly_eddy_probe] 内の descend_z 初期値を 2.5 に設定することで、多くのEDDYセンサーがより早く動作可能な状態に入ることが多い。
2.5 はデバッグの開始点であり、汎用の固定値でも公式のデフォルト設定でもない。最適なオフセットはプローブ取り付け位置、ノズル高さ、マシン構造に依存するため、実際のキャリブレーション結果に従うこと。