Translation of this page via google translator
- Vorbemerkung
- Einleitung
- Installation
- Konfiguration
- Classic Portal
- Enneos Portal
- Detailinformationen / Fehlersuche
- FAQ
In diese Integration wurde sehr viel Zeit investiert. Insbesondere wenn ihr durch die Integration Stromkosten spart, würde ich mich freuen, wenn ihr euch in irgendeiner Form bedankt. Beispiele gibt es (hier)[https://littleyoda.github.io/].
Diese Lösung wurde und wird von mir ohne Unterstützung von SMA entwickelt. Die von SMA zur Verfügung gestellte Dokumentation ist seit 2017 unverändert (Stand Juli 2024). Tools, wie die XSD-Datei zur Überprüfung der XML-Dateien, sind veraltet und spiegeln nicht mehr den aktuellen Stand der Protokollimplementierung durch SMA wider. Die Spezifikation ist leider in einigen Punkten unklar und in meinen Augen an einigen Stellen unglücklich gestaltet. So erhält das Gateway (=HA-SMA-SEMP) keine Information vom SHM2, wenn Einträge oder Zeiten nicht akzeptiert werden oder für wann die Betriebszeit des Gerätes geplant ist.
HA-SMA-Semp ermöglicht die Einbindung beliebiger Geräte, die vom Home Assistant unterstützt werden, in das Sunny Portal von SMA mit Hilfe des Sunny Home Managers 2.0 ("SHM2"). Genutzt wird hierfür das SEMP-Protokoll.
Im einfachsten Fall kann der Verbrauch der Geräte an den SHM2 gemeldet werden, so dass der Stromverbrauch der Geräte im Portal angezeigt wird. Das Gerät wird durch den SHM2 aber nicht gesteuert.
Jede Farbe in diesem Diagramm steht für den Stromverbrauch eines anderen Gerätes. Das SEMP Proktoll unterstützt nur Verbraucher. Erzeuger können über diesen Weg nicht integriert werden.
Im komplexeren Fall kann das Energiemanagement die Geräte aktiv steuern. Dazu wird z.B. festgelegt, wie lange das Gerät pro Tag laufen soll. Das SHM 2 schaltet das Gerät dann aktiv ein und aus, um das Gerät mit möglichst viel PV-Strom zu versorgen.
Unterschieden werden hierbei Geräte, die bei ihrer Arbeit unterbrochen werden dürfen (z.B. Wasserpumpen) und Geräte, die durchlaufen müssen.
Für mehr Informationen bzgl. SEMP und Geräteverwaltung sei auf die Kapitel 11 (Gerätevewrwaltung) und 13 (Visualisierung des Energiemanagements) in der SHM 2.0 Anleitung verwiesen.
Die einfachste Installation erfolgt mit Hilfe von HACS.
Dazu muss HACS bereits installiert sein.
Folgende Schritte sind notwendig:
- Hinzufügen der Integration:
- Anschließend auf Download klicken und den Download bestätigen
- Nach dem Download der Integration muss Home Assistant zwingend neugestartet werden:
Drei Möglichkeiten stehen anschließend zur Auswahl:
| Basiskonfiguration "report only" Stromverbrauch an Sunny Portal melden |
|
|---|---|
| Name Name des Gerätes Sensor Sensor für Stromverbrauch (Einheit W oder kW) oder Helfer-Entitiy vom Type Nummer Device Type Gerätetype ID Global eindeutiger Identifizierer Max Power Consumption Maximaler Verbrauch laut Typenschild |
 |
| Erweitere Konfiguration "Non-Interruptible" Geräte durch SHM2 steuern lassen |
|
|---|---|
| Min Power Consumption Minimaler Verbrauch laut Typenschild Minimum/Maximum running time Minimale und Maximale Laufzeit Calendar Kalender dessen Einträge mögliche Zeitfenster definiert, in den das Gerät gemäß der vorgebene Laufzeiten ein- und ausgeschaltet werden kann. On/Off switch Switch oder Helfer-Entitiy vom Type Schalter |
 |
| Erweitere Konfiguration "Interruptible" Unterbrechbare Geräte durch SHM2 steuern lassen |
|
|---|---|
| Min On Time Wie lange das Gerät mindestens eingeschaltet sein muss, bevor es wieder ausgeschaltet werden darf. Min Off Time Wie lange das Gerät mindestens ausgeschaltet sein muss, beovr es eingeschaltet werden darf. |
 |
Die Kalendereinträge werden verwendet, um dem Energiemanagementsystem (SHM2) mitzuteilen, in welchem Zeitraum die Geräte grundsätzlich laufen dürfen. Mit „Minimum running time“ und „Maximum running time“ wird festgelegt, wie lange die Geräte mindestens bzw. maximal in diesen Zeiträumen laufen dürfen.
Die Kalendereinträge werden den einzelnen Geräten über den Titel zugeordnet. Der Titel der Kalendereinträge muss somit mit dem Gerätenamen übereinstimmen.
Beispiel: Durch den Kalendereintrag wird festgelegt, dass die Pumpe grundsätzlich zwischen 8:00 und 18:00 Uhr laufen darf. Durch „Minimale Laufzeit: 4 h“ und „Maximale Laufzeit: 6 h“ wird festgelegt, dass die Pumpe mindestens 4 Stunden lang zwischen 8:00 und 18:00 Uhr laufen soll. Bei ausreichendem PV-Überschuss kann die Pumpe bis zu zwei weitere Stunden, also insgesamt maximal 6 Stunden zwischen 8:00 und 18:00 Uhr, laufen.
Nachdem die Geräte in Home Assitant angelegt wurden, müssen sie dem Sunny Portal hinzugefügt werden.
Einige Zeit (bis zu 15 min) nach der Anlage in Home Assistant werden die neue Geräte unter Anlagenüberwachung angezeigt.
TODO
Für die verlinkte URL, können zusätzliche Informationen zur Fehlersuche aufgerufen werden:
Neben der Information, ob der SHM 2.0 die Daten abruft, ist erkennbar, welche Daten an den SHM 2.0 gemeldet wurden und ob der SHM 2.0 Steuerbefehle gesendet hat.
Die Seite kann auch direkt über die URL <hostname/ip>/sempinfo/ aufgerufen werden.
In den Attributen der Status-Sensoren sind noch weitere Informationen hinterlegt:
- welche Zeiträume im Kalendar für dieses Gerät gefunden wurde
- ob und wenn ja, wie lange, dass Gerät im aktuellen Zeitfenster bereits eingeschalten war
- Protokoll, wann das Gerät ein- und ausgeschaltet wurde
Für eine bessere Übersicht empfehle ich ein Dialog mit Hilfe von Lovelance Auto Entities zu erstellen, der alle Sensoren der Integration anzeigt:
- type: custom:auto-entities
card:
type: entities
state_color: true
filter:
include:
- device_model: SMA Semp Adapter
exclude: []
sort:
method: friendly_name
TODO
Home Assitent und SHM2 müssen sich im gleichen Subnetz befinden, damit eine Kommunikation funktioniert.
Alle Geräte, die dem Sunny Home Manager von HA-SMA-Semp zur Verfügung gestellt werden, gelten als schaltbare Geräte. Der Sunny Home Manager 2.0 unterstützt insgesamt maximal 12 aktiv schaltbare Geräte
Der Funktionsumfang von HA-SMA-Semp ist vergleichbar mit SMA Semp Adapter für ioBroker oder Addon für Openhab.
Mit dem Smart Appliance Enabler (SAE) existiert bereits eine sehr umfassende Lösung, die unabhängig von einem Home Automation System Geräte steuern und den Verbrauch an das Sunny Portal melden kann.
Während SAE verschiedene Schnittstellen implementiert, um auf die Geräte zuzugreifen oder das Ein- und Ausschaltsignal zu melden, nutzt HA-SMA-SEMP hier die Funktionalität des Home Assistant. HA-SmaSemp kann praktisch jedes Gerät nutzen, das über einen Sensor seinen Verbrauch melden kann oder über Home Assistant ein- und ausgeschaltet werden kann.
Derzeit können Wallboxen nur ein- und ausgeschaltet werden. Die zusätzlichen Funktionen des SEMP-Protokolls für Wallboxen werden derzeit noch nicht unterstützt.
Mehr Informationen über das SEMP-Protokoll kann auf der SMA Webseite nachgelesen werden.