Anker SOLIX für Homey

Kurzanleitung für Version 0.7.9. Die App verbindet deine Anker-Anlage über die Anker Cloud mit Homey. Du kannst Messwerte anzeigen, in Insights auswerten und für Flows oder HomeyScript nutzen.

Voraussetzungen und Geräte

Du benötigst Homey Pro mit Homey 12.4.5 oder neuer, eine Internetverbindung und ein Anker-Konto mit einer bereits eingerichteten Anlage.

Gerätetyp in Homey Erkannte Modelle / Funktion
Solarbank Solarbank 1 (A17C0), Solarbank 2 Pro/Plus/AC (A17C1/A17C3/A17C2), Solarbank 3 E2700 Pro (A17C5), Solarbank 4 E5000 Pro (AE103), Max (AE111), Max AC (A17E2/A17E23Z1); X1-P5K-S/X1-P6K-S zur Überwachung. Steuerung je nach Modell.
Smartmeter Anker A17X7/A17X7US, Gen 2 AE1X0, P1 AE1R0, Shelly 3EM/Pro 3EM und EverHome EcoTracker IR, sofern sie in der Anker-Anlage eingebunden sind.
Solarpanel Leistung eines gemeldeten PV-Eingangs. Die Anzahl der Eingänge ist modellabhängig.
Solarpanel gruppiert Gesamte PV-Leistung der zugehörigen Solarbank.

Steckdosen, PowerDocks und Prime Charger sind keine eigenen Gerätetypen dieser App. Die verfügbaren Messwerte hängen von Modell, Firmware und Anker Cloud ab.

Einrichtung

  1. Prüfe in der Anker-App, dass die Geräte deiner Anlage sichtbar sind.
  2. Öffne in Homey Gerät hinzufügen → Anker Solix → Solarbank (alle Generationen).
  3. Wähle das Land bzw. die Region deines Anker-Kontos und melde dich mit diesem Konto an.
  4. Wähle die gewünschte Solarbank. Wiederhole die Kopplung für weitere Solarbanks, Smartmeter oder PV-Geräte.
  5. Optional: Unter Einstellungen → Apps → Anker Solix → Einstellungen das Standardland für weitere Kopplungen speichern. Bei vorhandenen Geräten lässt sich die Region in den Geräteeinstellungen korrigieren.

Das Abfrageintervall steht standardmäßig auf 60 Sekunden und lässt sich je Gerät zwischen 30 und 600 Sekunden einstellen. Die Cloud kann Werte verzögert liefern. Tagesstatistiken werden gemeinsam zwischengespeichert und normalerweise höchstens alle fünf Minuten neu angefordert.

Vorhandene Geräte müssen für das Update nicht neu gekoppelt werden. Neue Solarbanks verwenden den generischen Treiber solarbank; der alte Treiber solarbank2 bleibt für bestehende Geräte und Flows erhalten.

Messwerte und Homey Energy

Je nach Gerät erhältst du Solarleistung, Batteriestand, Lade-/Entladeleistung, Ausgang zum Haus, Netzleistung, Hausverbrauch und Temperatur.

  • Batterieleistung: positiv beim Laden, negativ beim Entladen.
  • Netzleistung am Smartmeter: positiv bei Bezug, negativ bei Einspeisung. Der Hausverbrauch ist ein eigener Wert.
  • Gesamtkapazität: automatisch aus Modell und gemeldeten Zusatzakkus. Bei gemischten Akkus oder unvollständigen Cloud-Daten kannst du in den Geräteeinstellungen die Gesamtkapazität dieser Solarbank in kWh eintragen; 0 aktiviert die automatische Ermittlung.
  • Gespeicherte Energie: Gesamtkapazität × Batteriestand. Sie ist von den dauerhaften Lade-/Entladezählern zu unterscheiden.

Für Homey Energy die Solarbank als Batterie und entweder das gruppierte Solarpanel oder die einzelnen PV-Eingänge verwenden. Beide Darstellungen zusammen würden Solarproduktion doppelt erfassen. Energiezähler bleiben bei Neustarts erhalten; während Ausfällen wird kein Verbrauch erfunden oder nachträglich geschätzt.

Der Ladestatus verwendet den Zustand der einzelnen Solarbank. Bei Solarbank 2 und neueren Hybridmodellen wird der Anker-Zustand „Erkennung“ anhand der Lade-/Entladeleistung genauer eingeordnet. Fehlende oder ausdrücklich ungültige/offline Daten erscheinen als „Unbekannt“. Der Betriebsmodus zeigt einen Namen wie „Manueller Zeitplan“ statt der API-Nummer an. Benutzerdefinierte Messwerte verwenden Standard-Symbole.

Tageswerte, Insights und HomeyScript

Die Tageswerte sind in kWh angegeben und orientieren sich am aktuellen Tag in der Homey-Zeitzone. Die Solarbank stellt unter anderem Solarertrag, Batterieladung/-entladung, Netzbezug/-einspeisung und Hausverbrauch bereit. Weitere Werte teilen die Energieflüsse auf; Verfügbarkeit abhängig von der Cloud. Smartmeter und PV-Geräte zeigen die für sie passenden Tageswerte.

Anlagensummen nicht mehrfach zählen: Tageswerte mehrerer Solarbanks derselben Anker-Anlage beziehen sich auf dieselbe Anlage. Fehlende Werte bleiben unbekannt und werden nicht als 0 ausgegeben. Nach dem Tageswechsel bleiben Werte unbekannt, bis Anker passende Tagesdaten liefert.

Die Werte stehen als Gerätefähigkeiten in Insights und HomeyScript zur Verfügung. Beispiele für Capability-IDs:

Capability Tageswert
solix_daily_solar Solarertrag
solix_daily_charge / solix_daily_discharge Batterieladung / -entladung
solix_daily_grid_import / solix_daily_grid_export Netzbezug / -einspeisung
solix_daily_home Hausverbrauch
solix_daily_date Datum der Tageswerte

Dieses HomeyScript liest Solarertrag und Datum eines Geräts. Ersetze GERAETE_ID durch dessen Homey-Geräte-ID:

const device = await Homey.devices.getDevice({ id: 'GERAETE_ID' });
return {
  datum: device.capabilitiesObj.solix_daily_date?.value ?? null,
  solarertrag_kWh: device.capabilitiesObj.solix_daily_solar?.value ?? null,
};

Betriebsmodi und Leistungssteuerung

Für neue Flows verwende Betriebsmodus auswählen mit Dropdown. Die ältere numerische Karte bleibt für vorhandene Flows erhalten. Solarbank 1 bietet diese Modussteuerung nicht an.

Modus Bedeutung
Smartmeter (1) Automatische Abgabe anhand eines in Anker eingebundenen Smartmeters.
Smarte Steckdosen (2) Regelung anhand unterstützter, in Anker eingerichteter Steckdosen. Dafür ist kein eigener Homey-Steckdosentreiber nötig.
Manueller Zeitplan (3) Verwendet den in Anker eingerichteten Ausgangsleistungsplan.
Zeitabhängiger Tarif (5) Aktiviert einen bereits vorhandenen Time-of-Use-Plan eines geeigneten Modells. Die App erstellt keinen Tarifplan und lädt keine dynamischen Strompreise.

Die angebotenen Modi setzen passende Firmware und Anlagenausstattung voraus. Temporäres Backup, KI-Regelung und dynamische Tarifsteuerung sind keine eigenen auswählbaren Aktionen dieser App.

Zwei Leistungsaktionen haben unterschiedliche Aufgaben:

Aktion Verwendung
Ausgangsleistung setzen Ab Solarbank 2: ändert den Sollwert im aktuellen Zeitfenster des manuellen oder Smart-Plug-Plans nach Homey-Zeitzone. Ein gemeinsamer Wochenplan bleibt gemeinsam: Die Änderung gilt für alle darin enthaltenen Wochentage. Im Smartmeter-Modus wird die Aktion abgewiesen. Solarbank 1 verwendet den bisherigen Legacy-Befehl.
AC-Ausgangslimit setzen Separate Obergrenze für kompatible Solarbank-3/4- und Max-Modelle über HTTP sowie eigenständige Solarbank-2-Anlagen über optionales MQTT, auch im Smartmeter-Modus. Nur von Anker angebotene Wattwerte sind gültig. Sie begrenzt die AC-Abgabe der Anlage und setzt keinen Sollwert für den Hausverbrauch.

Solarbank 2 AC/Pro/Plus: Die Referenz benötigt für das echte Ausgangslimit zusätzlich MQTT. Dieser Branch unterstützt den Befehl für eigenständige Solarbank-2-Anlagen, wenn Anker MQTT aktivieren in den Geräteeinstellungen eingeschaltet ist. Der manuelle Zeitplan-Sollwert bleibt steuerbar.

Modus, Zeitplan und AC-Limit betreffen die Anker-Anlage und können damit mehrere Solarbanks beeinflussen. Die Leistungsaktionen wechseln den Modus nicht automatisch. Eine aktive temporäre Backup-Ladung muss vor einer Sollwertänderung beendet werden. Die App liest die gespeicherte Cloud-Einstellung zurück; das bestätigt noch keine unmittelbar gemessene Geräteleistung.

Beispiele für Flows

  • Tagesbericht: Abends zu einer festen Uhrzeit die Tageswerte einer Solarbank als Tags in deinen Bericht übernehmen. Für dieselbe Anlage nur einen Satz Tageswerte verwenden.
  • Solarertrag erreicht: Wenn Tagesenergiewert hat sich geändert für Solarertrag auslöst und Tagesenergie ist über deinem Grenzwert liegt, eine Benachrichtigung senden. Für eine einmalige Meldung pro Tag eine eigene Tages-Sperre im Flow ergänzen.
  • Feste Abgabe: Erst Betriebsmodus auswählen → Manueller Zeitplan, dann Ausgangsleistung setzen → 300 W. Änderungen an gemeinsamen Zeitplänen beachten.
  • Automatik mit Obergrenze: Bei einem unterstützten Modell Smartmeter wählen und über die separate AC-Limit-Karte einen von Anker angebotenen Grenzwert setzen.

Fehlerbehebung

Problem Prüfen
Anmeldung oder Gerätesuche schlägt fehl Konto, Region und Sichtbarkeit der Anlage in der Anker-App prüfen. Bereits in Homey gekoppelte Solarbanks desselben Kontos werden ausgefiltert.
AC-Limit-Karte fehlt Modellunterstützung prüfen und die erste erfolgreiche Geräteabfrage abwarten. Bei Solarbank 2 Anker MQTT aktivieren; nur eigenständige Anlagen werden unterstützt.
Sollwert lässt sich nicht ändern Manuellen oder Smart-Plug-Modus verwenden und temporäres Backup beenden. Im Smartmeter-Modus für eine Obergrenze die AC-Limit-Karte verwenden, sofern unterstützt.
„Anker has not confirmed …“ Die Rücklesung bestätigt die gewünschte Einstellung noch nicht. In der Anker-App prüfen, bevor du den Befehl erneut auslöst.
Tageswerte fehlen Auf passende Cloud-Tagesdaten warten. Unbekannt bedeutet nicht null Energie.
Kapazität passt nicht Zusatzakkus und die manuelle Gesamtkapazität je Solarbank prüfen.

Support und Fehlerberichte: https://github.com/tilwegener/Anker-Solix-Homey-App/issues

Bitte Modellnummer, App-Version, Betriebsmodus und genaue Fehlermeldung angeben. Zugangsdaten nicht mitsenden. Die tatsächliche Gerätesteuerung muss mit dem jeweiligen Modell und seiner Firmware geprüft werden.

Optionale MQTT-Erweiterung

Die MQTT-Anleitung beschreibt Aktivierung, Solarbank-1/2/3/4-Temperaturen, Ausgangslimits eigenständiger Solarbank-2-Anlagen und die aktuellen Grenzen. MQTT ist standardmäßig deaktiviert.