pump_controller_web/README.md

Pump Controller ESP32

Web-Controlled Smart Pump System

_{⚙️ Main Dashboard   |   🛠️ Setup Wizard}

---

Features

• Web-based pressure monitoring
• OTA-ready & configurable via browser
• Auto-reset & fail-safe AP mode

---

🛠️ Build & Flash

Important

Requires ESP-IDF framework and just task runner

Connect your esp32 and run:

PORT="/dev/ttyUSB0" \
ESP_IDF="~/playground/esp-idf/"
just build flash

---

First-Time Setup

On first boot, the device creates a captive Wi-Fi access point:

• SSID: pumpcontroller
• IP: 192.168.4.1
• Port: 80

Steps:

1. Connect to pumpcontroller Wi-Fi
2. Open browser -> http://192.168.4.1
3. Enter your home Wi-Fi SSID + password
4. Device reboots → joins your network
5. Find its IP in your router's DHCP list

That IP becomes your pump control dashboard

Warning

If you enter wrong credentials, the device will not connect. You’ll need to factory reset and try again.

---

Factory Reset

1. Short pin D15 to GND
2. Power on the device
3. LED blinks 3 times 🔴🔴🔴
4. Remove the short after the 3rd blink
5. Device reboots → access point mode restored