battery-charging-optimizer/legacy/v3/QUICKSTART.md

🚀 Quick-Start: Dashboard Installation

⚡ 3-Minuten-Setup

Schritt 1: Datei auswählen (10 Sekunden)

Wähle eine der drei Varianten:

• 📊 Standard → battery_optimizer_dashboard.yaml (Desktop)
• 📱 Kompakt → battery_optimizer_dashboard_compact.yaml (Tablet)
• ⚡ Minimal → battery_optimizer_dashboard_minimal.yaml (Smartphone)

Meine Empfehlung für dich: KOMPAKT - beste Balance!

---

Schritt 2: Dashboard hinzufügen (2 Minuten)

Option A: Über die UI (Einfachste Methode)

1. Home Assistant öffnen
2. Klick auf "Einstellungen" → "Dashboards"
3. Klick auf "+ Dashboard hinzufügen"
4. Wähle "Neue Ansicht vom Scratch erstellen"
5. Name: Batterie Optimierung
6. Icon: mdi:battery-charging
7. Klick auf "Erstellen"
8. Klick auf ⋮ (3 Punkte oben rechts) → "Rohe Konfiguration bearbeiten"
9. Lösche alles und füge den Inhalt der YAML-Datei ein
10. Klick auf "Speichern"

Option B: Via Datei (Für Fortgeschrittene)

# Auf deinem Home Assistant Server:
cd /config
mkdir -p dashboards
cp battery_optimizer_dashboard_compact.yaml dashboards/

# In configuration.yaml oder dashboards.yaml ergänzen:
lovelace:
  mode: yaml
  dashboards:
    battery-optimizer:
      mode: yaml
      filename: dashboards/battery_optimizer_dashboard_compact.yaml
      title: Batterie
      icon: mdi:battery-charging
      show_in_sidebar: true

Dann Home Assistant neu starten.

---

Schritt 3: Entity-IDs anpassen (30 Sekunden)

Suchen & Ersetzen in der YAML-Datei:

Öffne die Dashboard-Konfiguration und ersetze diese Platzhalter mit deinen echten Entity-IDs:

# WICHTIG: Prüfe deine echten Entity-IDs unter:
# Entwicklerwerkzeuge → Zustände

# Ersetze:
sensor.battery_charging_plan_status
# Mit (wenn anders):
sensor.deine_plan_status_entity

# Ersetze:
sensor.battery_next_charge_time
# Mit:
sensor.deine_next_charge_entity

# Etc. für alle anderen Entities

Tipp: Nutze Suchen & Ersetzen (Strg+H) in deinem Editor!

---

Schritt 4: Fertig! (0 Sekunden)

✅ Dashboard ist einsatzbereit!

Navigiere zu: Sidebar → "Batterie Optimierung"

---

🔧 Häufige Anpassungen

Fehlende Entity entfernen

Falls eine Entity nicht existiert, einfach auskommentieren oder löschen:

# entities:
#   - entity: sensor.nicht_vorhanden  # ← Auskommentiert mit #
#     name: Nicht verfügbar

Farben ändern

# Plotly Graph Farben anpassen:
line:
  color: '#FF5722'  # Deine Wunschfarbe (Hex-Code)

Online Color Picker: https://htmlcolorcodes.com/

Graph-Zeitraum anpassen

hours_to_show: 24  # Von 48h auf 24h ändern

Spalten-Layout ändern

# Von 2 auf 3 Spalten:
- type: horizontal-stack
  cards:
    - card1
    - card2
    - card3  # ← Hinzufügen

---

✅ Checklist

• Dashboard-Variante ausgewählt
• YAML-Datei in Home Assistant eingefügt
• Entity-IDs überprüft und angepasst
• Dashboard gespeichert
• Browser-Cache geleert (Strg+Shift+R)
• Dashboard getestet auf verschiedenen Geräten

---

🆘 Hilfe bei Problemen

Problem: "Entity not found"

Lösung:

# Prüfe in Developer Tools → States:
# Existiert die Entity wirklich?
# Falls nein: Auskommentieren oder durch existierende Entity ersetzen

Problem: Plotly Graph zeigt nichts

Lösung:

# 1. Prüfe ob Entity historische Daten hat:
#    Developer Tools → History → Entity auswählen

# 2. Prüfe Recorder-Integration:
#    configuration.yaml sollte haben:
recorder:
  db_url: sqlite:////config/home-assistant_v2.db
  purge_keep_days: 7
  include:
    entities:
      - sensor.openems_ess0_activepower
      # ... alle anderen wichtigen Entities

Problem: Power Flow Card zeigt Fehler

Lösung:

# Installiere über HACS:
# HACS → Frontend → Suche "Power Flow Card Plus" → Installieren
# Dann Browser-Cache leeren (Strg+Shift+R)

Problem: Bubble Cards nicht gefunden

Lösung:

# Installiere über HACS:
# HACS → Frontend → Suche "Bubble Card" → Installieren
# Home Assistant neu starten
# Browser-Cache leeren

---

🎨 Nächste Schritte

Nach erfolgreicher Installation kannst du:

1. Card-mod nutzen für individuelles Styling
2. Conditional Cards für kontextabhängige Anzeigen
3. Template-Sensoren für zusätzliche Berechnungen
4. Plan-Historie implementieren (siehe vorheriger Chat)
5. InfluxDB-Integration für Langzeitanalyse

---

💡 Pro-Tipps

Mobile Optimierung

# Füge card_mod für bessere Mobile-Ansicht hinzu:
card_mod:
  style: |
    ha-card {
      font-size: 0.9em;  /* Kleinere Schrift auf Mobile */
    }
    @media (max-width: 768px) {
      ha-card {
        padding: 8px !important;  /* Weniger Padding */
      }
    }

Dark Mode Support

Alle Dashboards sind Dark-Mode-kompatibel! Die Farben passen sich automatisch an.

Performance-Tipp

# Reduziere Refresh-Rate für bessere Performance:
refresh_interval: 300  # Alle 5 Minuten statt jede Minute

---

📞 Support

Bei weiteren Fragen:

1. Entity-IDs prüfen: Developer Tools → States
2. Logs checken: Settings → System → Logs
3. Browser-Konsole: F12 → Console (für Frontend-Fehler)

---

Viel Erfolg! 🎉

Bei Problemen: Schicke mir einen Screenshot des Fehlers + deine YAML-Config.