SMA Energiezähler

Allgemeine Informationen

Der SMA Energy Meter Adapter empfängt die Multicast Datagramme des Energy-Meters bzw. des Sunny Home Managers. Diese senden jede Sekunde oder öfter Datenpakete mit ihren Messwerten ins Netzwerk. Das Sendeintervall von 200ms, 600ms oder 1000ms ist einstellbar im Sunny Portal.

Administration / Admin-Seite

adapter_admin_konfiguration

Reiter Multicast-Einstellungen
- Multicast IP: Standardmäßig eingestellt und von SMA vorgegeben ist die IP-Adresse 239.12.255.254.
- Multicast Port: Standardmäßig eingestellt und von SMA vorgegeben ist der UDP Port: 9522.
- Eigene Netzwerkschnittstellen-IPs: Ein Auswahlfeld, das alle verfügbaren Netzwerkschnittstellen-IPv4s auf dem ioBroker-Server anzeigt. Wählen Sie hier die Netzwerkschnittstellen-IP aus, auf der auf Multicasts gewartet werden soll.
- Ausgewählte Netzwerkschnittstellen-IP: Derzeit ausgewählte Netzwerkschnittstellen-IP, die auf Multicast-Nachrichten wartet. IP 0.0.0.0 bedeutet, dass der Adapter auf alle verfügbaren Netzwerkschnittstellen lauscht. Diese Einstellung wird nicht empfohlen, da sie in manchen Netzwerken zu Problemen führen kann.
- Energiezähler-IP: IP Adresse eines bestimmten Energiezählers. Wird diese eingegeben, werden die Daten nur dieses einen Energiezählers in einer Instanz des Adapters erfasst. Sind mehrere Energiezähler vorhanden, so können diese jeweils einzeln in weiteren Instanzen des Adapters konfiguriert werden. Vereinfacht wird dieses Verfahren über die ioBroker discovery, die die im Netzwerk erreichbaren SMA Energiezähler detektiert und die Erstellungen von einer Instanz je gefundenem Energiezähler anbietet. IP 0.0.0.0 wählt alle Energiezähler aus. Alle vorhandenen Energiezähler werden von einer Instanz des Adapters erfasst. Dies ist die Standardeinstellung und bietet die Kompatibilität mit früheren Versionen des Adapters.

adapter_admin_konfiguration2

Reiter Optionen
- Details L1 - L3: Über diese Auswahlpunkte können Details zu jeder einzelnen Phase angezeigt werden.
- Erweiterter Modus: Bietet detailiertere Information wie Blindleistung, Scheinleistung, cosphi, Spannungen, Stromstärke usw. Diese Einstellung ist standardmäßig deaktiviert.
- Echtzeit-Aktualisierungsintervall: Hier wird das Update-Intervall für Echzeitdaten wie z.B Momentanleistung oder Netzfrequenz eingestellt. Dies dient der Verminderung der Systemlast. Beispiel: Bei einer Datenpaktrate von 5/s (200ms Sendeintervall) werden während eines Echtzeit-Aktualisierungsintervalls von einer Sekunde alle Werte aufsummiert und erst am Ende des Intervalls der Mittelwert bzw. bei Frequenz und Phase der Median im entsprechenden ioBroker Datenpunkt aktualisiert.
- Nicht-Echtzeit-Aktualisierungsintervall: Hier wird das Update-Intervall für Nicht-Echzeitdaten wie z.B Zählerstände eingestellt. Hier wird erst am Ende des Intervalls der letzte empfangene Wert im entsprechenden ioBroker Datenpunkt aktualisiert.

Ordnerstruktur / Objekte

adapter_uebersicht

Nach Installation und Start des Adapters wird die auf dem Bild gezeigte Ordnerstruktur angelegt. Im Stammverzeichnis befinden sich die Gesamtdaten des Energy Meters. Sofern sie konfiguriert wurden, befinden sich in den Unterordnern L1-L3 jeweils die Werte der einzelnen Phasen.

Erklärung der Objekt-IDs

Die Buchstaben p, q und s und stehen für folgende Begriffe aus der Elektrotechnik:

P - Wirkleistung
Q - Blindleistung
S - Scheinleistung
Das Wort "regard" bedeutet hier soviel wie Netzbezug. (Strom, der vom Netz bezogen wird)
Das Wort "surplus" bedeutet Überschuss und hier soviel wie Netzeinspeisung. (Strom, der ins Netz eingespeist wird)
Das Wort "counter" bedeutet Zähler.

Daraus setzen sich die Objektnamen zusammen z.B.

pregard - Wirkleistung Netzbezug
psurplus - Wirkleistung Einspeisung
pregardcounter - Zähler der Wirkleistung Netzbezug
qregard - Blindleistung Netzbezug
...

Changelog

1.4.0 (2026-09-11) - 2026H2 maintenance release

(copilot) Adapter requires node.js >= 22 now
(pdbjjens) Fixed: i18n directory migrated to short format
(pdbjjens) Fixed: dependency updates and minor bugfixes

1.3.1 (2026-03-03) - 2026H1 maintenance release

(copilot) Adapter requires admin >= 7.7.22 now
(pdbjjens) Fixed: update release-script (#845)

1.3.1-alpha.0 (2025-10-21)

(pdbjjens) Fix: Add GitHub as npm Trusted Publisher
(pdbjjens) Change: Update dependencies
(pdbjjens) Change: Update npm badge

1.3.0 (2025-08-28) - 2025H2 maintenance release

(pdbjjens) Change: node>=20, js-controller>=7.0.7 and admin>=7.6.17 required
(pdbjjens) Fix: Correctly identify new SMA EMETER (#795)
(pdbjjens) Change: Cleanup devDependencies

1.2.0 (2025-01-31) - 2025H1 maintenance release

(pdbjjens) Change: Migration to ESLint 9
(simatec) Responsive Design added

License

The MIT License (MIT)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.