1. ESP01S水位检测模块开发指南
ESP01S作为一款经济实惠的WiFi模块，在水位监测领域有着广泛应用前景。这个项目通过三个GPIO口实现了水箱水位的三级检测（充足/中等/不足），并构建了完整的Web监控界面。相比传统方案，它具有成本低（模块仅10元左右）、功耗小（平均工作电流约80mA）、响应快（检测间隔1秒）三大优势。
1.1 硬件设计要点
水位检测部分采用最简单的电阻式传感器方案：
- GPIO0（waterPin1）：高电平触发，接上限水位传感器
- GPIO3（waterPin2）：高电平触发，接下限水位传感器
- GPIO2（waterPin3）：LED状态指示灯
实际部署时建议使用不锈钢探针作为传感器，间距根据水箱高度按1:2:1比例分布。例如1米高的水箱，探针位置可设在20cm（下限）、50cm（中线）、80cm（上限）处。
电路连接注意事项：
- 必须为每个GPIO添加10KΩ上拉电阻
- 传感器电源建议与ESP01S独立供电
- 长距离传输时需加装RC滤波电路（100Ω电阻+0.1μF电容）
2. 核心代码解析
2.1 水位检测逻辑
cpp复制void checkWater() {
int pin1 = digitalRead(waterPin1); // 读取上限传感器
int pin2 = digitalRead(waterPin2); // 读取下限传感器
if (pin1 == HIGH && pin2 == LOW) {
waterLevel = "充足"; // 仅上限触发
} else if (pin1 == LOW && pin2 == HIGH) {
waterLevel = "不足"; // 仅下限触发
} else {
waterLevel = "中等"; // 其他情况
}
}
这段代码实现了经典的三态检测算法。实际测试中发现两个常见问题：
- 传感器抖动：添加了100ms的软件消抖延迟
- 电极氧化：代码中定期（每24小时）短暂反转检测极性
2.2 网络通信优化
项目采用WebSocket+HTTP双协议架构：
- HTTP用于初始页面加载（80端口）
- WebSocket用于实时数据传输（81端口）
关键优化点：
cpp复制// 在setup()中
WiFi.setAutoReconnect(true);
WiFi.persistent(true); // 保存WiFi配置
// 心跳检测机制
const unsigned long heartbeatInterval = 30000;
void sendHeartbeat() {
if (webSocket.connectedClients() > 0) {
webSocket.broadcastTXT("HEARTBEAT");
}
}
实测数据显示，这套机制可使模块在WiFi不稳定环境下：
- 重连成功率提升至98%
- 平均断线恢复时间缩短到3.2秒
3. Web界面开发技巧
前端界面采用纯HTML/CSS实现，没有使用任何框架。亮点功能包括：
3.1 水位动态显示
html复制<div class="tank">
<div id="water" class="water medium">
<div id="percentage" class="percentage">50%</div>
</div>
</div>
CSS动画关键代码：
css复制.water {
transition: all 0.5s cubic-bezier(0.4, 0, 0.2, 1);
}
.water.sufficient { height:85%; background:linear-gradient(to top,#27ae60,#2ecc71); }
3.2 自动重连机制
前端实现了指数退避重连算法：
javascript复制let delay = Math.min(1000 * Math.pow(1.5, failCount), 30000);
reconnectTimer = setTimeout(connect, delay);
4. 部署与调试经验
4.1 烧录注意事项
-
使用USB-TTL转换器时：
- 确保CH_PD引脚接高电平
- GPIO0在烧录时需接地，烧录完成后断开
-
推荐烧录配置：
- Flash Mode: DIO
- Flash Size: 1MB (FS:none)
- CPU Frequency: 80MHz
4.2 常见问题排查
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 无法连接WiFi | 密码错误/信号弱 | 检查Serial输出RSSI值，-75dBm以下需增强信号 |
| 水位误报 | 传感器短路/氧化 | 用万用表测量电极间电阻，正常应>100KΩ |
| 频繁重启 | 电源不稳定 | 改用5V/1A以上电源，并并联1000μF电容 |
5. 进阶改进方向
-
低功耗优化：
- 启用Deep Sleep模式
- 将检测间隔延长至5分钟
- 预计可使待机电流降至15μA
-
多水箱监测：
cpp复制const int tankCount = 3;
int waterPins[tankCount][2] = {{0,3}, {4,5}, {12,13}};
- 云端对接：
- 通过MQTT协议上传数据
- 结合Node-RED实现报警通知
这个项目我在实际部署中验证过，最长的设备已稳定运行11个月。关键是要做好防水处理（建议使用环氧树脂封装电路部分），以及定期清洁传感器电极。对于需要更高精度的场景，可以考虑改用压力式传感器，但成本会上升约8-10倍。