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 i0; i10; i){ sum HAL_ADC_GetValue(hadc1); HAL_Delay(5); } float current (sum/10) * 3.3f / 4095.0f; // 转换为电压值 // 滑动窗口更新 for(int i4; i0; i--){ history[i] history[i-1]; } history[0] current; // 计算窗口平均值 float avg 0; for(int i0; i5; 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); }7. 项目扩展思路这个基础框架可以衍生出很多实用变种智能花盆配合继电器控制水泵水塔监测增加GSM模块发送报警短信实验记录仪添加SD卡存储长期数据最近我正在尝试用两个传感器做差分测量消除水温变化对测量的影响。还在开发手机APP通过蓝牙实时查看历史曲线。这些扩展功能我都会持续更新在GitHub项目页面上。