Seit heute gibt es von einem anderen Anwender der Community eine HACS basierte Integration des Maxxicharge in Homeassistant. Diese findet Ihr unter:
https://github.com/mephdrac/MaxxiChargeConnect
Diese deckt aktuell die Funktionalität des Abschnitts "1. Lokale Integration der Maxxicharge Betriebsdaten (Offiziell)" ab.
Grundsätzlich ist diese Art von Integration - insbesondere hinsichtlich der einfacheren Updates bei Weiterentwicklungen gegenüber den Änderungen in den "configuration.yaml", usw. zu bevorzugen. Inwieweit es möglich ist, von der .yaml basierten Konfiguration auf die HACS Lösung "umzusteigen" muss noch geprüft werden. Da jetzt eine HACS basierte Lösung existiert, sollte dies aber die Basis für alle Weiterentwicklungen - insbesondere in Hinsicht auf die CCU V2 werden.
Homeassistant "Backup" als Grundlage einer Integration mit dem Lokalen API der Maxxicharge CCU V1 (ab Firmware 0.41 - getestet mit 0.44)
🚨 Die Nutzung der bereitgestellten Konfiguration per Homeassistant Backup erfolgt auf eigene Verantwortung und ohne die implizite oder explizite Zusicherung von bestimmten Eigenschaften und Funktionalitäten, sowie ohne Gewähr und Support. Alle Marken- oder Produktmarken sind Eigentum des jeweiligen Firmen/Personen. 🚨
🚨 Die Lösung ist Community basiert und wird von der Firma Maxxisun weder unterstützt noch supported. Alles was hier beschrieben und genutzt wird, sind Homeassistant Technologien und Konzepte sowie Open Source Komponenten anderer User, die Homeassistant mittels Home Assistant Community Store (HACS) hinzugefügt werden können. Diese unterliegen den Copyright Regelungen des jeweiligen Repositories. Der Anwender trägt das Risiko eines mögliche Verlustes der Herstellergarantie sowie möglichen Schäden am Gerät durch unsachgemässe Nutzung und/oder Konfiguration. 🚨
🚨 In der nachfolgenden Beschreibung sind alle im "Backup" verwendenten Komponenten, die einer "leeren" Homeassistant Neuinstallation hinzugefügt werden, aufgeführt. Etwaige, evtl. inkompatibele Änderungen der Komponenten und daraus folgend notwendige Anpassungen liegen in der Verantwortung des Nutzers. Das gleiche gilt auch für Updates die die Homeassistant Installation anbietet. 🚨
Ein "Backup" für Homeassistant Neuinstallationen, dass nach Installation von Homeassistant auf einem geeignenten Geräte folgende Maxxicharge bezogenen Funktionen ohne weitere Konfiguration im Homeassistant bereitstellt:
- Integration der Maxxicharge Daten aus dem "Lokalen API" als Sensoren
- Helfer Entitäten, um die Daten die in Watt (W) gelieferten Daten im HA in Kilowattstunden (kwh) umzuwandeln
- Die unter 2. erzeugten Helfer Entitäten als Grundkonfiguration des HA Energie Dashboard einrichten
- Mind. ein HA Dashbaord mit allen Maxxicharge Entitäten basierend auf HA Standard Dashboard Möglichkeiten
Da Sensoren/Entitäten im HA komplett individuell benannt werden können, gibt es (m.W.n.) derzeit keine Möglichkeit einzelne, spezifische Konfigurationensteile für spezifischen Zwecke von einem HA-System auf ein anderes HA-System zu übertragen. Stattdessen müssen alle enthaltenen Komponenten (Sensoren, HACS Lovelace Dashboard Komponenten, Configuration.YAML Abschnitte,..) manuell im neuen System angelegt werden. Mit Hilfe dieser Komponenten können dann die Dashboards angelegt und konfiguriert werden.
Für jemanden, der neu mit dem HA anfängt stellt dies oftmal eine unerwartet hohe Anfangshürde dar, insbesondere dann, wenn man direkt mit der Konfiguration für ein System wie Maxxicharge starten will.
Die "Backup Funktionalität" im HA (gedacht für Datensicherung und die Übertragung eines komplettes Systems auf andere Hardare), erlaubt es bei einer Komplette Neuinstallation des HA Systems eine eine Basiskonfiguration (ohne Daten) einzuspielen. Wichtig: Ein Backup überschreibt alle Daten und Konfigurationen, die im jeweiligen HA System gemacht worden sind. Der Ansatz ist somit nur für die Erstkonfiguration in einer neu bereitgestellten und noch nicht genutzen HA Instanz geeignet.
Bei Homeassistant wird als "Core" Version mind. HA Core Version 2025.1.x benötigt, da erst diese Version die Verarbeitung verschlüsselter Backups ermöglicht.
Ergänzung: Mit HA Core Version 2025.2.x wird auch wieder die Erzeugung unverschlüsselter Backups unterstützt. Das Release V1 enthält (aus Konsistenzgründen) weiterhin das verschlüsselte Backup. Es wurde aber am 6.2.2025 auch ein unverschlüsseltes Backup mit gleichem Inhalt hinzugefügt. Dies sollte mit allen HA Core Versionen funktionieren. Wurde allerdings "nur" mit HA Core 2025.1.x und 2025.2.0 Versionen getestet.
Hinweis:
Die Konfiguration der Entitäten/Sensoren ist für eine Maxxicharge System mit EINER Batterie ausgelegt. Wer mehr als eine Batterie hat, muss weitere Sensoren für die 2. Batterie in der Konfiguration anlegen, um die Daten auslesen zu können.
Warnung:
Bei Nutzung des Backup zur Installation von Maxxicharge spezfischer Konfiguration werden ALLE bisher evtl. in dem System vorhandenen Konfgurationen sowie ALLE evtl. schon vorhandenen Daten gelöscht.
Disclaimer:
Keine Verantwortung für verlorene Daten und evtl. nicht funktionsfähige HA Installation. Das Einspielen der Backups wurde mit mehrenen HA Systemen auf unterschiedlicher Hardware getestet, allerdings aufgrund der Anzahl von Hardware- und Systemoptionen natürlich nicht auf allen möglichen Varianten. Daher unbedingt ein neues, noch nicht konfiguriertes, leeres HA System nehmen.
Beschreibung der Vorgehensweise und Details findet sich im Wiki des Repositories:
https://github.com/Joern-R/maxxicharge-local-ha-quickstart/wiki