README.md

💧 ESP8266 based AC 220V 50Hz Water Pump Controller

⚠️ 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.

📑 Table of Contents

• 🛠️ Hardware Requirements
• ✨ Features
• 📝 Setup Instructions
• 🔌 Connections
• ⚡ Safety Guidelines
• 📸 Gallery
• 📜 Version History
• ⚖️ License

🛠️ 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 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) 🎉

+ 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
     

   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

+ 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

🤝 Support

• 🐛 Report Issues
• 📢 Project Updates

---

Made with ❤️ by desiFish