Skip to main content

FLY-EDDY Calibration

Version Requirements

The Klipper official team has recently optimized the Eddy probe functionality, it is recommended to update to the latest version for use:

  • Regular host: Please update Klipper to the latest version
  • FLY Fast system: Please upgrade the system version to V1.3.8 or higher
  • The tool board or related MCU firmware also needs to be updated to the latest
Pre-use Checks
  • Before use, ensure that your printer does not have electrical leakage
  • If there are previously configured eddy, Probe, or BL-Touch configurations, please delete them
  • When installing EDDY, the coil should be above the nozzle, at a distance of 2~3mm from the nozzle
  • It is recommended not to turn on the heated bed during testing and calibration
Notes
  • Multi-Z axis machines need to manually level once first, then proceed with calibration

Calibration Process​

  • Click the button below to download the coil model:
Loading...

Calculating XY Offset Values​

After downloading the model, measure and calculate the XY offset values based on the actual structure of your printer, then modify the x_offset and y_offset values in the configuration.

Loading...
Loading...

EDDY Calibration​

Precautions​

  • Ensure that no other probe configurations such as Probe or BL-Touch are enabled simultaneously.
  • Multi-Z-axis machines need to be manually leveled once first.
  • Before calibration, check that there are no debris on the hot bed surface and keep the nozzle clean.
Safety Note

Wait until the nozzle has cooled to a safe temperature before cleaning it. If cleaning must be done while the machine is still hot, only use specialized tools—never touch the nozzle, hot end, or hot bed directly with your hands.

Adding Temporary Configuration​

Important Note

The configuration below is only for temporary calibration and must be deleted or commented out after use.

  1. After adding it, click Save & Restart to save and restart the system.
  2. It must be added at the top of the printer.cfg file—do not add it at the end.
Motion Risk

The temporary macros below will move the machine before the true position of the Z-axis is fully confirmed. Move your hands and tools away, ensure nothing is blocking under the nozzle before execution, and be ready to use the emergency stop at any time.

[force_move]
enable_force_move: true

[gcode_macro _LDC_CALIBRATE_DRIVE_CURRENT]
gcode:
    BED_MESH_CLEAR
    SET_KINEMATIC_POSITION x=100 y=100 z=10
    G28 X Y
    M104 S0
    M140 S0
    M106 S0
    G0 X{printer.toolhead.axis_maximum.x / 2} Y{printer.toolhead.axis_maximum.y / 2} F6000
    G0 Z30 F600
    G4 P1000
    LDC_CALIBRATE_DRIVE_CURRENT CHIP=fly_eddy_probe
    G4 P1000
    SAVE_CONFIG

[gcode_macro PROBE_EDDY_CURRENT_CALIBRATE_AUTO]
gcode:
    BED_MESH_CLEAR
    G28 X Y
    M104 S0
    M140 S0
    M106 S0
    G90
    G1 X{ printer.toolhead.axis_maximum.x/2 } Y{ printer.toolhead.axis_maximum.y/2 } F6000
    {% if 'z' not in printer.toolhead.homed_axes %}
        SET_KINEMATIC_POSITION Z={ printer.toolhead.axis_maximum.z-1 }
    {% endif %}
    PROBE_EDDY_CURRENT_CALIBRATE {rawparams}

Driving Current Calibration​

Enter the following in the web console:

_LDC_CALIBRATE_DRIVE_CURRENT

After execution, the printer will move to the center position and lift the nozzle away from the hot bed. The system will then automatically calibrate the driving current. Once calibration is complete, save the configuration and restart Klipper.

Calibration Height​

Tips
  • Multi-Z-axis machines need to be manually leveled once before performing height calibration.
  • After height calibration, it is recommended to level the machine again and recalibrate the height.
  • Before calibration, check that there are no debris on the hot bed surface and keep the nozzle clean.

Enter the following in the web console:

PROBE_EDDY_CURRENT_CALIBRATE_AUTO CHIP=fly_eddy_probe

After execution, the printer will move to the center position, and a calibration dialog box will appear. At this point, the Z height displayed by Klipper is not important—simply follow the on-screen prompts to lower the nozzle gradually until slight friction occurs between the nozzle and the paper.

After completion, click ACCEPT in the dialog box. The system will start calibrating the EDDY height. Once calibration is done, click SAVE_CONFIG & Restart in the upper right corner of the web page to save the configuration and restart Klipper.

Common Questions​

Q: What if the temperature rises too slowly?

A: Check if the environment is enclosed and if there are any significant air currents. If heating is too slow, you can end the calibration early.

Q: What if the data fluctuates greatly?

A: Ensure consistent force when testing with paper and check that the sensors are securely installed.

Q: What if calibration doesn’t work after completion?

A: Make sure SAVE_CONFIG was executed and Klipper was restarted.

TAP Mode Recommended​

Prerequisite

TAP mode relies on driver current and height calibration data, the calibration process above must be completed first for normal use; if calibration has not been completed, TAP mode cannot trigger properly.

FLY-EDDY supports both normal probing and TAP trigger modes, TAP mode is recommended:

  • TAP mode determines the trigger threshold by lightly touching the bed surface with the nozzle. The trigger point is closer to the actual printing gap, resulting in more stable Z offset
  • Each print can use SET_Z_FROM_PROBE METHOD=tap to automatically confirm the Z offset, reducing first-layer issues
  • Supports automatic threshold calibration (PROBE_EDDY_CURRENT_TAP_CALIBRATE), no need to manually set tap_threshold

To enable TAP mode, add the following to [probe_eddy_current fly_eddy_probe]:

tap_z_offset: 0

# Comment out before automatically calibrating the TAP threshold; it will be written by SAVE_CONFIG after successful calibration
# tap_threshold: 40000

TAP Mode Debugging: EDDY TAP Mode Debugging

EDDY Troubleshooting: EDDY Sensor Common Issues

Reference Configuration: FLY-EDDY Reference Configuration

Loading...