https://github.com/littleyoda/ha-pysmaplus
home assistant custom integration for pysma-plus
https://github.com/littleyoda/ha-pysmaplus
ennexos homeassistant inverter sma speedwire
Last synced: 3 months ago
JSON representation
home assistant custom integration for pysma-plus
- Host: GitHub
- URL: https://github.com/littleyoda/ha-pysmaplus
- Owner: littleyoda
- Created: 2024-03-30T20:12:58.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-12-10T15:25:57.000Z (6 months ago)
- Last Synced: 2025-12-11T00:28:05.283Z (6 months ago)
- Topics: ennexos, homeassistant, inverter, sma, speedwire
- Language: Python
- Homepage:
- Size: 797 KB
- Stars: 88
- Watchers: 5
- Forks: 5
- Open Issues: 11
-
Metadata Files:
- Readme: README.DE.md
- Support: docs/supported_devices.md
Awesome Lists containing this project
README
# ha-pysmaplus
Diese Intergration ermöglicht den Zugriff auf verschiedene Geräte (Wechselrichter, Batteriespeicher) von SMA.
Da jedes Geräte unterschiedliche Intnerfaces zur Verfügung stellt, muss bei dieser Integration ausgewählt werden, welches Interface gentutzw erden soll.
# Webconnect
Ist die Zugriffsart die in der aktuellen SMA Integration von Home Assistant genutzt wird. Hierbei werden die Werte über das Webinterface des Gerätes abgerufen.
Geräte: z.B. Sunny Tripower Smart Energy , Sunny Boy Storage
# EnnexOS
Die neuen Geräte (Tripower X und EVCharger) von SMA nutzen primär das Ennex-Betriebssystem. Ein Webserver, der die Werte liefert, ist vorhanden. Da das Webinterface sich im Vergleich zum Webconnect komplett geändert hat, musste ein neuer Adapter geschrieben werden, um die Daten abzurufen.
Geräte: Tripower X und EVCharger
# Speedwire EM
Der SHM2 und die Engerymeter übermittelt von sich aus die Daten per Multicast im Speedwire Format. Die Programme müssen hierbei nur auf den Netzwerktraffik lauschen und können die Werte dann dekodieren. Das Format für dieses eine Nachrichten Format hat SMA mittlerweile offen gelegt.
Geräte: Energymeter + Sunny Home Manager 2
# Speedwire
Fast alle(?) SMA Geräte unterstützen standardmäßig die Kommunikation per Speedwire. Dieses Protokoll ist aber nicht offen gelegt und ein paar Personen haben versucht, zumindest die unverschlüsselte Version des Protokolls zu dekodieren.
Voraussetzungen: Die Speedwire-Verschlüsselung darf nicht aktiviert werden. Defaultmäßig ist dieser für die Gruppe User auf 0000 und für die Grupper Installer auf 1111 eingestellt.
Geräte: alle, insbesondere Geräte, die von den anderen Interfaces nicht unterstützt werden z.B. Sunny Island
# Einschränkungen:
Da alle Interfaces, außer Energy Meter, ohne offizielle Unterlagen von SMA enträtselt wurden, kann es immer sein, dass etwas falsch interpretiert wurde. Außerdem sind die Interfaces im Zweifelsfall nicht vollständig. Gerade die Speedwire Implementierung ist noch unvollständig.
Speedwire hat aktuell den kleinsten Umfang an Sensoren, so dass EnnexOS oder Speedwire bevorzugt genutzt werden sollte.
Speedwire ist für die Geräte, die kein anderes Interface unterstützen, oder als Fallback.