Eddy Usage
info
- If you have previously configured the eddy settings, please delete them.
- When installing Eddy, the coil should be above the nozzle and 0.6-0.8cm away from the nozzle.
- Do not turn on the heated bed during testing.
- Before use, delete the
probe
configuration in the settings.
Note
- For multi-Z-axis machines, manual leveling needs to be done once.
Wiring Diagram
- Install with the trademark facing the heated bed.

Usage Instructions
- Log in to the terminal via SSH using the IP address, and execute the script. Download the required SSH tool MobaXterm tool
- International Use
- Domestic Use
Please use the following command for international use
Start installing the eddy automated script below
- Open the downloaded SSH tool, enter the command below, press Enter, and click copy.
rm -rf ./Eddy-Automated-Configuration-Script
git clone https://github.com/xishangyue/Eddy-Automated-Configuration-Script.git
sudo chmod +x ./Eddy-Automated-Configuration-Script/eddy1.sh
./Eddy-Automated-Configuration-Script/eddy1.sh
- Add the following configuration to the
moonraker.conf
file in thefluidd
web page for easier updates later.
[update_manager Eddy-Automated-Configuration-Script]
type: git_repo
channel: dev
path: ~/Eddy-Automated-Configuration-Script
origin: https://github.com/xishangyue/Eddy-Automated-Configuration-Script.git
primary_branch: main
install_script: eddy1.sh
managed_services: klipper
- If updated, run the following command.
sudo chmod +x ./Eddy-Automated-Configuration-Script/eddy1.sh
./Eddy-Automated-Configuration-Script/eddy1.sh
Please use the following command for domestic use
Start installing the eddy automated script below
- Open the downloaded SSH tool, enter the command below, press Enter, and click copy.
rm -rf ./Eddy-Automated-Configuration-Script
git clone https://gitee.com/xi2746810485/Eddy-Automated-Configuration-Script.git
sudo chmod +x ./Eddy-Automated-Configuration-Script/eddy1.sh
./Eddy-Automated-Configuration-Script/eddy1.sh
- Add the following configuration to the
moonraker.conf
file in thefluidd
web page for easier updates later.
[update_manager Eddy-Automated-Configuration-Script]
type: git_repo
channel: dev
path: ~/Eddy-Automated-Configuration-Script
origin: https://gitee.com/xi2746810485/Eddy-Automated-Configuration-Script.git
primary_branch: main
install_script: eddy1.sh
managed_services: klipper
- If updated, run the following command.
sudo chmod +x ./Eddy-Automated-Configuration-Script/eddy1.sh
./Eddy-Automated-Configuration-Script/eddy1.sh
- When executed, if it shows as shown in the image, input your host machine password.

- If it shows as shown in the image, input 'choose input', then input the corresponding number of your printer and press Enter.
- Choose '3z' to ensure that the
printer.cfg
has thez_tilt
configuration, or choose '4z' to ensure that theprinter.cfg
has thequad_gantry_level
configuration. For independent dual Z, choose '3z'. Configuration Reference

- If it displays as shown in the image, you need to input 'Y' and press Enter.

- If you are using 'sb2040-v3-PROV3', input 'y' and press Enter.

- If it shows as shown in the image, it means success.

info
- For printers with
z_tilt
orquad_gantry_level (QGL)
features, remember to perform multi-Z leveling.
Tips:
- Set your XY offset according to the following images before proceeding. Refer to XY Offset Calibration (Probe_Calibrate) Method.



Step 1: Calibrate EDDY
info
Divided into two small steps.
- Step 1
- Check if your homing macro is
safe_z_home
. If configured, proceed to the next step.
[safe_z_home]
home_xy_position:150,150 # XY center point coordinates, calculated by dividing the maximum bed size by 2 and adjust accordingly
speed:300 # Homing speed
z_hop:10 # Lift height before homing
-
Click the macro command
CALIBRATE_DD
shown in the image and execute it. -
Use the console to move the Z-axis toolhead to touch the heated bed, then continue with the prompts.
-
Click the macro command
CALIBRATE_EDDY
shown in the image and execute it.


- Click the macro command CALIBRATE_EDDY shown in the image and execute it.

- Then the following UI interface will appear.
- Adjust the
Z-offset
value using an A4 paper in the popped-up UI interface. Before adjusting, refer to the Klipper documentation tutorial Paper Test. - Once the appropriate value is found, click
ACCEPT
.
- After calibration, save the parameters with
SAVE_CONFIG
.
info
- The test homing is complete.
- If it does not return home normally,
- Modify the reference current value by referring to the files below.


Step 2: Temperature Compensation
info
- Do not heat the heated bed or nozzle before performing temperature compensation.
- Execute the macro command
TEMP_COMPENSATION
shown in the image and click to run.


- After executing this operation, the UI will display a Z-axis adjustment box. Use the manual Z-axis Offset Calibration (Paper Test) method mentioned above, insert a piece of paper between the nozzle and the bed, and confirm the value.
- After accepting the value, the heated bed temperature will automatically be set to 80°C, and the nozzle temperature will be set to 250°C.
- If you are in a room with air conditioning or open windows, to ensure the temperature rise of Eddy, it is recommended to turn off the air conditioning or windows as wind may affect the temperature increase.
- As the Eddy temperature rises, the system will automatically prompt you to manually calibrate the Z-offset every 3°C. Be cautious of burns as the heated bed temperature is very high!
- Repeat the manual Z-offset calibration (Paper Test) until calibration is complete. If you find that the Eddy temperature no longer rises, you can use the following relevant commands to end calibration early.
- During drift calibration, additional available G-code commands include: TEMPERATURE_PROBE_NEXT
TEMPERATURE_PROBE_NEXT
- Used to force Eddy to sample new data before reaching the target temperature of 80°C for EDDy.TEMPERATURE_PROBE_COMPLETE
- Used to complete calibration before Eddy reaches the set temperature of 80°C.ABORT
- Can be used to terminate calibration and ignore the results.- When calibration is complete, use
SAVE_CONFIG
to save the temperature offset settings! - In summary, compared to most other programs, the above calibration process is more challenging and time-consuming. It may require practice and multiple attempts to provide excellent first-layer printing results over a wide range of temperatures!
How to Fine-Tune Z-Offset
- Step 1: Use pursa/OrcaSlicer/cura/Bambu Studio to slice a 200x200mm square with a height of 0.2mm to print and fine-tune the z-offset.
- Step 2: Access
fluidd
ormainsail
via the printer's IP address to find the dashboardMovement Control
, where you can fine-tune the Z-axis offset z_OFFSET.

- After calibration, save the parameters with
SAVE_CONFIG
.
No Changes in Values
- Find the corresponding file in the image and modify it inside.

- After calibration, save the parameters with
SAVE_CONFIG
.
info
- After completing the above operations, if the sweeping bed fails, please change the Z limit to a virtual limit and overwrite the original endstop_pin
endstop_pin: probe:z_virtual_endstop
.
Coil Model Download Links
https://cdn.mellow.klipper.cn/STEP/sen.step
https://cdn.mellow.klipper.cn/STEP/1612.step