简介面向STM32开发者的NTC热敏电阻驱动库2.0.1版本专用于解决STM32平台上的温度采集与换算问题。库内包含NTC_Thermistor核心驱动、SmoothThermistor与AverageThermistor平滑及均值滤波实现并提供STM32工程示例涵盖平滑测量、均值测量与串口读取三种典型应用场景适合从入门到进阶的嵌入式开发者快速搭建温度监测功能。压缩包共16个文件以h头文件、cpp源码和ino示例为主附带library.properties库描述、README说明文档、LICENSE许可与接线示意图整体仅46KB结构清晰。该资源已被168人学习下载代码针对STM32特点做了优化兼顾计算效率与资源占用文档同步更新可帮助使用者理解NTC电阻-温度曲线换算、ADC读取及滤波算法从而缩短温度采集功能的开发周期。1. NTC 在 STM32 上测不准的三个误差来源在 STM32 上接 NTC 热敏电阻最典型的翻车现场是手写一段 ADC 读取代码套 B 值公式算出温度串口一打读数在 ±1.5℃ 之间跳到了 80℃ 以上比标准温度计低 4℃。多数人第一反应是加滤波但真正的问题往往藏在换算模型、分压电路和采样链路三个环节里。NTC_Thermistor-2.0.1 这个库把整套逻辑拆成了三层Thermistor 负责阻值到温度的换算AverageThermistor 做 N 点算术平均SmoothThermistor 做指数平滑并在 2.0.1 里针对 STM32 的 12 位 ADC 优化了计算效率和示例工程。适合做设备热保护、电池温度管理、环境监测这类需要稳定温度读数的嵌入式项目。2. β 方程与 Steinhart-Hart库内温度换算的实现逻辑2.1 NTC 阻值与温度的指数关系NTC 热敏电阻的阻值随温度升高而下降但不是线性下降而是近似指数衰减。以 25℃ 下 10kΩ、B 值 3950 的常见料号为例50℃ 时阻值只剩约 3.6kΩ85℃ 时不到 1.5kΩ。如果直接用线性比例换算温度温区稍微拉宽误差就会快速放大。工程上最常用的是 β 方程1/T 1/T0 (1/β) × ln(R/R0)其中 R0 是标称温度 T0通常 25℃下的阻值β 是材料常数典型值在 3380 到 4300K 之间。这个方程只有一个待定参数 β规格书一定会给所以工程上普及率最高。库内 Thermistor 的换算也是按这个公式走的。β 方程的局限性在于它假设 ln(R) 与 1/T 严格线性。实际 NTC 材料在宽温区会偏离这条直线。070℃ 范围内B3950 的 10k NTC 用 β 方程最大偏差大约 ±0.5℃如果拉宽到 -20100℃偏差可能到 ±1.5℃。这个误差不是 ADC 精度能救回来的是模型本身的缺陷。2.2 Steinhart-Hart 方程什么时候值得用Steinhart-Hart 方程是更精确的三参数模型1/T A B×ln(R) C×(ln(R))³三个系数需要三个温度点的阻值来标定。不用自己解三元方程组把三点数据丢进现成的 S-H 系数计算器就能得到 A、B、C。它的优势是在宽温区内误差可以压到 ±0.1℃ 以内代价是标定麻烦和对数运算量更大。日常项目里我一般这样选温度范围窄比如 070℃或者只做温度阈值告警β 方程完全够用做高精度温度记录、需要跨宽温区推算就换 Steinhart-Hart或者至少用第 5 章的两点校准把 B 值修正到自己的物料上。这个库默认走 β 方程路线正因为大多数 NTC 规格书只给 B 值而不是三个 S-H 系数。2.3 Thermistor 类的构造参数与换算流程库内 Thermistor 类的构造参数依次是引脚、串联电阻、标称阻值、标称温度、B 值、ADC 分辨率、ADC 参考电压。以 25℃ 下 10k NTC、串联电阻 10k、STM32 12 位 ADC 3.3V 供电为例#include Thermistor.h // 参数引脚、串联电阻、标称阻值、标称温度、B值、ADC分辨率、参考电压mV Thermistor thermistor(PA0, 10000, 10000, 25, 3950, 4095, 3300); float t thermistor.readTemperatureC();PA0STM32 的 ADC 输入引脚对应 CubeMX 里配置的 ADC 通道10000第二个分压电路里的固定串联电阻单位 Ω10000第三个NTC 在标称温度下的阻值单位 Ω25标称温度单位 ℃3950B 值单位 K具体见 NTC 规格书409512 位 ADC 满量程值如果库内约定传 4096 则以注释为准3300ADC 参考电压单位 mV务必用实测值读取流程分三步先拿 ADC 原始值再按分压公式反推 NTC 当前阻值最后套 β 方程换算温度。如果分压电路是 NTC 在低端固定电阻接 VCC、NTC 接 GND阻值计算式是R R_series × (ADC_MAX / ADC − 1)R_series串联固定电阻ADC_MAX12 位 ADC 满量程 4095ADC当前采样原始值2.4 STM32 优化点在哪里这个版本对 STM32 的优化体现在三个层面。第一把 ADC 分辨率和参考电压作为构造参数传入换算时不需要每次运行时去推导这些常量。第二示例工程里明确推荐先取平均再换算温度避免对每个原始样本都做log运算——STM32F103 在 72MHz 主频下数学库的log单次调用大约几十微秒频繁采样时会白白吃掉 CPU 时间。第三2.0.1 的 examples 里带了 STM32 SmoothMeasurement 和 AverageMeasurement 两个完整示例可以直接看到 ADC 初始化和库调用怎么衔接。模型所需参数0~70℃ 典型误差适用场景β 方程R0、T0、B 值±0.5℃热保护、环境监测、电池测温Steinhart-HartA、B、C 三点标定±0.1℃ 以内宽温区仪表、高精度记录3. STM32 ADC 采样链路配置与 Thermistor 库初始化实战3.1 分压电路与 ADC 输入阻抗的匹配NTC 测温的分压电路是整套系统的地基。推荐接法是VCC 到固定电阻 R_series再到 ADC 引脚再到 NTC最后到 GND。ADC 引脚对地并联一个 100nF 电容。这个电容既能滤高频噪声也会在采样瞬间与 ADC 内部采样电容发生电荷共享。STM32 的 ADC 是逐次逼近型内部采样保持电容需要时间从外部电路取电。源阻抗越大需要的时间越长。NTC 分压点在 25℃ 附近源阻抗大约是两电阻并联值10k 对 10k 时约 5kΩ。CubeMX 默认采样时间如果选 12.5 个 ADC 时钟周期某些引脚上会在输入阻抗偏高时读到偏低的电压。常见做法是直接拉到 55.5 或 239.5 个周期牺牲采样率换取准确度。注意采样时间不是越长越好。超过 239.5 周期后读数不再变化再拉长只会降低采样率对精度没有额外帮助。3.2 CubeMX 配置与 HAL 读取代码CubeMX 里配置 ADC1 的 IN0 通道分辨率选 12 位。重点是把采样时间改长对应生成的 HAL 代码是hadc1.Init.SamplingTime ADC_SAMPLETIME_239CYCLES_5;APB2 时钟 72MHz 时239.5 个周期约 3.3μs。配合外部 100nF 电容10kΩ 级别源阻抗能稳定读准。初始化完成后单次读取原始值是uint32_t read_ntc_adc(void) { HAL_ADC_Start(hadc1); if (HAL_ADC_PollForConversion(hadc1, 100) HAL_OK) return HAL_ADC_GetValue(hadc1); return 0; }HAL_ADC_Start启动一次 ADC 转换HAL_ADC_PollForConversion阻塞等待转换完成第二参数是超时时间单位 msHAL_ADC_GetValue返回 12 位原始值范围 040953.3 与 Thermistor 对象对接的两种模式拿到 ADC 原始值后怎么喂给库是关键。第一种是裸机模式每次读取前用read_ntc_adc()拿到新值替换库默认的读值函数。由于 Arduino 的analogRead在 STM32 上没有原生实现库的 STM32 示例会封装一层适配本质就是把 HAL 返回值塞进 Thermistor 的换算入口。第二种是中断加 DMA 模式更符合 STM32 的习惯定时器 1kHz 触发 ADC 采样DMA 把结果循环搬运进缓冲区主循环每 100ms 取一批样本求平均再把均值丢给 Thermistor 换算温度。这样 ADC 采集和温度换算完全解耦主循环负载很轻。我实际项目里通常这么分工CubeMX 配定时器触发 ADCDMA 开循环模式缓冲深度 64主循环用 100ms 周期读 32 个样本平均再调用一次温度换算。温度更新频率 10Hz对热保护和环境监测都足够CPU 占用几乎可以忽略。3.4 参考电压校准STM32 的 ADC 参考电压默认等于 VDDA。很多最小系统板的 VDDA 不是严格 3.3V会随负载小幅波动。构造函数里传的 3300mV 如果不准整个温度曲线会偏移。排查方法很直接用万用表实测 VDDA把实际毫伏值传给库。如果对精度要求高利用 STM32 内部 VREFINT 通道校准先读 VREFINT 的 ADC 原始值再反推当前 VDDA。VREFINT 的出厂校准值存在芯片生产区通过 HAL 接口可以读到。不校准的话VDDA 偏差 50mV在 12 位 ADC 下能让温度读数偏大约 0.30.5℃这在 85℃ 热保护场景里可能直接决定保护点准不准。4. AverageThermistor 与 SmoothThermistor 的滤波策略对比与选型4.1 AverageThermistorN 点算术平均AverageThermistor 在 Thermistor 构造参数基础上多了一个采样数量AverageThermistor avgThermistor(PA0, 10000, 10000, 25, 3950, 4095, 3300, 10); float t avgThermistor.readTemperatureC();内部逻辑是连续采 N 次 ADC 原始值求算术平均后再换算温度。注意顺序先平均 ADC 值再算阻值最后套 β 方程。不能先每次算温度再对温度做平均因为温度与阻值是指数关系对温度平均会引入系统性偏差而 ADC 原始值在分压点上近似线性先平均才是对的。N 的取值取决于噪声水平。ADC 读数只在 ±23 LSB 抖动时N10 就能把抖动压到 1 LSB 以内电源纹波大导致 ±10 LSB 毛刺时N50 更稳妥。代价是采样时间线性增长10 次采样每次 3.3μs总共 33μs对大多数场景完全没有压力。4.2 SmoothThermistor指数滑动平均SmoothThermistor 的思路不同它维护一个内部状态每次读入新值都和旧值做加权合并SmoothThermistor smoothThermistor(PA0, 10000, 10000, 25, 3950, 4095, 3300, 10); float t smoothThermistor.readTemperatureC();最后一个参数是平滑因子常见实现是这样的逻辑// 每次采样后更新内部平滑值 _smoothed (_smoothed * (factor - 1) newADC) / factor;factor新值权重为 1/factor旧值权重为 (factor−1)/factorfactor1直通无平滑效果factor10新值贡献 10%旧值贡献 90%等效时间常数约 10 个采样周期与 Average 的批量感不同Smooth 每次读取都吐出一个结果适合实时控制环的反馈输入比如恒温 PID 或温度保护阈值判断。4.3 选型参数表与实战建议维度AverageThermistorSmoothThermistor输出节奏攒满 N 次后输出每次读取都输出抗脉冲干扰强单点毛刺被稀释中等单点毛刺引起小幅跳变响应延迟N 个采样周期约 35 倍时间常数典型场景电池温度巡检、环境记录热保护阈值、PID 反馈、温控曲线两个滤波类都继承自 Thermistor代码里可以直接互换不需要改外围逻辑。我的习惯是项目初期先用 AverageThermistor 跑原始数据串口观察噪声底在哪里再决定要不要换成 SmoothThermistor。做温度告警比如超过 85℃ 拉闸时用 Smooth因为它每次读取都输出新值不会像 Average 那样攒批导致阈值判断晚几个采样周期。4.4 别对每个样本都调用 readTemperatureC一个高频踩坑点把readTemperatureC()放进 1ms 定时器里连续调用再指望 SmoothThermistor 平输出。这样每次调用都会执行一次log运算CPU 占用率可能飙到 20% 以上。正确做法是高频采样 ADC、低频换算温度。比如 1kHz 采样 ADC 并更新平滑状态每 100ms 调用一次readTemperatureC()取当前平滑后的温度。这样既保住平滑效果又把对数运算控制在每秒 10 次。5. B 值校准与 ADC 噪声排查的实用技巧5.1 两点校准反推 B 值规格书给的 B 值通常是该型号的典型值同一批料也有离散度。如果有恒温设备和标准温度计自己算 B 值更准B ln(R1 / R2) / (1/T1 − 1/T2)实操时用冰水混合物做 0℃ 点冰水要搅匀用沸水做 100℃ 点海拔不同沸点不同必须用温度计实测万用表量出对应阻值代入import math t1, r1 0.0, 32700.0 # 0℃ 实测阻值 t2, r2 100.0, 1370.0 # 100℃ 实测阻值 T1 t1 273.15 T2 t2 273.15 B math.log(r1 / r2) / (1 / T1 - 1 / T2) print(fB {B:.1f})算出的 B 值替换构造参数里的3950。B 值偏差几十 K 时在 100℃ 处温度换算能差出 1℃ 以上这一步值得在量产前做一次。5.2 ADC 抖动排查顺序温度读数跳动时不要急着加滤波参数按顺序查串口打印原始 ADC 值看跳变幅度。正常应在 ±23 LSB对应温度约 ±0.05℃。万用表量 VDDA 是否稳定。3.3V 上并联 10μF 加 100nF 电容带载时电压不能明显跌落。确认采样时间配置。源阻抗 10k 时12.5 周期和 239.5 周期的读数差可达 35 LSB。检查分压电路的地是不是独立模拟地远离电机驱动或继电器等大电流回路。5.3 自热误差与电阻取值的平衡NTC 会自热流过电流越大阻体温度越高于环境。3.3V 分压、上下电阻各 10k 时回路电流约 165μANTC 上最大功耗约 0.27mW0603 封装自热温升通常在 0.05℃ 以内不需要处理。把固定电阻换成 100k 可以再降功耗但源阻抗变大必须配合更长的 ADC 采样时间。我一般取 10k47k采样时间固定在 239.5 周期两端兼顾。提示调试阶段建议把 VREFINT 校准值在启动时算一次串口同时输出原始 ADC、计算阻值、校准前温度和校准后温度四个值。拿到现场日志后一眼就能定位偏差在 ADC、分压还是换算式里。本文还有配套的精品资源点击获取 STM32 NTC测温误差分析与滤波校准实战
简介面向STM32开发者的NTC热敏电阻驱动库2.0.1版本专用于解决STM32平台上的温度采集与换算问题。库内包含NTC_Thermistor核心驱动、SmoothThermistor与AverageThermistor平滑及均值滤波实现并提供STM32工程示例涵盖平滑测量、均值测量与串口读取三种典型应用场景适合从入门到进阶的嵌入式开发者快速搭建温度监测功能。压缩包共16个文件以h头文件、cpp源码和ino示例为主附带library.properties库描述、README说明文档、LICENSE许可与接线示意图整体仅46KB结构清晰。该资源已被168人学习下载代码针对STM32特点做了优化兼顾计算效率与资源占用文档同步更新可帮助使用者理解NTC电阻-温度曲线换算、ADC读取及滤波算法从而缩短温度采集功能的开发周期。1. NTC 在 STM32 上测不准的三个误差来源在 STM32 上接 NTC 热敏电阻最典型的翻车现场是手写一段 ADC 读取代码套 B 值公式算出温度串口一打读数在 ±1.5℃ 之间跳到了 80℃ 以上比标准温度计低 4℃。多数人第一反应是加滤波但真正的问题往往藏在换算模型、分压电路和采样链路三个环节里。NTC_Thermistor-2.0.1 这个库把整套逻辑拆成了三层Thermistor 负责阻值到温度的换算AverageThermistor 做 N 点算术平均SmoothThermistor 做指数平滑并在 2.0.1 里针对 STM32 的 12 位 ADC 优化了计算效率和示例工程。适合做设备热保护、电池温度管理、环境监测这类需要稳定温度读数的嵌入式项目。2. β 方程与 Steinhart-Hart库内温度换算的实现逻辑2.1 NTC 阻值与温度的指数关系NTC 热敏电阻的阻值随温度升高而下降但不是线性下降而是近似指数衰减。以 25℃ 下 10kΩ、B 值 3950 的常见料号为例50℃ 时阻值只剩约 3.6kΩ85℃ 时不到 1.5kΩ。如果直接用线性比例换算温度温区稍微拉宽误差就会快速放大。工程上最常用的是 β 方程1/T 1/T0 (1/β) × ln(R/R0)其中 R0 是标称温度 T0通常 25℃下的阻值β 是材料常数典型值在 3380 到 4300K 之间。这个方程只有一个待定参数 β规格书一定会给所以工程上普及率最高。库内 Thermistor 的换算也是按这个公式走的。β 方程的局限性在于它假设 ln(R) 与 1/T 严格线性。实际 NTC 材料在宽温区会偏离这条直线。070℃ 范围内B3950 的 10k NTC 用 β 方程最大偏差大约 ±0.5℃如果拉宽到 -20100℃偏差可能到 ±1.5℃。这个误差不是 ADC 精度能救回来的是模型本身的缺陷。2.2 Steinhart-Hart 方程什么时候值得用Steinhart-Hart 方程是更精确的三参数模型1/T A B×ln(R) C×(ln(R))³三个系数需要三个温度点的阻值来标定。不用自己解三元方程组把三点数据丢进现成的 S-H 系数计算器就能得到 A、B、C。它的优势是在宽温区内误差可以压到 ±0.1℃ 以内代价是标定麻烦和对数运算量更大。日常项目里我一般这样选温度范围窄比如 070℃或者只做温度阈值告警β 方程完全够用做高精度温度记录、需要跨宽温区推算就换 Steinhart-Hart或者至少用第 5 章的两点校准把 B 值修正到自己的物料上。这个库默认走 β 方程路线正因为大多数 NTC 规格书只给 B 值而不是三个 S-H 系数。2.3 Thermistor 类的构造参数与换算流程库内 Thermistor 类的构造参数依次是引脚、串联电阻、标称阻值、标称温度、B 值、ADC 分辨率、ADC 参考电压。以 25℃ 下 10k NTC、串联电阻 10k、STM32 12 位 ADC 3.3V 供电为例#include Thermistor.h // 参数引脚、串联电阻、标称阻值、标称温度、B值、ADC分辨率、参考电压mV Thermistor thermistor(PA0, 10000, 10000, 25, 3950, 4095, 3300); float t thermistor.readTemperatureC();PA0STM32 的 ADC 输入引脚对应 CubeMX 里配置的 ADC 通道10000第二个分压电路里的固定串联电阻单位 Ω10000第三个NTC 在标称温度下的阻值单位 Ω25标称温度单位 ℃3950B 值单位 K具体见 NTC 规格书409512 位 ADC 满量程值如果库内约定传 4096 则以注释为准3300ADC 参考电压单位 mV务必用实测值读取流程分三步先拿 ADC 原始值再按分压公式反推 NTC 当前阻值最后套 β 方程换算温度。如果分压电路是 NTC 在低端固定电阻接 VCC、NTC 接 GND阻值计算式是R R_series × (ADC_MAX / ADC − 1)R_series串联固定电阻ADC_MAX12 位 ADC 满量程 4095ADC当前采样原始值2.4 STM32 优化点在哪里这个版本对 STM32 的优化体现在三个层面。第一把 ADC 分辨率和参考电压作为构造参数传入换算时不需要每次运行时去推导这些常量。第二示例工程里明确推荐先取平均再换算温度避免对每个原始样本都做log运算——STM32F103 在 72MHz 主频下数学库的log单次调用大约几十微秒频繁采样时会白白吃掉 CPU 时间。第三2.0.1 的 examples 里带了 STM32 SmoothMeasurement 和 AverageMeasurement 两个完整示例可以直接看到 ADC 初始化和库调用怎么衔接。模型所需参数0~70℃ 典型误差适用场景β 方程R0、T0、B 值±0.5℃热保护、环境监测、电池测温Steinhart-HartA、B、C 三点标定±0.1℃ 以内宽温区仪表、高精度记录3. STM32 ADC 采样链路配置与 Thermistor 库初始化实战3.1 分压电路与 ADC 输入阻抗的匹配NTC 测温的分压电路是整套系统的地基。推荐接法是VCC 到固定电阻 R_series再到 ADC 引脚再到 NTC最后到 GND。ADC 引脚对地并联一个 100nF 电容。这个电容既能滤高频噪声也会在采样瞬间与 ADC 内部采样电容发生电荷共享。STM32 的 ADC 是逐次逼近型内部采样保持电容需要时间从外部电路取电。源阻抗越大需要的时间越长。NTC 分压点在 25℃ 附近源阻抗大约是两电阻并联值10k 对 10k 时约 5kΩ。CubeMX 默认采样时间如果选 12.5 个 ADC 时钟周期某些引脚上会在输入阻抗偏高时读到偏低的电压。常见做法是直接拉到 55.5 或 239.5 个周期牺牲采样率换取准确度。注意采样时间不是越长越好。超过 239.5 周期后读数不再变化再拉长只会降低采样率对精度没有额外帮助。3.2 CubeMX 配置与 HAL 读取代码CubeMX 里配置 ADC1 的 IN0 通道分辨率选 12 位。重点是把采样时间改长对应生成的 HAL 代码是hadc1.Init.SamplingTime ADC_SAMPLETIME_239CYCLES_5;APB2 时钟 72MHz 时239.5 个周期约 3.3μs。配合外部 100nF 电容10kΩ 级别源阻抗能稳定读准。初始化完成后单次读取原始值是uint32_t read_ntc_adc(void) { HAL_ADC_Start(hadc1); if (HAL_ADC_PollForConversion(hadc1, 100) HAL_OK) return HAL_ADC_GetValue(hadc1); return 0; }HAL_ADC_Start启动一次 ADC 转换HAL_ADC_PollForConversion阻塞等待转换完成第二参数是超时时间单位 msHAL_ADC_GetValue返回 12 位原始值范围 040953.3 与 Thermistor 对象对接的两种模式拿到 ADC 原始值后怎么喂给库是关键。第一种是裸机模式每次读取前用read_ntc_adc()拿到新值替换库默认的读值函数。由于 Arduino 的analogRead在 STM32 上没有原生实现库的 STM32 示例会封装一层适配本质就是把 HAL 返回值塞进 Thermistor 的换算入口。第二种是中断加 DMA 模式更符合 STM32 的习惯定时器 1kHz 触发 ADC 采样DMA 把结果循环搬运进缓冲区主循环每 100ms 取一批样本求平均再把均值丢给 Thermistor 换算温度。这样 ADC 采集和温度换算完全解耦主循环负载很轻。我实际项目里通常这么分工CubeMX 配定时器触发 ADCDMA 开循环模式缓冲深度 64主循环用 100ms 周期读 32 个样本平均再调用一次温度换算。温度更新频率 10Hz对热保护和环境监测都足够CPU 占用几乎可以忽略。3.4 参考电压校准STM32 的 ADC 参考电压默认等于 VDDA。很多最小系统板的 VDDA 不是严格 3.3V会随负载小幅波动。构造函数里传的 3300mV 如果不准整个温度曲线会偏移。排查方法很直接用万用表实测 VDDA把实际毫伏值传给库。如果对精度要求高利用 STM32 内部 VREFINT 通道校准先读 VREFINT 的 ADC 原始值再反推当前 VDDA。VREFINT 的出厂校准值存在芯片生产区通过 HAL 接口可以读到。不校准的话VDDA 偏差 50mV在 12 位 ADC 下能让温度读数偏大约 0.30.5℃这在 85℃ 热保护场景里可能直接决定保护点准不准。4. AverageThermistor 与 SmoothThermistor 的滤波策略对比与选型4.1 AverageThermistorN 点算术平均AverageThermistor 在 Thermistor 构造参数基础上多了一个采样数量AverageThermistor avgThermistor(PA0, 10000, 10000, 25, 3950, 4095, 3300, 10); float t avgThermistor.readTemperatureC();内部逻辑是连续采 N 次 ADC 原始值求算术平均后再换算温度。注意顺序先平均 ADC 值再算阻值最后套 β 方程。不能先每次算温度再对温度做平均因为温度与阻值是指数关系对温度平均会引入系统性偏差而 ADC 原始值在分压点上近似线性先平均才是对的。N 的取值取决于噪声水平。ADC 读数只在 ±23 LSB 抖动时N10 就能把抖动压到 1 LSB 以内电源纹波大导致 ±10 LSB 毛刺时N50 更稳妥。代价是采样时间线性增长10 次采样每次 3.3μs总共 33μs对大多数场景完全没有压力。4.2 SmoothThermistor指数滑动平均SmoothThermistor 的思路不同它维护一个内部状态每次读入新值都和旧值做加权合并SmoothThermistor smoothThermistor(PA0, 10000, 10000, 25, 3950, 4095, 3300, 10); float t smoothThermistor.readTemperatureC();最后一个参数是平滑因子常见实现是这样的逻辑// 每次采样后更新内部平滑值 _smoothed (_smoothed * (factor - 1) newADC) / factor;factor新值权重为 1/factor旧值权重为 (factor−1)/factorfactor1直通无平滑效果factor10新值贡献 10%旧值贡献 90%等效时间常数约 10 个采样周期与 Average 的批量感不同Smooth 每次读取都吐出一个结果适合实时控制环的反馈输入比如恒温 PID 或温度保护阈值判断。4.3 选型参数表与实战建议维度AverageThermistorSmoothThermistor输出节奏攒满 N 次后输出每次读取都输出抗脉冲干扰强单点毛刺被稀释中等单点毛刺引起小幅跳变响应延迟N 个采样周期约 35 倍时间常数典型场景电池温度巡检、环境记录热保护阈值、PID 反馈、温控曲线两个滤波类都继承自 Thermistor代码里可以直接互换不需要改外围逻辑。我的习惯是项目初期先用 AverageThermistor 跑原始数据串口观察噪声底在哪里再决定要不要换成 SmoothThermistor。做温度告警比如超过 85℃ 拉闸时用 Smooth因为它每次读取都输出新值不会像 Average 那样攒批导致阈值判断晚几个采样周期。4.4 别对每个样本都调用 readTemperatureC一个高频踩坑点把readTemperatureC()放进 1ms 定时器里连续调用再指望 SmoothThermistor 平输出。这样每次调用都会执行一次log运算CPU 占用率可能飙到 20% 以上。正确做法是高频采样 ADC、低频换算温度。比如 1kHz 采样 ADC 并更新平滑状态每 100ms 调用一次readTemperatureC()取当前平滑后的温度。这样既保住平滑效果又把对数运算控制在每秒 10 次。5. B 值校准与 ADC 噪声排查的实用技巧5.1 两点校准反推 B 值规格书给的 B 值通常是该型号的典型值同一批料也有离散度。如果有恒温设备和标准温度计自己算 B 值更准B ln(R1 / R2) / (1/T1 − 1/T2)实操时用冰水混合物做 0℃ 点冰水要搅匀用沸水做 100℃ 点海拔不同沸点不同必须用温度计实测万用表量出对应阻值代入import math t1, r1 0.0, 32700.0 # 0℃ 实测阻值 t2, r2 100.0, 1370.0 # 100℃ 实测阻值 T1 t1 273.15 T2 t2 273.15 B math.log(r1 / r2) / (1 / T1 - 1 / T2) print(fB {B:.1f})算出的 B 值替换构造参数里的3950。B 值偏差几十 K 时在 100℃ 处温度换算能差出 1℃ 以上这一步值得在量产前做一次。5.2 ADC 抖动排查顺序温度读数跳动时不要急着加滤波参数按顺序查串口打印原始 ADC 值看跳变幅度。正常应在 ±23 LSB对应温度约 ±0.05℃。万用表量 VDDA 是否稳定。3.3V 上并联 10μF 加 100nF 电容带载时电压不能明显跌落。确认采样时间配置。源阻抗 10k 时12.5 周期和 239.5 周期的读数差可达 35 LSB。检查分压电路的地是不是独立模拟地远离电机驱动或继电器等大电流回路。5.3 自热误差与电阻取值的平衡NTC 会自热流过电流越大阻体温度越高于环境。3.3V 分压、上下电阻各 10k 时回路电流约 165μANTC 上最大功耗约 0.27mW0603 封装自热温升通常在 0.05℃ 以内不需要处理。把固定电阻换成 100k 可以再降功耗但源阻抗变大必须配合更长的 ADC 采样时间。我一般取 10k47k采样时间固定在 239.5 周期两端兼顾。提示调试阶段建议把 VREFINT 校准值在启动时算一次串口同时输出原始 ADC、计算阻值、校准前温度和校准后温度四个值。拿到现场日志后一眼就能定位偏差在 ADC、分压还是换算式里。本文还有配套的精品资源点击获取