esp32.MeterMaster

OLED-Display-Node für MeterMaster — Zählerwerte aus ioBroker auf einem 64×48-Display. Steuerbar über Web-UI, iobroker.metermaster und optional sichtbar im ESP-Hub.

---

Überblick

Der MeterMaster ESP32 Node holt Zählerstände aus ioBroker und zeigt sie auf einem kleinen OLED. Er registriert sich beim MeterMaster-Adapter (Port 8089) für Config, Fernsteuerung und Carousel — und sendet zusätzlich einen Heartbeat an den ESP-Hub (Port 8093), damit das Gerät im zentralen ESP-Dashboard erscheint.

---

Features

• Zählerwerte live — via ioBroker Simple-API (Port 8087)
• 4 OLED-Stile — Standard, Groß, Minimal, Invertiert
• Carousel — bis zu 5 Zähler automatisch wechseln
• Alarm — LED-Blinken + OLED-Warnung bei Schwellwert
• MeterMaster-Adapter — Register, Config-Poll, cmd (LED, Zähler wechseln)
• ESP-Hub — zusätzliche Sichtbarkeit im ESP-Dashboard (ab v0.4.2)
• OTA — Browser-Upload oder GitHub-Release
• WiFiManager — Hotspot MeterMaster-Setup

---

Hardware

Komponente	Details
Mikrocontroller	ESP32 D1 Mini (WEMOS)
Display	0.66" OLED 64×48, SSD1306, I²C
SDA / SCL	GPIO 21 / 22
LED	GPIO 2 (active HIGH)

Referenzaufbau (D1 Mini + 0,66″ OLED)

Gesamtansicht	Display	Seitenansicht

Board (ohne Display)

---

Voraussetzungen

Library	Autor	Version
WiFiManager	tzapu	≥ 2.0.17
U8g2	olikraus	≥ 2.34
ArduinoJson	Blanchon	≥ 6.21

Board: WEMOS D1 MINI ESP32

Web-UI: web/index.html → python3 tools/pack_ui.py → src/web/UiPagesGz.h.
Build: gesamten Ordner mit arduino-cli und --build-property 'compiler.cpp.extra_flags=-Isrc'.

---

Quickstart

1. esp32.MeterMaster.ino flashen (oder vorkompilierte .bin, siehe unten)
2. Hotspot MeterMaster-Setup → WLAN konfigurieren
3. Web-UI: http://<ESP-IP>/
4. Einstellungen: ioBroker-Host, Simple-API (8087), Adapter (8089), ESP-Hub (8093)
5. Zähler laden oder State-ID manuell eingeben

---

Vorkompilierte Firmware

Schema: {name}.{version}.{family}.bin

Datei	Board
metermaster.0.5.0.esp32.bin	ESP32 / D1 Mini

---

Zwei ioBroker-Anbindungen

Adapter	Port	Aufgabe
iobroker.metermaster	8089	Node-Register, Config, cmd, Fernsteuerung
iobroker.esp-hub	8093	Dashboard-Sichtbarkeit, IO-Werte (optional, 0 = aus)

MeterMaster-Adapter (Pflicht für volle Funktion)

POST :8089/api/register          ← Heartbeat alle 60 s
GET  :8089/api/nodes/{MAC}/config ← Config-Poll alle 15 s

States: metermaster.0.nodes.<MAC>.*

ESP-Hub (optional, empfohlen)

POST :8093/api/register          ← Heartbeat alle 60 s

States: esp-hub.0.devices.<MAC>.* mit IO-Werten value, carousel, adapter

---

Web-Oberfläche

Tab	Inhalt
Dashboard	Zählerwert, Adapter- & Hub-Status
Einstellungen	ioBroker, Adapter, ESP-Hub, Zählerauswahl
Carousel	Mehrere Zähler rotieren
Alarm	Schwellwert + LED
OTA	Firmware-Update
Debug	Live-Log, Neustart

---

API (Auszug)

Endpunkt	Beschreibung
/api/status	Zählerwert, Adapter- & Hub-Status
/api/settings	GET/POST Einstellungen
/api/testadapter	MeterMaster-Adapter testen
/api/testhub	ESP-Hub testen
/api/carousel	Carousel konfigurieren

---

Lizenz

MIT © MPunktBPunkt — siehe LICENSE

Companion für MeterMaster App und iobroker.metermaster.