EDDY I2C 引脚与配置说明

本文说明 FLY-EDDY 系列（EDDY-M / EDDY-F）传感器的 I2C 引脚定义、两种连接方式的引脚对照与接线步骤，以及 probe_eddy_current 所需的 I2C 相关配置项。

I2C 引脚定义

FLY-EDDY 基于 TI LDC1612 芯片，通过 I2C 接口通信。5P 线束中包含 4 根 I2C 信号线和 1 根温度检测线（TEMP，板载热敏电阻输出，用于 [temperature_probe] 温漂补偿）：

引脚	定义	说明
VCC	电源正极	5V 供电，具体以产品标注为准
GND	电源地	与 MCU 共地
SDA	I2C 数据线	开漏输出，连接 MCU 的 I2C SDA 引脚
SCL	I2C 时钟线	开漏输出，连接 MCU 的 I2C SCL 引脚
TEMP	温度检测	板载热敏电阻输出，连接 MCU 的 ADC 引脚，用于 `[temperature_probe]` 温漂补偿（可选）

LDC1612 的 I2C 地址由芯片 ADDR 引脚电平决定，FLY-EDDY 出厂固定为 0x42（42），Klipper 配置中写十进制 i2c_address: 42。

两种连接方式

EDDY-M 与 EDDY-F 的信号定义完全一致，仅物理连接方式与适配平台不同（MX1.25 端子 / FPC 排线）：

EDDY-F（FPC 排线）：专门适配 SHT36 V3、SB2040 V3、SB2040 PRO V3 工具板的 EDDY 接口，TEMP 线自动接入工具板温度检测引脚（均为 gpio28）
EDDY-M（MX1.25 端子）：适配普通工具板或主板，需按实际板卡定义接线并配置 I2C（详见下方接线与配置章节）

信号	EDDY-M（MX1.25 端子）	EDDY-F（FPC 排线）
电源正极	VCC	VCC
电源地	GND	GND
数据线	SDA	SDA
时钟线	SCL	SCL
温度检测	TEMP	TEMP

EDDY-M 的 MX1.25 端子线序（从左到右）为：SDA、TEMP、SCL、5V、GND。EDDY-F 的 FPC 排线仅适配 FLY 工具板（SHT36 V3 / SB2040 V3 / SB2040 PRO V3）的 EDDY 接口，插入即可，无需核对线序。

EDDY-M：MX1.25 端子接线

断电操作

开始接线或插拔线束前，请完全关闭打印机并断开电源供应。不要在通电状态下插拔线束、整理接口线序或触碰端子。

将 MX1.25 排线（单头 5P，30cm）插入 EDDY-M 端子座，按端子线序（从左到右：SDA、TEMP、SCL、5V、GND）一一对应
线束另一端接入普通工具板或主板的 I2C 接口，按接口丝印核对引脚顺序
TEMP 线接入主板空闲的 ADC 引脚；没有可用 ADC 引脚时可不接，但温漂补偿功能不可用
插紧端子后轻拉线束确认不会脱落

I2C 配置说明

EDDY-M 接普通工具板或主板时，i2c_mcu、i2c_bus 需按实际主板的 MCU 定义填写；使用软件 I2C 时需指定 i2c_software_scl_pin / i2c_software_sda_pin。I2C 地址固定为 0x42（42），晶振频率 40MHz，配置项说明见下文。

EDDY-F：FPC 排线接线

断电操作

开始接线或插拔排线前，请完全关闭打印机并断开电源供应。不要在通电状态下插拔排线、整理接口线序或触碰端子。

将 FPC 排线（5P、0.5mm 间距、同向）插入 EDDY-F 连接器：打开锁扣，将排线金手指按正确方向插入，压平后扣上锁扣固定
排线另一端接入 SHT36 V3 / SB2040 V3 / SB2040 PRO V3 工具板的 EDDY 接口；FPC 与工具板接口一一对应，插入即可，无需核对线序
TEMP 线自动接入工具板 EDDY 接口的温度检测引脚（均为 gpio28），无需额外接线
确认排线无弯折、无外露铜箔

接线注意事项

SDA / SCL 信号线不要串接或并联电容、电感、二极管等元件，也不要经过 RC / LC 滤波电路或外接电平转换模块；I2C 为开漏信号，额外电容会拖慢信号上升沿，导致通信失败或报错
EDDY 通信线应远离电机线、加热线和热床线，避免 I2C 信号受干扰
I2C 线不宜过长，线材质量差或走线过长可能导致通信不稳定
优先使用成品线束；裸露端子或排线的电气检测请联系售后或专业人员

I2C 相关配置项

[probe_eddy_current] 中与 I2C 通信相关的配置项如下：

配置项	说明	FLY-EDDY 取值
`sensor_type`	传感器芯片型号，固定为 `ldc1612`	`ldc1612`
`i2c_address`	I2C 设备地址（十进制）	`42`（`0x42`）
`i2c_mcu`	连接传感器的 MCU 名称	按实际连接定义
`i2c_bus`	MCU 上的硬件 I2C 总线	按 MCU 定义
`i2c_speed`	I2C 通信速率（Hz）	默认 `100000`，可先按 `400000` 测试
`i2c_software_scl_pin` / `i2c_software_sda_pin`	软件 I2C 的 SCL / SDA 引脚	使用硬件 I2C 时无需配置
`frequency`	LDC1612 外部晶振频率（Hz）	`40000000`（40MHz）

配置示例

[probe_eddy_current] 支持硬件 I2C 与软件 I2C 两种方式，二选一即可，不要同时配置 i2c_bus 与 i2c_software_scl_pin / i2c_software_sda_pin。

硬件 I2C（推荐）
软件 I2C

MCU 有可用硬件 I2C 总线时，优先使用硬件 I2C，通信更稳定：

[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 定义
i2c_speed: 400000
# I2C 通信速率（Hz），通信不稳定时可降低
frequency: 40000000
# 外部晶振频率（Hz），FLY-EDDY 为 40MHz
x_offset: 0
y_offset: 21.42
descend_z: 2.5

MCU 没有可用硬件 I2C 总线，或硬件 I2C 通信不稳定时，可使用软件 I2C，指定两个空闲 GPIO 作为 SCL / SDA：

[probe_eddy_current fly_eddy_probe]
sensor_type: ldc1612
i2c_address: 42
# FLY-EDDY 的 I2C 地址为 0x42（42）
i2c_mcu: SHT36
# 连接 EDDY 的 MCU 名称，按实际定义
i2c_software_scl_pin: SHT36:gpioXX
# 软件 I2C 的 SCL 引脚，gpioXX 为示例占位，需按实际连接 EDDY 的空闲 GPIO 填写
i2c_software_sda_pin: SHT36:gpioXX
# 软件 I2C 的 SDA 引脚，gpioXX 为示例占位，需按实际连接 EDDY 的空闲 GPIO 填写
i2c_speed: 400000
# I2C 通信速率（Hz），软件 I2C 速率不宜过高，通信不稳定时可降低
frequency: 40000000
# 外部晶振频率（Hz），FLY-EDDY 为 40MHz
x_offset: 0
y_offset: 21.42
descend_z: 2.5

使用说明

硬件 I2C 与软件 I2C 二选一：使用硬件 I2C 配置 i2c_mcu + i2c_bus；使用软件 I2C 配置 i2c_software_scl_pin + i2c_software_sda_pin，不要再写 i2c_bus，也不要同时配置两种方式
软件 I2C 的引脚不能与其他功能（如温度传感器、风扇、限位等）重复占用，选择 MCU 上空闲的 GPIO
出现 BUS_TIMEOUT、Invalid read data、Eddy: CLKIN frequency too low 等 I2C 报错时，先断电检查接线，再将 i2c_speed 降低测试
frequency 必须与 EDDY 板载晶振一致，FLY-EDDY 为 40MHz；填错会导致读数异常
同一 I2C 总线上多个设备时，需确认设备地址不冲突

I2C 引脚定义​

两种连接方式​

EDDY-M：MX1.25 端子接线​

EDDY-F：FPC 排线接线​

接线注意事项​

I2C 相关配置项​

配置示例​

相关文档​