So verbinden Sie die sonnenBatterie (Gen. 8 oder höher, REST-API-Anbindung) mit dem Reduxi Controller
Verbinden Sie die sonnenBatterie Gen. 8 oder höher über die REST-API mit dem Reduxi Controller.
Textbeschreibung dieses Bildes
Foto einer sonnenBatterie, Herstellerbild. Dunkelgraue Betonwand in einem schwach beleuchteten Raum. Links an der Wand hängt ein graues rechteckiges Modul mit geriffelter oder gelochter Front, laut Bildunterschrift der Hybrid-Wechselrichter. Daneben rechts steht ein hoher hellgrauer Schrank mit einem runden hellblau leuchtenden Ring nahe der Oberkante. Auf den Geräten ist kein Text lesbar.
- Technische Dokumentation
- Erforderliche Ausrüstung
- Lokaler Zugriff auf die sonnenBatterie
- Gerätekonfiguration an der sonnenBatterie
- Bei der Reduxi Weboberfläche anmelden
- sonnenBatterie zu Reduxi hinzufügen
- Messwerte prüfen und Strategien einrichten
- Checkliste
- Zusammenfassung
- Häufige Probleme
- Verwandte Artikel
1 Technische Dokumentation
Herstellerseiten zur sonnenBatterie:
- sonnenBatterie 10 – Produktseite des Herstellers
- Sonnen-Bedienungsanleitungen – Bedienungsanleitungen des Herstellers
Video-Tutorials:
2 Erforderliche Ausrüstung
Halten Sie Folgendes bereit:
- Reduxi Controller (installiert und online)
- sonnenBatterie Gen. 8 oder höher (REST-API)
- Lokale IP-Adresse der sonnenBatterie
- Installateur-Passwort der sonnenBatterie (siehe Punkt 4)
- Computer im selben lokalen Netzwerk wie die sonnenBatterie
- Laptop oder Tablet mit Internetzugang, um das Gerät in Reduxi zu konfigurieren
3 Lokaler Zugriff auf die sonnenBatterie
Stellen Sie vor dem Start sicher, dass Sie die lokale IP-Adresse der sonnenBatterie haben und Ihr Computer mit demselben lokalen Netzwerk verbunden ist.
Die sonnenBatterie erhält ihre IP-Adresse von:
- dem Router,
- einem Netzwerk-Switch
- oder einem lokalen DHCP-Server.
Die IP-Adresse oder den DNS-Namen der sonnenBatterie finden Sie über find-my.sonnen-batterie.com. Folgen Sie dort der Sonnen-Anleitung.
Öffnen Sie einen Webbrowser und geben Sie die lokale IP-Adresse der sonnenBatterie ein, um ihre Weboberfläche zu öffnen. Beispiel: http://<IP>
4 Gerätekonfiguration an der sonnenBatterie
4.1 Installateur-Anmeldung
Nachdem Sie die IP-Adresse im Browser geöffnet haben, erscheint ein Anmeldebildschirm. Wählen Sie als Anmeldetyp Installer und geben Sie das Installateur-Passwort ein.
Wenn Sie Zugriff benötigen, wenden Sie sich an den Installateur, der die Anlage in Betrieb genommen hat, oder an den Sonnen-Support. Der Sonnen-Support kann die Anfrage prüfen, den Zugriff freischalten oder die erforderlichen Änderungen in Ihrem Auftrag vornehmen.
Textbeschreibung dieses Bildes
Screenshot des Anmeldebildschirms der Weboberfläche der sonnenBatterie, breites Fenster mit dem sonnen-Logo in der dunklen oberen Leiste. Zentriertes Anmeldefeld mit der Überschrift Dashboard. Text: Please choose a login. Dropdown mit dem ausgewählten Wert Installer. Feldbezeichnung Password, Feld leer. Hellblaue Schaltfläche Login.
4.2 Dashboard
Nach erfolgreicher Anmeldung wird das Menu / Dashboard angezeigt.
Textbeschreibung dieses Bildes
Screenshot der Weboberfläche der sonnenBatterie, Seite Dashboard, mit dem sonnen-Logo in der dunklen oberen Leiste. Linkes Menü: Dashboard (hellblau hervorgehoben), System, Settings, Battery, Inverter, Powermeter, Powermeter Setup, IOs, Software-Installer, Commissioning Assistant, System-Status, Network, Software-Integration. Überschrift im Hauptbereich: Dashboard. Energiefluss-Diagramm mit vier Feldern: production 3145 W (gelb, Solarmodul-Symbol); consumption 1875 W (blau, Haussymbol); FeedIn 1273 W (grau, Strommast-Symbol); active power mit dem Status idle, rSOC: 16% und uSOC: 9% (grün, Batterie-Symbol). Ein gelber Pfeil führt von production zum Batteriefeld, ein grüner Pfeil führt vom Batteriefeld nach oben zu consumption.
4.3 REST-API der sonnenBatterie aktivieren
Gehen Sie im Dashboard wie folgt vor:
Textbeschreibung dieses Bildes
Screenshot der Weboberfläche der sonnenBatterie, Seite Software-Integration (sonnen-Logo in der dunklen oberen Leiste; Seriennummer und Softwareversion oben rechts in kleiner Schrift). Linkes Menü: Dashboard, System, Settings, Battery, Inverter, Powermeter, Powermeter Setup, I/Os, Software-Installer, Commissioning Assistant, System-Status, Network, Software-Integration (mit einem roten Kasten hervorgehoben). Tabs: JSON API (ausgewählt), WebSocket API, Generated Docs (kleine Schrift). Zwei Schalter, beide an (blau) und jeweils mit einem roten Kasten markiert: Read API (Text darunter: allows to request the current status of the sonnenBatterie, measurements and configuration values) und Write API (Text darunter: send requests to change or discharge the sonnenBatterie and set configuration values). Ein roter Kasten markiert die Zeile API Token: ein Tokenwert (hier nicht gezeigt, geschwärzt) und eine Schaltfläche Create New. Darunter: ein Beispielbefehl curl mit einem Auth-Token-Header und einer URL, die auf /api/v2/latestdata endet. Überschrift Documentation mit einem Link zur Dokumentation der sonnenBatterie-JSON-API.
4.4 Betriebsmodus einstellen
Öffnen Sie links das Menü Settings und wählen Sie den Betriebsmodus Manual.
Textbeschreibung dieses Bildes
Screenshot der Weboberfläche der sonnenBatterie, Seite Settings (oben rechts steht Software: 1.15.6, der Rest ist abgeschnitten). Linkes Menü: Dashboard, System, Inverter, Settings (blau hervorgehoben), Network, Software-Integration. Überschrift im Hauptbereich: Settings. Abschnitt: Operating Mode. Ein Dropdown ist geöffnet, der Eintrag Manual ist ausgewählt (grau hervorgehoben). Die aufgeführten Optionen sind: Manual; Automatic - Self-Consumption; Battery-Module-Extension (30%); Time-Of-Use. Unter dem Dropdown ist ein Schalter mit der Beschriftung Surplus fullcharge sichtbar, aus (grau).
5 Bei der Reduxi Weboberfläche anmelden
Die Reduxi Weboberfläche können Sie auf zwei Arten öffnen:
Textbeschreibung dieses Bildes
Screenshot von drei Bildschirmen der Reduxi App nebeneinander, mit cyanfarbenen Rahmen und Nummernmarken 2 bis 4. Linker Bildschirm (Dashboard, dunkles Design): Menüsymbol oben links, mit einem Rahmen und der Marke 2 markiert; 'reduxi'-Logo; Registerkarten 'Real time data' (aktiv) und 'Statistics'; Preis 5.79 € und Temperatur 3.2 °C; Energiefluss-Diagramm mit einem Haus in der Mitte (-1.25 kW) und Symbolen mit den Werten 69.0 W, 1.3 kW, 1.1 kW (roter Ring), -165.0 W mit 97 % (roter Ring) und Werten 0.0 W unten; Registerkarten 'Power' und 'Energy'; untere Navigation: Dashboard, Diagnostics, Device control, Settings. Mittlerer Bildschirm (Seitenmenü): 'reduxi'-Logo, 'Number of locations: 1233', Überschrift 'Reduxi device management', Einträge '+ Add Reduxi location' und 'Reduxi devices' (mit einem Rahmen und der Marke 3 markiert), dann 'My profile' und 'About app'. Rechter Bildschirm (Geräteseite): Back; Bild eines schwarzen Reduxi Controllers mit zwei Ethernet-Anschlüssen; Status 'Connected'; Karte 'Update available': 'New update is available for your Reduxi device.' mit der Schaltfläche 'Download and install update'; Karte 'Connect to configurator': 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' mit der Schaltfläche 'Activate tunnel connection' (mit einem Rahmen und der Marke 4 markiert); Karte 'Unit details' mit dem Feld 'Unit ID'.
Textbeschreibung dieses Bildes
Screenshot aus zwei Teilen nebeneinander. Linker Teil: Bildschirm der Reduxi App auf dunklem Hintergrund. Oben: Schaltfläche Back; Bild eines schwarzen Reduxi Controllers mit zwei Ethernet-Anschlüssen und einer Klemmleiste; Status 'Connected' mit einem WLAN-Symbol. Karte 'Update available': 'New update is available for your Reduxi device.' mit der Schaltfläche 'Download and install update'. Karte 'Connect to configurator' mit einem Schlüsselsymbol: 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' und der Schaltfläche 'Open configurator', mit einem cyanfarbenen Rahmen und der Nummernmarke 5 markiert. Darunter: Karte 'Unit details' mit dem Feld 'Unit ID' (Wert nicht sichtbar). Rechter Teil: Reduxi Configurator in einem Browser geöffnet, mit einem cyanfarbenen Rahmen und der Nummernmarke 6 markiert. Kopfzeile: Zurück-Pfeil, 'Tunnel connection', Symbol zum Neuladen. Linke Seitenleiste mit Symbolen (Blitz, Chip, Blitzsymbol, Balkendiagramm, Zahnrad). Seite 'Home' mit einem grünen Link-Symbol. Grüner Hinweis: 'New patch available. Click here to apply.' mit einem Schließen-X. Uhrzeit 09:12:56. Energiefluss-Diagramm mit einem Haus in der Mitte (1.700 kW) und Symbolen für Netz (0.000 kW), Solar (1.700 kW), Batterie (grün, 0.000 kW und 0.800 kW), ein Gerät links (0.900 kW), ein Elektrofahrzeug und eine Ladestation oder ein Gerät unten. Beschriftung 'Energy manager' unten.
http://reduxi.local ein. Die IP-Adresse des Controllers finden Sie in der Geräteliste Ihres Routers oder in der Reduxi app unter Reduxi devices.admin · Passwort: admin (Werkseinstellung)Textbeschreibung dieses Bildes
Screenshot der Anmeldeseite des Reduxi Configurators in einem Chrome-Browserfenster. Die Adressleiste zeigt 'Not secure' und 'reduxi.local'; die Adressleiste ist mit einem cyanfarbenen Rahmen markiert, und links wird eine vergrößerte Kopie davon (cyanfarbener Rahmen, Text 'Not secure reduxi.local') gezeigt, verbunden durch eine cyanfarbene Linie. Seitenhintergrund: hellgraue Strichzeichnung eines Hauses mit Solarmodulen (grün), einer Wallbox, einem Wechselrichter, einem Auto und einer Ladesäule. Oben links: Logo 'reduxi configurator'. In der Mitte ein Anmeldefeld mit dem Titel 'Login', einer Sprachauswahl (englische Flagge, 'English'), einem Benutzernamenfeld, einem Passwortfeld und einer dunklen Schaltfläche 'Login'.
Textbeschreibung dieses Bildes
Screenshot der Weboberfläche des Reduxi Configurators nach der Anmeldung, helles Design. Oben links: Logo 'reduxi configurator'. Kopfleiste: links 'Home', oben rechts der grüne Status 'Connected'. Linke Seitenleiste: aufgeklappter Abschnitt 'Devices' mit einer Liste von Einträgen, dann eingeklappte Abschnitte 'Manager', 'Configuration' und 'Settings'. Hauptbereich: Energiefluss-Diagramm. Haus in der Mitte mit Ring, Wert 24.20 kW. Grid-Symbol oben links, 24.20 kW (roter Punkt auf der Linie). Solar-Symbol oben rechts, Wert '-'. Symbol links (Batterie oder Gerät), 6.700 kW (grüner Punkt auf der Linie). Symbole rechts (Battery storage und ein Gerät), Werte '-'. EV charger-Symbol unten links, 31.00 kW. Ein weiteres Gerätesymbol unten rechts. Beschriftung 'Energy manager' unter dem Haus.
6 sonnenBatterie zu Reduxi hinzufügen
Mit diesen Schritten fügen Sie ein neues Gerät zum Reduxi Controller hinzu.
6.1 Grundeinstellungen
Melden Sie sich im Reduxi Configurator an (siehe Punkt 5; siehe auch So melden Sie sich per Browser im Reduxi Configurator an) und klicken Sie auf + Add device.
Textbeschreibung dieses Bildes
Screenshot des linken Menüs des Reduxi Configurator unter dem Logo reduxi Configurator. Menüeinträge: Devices (aufgeklappt, mit Minuszeichen) mit der Schaltfläche „+ Add device“ (umrandet); Strategies (Pluszeichen); Utility Rate Plan; Settings (Pluszeichen). Die rechte Seite ist leer und weiß.
Legen Sie im ersten Schritt die Grundeinstellungen fest:
- Device type:
Hybrid Inverter - Type:
Sonnen - Name: ein beliebiger Name
Textbeschreibung dieses Bildes
Screenshot des Formulars Basic settings im Reduxi Configurator. Felder: Device type (Dropdown, Wert in kleiner Schrift); Type (Dropdown, Wert scheint Sonnen zu lauten, kleine Schrift); Name (Textfeld, Wert scheint sonnen zu lauten, kleine Schrift). Darunter ein Bereich Include in Strategy mit einer Tabelle: Spalten Strategy, Measurement Device, Regulated Device; zwei Zeilen, beide mit der Beschriftung Energy manager, jeweils mit einem kleinen Indikator in den Spalten Measurement Device und Regulated Device. Schaltflächen: Back (unten links, weiß), Next (unten rechts, schwarz). Das Bild hat eine niedrige Auflösung, und der meiste Text ist klein.
Klicken Sie auf Next.
6.2 Kommunikationseinstellungen
| Parameter | Wert |
|---|---|
| Verbindung | TCP/IP |
| IP | IP-Adresse der sonnenBatterie |
| API-Token | Der API-Token aus Punkt 4, Punkt 4.3 |
| PV | Wählen Sie den Wechselrichtertyp: AC‑gekoppelt (Batterie und Wechselrichter sind getrennt) oder Hybrid (Batterie und Wechselrichter sind in einem System integriert) |
Textbeschreibung dieses Bildes
Screenshot des Formulars Communication channel and device configuration im Reduxi Configurator. Das Bild hat eine niedrige Auflösung. Felder: Connection type (Dropdown); IP (Textfeld, leer) mit einer schwarzen Schaltfläche Scan for IP; Port: 80; Reconnect IP recovery (Schalter mit der Beschriftung Yes, an); API token (Textfeld, leer); ein zweiter Schalter mit einer kurzen Überschrift und dem Text Yes/No; Number of AC system units: 1; What is type of inverter (Dropdown): AC coupled system. Schaltflächen: Back (unten links), Test communication und Done (unten rechts, Done ist schwarz).
6.3 Kommunikation testen
Klicken Sie unten im Assistenten auf Test communication. Der Test liest die sonnenBatterie einmal aus und speichert nichts. Ist der Test erfolgreich, klicken Sie auf Done: Erst Done legt das Gerät an.
Textbeschreibung dieses Bildes
Screenshot der unteren Schaltflächenleiste einer Reduxi Configurator Seite. Links: Schaltfläche 'Back'. Rechts: Schaltfläche 'Test communication' (mit einem cyanfarbenen Rahmen markiert) und dunkle Schaltfläche 'Done'.
Textbeschreibung dieses Bildes
Screenshot der Reduxi Configurator Seite 'Communication channel and device configuration'. Connection *: TCP/IP (Dropdown). IP *: 192.168.50.243, mit der Schaltfläche 'Scan for IP'. Port *: 502, mit der Schaltfläche 'Test port'. Modbus unit ID *: 1. Schaltflächen unten: Back (links), Test communication und Done (rechts). Die Schaltfläche Done ist mit einem cyanfarbenen Rahmen markiert.
Der Test liefert eines von zwei Ergebnissen:
Textbeschreibung dieses Bildes
Screenshot des Dialogs Test communication im Reduxi Configurator mit einem Schließen-Symbol (x) oben rechts. Weißes Ergebnisfeld, grüner Text: Successful readout from device. Werte: Battery active power: 5.0 W; Battery current: 0.0229 A; Battery export active energy: 0 Wh; Battery import active energy: 0 Wh; Battery min. active power: -9600.0 W; Battery min. state of charge: 10.0 %; Battery state of charge: 100.0 %; Battery voltage: 218.0 V; Grid active power: 1456.0 W; Grid export active energy: 0 Wh; Grid import active energy: 0 Wh; Load active power: 1454.0 W; Load import active energy: 0 Wh; Off-grid: false; PV active power: 0.0 W; PV export active energy: 0 Wh; State name: GRID_ON; Additional parameter - CAPACITY_MAX_WH: 19531.0; Additional parameter - FREQUENCY: 49.965. Schaltfläche: Close (dunkel, unten rechts).
Textbeschreibung dieses Bildes
Screenshot eines Dialogs mit dem Titel Test communication (Schließen-X oben rechts). Erstes Feld: Unable to communicate with device. Zweites Feld mit rotem Text: Unable to communicate with null on port 502. Check if service is enabled on device, port number is correct and device is reachable on the network. ping: null: Name or service not known. Schaltfläche: Close (dunkel).
Erhalten Sie die Meldung „Unable to communicate with device“, prüfen Sie die Einstellungen (siehe Punkt 8).
7 Messwerte prüfen und Strategien einrichten
7.1 Last measurements
Sobald die Kommunikation steht, prüfen Sie die Messwerte unter Devices – Ihr Sonnen-Gerät – Last measurements im Reduxi Configurator.
7.2 Reduxi Cloud
So fügen Sie den Controller hinzu und verbinden ihn mit der Reduxi Cloud: Reduxi Cloud
7.3 Strategien
Um Strategien und den AI Energy Manager einzurichten, nutzen Sie die Dokumentation unten.
8 Checkliste
Gehen Sie diese Checkliste durch, damit Einrichtung und Betrieb zuverlässig sind.
8.1 Am Reduxi Controller
- IP-Adresse: Für das angeschlossene Gerät ist die richtige IP-Adresse eingetragen.
- API-Token: Ein gültiger API-Token ist eingetragen.
- Systemtyp: Der richtige Systemtyp ist ausgewählt: AC‑gekoppelt oder Hybrid.
- Kommunikationstest: Der Kommunikationstest wurde erfolgreich abgeschlossen.
- Erreichbarkeit: Die IP-Adresse des Geräts ist vom Reduxi Controller aus erreichbar.
8.2 In der Weboberfläche der sonnenBatterie
- API-Berechtigungen: Sowohl Read API als auch Write API sind aktiviert.
- Betriebsmodus: Der Betriebsmodus ist Manual.
8.3 Strategie
- Aktive Strategie: Die gewählte Strategie ist auf Active gestellt.
- KI-Energieoptimierung: Die Optimierung des AI Energy Manager ist in der Strategie aktiviert.
- Nur eine aktive Strategie: Es ist immer nur eine Strategie aktiv.
- Import-/Exportgrenzen: Die Import- und Exportgrenzen sind definiert und konfiguriert.
✓ Zusammenfassung
Vorbereitung (Punkte 1–3): Halten Sie die lokale IP-Adresse, das Installateur-Passwort und einen Computer im selben Netzwerk bereit. Öffnen Sie die Weboberfläche der sonnenBatterie.
sonnenBatterie (Punkt 4): Melden Sie sich als Installer an, aktivieren Sie Read API und Write API, kopieren oder erstellen Sie den API-Token und stellen Sie den Betriebsmodus auf Manual.
Zu Reduxi hinzufügen (Punkte 5–6): Öffnen Sie den Configurator und fügen Sie das Gerät mit dem Typ Sonnen hinzu. Geben Sie IP-Adresse, API-Token und den Wechselrichtertyp (AC‑coupled oder Hybrid) ein. Führen Sie Test communication aus.
Inbetriebnahme (Punkte 7–8): Prüfen Sie die Messwerte, richten Sie die Strategien ein und gehen Sie die Checkliste durch.
→ Häufige Probleme
| Problem | Lösung |
|---|---|
| Test communication zeigt „Unable to communicate with device“ | Das System ist nicht korrekt konfiguriert. Prüfen Sie die IP-Adresse, den API-Token, den Systemtyp (AC‑coupled oder Hybrid) und ob die IP-Adresse vom Controller aus erreichbar ist (siehe Punkt 8). |
| Die Installateur-Anmeldung ist nicht möglich | Das Installateur-Passwort steht Endnutzern nicht zur Verfügung. Wenden Sie sich an den Installateur, der die Anlage in Betrieb genommen hat, oder an den Sonnen-Support (siehe Punkt 4). |
| Kein API-Token vorhanden | Öffnen Sie in der Weboberfläche der sonnenBatterie Software Integration und klicken Sie unten auf der Seite auf Create new. |
| Reduxi-Befehle haben keine Wirkung auf die Batterie | Prüfen Sie, ob der Betriebsmodus Manual ist, ob Read API und Write API aktiviert sind, ob die Strategie Active ist und ob nur eine Strategie aktiv ist (siehe Punkt 8). |
| Open configurator öffnet sich nicht oder bleibt leer | Der Tunnel ist noch nicht aktiv. Warten Sie etwa 30 Sekunden und prüfen Sie, ob der Controller online ist. |
Die Anmeldung mit admin wird abgelehnt |
Das Passwort wurde bei der Installation geändert. Fragen Sie den Installateur. Das Passwort Ihres Reduxi-Kontos funktioniert hier nicht. |
reduxi.local lässt sich nicht laden |
Ihr Gerät befindet sich nicht im selben Netzwerk wie der Controller. Verwenden Sie die IP-Adresse oder die Tunnelverbindung. |
| Kommunikationstest schlägt fehl, Gerät wird offline angezeigt | Prüfen Sie die Erreichbarkeit, IP-Adresse / Port / Unit ID und ob das Protokoll am Gerät aktiviert ist. |