Entities & Dienste¶
Entities¶
Jeder Config Entry erzeugt ein Gerät. Die Entity-Namen nutzen den HA-Modus „has entity name“, der Gerätename wird in der UI vorangestellt.
Register-Sensoren¶
Ein Sensor pro Profil-Register mit entity: true und entweder basic: true
oder aktiver Pro-Lizenz. Das Entity-ID-Suffix ist der Registername, zum
Beispiel:
sensor.demo_energy_system_pv_powersensor.demo_energy_system_battery_socsensor.demo_energy_system_heat_pump_flow_temperature
Attribute folgen dem Profil: Einheit, Device Class, State Class und Precision.
Ein nicht dekodierbares Register wird unknown; ein fehlgeschlagener Poll
macht alle Register-Sensoren unavailable.
Diagnose- und Lizenz-Entities¶
| Entity | Typ | Bedeutung |
|---|---|---|
| Lizenzstatus | Sensor | trial, active, grace, expired oder free; Attribute enthalten Stufe, Features, Kunde, Ablauf und Resttage |
| Verbleibende Support-Zeit | Sensor | Restminuten der Support-Session, 0 wenn inaktiv |
| Support-Zugriff | Schalter | Startet und beendet eine Support-Session |
| Verbindung | Binary Sensor | Letzter Poll hat das Gerät erreicht; Attribute enthalten Transportstatistik |
Dienste¶
sg_energy_hub.activate_license¶
| Feld | Pflicht | Bedeutung |
|---|---|---|
license_blob |
ja | Signiertes Lizenzdokument |
Prüft Signatur und Instanzbindung, speichert die Lizenz und lädt alle Einträge neu.
sg_energy_hub.write_register¶
Erfordert eine aktive Pro-Lizenz und enable_write in den Optionen.
| Feld | Pflicht | Bedeutung |
|---|---|---|
entry_id |
nur bei mehreren Einträgen | Config Entry |
register |
eins von Register/Adresse | Registername aus dem Profil |
address |
eins von Register/Adresse | Rohe Registeradresse |
value |
ja | Messwert; Skalierung und Offset werden angewendet |
Nach erfolgreichem Schreiben aktualisiert der Coordinator sofort.
sg_energy_hub.start_support_session¶
| Feld | Pflicht | Bedeutung |
|---|---|---|
entry_id |
nur bei mehreren Einträgen | Config Entry |
duration_hours |
nein | 1–24, Standard aus den Optionen (4) |
sg_energy_hub.end_support_session¶
| Feld | Pflicht | Bedeutung |
|---|---|---|
entry_id |
nein | Ohne Angabe werden alle Sessions beendet |
sg_energy_hub.export_diagnostics¶
Gibt denselben redigierten Payload wie der HA-Diagnose-Download zurück.
| Feld | Pflicht | Bedeutung |
|---|---|---|
entry_id |
nein | Ohne Angabe werden alle Einträge exportiert |
service: sg_energy_hub.export_diagnostics
response_variable: diagnostics