sonnenBatterie (gen. 8 of hoger, REST API-verbinding) aansluiten op de Reduxi controller
Sluit de sonnenBatterie gen. 8 of hoger via de REST API aan op de Reduxi Controller.
Tekstbeschrijving van deze afbeelding
Foto van een sonnenBatterie, afbeelding van de fabrikant. Donkergrijze betonnen muur in een schemerige ruimte. Links aan de muur hangt een grijze rechthoekige module met een geribbelde of geperforeerde voorkant: volgens het bijschrift de hybride omvormer. Rechts ernaast staat een hoge lichtgrijze kast met bovenaan een ronde, lichtblauw verlichte ring. Op de apparaten is geen leesbare tekst te zien.
- Technische documentatie
- Benodigde apparatuur
- Lokale toegang tot de sonnenBatterie
- Apparaatconfiguratie op de sonnenBatterie
- Inloggen op de Reduxi-webinterface
- De sonnenBatterie aan Reduxi toevoegen
- De metingen controleren en strategieën instellen
- Checklist
- Samenvatting
- Veelvoorkomende problemen
- Gerelateerde artikelen
1 Technische documentatie
Pagina's van de fabrikant voor de sonnenBatterie:
- sonnenBatterie 10 – Productpagina van de fabrikant
- Sonnen-gebruikershandleidingen – Gebruikershandleidingen van de fabrikant
Videotutorials:
2 Benodigde apparatuur
Zorg voor het volgende:
- Reduxi Controller (geïnstalleerd en online)
- sonnenBatterie gen. 8 of hoger (REST API)
- Lokaal IP-adres van de sonnenBatterie
- Installateurswachtwoord van de sonnenBatterie (zie punt 4)
- Computer in hetzelfde lokale netwerk als de sonnenBatterie
- Laptop of tablet met internettoegang om het apparaat in Reduxi te configureren
3 Lokale toegang tot de sonnenBatterie
Zorg voordat u begint dat u het lokale IP-adres van de sonnenBatterie hebt en dat uw computer met hetzelfde lokale netwerk is verbonden.
De sonnenBatterie krijgt zijn IP-adres van:
- de router,
- een netwerkswitch,
- of een lokale DHCP-server.
Om het IP-adres of de DNS-naam van de sonnenBatterie te vinden, gebruikt u find-my.sonnen-batterie.com en volgt u de Sonnen-instructie.
Open een webbrowser en voer het lokale IP-adres van de sonnenBatterie in om de webinterface te openen. Voorbeeld: http://<IP>
4 Apparaatconfiguratie op de sonnenBatterie
4.1 Installateursaanmelding
Nadat u het IP-adres in de browser hebt geopend, verschijnt een aanmeldscherm. Selecteer Installer als aanmeldtype en voer het installateurswachtwoord in.
Als u toegang nodig hebt, neemt u contact op met de installateur die het systeem in gebruik heeft genomen of met Sonnen-support. Sonnen-support kan het verzoek controleren, de toegang ontgrendelen of de benodigde wijzigingen namens u doorvoeren.
Tekstbeschrijving van deze afbeelding
Schermafbeelding van het aanmeldscherm van de webinterface van de sonnenBatterie, breed venster met het sonnen-logo in de donkere bovenbalk. Gecentreerd aanmeldvak met de kop Dashboard. Tekst: Please choose a login. Keuzelijst met de geselecteerde waarde Installer. Veldlabel Password, veld leeg. Lichtblauwe knop Login.
4.2 Dashboard
Na een geslaagde aanmelding wordt het Menu / Dashboard weergegeven.
Tekstbeschrijving van deze afbeelding
Schermafbeelding van de webinterface van de sonnenBatterie, pagina Dashboard, met het sonnen-logo in de donkere bovenbalk. Menu links: Dashboard (lichtblauw gemarkeerd), System, Settings, Battery, Inverter, Powermeter, Powermeter Setup, IOs, Software-Installer, Commissioning Assistant, System-Status, Network, Software-Integration. Hoofdgedeelte met de kop Dashboard. Energiestroomschema met vier vakken: production 3145 W (geel, zonnepaneelpictogram); consumption 1875 W (blauw, huispictogram); FeedIn 1273 W (grijs, mastpictogram); active power met status idle, rSOC: 16% en uSOC: 9% (groen, batterijpictogram). Een gele pijl loopt van production naar het batterijvak, een groene pijl loopt van het batterijvak omhoog naar consumption.
4.3 De REST API van de sonnenBatterie inschakelen
Doe het volgende op het dashboard:
Tekstbeschrijving van deze afbeelding
Schermafbeelding van de webinterface van de sonnenBatterie, pagina Software-Integration (sonnen-logo in de donkere bovenbalk; serienummer en softwareversie rechtsboven in kleine tekst). Menu links: Dashboard, System, Settings, Battery, Inverter, Powermeter, Powermeter Setup, I/Os, Software-Installer, Commissioning Assistant, System-Status, Network, Software-Integration (gemarkeerd met een rood kader). Tabbladen: JSON API (geselecteerd), WebSocket API, Generated Docs (kleine tekst). Twee schakelaars, beide aan (blauw) en elk gemarkeerd met een rood kader: Read API (tekst eronder: allows to request the current status of the sonnenBatterie, measurements and configuration values) en Write API (tekst eronder: send requests to change or discharge the sonnenBatterie and set configuration values). Een rood kader markeert de rij API Token: een tokenwaarde (hier niet getoond, geredigeerd) en een knop Create New. Daaronder: een voorbeeld van een curl-opdracht met een Auth-Token-header en een URL die eindigt op /api/v2/latestdata. Kop Documentation met een link naar de documentatie van de sonnenBatterie JSON API.
4.4 De bedrijfsmodus instellen
Open links het menu Settings en selecteer de bedrijfsmodus Manual.
Tekstbeschrijving van deze afbeelding
Schermafbeelding van de webinterface van de sonnenBatterie, pagina Settings (rechtsboven staat Software: 1.15.6, de rest is afgesneden). Menu links: Dashboard, System, Inverter, Settings (blauw gemarkeerd), Network, Software-Integration. Hoofdgedeelte met de kop Settings. Sectie: Operating Mode. Een keuzelijst is geopend met de geselecteerde optie Manual (grijs gemarkeerd). De opties zijn: Manual; Automatic - Self-Consumption; Battery-Module-Extension (30%); Time-Of-Use. Onder de keuzelijst is een schakelaar met het label Surplus fullcharge zichtbaar, uit (grijs).
5 Inloggen op de Reduxi-webinterface
U kunt de Reduxi-webinterface op twee manieren openen:
Tekstbeschrijving van deze afbeelding
Schermafbeelding van drie schermen van de Reduxi mobiele app naast elkaar, met cyaan kaders en nummerbadges 2 tot 4. Linker scherm (dashboard, donker thema): menupictogram linksboven gemarkeerd met een kader en badge 2; logo 'reduxi'; tabbladen 'Real time data' (actief) en 'Statistics'; prijs 5.79 € en temperatuur 3.2 °C; energiestroomdiagram met een huis in het midden (-1.25 kW) en pictogrammen met waarden 69.0 W, 1.3 kW, 1.1 kW (rode ring), -165.0 W met 97 % (rode ring) en onderaan waarden van 0.0 W; tabbladen 'Power' en 'Energy'; onderste navigatie: Dashboard, Diagnostics, Device control, Settings. Middelste scherm (zijmenu): logo 'reduxi', 'Number of locations: 1233', kop 'Reduxi device management', items '+ Add Reduxi location' en 'Reduxi devices' (gemarkeerd met een kader en badge 3), daarna 'My profile' en 'About app'. Rechter scherm (apparaatpagina): Back; afbeelding van een zwarte Reduxi controller met twee Ethernet-poorten; status 'Connected'; kaart 'Update available': 'New update is available for your Reduxi device.' met de knop 'Download and install update'; kaart 'Connect to configurator': 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' met de knop 'Activate tunnel connection' (gemarkeerd met een kader en badge 4); kaart 'Unit details' met het veld 'Unit ID'.
Tekstbeschrijving van deze afbeelding
Schermafbeelding bestaande uit twee delen naast elkaar. Linkerdeel: scherm van de Reduxi mobiele app op een donkere achtergrond. Bovenaan: knop Back; afbeelding van een zwarte Reduxi controller met twee Ethernet-poorten en een klemmenblok; status 'Connected' met een Wi-Fi-pictogram. Kaart 'Update available': 'New update is available for your Reduxi device.' met de knop 'Download and install update'. Kaart 'Connect to configurator' met een sleutelpictogram: 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' en de knop 'Open configurator', gemarkeerd met een cyaan kader en nummerbadge 5. Daaronder: kaart 'Unit details' met een veld 'Unit ID' (waarde niet zichtbaar). Rechterdeel: Reduxi Configurator geopend in een browser, gemarkeerd met een cyaan kader en nummerbadge 6. Koptekst: terugpijl, 'Tunnel connection', herlaadpictogram. Zijbalk links met pictogrammen (bliksem, chip, bliksemschicht, staafdiagram, tandwiel). Pagina 'Home' met een groen linkpictogram. Groene melding: 'New patch available. Click here to apply.' met een sluitkruisje. Tijd 09:12:56. Energiestroomdiagram met een huis in het midden (1.700 kW) en pictogrammen voor net (0.000 kW), zon (1.700 kW), batterij (groen, 0.000 kW en 0.800 kW), een apparaat links (0.900 kW), een elektrisch voertuig en een lader of apparaat onderaan. Label 'Energy manager' onderaan.
http://reduxi.local in. Het IP-adres van de controller vindt u in de apparatenlijst van uw router of in de Reduxi app onder Reduxi devices.admin · Wachtwoord: admin (fabrieksinstelling)Tekstbeschrijving van deze afbeelding
Schermafbeelding van de inlogpagina van de Reduxi Configurator in een Chrome-browservenster. De adresbalk toont 'Not secure' en 'reduxi.local'; de adresbalk is gemarkeerd met een cyaan kader en een vergrote kopie ervan (cyaan kader, tekst 'Not secure reduxi.local') staat links, verbonden door een cyaan lijn. Paginaachtergrond: lichtgrijze lijntekening van een huis met zonnepanelen (groen), een laadpunt aan de muur, een omvormer, een auto en een laadpaal. Linksboven: logo 'reduxi configurator'. In het midden een inlogvak met de titel 'Login', een taalkeuze (Engelse vlag, 'English'), een veld voor de gebruikersnaam en een wachtwoordveld, en een donkere knop 'Login'.
Tekstbeschrijving van deze afbeelding
Schermafbeelding van de webinterface van de Reduxi Configurator na het inloggen, licht thema. Linksboven: logo 'reduxi configurator'. Koptekstbalk: 'Home' links, groene status 'Connected' rechtsboven. Zijbalk links: uitgeklapte sectie 'Devices' met een lijst van items, daarna ingeklapte secties 'Manager', 'Configuration' en 'Settings'. Hoofdgedeelte: energiestroomdiagram. Huis in het midden met ring, waarde 24.20 kW. Netpictogram linksboven, 24.20 kW (rode stip op de lijn). Zonpictogram rechtsboven, waarde '-'. Pictogram links (batterij of apparaat), 6.700 kW (groene stip op de lijn). Pictogrammen rechts (batterijopslag en een apparaat), waarden '-'. EV charger-pictogram linksonder, 31.00 kW. Nog een apparaatpictogram rechtsonder. Label 'Energy manager' onder het huis.
6 De sonnenBatterie aan Reduxi toevoegen
Met deze stappen voegt u een nieuw apparaat toe aan de Reduxi Controller.
6.1 Basisinstellingen
Meld u aan bij de Reduxi Configurator (zie punt 5; zie ook Inloggen bij de Reduxi Configurator via een browser) en klik op + Add device.
Tekstbeschrijving van deze afbeelding
Screenshot van het linkermenu van de Reduxi Configurator onder het reduxi Configurator-logo. Menu-items: Devices (uitgeklapt, met een minteken) met de knop '+ Add device' (omlijnd); Strategies (plusteken); Utility Rate Plan; Settings (plusteken). De rechterkant is leeg en wit.
Definieer in de eerste stap de basisinstellingen:
- Device type:
Hybrid Inverter - Type:
Sonnen - Name: een naam naar keuze
Tekstbeschrijving van deze afbeelding
Schermafbeelding van het formulier Basic settings van de Reduxi Configurator. Velden: Device type (keuzelijst, waarde in kleine tekst); Type (keuzelijst, waarde lijkt Sonnen te zijn, kleine tekst); Name (tekstveld, waarde lijkt sonnen te zijn, kleine tekst). Daaronder een sectie Include in Strategy met een tabel: kolommen Strategy, Measurement Device, Regulated Device; twee rijen, beide met het label Energy manager, elk met een kleine indicator in de kolommen Measurement Device en Regulated Device. Knoppen: Back (linksonder, wit), Next (rechtsonder, zwart). De afbeelding heeft een lage resolutie en de meeste tekst is klein.
Klik op Next.
6.2 Communicatie-instellingen
| Parameter | Waarde |
|---|---|
| Verbinding | TCP/IP |
| IP | IP-adres van de sonnenBatterie |
| API-token | Het API-token uit punt 4, punt 4.3 |
| PV | Kies het omvormertype: AC‑coupled (batterij en omvormer zijn gescheiden) of Hybrid (batterij en omvormer zijn in één systeem geïntegreerd) |
Tekstbeschrijving van deze afbeelding
Schermafbeelding van het formulier Communication channel and device configuration van de Reduxi Configurator. De afbeelding heeft een lage resolutie. Velden: Connection type (keuzelijst); IP (tekstveld, leeg) met een zwarte knop Scan for IP; Port: 80; Reconnect IP recovery (schakelaar, met het label Yes, aan); API token (tekstveld, leeg); een tweede schakelaar met een korte kop en de tekst Yes/No; Number of AC system units: 1; What is type of inverter (keuzelijst): AC coupled system. Knoppen: Back (linksonder), Test communication en Done (rechtsonder, Done is zwart).
6.3 Communicatie testen
Klik onderaan in de wizard op Test communication. Hiermee leest Reduxi de sonnenBatterie eenmalig uit en slaat niets op. Als de test slaagt, klikt u op Done: pas met Done wordt het apparaat aangemaakt.
Tekstbeschrijving van deze afbeelding
Schermafbeelding van de onderste knoppenbalk van een pagina van de Reduxi Configurator. Links: knop 'Back'. Rechts: knop 'Test communication' (gemarkeerd met een cyaan kader) en donkere knop 'Done'.
Tekstbeschrijving van deze afbeelding
Schermafbeelding van de pagina 'Communication channel and device configuration' van de Reduxi Configurator. Connection *: TCP/IP (keuzelijst). IP *: 192.168.50.243, met de knop 'Scan for IP'. Port *: 502, met de knop 'Test port'. Modbus unit ID *: 1. Knoppen onderaan: Back (links), Test communication en Done (rechts). De knop Done is gemarkeerd met een cyaan kader.
De test geeft een van twee resultaten:
Tekstbeschrijving van deze afbeelding
Schermafbeelding van het dialoogvenster Test communication van de Reduxi Configurator met een sluitpictogram (x) rechtsboven. Wit resultaatvak, groene tekst: Successful readout from device. Waarden: 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. Knop: Close (donker, rechtsonder).
Tekstbeschrijving van deze afbeelding
Schermafbeelding van een dialoogvenster met de titel Test communication (sluitkruisje rechtsboven). Eerste vak: Unable to communicate with device. Tweede vak met rode tekst: 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. Knop: Close (donker).
Als u de melding “Unable to communicate with device” krijgt, controleer dan de instellingen (zie punt 8).
7 De metingen controleren en strategieën instellen
7.1 Laatste metingen
Controleer nadat de communicatie tot stand is gebracht de gemeten waarden onder Devices – your Sonnen device – Last measurements in de Reduxi Configurator.
7.2 Reduxi Cloud
Hoe u de controller toevoegt en verbindt met de Reduxi Cloud: Reduxi Cloud
7.3 Strategieën
Om strategieën en de AI Energy Manager in te stellen, gebruikt u de onderstaande documentatie.
8 Checklist
Loop deze checklist door voor een correcte installatie en betrouwbare werking.
8.1 Op de Reduxi Controller
- IP-adres: Het juiste IP-adres is ingevoerd voor het aangesloten apparaat.
- API-token: Er is een geldig API-token ingevoerd.
- Systeemtype: Het juiste systeemtype is geselecteerd: AC‑coupled of Hybrid.
- Communicatietest: De communicatietest is met succes afgerond.
- Bereikbaarheid: Het IP-adres van het apparaat is bereikbaar vanaf de Reduxi Controller.
8.2 In de webinterface van de sonnenBatterie
- API-rechten: Zowel Read API als Write API is ingeschakeld.
- Bedrijfsmodus: De bedrijfsmodus is Manual.
8.3 Strategie
- Actieve strategie: De geselecteerde strategie staat op Active.
- AI-energieoptimalisatie: De optimalisatie van de AI Energy Manager is ingeschakeld in de strategie.
- Eén actieve strategie: Er is slechts één strategie tegelijk actief.
- Import-/exportlimieten: De import- en exportlimieten zijn gedefinieerd en geconfigureerd.
✓ Samenvatting
Voorbereiding (punt 1–3): Zorg voor het lokale IP-adres, het installateurswachtwoord en een computer in hetzelfde netwerk. Open de webinterface van de sonnenBatterie.
sonnenBatterie (punt 4): Meld u aan als Installer, schakel Read API en Write API in, kopieer of maak het API-token aan en stel de bedrijfsmodus in op Manual.
Toevoegen aan Reduxi (punt 5–6): Open de Configurator en voeg het apparaat toe met het type Sonnen. Voer het IP-adres, het API-token en het omvormertype in (AC‑coupled of Hybrid). Voer Test communication uit.
In gebruik nemen (punt 7–8): Controleer de metingen, stel de strategieën in en loop de checklist door.
→ Veelvoorkomende problemen
| Probleem | Oplossing |
|---|---|
| Test communication toont “Unable to communicate with device” | Het systeem is niet goed geconfigureerd. Controleer het IP-adres, het API-token, het systeemtype (AC‑coupled of Hybrid) en of het IP-adres bereikbaar is vanaf de controller (zie punt 8). |
| Aanmelden als installateur lukt niet | Het installateurswachtwoord is niet beschikbaar voor eindgebruikers. Neem contact op met de installateur die het systeem in gebruik heeft genomen of met Sonnen-support (zie punt 4). |
| Geen API-token beschikbaar | Open Software Integration in de webinterface van de sonnenBatterie en klik onderaan de pagina op Create new. |
| Reduxi-commando's hebben geen effect op de batterij | Controleer of de bedrijfsmodus Manual is, of Read API en Write API zijn ingeschakeld, of de strategie Active is en of slechts één strategie actief is (zie punt 8). |
| Open configurator opent niet of blijft leeg | De tunnel is nog niet actief. Wacht ongeveer 30 seconden en controleer of de controller online is. |
Inloggen met admin wordt geweigerd |
Het wachtwoord is tijdens de installatie gewijzigd. Vraag het aan de installateur. Het wachtwoord van uw Reduxi-account werkt hier niet. |
reduxi.local laadt niet |
Uw apparaat bevindt zich niet in hetzelfde netwerk als de controller. Gebruik het IP-adres of de tunnelverbinding. |
| Communicatietest mislukt, apparaat toont offline | Controleer de bereikbaarheid, het IP-adres, de poort en de unit ID, en of het protocol op het apparaat is ingeschakeld. |