Thesada Documentation

Thesada is an open-source modular property monitoring platform built on ESP32 hardware with custom C++ firmware, MQTT over TLS, cellular fallback, and Lua scripting. Designed for rural and off-grid deployments where reliability matters.

What it does

  • Monitors - temperature (DS18B20), current (ADS1115 + CT clamp), battery voltage and charge state
  • Alerts - Lua-defined alert rules with sustain, cooldown, and hysteresis via MQTT, Telegram, or webhook
  • Displays - SSD1306 OLED or ILI9341 TFT touch (CYD board) with Lua-driven rendering
  • Logs - CSV data to SD card, logrotate included
  • Updates - over-the-air via HTTP push or pull (TLS-verified, SHA256 checked)
  • Scripted - Lua 5.3 runtime for custom rules and display rendering without recompiling

Where to start


Thesada - CERN-OHL-P-2.0 / GPL-3.0-only / CC BY 4.0

This site uses Just the Docs, a documentation theme for Jekyll.