简介本资源是一套基于STM32F103系列单片机采用TPYBoard STM32F103RBT6最小系统板通过SPI接口驱动MAX31865高精度RTD温度传感器模块的完整嵌入式开发方案面向嵌入式初学者、硬件工程师及工业测温应用开发者解决铂电阻如PT100/PT1000温度采集中的通信配置、寄存器操作、冷端补偿与线性化处理等核心问题。压缩包共608个文件总计17.17MB涵盖Keil工程源码69个.c 73个.h文件、编译中间产物.o/.lst/.map等、硬件连接图与实物照片14张PNG/JPG、库函数使用说明docs/下rst文档为主、以及HTML格式的模块参考手册和配置指南。已有1376人学习下载提供开箱即用的Project.uvproj工程、完整SPI底层驱动、MAX31865初始化与温度读取函数封装并附带清晰的目录结构与注释详尽的C源码便于快速移植、调试验证与原理理解。 做测温项目尤其是指望精度能打的PT100/PT1000电阻式传感器很多人第一反应都是用STM32的ADC口直接测。真这么干过的人基本都栽过跟头——冷端补偿、基准电压漂移、导线电阻、PCB走线噪声随便一个因素就能让温度跳好几度。这也是我在项目里最终落到STM32F103SPIMAX31865这套组合的原因MAX31865是专为RTD传感器设计的数字转换芯片内置恒流源激励、24位ADC、参考电阻匹配和故障检测MCU只负责通过SPI把数据读回来做换算。这篇文章会把整个方案的硬件选型、寄存器配置、SPI驱动、温标换算和实测踩坑全部过一遍适合手里有STM32F103最小系统板、想用PT100/PT1000做温度采集又不想在模拟前端上花太多时间的朋友参考。1. 从PT100到MAX31865这套方案到底解决了什么1.1 为什么直接拿ADC测电阻型传感器不靠谱PT100这种热电阻本质是个随温度变化阻值的电阻0℃时刚好100Ω100℃时138.5Ω左右平均每摄氏度才变化约0.385Ω。如果直接用单片机的12位ADC去测通常是先搭一个分压电路把电阻变化转成电压变化再接给ADC采样。问题出在哪分压电路里另一个电阻的精度和温漂会直接叠加进测量结果电源电压稍微波动一点基准源也跟着漂。再加上STM32F103内置ADC本身的量化噪声和参考电压精度有限最终能稳住±0.5℃已经算烧高香实际场景里常常是±1℃以上甚至更多。更麻烦的是接线。工业现场或实验台面上导线动不动一两米铜导线每米大概0.01到0.05Ω两根线串进去就是0.1Ω级别的误差换算成温度已经有零点几摄氏度了。你要是用普通杜邦线或者细电缆误差更大。所以专业测温方案不会这么玩而是用恒流源激励RTD再用高精度ADC同时采集RTD上的电压和参考电阻上的电压两者相除把激励电流的影响抵消掉。MAX31865就是把这一整套模拟前端全部封装好的芯片。1.2 MAX31865内部工作原理与选型优势MAX31865内部集成了一个可选的恒流激励源经过FORCE和FORCE-引脚给外部RTD供电同时芯片内部通过一个精度非常高的参考电阻RREF来确定ADC的满量程。RTD两端的电压经RTDIN和RTDIN-输入到内部24位ADCADC结果实际上是RTD电阻和参考电阻的比值ADC_code (R_RTD / R_REF) × 32768这里32768对应15位ADC的满量程。注意芯片虽然内置24位ADC但输出给MCU的转换结果是15位有效数据。因为换算结果与激励电流大小无关电源电压的波动对精度影响被大幅削弱这也是它敢声称最高0.05%精度、温度分辨率能做到0.03125℃配合PT100的原因。选MAX31865而不是MAX31855最核心的区别是传感器类型不同后者配热电偶输出的是热端对冷端的温差电动势还要自己做冷端补偿而且热电偶本身是非线性器件低温段尤其难做准。而MAX31865配PT100/PT1000在全温区范围内可以用标准分度表或者方程式精确换算稳定性、重复性都好得多。做精密环境监测、工业过程控制、设备温度补偿这类场景PT100MAX31865是远比热电偶省心的路线。1.3 适用场景和整体架构这套方案的定位比较清晰测温范围覆盖-200℃到850℃取决于RTD型号精度可以达到0.1℃级别成本也完全可控非常适合做温度数据记录仪工业设备温度监测电池包或电机的温度采集节点需要温度补偿的精密测量装置实验室恒温环境监控整体硬件架构非常简洁就是一颗STM32F103最小系统板加一块MAX31865模块SPI四根线连过去模块上再接好PT100或者PT1000。MCU主频72MHzSPI跑2.25MHz读一次温度数据只需要几毫秒而MAX31865内部一次转换要几十毫秒到几百毫秒所以性能上完全不构成瓶颈。2. 硬件准备器件选型、参考电阻计算与接线2.1 PT100还是PT1000参考电阻怎么选传感器选PT100还是PT1000直接影响参考电阻的取值和电路的抗干扰表现。PT100在0℃时100ΩPT1000则是1000Ω后者灵敏度更高、自热更小、对导线电阻的容忍度也更好但价格略高而且很多通用工业仪表默认只支持PT100。我的经验是如果整个系统自己说了算又希望线缆长一点、抗干扰好一点直接上PT1000如果是替换老设备或者手头全是PT100探头就老老实实用PT100。参考电阻RREF是MAX31865外围最关键的元件它的精度直接决定测量误差。官方推荐PT100配430ΩPT1000配4300Ω。为什么不是刚好100Ω或1000Ω因为RTD在满量程时电阻会升高以PT100在850℃时约390Ω为例参考电阻必须大于最大量程的RTD电阻否则ADC容易饱和。430Ω给到0到850℃全程留出了余量也兼顾了0℃附近的分辨率。参考电阻的精度至少要选0.1%低温漂最好是0.05%或更高。你到淘宝买那些十几块钱的MAX31865模块板子上的参考电阻质量参差不齐直接读数可能整体偏个零点几摄氏度所以想要仪器级精度建议自己在模块上改成独立的高精度电阻或者先按后文的方法做校准。2.2 二线制、三线制、四线制接线方式RTD传感器引线方式分二线制、三线制和四线制这套方案全部支持二线制RTD两端各接一根线分别连到FORCE与RTDIN短接的一端、以及FORCE-与RTDIN-短接的另一端。虽然后端芯片可以补偿一部分但两根导线的电阻完全叠加进测量回路误差随线长线性增加。只适合短线、精度要求不高的场合。三线制RTD一端只出一根线接到FORCE与RTDIN的公共端另一端出两根线分别接RTDIN-和FORCE-。因为芯片同时采集了RTDIN-和FORCE-之间的电位关系导线电阻造成的压降能够被抵消一部分是工业现场最常用的接法也是我项目里的首选。四线制RTD每个端点接两根线一根走激励电流一根测电压理论上完全消除导线电阻影响精度最高但多一根线也意味着成本增加。实验室和高精度应用中比较常见。我实际测试时用两米长的普通屏蔽电缆二线制读数比三线制约高0.4℃到0.8℃这个偏差正好对应电缆回路的串联电阻换成三线制以后偏差降到0.1℃以内。所以哪怕只是桌上实验也建议优先采用三线制。2.3 STM32F103引脚映射与供电注意事项STM32F103的硬件SPI1默认引脚是PA5SCK、PA6MISO、PA7MOSI这组引脚在最小系统板上基本都引出来了直接用就好。片选CS我用PA4做软件控制原因后面代码部分细说。DRDY引脚是数据就绪输出转换完成后会拉低可以接任意GPIO或者干脆悬空用查询或延时方式代替。完整接线如下MAX31865模块引脚STM32F103引脚说明VIN/VCC3.3V注意必须是3.3V严禁接5VGNDGND共地CLKPA5SPI1_SCKSDIPA7SPI1_MOSISDOPA6SPI1_MISOCSPA4软件片选可换任意GPIODRDYPA3可选数据就绪标志低有效关于供电有一个特别容易踩的雷绝大部分市面上常见的MAX31865模块板上没有3.3V稳压器直接把5V接进去芯片大概率当场报废。它的工作电压范围是3.0V到3.6V只能从STM32F103最小系统板的3.3V引脚取电。焊接之前先拿万用表确认模块上VIN和GND之间不是直通的再上电。3. 寄存器与SPI时序MAX31865的关键bit逐个拆3.1 寄存器地址一览MAX31865的寄存器不多但每个bit都有实际意义先列个表方便对照寄存器地址名称读写属性用途0x00Configuration读/写配置转换模式、采样次数、接线方式0x01RTD MSBs读RTD转换结果高8位0x02RTD LSBs读RTD转换结果低8位0x03High Fault Threshold MSB读/写高温故障阈值高字节0x04High Fault Threshold LSB读/写高温故障阈值低字节0x05Low Fault Threshold MSB读/写低温故障阈值高字节0x06Low Fault Threshold LSB读/写低温故障阈值低字节0x07Fault Status读故障状态寄存器SPI协议上地址字节最高位为1表示写操作为0表示读操作。所以读配置寄存器发送0x00写配置寄存器发送0x80读RTD数据发送0x01读故障状态发送0x07。3.2 配置寄存器各bit怎么设配置寄存器的每一位含义如下D7VBIAS置1开启内部偏置电流也就是RTD激励。测量时必须为1否则RTD上无电流读数没意义。D6Conversion Mode置1为自动转换模式芯片持续周期性转换置0为单次模式需要写D5触发一次转换。我建议日常用自动模式省事。D5One-shot只在单次模式下有效写1启动一次转换转换完成后自动清0。D43-Wire置1表示三线制RTD置0表示二线制或四线制。一定要和实际接线对应上否则数据会明显偏大或偏小。D3到D1Fault Cycle设置采样次数000为1次001为2次010为4次011为8次100为16次。采样次数越多内部数字滤波效果越好但转换时间也越长后面实测数据说明。D0Fault Clear写1清除故障状态位写入后自动回到0。我常用的配置值有两个二线制/四线制、自动转换、2次采样0xC2三线制、自动转换、2次采样0xD2如果环境电磁干扰比较大可以把低三位改成0118次采样配置值相应变成0xCA或0xDA。3.3 SPI读写时序写配置、读RTD数据、读故障写配置寄存器时CS拉低后连续发送两个字节第一个是0x80写配置寄存器地址第二个是配置值然后拉高CS。整个过程一气呵成中间CS不能抖动。读RTD数据时CS拉低先发送0x01作为读地址然后连续读取两个字节。这里最容易犯的错是读完第一个字节就拉高CS或者用两次独立的HAL_SPI_Receive导致第二个字节读到的是垃圾数据。正确做法是CS在整个事务期间保持低电平连续接收两个字节后再拉高。第一个字节是RTD转换结果的高8位第二个字节是低8位。读故障状态更简单发送0x07后读取一个字节即可。如果这个字节非零说明当前有故障需要结合具体bit判断原因。4. STM32F103驱动代码从CubeMX配置到核心读写函数4.1 CubeMX初始化要点用STM32CubeMX生成工程时SPI的初始化有几个关键点SPI模式选Master双线全双工2 Lines Full Duplex数据宽度8位MSB先行CPOL置HighCPHA置2 Edge也就是SPI Mode 3。MAX31865支持Mode 1和Mode 3我用Mode 3比较顺。NSS选Software不要启用硬件片选波特率分频选SPI_BAUDRATEPRESCALER_32即72MHz分频后2.25MHzPA4作为CS引脚时在CubeMX中直接把它配置成GPIO_Output初始电平设为High然后SPI设置里NSS保持Disabled。代码里用两个宏控制片选#define MAX31865_CS_LOW() HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_RESET) #define MAX31865_CS_HIGH() HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_SET)这样做的原因是MAX31865的CS在整个读写事务期间要一直保持低电平中间不能拉高而硬件NSS在8位模式下控制节奏不如软件来得直接软件片选最稳妥。4.2 基础读写函数写配置寄存器void MAX31865_WriteConfig(uint8_t config) { uint8_t tx[2] {0x80, config}; MAX31865_CS_LOW(); HAL_SPI_Transmit(hspi1, tx, 2, 10); MAX31865_CS_HIGH(); }读RTD原始值uint16_t MAX31865_ReadRTD(void) { uint8_t tx[3] {0x01, 0x00, 0x00}; uint8_t rx[3] {0, 0, 0}; MAX31865_CS_LOW(); HAL_SPI_TransmitReceive(hspi1, tx, rx, 3, 10); MAX31865_CS_HIGH(); return (uint16_t)((rx[1] 8) | rx[2]); }之所以不用HAL_SPI_Transmit再HAL_SPI_Receive分开做是因为在片选保持低电平的前提下两次调用之间的时间间隔虽然不长但遇到中断或调度延迟时CS低电平时间拉长不影响正确性问题不大但有些HAL库版本在连续调用时如果DMA或中断处理不当容易出诡异问题。干脆一次TransmitReceive搞定简单可靠。读故障状态uint8_t MAX31865_ReadFault(void) { uint8_t tx[2] {0x07, 0x00}; uint8_t rx[2] {0, 0}; MAX31865_CS_LOW(); HAL_SPI_TransmitReceive(hspi1, tx, rx, 2, 10); MAX31865_CS_HIGH(); return rx[1]; }清故障void MAX31865_ClearFault(void) { uint8_t cfg 0xD2; // 或0xC2取决于接线 cfg | 0x01; // 置FAULTCL位 MAX31865_WriteConfig(cfg); MAX31865_WriteConfig(cfg 0xFE); // 清回0 }4.3 主循环采样状态机初始化阶段先调用一次MAX31865_ClearFault()再写一遍配置然后延时至少100ms等待第一次转换完成。主循环中每次读取的顺序是读RTD值、读故障状态、根据故障状态决定是否采用数据。因为MAX31865自动模式下内部一直在跑转换所以主循环没必要等DRDY直接按固定的间隔读取即可。比如我习惯500ms读一次与2次采样的转换时间约110ms相比肯定不会读到同一个转换周期的重复值。如果对更新时间要求更高可以把采样次数降为1次转换时间约55ms读取周期可以压到100ms。实际项目里我一般还会用一个简单的中值滤波连续读5次排序后取中间值作为这一轮的有效温度。这个逻辑放在后面软件滤波部分细讲。5. 从16位原始值到温度换算公式与查表法5.1 15位ADC数据与bit0的坑MAX31865返回的两字节拼成一个16位数但真正有效的ADC数据是bit15到bit1这15位最低位bit0是故障标志位不是数据。如果直接用这个16位数除以32768计算温度会整整偏大一倍测0℃能算出199℃这种离谱值。所以读回来的raw值必须先右移一位或者用raw 1处理后再参与计算uint16_t raw MAX31865_ReadRTD(); uint16_t adc_code raw 1;同时可以检查raw 0x01如果为1说明存在故障这个值就不应该被使用。5.2 电阻值计算得到15位ADC值后结合参考电阻RREF计算实际电阻float resistance (float)adc_code * RREF / 32768.0f;以PT100配430Ω参考电阻为例0℃时100Ω对应ADC值约7620100℃时138.5Ω对应ADC值约10555。这个公式其实就是前面讲的ADC_code (R_RTD / R_REF) × 32768的反推理解之后就不用死记。5.3 查表插值与Callendar-Van Dusen方程两种实现得到电阻值后换算温度有两种常用方法。第一种是查IEC 60751分度表加线性插值。把PT100在几个典型温度点的电阻值做成常量表const float pt100_table[][2] { {-40, 84.27f}, {0, 100.00f}, {50, 119.40f}, {100, 138.51f}, {150, 157.33f}, {200, 175.86f} };在相邻两个电阻值之间做线性插值float ResistanceToTemp(float r) { uint8_t i; for(i 0; i 5; i) { if(r pt100_table[i][1] r pt100_table[i1][1]) { float ratio (r - pt100_table[i][1]) / (pt100_table[i1][1] - pt100_table[i][1]); return pt100_table[i][0] ratio * (pt100_table[i1][0] - pt100_table[i][0]); } } return -999.0f; // 超出表格范围 }查表法的优点是实现直观、没有任何数学公式负温区也能直接处理只要表格点数足够密插值误差完全可以忽略。缺点是需要占用一点Flash但如果只放十几个点基本可以忽略不计。第二种是用Callendar-Van Dusen方程反解。IEC 60751给出的0℃以上温区关系为R_T R_0 × (1 A×T B×T²)其中A 3.9083×10⁻³B -5.775×10⁻⁷。反解一元二次方程float cvd_temp(float resistance, float r0) { float A 3.9083e-3f; float B -5.775e-7f; float c 1.0f - resistance / r0; float disc A * A - 4.0f * B * c; if(disc 0.0f) return -999.0f; return (-A sqrtf(disc)) / (2.0f * B); }注意这个公式只适用于0℃以上。低温段需要引入C系数的三次项直接用方程反解会偏所以0℃以下我推荐查表法。5.4 两种方法精度对比在我实测中把两种方法放在同一批RTD原始值上对比0℃到150℃范围内最大偏差不超过0.02℃都已经远高于传感器本身的重复性极限。所以选哪种纯粹看个人本文还有配套的精品资源点击获取