{"id":14963825,"url":"https://github.com/desiFish/Water-Pump-Controller-V1","last_synced_at":"2025-08-17T09:32:51.408Z","repository":{"id":246799020,"uuid":"822221138","full_name":"KamadoTanjiro-beep/ESP8266-Water-Pump-Controller","owner":"KamadoTanjiro-beep","description":"Automatic water pump controller","archived":false,"fork":false,"pushed_at":"2024-06-30T16:26:10.000Z","size":23,"stargazers_count":1,"open_issues_count":7,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-17T12:08:14.980Z","etag":null,"topics":["esp8266","esp8266-arduino","float-sensor","iot","pump","relay","solid-state-relay","ssr","water-pump","water-tank"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KamadoTanjiro-beep.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-30T16:08:41.000Z","updated_at":"2024-07-06T02:14:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"e48aa66a-0763-4022-98be-8fe959cd69e9","html_url":"https://github.com/KamadoTanjiro-beep/ESP8266-Water-Pump-Controller","commit_stats":null,"previous_names":["kamadotanjiro-beep/water-pump-controller","kamadotanjiro-beep/esp8266-water-pump-controller"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KamadoTanjiro-beep%2FESP8266-Water-Pump-Controller","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KamadoTanjiro-beep%2FESP8266-Water-Pump-Controller/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KamadoTanjiro-beep%2FESP8266-Water-Pump-Controller/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KamadoTanjiro-beep%2FESP8266-Water-Pump-Controller/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KamadoTanjiro-beep","download_url":"https://codeload.github.com/KamadoTanjiro-beep/ESP8266-Water-Pump-Controller/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230113668,"owners_count":18175220,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["esp8266","esp8266-arduino","float-sensor","iot","pump","relay","solid-state-relay","ssr","water-pump","water-tank"],"created_at":"2024-09-24T13:32:11.565Z","updated_at":"2025-08-17T09:32:51.397Z","avatar_url":"https://github.com/KamadoTanjiro-beep.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 💧 ESP8266 based AC 220V 50Hz Water Pump Controller\n\n\u003cdiv align=\"center\"\u003e\n\n[![Status](https://img.shields.io/badge/status-active-success.svg)]()\n[![License](https://img.shields.io/github/license/desiFish/ESP8266-Water-Pump-Controller)](/LICENSE)\n[![GitHub Issues](https://img.shields.io/github/issues/desiFish/ESP8266-Water-Pump-Controller.svg)](https://github.com/desiFish/ESP8266-Water-Pump-Controller/issues)\n[![Release](https://img.shields.io/github/v/release/desiFish/ESP8266-Water-Pump-Controller)](https://github.com/desiFish/ESP8266-Water-Pump-Controller/releases)\n\n\u003c/div\u003e\n\n\u003e 🚀 **Looking for more features?** Check out the enhanced ESP32 version with advanced capabilities:\n\u003e [ESP32 Advanced Water Pump Controller](https://github.com/desiFish/ESP32-Advanced-Water-Pump-Controller)\n\n## ⚠️ SAFETY WARNING\n\u003e **DANGER**: This project involves high-voltage operations (AC 220V-240V) and high currents (5A-50A).\n\u003e \n\u003e ☠️ **Improper handling can be fatal. Professional electrical expertise is required.**\n\n## 🛠️ Hardware Requirements\n### Required Components\n1. 🔲 D1 Mini V2 NodeMcu 4M Bytes\n2. ⚡ Relay Options:\n   - **High-End**: SSR-100DA Solid State Relay (3-32VDC/24-380VAC 100A)\n   - **Budget**: 30A Mechanical Relay Module (NC Mode)\n   \u003e 💡 Note: Choose a relay with 10x higher current rating than your pump's normal current\n3. Piezo Electronic Buzzer (3v-24v)\n4. WS2812B RGB LED\n5. Push Button\n6. SAIER SEN-PPI35 Float Level Switch\n7. DC Jacks and wiring components\n\n### Optional Components (For Dual Tank Setup)\n- 2-way 3-pole Mini Toggle Switch\n- Additional DC Jack and wiring\n\n## 🚀 Setup Instructions\n\u003cdetails\u003e\n\u003csummary\u003e1. 🔧 Hardware Assembly\u003c/summary\u003e\n\n- Follow the [Connections](#connections) section for wiring\n- Ensure proper isolation between high and low voltage circuits\n- Install system in a waterproof enclosure\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e2. 💻 Software Setup\u003c/summary\u003e\n\n- Update WiFi credentials in code\n- Upload code via Arduino IDE\n- Test system with low voltage first\n\u003c/details\u003e\n\n## ✨ Features\n### Current Version (V1.0.2) 🎉\n```diff\n+ BC547 transistor integration for louder buzzer alerts\n+ WiFi/OTA activation via boot-time button press\n+ Pump toggle via button press during operation\n+ Improved safety features\n+ Hardware-based tank level monitoring\n```\n\n## 🔌 Connections\nProper schematics will be added soon.\n\nI can help describe the schematic connections based on the code. Here's a text-based representation of how the components should be connected:\n\n### ESP8266 (D1 Mini) Connections:\n\n1. **SSR (Connected to D4/GPIO4)** \n   - Signal pin to GPIO4 (D4)\n   - GND to GND \u003cbr\u003e\n   ```diff\n   If using Mechanical Relay (Connected to D4/GPIO4)\n   - Signal pin to GPIO4 (D4)\n   - VCC to 5V\n   - GND to GND\n   ```\n\n2. **Buzzer with BC547 (Connected to D5/GPIO5)**\n   - BC547 Base -\u003e 1K resistor -\u003e GPIO5 (D5)\n   - BC547 Collector -\u003e Buzzer negative\n   - BC547 Emitter -\u003e GND\n   - Buzzer positive -\u003e 5V\n\n3. **Push Button (Connected to D12/GPIO12)**\n   - One terminal to GPIO12 (D12)\n   - Other terminal to 3.3V\n   - 10K pull-down resistor between GPIO12 and GND\n\n4. **Float Sensor (Connected to A0)**\n   - Signal wire to A0\n   - VCC to 3.3V\n   - GND to GND\n\n5. **WS2812B RGB LED (Connected to D14/GPIO14)**\n   - DIN (Data In) to GPIO14 (D14)\n   - VCC to 3.3V\n   - GND to GND\n\n## ⚡ Safety Guidelines\n### 🚨 CRITICAL SAFETY REQUIREMENTS\n1. 👨‍🔧 Professional installation required for high-voltage connections\n2. 🔒 Use appropriate isolation between circuits\n3. 🛡️ Install proper fusing and circuit protection\n4. ❄️ Use heatsink for SSR installation\n5. 🔌 Use appropriately rated wiring\n6. 💧 Install system in waterproof enclosure\n7. 🔴 Add emergency cutoff switch\n8. ⚡ Regular maintenance checks required\n\n## 📸 Gallery\n\u003cp float=\"left\"\u003e\n  \u003cimg src=\"https://github.com/desiFish/ESP8266-Water-Pump-Controller/blob/main/resources/x1.jpg\" width=\"200\" height=\"267\" alt=\"Circuit Setup\" style=\"margin-right: 10px\"/\u003e\n  \u003cimg src=\"https://github.com/desiFish/ESP8266-Water-Pump-Controller/blob/main/resources/x2.jpg\" width=\"200\" height=\"267\" alt=\"Complete Setup\" style=\"margin-right: 10px\"/\u003e\n  \u003cimg src=\"https://github.com/desiFish/ESP8266-Water-Pump-Controller/blob/main/resources/x3.jpg\" width=\"200\" height=\"267\" alt=\"Description 3\" style=\"margin-right: 10px\"/\u003e\n  \u003cimg src=\"https://github.com/desiFish/ESP8266-Water-Pump-Controller/blob/main/resources/x4.jpg\" width=\"200\" height=\"267\" alt=\"Description 4\"/\u003e\n\u003c/p\u003e\n\u003cp float=\"left\" style=\"margin-top: 10px\"\u003e\n  \u003cimg src=\"https://github.com/desiFish/ESP8266-Water-Pump-Controller/blob/main/resources/x5.jpg\" width=\"200\" height=\"267\" alt=\"Description 5\" style=\"margin-right: 10px\"/\u003e\n  \u003cimg src=\"https://github.com/desiFish/ESP8266-Water-Pump-Controller/blob/main/resources/x6.jpg\" width=\"200\" height=\"267\" alt=\"Description 6\" style=\"margin-right: 10px\"/\u003e\n  \u003cimg src=\"https://github.com/desiFish/ESP8266-Water-Pump-Controller/blob/main/resources/x7.jpg\" width=\"200\" height=\"267\" alt=\"Description 7\" style=\"margin-right: 10px\"/\u003e\n  \u003cimg src=\"https://github.com/desiFish/ESP8266-Water-Pump-Controller/blob/main/resources/x8.jpg\" width=\"200\" height=\"267\" alt=\"Description 8\"/\u003e\n\u003c/p\u003e\n\n## 📜 Version History\n\u003cdetails\u003e\n\u003csummary\u003eView Version History\u003c/summary\u003e\n\n```diff\n+ V1.0.2 - Current stable release\n  - Removed music tone\n  - Added BC547 transistor circuit\n  - Added WiFi/OTA support\n  - Added pump toggle feature\n\n! V1.0.1 - Initial release\n  - Basic pump control\n  - Music ending tone\n```\n\u003c/details\u003e\n\n## ⚖️ License\nThis project is licensed under GNU GPL v3. You are free to:\n- 🔄 Use, modify, and distribute the code\n- 🔧 Use the code commercially\n- 📄 Patent use\n\nUnder the following conditions:\n- 📝 Source code must be made available when distributing\n- 📋 A copy of the license and copyright notice must be included\n- 🔄 Modifications must be released under the same license\n- 📜 Changes made to the code must be documented\n\n\u003e **⚠️ Disclaimer**: This is a DIY project involving high voltage electricity. \n\u003e - No warranty is provided\n\u003e - Use at your own risk\n\u003e - Not meant for 24/7 operation\n\u003e - Authors are not liable for any damages or injuries\n\nFor more details, see the [GNU GPL v3 License](https://www.gnu.org/licenses/gpl-3.0.en.html)\n\n## 🤝 Support\n- 🐛 [Report Issues](https://github.com/KamadoTanjiro-beep/Water-Pump-Controller/issues)\n- 📢 [Project Updates](https://github.com/desiFish/ESP8266-Water-Pump-Controller)\n\n---\n\u003cdiv align=\"center\"\u003e\nMade with ❤️ by \u003ca href=\"https://github.com/desiFish\"\u003edesiFish\u003c/a\u003e\n\u003c/div\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FdesiFish%2FWater-Pump-Controller-V1","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FdesiFish%2FWater-Pump-Controller-V1","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FdesiFish%2FWater-Pump-Controller-V1/lists"}