====== batcontrol ======

**batcontrol** steuert deinen PV-Speicher anhand dynamischer Strompreise, einer Solarprognose und deinem Verbrauchsprofil. Es lädt die Batterie aus dem Netz, wenn Strom günstig ist, und spart die gespeicherte Energie für die teuren Stunden auf — vollautomatisch und **ohne** IP-basierten Stromzähler.

{{:img_0684.jpeg?800|batcontrol}}

===== Funktionen =====

  * **Preisbewusstes Laden** — günstig laden, in der Hochpreisphase nutzen
  * **Mit jedem Wechselrichter** — Fronius GEN24 (Solar API), Fronius Modbus TCP oder //jedes// System über den generischen MQTT-Treiber
  * **Kein zusätzlicher Zähler nötig**
  * **Solar- & Verbrauchsprognose** integriert
  * **Home-Assistant**-Anbindung über MQTT-Auto-Discovery und ein eigenes Add-on
  * **Peak Shaving** hält Speicherkapazität für die Mittagsspitze frei //(ab 0.8.0)//
  * **evcc-Koordination** fürs E-Auto-Laden
  * **Robuster Betrieb** — übersteht kurze Wechselrichter- oder Netzausfälle
  * **Open Source** (MIT), läuft als Docker-Container

===== So funktioniert es =====

batcontrol läuft in einem kurzen Zyklus und kombiniert drei Prognosen:

  - **Strompreis** aus deinem dynamischen Tarif (nächste 24–48 h)
  - **Solarertrag** aus einem PV-Prognosedienst
  - **Verbrauch** aus einem auf deinen Jahresverbrauch skalierten Lastprofil

Daraus berechnet es den erwarteten //Netto-Verbrauch// und entscheidet je Zyklus, ob **aus dem Netz geladen** (Preise niedrig und steigend), die Batterie **gehalten** (für teure Stunden aufgespart) oder normal **entladen** wird. Anschließend stellt es den Wechselrichter entsprechend ein — und stellt beim Beenden die ursprünglichen Einstellungen wieder her.

===== Unterstützte Hardware & Dienste =====

^ Kategorie ^ Unterstützt ^
| Wechselrichter | Fronius GEN24 (Solar %%API%%), Fronius Modbus TCP, jeder Wechselrichter via MQTT |
| Dynamische Tarife | Tibber, aWATTar, evcc, zonenbasierte Tarife (z. B. Octopus) |
| Solarprognose | [[https://forecast.solar|Forecast.Solar]], [[https://solarprognose.de|Solarprognose]], [[https://evcc.io|evcc]], Home-Assistant-Sensor |
| Verbrauch | CSV-Lastprofil (auf Jahres-kWh skaliert) oder Home-Assistant-Sensor |
| Hausautomation | MQTT, Home Assistant (Auto-Discovery + Add-on) |

===== Loslegen =====

batcontrol läuft als Docker-Container und wird über eine einzige YAML-Datei konfiguriert.

  * **Installation & Start:** siehe [[https://github.com/MaStr/batcontrol#docker-usage|README]]
  * **Vollständige Konfigurationsreferenz:** die  [[https://mastr.github.io/batcontrol/|Dokumentation]]
  * **Home-Assistant-Nutzer:** das [[https://github.com/MaStr/batcontrol_ha_addon|batcontrol-Add-on]]

----

//batcontrol ist experimentelle Software, die echte Hardware steuert, und wird ohne Gewähr bereitgestellt. Beginne mit konservativen Grenzwerten und beobachte die Logs bei der Ersteinrichtung.//