Solax Developer API für Home Assistant (Marketplace-Integration)

Installationen: 99 teilen Analysedaten
GitHub-Sterne: 2
Verbindung: Nutzt die Cloud des Herstellers
Pflege: In den letzten 6 Monaten aktualisiert
Version: v0.4.8, 24. September 2026
Kategorie: Energie, Solar und Batteriespeicher
Art: Marketplace-Integration
Marke: SolaX
Voraussetzung: Braucht den Marketplace (HACS bis Home Assistant 2026.10)
Domain: solax_developer_api
Quelle: github.com/NoUsername10/Solax-Developer-API-for-Home-assistant
Probleme: Problem melden

Unabhängiges Verzeichnis, erstellt vom Entwickler von Vulpo. Steht in keiner Verbindung zu Home Assistant oder der Open Home Foundation.

Screenshots Aus der README von NoUsername10/Solax-Developer-API-for-Home-assistant.

SolaX Developer Portal API region account

Überblick

Solax Developer API for Home Assistant verbindet SolaX-Systeme über die Cloud-API des SolaX Developer Portal mit Home Assistant. Die Integration erkennt autorisierte Anlagen und Geräte, etwa Wechselrichter, Batterien, Zähler, EV-Ladegeräte und EMS-Systeme, und erstellt Sensoren für jedes Gerät sowie systemweite Gesamtwerte. Zu den Entitäten gehören Tasten, Zahlen, Auswahlfelder, Schalter, Texte und Uhrzeiten für die Steuerung von EV-Ladegeräten und der Reserveladung. Ein Live-View-Modus erhöht die Abfragehäufigkeit vorübergehend und begrenzt dabei die API-Aufrufe auf ein festgelegtes Budget, und ein separates Nachtintervall kann die Abfragen verlangsamen. Die Alarmüberwachung kann dauerhafte Benachrichtigungen auslösen, und Verlauf und Statistiken lassen sich über Aktionen von SolaX abrufen. Aktionen zur Wechselrichtersteuerung sind nur als Testlauf möglich und blockieren Schreibzugriffe, und die manuelle Eingabe für Zähler und EMS ist verfügbar. Die Einrichtung erfolgt in der Oberfläche mit Client ID, Client Secret und API-Region.

Zusammenfassung der README und des Codes von NoUsername10/Solax-Developer-API-for-Home-assistant, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich

Unterstützt

Nutzt die Cloud des Herstellers Braucht eine Internetverbindung und einen Account beim Hersteller.
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.

SolaX Developer API einrichten

Client IDClient ID aus deiner Anwendung im SolaX Developer Portal.
Client SecretClient Secret aus derselben Anwendung im Developer Portal.
SystemnameName für das Systemgerät in Home Assistant und als Präfix für die Entitäts-IDs.
Aktualisierungsintervall (Sekunden)Normales Aktualisierungsintervall in Sekunden.
API-RegionDie deiner Anwendung zugewiesene Region der SolaX Developer API.

SolaX Developer API erneut verbinden

Client IDClient ID der vorhandenen SolaX Developer API-Anwendung.
Client SecretAktuelles Client Secret der Anwendung.
API-RegionDie der Anwendung zugewiesene Region der SolaX Developer API.

SolaX Developer API neu konfigurieren

Client IDClient ID, die nach der Neukonfiguration verwendet werden soll.
Client SecretClient Secret, das nach der Neukonfiguration verwendet werden soll.
SystemnameName für das Systemgerät in Home Assistant und als Präfix für die Entitäts-IDs.
API-RegionDie der Anwendung zugewiesene Region der SolaX Developer API.

Nach der Einrichtung

Client IDClient ID aus deiner Anwendung im SolaX Developer Portal.
Client SecretClient Secret aus derselben Anwendung im Developer Portal.
SystemnameName für das Systemgerät in Home Assistant und als Präfix für die Entitäts-IDs.
API-RegionDie deiner Anwendung zugewiesene Region der SolaX Developer API.
Aktualisierungsintervall (Sekunden)Normales Aktualisierungsintervall in Sekunden.
Standarddauer für Live View (Sekunden)Wie lange Live View aktiv bleibt, wenn keine abweichende Dauer angegeben wird.
Zielintervall für Live View (Sekunden)Angefordertes Aktualisierungsintervall für Live View. Das tatsächliche Intervall kann zum Schutz des API-Budgets verlängert werden.
Aufrufbudget für Live View (Aufrufe/min)Maximale Anzahl der pro Minute für Live View reservierten API-Aufrufe.
Aktualisierungsintervall bei Nacht (Sekunden)Aktualisierungsintervall während des konfigurierten Nachtzeitraums.
Startstunde des Nachtmodus (0-23)Ortszeitstunde, zu der die nächtliche Aktualisierung beginnt.
Endstunde des Nachtmodus (0-23)Ortszeitstunde, zu der die nächtliche Aktualisierung endet.
Seriennummern manueller Zähler hinzufügen (eine pro Zeile, optional |businessType)Gib pro Zeile eine erreichbare Zählerseriennummer ein. Füge |1 oder |4 nur hinzu, wenn ein bestimmter Betriebstyp erzwungen werden muss.
Zu entfernender manueller ZählerWähle einen zuvor manuell hinzugefügten Zähler aus.
Ausgewählten manuellen Zähler entfernenBestätige das Entfernen des ausgewählten manuellen Zählers.
Manuelle EMS-Systeme hinzufügen (EMS-Seriennummer|Anlagen-ID, eines pro Zeile)Gib pro Zeile eine EMS-Seriennummer und Anlagen-ID im Format SERIAL|PLANT_ID ein.
Zu entfernendes manuelles EMS-SystemWähle ein zuvor manuell hinzugefügtes EMS-System aus.
Ausgewähltes manuelles EMS-System entfernenBestätige das Entfernen des ausgewählten manuellen EMS-Systems.
Benachrichtigungen bei API-LimitsHome Assistant-Benachrichtigungen anzeigen, wenn SolaX ein Raten- oder Kontingentlimit meldet.
Steuerung des EV chargerEchte Schreibanforderungen nur für Dienste zur Steuerung des EV charger zulassen. Ist diese Option deaktiviert, bleiben die Dienste für den EV charger wie die übrigen Steuerungsdienste als Testlauf blockiert.
AlarmbenachrichtigungenDauerhafte Home Assistant-Benachrichtigungen anzeigen, wenn SolaX aktive Alarme meldet.
Intervall der AlarmabfrageWie oft SolaX auf aktive Alarme geprüft wird, in Sekunden.

Texte aus dem Code von NoUsername10/Solax-Developer-API-for-Home-assistant.

Entitäten

TastenLive View beschleunigen, EV charger sperren, EV charger als verfügbar festlegen, Ladevorgang starten, Ladevorgang beenden, Ladeszenario anwenden, QR-Code anwenden, Reserviertes Laden anwenden
ZahlenStrombegrenzung, Strom für reserviertes Laden
AuswahlfelderBetriebsmodus, Startmodus, Ladeszenario
SchalterBenachrichtigungen bei API-Ratenlimit, Live View-Modus
TexteQR-Code, OCPP-URL, OCPP-ID des EV charger
UhrzeitenStartzeit des reservierten Ladens, Endzeit des reservierten Ladens

Aktionen

Manuell aktualisierenSofortige Aktualisierung aller konfigurierten Einträge der SolaX Developer API auslösen.Felder: Eintrags-ID
Live View startenVorübergehend eine auf Echtzeitdaten ausgerichtete Aktualisierung mit automatischem Zeitlimit aktivieren.Felder: Eintrags-ID, Dauer (Sekunden), Zielintervall (Sekunden)
Live View beendenAktualisierung für Live View deaktivieren und zum Zeitplan des Standard- oder Nachtprofils zurückkehren.Felder: Eintrags-ID
Geräte für Verlauf auflistenListet die aktuell erkannten Geräte auf, die über den Verlaufsendpunkt der Developer API abgefragt werden können. Ruft die SolaX API nicht auf.Felder: Eintrags-ID
Ziele für Anlagenstatistik auflistenListet die aktuell erkannten Anlagen auf, die über den Anlagenstatistik-Endpunkt der Developer API abgefragt werden können. Ruft die SolaX API nicht auf.Felder: Eintrags-ID
Geräteverlauf abrufenLiest historische Telemetriedaten aus der Developer API und speichert das Ergebnis zwischen. Lange Zeiträume werden automatisch in API-sichere Abschnitte aufgeteilt.Felder: Eintrags-ID, Liste der Geräteseriennummern, Gerätetyp, Betriebstyp, Startzeit, Endzeit, Zeitintervall, Typ der Seriennummer für die Anforderung, Anforderungs-ID
Jahresstatistik einer Anlage abrufenLiest die monatliche Anlagenstatistik für ein Jahr aus der Developer API. Nur zur Anzeige; schreibt nicht in den Home Assistant Recorder.Felder: Eintrags-ID, Anlagen-ID, Betriebstyp, Jahr, Anforderungs-ID
Monatsstatistik einer Anlage abrufenLiest die tägliche Anlagenstatistik für einen Monat aus der Developer API. Nur zur Anzeige; schreibt nicht in den Home Assistant Recorder.Felder: Eintrags-ID, Anlagen-ID, Betriebstyp, Jahr, Monat, Anforderungs-ID
Anforderungsergebnis abfragenFragt den Status einer asynchronen Befehlsanforderung anhand der Zeichenfolge requestId ab.Felder: Eintrags-ID, Anforderungs-ID
Übergeordnetes Steuergerät abfragenLiest das übergeordnete Steuergerät der obersten Ebene (nur gewerblich und industriell, businessType=4).Felder: Eintrags-ID, Geräte-SN, Gerätetyp, Betriebstyp
Exportsteuerung festlegen (Testlauf)Nur Testlauf. Prüft den payload und blockiert die Schreibausführung.Felder: Eintrags-ID, Liste der Geräteseriennummern, Gerätetyp, Aktivierungskennzeichen, Grenzwert, Betriebstyp, Steuerungsmodus
Importsteuerung festlegen (Testlauf)Nur Testlauf. Prüft den payload und blockiert die Schreibausführung.Felder: Eintrags-ID, Liste der Geräteseriennummern, Gerätetyp, Aktivierungskennzeichen, Grenzwert, Betriebstyp
Eigenverbrauchsmodus des Wechselrichters (Testlauf)Nur Testlauf. Prüft den payload und blockiert die Schreibausführung.Felder: Eintrags-ID, Liste der Geräteseriennummern, Minimaler SOC, Laden aus dem Netz aktivieren, Oberer Lade-SOC, Betriebstyp, Start des Ladezeitraums 1, Ende des Ladezeitraums 1, Start des Entladezeitraums 1, Ende des Entladezeitraums 1
Einspeiseprioritätsmodus des Wechselrichters (Testlauf)Nur Testlauf. Prüft den payload und blockiert die Schreibausführung.Felder: Eintrags-ID, Liste der Geräteseriennummern, Minimaler SOC, Oberer Lade-SOC, Betriebstyp, Start des Ladezeitraums 1, Ende des Ladezeitraums 1, Start des Entladezeitraums 1, Ende des Entladezeitraums 1, Zeitraum 2 aktivieren
Notstrommodus des Wechselrichters (Testlauf)Nur Testlauf. Prüft den payload und blockiert die Schreibausführung.Felder: Eintrags-ID, Liste der Geräteseriennummern, Minimaler SOC, Laden aus dem Netz aktivieren, Oberer Lade-SOC, Betriebstyp, Start des Ladezeitraums 1, Ende des Ladezeitraums 1, Start des Entladezeitraums 1, Ende des Entladezeitraums 1
Manueller Modus des Wechselrichters (Testlauf)Nur Testlauf. Prüft den payload und blockiert die Schreibausführung.Felder: Eintrags-ID, Liste der Geräteseriennummern, Manueller Modus, Betriebstyp
A1-Hybrid-G2 Eigenverbrauch (Testlauf)Nur Testlauf. Prüft den payload und blockiert die Schreibausführung.Felder: Eintrags-ID, Liste der Geräteseriennummern, Betriebstyp
A1-Hybrid-G2 Einspeisepriorität (Testlauf)Nur Testlauf. Prüft den payload und blockiert die Schreibausführung.Felder: Eintrags-ID, Liste der Geräteseriennummern, Betriebstyp
A1-Hybrid-G2 Notstrommodus (Testlauf)Nur Testlauf. Prüft den payload und blockiert die Schreibausführung.Felder: Eintrags-ID, Liste der Geräteseriennummern, Netz im Notstrommodus aktivieren, Startzeit der Notstromladung, Endzeit der Notstromladung, Betriebstyp
A1-Hybrid-G2 Lastspitzenbegrenzung (Testlauf)Nur Testlauf. Prüft den payload und blockiert die Schreibausführung.Felder: Eintrags-ID, Liste der Geräteseriennummern, Netz für Lastspitzenbegrenzung aktivieren, Zeitpunkt der Spitzenbegrenzung 1, Zeitpunkt der Spitzenbegrenzung 2, Startzeit der Entladung für Lastbegrenzung 1, Endzeit der Entladung für Lastbegrenzung 1, Startzeit der Entladung für Lastbegrenzung 2, Endzeit der Entladung für Lastbegrenzung 2, Leistungsbegrenzung des Ladegeräts

Fehlerbehebung

DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:Das Ratenlimit der SolaX Developer API ist aktiv, Der Zugriff auf die SolaX Developer API ist unvollständig

Aus der README

SolaX Developer API integration to monitor and control your SolaX system in Home Assistant using the official SolaX Developer OpenAPI.
Automatically discovers authorized plants and devices, creates per-device sensors, and provides a system-wide overview with total sensors. Requires no YAML configuration or template sensors.

Aus der README von NoUsername10/Solax-Developer-API-for-Home-assistant, MIT License. Gekürzt.