Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/desifish/esp8266-water-pump-controller
Automatic water pump controller
https://github.com/desifish/esp8266-water-pump-controller
arduino-ide automatic-water-pump-controller automation d1-mini esp8266 esp8266-arduino float-sensor iot pump relay solid-state-relay ssr water-pump water-tank ws2812b
Last synced: 11 days ago
JSON representation
Automatic water pump controller
- Host: GitHub
- URL: https://github.com/desifish/esp8266-water-pump-controller
- Owner: desiFish
- License: gpl-3.0
- Created: 2024-06-30T16:08:41.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-01-12T16:46:12.000Z (21 days ago)
- Last Synced: 2025-01-12T17:35:46.720Z (21 days ago)
- Topics: arduino-ide, automatic-water-pump-controller, automation, d1-mini, esp8266, esp8266-arduino, float-sensor, iot, pump, relay, solid-state-relay, ssr, water-pump, water-tank, ws2812b
- Language: C++
- Homepage: https://iotthings.pythonanywhere.com/projects
- Size: 9.4 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 💧 ESP8266 based AC 220V 50Hz Water Pump Controller
[]()
[](/LICENSE)
[](https://github.com/desiFish/ESP8266-Water-Pump-Controller/issues)
[](https://github.com/desiFish/ESP8266-Water-Pump-Controller/releases)
## ⚠️ SAFETY WARNING
> **DANGER**: This project involves high-voltage operations (AC 220V-240V) and high currents (5A-50A).
>
> ☠️ **Improper handling can be fatal. Professional electrical expertise is required.**
## 🛠️ Hardware Requirements
### Required Components
1. 🔲 D1 Mini V2 NodeMcu 4M Bytes
2. ⚡ Relay Options:
- **High-End**: SSR-100DA Solid State Relay (3-32VDC/24-380VAC 100A)
- **Budget**: 30A Mechanical Relay Module (NC Mode)
> 💡 Note: Choose a relay with 10x higher current rating than your pump's normal current
3. Piezo Electronic Buzzer (3v-24v)
4. WS2812B RGB LED
5. Push Button
6. SAIER SEN-PPI35 Float Level Switch
7. DC Jacks and wiring components
### Optional Components (For Dual Tank Setup)
- 2-way 3-pole Mini Toggle Switch
- Additional DC Jack and wiring
## 🚀 Setup Instructions
1. 🔧 Hardware Assembly
- Follow the [Connections](#connections) section for wiring
- Ensure proper isolation between high and low voltage circuits
- Install system in a waterproof enclosure
2. 💻 Software Setup
- Update WiFi credentials in code
- Upload code via Arduino IDE
- Test system with low voltage first
## ✨ Features
### Current Version (V1.0.2) 🎉
```diff
+ BC547 transistor integration for louder buzzer alerts
+ WiFi/OTA activation via boot-time button press
+ Pump toggle via button press during operation
+ Improved safety features
+ Hardware-based tank level monitoring
```
## 🔌 Connections
Proper schematics will be added soon.
I can help describe the schematic connections based on the code. Here's a text-based representation of how the components should be connected:
### ESP8266 (D1 Mini) Connections:
1. **SSR (Connected to D4/GPIO4)**
- Signal pin to GPIO4 (D4)
- GND to GND
```diff
If using Mechanical Relay (Connected to D4/GPIO4)
- Signal pin to GPIO4 (D4)
- VCC to 5V
- GND to GND
```
2. **Buzzer with BC547 (Connected to D5/GPIO5)**
- BC547 Base -> 1K resistor -> GPIO5 (D5)
- BC547 Collector -> Buzzer negative
- BC547 Emitter -> GND
- Buzzer positive -> 5V
3. **Push Button (Connected to D12/GPIO12)**
- One terminal to GPIO12 (D12)
- Other terminal to 3.3V
- 10K pull-down resistor between GPIO12 and GND
4. **Float Sensor (Connected to A0)**
- Signal wire to A0
- VCC to 3.3V
- GND to GND
5. **WS2812B RGB LED (Connected to D14/GPIO14)**
- DIN (Data In) to GPIO14 (D14)
- VCC to 3.3V
- GND to GND
## ⚡ Safety Guidelines
### 🚨 CRITICAL SAFETY REQUIREMENTS
1. 👨🔧 Professional installation required for high-voltage connections
2. 🔒 Use appropriate isolation between circuits
3. 🛡️ Install proper fusing and circuit protection
4. ❄️ Use heatsink for SSR installation
5. 🔌 Use appropriately rated wiring
6. 💧 Install system in waterproof enclosure
7. 🔴 Add emergency cutoff switch
8. ⚡ Regular maintenance checks required
## 📸 Gallery
## 📜 Version History
View Version History
```diff
+ V1.0.2 - Current stable release
- Removed music tone
- Added BC547 transistor circuit
- Added WiFi/OTA support
- Added pump toggle feature
! V1.0.1 - Initial release
- Basic pump control
- Music ending tone
```
## ⚖️ License
This project is licensed under GNU GPL v3. You are free to:
- 🔄 Use, modify, and distribute the code
- 🔧 Use the code commercially
- 📄 Patent use
Under the following conditions:
- 📝 Source code must be made available when distributing
- 📋 A copy of the license and copyright notice must be included
- 🔄 Modifications must be released under the same license
- 📜 Changes made to the code must be documented
> **⚠️ Disclaimer**: This is a DIY project involving high voltage electricity.
> - No warranty is provided
> - Use at your own risk
> - Not meant for 24/7 operation
> - Authors are not liable for any damages or injuries
For more details, see the [GNU GPL v3 License](https://www.gnu.org/licenses/gpl-3.0.en.html)
## 🤝 Support
- 🐛 [Report Issues](https://github.com/KamadoTanjiro-beep/Water-Pump-Controller/issues)
- 📢 [Project Updates](https://github.com/desiFish/ESP8266-Water-Pump-Controller)
---