How to Build a Plant Disco Guardian with ESP32

What you'll build

This guide shows you how to build a Plant Disco Guardian -- an ESP32-based soil moisture monitor that alerts you when your plant is thirsty and runs a brief light and sound celebration when you water it. A capacitive soil moisture sensor continuously reads the hydration level. When it drops below a configurable threshold, a WS2812B LED ring glows red and the buzzer emits a periodic chirp. When you water the plant and moisture rises back above the threshold, the guardian runs a rainbow chasing animation and a short victory melody before returning to its calm idle glow.

The project teaches you how to read an analogue capacitive sensor on the ESP32's ADC, apply hysteresis-based threshold logic to avoid false triggers when moisture hovers near the boundary, and drive a 12-LED WS2812B ring through the FastLED library. The disco celebration sequence chains multiple animation patterns using non-blocking timers so the main loop stays responsive throughout.

When the build is complete you have a self-contained monitor that runs from any USB supply. The threshold constants are easy to tune for different soil types and pot sizes, and the code is structured so you can add new animation routines or extend it with Wi-Fi logging. If you want to explore more FastLED animation techniques, the gesture-controlled mood lamp builds on the same library with hand-wave interaction.

What you are building

This build has a specific scope. Knowing what is and is not included helps you decide whether to extend it later.

1. Read raw analogue moisture values from the Capacitive Soil Moisture Sensor on GPIO 34 and compare them against two configurable thresholds.
2. Drive the WS2812B LED Ring with a calm idle colour when moisture is normal, switch to a solid red alert when the soil is dry.
3. Sound a short periodic chirp on the Piezo Buzzer when the dry alert is active.
4. Trigger a rainbow chase animation and a short victory melody when moisture recovers above the wet threshold, running the celebration for DISCO_DURATION milliseconds before returning to idle.
5. Print moisture readings and state changes to Serial Monitor at 115200 baud for calibration and debugging.

Out of scope: Wi-Fi, push notifications, moisture data logging, multiple sensor support, and battery power management. These are reasonable extensions but are not part of this guide.

Upload and calibrate

Install libraries in the Arduino IDE Library Manager before opening the sketch:

• FastLED (by Daniel Garcia)

Pin and threshold constants are near the top of the sketch:

#define SOIL_PIN        34
#define LED_PIN          4
#define BUZZER_PIN      26
#define NUM_LEDS        12
#define DRY_THRESHOLD 2600   // above this value = dry alert
#define WET_THRESHOLD 2200   // below this value = watered, trigger disco
#define DISCO_DURATION 5000  // celebration length in milliseconds

The sensor produces lower ADC values in wet soil and higher values in dry soil. DRY_THRESHOLD and WET_THRESHOLD are starting points; calibrate them for your specific sensor and soil mix by watching the Serial Monitor readings with the probe in dry soil, then in freshly watered soil, and adjusting the constants to sit comfortably between those two readings.

Upload: select your ESP32 board and port, then click Upload. Open the Serial Monitor at 115200 baud.

Expected Serial Monitor output:

Plant Disco Guardian ready
Moisture: 2860  State: DRY
Moisture: 2820  State: DRY
Moisture: 1510  State: DISCO
Moisture: 1650  State: IDLE

After the "Plant Disco Guardian ready" message, readings appear once per second. This starter targets the common capacitive module polarity where dry soil reads high and wet soil reads low. Record both values for your exact sensor, then place DRY_THRESHOLD below the dry reading and WET_THRESHOLD above the wet reading while keeping a clear hysteresis gap.

Troubleshooting

• LED ring stays off or flickers randomly. Confirm the ring and 74AHCT125 use the regulated 5 V rail, all grounds are shared, and the 220 Ω resistor sits between 1Y and DIN.
• Moisture readings are stuck at 4095 or 0. GPIO 34 is not connected to the sensor SIG pin, or the sensor VCC is not powered. Verify all three sensor wires (VCC, GND, SIG) are seated firmly.
• Disco never triggers after watering. Measure the freshly watered value, then set WET_THRESHOLD about 50 counts above it while keeping it below DRY_THRESHOLD. The firmware triggers when the reading falls below this threshold.
• Dry alert triggers even with wet soil. Measure the dry-soil value, then set DRY_THRESHOLD about 50 counts below it while keeping it above WET_THRESHOLD. Do not derive the dry threshold from the wet reading.
• Buzzer makes no sound. GPIO 26 is not a PWM-capable pin on all ESP32 board variants. If you hear nothing, try moving the buzzer wire to GPIO 25 and updating BUZZER_PIN in the sketch.
• Serial Monitor shows garbled characters. The baud rate is not set to 115200. Change it in the Serial Monitor dropdown and press the reset button on the ESP32.

Going further

The most practical extension is replacing the single threshold chirp with a graduated alert. Because SOIL_PIN gives a continuous analogue value, you can map moisture level to LED colour on a gradient -- green for well-watered, yellow for borderline, red for dry -- without adding any hardware. The FastLED CHSV colour model makes this straightforward: map the raw ADC reading to a hue value and call fill_solid.

A second direction is adding Wi-Fi so the ESP32 posts readings to a home automation system whenever the state changes. The ESP32's built-in Wi-Fi can send an HTTP POST to Home Assistant, a simple MQTT broker, or a webhook in a few dozen lines alongside the existing sensor and LED code. Because the state machine is already cleanly separated in the sketch, the networking layer drops in without restructuring the core logic.