node-red-contrib-anker-solix 1.0.27

Node-RED node to read real-time data and energy statistics from Anker SOLIX Solar & Energy Storage Systems (Solarbank 2/3, Solarbank Max, Power Dock AE100, Smart Meter) for OpenCCU, MQTT, Home Assistant, ioBroker, InfluxDB and KNX/Loxone.

npm install node-red-contrib-anker-solix

node-red-contrib-anker-solix

npm version License: MIT Node-RED

🌐 Language / Sprache: 🇬🇧 English Overview (Full English Docs) | 🇩🇪 Kurzübersicht Deutsch (Vollständige deutsche Anleitung)


🇬🇧 Overview (English)

Node-RED node to read real-time data (W, %) and energy statistics (kWh) from Anker SOLIX Solar & Energy Storage Systems (Solarbank 2 E1600 Pro/Plus, Solarbank 3 E2700 Pro, Solarbank Max AE111, Solarbank Max AC A17E2/B17E2, Power Dock AE100, and Anker Smart Meters) via the Anker EU Cloud.

  • Universal Output 1 ({ topic, payload }): Sends delta-filtered values (with a 300-second heartbeat for flatline-free charts in CCU-Historian / InfluxDB) directly to OpenCCU / HomeMatic (ccu-sysvar), MQTT Brokers (mqtt out for Home Assistant / ioBroker), InfluxDB, or KNX / Loxone.
  • Raw JSON Output 2 (scen_info & energy_analysis): Provides full API payloads for custom processing, debugging, or direct database logging.
  • Smart Hardware Auto-Detection & Battery Protection: Automatically detects Power Dock (AE100), Anker Smart Meters (A17X7, A17X8, AE1X0, AE1R0, SHEM3), and AC-coupled home storage (AE111, A17E2, B17E2) for continuous 24/7 real-time updates, while keeping standalone solarbanks in battery-safe sleep mode at night.
  • Account Recommendation: Using a shared secondary Anker account is recommended for read-only data monitoring (maximum security and clean separation); the primary owner account is only required starting with v1.1.0 when sending write/control commands (Anker now supports parallel logins from the smartphone app and Node-RED simultaneously).
  • EU Cloud Support: Works with all European Anker SOLIX accounts (https://anker.com).

Visual Quick Start

Node-RED Flow Overview

Node Configuration

👉 Read the full English Documentation (Installation, SysVars, MQTT & Commands)


Changelog

  • v1.0.27:
    • Fixed monthly and yearly energy_analysis statistics (STAT_GES_MONAT_* & STAT_GES_JAHR_*), mapped total solar/battery yields from solarbank statistics on Power Dock (AE100) setups, and added automatic fallback calculation for total home usage (STAT_GES_*_HAUS).
    • Added primary AE100 Power Dock auto-detection via combiner_box_info.combiner_box_list.
    • Removed unsupported SB1_TEMP–SB4_TEMP keys for 120 clean, reliable data points and fixed documentation links.
  • v1.0.26:
    • Extended energy_analysis statistics queries across "solar_production", "home_usage", and "grid" so Power Dock (AE100) and Smart Meter systems reliably report grid import (STAT_GES_*_NETZ), home usage (STAT_GES_*_HAUS), and export (STAT_GES_*_EINSP) in kWh.
    • Fixed weekly statistics start date calculation (Monday of the current week) and added raw energy_analysis JSON output on Output 2 plus msg.topic = "get_stats" on-demand refresh.
    • Updated documentation (README.md, README.de.md, README.en.md) with kWh units, status badges, bilingual quick navigation, and updated account recommendations.
  • v1.0.25:
    • Improved 24/7 MQTT wake-up (cmd: 17, qos: 1, official clientId, REST app pings get_site_homepage & get_site_detail, 90-second stall re-trigger, and per-device wake-up lock).
    • Added 300-second heartbeat in emitSysVar to prevent spline wave interpolation artifacts in CCU-Historian during constant phases.
    • Made get_sites non-blocking during active polling.
  • v1.0.20 – v1.0.24:
    • Refined session token caching across multiple node instances sharing one account and stabilized MQTT reconnect handling.
  • v1.0.19:
    • Added explicit hardware support for Anker Smart Meter 2nd Gen (1-phase, AE1X0) and AC-coupled home storage systems (Solarbank Max AE111, Solarbank Max AC A17E2 / B17E2).
    • Prioritized manually entered Wakeup Device SN/PN over automatic detection.
    • Increased login protection cooldown to 5 minutes on wrong password errors (26108) to prevent account lockouts (10019).
    • Added structured section headers (_ANLEITUNG_1, _BEREICH_...) to the default SysVars JSON template and example flow.
    • Introduced multilingual documentation (README.md, README.en.md, README.de.md).
  • v1.0.18: Implemented binary MQTT pull_to_refresh (cmd: 17) with randomized jitter (3.5–7 min) and automatic battery protection for standalone solarbanks.
  • v1.0.15: Added set_wakeup runtime command (true / false / "auto") and get_sites multi-site discovery.

Planned Roadmap (Unbinding / Subject to Change)

  • v1.1.0:
    • Central account configuration node (anker-solix-config) with dropdown selection (separate primary & secondary accounts) and server region selector (EU / US-Global).
    • Dedicated write/control node (anker-solix-control) linked exclusively to the primary owner account for safe Read-Modify-Write commands (set_mode, set_power, set_min_soc, set_grid_export), keeping 24/7 polling isolated on the secondary read-only account.
    • Automatic multi-instance start offset (0–1,500 ms) when triggering multiple nodes from a single inject.
  • v2.0.x:
    • Extended support for the wider Anker SOLIX ecosystem: V1 Smart EV Charger (A5191), SOLIX X1 Home Energy Storage, and portable power stations / backup units (pps_info).

Legal Notice, Transparency & Disclaimer (English)

  • Unofficial Community Project: This Node-RED package (node-red-contrib-anker-solix) is an independent open-source community project and is not affiliated with, endorsed, or supported by Anker Innovations Limited or Anker SOLIX. All product names and trademarks belong to their respective owners.
  • Transparency & Development: Conception, architecture, practical testing, and maintenance are provided by the project author; code generation was assisted by AI (Google Gemini).
  • Use at Your Own Risk: Provided under the MIT License without warranty of any kind. Using the unofficial cloud interface is at your own risk. The author assumes no liability for temporary account restrictions, data loss, battery discharge, or damages resulting from the use of this node or changes to the Anker API.
  • Privacy: Email address and password are stored exclusively locally in Node-RED's encrypted credential storage (flows_cred.json) and transmitted only to official Anker EU servers.

🇩🇪 Kurzübersicht (Deutsch)

Node-RED-Baustein zum Auslesen von Echtzeit- (W, %) und Statistikdaten (kWh) für Anker SOLIX Solar- & Speichersysteme (Solarbank 2 E1600 Pro/Plus, Solarbank 3 E2700 Pro, Solarbank Max AE111, Solarbank Max AC A17E2/B17E2, Power Dock AE100 sowie Anker Smart Meter) über die Anker EU-Cloud.

  • Universeller Ausgang 1 ({ topic, payload }): Sendet Werte bei Änderung (sowie alle 300 Sekunden als Stützpunkt gegen Spline-Wellen in CCU-Historian / InfluxDB) direkt an OpenCCU / HomeMatic (ccu-sysvar), MQTT-Broker (mqtt out für Home Assistant / ioBroker), InfluxDB oder KNX / Loxone.
  • Rohdaten-Ausgang 2 (scen_info & energy_analysis): Liefert die vollständigen JSON-Antworten der API für eigene Auswertungen oder zur Diagnose.
  • Intelligente Hardware-Erkennung & Akkuschutz: Erkennt Power Dock (AE100), Anker Smart Meter (A17X7, A17X8, AE1X0, AE1R0, SHEM3) und 230V-Heimspeicher (AE111, A17E2, B17E2) automatisch für lückenlose 24/7-Echtzeitdaten, während reine Solarbank-Anlagen nachts im akkuschonenden Schlafmodus bleiben.
  • Konten-Empfehlung: Ein geteiltes Zweitkonto wird für das reine Auslesen von Live- und Statistikdaten empfohlen (maximale Sicherheit und saubere Trennung); das Hauptkonto (Eigentümer) ist erst ab v1.1.0 nötig, wenn Schreibbefehle / Steuerungen an die Anlage gesendet werden sollen (Anker erlaubt inzwischen parallele Logins von App und Node-RED gleichzeitig).
  • EU-Cloud-Unterstütung: Funktioniert mit allen europäischen Anker-SOLIX-Konten (https://anker.com).

👉 Zur vollständigen deutschen Anleitung (Installation, Systemvariablen, MQTT & Steuerbefehle)

Rechtliche Hinweise, Transparenz & Haftungsausschluss (Deutsch)

  • Unabhängiges Community-Projekt: Dieses Node-RED-Paket (node-red-contrib-anker-solix) ist ein privates Open-Source-Projekt und steht in keiner Verbindung zu Anker Innovations Limited oder Anker SOLIX. Alle genannten Marken- und Produktnamen sind Eigentum der jeweiligen Rechteinhaber.
  • Transparenz & Entstehung: Konzeption, Architektur, Praxistests und Pflege stammen vom Projektautor; die Code-Erstellung erfolgte mit KI-Unterstützung (Google Gemini).
  • Nutzung auf eigene Gefahr: Die Bereitstellung erfolgt unter der MIT-Lizenz ohne jegliche Gewährleistung. Die Nutzung der inoffiziellen Cloud-Schnittstelle erfolgt auf eigenes Risiko. Der Autor übernimmt keine Haftung für temporäre Kontosperrungen, Datenverluste, Akku-Entladungen oder Schäden, die durch die Nutzung dieses Bausteins oder durch Änderungen an der Anker-API entstehen.
  • Datenschutz: E-Mail-Adresse und Passwort werden ausschließlich lokal im verschlüsselten Credential-Speicher deiner Node-RED-Instanz (flows_cred.json) abgelegt und nur für die direkte Authentifizierung bei den EU-Servern von Anker verwendet.

Node Info

Version: 1.0.27
Updated 1 day ago
License: MIT
Rating: 5.0 2

Categories

Actions

Rate:

Downloads

3270 in the last week

Nodes

  • anker-solix

Keywords

  • node-red
  • anker
  • anker-solix
  • solix
  • solarbank
  • solarbank-2
  • solarbank-3
  • solarbank-max
  • power-dock
  • smart-meter
  • solar
  • battery
  • energy-storage
  • openccu
  • homematic
  • redmatic
  • mqtt
  • home-assistant
  • iobroker
  • influxdb
  • knx
  • loxone
  • smart-home

Maintainers