energy-device-edge

Firmware v0.1.0 C MIT

Compact ESP32-C3 energy bridge for local monitoring, simple browser setup, and IAMMETER-compatible upload.

View on GitHub Docs →
energy-device-edge

energy-device-edge

energy-device-edge is an ESP-IDF firmware project that reads a supported energy source on the local network, normalizes the readings into the IAMMETER upload shape, and can forward that data to an IAMMETER-compatible destination.

The current firmware focuses on two source devices:

  • IAMMETER WEM3080T over Modbus TCP
  • Shelly Pro 3EM over Shelly local RPC HTTP

It is designed for simple deployment on the edge:

  • connect the device to Wi-Fi
  • point it at a supported local meter
  • optionally forward normalized data to IAMMETER Cloud or IAMMETER Local

Runtime Model

The firmware runs in two modes:

  • STA connected for normal polling, monitoring, and upload
  • SoftAP recovery when Wi-Fi is missing or unavailable

In recovery mode, the device starts a local provisioning hotspot and serves the control UI at 192.168.4.1, so the source, network, and destination settings can be corrected without reflashing the firmware.

Build And Provisioning

energy-device-edge is built with ESP-IDF and targets a lightweight embedded deployment.

Typical workflow:

idf.py build
idf.py -p PORT flash monitor

After the firmware starts:

  • if Wi-Fi is configured and available, the device joins the LAN and starts the local UI
  • if Wi-Fi is missing or cannot connect, it starts the energy_device_edge_xxxx provisioning hotspot

From the embedded UI you can:

  • save Wi-Fi independently from source settings
  • hot-apply source address and port changes
  • switch between IAMMETER Cloud, IAMMETER Local, or local-only mode
  • upload new firmware through OTA
  • restart or factory reset the device
← Back to our projects