sonnenBatterie aansluiten op de Reduxi controller
Verbind uw sonnenBatterie met de Reduxi Controller en laat Reduxi-strategieën hem laden en ontladen tegen de beste prijzen. Deze handleiding behandelt de verbinding via de JSON API en laat zien waar de REST API-handleiding voor Gen. 8 of hoger van toepassing is.
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.
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 met de JSON API onder Software Integration
- Lokaal IP-adres van de sonnenBatterie
- 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
Sluit de sonnenBatterie via LAN aan op het lokale netwerk. De Reduxi Controller moet in hetzelfde netwerk zitten.
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
Log in op de webinterface van de sonnenBatterie (zie Punt 3). U hebt het API-token en het IP-adres nodig voor de Reduxi Controller (zie Punt 6).
4.1 Software Integration openen
Tekstbeschrijving van deze afbeelding
Schermafbeelding van de webinterface van de sonnenBatterie in een browser, pagina Software-Integration, tabblad JSON API. De adresbalk toont een lokaal IP-adres gevolgd door het pad dash/software-integration/json-api; het IP-adres is gemarkeerd met een rood kader en een pijl met het label SonnenBatterie IP. Menu links: Dashboard, System, Inverter, Settings, Network en Software-Integration (gemarkeerd). Tabbladen: JSON API (actief), Webhook API en sonnenKNX Module. Twee schakelaars staan aan: Read API (Allows to request the current status of the sonnenBatterie, measurements and configuration values) en Write API (Send requests to charge/discharge the sonnenBatterie and set configuration values). Daaronder het veld API Token met een tokenwaarde, gemarkeerd met een rood kader en het label API Token, en een knop Create New. Een voorbeeldregel herhaalt het token en het IP-adres met dezelfde markeringen. Onderaan: link sonnenBatterie JSON API v2 documentation.
4.2 Read API en Write API inschakelen
Schakel Read API en Write API in. Beide zijn nodig: Reduxi leest de metingen met de Read API en stuurt laad- en ontlaadcommando's met de Write API.
Tekstbeschrijving van deze afbeelding
Bijgesneden schermafbeelding van het tabblad JSON API met de tabbladen JSON API, Webhook API en sonnenKNX Module. De schakelaar Read API staat aan. Daaronder staat een lichtblauwe melding met de tekst This functionality is disabled while VPP is active, gevolgd door een grijze schakelaar Write API in de stand uit met de tekst Send requests to charge/discharge the sonnenBatterie and set configuration values. Een blauwe rechthoek markeert de melding en de schakelaar Write API.
4.3 De bedrijfsmodus instellen
Open het menu Settings aan de linkerkant en stel de bedrijfsmodus in op Manual. Alleen dan kan de Reduxi Controller de aansturing van de batterij overnemen.
Tekstbeschrijving van deze afbeelding
Schermafbeelding van de pagina Settings van de sonnenBatterie (software 1.15.6). Menu links: Dashboard, System, Inverter, Settings (gemarkeerd), Network en Software-Integration. De kaart Operating Mode bevat een keuzelijst met Manual; de geopende lijst eronder biedt Manual, Automatic - Self-Consumption, Battery-Module-Extension (30%) en Time-Of-Use. Onder de kaart is een schakelaar met het label Surplus fullcharge zichtbaar.
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 de sonnenBatterie als nieuw apparaat toe aan de Reduxi Controller.
6.1 Basisinstellingen
Log in op de Reduxi Configurator (zie Punt 5; zie ook How to log in to Reduxi Configurator via 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:
- Apparaattype: 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
Voer de verbindingsparameters tussen de Reduxi Controller en de sonnenBatterie in. Gebruik het IP-adres en het API-token uit Punt 4.
| Parameter | Waarde |
|---|---|
| Verbinding | TCP/IP |
| IP | IP-adres van de sonnenBatterie |
| Poort | 80 |
| API-token | Het API-token van het tabblad JSON API (Punt 4, punt 4.1) |
| Nominaal vermogen | Kies het nominale vermogen dat bij uw sonnenBatterie past |
| PV | Kies Yes als er een PV-meter is geïnstalleerd, anders No |
Tekstbeschrijving van deze afbeelding
Schermafbeelding van het formulier Communication channel and device configuration in de Reduxi Configurator. Velden van boven naar beneden: Connection (TCP/IP), IP (leeg, met een lichtblauwe pijl die naar het veld wijst), Port (80), API token (leeg, met een lichtblauwe pijl; hint: API token is located in inverter web interface in section Software-Integration / JSON API), Rated power (14.4 kW) en PV (Yes; hint: Is PV meter installed?). Knoppen onderaan: Back, Test communication en Next.
6.3 Communicatie testen
Klik onderaan in de wizard op Test communication. Hiermee leest u de sonnenBatterie één keer uit en wordt er niets opgeslagen. Is de test geslaagd, klik dan op Next.
De test geeft een van twee resultaten:
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 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).
6.4 Geavanceerde instellingen
De geavanceerde instellingen zijn optioneel en hangen af van de behoeften van de locatie. Klik als u klaar bent op Done: pas met Done wordt het apparaat aangemaakt.
Tekstbeschrijving van deze afbeelding
Schermafbeelding van de wizard van de Reduxi Configurator, stap 3 van 3 Advanced settings; de voortgangsbalk toont Basic settings, Communication channel en Advanced settings. Yes/No-schakelaars, allemaal op 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). Drie keuzelijsten L1, L2 en L3 is connected to main feed staan op L1, L2 en L3. Knoppen: Back links en Done rechts.
7 De metingen controleren en strategieën instellen
7.1 Laatste metingen
Nadat de communicatie tot stand is gekomen, controleert u de meetwaarden onder Devices – uw Sonnen-apparaat – Last measurements in de Reduxi Configurator.
7.2 Regeltype
Open Devices – uw Sonnen-apparaat in de Reduxi Configurator en stel het regeltype in op AUTO. Commando's uit de strategie hebben dan invloed op de batterij.
7.3 Reduxi Cloud
Hoe u de controller toevoegt en verbindt met de Reduxi Cloud: Reduxi Cloud
Zodra het apparaat is toegevoegd, kunt u het ook volgen en aansturen in de Reduxi-app.
7.4 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 en poort: Het IP-adres van de sonnenBatterie en poort
80zijn ingevoerd. - API-token: Er is een geldig API-token ingevoerd.
- Nominaal vermogen en PV: Het nominale vermogen en de PV-keuze komen overeen met het systeem.
- Communicatietest: De communicatietest is met succes afgerond.
- Regeltype: Het regeltype van het apparaat staat op AUTO.
- 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.
- VPP: De batterij is losgekoppeld van de VPP.
- 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 en een computer in hetzelfde netwerk. Open de webinterface van de sonnenBatterie.
sonnenBatterie (punt 4): Open Software-Integration, tabblad JSON API. Schakel Read API en Write API in (koppel de batterij eerst los van de VPP), 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 IP-adres, poort 80, API-token, nominaal vermogen en PV in. Voer Test communication uit en klik daarna op Done.
In gebruik nemen (punt 7–8): Controleer de metingen, stel het regeltype in op AUTO, stel de strategieën in en loop de checklist door.
→ Veelvoorkomende problemen
| Probleem | Oplossing |
|---|---|
| Test communication toont “Unable to communicate with device” | Controleer het IP-adres, poort 80, het API-token en of het IP-adres bereikbaar is vanaf de controller (zie Punt 8). |
| Write API kan niet worden ingeschakeld | De melding “This functionality is disabled while VPP is active” wordt getoond. Koppel de batterij los van de VPP en schakel daarna de Write API in (zie Punt 4.2). |
| Geen API-token beschikbaar | Open in de webinterface van de sonnenBatterie Software-Integration, tabblad JSON API, en klik 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 het regeltype AUTO is, of de strategie Active is en of er maar éé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 en de poort, en of de API op het apparaat is ingeschakeld. |