Skip to content

Earnie 2.7.0-beta.1

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 29 Oct 09:58
· 624 commits to main since this release

Earnie 2.7.0-beta.1

Erste Beta der Linie 2.7: mehrere Speicher und Wechselrichter, Push-only-Anbindung und Migrationsassistent – jetzt mit korrekter Aufteilung des Batterie-Wirkungsgrads bei der Migration, Watchdog im Home-Assistant-Paket und behobener Zeitverschiebung bei den Wetterdaten.

  • Nach dem Update: Konfigurationsmigration per Assistent, mit automatischem Backup
  • Falls schon eine Migration von 2.6 erfolgt ist: Batterie-Wirkungsgrad im Hauskonfigurator prüfen
  • Mehrere Batterien / Powerstations und Wechselrichter als eigene Einheit
  • Home Assistant und Loxone: nur noch Push; Batterieleistung beim Entladen positiv
  • Home Assistant: Watchdog gibt erzwungene Batterieleistung frei, wenn Earnie ausfällt
  • Wetterprognose und Wetterarchiv nicht mehr um eine Stunde verschoben
  • Neuer Knopf „Jetzt neu berechnen“ auf der Seite Optimierer-Dienst

Vorabversion (Community-Test) – keine offizielle Version. Nicht :latest verwenden, sondern :next oder den Versions-Tag pinnen. Diese Vorabversion enthält die 2.7-Änderungen gegenüber dem letzten öffentlichen Release 2.6.2 (:latest). Orientierungsstand in der Vorabversions-Linie: folgt auf 2.7.0-alpha.9.

Breaking / Bitte prüfen

  • Konfigurationsmigration nach dem Update. Earnie verlangt nach dem Update eine Migration der Konfigurationsdateien (Streamlit-Assistent). Der Optimierer-Dienst startet erst danach. Es wird automatisch ein Backup angelegt; ein Downgrade ist nicht möglich. Details siehe Abschnitt „Datenmodell & Migration“.
  • Wer schon mit einer 2.7-Vorabversion von 2.6 migriert hat: Batterie-Wirkungsgrad prüfen. Die Migration hat den Wirkungsgrad des Wechselrichters (η_inv, Vorgabe 0,97) gesetzt, den bisherigen Batterie-Wirkungsgrad aber nicht aufgeteilt. Der Speicherpfad rechnet dann mit beiden Werten, z. B. 0,97 × 0,97 ≈ 0,94 statt 0,97 pro Richtung. Die Migration teilt jetzt richtig auf und zeigt die neuen Werte an. Bereits migrierte Konfigurationen werden nicht nachträglich korrigiert: Im Hauskonfigurator den Wirkungsgrad der Batterie (η_batt) so setzen, dass η_inv × η_batt dem früheren Wert aus 2.6 entspricht (früherer Wert ÷ η_inv, z. B. 0,97 ÷ 0,97 = 1,0).
  • Home Assistant: nur noch Push. Der Pull-Transport entfällt; Mapping und Carrier-YAML müssen zum Push-Vertrag passen (Migration dm4.ha_pull_removal).
  • Home Assistant: altes ehal.ha.sign aus 2.6. Steht in der Konfiguration noch ein Vorzeichen aus 2.6, fragt der Migrationsassistent, ob es bleiben oder entfernt werden soll. Liefert Home Assistant die Werte bereits im Earnie-Vorzeichen, würden sie sonst doppelt gedreht. Danach in EHAL-Com Live-Lesen prüfen.
  • PV am Wechselrichter Pflicht. Statt flachem Anlagen-PV (sens_pv_production_active) ist inv.*.sens_inv_power_pv erforderlich, wenn dem Wechselrichter PV zugeordnet ist. Migration dm4.retire_plant_pv_binding übernimmt vorhandene Zuordnungen.
  • Loxone Heartbeats umbenannt. Lesen heartbeat_smarthome, Schreiben heartbeat_earnie (beide Pflicht). Alte IDs werden nicht mehr akzeptiert — VO/VI und Signalliste neu exportieren.
  • Home Assistant / Loxone: Vorzeichen der Batterieleistung prüfen. Earnie rechnet den Hausverbrauch durchgehend als PV + Netz + Batterie (Netz + = Bezug, Batterie + = Entladen, Vorzeichenkonvention). Batterie-Entity / Earnie_Batterie_Leistung muss beim Entladen positiv sein; Earnie dreht nicht mehr. (Hinweis: dieselbe Vorzeichenregel gilt bereits seit öffentlichem 2.6.2 – bitte trotzdem prüfen, falls noch nicht geschehen.)
  • Loxone: Signalnamen/Merker. Anbindung nur noch über Push und status.json; Vorlagen müssen zu den aktuellen Exporten passen (VI_Earnie_* / VO_Earnie_*).

Neu seit 2.7.0-alpha.9 (Kurzüberblick)

Wer alpha.9 schon nutzt, findet hier nur das, was seitdem dazugekommen ist. Die übrigen Abschnitte beschreiben alle Änderungen von 2.7 gegenüber 2.6.2; die Punkte unten stehen dort noch einmal ausführlicher.

  • Migration: Batterie-Wirkungsgrad wird beim Weg von 2.6 korrekt auf Wechselrichter und Batterie aufgeteilt (siehe „Bitte prüfen“).
  • Migration: neue Rückfrage zu einem alten ehal.ha.sign; der Assistent erklärt die PV-Zuordnung, zeigt danach den Bericht und startet den Optimierer-Dienst bei Auto-Start direkt.
  • Home Assistant: Watchdog im YAML-Paket, Export-Hinweis auf das YAML-Paket, input_number als Ziel; Live-Lesen zeigt Werte nach ehal.ha.sign.
  • Wetterdaten: Prognose und Archiv von Open-Meteo sind seit der Zeitumstellung nicht mehr um eine Stunde verschoben.
  • Szenario-Explorer: Dauerverbraucher fehlen nicht mehr im Jahresverbrauch der optimierten Szenarien; die Referenz bucht den Batterie-Standby nur einmal.
  • Tarife: Mehrwertsteuer auf die Netto-Netznutzung bei Brutto-Bezugstarifen; Warnung, wenn ein Abrechnungsaufschlag bei Festpreis- oder Monatstarif ignoriert wird.
  • Optimierer-Dienst: Knopf „Jetzt neu berechnen“.
  • EU-Marktdaten: keine Endlosschleife mehr, wenn der Server nicht erreichbar ist.
  • Signalexport: eine eingefügte Adresse mit http(s):// im Feld Earnie-Host wird bereinigt.

Highlights

  • Mehrere Batterien und Powerstations: Mehrere Batterien bzw. Batterie-Wechselrichter-Einheiten in der Optimierung; Powerstations als Reserve oder Standby-Backup. Live-SoC- und Ladegrenzen (get_ess_*) begrenzen die Planung auch für Standby-Packs.
  • Wechselrichter als eigene Einheit: PV-Strings, Batterien und Hybrid-Wechselrichter mit Leistungsgrenzen; PV-Summe über Wechselrichter statt flachem Anlagen-PV.
  • Eindeutige Bindings – Kennung, Einheit und Vorzeichen: Fest definierte Kennungen, Einheiten und Vorzeichen; Umrechnung zentral. Home Assistant und Loxone teilen denselben Signalvertrag (Push).
  • Konfigurations-Migrationsassistent: Strukturelle Änderungen über Assistent mit Vorschau, Rückfragen, Bericht und Backup.
  • Deutlich schnellere und pünktlichere Zyklen: Start kurz vor dem Viertelstundentakt; Sollwerte zum Takt.
  • Robusterer und präziserer Szenario-Explorer: zusammenhängende Sunrise-Buchfenster, Flex nur im Buchfenster; Kennzahlen zeigen den gebuchten Verbrauch – optimierte Szenarien mit gleichen Zielen haben denselben Gesamtverbrauch.

Neue Funktionen (seit 2.6.2)

  • Home Assistant Push-only: gemeinsamer Signalvertrag für alle Backends; Pull-Transport entfernt.
  • Home Assistant Watchdog: Das YAML-Paket gibt eine erzwungene Batterie-Wirkleistung wieder frei, wenn Earnie nicht mehr erreichbar ist. Ziele können jetzt auch input_number-Entities sein.
  • „Jetzt neu berechnen“: Knopf auf der Seite Optimierer-Dienst stößt sofort einen neuen Optimierungslauf an, statt auf die nächste Viertelstunde zu warten.
  • Bezeichnung PV-Feld / PV-Felder in UI und Anwenderdocs (JSON-Schlüssel unverändert).
  • Verbessertes Wärmemodell: gekoppeltes Modell Haus / Wärmespeicher / Solarthermie mit neuen Diagrammen.
  • Zusätzliche Batterieparameter: Grenzwerte live vom Gerät.
  • Strompreis: ENTSO-E zuerst; zeitabhängiger Netznutzungs-Arbeitspreis (Österreich).
  • E-Auto: verbesserte Rückkehr-/Anschlussprognose.
  • EHAL-Com: Signalliste, Live-Lesen/-Schreiben, Zuordnung pro Batterie.

Verbesserungen & Korrekturen

  • Migration 2.6 → 2.7, Batterie-Wirkungsgrad: Der bisherige Gesamtwirkungsgrad wird jetzt auf Wechselrichter (η_inv) und Batterie (η_batt) aufgeteilt, statt den Wechselrichter-Wirkungsgrad zusätzlich anzusetzen. Der Assistent zeigt die neuen Werte an.
  • Migrationsassistent: erklärt, wie er die PV-Felder zugeordnet hat (auch beim Weg von 2.6) und wann der Optimierer-Dienst startet; zeigt nach dem Lauf den Migrationsbericht; startet den Optimierer-Dienst direkt nach erfolgreicher Migration, wenn Auto-Start aktiv ist.
  • Start mit älterer Konfiguration (u. a. Home Assistant Add-on): Enthielt die Konfiguration noch Altlasten wie ehal.ha.transport, brach Earnie beim Start mit „Abbruch“ ab, bevor der Migrationsassistent erreichbar war. Der Assistent wird jetzt vor dem Laden der Konfiguration angeboten.
  • Wetterdaten (Open-Meteo): Prognose und Archiv waren nach der Zeitumstellung um eine Stunde verschoben, weil für die ganze Abfrage ein fester UTC-Versatz galt. Earnie fragt jetzt in UTC ab und rechnet pro Zeitpunkt in die Planungszeitzone um.
  • Szenario-Explorer, Jahresverbrauch: Ein Dauerverbraucher (z. B. 24 h an 7 Tagen) fehlte in den optimierten Szenarien und wird jetzt als fester Verbrauch gebucht. Die nicht optimierte Referenz hat den Batterie-Standby doppelt gebucht.
  • Tarife: Bei Brutto-Bezugstarifen wird die netto eingetragene Netznutzung jetzt mit Mehrwertsteuer gerechnet. Ein Abrechnungsaufschlag (settlement_fee_cent_kwh) wirkt nur bei Spot-Tarifen; bei Festpreis- und Monatstarifen warnt Earnie beim Laden, dass er ignoriert wird.
  • EU-Marktdaten: Ist der Server nicht erreichbar, fragt Earnie höchstens einmal pro Stunde neu an, statt in einer Schleife zu wiederholen.
  • Signalexport (Loxone / Home Assistant): Eine eingefügte Browser-Adresse im Feld Earnie-Host wird auf den Hostnamen gekürzt; Port oder Pfad werden mit einer Meldung abgelehnt.
  • Home Assistant, Live-Lesen: zeigt gepushte Werte nach Anwendung von ehal.ha.sign, mit Hinweis „Vorzeichen gedreht“ – wie im Live-Zyklus.
  • Detaillierte Simulationsansicht: Monate eines rollierenden 12-Monats-Fensters dem überlappenden Jahr zugeordnet.
  • Live-Cockpit nach PV-Migration: Monitor / Manuelle Geräte bleiben freigeschaltet, wenn PV nur über Wechselrichter gemappt ist und Verbraucher über Bindings angebunden sind.
  • Verbraucher-Bindings: Speicherung typisiert (consumer. / heatpump. / pool.*) statt generischem flex.*.
  • Loxone-Import: Haus Wärme nicht nur auf Verbraucher 1; klarere Speichern-Hinweise; Live-Szenario-Vorbelegung.
  • Signalliste: Heartbeats Pflicht; Earnie-Host-Label und LAN-IP-Vorbelegung.
  • Konfigurationspaket-Import: Einzeldateien auf Kompatibilität geprüft.
  • LoxBerry Update-Hinweis: prüft die Version hinter :latest / :next auf GHCR (OCI-Label), nicht GitHub Releases — damit ein nur für Home Assistant freigegebenes Release kein falsches „Update verfügbar“ für Docker/LoxBerry auslöst.
  • Dokumentation: Abrechnungsaufschlag und Netznutzung in „Preise“ klarer beschrieben; das Benutzerhandbuch erklärt den Viertelstunden-Takt des Optimierer-Dienstes.

Qualität & Stabilität

  • LoxBerry-Plugin-ZIP 0.2.1 mit UI-Text „Versionsvariante“ (separater Plugin-Release).
  • Fehleranalyse (Zyklus-Recorder, opt-out möglich), Pünktlichkeits-Kennzahlen, NTP-Hinweis, Log-Rotation.

Datenmodell & Migration

Das interne Datenmodell wurde grundlegend überarbeitet. Nach dem Update kann Earnie eine Konfigurationsmigration verlangen (Streamlit-Assistent). Der Optimierer-Dienst startet erst danach.

  • Backup: unter dem Config-Verzeichnis backups/pre-migration-dm…-<Zeitstempel>/ (inkl. manifest.json und report.json). Alte Backups bleiben liegen; löschen nur manuell.
  • Kein Downgrade: eine ältere Earnie-Version lehnt ein neueres Datenmodell ab. Rückweg nur durch manuelles Wiederherstellen des Backups.
  • Neu: dm4.ha_sign (Home Assistant): Steht in config.json noch ehal.ha.sign aus 2.6, fragt der Assistent „Behalten“ oder „Entfernen“. „Entfernen“ ist richtig, wenn Home Assistant die Werte bereits im Earnie-Vorzeichen liefert (Netz + = Bezug, Batterie + = Entladen); „Behalten“ nur, wenn die gepushten Werte noch das Hersteller-Vorzeichen tragen. Manuelle To-dos (z. B. Live-Lesen prüfen) berechnet der Assistent beim Migrieren.
  • Korrigiert: Batterie-Wirkungsgrad wird beim Weg von 2.6 auf η_inv × η_batt aufgeteilt. Schon migrierte Konfigurationen bitte von Hand prüfen (siehe „Bitte prüfen“).

Plattformhinweise

Home Assistant

  • Nur noch Push-Transport; Vorzeichen der Batterie-Entity prüfen. Carrier-YAML und Signalliste nach der Migration neu erzeugen – das neue YAML-Paket bringt den Watchdog mit.
  • Add-on: Kanäle earnie (offiziell) und earnie_prerelease. Diese Vorabversion wird für Home Assistant und Docker/LoxBerry freigegeben (targets=both).

LoxBerry / Loxone

  • Push-only; Heartbeat-IDs und Earnie-Exportvorlagen aktualisieren. Telemetrie-Pfad /ehal/telemetry/….
  • Plugin-ZIP 0.2.1 für die UI-Texte „Versionsvariante“ (falls noch nicht installiert).
  • Update-Hinweis „Update verfügbar“ liest die Image-Version von GHCR (:latest / :next); bei „Unbekannt“ war GHCR nicht erreichbar oder das Image stammt noch aus der Zeit vor dem Versions-Label.
  • Einheiten: Leistungsgrenzen in kW.

Synology / Docker · Proxmox

  • Compose-Dateien *-alpha.yml auf Image-Tag 2.7.0-beta.1 bzw. :next nach Promote.
  • Produktiv (*_productive.yml mit :latest) bleibt auf öffentlichem 2.6.2, bis ein offizielles 2.7 erscheint.

Bekannte Einschränkungen

  • forecast.solar liefert im Zyklus kurz vor Mitternacht für den Folgetag keine PV-Prognose (synthetischer Ersatz für einen Zyklus).

Docker images

  • ghcr.io/jochentcc/earnie-energy:2.7.0-beta.1
  • ghcr.io/jochentcc/earnie-energy:next

Not an official release: do not use :latest. Multi-arch: linux/amd64 (Synology / Proxmox) · linux/arm64 (LoxBerry).

docker compose --project-directory . -f docker/compose/synology-alpha.yml pull
docker compose --project-directory . -f docker/compose/synology-alpha.yml up -d

(Same pattern for loxberry-alpha.yml / proxmox-alpha.yml.)