EDDY Sensor Troubleshooting Guide

Issue 1: Error Error during homing z: Eddy current sensor error during homing

If you encounter this error, please try the following methods in order:

Method 1: Update Klipper

Important Notice

There were previously compatibility issues with EDDY's Z homing function, which have been optimized in the Klipper update from January 6, 2026. Please perform the following operations based on your host type:

• If using a standard host, please update Klipper to the latest version.
• If using a FLY host, please upgrade the system version to V1.3.5 or higher. Please note: After completing the above updates, you need to recalibrate the EDDY sensor.

Method 2: Adjust Drive Current

1. Open the printer.cfg file.
2. Find the reg_drive_current = parameter at the bottom of the configuration.
3. Increase or decrease its current value by 1 (e.g., if it's 15, change it to 16 or 14).
4. Note: Please enter the calculated result directly (e.g., 16), do not enter an expression (e.g., 15+1).
5. Save the file and restart the printer, then test homing again.
   Loading...

Method 3: Adjust Probe Offset If Method A is ineffective:

1. In printer.cfg, find the [probe_eddy_current fly_eddy_probe] configuration section.
2. Increase the z_offset: value within it (default is 1.0, try 2.0 or 2.5 first).
3. Important Notes:
   • This parameter must only be configured here once; do not configure it elsewhere.
   • It is recommended not to exceed 3.0. The specific value depends on your machine's hardware.
4. Save and restart the printer, then test.
   Loading...

Issue 2: Prompt !! probe_eddy_current sensor not in valid range

This error indicates the probe reading is outside the valid range.

• Main Cause: After enabling the EDDY probe, the probing heights set elsewhere (e.g., in the [Horizontal_move_Z] or [bed_mesh] modules) might not take effect, causing the probe to move beyond its physical range.
• Solution: Please check and ensure that all configured probing heights involving the probe's descent are within the sensor's valid range.
  Loading...

Important Reminders

• Empirical Reference for z_offset Value: Based on numerous cases we've handled, setting the initial z_offset value in [probe_eddy_current fly_eddy_probe] to 2.5 often allows many EDDY sensors to become operational relatively quickly. You can use this as an efficient debugging starting point.
• Important Clarification: This is not a universal fixed value nor an official default configuration. The optimal probe offset strictly depends on your machine's specific hardware (e.g., probe mounting position).

---