STM32驱动MLX90614红外测温：SMBus时序、PEC校验与发射率修正实战

简介：一款面向毕业设计与课程实训的STM32红外测温项目源码，聚焦MLX90614非接触测温模块的驱动开发与软硬件联调，适合电子、通信、自动化等专业学生及嵌入式入门开发者使用。代码按HARDWARE、SYSTEM、CORE、USER等目录分层，包含完整工程文件与硬件驱动，质量经过实测，可作为课程设计、大作业或毕设的参考基础，方便二次修改拓展功能。

压缩包总计76个文件，以C源码与头文件为主（33个h、32个c），另有Keil工程配置、启动文件、链接映射及说明文档，整体大小仅395KB，轻量完整，便于直接导入MDK工程编译运行。工程集成STM32标准外设库，主控逻辑集中在main.c与mlx90614驱动模块，配合串口调试和延时模块，可快速验证红外测温流程。

资源已有155人学习，对于希望掌握STM32驱动I2C型传感器、理解测温数据解析与嵌入式项目结构的读者，具备较好的参考价值与复用性。

1. STM32 驱动 MLX90614 红外测温模块：毕业设计里的一道分水岭

“STM32 驱动 MLX90614 红外测温模块”这串词在毕业设计题目里出现得越来越规律，几乎成了非接触测温方向的默认组合。MLX90614 把热电堆、信号调理、ADC 和数字信号处理全部封进一个 TO-39 金属壳，对外只剩一根 SMBus 总线，STM32 要做的只是按协议把温度读回来，但恰恰是这条“只有两根线”的协议，挡住了大部分第一次做的人。做这个项目的价值在于：把 SMBus 时序、寄存器映射、PEC 校验、发射率修正、软件滤波和硬件排错完整走一遍，比单纯调通一个模块更有说服力，也更能通过答辩追问。这篇博文直接给一套可落地的实现路径，从芯片协议入手，到最小驱动代码，再到标定滤波与验收排错，适合准备毕业设计的学生，也适合想快速评估红外测温方案的工程师。

2. MLX90614 的 SMBus 协议与寄存器映射：先把芯片的“脾气”摸清

2.1 为什么说“I2C 能读”不等于“SMBus 能跑稳”

MLX90614 官方接口是 SMBus，兼容 I2C，但两者在容错机制上差别明显。SMBus 规定了时钟低电平超时、从机地址 NACK 后的释放逻辑、PEC 包错误校验，而普通 I2C 主机遇到 NACK 后的常见行为是重发或直接超时退出，这会把从机状态机搞乱。STM32 的硬件 I2C 外设在 HAL 库里对 NACK 的处理策略偏保守，超时返回 busy 后总线上的 START/STOP 条件不一定干净，SR1 里的 AF 标志还容易残留，下一次通信就卡死。早期很多教学例程宁可牺牲一点速率也要用软件模拟 I2C，原因就在这里。

我一般会这样处理：如果坚持用硬件 I2C，必须在每次通信失败后做总线恢复，把 SCL 引脚临时切成 GPIO 模式翻转 9 个时钟，再切回外设模式；但这对毕业设计来说属于额外风险。MLX90614 的采样率通常只有 10Hz 到 20Hz，模拟 I2C 跑 100kHz 完全够用，代码量也就二十行左右，可控性反而更高。另外，不管用标准库还是 HAL 库，这个项目的难点都不在库本身，而在“通信失败之后你的状态机能不能回到初始态”，这也是答辩老师最常追问的细节。

2.2 RAM 区与 EEPROM 区的寄存器地址表

MLX90614 的寄存器分两块：RAM 区存放实时测量结果，EEPROM 区存放出厂校准和用户配置。RAM 区的典型偏移地址如下表：

读 RAM 和读 EEPROM 的 SMBus 时序基本一致，差别在于偏移地址不同。唯一要小心的是 EEPROM 写入：硬件上必须先执行解锁命令，写完某个字节后还要留出擦写时间，否则数据写不进去。很多人的温度读数异常，其实是把 RAM 里 0x06 和 EEPROM 里 0x0F 的地址搞混，对着 0x0F 读目标温度，自然得到一堆随机值。

2.3 电源、上拉电阻与地线：四根线能点亮，精度却藏在布局里

驱动 MLX90614 的接线非常少：VDD、GND、SCL、SDA。但“能点亮”和“读数稳定”是两回事。VDD 与 VSS 之间要放 100nF 陶瓷电容和 10uF 电解电容，电容尽量贴着芯片引脚放；SCL 和 SDA 各接一个 4.7kΩ 上拉电阻到 3.3V。MLX90614 的 IO 电平以 VDD 为基准，所以 VDD 一定要接 3.3V，不要随手挂在 5V 排针上。

更隐蔽的问题是地线。热电堆输出信号在微伏级，内部 PGA 增益很高，开关电源纹波或电机回灌噪声会直接耦合进 ADC 窗口，表现为温度读数周期性跳变。我见过最典型的案例是传感器和舵机共用一个电源，舵机一动，TObj 就跳 0.5℃。处理办法是给传感器单独一个 LDO，并且让 GND 从电源地星形连接，不要在主回路里串接。

3. STM32 驱动 MLX90614 的最小代码：模拟 I2C 加 PEC 校验的完整实现

3.1 标准库下的 GPIO 模拟 I2C 框架

先定框架：用 STM32F103 标准库，PB6 做 SCL，PB7 做 SDA，两个引脚都配置为开漏输出，外部已经接好 4.7kΩ 上拉。开漏模式配合上拉电阻，才能实现真正的线与逻辑，这是模拟 I2C 能跑稳的前提之一。

/* 引脚与电平宏 */ #define MLX90614_ADDR_W 0xB4 /* 0x5A << 1，写地址 */ #define MLX90614_ADDR_R 0xB5 /* 0x5A << 1 | 0x01，读地址 */ #define MLX90614_USE_PEC 1 /* 1 开启 PEC 校验 */ #define SCL_H() GPIOB->BSRR = GPIO_Pin_6 #define SCL_L() GPIOB->BRR = GPIO_Pin_6 #define SDA_H() GPIOB->BSRR = GPIO_Pin_7 #define SDA_L() GPIOB->BRR = GPIO_Pin_7 #define SDA_READ() ((GPIOB->IDR & GPIO_Pin_7) != 0) void MLX_GPIO_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); GPIO_InitStructure.GPIO_Pin = GPIO_Pin_6 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_OD; /* 开漏 */ GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOB, &GPIO_InitStructure); SCL_H(); SDA_H(); }

这套 GPIO 宏直接在寄存器上操作，比反复调用库函数更快也更可控。开漏模式是必须的，如果配置成推挽输出，SDA 被从机拉低时主机再输出高电平，就可能形成短路过流，轻则通信异常，重则烧引脚。初始化最后把 SCL 和 SDA 都拉高，让总线处于空闲状态。

3.2 读 RAM 区数据的核心函数与 SMBus 时序

读一个 16 位寄存器值的完整 SMBus 时序是：Start，发送写地址 0xB4 并等待 ACK，发送寄存器偏移地址，再次发送 Start（重复起始），发送读地址 0xB5，依次读低字节、高字节，最后主机回 NACK 表示结束，然后 Stop。如果开启 PEC，还要在读完两个数据字节之后再读一个 CRC 字节。

/* 返回 0 成功；1 总线忙；2 NACK；3 PEC 校验失败 */ uint8_t MLX90614_ReadWord(uint8_t reg, uint16_t *value) { uint8_t buf[3]; /* 低字节、高字节、PEC */ uint8_t crc_data[5]; /* PEC 覆盖的原始字节序列 */ uint8_t crc; if (I2C_Start() == 0) return 1; /* SDA 被拉低，说明总线被占用 */ if (I2C_SendByte(MLX90614_ADDR_W) != 0) { I2C_Stop(); return 2; } if (I2C_SendByte(reg) != 0) { I2C_Stop(); return 2; } I2C_Start(); /* 重复起始条件 */ if (I2C_SendByte(MLX90614_ADDR_R) != 0) { I2C_Stop(); return 2; } buf[0] = I2C_ReadByte(1); /* 主机回 ACK */ buf[1] = I2C_ReadByte(1); /* 主机回 ACK */ #if MLX90614_USE_PEC crc_data[0] = MLX90614_ADDR_W; crc_data[1] = reg; crc_data[2] = MLX90614_ADDR_R; crc_data[3] = buf[0]; crc_data[4] = buf[1]; crc = MLX_PEC(crc_data, 5); buf[2] = I2C_ReadByte(0); /* 最后一个字节，主机回 NACK */ I2C_Stop(); if (buf[2] != crc) return 3; #else buf[2] = I2C_ReadByte(0); I2C_Stop(); #endif *value = (uint16_t)((buf[1] << 8) | buf[0]); return 0; }

这里最关键的是重复起始条件：读操作时，写入寄存器和读取数据之间必须有一个新的 Start，不能直接跟读地址。很多移植失败案例都是把 I2C_Start 写成了普通 Stop 加 Start，从机状态机直接错乱。I2C_SendByte 的返回值按 ACK 判断，收到 ACK 返回 0，收到 NACK 返回 1；I2C_ReadByte 参数为 1 表示主机回 ACK，为 0 表示回 NACK，这两个方向不要记反。

3.3 PEC 的 CRC-8 实现：多一个字节换一次容错

PEC 全称 Packet Error Checking，本质是一个 CRC-8 校验，多项式是 x8+x2+x+1，对应十六进制 0x07，初始值为 0x00。它覆盖的字节序列依次是：写地址、寄存器偏移、读地址、数据低字节、数据高字节。计算时从起始条件之后开始，不包含 STOP 和重复起始条件本身。

uint8_t MLX_PEC(uint8_t *data, uint8_t len) { uint8_t crc = 0x00; uint8_t i, j; for (i = 0; i < len; i++) { crc ^= data[i]; for (j = 0; j < 8; j++) { if (crc & 0x80) crc = (uint8_t)((crc << 1) ^ 0x07); else crc = (uint8_t)(crc << 1); } } return crc; }

PEC 的作用是拦截总线噪声导致的数据错位，尤其适用于传感器和主控之间有较长杜邦线的场景。但要注意：PEC 只防数据被干扰，不防地址本身写错。如果从机地址压根不对，从机不会应答，主机读到的 PEC 字节和计算值同样对不上，但报错位置会在 NACK 而不是 PEC。排错时先看是哪个环节返回错误码，再决定是查地址还是查 PEC。

3.4 写 EEPROM：解锁、改发射率、等待擦除完成

写 EEPROM 比读 RAM 多一个解锁步骤。MLX90614 的 EEPROM 在写入前必须先执行解锁操作，常见做法是发送解锁命令字节 0x66，随后按写字节时序发送目标偏移地址和要写入的数据。整个过程中需要给擦写留足时间，建议每次写操作后至少延时 10ms。

uint8_t MLX90614_WriteEEPROM(uint8_t addr, uint8_t data) { /* 解锁 */ I2C_Start(); if (I2C_SendByte(MLX90614_ADDR_W) != 0) { I2C_Stop(); return 1; } if (I2C_SendByte(0x66) != 0) { I2C_Stop(); return 1; } I2C_Stop(); delay_ms(10); /* 写入目标字节 */ I2C_Start(); if (I2C_SendByte(MLX90614_ADDR_W) != 0) { I2C_Stop(); return 1; } if (I2C_SendByte(addr) != 0) { I2C_Stop(); return 1; } if (I2C_SendByte(data) != 0) { I2C_Stop(); return 1; } I2C_Stop(); delay_ms(10); return 0; }

写入发射率寄存器 0x04 之后修改立即生效，不需要复位。最容易被忽略的是改 SMBus 地址：如果你动了 0x0F，下次通信地址就变了，主控代码里所有 0xB4/0xB5 都要同步改，还要按数据手册要求补一个取反校验字节，否则地址写不进去。所以一般只建议在出厂配置阶段改地址，跑通之后就不要反复动了。

4. 红外测温换算、发射率修正与软件滤波：让读数对得上体温计

4.1 原始数据转摄氏度：先补码判断再乘 0.02

MLX90614 返回的 16 位数据是二进制补码，单位是开尔文，分辨率 0.02K/LSB。转换步骤是：把高低两个字节拼成无符号数，再按 int16_t 解释成有符号数，乘 0.02 得到开尔文温度，最后减 273.15 得到摄氏度。

/* raw: 从 MLX90614_ReadWord 读回的原始值 */ float MLX90614_CalcTemp(uint16_t raw) { int16_t val = (int16_t)raw; /* 关键：先转有符号 */ float temp_k = val * 0.02f; return temp_k - 273.15f; }

这里最容易犯的错是用 uint16_t 直接参与运算。0xFFFF 按无符号算是 65535，乘 0.02 后得到 1310.7K，明显超出物理范围；按 int16_t 解释则是 -1，对应 -273.17℃，同样不合理，但至少能立刻看出数据异常。实际调试中，总线故障时读到 0xFFFF 的概率很高，建议在调用转换函数前先判断 raw < 0xFF00 这类边界条件，直接丢弃异常数据。

4.2 发射率修正：出厂默认 1.0 测不到真实表面温度

MLX90614 内部计算目标温度时假设发射率是 1.0，也就是完全黑体。真实物体辐射率都小于 1，不修正的话，测量亮色金属表面可能偏低十几度。常见的经验值：人体皮肤约 0.98，黑色哑光胶带约 0.95，氧化铝表面约 0.2 到 0.4。修正公式要用开尔文温度做四次方运算：

float MLX90614_EmissivityCorrect(float tobj_c, float ta_c, float emissivity) { float t_raw = tobj_c + 273.15f; float t_amb = ta_c + 273.15f; float t_true; float t4 = powf(t_raw, 4.0f); /* 扣除环境反射分量，再除以真实发射率，最后开四次方 */ t_true = powf((t4 - (1.0f - emissivity) * powf(t_amb, 4.0f)) / emissivity, 0.25f); return t_true - 273.15f; }

注意公式中的环境温度 Ta 必须来自同一次采样，因为环境温度也在缓慢漂移。现场演示时如果不想改 EEPROM，直接调用这个函数做软件修正即可；如果想让模块本身输出修正后的结果，就通过 3.4 节的写 EEPROM 流程把 0x04 改成对应发射率。投影片上也经常会问“为什么拿铝箔和黑胶带测同一个热源差那么多”，这就是发射率的作用。

4.3 先中值后平均：对付热电堆毫伏级噪声

红外传感器的信号链路增益极高，噪声表现为读数在真实值附近来回跳，单次采样的峰峰抖动可能达到 ±0.5℃ 甚至更高。单纯做滑动平均能压住白噪声，但对脉冲型干扰无效；单纯做中值滤波能剔除野值，但对连续抖动平滑不够。常见的组合策略是：每 100ms 采一组数据，先做一次中值滤波，再把中值结果送入滑动平均数组。

#define MEDIAN_LEN 5 #define SMOOTH_LEN 10 static float g_smooth_buf[SMOOTH_LEN]; static uint8_t g_smooth_idx; /* 5 点中值，只保留排序后中间值 */ float MLX90614_Median(float *buf, uint8_t len) { float tmp[MEDIAN_LEN]; uint8_t i, j; for (i = 0; i < len; i++) tmp[i] = buf[i]; for (i = 0; i < len - 1; i++) for (j = i + 1; j < len; j++) if (tmp[j] < tmp[i]) { float t = tmp[i]; tmp[i] = tmp[j]; tmp[j] = t; } return tmp[len / 2]; } /* 滑动平均，返回滤波后的值 */ float MLX90614_Smooth(float sample) { float sum = 0.0f; uint8_t i; g_smooth_buf[g_smooth_idx] = sample; g_smooth_idx = (g_smooth_idx + 1) % SMOOTH_LEN; for (i = 0; i < SMOOTH_LEN; i++) sum += g_smooth_buf[i]; return sum / SMOOTH_LEN; }

中值窗口取 5、滑动窗口取 10 是常用折中。窗口太短压不住噪声，太长会让响应变慢，物体从桌面上拿开到贴近传感器的过程中，读数会拖尾 1 秒以上。如果做的是人体测温场景，建议把滑动窗口缩短到 5，优先保证响应速度；做工业表面检测则可以放宽到 20。

4.4 两点标定：用标准温度计拿斜率和截距

模块的出厂线性度已经不错，但每个芯片在 30℃ 到 40℃ 区间都可能存在零点偏移，幅度通常在 ±0.5℃ 以内。毕业设计答辩现场，评委常会拿工业温度计或水银体温计做对照，这时提前做一次两点标定最稳妥。方法：让传感器分别对准两个已知温度的目标，记录换算后的读数 x1、x2，再用标准温度计读出真实值 y1、y2，算出斜率 a 和截距 b，后续显示前做一次线性变换。

/* 标定系数：a = (y2-y1)/(x2-x1)，b = y1 - a*x1 */ float MLX90614_Calibrate(float x, float a, float b) { return a * x + b; }

采集两个点时要注意热平衡。第一个点选择与环境温度接近的散热片，第二个点选择 40℃ 左右的恒温热水袋，目标表面用黑色胶带覆盖；每个点稳定 3 分钟后再读数，取滤波后的平均值参与计算。标定完成后，在恒温环境下可以把显示误差压到 0.2℃ 量级，但这个误差只代表拟合误差，不包含发射率选错导致的系统偏差。答辩时如果被测表面不是黑体，记得先讲清发射率这个变量。

5. STM32 红外测温模块验收：验证手段与三个高频坑

5.1 逻辑分析仪下的一次完整读操作

代码写完别急着看温度，先用逻辑分析仪抓一次 SCL/SDA 波形。一次正常的 RAM 读操作应该是：SCL 空闲为高，SDA 从高拉低产生起始条件；随后出现 9 个时钟，对应地址字节 0xB4 加 ACK；再 9 个时钟，对应偏移地址 0x07；紧接着 SDA 再次拉低产生重复起始；然后是读地址 0xB5，之后连续两段 9 时钟读数据，最后主机回 NACK，SDA 在 SCL 高电平期间释放，SCL 继续走完最后一个脉冲。PEC 开启时，在数据高字节之后还能看到一个 CRC 字节。如果波形里缺少重复起始，或者最后少了一次 NACK，温度数据会整体错位。

5.2 三个高频假故障：NACK、异常宽度、跳变

地址问题的典型特征是：读 RAM 正常、读 EEPROM 返回 NACK。因为 EEPROM 偏移大于 0x0F 时，高位地址参与设备寻址，如果寄存器偏移传成了 16 位，从机根本不会应答。出现固定异常值时，先打印原始 raw 值而不是换算后的温度，能直接判断是总线读到 0xFF 还是物理温度本身异常。

5.3 一行调试输出配合 1ms 定时器节拍

调试输出建议固定成一行，用 STM32 的定时器产生 1ms 基准，每 100ms 触发一次采样打印，格式尽量精简：

printf("raw=%04X TA=%.2f TObj=%.2f\r\n", raw, ta_c, tobj_c);

打印内容同时包含原始值和温度值，比只打印温度有用得多。raw 固定在 0xFFFF 说明总线问题，TA 正常但 TObj 明显偏低，说明发射率修正方向反了。采样节拍放在定时器中断标志位里，不要用 delay 阻塞主循环；一次 SMBus 读操作本身只要几百微秒，但滤波和标定计算不能挤占 LCD 刷新或按键扫描的时间。经验做法是每 100ms 采一次，先做 5 点中值再做 10 点滑动平均，最终 TObj 的峰峰抖动可以从 ±1.2℃ 收窄到 ±0.15℃。

本文还有配套的精品资源，点击获取