跳到主要内容

Eddy 使用

信息
  • 使用前确保自己的打印机没有漏电
  • 如之前有配置eddy、Probe、BL-Touch的配置,请删除
  • 在安装 Eddy 时,线圈需在喷嘴上方,且距离喷嘴2mm-3mm处
  • 测试时不要打开热床
注意事项
  • 多Z轴机器需要手动调平一次做好
版本要求

Klipper 官方近期对 Eddy 探针功能进行了优化，建议更新至最新版本使用：

  • 普通上位机：请将 Klipper 更新至最新版本
  • FLY Fast 系统：请将系统版本升级至 V1.3.8 或更高版本

接线示意图​

  • 商标朝热床安装
    Loading...

参考配置​

  • XY的偏移值需要根据扫床模块与喷头本身进行计算,然后修改到下方的偏移值。
  • descend_z 的值必须确保探针线圈与喷嘴尖端之间的物理高度差在2~3mm的推荐范围内。
[stepper_z]
endstop_pin: probe:z_virtual_endstop
# position_endstop: -0.5      

[probe_eddy_current fly_eddy_probe]
sensor_type: ldc1612
i2c_address: 43
i2c_mcu: SB2040
i2c_bus: i2c1b
# I2C总线标识，根据MCU定义
x_offset: 0
# X方向探针与喷嘴偏移量（mm），需根据实际安装测量
y_offset: 21.42
# Y方向偏移量（mm），此处为21.42，需根据实际安装测量
descend_z: 2.5
# 探针下降停止距离（mm），即喷嘴与热床之间的安全距离，需根据实际设置
i2c_speed: 4000000
# I2C通信速率（Hz），此处为4MHz
frequency: 40000000
# 外部晶振频率（Hz），SB2040-V3使用40MHZ

[temperature_probe fly_eddy_probe]
sensor_type: Generic 3950
sensor_pin:SB2040:gpio28

线圈模型下载链接​

  • 点击下方按钮下载线圈模型：
Loading...

计算 XY 偏移值​

下载模型后，请根据打印机实际结构测量并计算 XY 偏移值，再修改配置中的 x_offset 与 y_offset。

Loading...

EDDY 校准​

注意事项​

  • 请确认没有同时启用 Probe、BL-Touch 等其他探针配置。
  • 多 Z 轴机器需要先手动调平一次。
  • 校准前检查热床表面无杂物，并保持喷嘴清洁。
安全提示

清洁喷嘴前请等待喷嘴冷却到安全温度；如必须在热机状态清理，只能使用专用工具，严禁用手直接接触喷嘴、热端或热床。

添加临时配置​

须知

下方配置仅用于临时校准，使用后必须删除或注释。

  1. 添加后点击 Save & Restart 保存并重启。
  2. 必须添加到 printer.cfg 文件顶部，请不要添加到文件末尾。
运动风险

下方临时宏会在未完整确认 Z 轴真实位置时移动机器。执行前请移开手和工具，确认喷嘴下方无遮挡，并随时准备使用急停。

[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}

驱动电流校准​

在网页控制台中输入：

_LDC_CALIBRATE_DRIVE_CURRENT

执行后打印机会移动到中心位置，并将打印头远离热床。随后系统会自动进行驱动电流校准，校准完成后保存配置并重启 Klipper。

校准高度​

提示
  • 多 Z 轴机器需要先手动调平一次，再进行高度校准。
  • 多 Z 轴机器完成高度校准后，建议再执行一次调平并重新校准高度。
  • 校准前检查热床表面无杂物，并保持喷嘴清洁。

在网页控制台中输入：

PROBE_EDDY_CURRENT_CALIBRATE_AUTO CHIP=fly_eddy_probe

执行后打印机会移动到中心位置，并弹出校准对话框。此时 Klipper 显示的 Z 高度并不重要，只需要按界面提示逐步降低喷嘴，直到喷嘴与纸张产生轻微摩擦。

完成后点击对话框中的 ACCEPT，系统会开始校准 EDDY 高度。校准完成后，点击网页右上角的 SAVE_CONFIG & Restart 保存配置并重启 Klipper。

常见问题​

Q：温度上升太慢怎么办？

A：检查环境是否密闭、是否存在明显气流。若升温过慢，可提前结束校准。

Q：数据跳动大怎么办？

A：确认纸张测试力度一致，并检查传感器安装是否牢固。

Q：校准后无效怎么办？

A：确认已执行 SAVE_CONFIG 并重启 Klipper。

使用优化​

快速扫床​

下方宏会让调平流程先将喷头抬升到 10mm 进行快速调平，完成后再使用 EDDY 的下探高度进行精细调平。

[gcode_macro Z_TILT_ADJUST]
rename_existing: _Z_TILT_ADJUST
gcode:
    {% set PROBE_Z_OFFSET = printer.configfile.settings['probe_eddy_current fly_eddy_probe'].descend_z|float %}
    SAVE_GCODE_STATE NAME=STATE_Z_TILT
    BED_MESH_CLEAR

    {% if not printer.z_tilt.applied %}
        _Z_TILT_ADJUST horizontal_move_z=10 retry_tolerance=1
    {% endif %}

    _Z_TILT_ADJUST horizontal_move_z={PROBE_Z_OFFSET} retry_tolerance=0.075 retries=20 METHOD=rapid_scan ADAPTIVE=1
    G0 Z10 F6000
    G90
    M117 Z_tilt Completed
    RESTORE_GCODE_STATE NAME=STATE_Z_TILT
    M400

热床​

下方宏会让网床扫描使用快速模式，并在扫描时临时关闭热床，减少热床加热和大功率负载对 EDDY 的影响。扫描完成后会恢复原热床目标温度。

[gcode_macro BED_MESH_CALIBRATE]
rename_existing: _BED_MESH_CALIBRATE
gcode:
    {% set PROBE_Z_OFFSET = printer.configfile.settings['probe_eddy_current fly_eddy_probe'].descend_z|float %}
    {% set TARGET_TEMP = printer.heater_bed.target %}
    M140 S0
    _BED_MESH_CALIBRATE horizontal_move_z={PROBE_Z_OFFSET} METHOD=rapid_scan {rawparams}
    M140 S{TARGET_TEMP}

EDDY 使用 Z 轴偏移功能​

重要通知

EDDY 的 Z 偏移功能此前存在兼容性问题，已在 2025 年 12 月 31 日的 Klipper 更新中修复。

  • 普通上位机：请将 Klipper 更新至较新的稳定版本。
  • FLY 上位机：请将系统版本升级至 V1.3.5 或更高。

完成更新后，请删除之前配置文件中与 Z 偏移 相关的旧设置，否则该功能可能无法正常使用。

Z 偏移说明​

Z 偏移校准前，建议先打印一个较大面积的单层模型，用于观察首层状态。

Mainsail Z 轴偏移校准位置：

Loading...

Fluidd Z 轴偏移校准位置：

Loading...

校准完成后点击保存即可。保存结果只会在控制台中提示，保存后不需要重启 Klipper。

注意事项

Z 偏移校准通常需要重复几次，才能获得更稳定的首层效果。

Loading...