f2daz/battery-charging-optimizer
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
0fa03a566a0114e8f96bf28bbfdaefac305d7e8a
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

251 lines
5.5 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 🎯 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 → **Einstellungen** → **Dashboards**
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 **Entwicklerwerkzeuge** → **Zustände** ob diese Entities existieren:
```yaml
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:
```yaml
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 ⭐
Reference in New Issue View Git Blame Copy Permalink