Loxone Miniserver¶
Der WattWächter Plus lässt sich über seinen Modbus-TCP-Server in Loxone einbinden. Loxone Config hat keine SunSpec-Auto-Discovery — anders als z.B. Home Assistant oder evcc liest der Miniserver den SunSpec-Header nicht selbsttätig ein. Die Register müssen manuell angelegt werden.
Voraussetzungen¶
- WattWächter Plus mit Firmware 1.1.0 oder neuer
- Modbus TCP am WattWächter aktiviert — siehe Modbus TCP → Aktivieren
- Loxone Miniserver (Gen 1 mit Modbus Extension oder Gen 2) im selben Netzwerk
Schritt 1 — Modbus-Server in Loxone Config anlegen¶
- Peripheriegerät hinzufügen → Modbus Server
- IP-Adresse des WattWächters und Port 502 eintragen
- Slave-ID auf
1setzen - Abfrageintervall nach Bedarf (z.B. 5–10 s)
Schritt 2 — Register manuell anlegen¶
Lege für jeden gewünschten Wert einen Modbus-Sensor unter dem Modbus-Server an. Die wichtigsten Register:
| Wert | Adresse | Anzahl | Datentyp | Skalierung (SF-Register) |
|---|---|---|---|---|
| Gesamtwirkleistung | 40088 | 1 | int16 (signed!) | 40092 (W_SF) |
| Wirkleistung L1 / L2 / L3 | 40089 / 40090 / 40091 | 1 | int16 | 40092 (W_SF) |
| Strom L1 / L2 / L3 | 40073 / 40074 / 40075 | 1 | int16 | 40076 (A_SF) |
| Spannung L1 / L2 / L3 | 40078 / 40079 / 40080 | 1 | int16 | 40085 (V_SF) |
| Frequenz | 40086 | 1 | int16 | 40087 (Hz_SF) |
| Bezug gesamt | 40116 | 2 | uint32 (acc32) | 40124 (TotWh_SF) |
| Einspeisung gesamt | 40108 | 2 | uint32 (acc32) | 40124 (TotWh_SF) |
Die vollständige Register-Map (alle SunSpec-Felder, Datentypen, OBIS-Codes) findest du in der Modbus-TCP-Referenz.
Für jeden Wert in Loxone:
- Skalierungsfaktor als eigenen Sensor einlesen und per Formel-/Status-Baustein anwenden:
Wert = Rohwert × 10^SF. Die SF-Register sind in der Praxis stabil — du kannst sie auch einmalig auslesen und als Konstante hardcoden, um eine Berechnung zu sparen. - Sentinel-Filter: Werte ≤ −32000 sind das SunSpec-
0x8000(not implemented). Filtere sie per Status-Baustein heraus, sonst zeigt Loxone falsche Werte für Felder, die dein Zähler nicht liefert. Welche Felder valide sind, siehst du am Status-Endpunkt.
Schritt 3 — Bezug und Einspeisung trennen¶
Die Gesamtleistung W (40088) ist vorzeichenbehaftet: positiv bei Bezug, negativ bei Einspeisung. Für den Loxone-Energiemonitor zerlegst du den Wert per Status-Baustein in zwei Größen:
- Bezug =
MAX(W, 0) - Einspeisung =
MAX(-W, 0)
Die Energie-Zählerstände TotWhImp (Bezug) und TotWhExp (Einspeisung) liegen ohnehin in getrennten Registern — die kannst du direkt verdrahten.
Welche Register liefert mein Zähler?
Der WattWächter füllt W, TotWhImp und TotWhExp immer mit gültigen Werten (bei fehlenden Daten mit 0), damit Loxone das Gerät als gültigen Zähler akzeptiert. Phasenwerte und Frequenz sind nur befüllt, wenn dein Zähler die zugehörigen OBIS-Codes liefert. Eine Live-Übersicht liefert /api/v1/modbus/status.