Repolode
JGAguado

JGAguado/Smart_Plant

An ESP32-S2 plant sensor board that sits in the soil, measures moisture, light, temperature and humidity, and shows readings on an e-paper label.

Stars
303
Forks
26
Open issues
7
Last commit
11 days ago

What is it?

Smart Plant is a small board that is placed in a plant pot. It measures soil moisture, ambient light, air temperature and relative humidity, and displays the latest readings on a 2.9-inch e-paper screen that keeps its content while the device sleeps.

The firmware is built on ESPHome and can report readings to Home Assistant through the native ESPHome API or through retained MQTT messages. The device runs on battery, sleeps between measurement cycles, and supports an optional solar cell.

The companion Label-maker project generates printable plant labels and e-paper background images from JSON or YAML templates, so each plant can have its own name and illustration. The repository also includes board design files, enclosure models and documentation.

Key features

  • 01Measures soil moisture, light, air temperature and humidity.
  • 02Shows the latest readings on a 2.9-inch e-paper display.
  • 03Integrates with Home Assistant via ESPHome API or MQTT.
  • 04Sleeps between measurements for battery operation, with optional solar charging.
  • 05Custom plant labels generated by the companion Label-maker project.

Use cases

  • Monitoring soil moisture for houseplants or garden pots without manual checks.
  • Tracking plant light and temperature conditions in a Home Assistant dashboard.
  • Running several plant sensors across a home with retained MQTT readings.
  • Making personalized e-paper labels for each plant in a collection.

Quick start

  1. 1

    Get a board from the Elecrow store or use the hardware design files

  2. 2

    Follow the getting-started guide and ESPHome programming guide

  3. 3

    Set your Wi-Fi credentials, calibrate the soil sensor, and start from the standalone configuration

  4. 4

    Add your label background, then install the firmware

Things to know

  • Licensed CC BY-NC-SA 4.0, so commercial use is restricted.
  • Requires purchasing or building custom ESP32-S2 hardware with an e-paper display.
  • Setup involves Wi-Fi configuration, sensor calibration and firmware flashing.

In collections

Topics

#iot#esp32#esphome#home-assistant#e-paper#soil-moisture#smart-home#hardware

FAQ

What is Smart_Plant?
An ESP32-S2 plant sensor board that sits in the soil, measures moisture, light, temperature and humidity, and shows readings on an e-paper label. Smart Plant is a small board that is placed in a plant pot. It measures soil moisture, ambient light, air temperature and relative humidity, and displays the latest readings on a 2.9-inch e-paper screen that keeps its content while the device sleeps.
Is Smart_Plant free to use? What license does it have?
Smart_Plant is open source under the Other license. Check the license terms before using it in commercial products.
Is Smart_Plant still maintained?
Actively maintained. The last commit to Smart_Plant was on Oct 27, 2026.
What can I use Smart_Plant for?
Monitoring soil moisture for houseplants or garden pots without manual checks. Tracking plant light and temperature conditions in a Home Assistant dashboard. Running several plant sensors across a home with retained MQTT readings. Making personalized e-paper labels for each plant in a collection.
How do I install Smart_Plant?
Get a board from the Elecrow store or use the hardware design files Follow the getting-started guide and ESPHome programming guide Set your Wi-Fi credentials, calibrate the soil sensor, and start from the standalone configuration Add your label background, then install the firmware
Where can I get Smart_Plant?
The source code and installation instructions are on GitHub: https://github.com/JGAguado/Smart_Plant

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects