Så ansluter du sonnenBatterie till Reduxi controller
Anslut din sonnenBatterie till Reduxi Controller och låt Reduxi-strategier ladda och urladda den till de bästa priserna. Den här guiden beskriver anslutningen via JSON API och visar var guiden för REST API för Gen. 8 eller senare gäller.
Textbeskrivning av bilden
Foto av en sonnenBatterie, tillverkarens bild. Mörkgrå betongvägg i ett dunkelt rum. På väggen till vänster hänger en grå rektangulär modul med räfflad eller perforerad framsida, enligt bildtexten hybridväxelriktaren. Bredvid, till höger, står ett högt ljusgrått skåp med en rund ljusblå upplyst ring nära toppen. Ingen läsbar text på enheterna.
1 Teknisk dokumentation
Tillverkarens sidor om sonnenBatterie:
- sonnenBatterie 10 – Produktsida från tillverkaren
- Bruksanvisningar för Sonnen – Bruksanvisningar från tillverkaren
Videoguider:
2 Utrustning som behövs
Förbered följande:
- Reduxi Controller (installerad och online)
- sonnenBatterie med JSON API under Software Integration
- sonnenBatteries lokala IP-adress
- Dator i samma lokala nätverk som sonnenBatterie
- Dator eller surfplatta med internetanslutning för att konfigurera enheten i Reduxi
3 Lokal åtkomst till sonnenBatterie
Anslut sonnenBatterie till det lokala nätverket via LAN. Reduxi Controller måste vara i samma nätverk.
sonnenBatterie får sin IP-adress från:
- routern,
- en nätverksswitch,
- eller en lokal DHCP-server.
För att hitta sonnenBatteries IP-adress eller DNS-namn använder du find-my.sonnen-batterie.com och följer Sonnens anvisning.
Öppna en webbläsare och ange sonnenBatteries lokala IP-adress för att öppna dess webbgränssnitt. Exempel: http://<IP>
4 Enhetskonfiguration på sonnenBatterie
Logga in i sonnenBatteries webbgränssnitt (se punkt 3). Du behöver API-token och IP-adressen för Reduxi Controller (se punkt 6).
4.1 Öppna Software Integration
Textbeskrivning av bilden
Skärmbild av webbgränssnittet för sonnenBatterie i en webbläsare, sidan Software-Integration, fliken JSON API. Adressfältet visar en lokal IP-adress följd av sökvägen dash/software-integration/json-api, IP-adressen är markerad med en röd ruta och en pil med etiketten SonnenBatterie IP. Vänstermeny: Dashboard, System, Inverter, Settings, Network och Software-Integration (markerad). Flikar: JSON API (aktiv), Webhook API och sonnenKNX Module. Två reglage är påslagna: Read API (Allows to request the current status of the sonnenBatterie, measurements and configuration values) och Write API (Send requests to charge/discharge the sonnenBatterie and set configuration values). Under dem finns fältet API Token med ett tokenvärde, markerat med en röd ruta och etiketten API Token, och en knapp Create New. En exempelrad upprepar token och IP-adress med samma markeringar. Längst ned: länken sonnenBatterie JSON API v2 documentation.
4.2 Aktivera Read API och Write API
Slå på Read API och Write API. Båda krävs: Reduxi läser mätvärdena med Read API och skickar laddnings- och urladdningskommandon med Write API.
Textbeskrivning av bilden
Beskuren skärmbild av fliken JSON API med flikarna JSON API, Webhook API och sonnenKNX Module. Reglaget Read API är påslaget. Under det står ett ljusblått meddelande This functionality is disabled while VPP is active, följt av ett nedtonat reglage Write API i avstängt läge med texten Send requests to charge/discharge the sonnenBatterie and set configuration values. En blå rektangel markerar meddelandet och reglaget Write API.
4.3 Ange driftläge
Öppna menyn Settings på vänster sida och ställ in driftläget på Manual. Först då kan Reduxi Controller ta över styrningen av batteriet.
Textbeskrivning av bilden
Skärmbild av sidan Settings i sonnenBatterie (programvara 1.15.6). Vänstermeny: Dashboard, System, Inverter, Settings (markerad), Network och Software-Integration. Kortet Operating Mode innehåller en rullgardinslista som visar Manual, den öppna listan under erbjuder Manual, Automatic - Self-Consumption, Battery-Module-Extension (30%) och Time-Of-Use. Under kortet syns ett reglage med etiketten Surplus fullcharge.
5 Logga in i Reduxis webbgränssnitt
Du kan öppna Reduxis webbgränssnitt på två sätt:
Textbeskrivning av bilden
Skärmbild av tre skärmar i mobilappen Reduxi sida vid sida, med cyanfärgade rutor och nummermärken 2 till 4. Vänster skärm (instrumentpanel, mörkt tema): menyikon uppe till vänster markerad med en ruta och märke 2; logotypen 'reduxi'; flikarna 'Real time data' (aktiv) och 'Statistics'; pris 5.79 € och temperatur 3.2 °C; energiflödesdiagram med ett hus i mitten (-1.25 kW) och ikoner med värdena 69.0 W, 1.3 kW, 1.1 kW (röd ring), -165.0 W med 97 % (röd ring) och 0.0 W längst ned; flikarna 'Power' och 'Energy'; navigering längst ned: Dashboard, Diagnostics, Device control, Settings. Mellersta skärmen (sidomeny): logotypen 'reduxi', 'Number of locations: 1233', rubriken 'Reduxi device management', posterna '+ Add Reduxi location' och 'Reduxi devices' (markerad med en ruta och märke 3), sedan 'My profile' och 'About app'. Höger skärm (enhetssida): Back; bild av en svart Reduxi-styrenhet med två Ethernet-portar; status 'Connected'; kortet 'Update available': 'New update is available for your Reduxi device.' med knappen 'Download and install update'; kortet 'Connect to configurator': 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' med knappen 'Activate tunnel connection' (markerad med en ruta och märke 4); kortet 'Unit details' med fältet 'Unit ID'.
Textbeskrivning av bilden
Skärmbild i två delar sida vid sida. Vänster del: skärm i mobilappen Reduxi på mörk bakgrund. Överst: knappen Back; bild av en svart Reduxi-styrenhet med två Ethernet-portar och ett plintblock; status 'Connected' med en Wi-Fi-ikon. Kortet 'Update available': 'New update is available for your Reduxi device.' med knappen 'Download and install update'. Kortet 'Connect to configurator' med en nyckelikon: 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' och knappen 'Open configurator', markerad med en cyanfärgad ruta och nummermärke 5. Under: kortet 'Unit details' med fältet 'Unit ID' (värdet syns inte). Höger del: Reduxi Configurator öppnad i en webbläsare, markerad med en cyanfärgad ram och nummermärke 6. Överst: bakåtpil, 'Tunnel connection', uppdateringsikon. Sidofält till vänster med ikoner (blixt, chip, blixtsymbol, stapeldiagram, kugghjul). Sidan 'Home' med en grön länkikon. Grön notis: 'New patch available. Click here to apply.' med ett stäng-X. Tid 09:12:56. Energiflödesdiagram med ett hus i mitten (1.700 kW) och ikoner för nät (0.000 kW), sol (1.700 kW), batteri (grönt, 0.000 kW och 0.800 kW), en enhet till vänster (0.900 kW), elfordon och en laddare eller enhet längst ned. Etiketten 'Energy manager' längst ned.
http://reduxi.local. Du hittar styrenhetens IP-adress i routerns enhetslista eller i Reduxi-appen under Reduxi devices.admin · Lösenord: admin (fabriksinställning)Textbeskrivning av bilden
Skärmbild av inloggningssidan till Reduxi Configurator i ett Chrome-fönster. Adressfältet visar 'Not secure' och 'reduxi.local'; adressfältet är markerat med en cyanfärgad ruta och en förstorad kopia av det (cyanfärgad ruta, texten 'Not secure reduxi.local') visas till vänster, förbunden med en cyanfärgad linje. Sidans bakgrund: en ljusgrå linjeteckning av ett hus med solpaneler (gröna), en laddbox, en växelriktare, en bil och en laddare. Uppe till vänster: logotypen 'reduxi configurator'. Inloggningsruta i mitten med rubriken 'Login', en språkväljare (engelsk flagga, 'English'), ett användarnamnsfält och ett lösenordsfält samt en mörk knapp 'Login'.
Textbeskrivning av bilden
Skärmbild av webbgränssnittet i Reduxi Configurator efter inloggning, ljust tema. Uppe till vänster: logotypen 'reduxi configurator'. Rubrikfält: 'Home' till vänster, grön status 'Connected' uppe till höger. Vänster sidofält: utfällt avsnitt 'Devices' med en lista med poster, därefter hopfällda avsnitt 'Manager', 'Configuration' och 'Settings'. Huvudytan: energiflödesdiagram. Hus i mitten med en ring, värde 24.20 kW. Grid-ikon uppe till vänster, 24.20 kW (röd punkt på linjen). Solar-ikon uppe till höger, värde '-'. Ikon till vänster (batteri eller enhet), 6.700 kW (grön punkt på linjen). Ikoner till höger (batterilager och en enhet), värden '-'. EV charger-ikon nere till vänster, 31.00 kW. Ytterligare en enhetsikon nere till höger. Etiketten 'Energy manager' under huset.
6 Lägg till sonnenBatterie i Reduxi
Följ de här stegen för att lägga till sonnenBatterie som en ny enhet i Reduxi Controller.
6.1 Grundinställningar
Logga in i Reduxi Configurator (se punkt 5, se även How to log in to Reduxi Configurator via browser) och klicka på + Add device.
Textbeskrivning av bilden
Skärmbild av vänstermenyn i Reduxi Configurator under logotypen reduxi Configurator. Menyposter: Devices (utfällt, med ett minustecken) som innehåller knappen '+ Add device' (kontur); Strategies (plustecken); Utility Rate Plan; Settings (plustecken). Högra sidan är tom vit.
I första steget definierar du grundinställningarna:
- Device type: Hybrid Inverter
- Type: Sonnen
- Name: ett namn som du väljer
Textbeskrivning av bilden
Skärmdump av formuläret Basic settings i Reduxi Configurator. Fält: Device type (rullgardinsmeny, värdet i liten text); Type (rullgardinsmeny, värdet verkar vara Sonnen, liten text); Name (textfält, värdet verkar vara sonnen, liten text). Under finns avsnittet Include in Strategy med en tabell: kolumnerna Strategy, Measurement Device, Regulated Device; två rader, båda märkta Energy manager, var och en med en liten indikator i kolumnerna Measurement Device och Regulated Device. Knappar: Back (längst ner till vänster, vit), Next (längst ner till höger, svart). Bilden har låg upplösning och det mesta av texten är liten.
Klicka på Next.
6.2 Kommunikationsinställningar
Ange anslutningsparametrarna mellan Reduxi Controller och sonnenBatterie. Använd IP-adressen och API-token från punkt 4.
| Parameter | Värde |
|---|---|
| Anslutning | TCP/IP |
| IP | sonnenBatteries IP-adress |
| Port | 80 |
| API-token | API-token från fliken JSON API (punkt 4, punkt 4.1) |
| Märkeffekt | Välj den nominella effekt som passar din sonnenBatterie |
| PV | Välj Yes om en PV-mätare är installerad, annars No |
Textbeskrivning av bilden
Skärmbild av formuläret Communication channel and device configuration i Reduxi Configurator. Fält uppifrån och ned: Connection (TCP/IP), IP (tomt, med en ljusblå pil som pekar på fältet), Port (80), API token (tomt, med en ljusblå pil, hjälptext: API token is located in inverter web interface in section Software-Integration / JSON API), Rated power (14.4 kW) och PV (Yes, hjälptext: Is PV meter installed?). Knappar längst ned: Back, Test communication och Next.
6.3 Testa kommunikationen
Klicka på Test communication längst ned i guiden. Testet läser av sonnenBatterie en gång och sparar ingenting. Om testet lyckas klickar du på Next.
Testet ger ett av två resultat:
Textbeskrivning av bilden
Skärmbild av knappfältet längst ned på en sida i Reduxi Configurator. Vänster: knappen 'Back'. Höger: knappen 'Test communication' (markerad med en cyanfärgad ruta) och den mörka knappen 'Done'.
Textbeskrivning av bilden
Skärmdump av dialogrutan Test communication i Reduxi Configurator med ett stängningsikon (x) uppe till höger. Vit resultatruta, grön text: Successful readout from device. Värden: 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. Knapp: Close (mörk, längst ner till höger).
Textbeskrivning av bilden
Skärmdump av en dialogruta Test communication (stängningskryss uppe till höger). Första rutan: Unable to communicate with device. Andra rutan med röd 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. Knapp: Close (mörk).
Om du får meddelandet “Unable to communicate with device” kontrollerar du inställningarna (se Punkt 8).
6.4 Avancerade inställningar
De avancerade inställningarna är valfria och beror på platsens behov. När du är klar klickar du på Done: bara Done skapar enheten.
Textbeskrivning av bilden
Skärmbild av guiden i Reduxi Configurator, steg 3 av 3 Advanced settings, förloppsraden visar Basic settings, Communication channel och Advanced settings. Reglage av typen Yes/No, alla inställda på 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). Tre rullgardinslistor L1, L2 och L3 is connected to main feed är inställda på L1, L2 och L3. Knappar: Back till vänster och Done till höger.
7 Kontrollera avläsningarna och konfigurera strategier
7.1 Last measurements
När kommunikationen är upprättad kontrollerar du mätvärdena under Devices – din Sonnen-enhet – Last measurements i Reduxi Configurator.
7.2 Control type
Öppna Devices – din Sonnen-enhet i Reduxi Configurator och ställ in control type på AUTO. Kommandona från strategin påverkar då batteriet.
7.3 Reduxi Cloud
Så lägger du till och ansluter styrenheten till Reduxi Cloud: Reduxi Cloud
När enheten har lagts till kan du övervaka och styra den i Reduxi-appen också.
7.4 Strategier
För att konfigurera strategier och AI Energy Manager använder du dokumentationen nedan.
8 Checklista
Gå igenom den här checklistan för korrekt konfiguration och tillförlitlig drift.
8.1 På Reduxi Controller
-
IP-adress och port: sonnenBatteries IP-adress och port
80är angivna. - API-token: En giltig API-token är angiven.
- Nominell effekt och PV: Den nominella effekten och valet för PV stämmer överens med systemet.
- Kommunikationstest: Kommunikationstestet har slutförts utan fel.
- Control type: Enhetens control type är inställd på AUTO.
- Nåbarhet: Enhetens IP-adress kan nås från Reduxi Controller.
8.2 I webbgränssnittet för sonnenBatterie
- API-behörigheter: Både Read API och Write API är aktiverade.
- VPP: Batteriet är bortkopplat från VPP.
- Driftläge: Driftläget är Manual.
8.3 Strategi
- Aktiv strategi: Den valda strategin är inställd på Active.
- AI-energioptimering: Optimering med AI Energy Manager är aktiverad i strategin.
- En enda aktiv strategi: Bara en strategi är aktiv åt gången.
- Import-/exportgränser: Import- och exportgränserna är definierade och konfigurerade.
✓ Sammanfattning
Förberedelser (punkt 1–3): Förbered den lokala IP-adressen och en dator i samma nätverk. Öppna sonnenBatteries webbgränssnitt.
sonnenBatterie (punkt 4): Öppna Software-Integration, fliken JSON API. Aktivera Read API och Write API (koppla först bort batteriet från VPP), kopiera eller skapa API-token och ställ in driftläget på Manual.
Lägg till i Reduxi (punkt 5–6): Öppna Configurator och lägg till enheten med typen Sonnen. Ange IP-adress, port 80, API-token, nominell effekt och PV. Kör Test communication och klicka sedan på Done.
Driftsättning (punkt 7–8): Kontrollera mätvärdena, ställ in control type på AUTO, ställ in strategierna och gå igenom checklistan.
→ Vanliga problem
| Problem | Lösning |
|---|---|
| Test communication visar “Unable to communicate with device” | Kontrollera IP-adressen, port 80, API-token och att IP-adressen går att nå från styrenheten (se punkt 8). |
| Write API går inte att slå på | Meddelandet “This functionality is disabled while VPP is active” visas. Koppla bort batteriet från VPP och aktivera sedan Write API (se punkt 4.2). |
| Ingen API-token tillgänglig | Öppna Software-Integration, fliken JSON API, i sonnenBatteries webbgränssnitt och klicka på Create New. |
| Reduxi-kommandon påverkar inte batteriet | Kontrollera att driftläget är Manual, att Read API och Write API är aktiverade, att control type är AUTO, att strategin är Active och att bara en strategi är aktiv (se punkt 8). |
| Open configurator öppnas inte eller förblir tom | Tunneln är inte aktiv ännu. Vänta cirka 30 sekunder och kontrollera att styrenheten är online. |
| Inloggning med admin avvisas | Lösenordet ändrades vid installationen. Fråga installatören. Lösenordet till Reduxi-kontot fungerar inte här. |
| reduxi.local laddas inte | Din enhet är inte i samma nätverk som styrenheten. Använd IP-adressen eller tunnelanslutningen. |
| Kommunikationstestet misslyckas, enheten visas som offline | Kontrollera nåbarhet, IP-adress och port samt att API:t är aktiverat på enheten. |