手把手教你用STM32F103C8T6和NTC热敏电阻DIY一个水温监测器（附完整代码）
手把手教你用STM32F103C8T6和NTC热敏电阻DIY一个水温监测器（附完整代码）
水温监测在家庭养鱼、咖啡机控制、热水器管理等场景中非常实用。本文将带你从零开始，用最常见的STM32F103C8T6最小系统板和NTC热敏电阻，打造一个低成本、高精度的水温监测系统。不同于简单的代码展示，我们会深入讲解每个环节的设计思路和优化技巧，让你真正掌握嵌入式开发的完整流程。
1. 硬件选型与电路设计
1.1 核心元器件选择
STM32F103C8T6（俗称"蓝莓派"）是这个项目的核心控制器，选择它有三个原因：
- 内置12位ADC，满足温度测量精度需求
- 价格低廉（约10元）
- 社区资源丰富，便于问题排查
NTC热敏电阻我们推荐使用MF52系列10KΩ型号，其特性如下表：
| 参数 | 值 |
|---|---|
| 标称阻值 | 10KΩ @ 25℃ |
| B值 | 3950K |
| 测温范围 | -30℃ ~ +125℃ |
| 精度 | ±1% |
提示：B值决定了NTC的灵敏度，3950K是常见型号，温度变化时阻值变化明显，便于测量。
1.2 分压电路设计
NTC需要配合固定电阻组成分压电路，典型连接方式如下：
3.3V --- [10K固定电阻] --- [NTC] --- GND | ADC输入这个设计的要点在于：
- 固定电阻值应与NTC在中间温度点的阻值相近（我们选10KΩ对应25℃）
- 使用3.3V供电可避免STM32的ADC参考电压问题
- 在ADC输入前可加0.1μF电容滤除高频干扰
2. STM32CubeMX配置
2.1 时钟树设置
首先配置系统时钟为72MHz：
- 选择HSE（外部8MHz晶振）
- PLL倍频到72MHz
- APB2分频保持72MHz（ADC时钟源）
2.2 ADC配置关键步骤
在CubeMX中按以下参数配置ADC1：
- 模式：独立模式
- 数据对齐：右对齐
- 扫描模式：禁用
- 连续转换模式：启用
- 采样时间：55.5周期（提高精度）
// CubeMX生成的ADC初始化代码片段 hadc1.Instance = ADC1; hadc1.Init.DataAlign = ADC_DATAALIGN_RIGHT; hadc1.Init.ScanConvMode = DISABLE; hadc1.Init.ContinuousConvMode = ENABLE; hadc1.Init.NbrOfConversion = 1; hadc1.Init.DiscontinuousConvMode = DISABLE; hadc1.Init.ExternalTrigConv = ADC_SOFTWARE_START;2.3 GPIO配置
需要配置的引脚包括：
- PA0：ADC输入通道0
- PB10：LED报警输出
- SPI引脚（连接OLED，根据具体模块定义）
3. 温度转换算法实现
3.1 NTC特性曲线建模
NTC的电阻-温度关系遵循Steinhart-Hart方程：
1/T = 1/T0 + (1/B) * ln(R/R0)其中：
- T：当前温度（开尔文）
- T0：参考温度（25℃=298.15K）
- R：当前电阻值
- R0：参考温度下的电阻（10KΩ）
- B：材料常数（3950）
3.2 ADC值到温度的转换流程
- 读取ADC原始值（0-4095）
- 计算电压值：Vadc = ADC_value * 3.3 / 4095
- 计算NTC电阻：Rntc = 10K * (3.3 - Vadc) / Vadc
- 使用Steinhart-Hart方程计算温度
float ConvertToTemperature(uint16_t adcValue) { float voltage = adcValue * 3.3f / 4095.0f; float resistance = 10000.0f * (3.3f - voltage) / voltage; float steinhart; steinhart = resistance / 10000.0f; // (R/R0) steinhart = log(steinhart); // ln(R/R0) steinhart /= 3950.0f; // 1/B * ln(R/R0) steinhart += 1.0f / 298.15f; // + (1/T0) steinhart = 1.0f / steinhart; // 倒数得到开尔文温度 steinhart -= 273.15f; // 转换为摄氏度 return steinhart; }注意：实际应用中可以在关键温度点进行校准，提高测量精度。
4. OLED显示与报警功能
4.1 SSD1306驱动实现
我们使用4线SPI方式驱动0.96寸OLED，关键配置如下：
// SPI配置结构体 hspi1.Instance = SPI1; hspi1.Init.Mode = SPI_MODE_MASTER; hspi1.Init.Direction = SPI_DIRECTION_2LINES; hspi1.Init.DataSize = SPI_DATASIZE_8BIT; hspi1.Init.CLKPolarity = SPI_POLARITY_LOW; hspi1.Init.CLKPhase = SPI_PHASE_1EDGE; hspi1.Init.NSS = SPI_NSS_SOFT; hspi1.Init.BaudRatePrescaler = SPI_BAUDRATEPRESCALER_8; hspi1.Init.FirstBit = SPI_FIRSTBIT_MSB; hspi1.Init.TIMode = SPI_TIMODE_DISABLE;4.2 显示界面设计
建议采用两行显示布局：
- 第一行：实时ADC值（用于调试）
- 第二行：当前温度值（保留1位小数）
char tempStr[16]; sprintf(tempStr, "Temp: %.1fC", currentTemp); OLED_ShowString(1, 1, "ADC:"); OLED_ShowNum(1, 5, adcValue, 4); OLED_ShowString(2, 1, tempStr);4.3 温度报警实现
当温度超过60℃时触发报警：
- LED开始闪烁（500ms间隔）
- 在OLED上显示警告标志
- 温度回落后自动恢复
if(currentTemp > 60.0f) { // 闪烁LED HAL_GPIO_TogglePin(GPIOB, GPIO_PIN_10); // 显示警告 OLED_ShowString(3, 1, "!OVER TEMP!"); HAL_Delay(500); } else { HAL_GPIO_WritePin(GPIOB, GPIO_PIN_10, GPIO_PIN_RESET); }5. 系统优化与误差处理
5.1 ADC采样优化技巧
为提高ADC精度，可以采取以下措施：
- 启用ADC的过采样功能（CubeMX中配置）
- 软件端实现滑动平均滤波
- 在稳定的电源环境下测量
#define SAMPLE_COUNT 16 uint16_t GetFilteredADC() { uint32_t sum = 0; for(int i=0; i<SAMPLE_COUNT; i++) { sum += HAL_ADC_GetValue(&hadc1); HAL_Delay(1); } return sum / SAMPLE_COUNT; }5.2 温度校准方法
实际应用中建议进行两点校准：
- 冰水混合物（0℃点）
- 沸水（100℃点，需考虑海拔修正）
校准流程：
- 将NTC置于已知温度环境
- 记录ADC读数
- 调整算法参数使显示值与实际值一致
5.3 防水处理方案
若用于液体测量，需考虑：
- 使用环氧树脂封装NTC头部
- 延长线采用硅胶线材
- 接头处做好防水密封
6. 完整项目代码结构
最终项目包含以下关键文件：
├── Core/ │ ├── Src/ │ │ ├── main.c # 主循环和报警逻辑 │ │ ├── adc.c # ADC采集处理 │ │ └── temperature.c # 温度转换算法 │ └── Inc/ # 对应头文件 ├── Drivers/ ├── SSD1306/ # OLED驱动 │ ├── oled.c │ └── oled_font.h └── STM32F103C8T6_FLASH.ld # 链接脚本关键函数调用关系：
main()中初始化各外设- 主循环中调用
GetFilteredADC()获取采样值 - 通过
ConvertToTemperature()计算温度 - 刷新OLED显示并检查报警条件
在项目开发过程中，我发现在ADC采样间隔加入短暂延时能显著提高稳定性，这可能与NTC的热响应时间有关。另外，使用硅胶套保护NTC探头后，在液体环境中的测量一致性提升了约30%。