1. TOF10120模块与I2C协议基础
TOF10120是一款基于飞行时间(Time of Flight)原理的激光测距模块，测量范围10cm到180cm，精度可达±1cm。这个模块最吸引人的地方在于它支持两种通信方式：串口和I2C。在实际项目中，I2C接口往往更受欢迎，因为它只需要两根信号线(SCL和SDA)就能实现通信，特别适合引脚资源紧张的STM32单片机。
I2C协议是一种同步、半双工的通信协议，由Philips公司开发。它有两个关键特性：多主从架构和地址寻址机制。在TOF10120的应用中，模块作为从设备，默认地址是0xA4（十进制164）。我遇到过不少初学者对这个地址表示困惑，其实0xA4是7位地址左移一位后的值，真正的设备地址是0x52。
模块的引脚定义很简单：
- 绿线：SCL（时钟线）
- 蓝线：SDA（数据线）
- 白线：TXD（串口发送，I2C模式下不用）
- 黄线：RXD（串口接收，I2C模式下不用）
- 红线：VCC（3.3V-5V）
- 黑线：GND
2. STM32硬件I2C配置实战
2.1 GPIO初始化
在STM32CubeIDE中配置I2C接口时，我强烈建议使用硬件I2C而非软件模拟。以STM32F103C8T6为例，硬件I2C1的SCL和SDA分别对应PB6和PB7引脚。初始化代码如下：
void MX_I2C1_Init(void) { hi2c1.Instance = I2C1; hi2c1.Init.ClockSpeed = 100000; // 100kHz标准模式 hi2c1.Init.DutyCycle = I2C_DUTYCYCLE_2; hi2c1.Init.OwnAddress1 = 0; hi2c1.Init.AddressingMode = I2C_ADDRESSINGMODE_7BIT; hi2c1.Init.DualAddressMode = I2C_DUALADDRESS_DISABLE; hi2c1.Init.OwnAddress2 = 0; hi2c1.Init.GeneralCallMode = I2C_GENERALCALL_DISABLE; hi2c1.Init.NoStretchMode = I2C_NOSTRETCH_DISABLE; if (HAL_I2C_Init(&hi2c1) != HAL_OK) { Error_Handler(); } }2.2 通信稳定性优化
实际调试中发现三个常见问题：
- 上拉电阻不足：I2C总线需要4.7kΩ上拉电阻，很多开发板已经集成
- 时序问题：当总线负载较重时，可以适当降低时钟频率
- 地址错误：TOF10120的地址引脚默认悬空，地址为0xA4，若接地则变为0xA0
遇到通信失败时，建议先用逻辑分析仪抓取波形。我常用的排查步骤是：
- 检查电源电压是否稳定（3.3V-5V）
- 测量SCL/SDA线上是否有正常波形
- 确认地址是否正确（发送0xA4后是否收到ACK）
3. 实时模式与滤波模式深度解析
3.1 寄存器配置差异
TOF10120有两个关键寄存器控制数据输出模式：
- 0x08寄存器：模式选择（0=滤波模式，1=实时模式）
- 0x09寄存器：数据推送方式（0=模块主动推送，1=主机查询）
滤波模式下的数据读取地址是0x04，而实时模式使用0x00。这个细节很容易被忽略，我在第一个项目中就栽过跟头。两种模式的核心区别在于：
| 特性 | 实时模式 | 滤波模式 |
|---|---|---|
| 响应速度 | ＜10ms | 约100ms |
| 数据稳定性 | 波动较大(±3cm) | 非常稳定(±1cm) |
| 适用场景 | 快速避障 | 精确测距 |
3.2 模式切换代码实现
切换模式的完整流程应该是：
- 停止当前测量
- 修改0x08寄存器值
- 等待50ms稳定时间
- 开始新测量
具体代码示例：
void TOF_SetMode(uint8_t mode) // 0=滤波模式，1=实时模式 { uint8_t buf[1]; // 停止测量 buf[0] = 0x02; HAL_I2C_Mem_Write(&hi2c1, TOF_ADDR, 0x03, 1, buf, 1, 100); // 设置模式 buf[0] = mode; HAL_I2C_Mem_Write(&hi2c1, TOF_ADDR, 0x08, 1, buf, 1, 100); // 等待稳定 HAL_Delay(50); // 开始测量 buf[0] = 0x01; HAL_I2C_Mem_Write(&hi2c1, TOF_ADDR, 0x03, 1, buf, 1, 100); }4. 实际应用场景与优化建议
4.1 机器人避障系统
在自动导引车(AGV)项目中，我采用双模式混合策略：
- 默认使用滤波模式获取稳定距离
- 当检测到快速接近的物体（距离变化率＞20cm/s）时
- 自动切换到实时模式，采样率从10Hz提升到100Hz
- 危险解除后切回滤波模式
这种动态切换的方式既保证了测量精度，又能在紧急情况下快速响应。关键代码如下：
float distance_rate = (current_dist - last_dist) / delta_time; if(distance_rate > 20.0f) // 快速接近 { TOF_SetMode(1); // 实时模式 sampling_rate = 100; // 100Hz } else { TOF_SetMode(0); // 滤波模式 sampling_rate = 10; // 10Hz }4.2 工业测距应用
在板材厚度测量项目中，发现三个优化点：
- 安装角度补偿：当模块非垂直安装时，需用cosθ修正测量值
- 温度补偿：每10℃变化会导致约0.5mm的误差
- 表面材质校准：不同反射率的材料需要不同的补偿系数
建议的校准流程：
- 在标准距离（如100cm）处测量
- 记录10组数据计算平均值
- 比较实际距离与测量距离
- 在代码中加入补偿系数：
float calibrated_distance = raw_distance * calib_factor + offset;最后提醒一点：TOF10120的测量结果是以毫米为单位的16位无符号整数，但实际有效范围是100-1800mm（10-180cm）。超出这个范围的数据虽然能读取，但精度无法保证。在代码中最好加入范围检查：
if(distance < 100 || distance > 1800) { return INVALID_DISTANCE; // 定义错误码 }
