Kako povezati sonnenBatterie (Gen. 8 ili novija, povezivanje putem REST API-ja) s Reduxi kontrolerom
Povežite sonnenBatterie Gen. 8 ili noviju s Reduxi Controllerom putem REST API-ja.
Tekstualni opis ove slike
Fotografija sonnenBatterie, slika proizvođača. Tamnosivi betonski zid u prigušeno osvijetljenoj prostoriji. Na zidu lijevo visi siva pravokutna jedinica s rebrastom ili perforiranom prednjom stranom, prema opisu ispod slike hibridni izmjenjivač. Pored nje, desno, stoji visok svijetlosivi ormar s okruglim svijetloplavim osvijetljenim prstenom pri vrhu. Na uređajima nema čitljivog teksta.
1 Tehnička dokumentacija
Stranice proizvođača za sonnenBatterie:
- sonnenBatterie 10 – stranica proizvoda proizvođača
- Sonnen korisnički priručnici – korisnički priručnici proizvođača
Video tutorijali:
2 Potrebna oprema
Pripremite sljedeće:
- Reduxi Controller (instaliran i online)
- sonnenBatterie Gen. 8 ili novija (REST API)
- Lokalna IP adresa uređaja sonnenBatterie
- Lozinka instalatera za sonnenBatterie (vidi Točku 4)
- Računalo u istoj lokalnoj mreži kao sonnenBatterie
- Prijenosno računalo ili tablet s pristupom internetu za konfiguriranje uređaja u Reduxiju
3 Lokalni pristup uređaju sonnenBatterie
Prije početka provjerite imate li lokalnu IP adresu uređaja sonnenBatterie i je li Vaše računalo povezano s istom lokalnom mrežom.
sonnenBatterie dobiva IP adresu od:
- usmjerivača,
- mrežnog preklopnika,
- ili lokalnog DHCP poslužitelja.
Za pronalazak IP adrese ili DNS naziva uređaja sonnenBatterie koristite find-my.sonnen-batterie.com i slijedite Sonnen uputu.
Otvorite web preglednik i unesite lokalnu IP adresu uređaja sonnenBatterie kako biste otvorili njegovo web sučelje. Primjer: http://<IP>
4 Konfiguracija uređaja na sonnenBatterie
4.1 Prijava instalatera
Nakon što IP adresu otvorite u pregledniku, pojavljuje se zaslon za prijavu. Kao vrstu prijave odaberite Installer i unesite lozinku instalatera.
Ako Vam je potreban pristup, obratite se instalateru koji je pustio sustav u rad ili Sonnen podršci. Sonnen podrška može provjeriti zahtjev, otključati pristup ili izvršiti potrebne promjene umjesto Vas.
Tekstualni opis ove slike
Snimka zaslona zaslona za prijavu web sučelja sonnenBatterie, široki prozor s sonnen logotipom u tamnoj gornjoj traci. Središnji okvir za prijavu s naslovom Dashboard. Tekst: Please choose a login. Padajući izbornik s odabranom vrijednošću Installer. Oznaka polja Password, polje prazno. Svijetloplavi gumb Login.
4.2 Dashboard
Nakon uspješne prijave prikazuje se Menu / Dashboard.
Tekstualni opis ove slike
Snimka zaslona web sučelja sonnenBatterie, stranica Dashboard, sa sonnen logotipom u tamnoj gornjoj traci. Lijevi izbornik: Dashboard (istaknuto svijetloplavo), System, Settings, Battery, Inverter, Powermeter, Powermeter Setup, IOs, Software-Installer, Commissioning Assistant, System-Status, Network, Software-Integration. Naslov glavnog područja: Dashboard. Dijagram toka energije s četiri okvira: production 3145 W (žuto, ikona solarnog panela); consumption 1875 W (plavo, ikona kuće); FeedIn 1273 W (sivo, ikona dalekovodnog stupa); active power sa statusom idle, rSOC: 16% i uSOC: 9% (zeleno, ikona baterije). Žuta strelica ide od okvira production do okvira baterije, zelena strelica ide od okvira baterije prema gore do okvira consumption.
4.3 Omogućavanje REST API-ja uređaja sonnenBatterie
Na dashboardu učinite sljedeće:
Tekstualni opis ove slike
Snimka zaslona web sučelja sonnenBatterie, stranica Software-Integration (sonnen logotip u tamnoj gornjoj traci; serijski broj i verzija softvera prikazani gore desno sitnim tekstom). Lijevi izbornik: Dashboard, System, Settings, Battery, Inverter, Powermeter, Powermeter Setup, I/Os, Software-Installer, Commissioning Assistant, System-Status, Network, Software-Integration (istaknuto crvenim okvirom). Kartice: JSON API (odabrano), WebSocket API, Generated Docs (sitan tekst). Dva prekidača, oba uključena (plavo) i svaki označen crvenim okvirom: Read API (tekst ispod: allows to request the current status of the sonnenBatterie, measurements and configuration values) i Write API (tekst ispod: send requests to change or discharge the sonnenBatterie and set configuration values). Crveni okvir označava redak API Token: vrijednost tokena (ovdje nije prikazana, zacrnjena) i gumb Create New. Ispod: primjer curl naredbe sa zaglavljem Auth-Token i URL-om koji završava na /api/v2/latestdata. Naslov Documentation s poveznicom na dokumentaciju sonnenBatterie JSON API-ja.
4.4 Postavljanje načina rada
Otvorite izbornik Settings s lijeve strane i odaberite način rada Manual.
Tekstualni opis ove slike
Snimka zaslona web sučelja sonnenBatterie, stranica Settings (gore desno prikazano Software: 1.15.6, ostatak odrezan). Lijevi izbornik: Dashboard, System, Inverter, Settings (istaknuto plavo), Network, Software-Integration. Naslov glavnog područja: Settings. Odjeljak: Operating Mode. Otvoren je padajući izbornik s odabranom stavkom Manual (istaknuto sivo). Navedene opcije: Manual; Automatic - Self-Consumption; Battery-Module-Extension (30%); Time-Of-Use. Ispod padajućeg izbornika vidljiv je prekidač s oznakom Surplus fullcharge, isključen (sivo).
5 Prijava u Reduxi web sučelje
Reduxi web sučelje možete otvoriti na dva načina:
Tekstualni opis ove slike
Snimka zaslona triju zaslona mobilne aplikacije Reduxi jedan pored drugog, s cijan okvirima i brojčanim oznakama 2 do 4. Lijevi zaslon (nadzorna ploča, tamna tema): ikona izbornika gore lijevo označena okvirom i oznakom 2; logotip 'reduxi'; kartice 'Real time data' (aktivna) i 'Statistics'; cijena 5.79 € i temperatura 3.2 °C; dijagram toka energije s kućom u sredini (-1.25 kW) i ikonama s vrijednostima 69.0 W, 1.3 kW, 1.1 kW (crveni prsten), -165.0 W s 97 % (crveni prsten) i vrijednostima 0.0 W pri dnu; kartice 'Power' i 'Energy'; donja navigacija: Dashboard, Diagnostics, Device control, Settings. Srednji zaslon (bočni izbornik): logotip 'reduxi', 'Number of locations: 1233', naslov 'Reduxi device management', stavke '+ Add Reduxi location' i 'Reduxi devices' (označeno okvirom i oznakom 3), zatim 'My profile' i 'About app'. Desni zaslon (stranica uređaja): Back; slika crnog Reduxi kontrolera s dva Ethernet priključka; status 'Connected'; kartica 'Update available': 'New update is available for your Reduxi device.' s gumbom 'Download and install update'; kartica 'Connect to configurator': 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' s gumbom 'Activate tunnel connection' (označen okvirom i oznakom 4); kartica 'Unit details' s poljem 'Unit ID'.
Tekstualni opis ove slike
Snimka zaslona sastavljena od dva dijela jedan pored drugog. Lijevi dio: zaslon mobilne aplikacije Reduxi na tamnoj pozadini. Gore: gumb Back; slika crnog Reduxi kontrolera s dva Ethernet priključka i priključnom stezaljkom; status 'Connected' s ikonom Wi-Fi-ja. Kartica 'Update available': 'New update is available for your Reduxi device.' s gumbom 'Download and install update'. Kartica 'Connect to configurator' s ikonom ključa: 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' i gumb 'Open configurator', označen cijan okvirom i brojčanom oznakom 5. Ispod: kartica 'Unit details' s poljem 'Unit ID' (vrijednost nije vidljiva). Desni dio: Reduxi Configurator otvoren u pregledniku, označen cijan okvirom i brojčanom oznakom 6. Zaglavlje: strelica za povratak, 'Tunnel connection', ikona ponovnog učitavanja. Lijeva bočna traka s ikonama (munja, čip, munja, stupčasti grafikon, zupčanik). Stranica 'Home' sa zelenom ikonom veze. Zelena obavijest: 'New patch available. Click here to apply.' sa zatvaranjem X. Vrijeme 09:12:56. Dijagram toka energije s kućom u sredini (1.700 kW) i ikonama za mrežu (0.000 kW), solar (1.700 kW), bateriju (zelena, 0.000 kW i 0.800 kW), uređaj lijevo (0.900 kW), električno vozilo te punjač ili uređaj pri dnu. Oznaka 'Energy manager' pri dnu.
http://reduxi.local. IP adresu kontrolera možete pronaći na popisu uređaja u routeru ili u aplikaciji Reduxi pod Reduxi devices.admin · Lozinka: admin (tvornička postavka)Tekstualni opis ove slike
Snimka zaslona stranice za prijavu u Reduxi Configurator u prozoru preglednika Chrome. Adresna traka prikazuje 'Not secure' i 'reduxi.local'; adresna traka označena je cijan okvirom, a njezina povećana kopija (cijan okvir, tekst 'Not secure reduxi.local') prikazana je lijevo, povezana cijan linijom. Pozadina stranice: svijetlosiva linijska ilustracija kuće sa solarnim panelima (zeleno), zidnom kutijom, inverterom, automobilom i punjačem. Gore lijevo: logotip 'reduxi configurator'. U sredini okvir za prijavu s naslovom 'Login', odabirom jezika (engleska zastava, 'English'), poljem za korisničko ime, poljem za lozinku i tamnim gumbom 'Login'.
Tekstualni opis ove slike
Snimka zaslona web sučelja Reduxi Configuratora nakon prijave, svijetla tema. Gore lijevo: logotip 'reduxi configurator'. Zaglavna traka: 'Home' lijevo, zeleni status 'Connected' gore desno. Lijeva bočna traka: proširen odjeljak 'Devices' s popisom stavki, zatim sklopljeni odjeljci 'Manager', 'Configuration' i 'Settings'. Glavno područje: dijagram toka energije. Kuća u sredini s prstenom, vrijednost 24.20 kW. Ikona mreže gore lijevo, 24.20 kW (crvena točka na liniji). Ikona sunca gore desno, vrijednost '-'. Lijeva ikona (baterija ili uređaj), 6.700 kW (zelena točka na liniji). Desne ikone (baterijski spremnik i uređaj), vrijednosti '-'. Ikona EV punjača dolje lijevo, 31.00 kW. Još jedna ikona uređaja dolje desno. Oznaka 'Energy manager' ispod kuće.
6 Dodavanje sonnenBatterie u Reduxi
Slijedite ove korake za dodavanje novog uređaja na Reduxi Controller.
6.1 Osnovne postavke
Prijavite se u Reduxi Configurator (vidi Točku 5; vidi i Kako se prijaviti u Reduxi Configurator putem preglednika) i kliknite + Add device.
Tekstualni opis ove slike
Snimka zaslona lijevog izbornika Reduxi Configuratora ispod logotipa reduxi Configurator. Stavke izbornika: Devices (proširen, sa znakom minus) koji sadrži gumb '+ Add device' (s obrubom); Strategies (znak plus); Utility Rate Plan; Settings (znak plus). Desna strana je prazna bijela.
U prvom koraku definirajte osnovne postavke:
- Device type:
Hybrid Inverter - Type:
Sonnen - Name: naziv po Vašem izboru
Tekstualni opis ove slike
Snimka zaslona obrasca Reduxi Configuratora s naslovom Basic settings. Polja: Device type (padajući izbornik, vrijednost sitnim tekstom); Type (padajući izbornik, vrijednost izgleda kao Sonnen, sitan tekst); Name (tekstualno polje, vrijednost izgleda kao sonnen, sitan tekst). Ispod je odjeljak Include in Strategy s tablicom: stupci Strategy, Measurement Device, Regulated Device; dva retka, oba označena Energy manager, svaki s malim indikatorom u stupcima Measurement Device i Regulated Device. Gumbi: Back (dolje lijevo, bijelo), Next (dolje desno, crno). Slika je niske razlučivosti i većina je teksta sitna.
Kliknite Next.
6.2 Postavke komunikacije
| Parametar | Vrijednost |
|---|---|
| Veza | TCP/IP |
| IP | IP adresa uređaja sonnenBatterie |
| API token | API token iz Točke 4, točka 4.3 |
| PV | Odaberite vrstu izmjenjivača: AC‑coupled (baterija i izmjenjivač su odvojeni) ili Hybrid (baterija i izmjenjivač integrirani su u jedan sustav) |
Tekstualni opis ove slike
Snimka zaslona obrasca Reduxi Configuratora s naslovom Communication channel and device configuration. Slika je niske razlučivosti. Polja: Connection type (padajući izbornik); IP (tekstualno polje, prazno) s crnim gumbom Scan for IP; Port: 80; Reconnect IP recovery (prekidač, oznaka Yes, uključen); API token (tekstualno polje, prazno); drugi prekidač s kratkim naslovom i tekstom Yes/No; Number of AC system units: 1; What is type of inverter (padajući izbornik): AC coupled system. Gumbi: Back (dolje lijevo), Test communication i Done (dolje desno, Done je crno).
6.3 Testiranje komunikacije
Kliknite Test communication pri dnu čarobnjaka. On jednom očitava sonnenBatterie i ništa ne sprema. Ako test uspije, kliknite Done: uređaj kreira samo Done.
Tekstualni opis ove slike
Snimka zaslona donje trake s gumbima na stranici Reduxi Configuratora. Lijevo: gumb 'Back'. Desno: gumb 'Test communication' (označen cijan okvirom) i tamni gumb 'Done'.
Tekstualni opis ove slike
Snimka zaslona stranice 'Communication channel and device configuration' u Reduxi Configuratoru. Connection *: TCP/IP (padajući izbornik). IP *: 192.168.50.243, s gumbom 'Scan for IP'. Port *: 502, s gumbom 'Test port'. Modbus unit ID *: 1. Gumbi pri dnu: Back (lijevo), Test communication i Done (desno). Gumb Done označen je cijan okvirom.
Test daje jedan od dva rezultata:
Tekstualni opis ove slike
Snimka zaslona dijaloškog okvira Test communication u Reduxi Configuratoru s ikonom za zatvaranje (x) gore desno. Bijeli okvir rezultata, zeleni tekst: Successful readout from device. Vrijednosti: 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. Gumb: Close (tamno, dolje desno).
Tekstualni opis ove slike
Snimka zaslona dijaloškog okvira s naslovom Test communication (X za zatvaranje gore desno). Prvi okvir: Unable to communicate with device. Drugi okvir s crvenim tekstom: 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. Gumb: Close (tamno).
Ako dobijete poruku “Unable to communicate with device”, provjerite postavke (vidi Točku 8).
7 Provjera očitanja i postavljanje strategija
7.1 Last measurements
Nakon uspostave komunikacije provjerite izmjerene vrijednosti pod Devices – your Sonnen device – Last measurements u Reduxi Configuratoru.
7.2 Reduxi Cloud
Kako dodati i povezati kontroler s Reduxi Cloudom: Reduxi Cloud
7.3 Strategije
Za postavljanje strategija i AI Energy Managera koristite dokumentaciju u nastavku.
8 Kontrolni popis
Pregledajte ovaj kontrolni popis radi ispravnog postavljanja i pouzdanog rada.
8.1 Na Reduxi Controlleru
- IP adresa: za povezani uređaj unesena je ispravna IP adresa.
- API token: unesen je važeći API token.
- Vrsta sustava: odabrana je ispravna vrsta sustava: AC‑coupled ili Hybrid.
- Test komunikacije: test komunikacije uspješno je završen.
- Dostupnost: IP adresa uređaja dostupna je s Reduxi Controllera.
8.2 Na web sučelju uređaja sonnenBatterie
- API dozvole: omogućeni su i Read API i Write API.
- Način rada: način rada je Manual.
8.3 Strategija
- Aktivna strategija: odabrana strategija postavljena je na Active.
- AI optimizacija energije: u strategiji je omogućena optimizacija AI Energy Managera.
- Jedna aktivna strategija: istodobno je aktivna samo jedna strategija.
- Ograničenja preuzimanja/isporuke: ograničenja preuzimanja i isporuke definirana su i konfigurirana.
✓ Sažetak
Priprema (točke 1–3): pripremite lokalnu IP adresu, lozinku instalatera i računalo u istoj mreži. Otvorite web sučelje uređaja sonnenBatterie.
sonnenBatterie (točka 4): prijavite se kao Installer, omogućite Read API i Write API, kopirajte ili kreirajte API token i postavite način rada na Manual.
Dodavanje u Reduxi (točke 5–6): otvorite Configurator i dodajte uređaj tipa Sonnen. Unesite IP adresu, API token i vrstu izmjenjivača (AC‑coupled ili Hybrid). Pokrenite Test communication.
Puštanje u rad (točke 7–8): provjerite očitanja, postavite strategije i prođite kontrolni popis.
→ Česti problemi
| Problem | Rješenje |
|---|---|
| Test communication prikazuje “Unable to communicate with device” | Sustav nije ispravno konfiguriran. Provjerite IP adresu, API token, vrstu sustava (AC‑coupled ili Hybrid) i je li IP adresa dostupna s kontrolera (vidi Točku 8). |
| Prijava instalatera nije moguća | Lozinka instalatera nije dostupna krajnjim korisnicima. Obratite se instalateru koji je pustio sustav u rad ili Sonnen podršci (vidi Točku 4). |
| API token nije dostupan | Otvorite Software Integration u web sučelju uređaja sonnenBatterie i kliknite Create new pri dnu stranice. |
| Reduxi naredbe nemaju učinka na bateriju | Provjerite je li način rada Manual, jesu li Read API i Write API omogućeni, je li strategija Active i je li aktivna samo jedna strategija (vidi Točku 8). |
| Open configurator se ne otvara ili ostaje prazan | Tunel još nije aktivan. Pričekajte oko 30 sekundi i provjerite je li kontroler online. |
Prijava s admin se odbija |
Lozinka je promijenjena tijekom instalacije. Pitajte instalatera. Lozinka Reduxi računa ovdje ne radi. |
reduxi.local se ne učitava |
Vaš uređaj nije u istoj mreži kao kontroler. Koristite IP adresu ili tunelsku vezu. |
| Test komunikacije ne uspijeva, uređaj je offline | Provjerite dostupnost, IP adresu / port / unit ID te je li protokol uključen na uređaju. |