Repository navigation
Earnie 2.7.0-beta.1
Pre-releaseEarnie 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
:latestverwenden, sondern:nextoder 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 auf2.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.signaus 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) istinv.*.sens_inv_power_pverforderlich, wenn dem Wechselrichter PV zugeordnet ist. Migrationdm4.retire_plant_pv_bindingübernimmt vorhandene Zuordnungen. - Loxone Heartbeats umbenannt. Lesen
heartbeat_smarthome, Schreibenheartbeat_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_Leistungmuss 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_numberals Ziel; Live-Lesen zeigt Werte nachehal.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 generischemflex.*. - 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/:nextauf 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.1mit 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.jsonundreport.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 inconfig.jsonnochehal.ha.signaus 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) undearnie_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.1fü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.ymlauf Image-Tag2.7.0-beta.1bzw.:nextnach Promote. - Produktiv (
*_productive.ymlmit: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.1ghcr.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.)