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.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

200 lines
5.1 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-Überarbeitung: Batterie-Optimierung
## 📦 Was ist enthalten?
Ich habe **3 komplett überarbeitete Dashboard-Varianten** für dein Batterie-Optimierungssystem erstellt:
### ✨ Die Dashboards
| Datei | Größe | Beste für | Spalten |
|-------|-------|-----------|---------|
| **battery_optimizer_dashboard.yaml** | 11 KB | Desktop, Details | 2-4 |
| **battery_optimizer_dashboard_compact.yaml** | 8 KB | Tablet, Balance | 2-4 |
| **battery_optimizer_dashboard_minimal.yaml** | 6 KB | Smartphone, Quick | 2-3 |
### 📖 Die Dokumentation
| Datei | Beschreibung |
|-------|--------------|
| **QUICKSTART.md** | ⚡ 3-Minuten Installation |
| **README_Dashboard.md** | 📚 Vollständige Anleitung |
| **DASHBOARD_COMPARISON.md** | 📊 Visueller Vergleich |
---
## 🚀 Los geht's!
### Für Eilige (3 Minuten):
👉 **Lies zuerst: `QUICKSTART.md`**
### Für Detailverliebte (10 Minuten):
👉 **Lies zuerst: `README_Dashboard.md`**
### Für Unentschlossene (5 Minuten):
👉 **Lies zuerst: `DASHBOARD_COMPARISON.md`**
---
## 🎨 Hauptunterschiede
### Was ist neu gegenüber dem alten Dashboard?
✅ **Maximal 4 Spalten** - keine unübersichtlichen 6+ Spalten mehr
✅ **Moderne Cards** - Bubble Cards & Stack-in-Card statt nur Entities
✅ **Power Flow Visualisierung** - Energie-Fluss auf einen Blick
✅ **Bessere Graphen** - Plotly statt einfachen History Graphs
✅ **Responsive Layout** - Passt sich an Desktop/Tablet/Smartphone an
✅ **Klare Struktur** - Logische Gruppierung nach Funktion
✅ **Weniger Scroll** - Kompaktere Darstellung wichtiger Infos
---
## 💡 Meine Empfehlung für dich
Basierend auf deinem Setup würde ich starten mit:
**1. Wahl: KOMPAKT-Version**
- Beste Balance zwischen Detail und Übersicht
- Nutzt deine installierten HACS Cards optimal
- Funktioniert super auf Tablet UND Desktop
- Nicht zu überladen, aber alle wichtigen Infos
**Datei:** `battery_optimizer_dashboard_compact.yaml`
---
## 🔧 Verwendete Custom Cards
Alle diese Cards hast du bereits via HACS installiert:
- ✅ **Bubble Card** - Moderne Buttons & Toggles
- ✅ **Plotly Graph Card** - Interaktive Graphen
- ✅ **Power Flow Card Plus** - Energie-Visualisierung
- ✅ **Stack-in-Card** - Kompaktes Layout
➡️ **Keine zusätzlichen Installationen nötig!**
---
## 📱 Geräte-Empfehlungen
| Dein Gerät | Dashboard-Version |
|------------|-------------------|
| 💻 Desktop (>1920px) | KOMPAKT oder STANDARD |
| 💻 Laptop (1366-1920px) | KOMPAKT ⭐ |
| 📱 Tablet (768-1366px) | KOMPAKT ⭐⭐⭐ |
| 📱 Smartphone (<768px) | MINIMAL ⭐⭐⭐ |
| 🖼️ Wall Panel (fest) | KOMPAKT oder MINIMAL |
---
## ⚠️ Wichtig vor der Installation
### Entity-IDs prüfen!
Die Dashboards verwenden diese Entities - **prüfe ob sie bei dir existieren:**
```yaml
# Hauptentities:
sensor.openems_ess0_activepower # Batterie-Leistung
sensor.esssoc # Batterie SOC
sensor.openems_grid_activepower # Netz
sensor.openems_production_activepower # PV
sensor.hastrom_flex_extended_current_price # Preis
# Plan-Entities:
pyscript.battery_charging_plan # Ladeplan
sensor.battery_charging_plan_status # Status
sensor.battery_next_charge_time # Nächste Ladung
# Steuerung:
input_boolean.battery_optimizer_enabled
input_boolean.goodwe_manual_control
```
**So prüfst du:**
1. Home Assistant → **Entwicklerwerkzeuge** → **Zustände**
2. Suche nach den Entity-IDs
3. Falls anders: Im Dashboard anpassen (Suchen & Ersetzen)
---
## 🎯 Nächste Schritte
Nach erfolgreicher Dashboard-Installation:
1. ✅ **Plan-Historie implementieren** (aus vorigem Chat)
2. ✅ **InfluxDB-Integration** für Langzeitdaten
3. ✅ **Notifications** bei Ladestart/-ende
4. ✅ **Grafana-Dashboard** als Alternative
Willst du mit einem dieser Punkte weitermachen?
---
## 📊 Visualisierung
### Was zeigen die Dashboards?
**Alle Versionen zeigen:**
- 🔋 Energie-Fluss (Power Flow Card)
- 📅 Geplante Ladestunden
- 💶 Strompreis-Verlauf
- 📈 Batterie SOC-Trend
- 🎛️ Steuerung (Auto/Manuell)
**Zusätzlich in Standard/Kompakt:**
- ⚡ Energie-Flüsse (PV/Netz/Batterie)
- 📊 Detaillierte Plan-Statistiken
- 🗂️ Vollständige Plan-Tabelle
**Nur in Standard:**
- ℹ️ Erweiterte System-Infos
- 🔍 Noch mehr Details
---
## ✅ Installation Checklist
- [ ] Dashboard-Variante gewählt
- [ ] `QUICKSTART.md` gelesen
- [ ] Entity-IDs geprüft
- [ ] YAML-Datei in HA eingefügt
- [ ] Browser-Cache geleert
- [ ] Dashboard getestet
- [ ] Auf verschiedenen Geräten geprüft
---
## 🆘 Bei Problemen
**Erste Hilfe:**
1. Browser-Cache leeren (Strg+Shift+R)
2. Entity-IDs in Developer Tools prüfen
3. Home Assistant Logs checken
4. Browser-Konsole checken (F12)
**Dokumentation:**
- `QUICKSTART.md` → Häufige Anpassungen
- `README_Dashboard.md` → Fehlerbehebung
---
## 🎉 Los geht's!
**Starte jetzt mit:**
```
1. Öffne: QUICKSTART.md
2. Wähle: battery_optimizer_dashboard_compact.yaml
3. Folge: 3-Minuten-Setup
4. Fertig! 🚀
```
Viel Erfolg mit deinem neuen Dashboard!
---
**Erstellt:** 16. November 2025
**Für:** Felix's Batterie-Optimierungssystem
**Version:** 1.0
Reference in New Issue View Git Blame Copy Permalink