So verbinden Sie sonnenBatterie mit dem Reduxi Controller
Verbinden Sie Ihre sonnenBatterie mit dem Reduxi Controller und lassen Sie sie von den Reduxi Strategien zu den besten Preisen laden und entladen. Diese Anleitung behandelt die Verbindung über die JSON API und zeigt, wo die REST-API-Anleitung für Gen. 8 oder höher gilt.
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.
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 mit der JSON API unter Software Integration
- Lokale IP-Adresse der sonnenBatterie
- 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
Verbinden Sie die sonnenBatterie per LAN mit dem lokalen Netzwerk. Der Reduxi Controller muss sich im selben Netzwerk befinden.
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
Melden Sie sich an der Weboberfläche der sonnenBatterie an (siehe Punkt 3). Sie brauchen den API-Token und die IP-Adresse für den Reduxi Controller (siehe Punkt 6).
4.1 Software Integration öffnen
Textbeschreibung dieses Bildes
Screenshot der Weboberfläche der sonnenBatterie in einem Browser, Seite Software-Integration, Reiter JSON API. Die Adressleiste zeigt eine lokale IP-Adresse gefolgt vom Pfad dash/software-integration/json-api; die IP-Adresse ist mit einem roten Rahmen und einem Pfeil mit der Beschriftung SonnenBatterie IP markiert. Linkes Menü: Dashboard, System, Inverter, Settings, Network und Software-Integration (hervorgehoben). Reiter: JSON API (aktiv), Webhook API und sonnenKNX Module. Zwei Schalter sind eingeschaltet: Read API (Allows to request the current status of the sonnenBatterie, measurements and configuration values) und Write API (Send requests to charge/discharge the sonnenBatterie and set configuration values). Darunter das Feld API Token mit einem Tokenwert, mit einem roten Rahmen und der Beschriftung API Token markiert, und eine Schaltfläche Create New. Eine Beispielzeile wiederholt den Token und die IP-Adresse mit denselben Markierungen. Unten: Link sonnenBatterie JSON API v2 documentation.
4.2 Read API und Write API aktivieren
Schalten Sie Read API und Write API ein. Beide sind erforderlich: Reduxi liest die Messwerte mit der Read API und sendet Lade- und Entladebefehle mit der Write API.
Textbeschreibung dieses Bildes
Zugeschnittener Screenshot des Reiters JSON API mit den Reitern JSON API, Webhook API und sonnenKNX Module. Der Schalter Read API ist eingeschaltet. Darunter steht ein hellblauer Hinweis: This functionality is disabled while VPP is active, gefolgt von einem ausgegrauten Schalter Write API in der Stellung aus mit dem Text Send requests to charge/discharge the sonnenBatterie and set configuration values. Ein blaues Rechteck hebt den Hinweis und den Schalter Write API hervor.
4.3 Betriebsmodus festlegen
Öffnen Sie links das Menü Settings und stellen Sie den Betriebsmodus auf Manual. Nur dann kann der Reduxi Controller die Steuerung der Batterie übernehmen.
Textbeschreibung dieses Bildes
Screenshot der Seite Settings der sonnenBatterie (Software 1.15.6). Linkes Menü: Dashboard, System, Inverter, Settings (hervorgehoben), Network und Software-Integration. Die Karte Operating Mode enthält ein Dropdown, das Manual anzeigt; die geöffnete Liste darunter bietet Manual, Automatic - Self-Consumption, Battery-Module-Extension (30%) und Time-Of-Use. Unter der Karte ist ein Schalter mit der Beschriftung Surplus fullcharge zu sehen.
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 die sonnenBatterie als neues Gerät am Reduxi Controller hinzu.
6.1 Grundeinstellungen
Melden Sie sich im Reduxi Configurator an (siehe Punkt 5; siehe auch How to log in to Reduxi Configurator via browser) 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:
- Gerätetyp: Hybrid Inverter
- Typ: 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
Geben Sie die Verbindungsparameter zwischen dem Reduxi Controller und der sonnenBatterie ein. Verwenden Sie die IP-Adresse und den API-Token aus Punkt 4.
| Parameter | Wert |
|---|---|
| Verbindung | TCP/IP |
| IP | IP-Adresse der sonnenBatterie |
| Port | 80 |
| API-Token | Der API-Token aus dem Reiter JSON API (Punkt 4, Punkt 4.1) |
| Nennleistung | Wählen Sie die Nennleistung, die zu Ihrer sonnenBatterie passt |
| PV | Wählen Sie Yes, wenn ein PV-Zähler installiert ist, andernfalls No |
Textbeschreibung dieses Bildes
Screenshot des Formulars Communication channel and device configuration im Reduxi Configurator. Felder von oben nach unten: Connection (TCP/IP), IP (leer, mit einem hellblauen Pfeil, der auf das Feld zeigt), Port (80), API token (leer, mit einem hellblauen Pfeil; Hinweis: API token is located in inverter web interface in section Software-Integration / JSON API), Rated power (14.4 kW) und PV (Yes; Hinweis: Is PV meter installed?). Schaltflächen unten: Back, Test communication und Next.
6.3 Kommunikation testen
Klicken Sie unten im Assistenten auf Test communication. Der Test liest die sonnenBatterie einmal aus und speichert nichts. Wenn der Test erfolgreich ist, klicken Sie auf Next.
Der Test liefert eines von zwei Ergebnissen:
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 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).
6.4 Erweiterte Einstellungen
Die erweiterten Einstellungen sind optional und hängen vom Bedarf des Standorts ab. Wenn Sie fertig sind, klicken Sie auf Done: Erst Done legt das Gerät an.
Textbeschreibung dieses Bildes
Screenshot des Assistenten im Reduxi Configurator, Schritt 3 von 3 Advanced settings; die Fortschrittsleiste zeigt Basic settings, Communication channel und Advanced settings. Yes/No-Schalter, alle auf No: set data saving interval (default 1 min), set reading delay (default 1000 ms), set writing delay (default 1000 ms), set power generation limits and capabilities, set power consumption limits and capabilities, limit communication with the device to read-only (default No), invert direction for energy import and export (default No), exclude device from summary (default No). Drei Dropdowns L1, L2 und L3 is connected to main feed sind auf L1, L2 und L3 gesetzt. Schaltflächen: Back links und Done rechts.
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 Control type
Öffnen Sie im Reduxi Configurator Devices – Ihr Sonnen Gerät und stellen Sie den Control type auf AUTO. Befehle aus der Strategie wirken sich dann auf die Batterie aus.
7.3 Reduxi Cloud
So fügen Sie den Controller hinzu und verbinden ihn mit der Reduxi Cloud: Reduxi Cloud
Sobald das Gerät hinzugefügt ist, können Sie es auch in der Reduxi App überwachen und steuern.
7.4 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 und Port: Die IP-Adresse der sonnenBatterie und der Port
80sind eingetragen. - API-Token: Ein gültiger API-Token ist eingetragen.
- Nennleistung und PV: Die Nennleistung und die PV-Auswahl passen zur Anlage.
- Kommunikationstest: Der Kommunikationstest wurde erfolgreich abgeschlossen.
- Control type: Der Control type des Geräts ist auf AUTO gestellt.
- 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.
- VPP: Die Batterie ist vom VPP getrennt.
- 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 und einen Computer im selben Netzwerk bereit. Öffnen Sie die Weboberfläche der sonnenBatterie.
sonnenBatterie (Punkt 4): Öffnen Sie Software-Integration, Reiter JSON API. Aktivieren Sie Read API und Write API (trennen Sie die Batterie zuerst vom VPP), kopieren Sie den API-Token oder erstellen Sie einen und stellen Sie den Betriebsmodus auf Manual.
In 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, Port 80, API-Token, Nennleistung und PV ein. Führen Sie Test communication aus und klicken Sie dann auf Done.
Inbetriebnahme (Punkte 7–8): Prüfen Sie die Messwerte, stellen Sie den Control type auf AUTO, 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“ | Prüfen Sie die IP-Adresse, Port 80, den API-Token und ob die IP-Adresse vom Controller aus erreichbar ist (siehe Punkt 8). |
| Die Write API lässt sich nicht einschalten | Es erscheint der Hinweis “This functionality is disabled while VPP is active”. Trennen Sie die Batterie vom VPP und aktivieren Sie dann die Write API (siehe Punkt 4.2). |
| Kein API-Token vorhanden | Öffnen Sie in der Weboberfläche der sonnenBatterie Software-Integration, Reiter JSON API, und klicken Sie 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 der Control type AUTO ist, 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ädt nicht | 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, die IP-Adresse und den Port und ob die API am Gerät aktiviert ist. |