ESP32 terrarium controller

With this project you can control your terrarium's temperature, light, sprinkler and so on via webinterface.

Features

• Reads different Sensors for temperature and humidity (DHT22, SHT3x, DS1820, ...) and analog sensors to measure soil moisture etc.
• Timers for day/night light switch
• Actions if threshold for a sensor is reached e.g. to start sprinkler for 10s if humidity is under threshold
• Webinterface:
  • 24h log of temperature and humidity, actions etc.
  • control for buttons/actors and sliders for PWM pins
  • change config
• OTA update via WiFi

Webinterface

The webinterface has interactive controls to toggle relays or set PWM values to set the brightness of LEDs or fan speed.

A chart shows the measured temperatures (red) and humidity (blue) of your configured sensors and events (green) like time on, off and so on.

You can add sensors, actuators (relay, pwm), timers and thresholds in the 'settings' section.

Parts needed

• ESP32 dev board
• DHT22 / SHT31 / analog temperature and humidity sensor
• Relay or SSR board to control lights/pump
• MOSFET board to control LED brightness, fan speed etc. via PWM
• WiFi connection for time sync

The device creates an access point on first start. Then you can configure your WiFi and pin settings.

Caution

The WiFi password is saved without encryption on the device. Also OTA-update has default password "admin" at the moment. Change it if you want to secure your device for unauthorized updates.

Make the webinterface accessible from the internet is a very bad idea! Please use a VPN or something else to prevent a flooded terrarium ;-)

Installation

• Download / Clone this repository
• Install PlatformIO: https://docs.platformio.org/en/latest/ide/pioide.html
• Open this project in PlatformIO
• Connect your ESP32 via USB cable and upload sketch and filesystem
  • Run task -> Upload file system image
  • or run pio run -t uploadfs
  • Uploading filesystem will overwrite your settings!
• Reboot ESP32, it will create an AccessPoint with name ESP_xxxx
• Connect to the AP and open http://192.168.4.1 in Browser
• Connect to your WiFi network
• Setup pins, sensor and so on in the webinterface

Problems

• If PlatformIO can't find the libraries, switch to the cloned directory, open a terminal and type pio lib install. The command should download all necessary libraries.
• Windows users: if you get errors like error: 'timeinfo' has incomplete type just delete the Time.h header in .pio/libdeps/{ota,usb}/Time after installing the libs. The bug happens only on Windows because it's not case-sensitive and mixes the time.h header with Time.h of TimeLib library.

PCB

Prototype PCB with several new features:

• 12V supply voltage for board and PWM/switches
• Directly soldered ESP32 with 12V -> 5V -> 3V3 converter
• 4x SSR to switch 230V AC with one 230V AC input and 3-4x outputs (is this safe??)
• 4x MOSFETs for PWM with supply voltage (to set the brightness of a 12V LED strip or control the speed of a fan)
• Connect multiple sensors/displays/whatever via i2c bus
• Connect analog sensors

ToDo

• webinterface with authorization
• better instructions
• import/export config
• The current hardware setup is a mess with many jumper cables and so on. So I want to create PCB with relays/SSR, MOSFETS, power supply
• PID controller for heater/humidifier?
• PCB: switch from EAGLE to KiCAD (in progress...)
• PCB: replace the expensive 12V -> 5V step down (in progress...)