Neues YouTube-Video: Visualisierung im Devices-Adapter

[MatthiasUlrich]

Hi,
Ich möchte euch hier meinen ersten Adapter vorstellen.

Hier die klare Kennzeichnung: Dieser Adapter ist mit KI erstellt!

Trotzdem es bereits den AnkerSolix2 Adapter gibt macht dieser durchaus Sinn, da er auf der HA Integration beruht und einen zusätzlichen MQTT Client enthält.
Es ist dadurch mehr möglich an Steuerung und Geräteunterstützung.

Außerdem habe ich noch eine Abregelungsvermeidung eingebaut, die verhindert dass die PV Leistung abgeregelt wird wenn viel Erzeugung erwartet wird, die die Wechselrichterlimits übersteigen.

Hier die Details:

Anker Solix (Solarbank, Power Dock/Combiner, Smart Meter, PPS, Wallbox, Smart Plug u. a.) in ioBroker einbinden – auf Basis der Home-Assistant-Integration ha-anker-solix und der inoffiziellen Python-Bibliothek solixapi.

Ein Python-Bridge-Daemon holt Daten aus der Anker-Cloud (optional MQTT) und stellt sie als ioBroker-States bereit. Steuerung über control.*-States und Service-Buttons.

GitHub: https://github.com/MatthiasUlrich1/ioBroker.anker-solix
npm: iobroker.anker-solix (aktuell v0.10.4)

Installierbar über:
iob url iobroker.anker-solix@latest

Funktionen (Überblick)
Cloud-Anbindung: Login mit Anker-Konto (EU/COM je nach Land), Login-Cache unter iobroker-data/…/authcache/ (weniger Captcha-Risiko)
Geräte: Solarbank 1/2/3/4, Combiner/Power Dock (bis 4 Solarbänke), Smart Meter, System/Site, Inverter, Smart Plug, PPS, EV-Lader, Fahrzeug-Profile u. a. (wie HA)
Daten: Leistung, SOC, Energie-Statistiken, Verbindungsstatus; optional viele Zusatz-States über Entity-Gruppen (standardmäßig nur „Core“, weniger API-Last)
Steuerung: Nutzungsmodus, SOC-Reserve, AC-Ladelimit, Netzeinspeisung (je nach Gerät/API/MQTT)
MQTT: für Geräte/Funktionen, die die Cloud allein nicht liefert (empfohlen bei PPS, Wallbox, Hybrid-Steuerungen)
Services: Zeitplan lesen/löschen, System-Export, Geräte-Refresh, System-Info
Abregelungsvermeidung (optional): Prognose vom Adapter solarprognose; bei erwarteter Überproduktion während des Fensters Modus Benutzerdefiniert + berechnetes AC-Ladelimit; danach konfigurierbarer Modus; Status unter curtailment.* (Admin: Combiner-Checkbox, bis 4 Solarbank-Slots)

Voraussetzungen
ioBroker js-controller ≥ 6, Admin ≥ 7.6
Node.js ≥ 22 auf dem Host, der die Instanz ausführt
Python 3.12+ auf dem ioBroker-Host (venv wird im Adapter-Ordner angelegt, optional Auto-Install)
MQTT in den Adapter-Optionen, wenn Steuerung/Live-Daten über MQTT nötig sind
Für Abregelungsvermeidung: Adapter solarprognose mit stündlicher Prognose
Hinweis: Inoffizielle Cloud-API – kann sich jederzeit ändern; kein Anker-Support. Nutzung nur nach Zustimmung im Tab Terms.

Was Tester besonders prüfen könnten
Ersteinrichtung: Konto, Land, Load devices, sinnvolle Poll-Intervalle (60–180 s)
Login-Cache / erneuter Login ohne unnötiges „Cache leeren“
Lesbare States (Solarbank/Smart Meter/Combiner) und Schreiben von Controls
Optional: Entity-Gruppen aktivieren → Neustart → Last/API-Verhalten
Optional: MQTT + Hybrid-Steuerungen (SOC, Export, AC-Limit)
Optional: Abregelungsvermeidung mit solarprognose und curtailment.*
Multihost / verschiedene Node-Versionen (22+)
Feedback gern als Issue auf GitHub oder hier im Thread (Gerätetyp, Land, ioBroker-/Node-Version, Log-Auszug).

Bekannte Einschränkungen (kurz)
Cloud API pflicht; MQTT allein reicht nicht für vollständige Systemdaten
Kein Ersatz für BLE/Modbus (z. B. SolixBLE, offizielle Modbus-Integration)
VPS/VPN kann Captcha bei Neu-Login auslösen → Authcache von HA kopieren
Standalone-Geräte oft nur eingeschränkte API-Daten

Das ganze Porjekt ist mit Cursor AI erstellt. Das hat mich wirklich beeindruckt!

So jetzt viel Spaß beim Testen.
Ich freue mich auf Feedback

Gruß Matthias

[Shadowhunter23]

Mit dem aktuellen Anker Adapter habe ich die Zeit auf 30 Sekunden eingestellt und bin zufrieden. Bevor ich deinen Adapter mal teste, was ist das kleinste Abfrageintervall bzw wie oft kann ich Änderungen senden?

[MatthiasUlrich]

@shadowhunter23 Also 30 Sekunden Abfrage funktioniert bei mir auch ohne Sperre des Zugangs. In den Einstellungen gibt es aktuell keine Limitierung. Senden müsste man testen. Mit der Abregelungsvermeidung wird teilweise recht häufig gesendet und bisher gab es keine Probleme. Nur parallel würde ich die beiden Adapter nicht dauerhaft laufen lassen, da sich dann die Abfragen verdoppeln. Ich weiß nicht wie die Cloud darauf reagiert.

[motugozu]

Bekommst du mit dem Adapter Monats und Jahres Energie Bericht bzw kann man es abfragen ? , mit dem normalen Adapter bekommt du ja nur die Tages und Wochen Übersicht

[MatthiasUlrich]

@motugozu Aktuell nur heute und gestern. Aber ich kann mal schauen was da noch geht. Schreibst du ein Issue, was du alles brauchst?

[motugozu]

kann ich machen

[MatthiasUlrich]

@motugozu ich bin dabei die Wochen Monats und Jahresstatistik zu implementieren aber habe noch probleme mit der Anzahl an API abrufen. Meine zugang ist aktuell geblockt und ich kann nicht weiter testen. Bin aber dran. Ich bitte um etwas Geduld aber das wird sicher klappen.

[Shadowhunter23]

@matthiasulrich
Was ist denn wenn der Account geblockt ist was muss man dann machen?

[MatthiasUlrich]

Einfach warten, Adapter abschalten und am nächsten Tag wieder einschalten. Wird automatisch wieder freigegeben. Ist nur ein temporärer Block.

[MatthiasUlrich]

@motugozu ich hab lange gesessen an dem Thema heute Nacht. Aber am Ende hat es funktioniert. Die Daten für Week Month und Year werden einmal pro Tag aktualisiert und zwar in der Nacht ab 23:00 beginnend mit Week, dann ab 23:15 Month und 23:30 dann Year. Zwischendurch sind über den Tageswechsel noch Probleme mit der Abregeleungsvermeidung aufgetreten die ich noch gelöst habe. Manchmal ist es gut den Tageswechsel zu beobachten. Das hätte ansonsten meinen schönen Autarkiegrad für den Mai gekillt. 😂

[motugozu]

@matthiasulrich das genial weil das hat mir wirklich am anderen Adapter gestört das die nicht übertragen werden , für die Weiterverarbeitung in Grafana brauch ich die .

[MatthiasUlrich]

@motugozu hat bei mir heute wieder zuverlässig funktioniert. Alle daten sind angekommen

[MatthiasUlrich]

Hier mal ein kleiner Zwischenstand:

Der Adapter läuft stabil, die ApI wird auch nicht durch Anfragen überlastet. Alle Datenpunkte sind in Gruppen unterteilt und in den Einstellungen kann ausgewählt werden welche Objekte erstellt und agberufen werden sollen. Die Abregelungsvermeidung läuft zuverlässig. Da sind nur noch Schönheitsfehler zu beseitigen. Dort wird beim Tageswechsel noch Status Before angezeigt mit den Daten vom Vortag. Diese sollen zukünftig genullt werden und erst mit der neuen Prognose wieder gesetzt werden.
Aber das macht nichts aus für die Funktion.

To Do‘s:

• Integration der Steuerungsmöglichkeiten für den EV Lader. (Auto zum Testen fehlt mir)
• Funktion zum Löschen des Authentifiakations Files entfernen. (Führt nur zu Problemen) Das File kann man nicht wiederherstellen. (Außer mit dem AnkerSolix2 Adapter als Notlösung )

Ganz wichtig wenn ihr nicht irgendwelche Zwischenstände laden wollt. Immer nur von NPM installieren!

[MatthiasUlrich]

Kurzes Update:

Steuerung für EV Lader und alle Livedaten sind integriert.

[motugozu]

wirst du die neue Solix 4 auch in den Adapter bekommen , kannst du dazu schon was sagen ?

[MatthiasUlrich]

@motugozu vorgesehen ist sie schon. Aber das hängt davon ab ob sie die gleiche API nutzt. Sie soll ja von Hause aus eine HA Integration haben (offiziell) also wenn die API gleich ist, sollte sie automatisch im
Adapter auftauchen. Wenn nicht, schwer zu sagen aber ich sag mal so ich werde es versuchen dann trotzdem umzusetzen.

[MatthiasUlrich]

Zwischenstand:

• Das Problem mit dem Authetification-Cache ist gelöst. Beim ersten erfolgreichen Login wird ein Backup angelegt aus dem man dann das File wiederherstellen kann.
• Die Adapter-Einstellungen wurden vereinfacht und unnötiger Kram entfernt
• Die Abregelungsvermeidung wurde optimiert
• Batterie Ladeleistung und Entladeleistung wurde optimiert

[MatthiasUlrich]

Update: ich habe die Installation von Python Betriebssystemunabhängig gemacht. Windows, Linux, HA IoBroker App, Container(nicht getestet)
Es sollte jetzt auf jedem OS laufen.

[Nobody28]

Hallo in die Runde,

nach langem mal wieder einen Post von mir. :)
Als erstes einmal danke an Matthias für die, aus meiner Sicht, sehr gelungen Adapter. Ich bin durch seinen FB Post in Kontakt mit ihm gekommen und habe es gewagt, den Adapter zu installieren, aber, und darum sucht Mattias ja auch Tester, ich habe eine Besonderheit.

Ich nutze aktuell auf meinem Master ioBroker mit einer N150 CPU noch Node 20. Das hat den Grund, dass sich sonst das System bei Node 22 einfach abschaltet. Dazu habe ich noch keine Lösung gesucht, und das war bisherher auch kein Problem. Nur, der Adapter von Matthias benötigt nunmal Node 22.
Letztes Wochenende habe ich es dann geschafft, den Adapter zu installieren, und habe auf anhieb ca. 60 bis 70% meiner Werte für meinem iQontrol auf den neuen Adapter umgestellt. Flot habe ich aktuell, aus Zeitgründen noch nicht umgestellt, aber Daten werden schon gesammelt.
Da Matthias aber fleißig weiter entwickelt, stand ich vor dem Problem, wie ich nun auch einfach updaten kann. Über ioBroker Boardmitteln habe ich es aktuell noch nicht hinbekommen.
Da es aber evtl. auch andere mit dem Problem gibt, hier eine kleine Update Anleitung, wie ich es eben gemacht habe:

• per SSH auf Euer System aufschalten
• den Code ausführen:

sudo -u iobroker npm install iobroker.anker-solix --production --engine-strict=false

• dann in der Datei "package.json" die Nodeversion auf Version: 20 ändern

sudo nano /opt/iobroker/node_modules/iobroker.anker-solix/package.json

Der originale Eintrag sieht so aus:

"engines": {
  "node": ">= 22" 

• dann noch unter Instances:
  
  den Upload ausführen.
• zur Sicherheit den Adapter neustarten
• wenn alles geklappt hat, sollte im LOG auch kein Fehler auftreten

ich hoffe dem ein oder anderem nimmt es die Angst mit zu testen.
Ich werde heute weitere Werte meiner Visuallisierung umstellen und aber auch ergänzen, weil Matthias nun auch Werte für die Wallbox ausliest, was der alte Adapter einfach nicht kann!!! Alleine das ist schon ein Grund für mich hier mitzumachen.

Noch mal ein dickes Danke an Maatias.... weiter so und wir lesen uns :)

[Thomas Braun]

@Nobody28 sagte:

noch Node 20.

Dann bring das Ding auf 22 und verbreitete hier keine dreckigen Workarounds. , dein nodejs@20 ist abgekündigt, EOL und bekommt keine Updates mehr.