eddy
sidebar_position: 8 sidebar_label: EDDY FAQ
EDDY Sensor Common Issue Resolution 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 was a compatibility issue with the Z homing function of EDDY, which has been optimized in the Klipper update on January 6, 2026. Please proceed as follows based on your host computer type:
- If using a standard host computer, update Klipper to the latest version.
- If using a FLY host computer, upgrade the system version to V1.3.5 or higher. Note: After completing the above update, the EDDY needs to be recalibrated.
Method 2: Adjust Drive Current
- Open the
printer.cfgfile. - Locate the
reg_drive_current =parameter at the bottom of the configuration. - Increase or decrease its current value by 1 (e.g., if it is
15, change it to16or14). - Note: Please enter the calculated result directly (e.g.,
16), do not enter an expression (e.g.,15+1). - Save the file and restart the printer, then re-test homing.
Loading...
Method 3: Adjust Probe Offset If Method 1 is ineffective:
- Find the
[probe_eddy_current fly_eddy_probe]configuration section inprinter.cfg. - Increase the
z_offset:value (default is1.0, try2.0or2.5first). - Important Notes:
- This parameter can only be configured once in this location. Do not configure it repeatedly.
- It is recommended not to exceed
3.0; the specific value depends on your machine's hardware.
- Save and restart the printer, then test.
Loading...
Issue 2: Prompt !! probe_eddy_current sensor not in valid range
This error indicates that the probe reading is out of the valid range.
- Main Cause: After enabling the EDDY probe, the probing height set in other locations (e.g.,
[Horizontal_move_Z]or[bed_mesh]modules) may not take effect, causing the probe to move beyond its physical range. - Solution: Check and ensure all configuration heights involving probe descent are within the sensor's valid range.
Loading...
Important Reminders
- Empirical Reference for
z_offsetValue: In a large number of cases we have handled, setting the initialz_offsetvalue in[probe_eddy_current fly_eddy_probe]to2.5often allows many EDDY sensors to enter a working state relatively quickly. You can use this as an efficient debugging starting point. - Important Note: This is not a universal fixed value, nor is it an official default configuration. The optimal offset for the probe strictly depends on your specific machine hardware (e.g., probe installation position).
Loading...