v0.4.0

Backup Helpers\n- Optionaler Backup-Helper-Layer per Options Flow aktivierbar\n- Neue Binary-Sensoren für Stromausfall, aktive Backup-Versorgung und kritische Reserve\n- Neue Hilfssensoren für geschätzte Restlaufzeit, nutzbare Energie und empfohlene Aktion\n- Stromausfall-Erkennung als konservative Heuristik mit Frequenz-, Netzleistungs- und Lastprüfung\n- README mit Erklärung und Automationsbeispielen erweitert\n- Unit-Tests für die Kernlogik von backup_helpers ergänzt

v0.3.6

Added

• Gap reconciliation for MQTT disconnects in energy accumulators.
• Connection sensor now exposes gap metadata (last_gap_started_at, last_gap_ended_at, last_gap_seconds, gap_event_id).
• Diagnostics now include gap reconciliation metadata.

Changed

• Energy accumulation during reconnect no longer assumes last power for the full offline duration.
• For detected gaps, estimated gap energy is calculated via trapezoidal interpolation between last pre-disconnect power and first post-reconnect power.

Safety

• Gap reconciliation only applies for outages between 60 seconds and 6 hours.
• Longer outages are logged and skipped to avoid unrealistic corrections.

v0.3.1

v0.3.1

• Fix: Leistungs-Mapping fuer Hausverbrauch/Netz/Batterie robust normalisiert
• Fix: Energiezaehler (Bezug/Einspeisung, Batterie-Ladung/Entnahme) nutzen konsistente Vorzeichenlogik
• Maintenance: manifest.json Version auf 0.3.1 erhoeht

v0.3.0 — Neue Sensoren, Options Flow, Verbindungsstatus

Neue Features

Neue Sensoren

Sensor	Einheit	Standard
MOSFET-Temperatur (pro Batterie-Pack)	°C	deaktiviert
Batterie-Gesamtenergie	Wh	aktiv
Aktive Batterie-Module	—	aktiv
DC-Bus-Spannung	V	deaktiviert
Phase L1/L2/L3 Blindleistung	var	deaktiviert
Phase L1/L2/L3 Scheinleistung	VA	deaktiviert
MPPT 1–4 Spannung	V	deaktiviert
MPPT 1–4 Strom	A	deaktiviert
Verbindungsstatus (connected/disconnected)	—	aktiv

Options Flow

Die Anzahl der Batterie-Packs kann jetzt nachträglich geändert werden:
Einstellungen → Geräte & Dienste → EcoFlow PowerOcean → Konfigurieren

Die Integration lädt sich danach automatisch neu — kein manueller Neustart nötig.

Update

HACS → EcoFlow PowerOcean → Aktualisieren → Home Assistant neu starten

v0.2.3 — Netzfrequenz-Fix

Bugfix

Netzfrequenz zeigt jetzt „Nicht verfügbar" statt „0 Hz" — das Gerät sendet diesen Wert nicht zuverlässig.

Hinweise zu aktuell bekannten Punkten

Batterie-Wechselrichterleistung „Nicht verfügbar": Stale-Entität aus v0.2.0. Bitte manuell löschen:
Einstellungen → Geräte & Dienste → EcoFlow PowerOcean → Entitäten → „Batterie-Wechselrichterleistung" → Löschen

Solar-Leistung höher als MPPT 1 + MPPT 2: MPPT 3 ist standardmäßig deaktiviert. Falls vorhanden aktivieren:
Einstellungen → Geräte & Dienste → EcoFlow PowerOcean → Entitäten → „MPPT 3 Leistung" → Aktivieren

v0.2.2 — Energie-Dashboard ohne YAML

Energie-Dashboard direkt nutzbar — kein YAML nötig

Neue kWh-Sensoren (direkt im Energie-Dashboard auswählbar)

Sensor	Für Energie-Dashboard
Solar-Energie	Solar → Solaranlage
Netz-Bezug	Netz → Strom aus dem Netz
Netz-Einspeisung	Netz → Strom zurück ins Netz
Batterie-Entnahme	Heimspeicher → Energie ins System
Batterie-Ladung	Heimspeicher → Energie aus dem System

Außerdem: Gesamt-Ladestand (%) für Heimspeicher → Aktueller Ladestand.

Technisches

• Riemann-Summe (Links-Methode) integriert W → kWh in Echtzeit
• Werte werden nach HA-Neustart automatisch wiederhergestellt (RestoreSensor)
• Bidirektionale Sensoren (Netz, Batterie) werden intern aufgeteilt
• device_class: energy, state_class: total_increasing → erscheinen automatisch in allen Energie-Dashboard-Dropdowns

Upgrade

HACS → EcoFlow PowerOcean → Aktualisieren → HA neu starten.
Die 5 neuen kWh-Sensoren erscheinen dann direkt unter Geräte & Dienste.

v0.2.1 — Energiefluss-Sensoren Fix

Bugfix: Solar-, Netz- und Last-Sensoren jetzt verfügbar

Problem

Das Gerät sendet JTS1_ENERGY_STREAM_REPORT (cmdId=33) nicht — daher zeigten Solar-Leistung, Netz-Leistung, Hausverbrauch, Batterie-Gesamtleistung und Gesamt-SOC alle „Nicht verfügbar".

Lösung

Die Werte werden jetzt aus den zuverlässig gesendeten JTS1_EMS_HEARTBEAT-Daten berechnet:

Sensor	Berechnung
Solar-Leistung	Summe der MPPT-String-Leistungen
Netz-Leistung	Summe der Phasen-Wirkleistungen (negativ = Einspeisung)
Hausverbrauch	Energiebilanz: Solar + Batterie + Netz
Batterie-Gesamtleistung	emsBpPower aus EMS_HEARTBEAT
Gesamt-Ladestand	Durchschnitt der Pack-SOCs

Entfernt

• Sensor „Batterie-Wechselrichterleistung" (war identisch mit „Batterie-Gesamtleistung")

Upgrade

Integration über HACS aktualisieren und Home Assistant neu starten.

v0.2.0 — Alle API-Sensoren

Was ist neu in v0.2.0

Neue Sensoren

Systemweite Energiefluss-Sensoren (aus JTS1_ENERGY_STREAM_REPORT):

• Solar-Leistung (W) — PV-Gesamtertrag
• Netz-Leistung (W) — Bezug positiv, Einspeisung negativ
• Hausverbrauch (W) — aktuelle Lastleistung
• Batterie-Gesamtleistung (W) — Entladen positiv, Laden negativ
• Gesamt-Ladestand (%) — kombinierter SOC aller Packs

Wechselrichter- und 3-Phasen-Sensoren (aus JTS1_EMS_HEARTBEAT):

• Phase L1/L2/L3 Spannung (V)
• Phase L1/L2/L3 Strom (A)
• Phase L1/L2/L3 Leistung (W)
• Netzfrequenz (Hz)
• Batterie-Wechselrichterleistung (W)
• MPPT 1/2 Leistung (W) — standardmäßig aktiv
• MPPT 3/4 Leistung (W) — standardmäßig deaktiviert

Energie-Dashboard

Die README enthält jetzt eine vollständige Anleitung zur Einrichtung des HA Energie-Dashboards mit Template-Sensoren und Integral-Helfern.

Upgrade

Integration über HACS aktualisieren und Home Assistant neu starten. Keine Änderungen an der Konfiguration erforderlich — alle neuen Entitäten erscheinen automatisch.

v0.1.4 — Fix: MQTT Client-ID Format korrigiert

Bugfix: MQTT "Not authorized" (Root Cause)

EcoFlow's MQTT-Broker akzeptiert nur Client-IDs im Format ANDROID_{uuid}_{user_id} — exakt wie die EcoFlow App selbst. Alle anderen Formate (HA_EcoFlow_*, certificateAccount usw.) werden sofort mit "Not authorized" abgelehnt.

Die UUID wird deterministisch aus der Seriennummer berechnet, sodass nach jedem HA-Neustart dieselbe Client-ID verwendet wird und das EcoFlow-Limit von 10 neuen Client-IDs/Tag nicht überschritten wird.

---

Update-Anleitung

HACS → Update auf 0.1.4 → HA neu starten — kein Neu-Einrichten nötig.

v0.1.3 — Fix: MQTT "Not authorized"

Bugfix: MQTT-Verbindung schlägt fehl mit "Not authorized"

EcoFlow's MQTT-Broker akzeptiert nur Client-IDs, die dem certificateAccount-Wert aus der Certification-API entsprechen. Die bisherige Client-ID HA_EcoFlow_{Seriennummer} wurde vom Broker mit "Not authorized" sofort abgelehnt — daher blieben alle Sensoren auf "Unavailable".

Fix: Die Client-ID wird jetzt auf den certificateAccount-Wert gesetzt (z. B. app-5d108c3d...).

---

Update-Anleitung

HACS → Update auf 0.1.3 → HA neu starten

Kein Neu-Einrichten der Integration nötig.