Skip to content

Repository files navigation

LOTSE — Local Energy Coordination

Reducing transformer peaks through local coordination — respecting each household's individual pricing model.

An experimental open-source project exploring how residential loads — EV chargers, batteries, heat pumps, PV surplus — can be coordinated locally to reduce stress on low-voltage distribution grids. No energy trading between households, no cloud dependency, no billing. Each household keeps full control over its own devices and pricing.


Architecture

Each household:
Tasmota ──MQTT──► HA automation ──MQTT──► Heltec V3 (stock Meshtastic, mqtt ch+downlink)
│
▼ LoRa 868 MHz
all neighbors

Every node runs stock Meshtastic firmware with the mqtt channel enabled. Each Home Assistant publishes its own meter data into the LoRa mesh, and receives data from all neighbors. No custom firmware, no shared infrastructure, no single point of failure.


What you need (per household)

ComponentPurposeEst. cost
Heltec V3 (ESP32-S3 + SX1262 868 MHz)LoRa mesh node with MQTT downlink~€25
Tasmota IR readerSmart meter IR interface~€20
Home Assistant + MQTT brokerSends and receives mesh data
USB-C power supplyPowers the node€0

Getting started

  1. Configure your Heltec V3mesh-setup.md Flash stock Meshtastic, set up MQTT, create the mqtt channel, find your node number.

  2. Set up Home Assistantha-setup.md Import the sender blueprint, configure auto-discovery, install combined sensors, link the Energy Dashboard.

That's it. Each neighbor that does the same becomes visible automatically — no central server, no registration.


Key files

FilePurposeGroup
mesh-setup.mdHardware, flashing, Heltec V3 configSetup guides
ha-setup.mdFull HA integration guideSetup guides
sender-blueprint.yamlHA blueprint to send your data into the meshImport into HA
custom_components/lotse_forecast/Per-node sensors, combined aggregation, Energy DashboardIntegration (replaces all YAML files)
Requirements.mdRequirements, household typesReference
AGENTS.mdProject invariants for AI agentsReference

Repository structure

DirectoryContents
tests/Jinja template + Python sensor tests, schema checks, forecast validation
sender-blueprint.yamlSender automation blueprint (import into HA)
custom_components/lotse_forecast/HA integration (MQTT sub, per-node + combined sensors, dashboard, forecast)
config-hub/ESP-IDF project (Tasmota SML → MQTT → Meshtastic envelope)
archive/Legacy design docs, superseded specs, AI firmware reviews

Status

  • Phase 1 — Share meter data with neighbors ✅ working, start here
  • Phase 2 — Coordinated load shedding and flex offers ⏸️ deferred, no timeline

Contributing

Feedback from: low-voltage infrastructure, embedded systems, MQTT/LoRa, energy management, operational safety.


License

See LICENSE.


Disclaimer

Experimental research project. Not for production-critical infrastructure without proper validation.

About

Local grid-aware coordination for residential energy systems

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages