HYXI für Home Assistant (Marketplace-Integration)

Installationen: 53 teilen Analysedaten
GitHub-Sterne: 15
Verbindung: Nutzt die Cloud des Herstellers
Pflege: In den letzten 6 Monaten aktualisiert
Version: v1.7.0, 27. Oktober 2026
Art: Marketplace-Integration
Voraussetzung: Braucht den Marketplace (HACS bis Home Assistant 2026.10)
Domain: hyxi_cloud
Quelle: github.com/Veldkornet/ha-hyxi-cloud
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 Veldkornet/ha-hyxi-cloud.

Überblick

HYXI ist eine Home Assistant Integration für HYXiPower Solarwechselrichter, Batterien und Zähler. Die Daten kommen entweder über die HYXI Cloud mit einem Konto oder über eine direkte RS485 Modbus Verbindung zu einem einzelnen Wechselrichter, per TCP-Gateway oder über eine serielle Schnittstelle. Sie fügt Sensoren für Batterieladung, Solarleistung, Hauslast und Netzfluss hinzu, dazu Binärsensoren, Tasten, Zahlen und Schalter, und sie unterstützt das Energie-Dashboard. Steuerungsentitäten für Batteriemodi, Leistungsziele und Schutzgrenzen bleiben ausgeblendet, bis Device Control & Protection in den Optionen aktiviert wird. Zu den optionalen Funktionen gehören Webhook-Push für Live-Daten und Alarme, einstellbare Abfrageintervalle und ein Energy Manager in der Beta, der das Laden und Entladen der Batterie anhand eines P1-Zählers und einer Solarprognose steuert. Für Automationen steht eine Aktion zum Setzen des Batteriemodus bereit, und die Einrichtung erfolgt in der Benutzeroberfläche.

Zusammenfassung der README und des Codes von Veldkornet/ha-hyxi-cloud, 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.

Wie soll Home Assistant Ihr HYXI-System erreichen?

Verbindungsart

Mit HYXI Cloud verbinden

Zugriffsschlüssel (AK)
Geheimer Schlüssel (SK)
Serverregion
Echtzeit-Webhook-Push aktivierenWenn aktiviert, sendet HYXI Live-Daten und Alarme sofort an Home Assistant. Dafür braucht es eine öffentliche HTTPS-URL, die die HYXI-Cloud erreichen kann; die nächste Seite fragt, welche. Standardmäßig aus; das Push-Intervall lässt sich später in den Optionen einstellen.

Callback-URL für Push

Benutzerdefinierte Callback-URL (optional, dynamischer Standard)Optional. Eine öffentliche HTTPS-Adresse, an die die HYXI-Cloud Push-Daten senden soll, falls nicht Home Assistant Cloud oder die externe URL von Home Assistant. Nur die Basis-URL eingeben; der Webhook-Pfad wird automatisch ergänzt.

Wie ist der RS485-Bus angeschlossen?

Verbindungstyp

Wird auch beim Ändern der Verbindung abgefragt.

Modbus-TCP-Gateway

Gateway-Host oder IP-Adresse
Port
Slave-Adresse

Serieller Anschluss

Serielles Gerät
Baudrate
Slave-Adresse

HYXI Cloud erneut authentifizieren

Zugriffsschlüssel (AK)
Geheimer Schlüssel (SK)
Serverregion

Nach der Einrichtung

Abfrageintervall (1-60 Minuten, Standard: 5)
Abfrageintervall (1-60 Sekunden, Standard: 15)
Discovery über Alarme aktivieren (Erweitert)
Gerätesteuerung und -schutz aktivierenAktivieren Sie dies mit Vorsicht, wenn Ihr Wechselrichter bereits von Ihrem Energieversorger verwaltet wird oder an einem Virtual-Power-Plant-Programm (VPP) teilnimmt. Das Senden von Befehlen, während Ihr Versorger die Kontrolle hat, kann mit dessen Dispatch-Zeitplan in Konflikt geraten.
Energie-Manager Standalone aktivieren (Beta)
Echtzeit-Webhook-Push aktivieren
Push-Aktualisierungsfrequenz (Millisekunden, Bereich: 5000-3600000)
Benutzerdefinierte Callback-URL (optional, dynamischer Standard)
P1 Smart Meter (Leistungssensor)
Solarprognose für den restlichen Tag (optional)
Solarprognose aktuelle Leistung (optional)
Zu steuernder Wechselrichter
Batteriekapazität überschreiben
Batteriekapazität (Wh)
Entscheidungsintervall (Sekunden)
Testmodus (keine API-Aufrufe)

Texte aus dem Code von Veldkornet/ha-hyxi-cloud. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.

Entitäten

BinärsensorenVerbindungsstatus, Aktive Probleme, Nachtmodus, Hohe Last erkannt, Arbeitsmodus
TastenGerät neu starten, Modus: Leerlauf, Modus: Laden, Modus: Entladen, Modus: Eigenverbrauch, Arbeitsmodus: Eigenverbrauch, Arbeitsmodus: Netz-Backup, Arbeitsmodus: Zeitvariabler Tarif (TOU), Spitzenlastkappung: Ausschalten, Spitzenlastkappung: Laden erzwingen, Spitzenlastkappung: Entladen erzwingen, Spitzenlastkappung: Stoppen und 7 weitere
ZahlenZiel-Ladeleistung, Ziel-Entladeleistung, Leistungsbegrenzung, Einspeiseleistungsgrenze, VPP SOC Minimum, Zwangsladung Start-SOC, Zwangsladung Stopp-SOC, Off-Grid Minimum SOC, Eigenverbrauch Reserve-SOC, Entladung Minimum SOC, Notstrom Reserve-SOC, Zwangsladung SOC und 23 weitere
SensorenBatterieladezustand, Batterieleistung, Solarleistung, Hausverbrauch, Netzbezug, Netzeinspeisung, Batterie lädt, Batterie entlädt, Gesamtertrag, Gesamtertrag B, Gesamtertrag C, Gesamte Batterieladung und 137 weitere
SchalterFrequenzregelung, Strom, Tiefentladeschutz, Netzladung Erlaubt, Energie-Manager, Batterieunterstützung bei hoher Last, Nachtmodus, Einspeisebegrenzung, Batterie-Dispatch-Steuerung

Aktionen

Abonnement kündigenEin aktives oder verwaistes Push/Alarm-Abonnement manuell auf dem HYXI Cloud-Server stornieren.Felder: Abonnementcode, Entry
Batteriemodus setzenSendet einen Befehl für den Batteriebetriebsmodus an einen HYXI-Wechselrichter. Erfordert, dass "Gerätesteuerung & Schutz" für diesen Eintrag aktiviert ist, und wird abgelehnt, solange der Energie-Manager den Ziel-Wechselrichter steuert, sofern nicht Erzwingen gesetzt ist.Felder: Modus, Leistung, Erzwingen

Fehlerbehebung

DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:Die Batteriesteuerung ist über die HYXI Cloud nicht verfügbar, Energy Manager pausiert: keine aktuellen Daten

Aus der README

Monitor your HYXIPower solar production, battery, and grid flow in real-time.
Bring your HYXIPower inverter, battery, and meter data into Home Assistant — over the HYXI Cloud (your account, any supported device) or a direct Local Modbus (RS485) connection to one inverter (no account, no internet dependency).
☁️ Cloud or 📟 local — pull data through the HYXI Cloud API, or talk straight to one inverter over RS485 Modbus for faster polling and no internet dependency (Local Modbus).
⚡ Energy Dashboard ready — native support for Home Assistant's Energy Dashboard (setup).
🔄 Real-time push — optional webhook subscriptions for instant telemetry and alarm updates, bypassing the poll interval (details).
🔧 Device control — opt-in inverter mode buttons, charge/discharge power, peak shaving, battery protection, and microinverter controls (reference).
🔋 Energy Manager (Beta) — an automated battery engine that manages charge/discharge from your P1 meter, solar, SOC, and forecast (guide).
📊 Diagnostics — dedicated sensors for cloud connectivity, data freshness, and sync latency.
🛡️ Resilient — 100% test coverage, and glitch-filtering that rejects impossible energy spikes and dips from cloud reporting delays.
🕥 Adjustable polling — 1 to 60 minutes.
🌍 20+ languages — English, German, French, Dutch, Afrikaans, Portuguese, Spanish, Italian, and more.

Aus der README von Veldkornet/ha-hyxi-cloud, MIT License. Gekürzt.