STM32F103C8T6 + GY-906红外测温：手把手教你用CubeMX和HAL库搞定IIC驱动（附完整工程）
STM32F103C8T6与GY-906红外测温实战：从CubeMX配置到数据采集全流程解析
红外测温技术在工业检测、医疗设备和智能家居等领域有着广泛应用。GY-906（基于MLX90614芯片）作为一款高精度非接触式红外温度传感器，以其小体积、低功耗和SMBus兼容I2C接口等特点，成为嵌入式开发的理想选择。本文将手把手带你完成STM32F103C8T6与GY-906的完整开发流程，从硬件连接到软件实现，解决实际开发中的常见问题。
1. 硬件准备与CubeMX工程创建
在开始编码前，我们需要确保硬件连接正确并搭建好开发环境。GY-906模块通常有四个引脚：VCC（3.3V）、GND、SCL和SDA。与STM32F103C8T6的连接方式如下：
| GY-906引脚 | STM32F103C8T6引脚 | 备注 |
|---|---|---|
| VCC | 3.3V | 电源正极 |
| GND | GND | 电源地 |
| SCL | PB6 | I2C1时钟线 |
| SDA | PB7 | I2C1数据线 |
使用STM32CubeMX创建工程的基本步骤：
- 打开CubeMX，选择"New Project"
- 在芯片选择框中输入"STM32F103C8T6"并确认
- 配置系统时钟（通常选择外部晶振作为时钟源）
- 在"Pinout & Configuration"标签页中激活I2C1外设
- 将PB6和PB7自动配置为I2C1的SCL和SDA
- 设置I2C参数（标准模式，100kHz时钟）
- 生成代码前，确保在"Project Manager"中选择了合适的IDE（如MDK-ARM）
提示：初次使用CubeMX时，建议保持默认的中断优先级设置。对于I2C通信，CubeMX会自动配置必要的GPIO和时钟，大幅减少底层配置工作量。
2. HAL库与第三方驱动的整合技巧
GY-906传感器使用SMBus协议（I2C的子集），网上常见的驱动文件通常基于标准库编写。我们需要将这些驱动适配到HAL库环境中。主要修改点包括：
- 替换GPIO操作函数：将标准库的
GPIO_SetBits/GPIO_ResetBits改为HAL库的HAL_GPIO_WritePin - 修改延时函数：标准库的
delay_us需要替换为HAL库的HAL_Delay或自定义精确延时 - 调整包含路径：确保驱动文件能找到HAL库的头文件
关键驱动文件MLX90614.h的修改示例：
// 原标准库定义 // #define MLX90614_IIC_PORT GPIOB // #define MLX90614_IIC_PIN_SCL GPIO_PIN_6 // #define MLX90614_IIC_PIN_SDA GPIO_PIN_7 // 修改为HAL库兼容定义 #define MLX90614_IIC_PORT GPIOB #define MLX90614_IIC_PIN_SCL GPIO_PIN_6 #define MLX90614_IIC_PIN_SDA GPIO_PIN_7 #define MLX90614_SCL(x) HAL_GPIO_WritePin(MLX90614_IIC_PORT, MLX90614_IIC_PIN_SCL, (x)?GPIO_PIN_SET:GPIO_PIN_RESET) #define MLX90614_SDA(x) HAL_GPIO_WritePin(MLX90614_IIC_PORT, MLX90614_IIC_PIN_SDA, (x)?GPIO_PIN_SET:GPIO_PIN_RESET) #define MLX90614_READ_SDA HAL_GPIO_ReadPin(MLX90614_IIC_PORT, MLX90614_IIC_PIN_SDA)常见编译错误及解决方案：
- 未定义标识符错误：检查所有标准库特有的函数是否已替换为HAL库等效函数
- 头文件包含问题：在工程属性中添加HAL库的头文件路径
- 链接错误：确保在CubeMX中生成代码时选择了正确的IDE和工具链
3. 传感器初始化与温度读取实现
GY-906传感器的初始化流程相对简单，但需要注意几个关键点：
- 硬件I2C与软件模拟I2C的选择：虽然HAL库提供了硬件I2C支持，但许多开源驱动使用GPIO模拟时序
- 上电延时：传感器需要约2ms的上电稳定时间
- 模式切换：某些GY-906模块默认处于PWM模式，需切换到SMBus模式
温度读取的核心函数实现：
float MLX90614_ReadTemp(uint8_t reg) { uint16_t tempData = mlx90614_read_ram(MLX90614_DEFAULT_ADDR, reg); float temp = (float)tempData * 0.02 - 273.15; // 转换为摄氏度 return temp; }在实际应用中，我们可以读取三种温度值：
- 物体温度1（OBJ1）：默认的测量目标温度
- 物体温度2（OBJ2）：部分型号支持的第二个测量区域
- 环境温度（TA）：传感器自身温度
注意：GY-906的测量精度受环境温度影响。为提高准确性，建议定期读取环境温度并补偿，特别是在环境温度变化较大的场景中。
4. 数据验证与误差处理
红外测温的准确性受多种因素影响，包括测量距离、被测物体表面特性以及环境条件。为提高系统可靠性，应实现以下验证机制：
- PEC校验：MLX90614使用CRC-8校验（称为PEC），确保数据传输正确
- 数据合理性检查：温度值应在传感器量程范围内（-70~380℃）
- 多次采样取平均：减少随机误差的影响
PEC校验函数示例：
uint8_t MLX90614_CheckPEC(uint8_t *data, uint8_t len) { uint8_t crc = 0x07; // CRC-8多项式初始值 for(uint8_t i=0; i<len; i++) { crc ^= data[i]; for(uint8_t j=0; j<8; j++) { if(crc & 0x80) { crc = (crc << 1) ^ 0x07; } else { crc <<= 1; } } } return crc; }常见问题排查指南：
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 读取温度固定为0或异常 | I2C通信失败 | 检查接线，确认上拉电阻 |
| 温度值波动大 | 测量距离过远或目标太小 | 调整测量距离，确保目标充满视场 |
| 偶尔读取失败 | 电源噪声或时序问题 | 增加电源滤波电容，调整I2C速率 |
5. 性能优化与高级功能实现
在基本功能实现后，我们可以进一步优化系统性能和扩展功能：
低功耗设计：
- 利用GY-906的睡眠模式（电流可降至0.5μA）
- 调整STM32的工作模式，在两次测量间进入低功耗状态
void MLX90614_Sleep(void) { mlx90614_iic_start(); mlx90614_iic_write_byte(MLX90614_DEFAULT_ADDR << 1); mlx90614_iic_write_byte(SLEEP); mlx90614_iic_stop(); }多传感器组网：
- 通过修改传感器地址（0x00~0x7F），实现单I2C总线连接多个GY-906
- 注意I2C总线的负载能力，适当降低通信速率
温度补偿算法：
- 建立误差模型，根据环境温度补偿测量值
- 针对特定材料设置发射率校正（GY-906默认发射率为0.95）
实际项目中，将温度数据通过串口输出的完整示例：
while (1) { float objectTemp = MLX90614_ReadTemp(MLX90614_OBJ1_TEMP); float ambientTemp = MLX90614_ReadTemp(MLX90614_TA_TEMP); printf("物体温度: %.2f℃, 环境温度: %.2f℃\r\n", objectTemp, ambientTemp); HAL_Delay(1000); // 每秒更新一次 }通过USB转串口工具，这些数据可以在PC端显示或记录，为后续分析和处理提供便利。对于更复杂的应用，可以考虑添加无线传输模块或将数据上传到云平台。