Skip to main content

node-red-contrib-anker-solix

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.

Version: 1.0.26Weekly Downloads: 2,952Author:j-c-wegnerUpdated: Nov 19, 2026

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, %, °C) 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 (://anker.com).

Visual Quick Start

Node-RED Flow Overview

Node Configuration

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


Changelog

  • 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 and server region selector (EU / US-Global) for worldwide compatibility.
    • Automatic multi-instance start offset (0–1,500 ms) when triggering multiple nodes from a single inject.
    • Write commands via safe Read-Modify-Write (set_mode, set_power, set_min_soc, set_grid_export – requires primary owner account).
  • 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).

  • 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, %, °C) 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ützung: Funktioniert mit allen europäischen Anker-SOLIX-Konten (://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.

Installation

Install in Node-RED via the palette manager.

Node-RED Palette Manager dialog with the node selected and the Install button visible.

Quick Stats

Current Version1.0.26
Weekly Downloads2,952
First PublishedNov 15, 2026
Last UpdatedNov 19, 2026

Need Help?

Get professional support for your Node-RED projects with FlowFuse.

Contact Us