跳到主要内容

EDDY 传感器常见问题解决指南

EDDY 传感器常见问题

归位时报错 Error during homing z: Eddy current sensor error​

遇到此错误时，请按顺序排查。

更新 Klipper 或系统​

重要通知

EDDY 的 Z 归位功能此前存在兼容性问题，已在 2026 年 1 月 6 日的 Klipper 更新中优化。

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

完成更新后，需要重新校准 EDDY。

调整驱动电流​

  1. 打开 printer.cfg 文件。
  2. 找到配置最下方的 reg_drive_current = 参数。
  3. 将当前值增加或减少 1，例如 15 可改为 16 或 14。
  4. 请直接填写计算后的结果，不要填写 15+1 这类算式。
  5. 保存文件并重启打印机，然后重新测试归位。
Loading...

调整探头偏移量​

如果更新和驱动电流调整后仍然无效，可继续检查 z_offset。

  1. 在 printer.cfg 中找到 [probe_eddy_current fly_eddy_probe] 配置段。
  2. 将 z_offset: 适当改大。默认值通常为 1.0，可先尝试 2.0 或 2.5。
  3. 此参数只能在该配置段中保留一处，请勿重复配置。
  4. 建议值不要超过 3.0，最终数值需要根据机器结构和探头安装高度确定。
  5. 保存并重启打印机，然后再次测试归位。
Loading...

提示 !! probe_eddy_current sensor not in valid range​

此错误表示探头读数超出有效范围。常见原因是启用 EDDY 探头后，其他配置段中的探测高度没有按预期生效，导致探头移动超出物理量程。

请重点检查以下位置：

  • [probe_eddy_current fly_eddy_probe]
  • [bed_mesh]
  • [z_tilt] 或 [quad_gantry_level]
  • 自定义归位、调平、扫床宏

处理方式：

  1. 确认所有探测动作的下探高度都在 EDDY 可用范围内。
  2. 避免多个宏或配置段重复覆盖同一个高度参数。
  3. 修改后保存并重启 Klipper，再重新执行归位或调平。
Loading...

提示 Eddy I2C STATUS/DATA error 或 Invalid read data​

此类错误表示 EDDY 与 MCU 之间的通信或读数异常。

常见原因：

  • EDDY 线束、插头或焊点接触不良。
  • I2C 线过长、线材质量差，或与电机线、加热线并行走线导致干扰。
  • I2C 速率过高，当前线材和环境下不稳定。
  • 探头供电不稳定。

处理方式：

断电操作

重新插拔 EDDY 线束、整理走线或检查插头前，请完全关闭打印机并断开电源供应。不要在通电状态下拔插传感器或触碰端子。

  1. 断电后重新插拔 EDDY 线束，检查端子是否松动。
  2. 将 EDDY 通信线远离电机线、加热线和热床线。
  3. 如果使用硬件 I2C，可尝试降低 I2C 速率；仍不稳定时再测试软件 I2C。
  4. 优先通过更换成品线束、换端口或替换传感器进行交叉测试；裸露端子的电气检测请联系售后或专业人员。
  5. 修改后重新执行归位或 PROBE_EDDY_CURRENT_CALIBRATE。

提示 Unable to obtain probe_eddy_current sensor readings​

此错误表示 Klipper 在规定时间内没有获取到有效的 EDDY 传感器数据。

常见原因：

  • 传感器通信线断开或配置的总线/引脚错误。
  • 探头离金属床面过远，读数不在可用范围。
  • reg_drive_current 不合适，传感器频率范围不足。
  • 尚未完成驱动电流校准或 Z 高度校准。

处理方式：

断电操作

检查 EDDY 总线、引脚接线或更换传感器线束前，请完全关闭打印机并断开电源供应。不要在通电状态下拔插传感器。

  1. 断电后确认 [probe_eddy_current fly_eddy_probe] 中的总线和引脚配置与实际接线一致。
  2. 将喷头移动到热床中心，确保 EDDY 位于金属床面上方。
  3. 重新执行 LDC_CALIBRATE_DRIVE_CURRENT CHIP=fly_eddy_probe 并 SAVE_CONFIG。
  4. 重新执行 PROBE_EDDY_CURRENT_CALIBRATE CHIP=fly_eddy_probe。
  5. 如果只在归位时出现，继续按本文上方“归位时报错”章节调整 reg_drive_current 和 z_offset。

TAP 模式触发异常​

使用 EDDY 的 METHOD=tap 时，如果探测提前停止、接触床面后仍不停止，或结果明显不稳定，通常与 tap_threshold 和喷嘴/床面状态有关。

详细流程：EDDY TAP 模式调试方法

运动风险

TAP 测试会让喷嘴接近或接触热床。执行前请确认喷嘴和床面干净，手和工具远离运动区域，并准备好急停。

排查要点：

  1. 确认喷嘴和床面干净，喷嘴残料会直接影响 TAP 结果。
  2. 开始 TAP 前，喷嘴距离床面建议保持在几毫米范围内，不要过近或过远。
  3. 如果未接触床面就停止，说明 tap_threshold 可能过低，可适当增大。
  4. 如果接触床面后仍不停止，说明 tap_threshold 可能过高，应立即停止并降低阈值。
  5. 调整后重新执行 PROBE_EDDY_CURRENT_TAP_CALIBRATE，通过后再 SAVE_CONFIG。

温漂导致首层不稳定​

EDDY 属于电涡流传感器，床温、喷嘴温度、传感器线圈温度和附近金属件温度变化都会影响测量结果。表现通常是：冷机校准正常，热机打印首层偏高或偏低。

处理方式：

  1. 尽量在接近实际打印温度时执行 EDDY 校准。
  2. 打印前等待热床和喷嘴温度稳定后再归位、调平或扫床。
  3. 如果 EDDY 带温度传感器，可配置 [temperature_probe] 并进行温漂补偿。
  4. 封箱机器建议在箱温稳定后再执行精细校准。

z_offset 调试建议​

在大量调试案例中，将 [probe_eddy_current fly_eddy_probe] 中的 z_offset 初始值设为 2.5，通常能更快让许多 EDDY 传感器进入可工作状态。

注意

2.5 只是调试起点，不是通用固定值，也不是官方默认配置。最佳偏移量取决于探头安装位置、喷嘴高度和机器结构，请以实际校准结果为准。

Loading...