본문으로 건너뛰기

FLY-EDDY 参考配置

以下配置参考 SHT36V3 工具板的 EDDY 配置写法，仅将 I2C 地址改为 FLY-EDDY 的 0x42（42）。i2c_mcu、i2c_bus 以及 x_offset、y_offset、descend_z 需按实际连接的 MCU 与安装位置修改。

参考配置​

[probe_eddy_current] 支持硬件 I2C 与软件 I2C 两种连接方式，二选一即可。MCU 有可用硬件 I2C 总线时优先使用硬件 I2C：

[stepper_z]
endstop_pin: probe:z_virtual_endstop
# position_endstop: -0.5

[probe_eddy_current fly_eddy_probe]
sensor_type: ldc1612
i2c_address: 42
# FLY-EDDY 的 I2C 地址为 0x42（42）
i2c_mcu: SHT36
# 连接 EDDY 的 MCU 名称，根据实际定义
i2c_bus: i2c1e
# 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），FLY-EDDY 使用 40MHz 晶振

[temperature_probe fly_eddy_probe]
sensor_type: Generic 3950
sensor_pin: SHT36:gpio28
# 温度传感器引脚，按实际连接的 MCU 修改

配置说明​

  • i2c_address: 42 为 FLY-EDDY 的固定 I2C 地址（0x42），无需修改
  • frequency: 40000000 必须与 EDDY 板载晶振一致，FLY-EDDY 使用 40MHz 晶振，请勿填写其他值
  • i2c_mcu、i2c_bus 需与连接 EDDY 的 MCU 定义一致；没有可用硬件 I2C 时，可使用软件 I2C（i2c_software_scl_pin / i2c_software_sda_pin），详见上方两个标签页的完整示例
  • i2c_speed 通信不稳定时可降低（如 400000）
  • XY 偏移值需根据扫床模块与喷头本身的安装位置计算后修改
  • descend_z 的值必须确保探针线圈与喷嘴尖端之间的物理高度差在 2~3mm 的推荐范围内
  • [temperature_probe] 段的 sensor_pin 对应线束中的 TEMP 线（板载热敏电阻，Generic 3950）；EDDY-F 接 SHT36 V3 / SB2040 V3 / SB2040 PRO V3 时对应工具板 gpio28，EDDY-M 接普通工具板或主板时按实际 ADC 引脚修改；不接 TEMP 时温漂补偿不可用
推荐 TAP 模式

FLY-EDDY 推荐使用 TAP 触发模式，每次打印可通过 SET_Z_FROM_PROBE METHOD=tap 自动确认 Z 偏移。启用 TAP 需在 [probe_eddy_current fly_eddy_probe] 中增加 tap_z_offset: 0（tap_threshold 由自动校准写入，使用前先注释掉），完整流程见下方 TAP 文档。

优化动作宏​

配置与校准完成后，可按需添加以下优化宏，提升扫床与打印体验：

使用优化​

快速扫床​

下方宏会让调平流程先将喷头抬升到 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 偏移校准通常需要重复几次，才能获得更稳定的首层效果。

校准教程：FLY-EDDY 校准

EDDY 问题排查：EDDY 传感器常见问题

TAP 模式：EDDY TAP 模式调试

Loading...