Zum Inhalt springen

Nutzt du Home Assistant 2026.10 oder älter? In HACS öffnen

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 windsurf/hassio-zendure-restapi.

\<image of the dashboard\>\<image of the Price Control tab\>

Überblick

Zendure RestAPI ist eine lokale Integration für Zendure SolarFlow Batterien, die den Netzbezug nahe null hält. Sie spricht direkt mit der Batterie, ohne Cloud-Konto oder MQTT-Broker, und wird in der Oberfläche mit der IP-Adresse und dem HTTP-Port der Batterie hinzugefügt. Eine Regelschleife liest jede Sekunde den Netzzähler aus, lädt die Batterie mit überschüssigem Solarstrom und entlädt sie, um den Bedarf im Haus zu decken. Der Zähler kann ein HomeWizard-, YouLess- oder Shelly P1-Gerät sein, das über IP ausgelesen wird, oder ein beliebiger Leistungssensor in Home Assistant. Die Preissteuerung plant das Laden und Entladen anhand eines Preissensors für dynamische Tarife, und ein Festpreismodus speichert überschüssigen Solarstrom ohne einen solchen Sensor. Sie fügt Sensoren, Zahlen, Auswahlen, Schalter, Tasten und Binärsensoren hinzu, dazu ein generiertes Dashboard mit den Ansichten Price Control und History.

Zusammenfassung der README und des Codes von windsurf/hassio-zendure-restapi, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich

Erscheint in Vulpo

Schnellumschalterkarte, Tastenkarte, Auswahl-Karte, Diagrammkarte, Apple Watch, Kontrollzentrum.

Unterstützt

  • Funktioniert lokalSpricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
  • Wird automatisch erkanntHome Assistant entdeckt sie im Netzwerk und bietet an, sie hinzuzufügen.
  • Aus dem MarketplaceWird über den Marketplace installiert, früher HACS.
  • Aktiv gepflegtDas Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.

Stellt bereit

  • Schalter
  • Sensoren

Einrichtung

Installiere die Integration aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.

Zähler prüfen

  • Der Zähler zeigt Einspeisung positiv (Vorzeichen umkehren)

Zendure-Gerät

  • IP-Adresse
  • HTTP-Port
  • Zendure-RestAPI-Dashboard anlegen (nur Batterie)

Zendure-Gerät gefunden

  • Zendure-RestAPI-Dashboard anlegen

Externer Netzzähler über IP

  • Zählertyp
  • IP-Adresse
  • Millisekunden zwischen Abfragen (100-1000; unter 1000 nur für YouLess)

Home-Assistant-Sensor

  • Leistungssensor (Bezug positiv)
  • Einspeisesensor (optional, Einspeisung positiv)
  • Der Zähler zeigt Einspeisung positiv (Vorzeichen umkehren)

Preissteuerung

  • Batterie oder Cluster
  • Preissensor (Preis pro kWh)Feste Preise: jeder Sensor mit dem aktuellen Preis. Tagesplan: ein Sensor mit Preisliste — Nord Pool (HACS), EPEX Spot (HACS), Zonneplan, ENTSO-e oder Frank Energie.
  • Der Preissensor enthältFür den Tagesplan. Nord Pool (HACS) mit MwSt. an und ohne Zusatzkosten: Spotpreis inkl. MwSt. Mit MwSt. aus: Spotpreis. Mit dem ganzen Tarif in den Zusatzkosten: Bezugspreis. EPEX Spot: Sensor Market price: Spotpreis; Sensor Total price: Bezugspreis. Zonneplan: Bezugspreis.

Zählergerät

  • Gerät

Virtueller Cluster (simuliert)

  • Zu kopierende BatterieDie Kopien übernehmen Modell, Maxima, SOC-Grenzen und Einstellungen; die erste Kopie startet mit seinem Ladezustand.

Nach der Einrichtung

  • Sekunden zwischen Abfragen (1-60)
  • Solarleistung von außerhalb des Speichers (optional, für das Dashboard)Eine smarte Steckdose an einem Mikrowechselrichter oder ein zweiter Wechselrichter. Die PV-Reihen des Dashboards zeigen sie: statt der eigenen PV des Speichers, wenn diese nicht genutzt wird, sonst daneben. Für die Regelung ist sie nicht nötig, der Netzzähler sieht diese Leistung bereits.
  • Solarenergie von außerhalb des Speichers (optional, für das Dashboard)Ihr kWh-Zähler, für die Tagessummen im Tab History.
  • Einstellungen zurücksetzen: die Regeleinstellungen auf ihre StandardwertePuffer und Startschwellen 5 W, Laden stoppen unter 50 W, Entladen stoppen unter 50 W, Stoppen nach 30 s, Starten nach 30 s, Min. Ladeleistung und Min. Entladeleistung 0 W, Schwelle Modus 10 W, Schwelle Nachregelung 40 W, Nachregelstärke 80 %, Wartezeit bei Richtungswechsel 10 s. Operation mode, Max. Ladeleistung und Max. Entladeleistung, SOC-Schutz, der Zähler und Price Control bleiben, wie sie sind. In einem Cluster gelten die Einstellungen der Gruppe.
  • Dashboard neu aufbauen (eigene Änderungen daran gehen verloren)
  • IP-Adresse
  • Millisekunden zwischen Abfragen (100-1000; unter 1000 nur für YouLess)
  • Leistungssensor (Bezug positiv)
  • Einspeisesensor (optional, Einspeisung positiv)
  • Der Zähler zeigt Einspeisung positiv (Vorzeichen umkehren)
  • Preissensor (Preis pro kWh)Feste Preise: jeder Sensor mit dem aktuellen Preis. Tagesplan: ein Sensor mit Preisliste — Nord Pool (HACS), EPEX Spot (HACS), Zonneplan, ENTSO-e oder Frank Energie.
  • Der Preissensor enthältFür den Tagesplan. Nord Pool (HACS) mit MwSt. an und ohne Zusatzkosten: Spotpreis inkl. MwSt. Mit MwSt. aus: Spotpreis. Mit dem ganzen Tarif in den Zusatzkosten: Bezugspreis. EPEX Spot: Sensor Market price: Spotpreis; Sensor Total price: Bezugspreis. Zonneplan: Bezugspreis.
  • Der Zähler zeigt Einspeisung positiv (Vorzeichen umkehren)
  • Externer Zähler
  • Dashboard neu aufbauen (eigene Änderungen daran gehen verloren)
  • Kopien zurücksetzen: jede Kopie anhalten und um den Ladezustand deiner Batterie neu startenDie Kopien halten an, beide Limits gehen auf 0, und jede beginnt neu beim Ladezustand deiner Batterie plus ihrer SoC-Abweichung.
  • Einstellungen zurücksetzen: alle Einstellungen des virtuellen Clusters und seiner Kopien auf den StandardwertKopien 3, Load factor 1, SoC-Abweichungen 0 / -20 / 15 %, zusätzliche Reaktionszeit 0 / 1 / 3 s, Max. Anteil 0, Operation mode Follow source, Puffer und Startschwellen 5 W, Laden stoppen unter 50 W, Entladen stoppen unter 50 W, Stoppen nach 30 s, Starten nach 30 s, Concentrate below 300 W, Redistribute every 30 s. Die Kopien laufen weiter; hake auch Kopien zurücksetzen an, um sie mit den neuen Abweichungen zu starten. Deine eigene Batterie und Price Control bleiben unberührt.
  • Dashboard neu aufbauen (eigene Änderungen daran gehen verloren)

Texte aus dem Code von windsurf/hassio-zendure-restapi.

Entitäten

  • BinärsensorenDaten bereit, Potenzialfreier Kontakt, Lüfter, Netz verbunden, Heizung, HV-Akkusteuerung, Fehler, Leuchte, Durchleitung, PV-AC-Kopplung, Rückfluss, SOC-Kompensation und 1 weitere
  • TastenZurücksetzen, Dashboard neu aufbauen
  • ZahlenKalibrierintervall, Ladepuffer, Ladewirkungsgrad, Maximale Ladeleistung, Günstiger Preis, Wartezeit bei Richtungswechsel, Entladepuffer, Entladewirkungsgrad, Erwarteter Hausverbrauch, Teurer Preis, Einspeisefaktor, Einspeiseaufschlag und 30 weitere
  • AuswahlfelderZählerquelle, Wandlermodus, Notstrommodus, PV-Einspeisung, Lüftermodus, Externer Zähler, Entscheidung, Modus bei günstigem Preis, Modus bei teurem Preis, Netznorm, Modus dazwischen, Betriebsmodus und 1 weitere
  • SensorenLüfterstufe, Batteriezustand, AC-Zustand, DC-Zustand, PV-Zustand, SOC-Grenzstatus, SOC-Kalibrierstatus, Reglerstatus, Status, Plan, Scheinleistung Phase A, AC-Kopplungsstatus und 78 weitere
  • SchalterLüfter dauerhaft an, Saldierung (Einspeisung = Bezugspreis), Flash-Schreiben überspringen, Trace-Aufzeichnung, Mitmachen

Fehlerbehebung

  • DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
  • ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:Hat mit einem Limit neu gestartet, Meldet neue Eigenschaften

Aus der README

Your Zendure SolarFlow battery in Home Assistant, 100% local, in three steps. No cloud account, no MQTT broker, no YAML packages to copy. Install it from HACS, add your battery, pick a mode — the battery holds your grid at zero, once a second.

⚖️ Zero export, once a second. The battery holds your grid connection at zero (Dutch: nul op de meter, NOM). A fast loop reads your meter every second and corrects evenly on both sides of zero: what your solar panels would send to the grid goes into the battery, and what the house would take from the grid comes out of it, without swinging from one to the other.

Aus der README von windsurf/hassio-zendure-restapi, Apache License 2.0. Gekürzt.

Informationen

Installationen
74 teilen Analysedaten
GitHub-Sterne
14
Verbindung
Funktioniert lokal
Pflege
In den letzten 6 Monaten aktualisiert
Version
v1.7.6,
Kategorie
Energie, Solar und Batteriespeicher
Art
Marketplace-Integration
Marke
Zendure
Voraussetzung
Braucht den Marketplace (HACS bis Home Assistant 2026.10)
Domain
zendure_restapi

Mehr von Zendure

Das könnte dir auch gefallen

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

Auf der Suche nach einer App? Die passende Home Assistant App fürs iPhone, nach Bedarf.