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.
Notice
- For multi-Z axis machines, manual leveling needs to be done once properly.
Wiring Diagram
- Install the trademark facing the heated bed.

Usage Instructions
- Log in to the terminal via SSH tool 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 users.
Below is the start of the installation of the eddy automated script.
- Open the downloaded SSH tool, enter the following command and press Enter, then 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
- In the
fluidd
web page'smoonraker.conf
configuration file, add the following configuration 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 you have updated, use the SSH tool to execute the following commands.
sudo chmod +x ./Eddy-Automated-Configuration-Script/eddy1.sh
./Eddy-Automated-Configuration-Script/eddy1.sh
Please use the following command for domestic users.
Below is the start of the installation of the eddy automated script.
- Open the downloaded SSH tool, enter the following command and press Enter, then 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
- In the
fluidd
web page'smoonraker.conf
configuration file, add the following configuration 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 you have updated, use the SSH tool to execute the following commands.
sudo chmod +x ./Eddy-Automated-Configuration-Script/eddy1.sh
./Eddy-Automated-Configuration-Script/eddy1.sh
- Execute it and if shown as in the figure, input your host machine password.

- If shown as in the figure, input the corresponding number for your printer, there are Chinese and English options, press Enter after inputting.
- Choose
3z
to ensure that theprinter.cfg
has thez_tilt
configuration or choose4z
to ensure that theprinter.cfg
has thequad_gantry_level
configuration. For independent dual Z-axis, select3z
. Configuration reference

- If shown as in the figure, you need to input
Y
and press Enter.

- If you are using
sht36_v3
, inputN
and press Enter.

- If shown as in the figure, 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