当前位置：首页 > news >正文

从入门到实践：基于STM32的Water Sensor水位监测系统搭建

news 2026/5/12 13:06:19

1. 认识你的硬件伙伴：Water Sensor模块详解

第一次接触水位监测项目时，我对着淘宝上五花八门的传感器模块犯了选择困难症。经过多次实测，这款40x60mm的平行导线式Water Sensor确实是最适合新手的入门选择。它的工作原理就像我们用手指触摸水面时感受到的湿润程度——导线接触水面积越大，导电性就越好，输出的模拟信号就越强。

技术参数方面有几个关键点需要注意：最大60mm的测量深度意味着它更适合小容器监测（比如我用来养多肉植物的自动浇水系统）。工作时只需要3-3.6V电压，但实际测试中发现5V供电时稳定性更好。记得我第一次接线时犯了个低级错误，把AO口接到了普通IO引脚，结果当然读取不到数据——这个模块必须连接带ADC功能的引脚！

模块背面有三个镀金排针：

红色线（VCC）：接3.3V或5V
黑色线（GND）：接地
黄色线（AO）：接STM32的ADC引脚

有个实用小技巧：用热熔胶把导线连接处密封，可以防止水汽腐蚀。去年夏天我就因为潮湿导致接触不良，折腾了一下午才找到问题所在。

2. 搭建STM32开发环境

推荐使用STM32CubeIDE这个免费工具，它就像乐高积木的说明书，帮我们自动生成基础代码。新建工程时选择STM32F103C8T6（也就是常说的"蓝 pill"开发板），配置时钟树时有个坑要注意：默认内部RC振荡器精度不够会导致ADC采样不准，建议启用外部8MHz晶振。

安装完开发环境后，我们需要三个关键驱动：

ADC采集驱动（读取传感器模拟量）
定时器驱动（实现周期性采样）
OLED显示驱动（我用的是SSD1306芯片的0.96寸屏）

这里分享一个我调试时发现的技巧：在CubeMX配置ADC时，把采样周期设置为239.5个时钟周期，这样既能保证精度又不会太慢。记得开启连续转换模式和DMA，可以减轻CPU负担。

// ADC初始化示例代码片段 void MX_ADC1_Init(void) { hadc1.Instance = ADC1; hadc1.Init.ScanConvMode = ADC_SCAN_DISABLE; hadc1.Init.ContinuousConvMode = ENABLE; hadc1.Init.DataAlign = ADC_DATAALIGN_RIGHT; hadc1.Init.NbrOfConversion = 1; if (HAL_ADC_Init(&hadc1) != HAL_OK) { Error_Handler(); } }

3. 水位数据的采集与处理

直接读取ADC原始值会面临两个问题：数值跳动大，以及非线性响应。我的解决方案是"软硬件组合拳"：

硬件方面：

在AO引脚和GND之间加个0.1uF电容
使用屏蔽线连接传感器
电源端并联100uF电解电容

软件方面采用三重滤波：

均值滤波：连续采样10次取平均
滑动窗口滤波：保留最近5次平均值再做平均
阈值滤波：忽视频繁跳变的异常值

// 改进版的水位计算函数 float Get_Water_Level(void) { static float history[5] = {0}; float sum = 0; // 采集10次样本 for(int i=0; i<10; i++){ sum += HAL_ADC_GetValue(&hadc1); HAL_Delay(5); } float current = (sum/10) * 3.3f / 4095.0f; // 转换为电压值 // 滑动窗口更新 for(int i=4; i>0; i--){ history[i] = history[i-1]; } history[0] = current; // 计算窗口平均值 float avg = 0; for(int i=0; i<5; i++){ avg += history[i]; } return avg / 5 * 100; // 转换为百分比 }

实际测试时发现，当水位接近满量程时灵敏度会下降。于是我在代码里加入了非线性补偿公式：水位 = 原始值 + 0.05*(原始值^2)，这样在80%-100%区间的测量精度提高了约30%。

4. OLED显示界面的优化设计

SSD1306屏幕虽然只有128x64分辨率，但通过精心设计可以呈现丰富信息。我的界面布局分为三个区域：

顶部状态栏：显示项目名称和电池图标（后期可扩展）
中部主显示区：用20x16大字体显示当前水位百分比
底部功能区：迷你柱状图和水位趋势箭头

void Update_Display(float level) { char buf[16]; // 清屏 SSD1306_Fill(0); // 绘制标题 SSD1306_GotoXY(0,0); SSD1306_Puts("水位监测", &Font_11x18, 1); // 显示数值 sprintf(buf, "%.1f%%", level); SSD1306_GotoXY(30,25); SSD1306_Puts(buf, &Font_16x26, 1); // 绘制水位条 int bar_width = (int)(120 * level / 100.0f); SSD1306_DrawRect(4, 55, 120, 8, 1); SSD1306_FillRect(4, 55, bar_width, 8); // 刷新屏幕 SSD1306_UpdateScreen(); }

有个显示优化的小技巧：在调用SSD1306_UpdateScreen()前，先对比显存内容，只更新有变化的区域。这样刷新率能从15FPS提升到30FPS，视觉效果更流畅。另外建议把显示刷新和水位采集放在不同定时器中断里，避免界面卡顿。

5. 项目进阶与实用化改造

完成基础功能后，我给它加了三个实用功能：

阈值报警：当水位低于20%时闪烁红灯并蜂鸣
数据记录：每隔1小时保存一次数据到EEPROM
蓝牙传输：通过HC-05模块发送数据到手机

电源管理也很关键。实测发现整套系统在5V/1A供电时：

常规模式下功耗约120mA
开启省电模式（每秒唤醒一次）后降至35mA
配合18650锂电池可连续工作约48小时

如果想做成防水版本，可以用AB胶密封电路板，传感器部分用硅胶套管保护。去年我给朋友做的鱼缸监测系统就是这样处理的，已经稳定运行8个多月。

6. 常见问题排查指南

遇到问题时可以按这个顺序检查：

电源问题：测量VCC和GND之间电压是否稳定
信号问题：用万用表检查AO引脚输出电压是否随水位变化
代码问题：先用简单测试程序验证ADC基本功能
显示问题：单独测试OLED是否正常

我遇到过最诡异的问题是传感器在潮湿环境下读数漂移，后来发现是杜邦线受潮导致阻抗变化。换成硅胶线并做防水处理后问题解决。另一个常见现象是水位为0时仍有小数值输出，这属于正常现象，可以在代码中设置死区阈值。

调试时这个串口打印函数很有用：

void Debug_Print(float level) { printf("ADC原始值: %d\r\n", HAL_ADC_GetValue(&hadc1)); printf("计算电压: %.2fV\r\n", level * 3.3f / 100.0f); printf("水位百分比: %.1f%%\r\n", level); }