保姆级教程：用STM32CubeMX和HAL库搞定NTC热敏电阻测温（附完整代码）
STM32CubeMX与HAL库实战：NTC热敏电阻高精度测温系统开发指南
在物联网设备开发中，温度监测是最基础却又至关重要的功能之一。无论是智能家居中的环境控制系统，还是工业设备的状态监测，精准的温度测量都是保障系统稳定运行的前提。对于STM32开发者而言，利用内置ADC模块配合NTC热敏电阻实现温度采集，是一种高性价比的解决方案。本文将彻底解析从硬件连接到软件实现的完整流程，提供可直接移植的代码框架。
1. 硬件设计与环境搭建
1.1 NTC热敏电阻选型与电路设计
B3950 10K NTC热敏电阻是工业级应用的常见选择，其电阻值随温度变化呈现良好的线性特性。典型分压电路设计如下：
VCC (3.3V) | [R1: 10KΩ固定电阻] | |---[ADC输入引脚] | [NTC热敏电阻] | GND关键参数计算：
- 当NTC在25℃时阻值为10KΩ，此时分压点电压为1.65V
- ADC分辨率=3.3V/4095≈0.806mV每LSB
- 建议在NTC与ADC引脚间加入100nF滤波电容
注意：实际PCB布局时，模拟信号走线应远离高频数字信号，避免电磁干扰影响测量精度
1.2 STM32开发环境配置
- 安装STM32CubeMX 6.x及以上版本
- 选择对应芯片系列（如STM32F1xx）的HAL库
- 准备调试工具（ST-Link/J-Link）和串口终端软件
推荐开发板配置：
- 主控：STM32F103C8T6（Blue Pill开发板）
- 调试接口：SWD
- 供电：3.3V稳压输出
2. CubeMX工程配置详解
2.1 ADC模块初始化
在CubeMX界面中按以下步骤配置：
启用ADC1模块
选择对应通道（如Channel 13对应PC3引脚）
参数设置：
Clock Prescaler: PCLK2 divided by 6 Resolution: 12 bits Data Alignment: Right Scan Conversion Mode: Disabled Continuous Conversion Mode: Enabled Discontinuous Conversion Mode: Disabled Number Of Conversion: 1 Sampling Time: 55.5 Cycles生成代码前勾选"Generate peripheral initialization as a pair of .c/.h files"
2.2 时钟树配置关键点
时钟配置直接影响ADC采样精度：
| 参数 | 推荐值 | 说明 |
|---|---|---|
| HCLK | 72 MHz | 系统主时钟 |
| PCLK2 | 72 MHz | APB2总线时钟 |
| ADC Prescaler | /6 | 得到12MHz ADC时钟 |
| Sampling Time | 55.5周期 | 平衡速度与采样精度 |
计算实际采样率：
- 转换时间 = (55.5 + 12.5)周期 / 12MHz ≈ 5.67μs
- 最大采样率 ≈ 176kSPS
3. HAL库温度采集实现
3.1 ADC数据采集核心代码
在生成的工程框架中添加以下功能模块：
// ntc.h typedef struct { uint16_t raw_value; float voltage; float temperature; } NTC_HandleTypeDef; void NTC_Init(void); void NTC_Update(void); float NTC_GetTemperature(void);// ntc.c #include "ntc.h" NTC_HandleTypeDef hntc; void NTC_Init(void) { HAL_ADC_Start(&hadc1); } void NTC_Update(void) { if(HAL_ADC_PollForConversion(&hadc1, 10) == HAL_OK) { hntc.raw_value = HAL_ADC_GetValue(&hadc1); hntc.voltage = hntc.raw_value * 3.3f / 4095.0f; hntc.temperature = NTC_ConvertToTemperature(hntc.raw_value); } } static float NTC_ConvertToTemperature(uint16_t adc_val) { // 温度转换实现见下一节 }3.2 温度查表法与线性插值
针对B3950 10K NTC，我们采用分段线性化处理：
准备温度-电阻对应表（从-30℃到70℃，间隔1℃）
将电阻值转换为预期ADC值：
// 示例温度表片段 static const struct { uint16_t temp; // 温度(℃×10)，如-300表示-30.0℃ uint16_t adc_low; uint16_t adc_high; } ntc_table[] = { {-300, 3850, 3867}, // -30℃ {-290, 3837, 3854}, // -29℃ // ...中间数据省略... {700, 589, 617} // 70℃ };实现二分查找算法：
static float NTC_ConvertToTemperature(uint16_t adc_val) { int low = 0, high = sizeof(ntc_table)/sizeof(ntc_table[0]) - 1; // 边界检查 if(adc_val >= ntc_table[0].adc_high) return -30.0f; if(adc_val <= ntc_table[high].adc_low) return 70.0f; // 二分查找 while(low <= high) { int mid = (low + high) / 2; if(adc_val > ntc_table[mid].adc_high) { high = mid - 1; } else if(adc_val < ntc_table[mid].adc_low) { low = mid + 1; } else { // 线性插值 float range = ntc_table[mid].adc_high - ntc_table[mid].adc_low; float offset = (float)(adc_val - ntc_table[mid].adc_low) / range; return (ntc_table[mid].temp + offset * 10) / 10.0f; } } return 25.0f; // 默认返回值 }
4. 系统集成与性能优化
4.1 多任务环境下的ADC采样策略
在实际应用中，ADC资源可能被多个传感器共享。推荐采用DMA+定时器触发模式：
CubeMX中配置：
- 启用ADC的DMA传输
- 选择循环模式
- 设置定时器触发（如TIM2 TRGO）
代码实现：
// 启动带DMA的ADC HAL_ADC_Start_DMA(&hadc1, (uint32_t*)adc_buffer, BUFFER_SIZE); // 配置定时器触发 HAL_TIM_Base_Start(&htim2);数据处理回调：
void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef* hadc) { if(hadc->Instance == ADC1) { NTC_ProcessData(adc_buffer); } }
4.2 温度数据的滤波处理
针对NTC测量的噪声问题，可采用复合滤波算法：
移动平均滤波：
#define FILTER_WINDOW 8 static uint16_t adc_history[FILTER_WINDOW]; static uint8_t index = 0; uint16_t filtered_value = 0; adc_history[index++] = raw_adc; if(index >= FILTER_WINDOW) index = 0; for(int i=0; i<FILTER_WINDOW; i++) { filtered_value += adc_history[i]; } filtered_value /= FILTER_WINDOW;一阶滞后滤波：
float alpha = 0.2f; // 滤波系数 static float filtered_temp = 25.0f; filtered_temp = alpha * new_temp + (1-alpha) * filtered_temp;异常值剔除：
#define TEMP_CHANGE_RATE 5.0f // ℃/s if(fabsf(new_temp - last_temp) > TEMP_CHANGE_RATE * sample_interval) { // 视为异常数据，使用上次有效值 return last_temp; }
4.3 功耗优化技巧
对于电池供电设备：
- 采用间歇采样模式（如每10秒唤醒采集一次）
- 在CubeMX中配置ADC的LowPowerAutoWait特性
- 采样完成后切换ADC到低功耗模式：
HAL_ADC_Stop(&hadc1); HAL_ADCEx_DisableVREFINT();
实际项目中，将NTC安装在远离热源的位置，并使用导热硅胶确保与环境充分热交换。调试时发现，上电后的前三次采样通常存在较大偏差，建议在初始化时进行三次空采样后再读取有效数据。