Überblick
SunSpec Modbus verbindet Solarwechselrichter, Zähler und Batterien, die SunSpec Modbus sprechen, lokal mit Home Assistant. Es stellt die vom Gerät gemeldeten Werte als Sensoren bereit, etwa Leistung, Energie, Spannungen, Ströme, Temperaturen, Betriebszustand und Fehlerereignisse, einschließlich eines Sensors für die Gesamtenergie über die Lebensdauer für das Energie-Dashboard. Neben dem Auslesen von Daten bringt es Steuerungen für Lade- und Entladeraten der Batterie, Einspeisebegrenzung, Leistungsfaktor und Sollwert der Wirkleistung mit, dazu eine Aktion für einen Batterieplan mit Start- und Endzeit. Die Steuerungen für die Einspeisebegrenzung sind als experimentell markiert und standardmäßig ausgeschaltet. Die Verbindung läuft über Modbus TCP oder einen seriellen RS-485-Anschluss, und der Wechselrichter kann per Adresse eingegeben, über einen Netzwerkscan gefunden oder automatisch erkannt werden. Außerdem erzeugt es Reparaturhinweise, wenn ein Wechselrichter nicht erreichbar ist, bietet einen Diagnose-Download für Fehlerberichte an, und die Einrichtung erfolgt in der Oberfläche.
Zusammenfassung der README und des Codes von hilman2/ha-sunspec2, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich
Unterstützt
Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
Wird automatisch erkannt Home Assistant entdeckt sie im Netzwerk und bietet an, sie hinzuzufügen.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.
Stellt bereit
- Schalter
- Sensoren
Einrichtung
Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.
Wechselrichter-Verbindung
- Host oder IP
- Modbus-TCP-Port
- Modbus-Unit-ID
Wird auch beim Ändern der Verbindung abgefragt.
Netzwerk nach Wechselrichtern durchsuchen
- Zu scannendes Subnetz (CIDR-Notation, z.B. 192.168.1.0/24)
Wechselrichter auswählen
- Wechselrichter
Modbus-RTU-Verbindung
- Serielle Schnittstelle (z.B. /dev/ttyUSB0 oder COM3)
- Baudrate
- Parität
- Modbus-Unit-ID
Wechselrichter-Einstellungen
- Präfix für SensornamenOptionaler Zusatz vor den Sensornamen.
- AbfrageintervallAbstand zwischen den Geräteabfragen. Kurze Intervalle belasten Gerät und Netzwerk stärker.
- SensormodelleWähle die erkannten SunSpec-Modelle, für die Sensoren angelegt werden. Mindestens ein Modell muss ausgewählt sein.
- Spitzen-AC-LeistungAC-Leistung für die Erkennung unplausibler Messwerte. Vorschlag: Nennleistung plus 20 % Reserve. Für DC- und Scheinleistung gelten Zuschläge. Leer lassen verwendet die automatische Erkennung.
Nach der Einrichtung
- Host oder IP
- Modbus-TCP-Port
- Modbus-Unit-ID
- AbfrageintervallAbstand zwischen den Geräteabfragen. Kurze Intervalle belasten Gerät und Netzwerk stärker.
- SensormodelleWähle die erkannten SunSpec-Modelle, für die Sensoren angelegt werden. Mindestens ein Modell muss ausgewählt sein.
- Spitzen-AC-LeistungAC-Leistung für die Erkennung unplausibler Messwerte. Vorschlag: Nennleistung plus 20 % Reserve. Für DC- und Scheinleistung gelten Zuschläge. Leer lassen verwendet die automatische Erkennung.
- Präfix für SensornamenOptionaler Zusatz vor den Sensornamen.
- Abschalten im Leerlauf berücksichtigenUnterdrückt Verbindungs-Reparaturmeldungen für Geräte, die ohne Standby-Meldung vom Netz gehen. Sensoren werden weiterhin nicht verfügbar. Gemeldeten Standby erkennt die Integration automatisch.
- Pause beim ModellscanPause zwischen Modellen bei der Geräteerkennung, nicht bei normalen Abfragen. Erhöhen, wenn die Erkennung auf langsamen Geräten fehlschlägt.
- Pause zwischen ModellabfragenPause zwischen Modellabfragen im laufenden Betrieb. Kleinere Werte verkürzen Abfragen und Schreibaktionen. 0 schaltet die Pause aus.
- Diagnoseregister mitschneidenErgänzt Diagnose-Downloads zur Fehlersuche um rohe Modbus-Registerdaten.
- Steuerung nach Wertänderung neu aktivierenFronius GEN24 benötigt einen Aus-/Ein-Zyklus für geänderte Grenzwerte. Bei aktiver Steuerung wird der Schalter ausgeschaltet, der Wert geschrieben und der Schalter eine Sekunde später eingeschaltet. In dieser Sekunde wirkt das Limit nicht.
- Anonyme Nutzungsstatistik sendenSendet einmal täglich eine zufällige Installations-ID, Integrations- und HA-Version, Herstellerprofil und Anzahl der Einträge an den Autor. Keine Adresse, Seriennummer, Standort- oder Messwerte. Ausschalten beendet die Übertragung.
- Passwort der WeboberflächeLokaler Login "customer", nicht das Solar.web-Konto. Ermöglicht zusätzliche Geräte- und Batteriedaten. Gespeichert wird nur ein gerätespezifischer Login-Hash. Leer lassen behält den gespeicherten Login.
- Gespeicherten Login löschenEntfernt den gespeicherten Login und deaktiviert die zusätzlichen Funktionen der Weboberfläche.
Texte aus dem Code von hilman2/ha-sunspec2.
Entitäten
- TastenModbus-Steuerung zurücksetzen, Batterie im Standby halten, Batteriesteuerung freigeben
- ZahlenEinspeise-Limit, Ablaufzeit Einspeiselimit, Leistungsfaktor-Sollwert, Wirkleistungs-Sollwert, Wirkleistungs-Sollwert in Prozent, Ruecksprungwert Einspeiselimit, Batterie-Laderate, Batterie-Entladerate, Batterie-Ladeleistung (max), Ablaufzeit Batterie-Rate, Batterie-Mindestreserve, Batterie PV-Ladelimit und 24 weitere
- AuswahlfelderBatterie-Steuermodus, Batterie-Betriebsart, Modus Wirkleistungs-Sollwert, Speicher-Steuermodus, Speicher AC-Laderegel, Speicher Standardmodus, Speicher Kommandomodus, Modus Anlagenlimit, Bezug des Anlagenlimits, Externe Leistungssteuerung, Batterieplan Richtung
- SensorenAC-Strom, AC-Strom L1, AC-Strom L2, AC-Strom L3, Phasenspannung L1-L2, Phasenspannung L2-L3, Phasenspannung L3-L1, Phasenspannung L1-N, Phasenspannung L2-N, Phasenspannung L3-N, AC-Leistung, AC-Frequenz und 123 weitere
- SchalterEinspeise-Limit aktiv, Leistungsfaktor-Sollwert aktiv, Wechselrichter mit Netz verbunden, Wirkleistungs-Sollwert aktiv, Einspeiselimit bleibt nach Ruecksprung aktiv, Batterieladen aus dem Netz erlaubt, Batterieplan, Batterieladen aus dem Netz (Weboberfläche), Batterieladen aus AC (Weboberfläche), Modbus-Steuerung erlaubt, Speicherkommando erneuern, Wirkleistungslimit festhalten und 2 weitere
- UhrzeitenBatterieplan Beginn, Batterieplan Ende
Aktionen
- Batterieplan einstellenPlanwerte gemeinsam ändern. Änderungen gelten ab dem nächsten erfolgreichen Poll; Ausschalten beendet den Plan sofort.Felder: SunSpec-Gerät, Richtung, Beginn, Ende, Zielladestand, Batteriekapazität, Aktiviert
Fehlerbehebung
- DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
- ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:SunSpec-Wechselrichter nicht erreichbar, Gerät spricht kein SunSpec, Wechselrichter meldet eine Modbus-Exception, cjne/ha-sunspec ist noch aktiv
Aus der README
Connects solar inverters, meters and batteries to Home Assistant, if they speak SunSpec Modbus. SunSpec is a standard that many makers build into their inverters. Modbus is the way the data travels over your network. You do not need to know more than that.
Set up entirely in the UI: enter the inverter's IP address or let the integration search your network, tick the data you want, done. No YAML, no template sensors.
Erscheint in Vulpo
Schnellumschalterkarte, Tastenkarte, Auswahl-Karte, Diagrammkarte, Apple Watch, Kontrollzentrum.Informationen
- Installationen
- 65 teilen Analysedaten
- GitHub-Sterne
- 9
- Verbindung
- Funktioniert lokal
- Pflege
- In den letzten 6 Monaten aktualisiert
- Version
- v2026.10.13,
- Kategorie
- Energie, Solar und Batteriespeicher
- Art
- Marketplace-Integration
- Voraussetzung
- Braucht den Marketplace (HACS bis Home Assistant 2026.10)
- Domain
sunspec2- Probleme
- Problem melden
