VoltWise

An Open Source Energy Monitoring System using Raspberry Pis and PZEM-004T sensors.

This repository is divided into two parts:

1. Sensor Node

The software that runs on the Raspberry Pi.

• Connects to PZEM-004T sensors.
• Provides a local web dashboard at http://<pi-ip>:25500 with Settings (device name, timezone, Wi‑Fi profiles).

>> Go to Sensor Node Documentation

Fertiges SD-Image (nur flashen): Offizielle Builds für echtes Messen gibt es unter Releases (VoltWise-Node-RaspberryPi-…, aus dem Release-Workflow mit Tag v*). Details: docs/IMAGE_BUILD.md. Lokal bauen: tools/image-build/build-image.sh. Der manuelle Workflow „Build SD image“ legt nur Actions-Artefakte ab (kein Release). Demo-/Test-Images (ohne PZEM, synthetische Daten) sind dort nur bei aktivierter Demo-Option, kurz gültig und nicht als stabiler Download gedacht.

2. Central Dashboard

(Optional) A central server to monitor multiple sensor nodes.

• runs on PC/Mac/Linux.
• Aggregates data from multiple Pis.
• Download Central (Windows / Linux / macOS — siehe Release-Assets)

Updates: Node und Central vergleichen beim Start die Versionsnummer (VERSION / Release-Tag) mit dem neuesten GitHub Release und können im Dashboard darauf hinweisen.

Versionierte Komplett-Releases (Node SD-Image + Central): Tag v* pushen → Workflow „Release (Node SD + Central)“.

• Note for Mac Users: If you see a security warning, please Right-Click -> Open.

---

Quick Start (Raspberry Pi)

A) Fertig-Image (empfohlen für Einsatz vor Ort)

1. Image bauen (Docker): ./tools/image-build/build-image.sh → Datei unter dist/.
2. Mit Raspberry Pi Imager auf die SD schreiben; im Imager WLAN/SSH/Benutzer setzen (Erstinstallation braucht Internet).
3. Pi starten; nach ein paar Minuten Dashboard: http://<pi-ip>:25500.

Details: docs/IMAGE_BUILD.md.

B) Manuell (Repository auf dem Pi)

1. Clone this repository:

   git clone https://github.com/EvilMonkey09/voltwise.git

2. Enter the sensor directory:

   cd voltwise/sensor-node

3. Run the installer:

   sudo ./install.sh