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...

Calculate XY Offset Values​

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

Loading...

EDDY Calibration​

Precautions​

  • Ensure that no other probe configurations such as Probe or BL-Touch are enabled simultaneously.
  • Multi Z-axis machines require a manual bed leveling first.
  • Before calibration, check that the bed surface is free of debris and keep the nozzle clean.
Safety Tips

Wait for the nozzle to cool to a safe temperature before cleaning it; if cleaning must be performed while hot, use only specialized tools. Never touch the nozzle, hot end, or bed with your hands directly.

Add Temporary Configuration​

Important

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

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

The temporary macro below will move the machine without fully confirming the actual Z-axis position. Before execution, keep hands and tools clear, ensure nothing is obstructing the nozzle, 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}

Drive Current Calibration​

Enter the following command in the web console:

_LDC_CALIBRATE_DRIVE_CURRENT

After execution, the printer will move to the center position and raise the print head away from the bed. The system will then automatically perform the drive current calibration. Once completed, save the configuration and restart Klipper.

Height Calibration​

Tips
  • Multi Z-axis machines require a manual bed leveling first before performing height calibration.
  • After completing height calibration on multi Z-axis machines, it is recommended to perform another bed leveling and recalibrate the height.
  • Before calibration, check that the bed surface is free of debris and keep the nozzle clean.

Enter the following command 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 will appear. The Z height displayed by Klipper at this point is not important. Simply follow the on-screen prompts to gradually lower the nozzle until it makes light contact with the paper.

Once done, click ACCEPT in the dialog. The system will begin calibrating the EDDY height. After calibration is complete, click SAVE_CONFIG & Restart in the top right corner of the web interface to save the configuration and restart Klipper.

Frequently Asked Questions​

Q: What if the temperature rises too slowly?

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

Q: What if the data fluctuates significantly?

A: Ensure the paper test force is consistent, and check that the sensor is installed securely.

Q: What if the calibration is ineffective?

A: Confirm that SAVE_CONFIG has been executed and Klipper has been 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...