SunSpec Modbus voor Home Assistant (Marketplace-integratie)

Installaties: 65 die analysegegevens delen
GitHub-sterren: 9
Verbinding: Werkt lokaal
Onderhoud: Bijgewerkt in de afgelopen 6 maanden
Versie: v2026.10.13, 26 oktober 2026
Categorie: Energie, Zonne-energie en batterijen
Soort: Marketplace-integratie
Vereist: Vereist de Marketplace (HACS op 2026.10 en ouder)
Domein: sunspec2
Bron: github.com/hilman2/ha-sunspec2
Problemen: Probleem melden

Onafhankelijk overzicht, gemaakt door de ontwikkelaar van Vulpo. Niet gelieerd aan Home Assistant of de Open Home Foundation.

Over dit item

SunSpec Modbus verbindt zonne-omvormers, meters en accu's die SunSpec Modbus spreken lokaal met Home Assistant. Het toont wat het apparaat meldt als sensoren, zoals vermogen, energie, spanningen, stromen, temperaturen, bedrijfsstatus en foutgebeurtenissen, inclusief een sensor voor de totale energie over de levensduur voor het Energiedashboard. Naast het uitlezen van gegevens voegt het bedieningselementen toe voor laad- en ontlaadsnelheden van de accu, exportlimiet, arbeidsfactor en instelwaarde voor actief vermogen, plus een actie voor een accuplan met begin- en eindtijden. De bedieningselementen voor de exportlimiet zijn als experimenteel gemarkeerd en staan standaard uit. De verbinding loopt via Modbus TCP of een seriële RS-485-poort, en de omvormer kan worden ingevoerd met een adres, worden gevonden met een netwerkscan of automatisch worden ontdekt. Het meldt ook reparaties wanneer een omvormer onbereikbaar is en biedt een diagnosedownload voor bugrapporten, en de installatie gebeurt in de UI.

Automatische samenvatting van de README en de code van hilman2/ha-sunspec2, automatisch vertaald. Klopt er iets niet, of ben je de maintainer en wil je hier je eigen tekst tonen? Neem contact op

Ondersteunt

Werkt lokaal Praat met je apparaten op je eigen netwerk. Geen cloud van de aanbieder ertussen.
Wordt vanzelf gevonden Home Assistant vindt het op het netwerk en biedt aan om het toe te voegen.
Uit de Marketplace Wordt geïnstalleerd via de Marketplace, voorheen HACS.
Actief onderhouden De auteur heeft in de afgelopen zes maanden een release of wijziging gepubliceerd.

Levert

Schakelaars
Sensoren

Instellen

Installeer de integratie vanuit de Marketplace en herstart Home Assistant. Voeg de integratie daarna toe onder Instellingen > Apparaten en diensten.

Verbinding met omvormer

Host of IP
Modbus TCP-poort
Modbus-unit-ID

Ook gevraagd bij het wijzigen van de verbinding.

Netwerk scannen op omvormers

Te scannen subnet (CIDR-notatie, bijvoorbeeld 192.168.1.0/24)

Kies je omvormer

Omvormer

Modbus RTU-verbinding

Baudrate
Pariteit
Modbus-unit-ID

Omvormerinstellingen

Voorvoegsel voor sensornamenOptioneel voorvoegsel voor sensornamen.
PollingintervalTijd tussen het uitlezen van het apparaat. Korte intervallen verhogen de belasting van het netwerk en het apparaat.
SensormodellenSelecteer de gedetecteerde SunSpec-modellen die je als sensoren wilt aanbieden. Selecteer er minstens één.
Piek-ACvermogenACvermogen waarmee onwaarschijnlijke metingen worden gefilterd. Voorgesteld op basis van het typeplaatje met 20% extra marge. Bij DC-vermogen en schijnbaar vermogen zijn hogere metingen toegestaan. Maak het veld leeg om automatische detectie te gebruiken.

Na het instellen

Host of IP
Modbus TCP-poort
Modbus-unit-ID
PollingintervalTijd tussen het uitlezen van het apparaat. Korte intervallen verhogen de belasting van het netwerk en het apparaat.
SensormodellenSelecteer de gedetecteerde SunSpec-modellen die je als sensoren wilt aanbieden. Selecteer er minstens één.
Piek-ACvermogenACvermogen waarmee onwaarschijnlijke metingen worden gefilterd. Voorgesteld op basis van het typeplaatje met 20% extra marge. Bij DC-vermogen en schijnbaar vermogen zijn hogere metingen toegestaan. Maak het veld leeg om automatische detectie te gebruiken.
Voorvoegsel voor sensornamenOptioneel voorvoegsel voor sensornamen.
Toestaan dat de omvormer offline gaat bij inactiviteitOnderdrukt Reparaties voor de verbinding bij apparaten die offline gaan zonder stand-by te melden. Sensoren worden nog steeds niet beschikbaar. Gemelde stand-by wordt automatisch herkend.
Pauze tussen modelscansPauze tussen modellen tijdens het zoeken, niet tijdens het normale pollen. Verhoog dit als het zoeken mislukt bij trage apparaten.
Pauze tussen modelmetingenPauze tussen het uitlezen van modellen tijdens het normale pollen. Lagere waarden maken verversen en schrijfacties sneller. Stel in op 0 om de pauze te verwijderen.
Diagnostische registers vastleggenVoegt ruwe Modbus-registergegevens toe aan diagnostische downloads om problemen op te sporen.
Besturing opnieuw inschakelen na een wijziging van de instelwaardeFronius GEN24 vereist een uit/aan-cyclus om gewijzigde limieten toe te passen. Zolang een besturing is ingeschakeld, wordt de bijbehorende schakelaar uitgezet, de waarde geschreven en de schakelaar één seconde later weer aangezet. Tijdens die seconde is de limiet niet actief.
Anonieme gebruiksstatistieken verzendenStuurt eenmaal per dag een willekeurig installatie-ID, de versies van de integratie en HA, het leveranciersprofiel en het aantal items naar de auteur. Stuurt geen adres, serienummer, locatie of metingen. Schakel uit om niets te verzenden.
Wachtwoord van de webinterfaceLokale "customer"-login, niet je Solar.web-account. Maakt extra gegevens over het apparaat en de batterij beschikbaar. Alleen een apparaatspecifieke loginhash wordt opgeslagen. Laat leeg om de opgeslagen login te behouden.
Opgeslagen login vergetenVerwijdert de opgeslagen login en schakelt de extra functies van de webinterface uit.

Teksten uit de code van hilman2/ha-sunspec2. Teksten waarvoor de repository geen Nederlandse vertaling heeft, zijn automatisch vertaald.

Entiteiten

KnoppenModbus-besturing resetten
NummersExportlimiet, Terugkeertijd exportlimiet, Instelwaarde arbeidsfactor, Instelwaarde actief vermogen, Instelwaarde actief vermogen in procenten, Terugkeerwaarde exportlimiet, Laadsnelheid batterij, Ontlaadsnelheid batterij, Maximaal laadvermogen batterij, Terugkeertijd batterijsnelheid, Minimale reserve batterij, PV-laadlimiet batterij en nog 24
SelectiesAccubesturingsmodus, Accumodus, Modus setpoint actief vermogen, Opslagbesturingsmodus, AC-laadbeleid opslag, Standaardmodus opslag, Opdrachtmodus opslag, Locatielimietmodus, Bereik locatielimiet, Externe vermogensregeling, Richting accuplan
SensorenAC-stroom, AC-stroom L1, AC-stroom L2, AC-stroom L3, Fasespanning L1-L2, Fasespanning L2-L3, Fasespanning L3-L1, Fasespanning L1-N, Fasespanning L2-N, Fasespanning L3-N, AC-vermogen, AC-frequentie en nog 123
SchakelaarsExportlimiet ingeschakeld, Setpoint vermogensfactor ingeschakeld, Netaansluiting omvormer, Setpoint actief vermogen ingeschakeld, Exportlimiet blijft aan na terugzetten, Laden van accu vanaf het net toegestaan, Accuplan, Laden van accu vanaf het net (webinterface), Laden van accu via AC (webinterface), Modbus-besturing toegestaan, Opslagopdracht opnieuw activeren, Limiet actief vermogen blijven afdwingen en nog 2
TijdenStart accuplan, Einde accuplan

Acties

Accuplan instellenWerk de planinstellingen samen bij. Wijzigingen gelden bij de volgende geslaagde poll; uitschakelen stopt het plan direct.Velden: SunSpec-apparaat, Richting, Start, Einde, Doellaadtoestand, Accucapaciteit, Ingeschakeld

Probleemoplossing

DiagnostiekDownloadt een diagnostiekbestand om aan een bugmelding toe te voegen.
ReparatiemeldingenMeldingen die het kan tonen onder Instellingen > Reparaties:SunSpec-omvormer niet bereikbaar, Apparaat spreekt geen SunSpec, Omvormer meldt een Modbus-uitzondering, cjne/ha-sunspec is nog actief

Uit de 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.

Uit de README van hilman2/ha-sunspec2, MIT License. Ingekort.