STM32水质监测系统实战：PH/TDS/温度传感器集成与嵌入式开发详解

简介：本资源是一套基于STM32F103系列单片机开发的水质检测系统完整工程源码，面向嵌入式初学者、课程设计学生及毕业设计需求者，解决PH值、TDS（总溶解固体）与水温三项核心水质参数的实时采集、计算与显示问题，适用于环境监测类实践项目、电子信息类期末大作业及本科毕业设计。压缩包共337个文件，含46个C源文件（如stm32f10x_adc.c、stm32f10x_i2c.c等外设驱动）、72个头文件（h）、46个编译中间文件（o）及45个调试符号文件（crf），另有keilkilll.bat一键清理脚本、README.md使用说明、水质监测设计xin.pdf系统文档及附赠内容.zip扩展资料，整体大小为11.26MB。已有208人学习下载。用户可直接导入Keil MDK编译运行，获得包含硬件接口适配、传感器数据滤波算法、多参数动态刷新显示在内的完整可验证方案，并通过OBJ、SYSTEM、CORE等规范目录结构快速掌握STM32标准外设库工程组织逻辑。

1. 项目概述：从想法到实现，一个嵌入式工程师的水质监测实战

最近在整理过去的项目资料，翻到了一个挺有意思的毕业设计级别的作品——基于STM32的水质检测系统。这个项目当时是为了参加一个校内创新竞赛做的，核心目标很明确：用一块单片机，实时监测水体的PH值、TDS（总溶解固体）值和水温这三个关键参数。别看现在市面上各种智能水质检测笔、在线监测仪琳琅满目，但自己从头到尾搭一套系统，从传感器选型、电路设计、代码编写到数据校准，整个过程踩过的坑、获得的经验，远比直接买一个成品来得深刻。这个项目非常适合有一定STM32或51单片机基础，想挑战综合性应用开发的朋友，它涵盖了模拟信号采集、数字通信、数据滤波、人机交互等多个嵌入式开发的核心环节。今天，我就把这个项目的设计思路、源码核心解析以及那些“教科书上不会写”的实操细节，系统地分享出来，希望能给正在做类似课题或者想深入学习STM32的朋友一些实实在在的参考。

2. 系统整体设计与核心思路拆解

2.1 为什么选择STM32作为主控？

当时在做技术选型时，51单片机和STM32都在考虑范围内。51单片机（比如经典的STC89C52）简单易学，资源对于简单的逻辑控制绰绰有余。但在这个项目中，我们需要同时处理三路传感器信号：PH和TDS是模拟量，需要高精度的ADC（模数转换器）进行采集；水温传感器（如DS18B20）用的是单总线协议，需要精确的时序控制；此外，我们还需要一个界面来显示数据，可能用到LCD屏或OLED，这又涉及到SPI或I2C通信。如果使用51单片机，可能需要外挂ADC芯片（如PCF8591），并精心协调各个外设的中断和时序，代码复杂度和系统稳定性都会面临挑战。

而STM32，尤其是STM32F103系列（俗称“蓝桥杯”系列或“江科大”同款），其优势就非常明显了。它内置了多通道、12位精度的ADC，可以轻松地对多路模拟信号进行扫描采样，配合DMA（直接存储器访问）还能实现不占用CPU周期的后台数据搬运，极大地提高了效率。其丰富的外设（多个USART、SPI、I2C、定时器）为连接各类传感器和显示器提供了极大的便利。更重要的是，STM32的性能足够强大，我们可以有充裕的资源来实现更复杂的软件滤波算法（如中位值平均滤波法）来提升数据稳定性，甚至为未来添加无线传输模块（如ESP8266）预留空间。因此，选择STM32F103C8T6这类性价比极高的核心板，成为了自然而然的选择。

2.2 系统架构与工作流程

整个系统的架构可以清晰地分为感知层、控制层和交互层。

感知层：由三个关键传感器构成。

1. PH传感器：通常采用复合电极，其输出是一个与氢离子浓度相关的毫伏级模拟电压信号。这个信号非常微弱且易受干扰，因此前端必须搭配一个高输入阻抗、低漂移的运算放大器电路（信号调理电路）进行放大和阻抗匹配，将电压调整到STM32 ADC量程（通常是0-3.3V）内。
2. TDS传感器：其原理是通过测量水的电导率来间接反映溶解性固体总量。常见的TDS传感器模块输出有两种形式：一种是模拟电压，其电压值与电导率/ TDS值成比例；另一种是数字信号，模块内部已经做了校准和计算，通过串口直接输出TDS数值。为了降低单片机计算压力并提高精度，本项目采用了模拟输出型号，这样我们可以获取原始数据进行更灵活的软件处理。
3. 水温传感器：DS18B20是经典选择。它采用单总线协议，只需一根数据线即可与单片机通信，精度可达±0.5°C，且自带防水封装，非常适合本项目。

控制层：STM32单片机是绝对的核心。它的主要任务包括：

• 定时采集：通过定时器触发，循环采集三路传感器数据。
• 信号处理：对ADC采集的原始值进行软件滤波、标度变换（将电压值转换为实际的PH值、TDS值）。
• 协议解析：通过GPIO模拟单总线时序，读取DS18B20的温度数据。
• 逻辑控制与数据管理：管理整个测量流程，处理可能的异常数据（如传感器未连接）。

交互层：为了直观展示，我们使用了一块0.96英寸的OLED显示屏（SSD1306驱动，I2C接口），它功耗低、显示清晰。同时，预留了一个USART接口，可以将数据打印到电脑串口助手进行调试，或者未来连接Wi-Fi模块上传到云平台。

整个工作流程就是一个清晰的循环：上电初始化各外设→定时器到达采样周期→启动ADC采集PH和TDS电压→读取DS18B20温度→对ADC原始值进行滤波和换算→将PH值、TDS值、水温刷新到OLED屏幕→通过串口发送数据→进入低功耗休眠或等待下一个定时周期。

3. 硬件电路设计与核心细节解析

3.1 传感器接口电路设计要点

硬件设计的核心在于确保传感器信号能够被STM32稳定、准确地读取。

1. PH传感器接口电路：这是硬件设计中最需要小心对待的部分。PH电极输出的是高内阻的微弱电压信号（每PH变化约59.16mV @25°C）。直接接入STM32的ADC引脚是不可行的，输入阻抗不够会导致测量值严重失真。

• 方案选择：必须使用运放搭建一个电压跟随器或同相放大电路。电压跟随器能提供极高的输入阻抗和极低的输出阻抗，完美地起到隔离和缓冲作用。我选择的是TI的LMC6482，这是一款轨到轨输入输出的精密运放，工作电压在3.3V单电源下表现良好。
• 电路设计：PH电极的信号线接入运放的同相输入端，反相输入端与输出端短接，构成典型的电压跟随器。运放的输出再连接到STM32的ADC引脚。同时，在运放输入端和电源处，需要加入适当的去耦电容（如0.1uF和10uF并联），以抑制高频噪声。
• 注意事项：运放的供电必须干净、稳定。如果PCB空间允许，可以考虑为模拟部分（运放和PH传感器接口）使用独立的线性稳压器（如AMS1117-3.3）供电，并与数字部分（单片机核心）进行单点接地，以最大限度减少数字噪声对模拟信号的干扰。

2. TDS传感器接口电路：市面上常见的模拟输出TDS模块，其输出已经是经过初步调理的0-3.3V电压信号，通常可以直接连接到STM32的ADC引脚。但为了保险起见，最好在信号线上串联一个100欧姆左右的电阻，并并联一个0.1uF的电容到地，形成一个简单的RC低通滤波器，滤除可能的高频毛刺。

注意：不同厂家、不同量程的TDS模块，其输出电压与TDS值的对应关系（斜率）可能不同。务必查阅你所购买模块的数据手册，记录下其特性参数，用于后续软件校准。

3. DS18B20接口电路：DS18B20的电路非常简单。数据引脚（DQ）通过一个4.7KΩ的上拉电阻连接到3.3V电源，同时连接到STM32的一个GPIO引脚（需配置为开漏输出模式）。这个上拉电阻对于单总线通信的稳定性至关重要，绝对不能省略。

3.2 STM32最小系统与电源设计

• 最小系统：包括STM32F103C8T6芯片、8MHz晶振及两个负载电容（通常22pF）、复位电路（10K电阻和0.1uF电容）、Boot模式选择电路（10K下拉电阻）、以及3.3V稳压电路。使用现成的核心板可以省去这些麻烦。
• 电源设计：整个系统可以由一个5V/1A的USB口供电。5V电压一路给TDS传感器模块（多数模块需要5V供电），另一路通过AMS1117-3.3线性稳压芯片降至3.3V，为STM32、OLED、运放和DS18B20供电。务必在每颗芯片的电源引脚附近放置足够容量的滤波电容（如10uF电解电容并联0.1uF陶瓷电容）。

4. 软件实现与核心代码剖析

项目源码采用Keil MDK开发，基于标准外设库或HAL库均可。这里我以标准外设库为例，讲解几个最核心的模块。

4.1 ADC多通道扫描与DMA传输配置

为了同时采集PH和TDS两路模拟信号，我们配置ADC1工作在扫描模式，并使用DMA进行自动数据传输。这是提高采样效率的关键。

// ADC 与 DMA 初始化代码片段 void ADC1_DMA_Init(void) { ADC_InitTypeDef ADC_InitStructure; DMA_InitTypeDef DMA_InitStructure; GPIO_InitTypeDef GPIO_InitStructure; // 1. 开启时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_ADC1, ENABLE); RCC_AHBPeriphClockCmd(RCC_AHBPeriph_DMA1, ENABLE); // 2. 配置ADC通道对应的GPIO (PA1->PH, PA2->TDS) 为模拟输入 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_1 | GPIO_Pin_2; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AIN; GPIO_Init(GPIOA, &GPIO_InitStructure); // 3. 配置DMA DMA_DeInit(DMA1_Channel1); DMA_InitStructure.DMA_PeripheralBaseAddr = (uint32_t)&ADC1->DR; // 外设地址：ADC数据寄存器 DMA_InitStructure.DMA_MemoryBaseAddr = (uint32_t)ADC_ConvertedValue; // 内存地址：自定义数组 DMA_InitStructure.DMA_DIR = DMA_DIR_PeripheralSRC; // 方向：外设->内存 DMA_InitStructure.DMA_BufferSize = 2; // 传输数据量：2个通道 DMA_InitStructure.DMA_PeripheralInc = DMA_PeripheralInc_Disable; // 外设地址不递增 DMA_InitStructure.DMA_MemoryInc = DMA_MemoryInc_Enable; // 内存地址递增 DMA_InitStructure.DMA_PeripheralDataSize = DMA_PeripheralDataSize_HalfWord; DMA_InitStructure.DMA_MemoryDataSize = DMA_MemoryDataSize_HalfWord; DMA_InitStructure.DMA_Mode = DMA_Mode_Circular; // 循环模式 DMA_InitStructure.DMA_Priority = DMA_Priority_High; DMA_InitStructure.DMA_M2M = DMA_M2M_Disable; DMA_Init(DMA1_Channel1, &DMA_InitStructure); DMA_Cmd(DMA1_Channel1, ENABLE); // 4. 配置ADC ADC_InitStructure.ADC_Mode = ADC_Mode_Independent; ADC_InitStructure.ADC_ScanConvMode = ENABLE; // 扫描模式 ADC_InitStructure.ADC_ContinuousConvMode = ENABLE; // 连续转换 ADC_InitStructure.ADC_ExternalTrigConv = ADC_ExternalTrigConv_None; // 软件触发 ADC_InitStructure.ADC_DataAlign = ADC_DataAlign_Right; ADC_InitStructure.ADC_NbrOfChannel = 2; // 2个通道 ADC_Init(ADC1, &ADC_InitStructure); // 5. 配置ADC通道的采样顺序和周期 ADC_RegularChannelConfig(ADC1, ADC_Channel_1, 1, ADC_SampleTime_239Cycles5); // PA1, 通道1， 采样周期较长以提高精度 ADC_RegularChannelConfig(ADC1, ADC_Channel_2, 2, ADC_SampleTime_239Cycles5); // PA2, 通道2 // 6. 使能ADC的DMA请求 ADC_DMACmd(ADC1, ENABLE); // 7. 使能ADC ADC_Cmd(ADC1, ENABLE); // 8. 复位校准并开始校准 ADC_ResetCalibration(ADC1); while(ADC_GetResetCalibrationStatus(ADC1)); ADC_StartCalibration(ADC1); while(ADC_GetCalibrationStatus(ADC1)); // 9. 软件启动ADC转换 ADC_SoftwareStartConvCmd(ADC1, ENABLE); }

这段代码配置好后，ADC就会自动、连续地对通道1（PH）和通道2（TDS）进行转换，并将结果通过DMA自动存放到ADC_ConvertedValue这个数组中，完全无需CPU干预。我们只需要在主循环中定期去读取这个数组的值即可。

4.2 DS18B20单总线驱动实现

DS18B20的驱动关键在于精确的时序模拟。以下是一些核心函数：

// 单总线延时函数（需根据系统时钟微调） static void Delay_us(uint32_t n) { // 使用SysTick或简单的for循环实现微秒级延时 } // 复位DS18B20 uint8_t DS18B20_Reset(void) { uint8_t presence = 0; SET_DQ_OUT(); // 配置DQ引脚为输出 DQ_LOW(); // 拉低DQ Delay_us(480); // 保持480us以上 SET_DQ_IN(); // 配置DQ引脚为输入（释放总线） Delay_us(60); // 等待15-60us if (READ_DQ() == 0) presence = 1; // 检测到存在脉冲 Delay_us(480); // 等待存在周期结束 return presence; // 返回1表示设备存在 } // 写一个字节到DS18B20 void DS18B20_WriteByte(uint8_t dat) { uint8_t i; SET_DQ_OUT(); for (i=0; i<8; i++) { DQ_LOW(); Delay_us(2); // 拉低后尽快输出数据 if (dat & 0x01) DQ_HIGH(); // 写1 else DQ_LOW(); // 写0 Delay_us(60); // 保持60us DQ_HIGH(); // 释放总线 dat >>= 1; Delay_us(2); } } // 从DS18B20读取一个字节 uint8_t DS18B20_ReadByte(void) { uint8_t i, dat = 0; for (i=0; i<8; i++) { dat >>= 1; SET_DQ_OUT(); DQ_LOW(); Delay_us(2); // 拉低至少1us SET_DQ_IN(); // 释放总线，准备读取 Delay_us(8); // 等待15us内采样 if (READ_DQ()) dat |= 0x80; // 读取数据位 Delay_us(60); // 等待读时间隙结束 DQ_HIGH(); } return dat; } // 读取温度值 float DS18B20_ReadTemp(void) { uint8_t tempL, tempH; int16_t temp; float temperature; if (DS18B20_Reset() != 1) return -999; // 设备不存在 DS18B20_WriteByte(0xCC); // 跳过ROM命令 DS18B20_WriteByte(0x44); // 开始温度转换 Delay_ms(750); // 等待转换完成，12位精度需750ms if (DS18B20_Reset() != 1) return -999; DS18B20_WriteByte(0xCC); DS18B20_WriteByte(0xBE); // 读取暂存器 tempL = DS18B20_ReadByte(); tempH = DS18B20_ReadByte(); temp = (tempH << 8) | tempL; temperature = temp / 16.0; // 转换为摄氏度 return temperature; }

实操心得：DS18B20的时序要求非常严格，Delay_us函数的准确性至关重要。如果使用SysTick定时器来实现微秒延时，会比简单的for循环更精确。另外，总线上拉电阻的阻值（4.7KΩ）必须合适，过大会导致上升沿太慢，通信失败；过小则功耗增加。

4.3 数据滤波与标度变换算法

直接从ADC读取的原始值（0-4095对应0-3.3V）是充满噪声的，不能直接使用。

1. 软件滤波：我采用了“中位值平均滤波法”，又称防脉冲干扰平均滤波法。其原理是：连续采样N次（例如10次），去掉一个最大值和一个最小值，然后计算剩余N-2个数据的算术平均值。

#define FILTER_N 10 uint16_t Filter_ADC(uint16_t adc_channel_index) { // 假设通过索引区分通道 uint16_t i, j; uint32_t sum = 0; uint16_t buf[FILTER_N]; // 1. 连续采样N次 (这里需要根据通道索引从DMA数组对应位置取数，实际项目需连续触发采样) for(i=0; i<FILTER_N; i++) { buf[i] = ADC_GetValue(adc_channel_index); // 伪代码，获取一次ADC值 Delay_ms(5); // 间隔采样，避免相关性 } // 2. 冒泡排序 for(i=0; i<FILTER_N-1; i++) { for(j=0; j<FILTER_N-1-i; j++) { if(buf[j] > buf[j+1]) { uint16_t temp = buf[j]; buf[j] = buf[j+1]; buf[j+1] = temp; } } } // 3. 去掉首尾，求平均 for(i=1; i<FILTER_N-1; i++) { sum += buf[i]; } return (uint16_t)(sum / (FILTER_N-2)); }

这种方法能有效抑制偶然出现的脉冲干扰和周期性噪声，且计算量适中。

2. 标度变换：将滤波后的ADC值转换为实际的物理量。

• PH值计算：这是最复杂的一环，因为PH值与电压并非简单的线性关系，且受温度影响（能斯特方程）。一个实用的简化方法是两点校准法。

  1. 准备两种标准缓冲液（如PH4.01和PH6.86）。
  2. 将传感器依次放入两种溶液中，分别记录稳定的ADC读数，得到两点(ADC1, PH1)和(ADC2, PH2)。
  3. 在软件中，假设在测量范围内呈线性，计算斜率和截距：slope = (PH2 - PH1) / (ADC2 - ADC1);intercept = PH1 - slope * ADC1;
  4. 测量未知溶液时：PH_Value = slope * ADC_filtered + intercept;

  重要提示：为了更精确，可以引入温度补偿。DS18B20测得的温度值可以用于查找预存的温度补偿表（不同温度下，PH电极的理论斜率），对上述公式进行修正。这在要求高的场合是必须的。

• TDS值计算：

  1. 首先将ADC值转换为电压：Voltage = ADC_filtered * 3.3 / 4095.0。
  2. 根据你所使用的TDS模块手册，找到其转换系数。例如，某模块在25°C时，输出电压(V)与TDS值(ppm)的关系为：TDS = (Voltage * K)，其中K是一个常数（如 500）。
  3. 同样，TDS值也受水温影响。电导率随温度升高而增大。一个常见的补偿公式是将读数补偿到25°C标准温度：TDS_compensated = TDS_raw / (1.0 + 0.02 * (temperature - 25.0))其中0.02是温度补偿系数，不同溶液可能略有差异。

4.4 OLED显示与系统主循环

使用OLED显示，我们需要移植一个驱动库（如ssd1306.c/h）。在主循环中，我们以较低的频率（如1Hz）更新显示，避免屏幕闪烁和CPU占用过高。

int main(void) { // 系统初始化 System_Init(); // 时钟、延时等 ADC1_DMA_Init(); DS18B20_Init(); // GPIO初始化 OLED_Init(); OLED_Clear(); UART1_Init(115200); // 串口初始化用于调试 printf("Water Quality Detection System Start!\r\n"); while(1) { // 1. 读取温度 current_temp = DS18B20_ReadTemp(); if(current_temp < -100) { // 读取失败处理 OLED_ShowString(0, 0, "Temp:Err "); } else { sprintf(temp_str, "Temp:%4.1fC", current_temp); OLED_ShowString(0, 0, temp_str); } // 2. 获取滤波后的ADC值 (这里需要从全局数组读取DMA搬运的结果) // 假设经过定时滤波处理后，ph_adc_filtered和tds_adc_filtered已更新 ph_adc = Get_Filtered_PH_ADC(); tds_adc = Get_Filtered_TDS_ADC(); // 3. 计算PH和TDS ph_value = Calculate_PH(ph_adc, current_temp); // 传入温度用于补偿 tds_value = Calculate_TDS(tds_adc, current_temp); // 4. 显示 sprintf(ph_str, "PH :%5.2f", ph_value); sprintf(tds_str, "TDS:%4dppm", (int)tds_value); OLED_ShowString(0, 2, ph_str); OLED_ShowString(0, 4, tds_str); // 5. 串口输出，方便电脑记录 printf("Temp:%.1fC, PH:%.2f, TDS:%dppm\r\n", current_temp, ph_value, (int)tds_value); // 6. 延时，控制刷新率 Delay_ms(1000); // 1秒刷新一次 } }

5. 校准、调试与常见问题排查

5.1 传感器校准实战流程

校准是保证测量精度的灵魂，绝不能跳过。

PH传感器校准：

1. 准备：PH4.01、PH6.86（或PH9.18）标准缓冲液，洁净的烧杯，蒸馏水，纸巾。
2. 硬件连接：确保系统供电稳定，传感器与电路板连接可靠。
3. 软件准备：在代码中设置一个“校准模式”，通过串口发送指令进入。校准时，代码会记录当前ADC原始值。
4. 两点校准：
   • 将PH电极用蒸馏水冲洗干净，用纸巾轻轻吸干（勿擦拭敏感玻璃球）。
   • 放入PH6.86缓冲液中，轻轻搅拌，等待读数稳定（约30-60秒）。通过串口发送命令，记录此时ADC值为ADC_PH6_86。
   • 取出电极，用蒸馏水冲洗并吸干。
   • 放入PH4.01缓冲液中，同样操作，记录ADC_PH4_01。
5. 计算参数：根据前面提到的公式，在电脑端计算slope和intercept，然后将其定义为常量写入代码，或者设计一个机制（如存入STM32的Flash）让系统上电时读取。

TDS传感器校准：

1. 准备：已知电导率的标准溶液（如1413μS/cm的KCl溶液），或使用纯水（TDS≈0）作为零点参考。更简单的方法是使用一个已知TDS值的矿泉水进行粗略校准。
2. 步骤：将传感器探头浸入标准液中，等待稳定。记录此时的ADC值或计算出的TDS_raw值。
3. 计算系数：如果模块手册没有给出精确系数K，则通过公式K = TDS_standard / Voltage反推出K值，更新到代码中。

5.2 常见问题与解决方案速查表

在实际开发中，你几乎一定会遇到下面这些问题：

5.3 项目优化与扩展思路

这个基础项目完成后，还有很大的优化和扩展空间：

1. 数据存储与历史查询：可以加入SPI Flash或SD卡模块，定时将数据（带时间戳）存储为CSV文件，便于后期分析。这需要实现文件系统，如FatFs。
2. 无线传输与物联网：集成ESP8266或蓝牙模块（如HC-05）。通过AT指令或更底层的SPI/SDIO接口，将数据上传到云平台（如阿里云、OneNET）或发送到手机APP，实现远程监控。
3. 图形化界面：使用带GUI库的彩色屏幕（如TFT LCD），可以绘制PH、TDS、水温随时间变化的曲线图，直观展示水质变化趋势。
4. 报警功能：设置PH、TDS的上下限阈值，当数据超标时，通过蜂鸣器报警或LED闪烁提示，并通过无线模块发送报警信息。
5. 低功耗设计：对整个系统进行功耗规划。使用STM32的低功耗模式，间歇性唤醒测量；为传感器设计电源开关电路；选择低功耗的OLED屏（进入睡眠模式）。这样可以用电池供电，实现便携式或长期野外监测。

这个基于STM32的水质检测系统项目，麻雀虽小，五脏俱全。它串联了模拟电路设计、数字信号采集、传感器应用、嵌入式编程和数据处理等多个知识点。把每个环节吃透，尤其是校准和调试部分，你对嵌入式系统的理解会上一个实实在在的台阶。代码本身并不复杂，但背后的硬件稳定性设计、软件鲁棒性思考和解决问题的过程，才是这个项目最有价值的部分。希望这份详细的拆解，能帮你少走些弯路。

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