Files
battery-charging-optimizer/openems/legacy/v3/00_START_HIER_SECTIONS.md
felix.zoesch 0fa03a566a feat: Major update - Battery Optimizer v3.4.0 with comprehensive fixes
## 🎯 Hauptänderungen

### Version 3.4.0 - SOC-Drift & Charging Capacity
-  Sicherheitspuffer (20-50% konfigurierbar) für untertägige SOC-Schwankungen
-  Monatliche automatische Batterie-Kalibrierung
- 🐛 SOC-Plausibilitäts-Check (filtert 65535% Spikes beim Modus-Wechsel)
- 🐛 Zeitabhängige API-Abfrage (vor/nach 14:00 Uhr)

### Neue Features
- 🔋 **Safety Buffer**: Kompensiert SOC-Drift und Eigenverbrauch
- 🔋 **Auto-Calibration**: Monatlicher Vollzyklus für SOC-Genauigkeit
- 🔋 **Spike Protection**: 4-fach Schutz gegen ungültige SOC-Werte
- 🔋 **Smart API**: Verhindert HTTP 500 Errors bei fehlenden Tomorrow-Preisen

### Dokumentation
- 📚 SOC_CALIBRATION_GUIDE.md - Umfassender Kalibrierungs-Guide
- 📚 FIX_CHARGING_CAPACITY.md - Sicherheitspuffer-Dokumentation
- 📚 FIX_SOC_SPIKE_PROBLEM.md - Spike-Protection-Lösung
- 📚 FIX_API_TIMING.md - Zeitabhängige API-Abfrage
- 📚 DIAGNOSE_LADE_PROBLEM.md - Debug-Guide

### Neue Dateien
- battery_calibration_automation.yaml - 4 Automations für Kalibrierung
- battery_calibration_input_helper.yaml - Input Helper Config
- battery_optimizer_input_helper_safety_buffer.yaml - Puffer Config
- debug_schedule.py - Umfassendes Debug-Script

### Scripts
- battery_charging_optimizer.py v3.4.0
- hastrom_flex_extended.py v1.1.0
- debug_schedule.py v1.0.0

### Fixes
- 🐛 SOC springt auf 65535% beim ESS-Modus-Wechsel → Debounce + Plausibilitäts-Check
- 🐛 API-HTTP-500 vor 14:00 → Zeitabhängige Abfrage
- 🐛 Batterie nicht bis 100% geladen → Sicherheitspuffer
- 🐛 SOC driftet ohne Vollzyklen → Automatische Kalibrierung

## 🚀 Installation

1. Input Helper erstellen (siehe battery_optimizer_input_helper_safety_buffer.yaml)
2. Automations installieren (siehe battery_calibration_automation.yaml)
3. Scripts aktualisieren (battery_charging_optimizer.py v3.4.0)
4. PyScript neu laden

## 📊 Verbesserungen

- Präzisere Ladeplanung durch Sicherheitspuffer
- Robustheit gegen SOC-Drift
- Keine API-Fehler mehr vor 14:00
- Hardware-Stopp bei 100% wird respektiert
- Bessere Batterie-Gesundheit durch regelmäßige Kalibrierung

🤖 Generated with Claude Code (claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-12 08:04:07 +01:00

5.5 KiB
Raw Blame History

🎯 Dashboard mit SECTIONS-Layout (AKTUELL!)

Das solltest du wissen

Ich habe 3 neue Dashboards mit dem modernen Sections-Layout erstellt!

🆕 Sections-Layout (EMPFOHLEN)

Das neue Layout ist seit Home Assistant 2024.x der Standard und bietet:

Bessere Organisation durch Section-Überschriften
Automatisches responsive Grid-System
Einfachere Anpassung und Wartung
Moderne Struktur mit max_columns
Zukunftssicher und von HA unterstützt


📦 Verfügbare Dashboards

🆕 SECTIONS-LAYOUT (2024.x) - NUTZE DIESE!

Datei Sections Beste für
battery_optimizer_sections_compact.yaml 7 Tablet/Desktop
battery_optimizer_sections_minimal.yaml 7 Smartphone
battery_optimizer_sections_standard.yaml 10 Desktop Detail

📜 Klassisches Layout (Fallback)

Falls dein Home Assistant älter als 2024.2 ist:

  • battery_optimizer_dashboard_compact.yaml
  • battery_optimizer_dashboard_minimal.yaml
  • battery_optimizer_dashboard.yaml

🚀 Quick-Start (3 Minuten)

Schritt 1: Dashboard erstellen

  1. Home Assistant → EinstellungenDashboards
  2. "+ Dashboard hinzufügen"
  3. "Mit Sections erstellen" (Wichtig!)
  4. Name: Batterie Optimierung
  5. Icon: mdi:battery-charging
  6. "Erstellen"

Schritt 2: Code einfügen

  1. (3 Punkte oben rechts) → "Rohe Konfiguration bearbeiten"
  2. Alles löschen
  3. Kopiere Inhalt von battery_optimizer_sections_compact.yaml
  4. Einfügen
  5. "Speichern"

Schritt 3: Entity-IDs anpassen

Prüfe in EntwicklerwerkzeugeZustände ob diese Entities existieren:

sensor.openems_ess0_activepower
sensor.esssoc
sensor.openems_grid_activepower
sensor.hastrom_flex_extended_current_price
pyscript.battery_charging_plan

Falls anders: Im Dashboard mit Suchen & Ersetzen anpassen!

Schritt 4: Fertig! 🎉

Navigiere zu: Sidebar"Batterie Optimierung"


💡 Meine Empfehlung

Starte mit:

📄 battery_optimizer_sections_compact.yaml
📊 7 Sections
📱 Perfekt für Desktop + Tablet
⚡ max_columns: 4

Warum?

  • Beste Balance zwischen Detail und Übersicht
  • Nutzt alle deine HACS Cards optimal
  • Funktioniert super auf allen Geräten
  • Nicht überladen, aber vollständig

📖 Dokumentation

Datei Inhalt
README_SECTIONS.md Sections-Layout Anleitung
QUICKSTART.md Schnellstart (für altes Layout)
README_Dashboard.md Vollständige Anleitung
DASHBOARD_COMPARISON.md Visueller Vergleich

🎨 Section-Übersicht (Kompakt)

Die Kompakt-Version enthält 7 Sections:

  1. 🏠 Status & Steuerung

    • Power Flow Card
    • Auto/Manuell Toggles
    • Quick-Status (SOC, Preis)
  2. 📅 Ladeplanung

    • Plan-Status
    • Nächste Ladung
    • Kompakte Plan-Liste
  3. 💶 Strompreis-Visualisierung

    • 48h Preis-Graph
    • Geplante Ladungen als Marker
  4. 🔋 Batterie-Übersicht

    • 24h SOC & Leistung Graph
    • Dual-Achsen
  5. 📋 Detaillierter Plan

    • Statistik-Bubble-Cards
    • Vollständige Plan-Tabelle
  6. ⚙️ Einstellungen

    • Alle Parameter
    • Min/Max SOC, Ladeleistung, etc.
  7. System

    • OpenEMS Status
    • PV-Prognosen
    • Automation-Status

🔧 Anpassungen

Spaltenanzahl ändern:

type: sections
max_columns: 3  # Statt 4 für weniger Spalten

Section entfernen:

Einfach die komplette Section löschen (von - type: grid bis zur nächsten Section)

Reihenfolge ändern:

Sections im YAML nach oben/unten verschieben


📱 Responsive Verhalten

Das Sections-Layout passt sich automatisch an:

  • Desktop (>1920px): 4 Spalten nebeneinander
  • Laptop (1366-1920px): 3-4 Spalten
  • Tablet (768-1366px): 2-3 Spalten
  • Smartphone (<768px): 1 Spalte

Kein manuelles Responsive-CSS nötig! 🎯


Voraussetzungen

  • Home Assistant 2024.2 oder neuer
  • HACS Custom Cards:
    • Bubble Card
    • Plotly Graph Card
    • Power Flow Card Plus
    • Stack-in-Card (optional)

Alle bereits bei dir installiert! 🚀


🐛 Fehlerbehebung

"Sections not supported"

➜ Home Assistant auf 2024.2+ updaten
➜ Oder: Klassisches Layout nutzen

Cards werden nicht angezeigt

➜ Browser-Cache leeren (Strg+Shift+R)
➜ Home Assistant neu starten

Plotly zeigt keine Daten

➜ Prüfe Entity-Historie in Developer Tools
➜ Recorder-Integration prüfen


🎯 Nächste Schritte

Nach Dashboard-Installation:

  1. Plan-Historie implementieren
  2. InfluxDB-Integration erweitern
  3. Notifications einrichten
  4. Grafana-Dashboard als Alternative

Womit möchtest du weitermachen?


🆚 Sections vs. Klassisch

Feature Sections Klassisch
HA Version 2024.2+ Alle
Struktur Modern Traditionell
Responsive Automatisch Manuell
Überschriften Integriert Manuell
Wartung Einfacher Komplexer
Zukunft Standard ⚠️ Legacy

Empfehlung: Nutze Sections wenn möglich! 🚀


🎉 Los geht's!

Starte jetzt:

  1. 📖 Lies: README_SECTIONS.md
  2. 📄 Öffne: battery_optimizer_sections_compact.yaml
  3. 🚀 Folge: Quick-Start oben
  4. Teste: Auf verschiedenen Geräten

Viel Erfolg mit deinem modernen Dashboard! 🎊


Erstellt: 16. November 2025
Layout: Home Assistant Sections (2024.x)
Empfohlung: COMPACT-Version