Kako povezati sonnenBatterie (Gen. 8 ali novejša, povezava REST API) s krmilnikom Reduxi Controller
Povežite sonnenBatterie Gen. 8 ali novejšo z Reduxi Controller prek REST API.
Besedilni opis te slike
Fotografija naprave sonnenBatterie, slika proizvajalca. Temno siva betonska stena v zatemnjenem prostoru. Na steni levo visi siv pravokoten modul z narebreno ali perforirano sprednjo stranjo, po podnapisu hibridni razsmernik. Ob njem desno stoji visoka svetlo siva omara z okroglim svetlomodro osvetljenim obročem blizu vrha. Na napravah ni berljivega besedila.
1 Tehnična dokumentacija
Strani proizvajalca za sonnenBatterie:
- sonnenBatterie 10 – stran izdelka proizvajalca
- Navodila za uporabo Sonnen – navodila za uporabo proizvajalca
Video navodila:
2 Potrebna oprema
Pripravite naslednje:
- Reduxi Controller (nameščen in na spletu)
- sonnenBatterie Gen. 8 ali novejša (REST API)
- Lokalni naslov IP naprave sonnenBatterie
- Geslo monterja (installer) naprave sonnenBatterie (glejte točko 4)
- Računalnik v istem lokalnem omrežju kot sonnenBatterie
- Prenosnik ali tablica z internetno povezavo za nastavitev naprave v Reduxi
3 Lokalni dostop do sonnenBatterie
Preden začnete, poskrbite, da imate lokalni naslov IP naprave sonnenBatterie in da je vaš računalnik povezan v isto lokalno omrežje.
Naprava sonnenBatterie dobi naslov IP od:
- usmerjevalnika,
- omrežnega stikala
- ali lokalnega strežnika DHCP.
Za iskanje naslova IP ali imena DNS naprave sonnenBatterie uporabite find-my.sonnen-batterie.com in sledite navodilom Sonnen.
Odprite spletni brskalnik in vnesite lokalni naslov IP naprave sonnenBatterie, da odprete njen spletni vmesnik. Primer: http://<IP>
4 Nastavitev naprave sonnenBatterie
4.1 Prijava kot Installer
Ko v brskalniku odprete naslov IP, se prikaže prijavni zaslon. Kot vrsto prijave izberite Installer in vnesite geslo monterja.
Če potrebujete dostop, se obrnite na monterja, ki je sistem zagnal, ali na podporo Sonnen. Podpora Sonnen lahko preveri zahtevo, odklene dostop ali v vašem imenu naredi potrebne spremembe.
Besedilni opis te slike
Posnetek zaslona prijavnega zaslona spletnega vmesnika sonnenBatterie, široko okno z logotipom sonnen v temni zgornji vrstici. Osrednje prijavno okno z naslovom Dashboard. Besedilo: Please choose a login. Spustni meni z izbrano vrednostjo Installer. Oznaka polja Password, polje prazno. Svetlomodri gumb Login.
4.2 Dashboard
Po uspešni prijavi se prikaže Menu / Dashboard.
Besedilni opis te slike
Posnetek zaslona spletnega vmesnika sonnenBatterie, stran Dashboard, z logotipom sonnen v temni zgornji vrstici. Levi meni: Dashboard (označeno svetlomodro), System, Settings, Battery, Inverter, Powermeter, Powermeter Setup, IOs, Software-Installer, Commissioning Assistant, System-Status, Network, Software-Integration. Naslov glavnega območja: Dashboard. Diagram pretoka energije s štirimi okvirji: production 3145 W (rumen, ikona sončnega panela); consumption 1875 W (moder, ikona hiše); FeedIn 1273 W (siv, ikona daljnovodnega stebra); active power s stanjem idle, rSOC: 16% in uSOC: 9% (zelen, ikona baterije). Rumena puščica vodi od production do okvirja baterije, zelena puščica od okvirja baterije navzgor do consumption.
4.3 Omogočite REST API naprave sonnenBatterie
Na nadzorni plošči naredite naslednje:
Besedilni opis te slike
Posnetek zaslona spletnega vmesnika sonnenBatterie, stran Software-Integration (logotip sonnen v temni zgornji vrstici; serijska številka in različica programske opreme zgoraj desno z drobnim besedilom). Levi meni: Dashboard, System, Settings, Battery, Inverter, Powermeter, Powermeter Setup, I/Os, Software-Installer, Commissioning Assistant, System-Status, Network, Software-Integration (označeno z rdečim okvirjem). Zavihki: JSON API (izbran), WebSocket API, Generated Docs (drobno besedilo). Dve stikali, obe vklopljeni (modri) in vsako označeno z rdečim okvirjem: Read API (besedilo pod njim: allows to request the current status of the sonnenBatterie, measurements and configuration values) in Write API (besedilo pod njim: send requests to change or discharge the sonnenBatterie and set configuration values). Rdeč okvir označuje vrstico API Token: vrednost žetona (tu ni prikazana, zabrisana) in gumb Create New. Spodaj: primer ukaza curl z glavo Auth-Token in URL, ki se konča z /api/v2/latestdata. Naslov Documentation s povezavo na dokumentacijo JSON API naprave sonnenBatterie.
4.4 Nastavite način delovanja
Odprite meni Settings na levi strani in izberite način delovanja Manual.
Besedilni opis te slike
Posnetek zaslona spletnega vmesnika sonnenBatterie, stran Settings (zgoraj desno Software: 1.15.6, preostanek odrezan). Levi meni: Dashboard, System, Inverter, Settings (označeno modro), Network, Software-Integration. Naslov glavnega območja: Settings. Razdelek: Operating Mode. Odprt je spustni meni z izbranim vnosom Manual (označen sivo). Navedene možnosti: Manual; Automatic - Self-Consumption; Battery-Module-Extension (30%); Time-Of-Use. Pod spustnim menijem je vidno stikalo z oznako Surplus fullcharge, izklopljeno (sivo).
5 Prijava v spletni vmesnik Reduxi
Spletni vmesnik Reduxi lahko odprete na dva načina:
Besedilni opis te slike
Posnetek zaslona treh zaslonov mobilne aplikacije Reduxi drug ob drugem, s ciano okvirji in številčnimi značkami od 2 do 4. Levi zaslon (nadzorna plošča, temna tema): ikona menija zgoraj levo, označena z okvirjem in značko 2; logotip 'reduxi'; zavihka 'Real time data' (aktiven) in 'Statistics'; cena 5.79 € in temperatura 3.2 °C; diagram energijskega toka s hišo v sredini (-1.25 kW) in ikonami z vrednostmi 69.0 W, 1.3 kW, 1.1 kW (rdeč obroč), -165.0 W z 97 % (rdeč obroč) in vrednostmi 0.0 W spodaj; zavihka 'Power' in 'Energy'; spodnja navigacija: Dashboard, Diagnostics, Device control, Settings. Srednji zaslon (stranski meni): logotip 'reduxi', 'Number of locations: 1233', naslov 'Reduxi device management', vnosa '+ Add Reduxi location' in 'Reduxi devices' (označen z okvirjem in značko 3), nato 'My profile' in 'About app'. Desni zaslon (stran naprave): Back; slika črnega krmilnika Reduxi z dvema vratoma Ethernet; status 'Connected'; kartica 'Update available': 'New update is available for your Reduxi device.' z 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.' z gumbom 'Activate tunnel connection' (označen z okvirjem in značko 4); kartica 'Unit details' s poljem 'Unit ID'.
Besedilni opis te slike
Posnetek zaslona iz dveh delov drug ob drugem. Levi del: zaslon mobilne aplikacije Reduxi na temnem ozadju. Zgoraj: gumb Back; slika črnega krmilnika Reduxi z dvema vratoma Ethernet in priključno sponko; status 'Connected' z ikono Wi-Fi. Kartica 'Update available': 'New update is available for your Reduxi device.' z gumbom 'Download and install update'. Kartica 'Connect to configurator' z ikono ključa: 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' in gumb 'Open configurator', označen s ciano okvirjem in številčno značko 5. Spodaj: kartica 'Unit details' s poljem 'Unit ID' (vrednost ni vidna). Desni del: Reduxi Configurator, odprt v brskalniku, označen s ciano okvirjem in številčno značko 6. Glava: puščica nazaj, 'Tunnel connection', ikona osveževanja. Leva stranska vrstica z ikonami (strela, čip, strela, stolpčni diagram, zobnik). Stran 'Home' z zeleno ikono povezave. Zeleno obvestilo: 'New patch available. Click here to apply.' s križcem za zapiranje. Čas 09:12:56. Diagram energijskega toka s hišo v sredini (1.700 kW) in ikonami za omrežje (0.000 kW), sonce (1.700 kW), baterijo (zelena, 0.000 kW in 0.800 kW), napravo na levi (0.900 kW), električno vozilo ter polnilnik ali napravo spodaj. Oznaka 'Energy manager' spodaj.
http://reduxi.local. Naslov IP krmilnika najdete na seznamu naprav v usmerjevalniku ali v aplikaciji Reduxi pod Reduxi devices.admin · Geslo: admin (tovarniška nastavitev)Besedilni opis te slike
Posnetek zaslona prijavne strani Reduxi Configurator v oknu brskalnika Chrome. Naslovna vrstica prikazuje 'Not secure' in 'reduxi.local'; naslovna vrstica je označena s ciano okvirjem, njena povečana kopija (ciano okvir, besedilo 'Not secure reduxi.local') je prikazana levo in povezana s ciano črto. Ozadje strani: svetlosiva črtna risba hiše s sončnimi paneli (zelena), stenske polnilne enote, razsmernika, avtomobila in polnilnika. Zgoraj levo: logotip 'reduxi configurator'. Prijavno okno na sredini z naslovom 'Login', izbirnikom jezika (angleška zastava, 'English'), poljem za uporabniško ime in poljem za geslo ter temnim gumbom 'Login'.
Besedilni opis te slike
Posnetek zaslona spletnega vmesnika Reduxi Configurator po prijavi, svetla tema. Zgoraj levo: logotip 'reduxi configurator'. Glava: 'Home' levo, zelen status 'Connected' zgoraj desno. Leva stranska vrstica: razširjen razdelek 'Devices' s seznamom vnosov, nato strnjeni razdelki 'Manager', 'Configuration' in 'Settings'. Glavni del: diagram energijskega toka. Hiša v sredini z obročem, vrednost 24.20 kW. Ikona omrežja zgoraj levo, 24.20 kW (rdeča pika na črti). Ikona sonca zgoraj desno, vrednost '-'. Leva ikona (baterija ali naprava), 6.700 kW (zelena pika na črti). Desne ikone (hranilnik energije in naprava), vrednosti '-'. Ikona EV charger spodaj levo, 31.00 kW. Še ena ikona naprave spodaj desno. Oznaka 'Energy manager' pod hišo.
6 Dodajte sonnenBatterie v Reduxi
S temi koraki dodate novo napravo v Reduxi Controller.
6.1 Osnovne nastavitve
Prijavite se v Reduxi Configurator (glejte točko 5; glejte tudi Kako se prijaviti v Reduxi Configurator prek brskalnika) in kliknite + Add device.
Besedilni opis te slike
Posnetek zaslona levega menija v Reduxi Configurator pod logotipom reduxi Configurator. Menijske postavke: Devices (razširjeno, z znakom minus) z gumbom '+ Add device' (z obrobo); Strategies (znak plus); Utility Rate Plan; Settings (znak plus). Desna stran je prazna in bela.
V prvem koraku določite osnovne nastavitve:
- Device type:
Hybrid Inverter - Type:
Sonnen - Name: poljubno ime
Besedilni opis te slike
Posnetek zaslona obrazca Basic settings v Reduxi Configurator, odrezan na desnem robu. Polja: Device type (spustni meni, vrednost v drobnem besedilu); Type (spustni meni, vrednost je videti Sonnen, drobno besedilo); Name (besedilno polje, vrednost je videti sonnen, drobno besedilo). Spodaj razdelek Include in Strategy s tabelo: stolpci Strategy, Measurement Device, Regulated Device; dve vrstici, obe z oznako Energy manager, vsaka z majhnim kazalnikom v stolpcih Measurement Device in Regulated Device. Gumba: Back (spodaj levo, bel), Next (spodaj desno, črn). Slika je v nizki ločljivosti in večina besedila je majhna.
Kliknite Next.
6.2 Nastavitve komunikacije
| Parameter | Vrednost |
|---|---|
| Povezava | TCP/IP |
| IP | Naslov IP naprave sonnenBatterie |
| API token | API token iz točke 4, točka 4.3 |
| PV | Izberite tip razsmernika: AC‑coupled (baterija in razsmernik sta ločena) ali Hybrid (baterija in razsmernik sta združena v en sistem) |
Besedilni opis te slike
Posnetek zaslona obrazca Communication channel and device configuration v Reduxi Configurator. Slika je v nizki ločljivosti. Polja: Connection type (spustni meni); IP (besedilno polje, prazno) s črnim gumbom Scan for IP; Port: 80; Reconnect IP recovery (stikalo z oznako Yes, vklopljeno); API token (besedilno polje, prazno); drugo stikalo s kratkim naslovom in besedilom Yes/No; Number of AC system units: 1; What is type of inverter (spustni meni): AC coupled system. Gumbi: Back (spodaj levo), Test communication in Done (spodaj desno, Done je črn).
6.3 Preizkus komunikacije
Na dnu čarovnika kliknite Test communication. Test enkrat prebere podatke iz sonnenBatterie in ničesar ne shrani. Če je test uspešen, kliknite Done: napravo ustvari samo Done.
Besedilni opis te slike
Posnetek zaslona spodnje vrstice z gumbi na strani Reduxi Configurator. Levo: gumb 'Back'. Desno: gumb 'Test communication' (označen s ciano okvirjem) in temen gumb 'Done'.
Besedilni opis te slike
Posnetek zaslona strani 'Communication channel and device configuration' v Reduxi Configurator. Connection *: TCP/IP (spustni seznam). IP *: 192.168.50.243, z gumbom 'Scan for IP'. Port *: 502, z gumbom 'Test port'. Modbus unit ID *: 1. Gumbi spodaj: Back (levo), Test communication in Done (desno). Gumb Done je označen s ciano okvirjem.
Test vrne enega od dveh rezultatov:
Besedilni opis te slike
Posnetek zaslona pogovornega okna Test communication v Reduxi Configurator s ikono za zapiranje (x) zgoraj desno. Belo polje z rezultatom, zeleno besedilo: Successful readout from device. Vrednosti: 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 (temen, spodaj desno).
Besedilni opis te slike
Posnetek zaslona pogovornega okna z naslovom Test communication (križec za zapiranje zgoraj desno). Prvo polje: Unable to communicate with device. Drugo polje z rdečim besedilom: 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 (temen).
Če prejmete sporočilo “Unable to communicate with device”, preverite nastavitve (glejte točko 8).
7 Preverite meritve in nastavite strategije
7.1 Last measurements
Ko je komunikacija vzpostavljena, v Reduxi Configurator pod Devices – vaša naprava Sonnen – Last measurements preverite izmerjene vrednosti.
7.2 Reduxi Cloud
Kako dodati in povezati krmilnik z Reduxi Cloud: Reduxi Cloud
7.3 Strategije
Za nastavitev strategij in AI Energy Manager uporabite spodnjo dokumentacijo.
8 Kontrolni seznam
S tem kontrolnim seznamom preverite pravilno nastavitev in zanesljivo delovanje.
8.1 Na krmilniku Reduxi Controller
- Naslov IP: Za povezano napravo je vnesen pravilen naslov IP.
- API token: Vnesen je veljaven API token.
- Tip sistema: Izbran je pravilen tip sistema: AC‑coupled ali Hybrid.
- Test komunikacije: Test komunikacije je uspešno zaključen.
- Dosegljivost: Naslov IP naprave je dosegljiv iz krmilnika Reduxi Controller.
8.2 V spletnem vmesniku sonnenBatterie
- Dovoljenja API: Omogočena sta Read API in Write API.
- Način delovanja: Način delovanja je Manual.
8.3 Strategija
- Aktivna strategija: Izbrana strategija je nastavljena na Active.
- Energijska optimizacija AI: Optimizacija AI Energy Manager je v strategiji omogočena.
- Ena aktivna strategija: Naenkrat je aktivna samo ena strategija.
- Omejitve uvoza/izvoza: Omejitvi uvoza in izvoza sta določeni in nastavljeni.
✓ Povzetek
Priprava (točke 1–3): Pripravite lokalni naslov IP, geslo monterja in računalnik v istem omrežju. Odprite spletni vmesnik naprave sonnenBatterie.
sonnenBatterie (točka 4): Prijavite se kot Installer, omogočite Read API in Write API, kopirajte ali ustvarite API token in nastavite način delovanja na Manual.
Dodajanje v Reduxi (točki 5–6): Odprite Configurator in dodajte napravo tipa Sonnen. Vnesite naslov IP, API token in tip razsmernika (AC‑coupled ali Hybrid). Zaženite Test communication.
Zagon (točki 7–8): Preverite meritve, nastavite strategije in preglejte kontrolni seznam.
→ Pogoste težave
| Težava | Rešitev |
|---|---|
| Test komunikacije prikaže “Unable to communicate with device” | Sistem ni pravilno nastavljen. Preverite naslov IP, API token, tip sistema (AC‑coupled ali Hybrid) in ali je naslov IP dosegljiv iz krmilnika (glejte točko 8). |
| Prijava kot Installer ni mogoča | Geslo monterja končnim uporabnikom ni na voljo. Obrnite se na monterja, ki je sistem zagnal, ali na podporo Sonnen (glejte točko 4). |
| API token ni na voljo | V spletnem vmesniku sonnenBatterie odprite Software Integration in na dnu strani kliknite Create new. |
| Ukazi Reduxi na baterijo nimajo učinka | Preverite, ali je način delovanja nastavljen na Manual, ali sta omogočena Read API in Write API, ali je strategija Active in ali je aktivna samo ena strategija (glejte točko 8). |
| Open configurator se ne odpre ali ostane prazen | Tunel še ni aktiven. Počakajte približno 30 sekund in preverite, ali je krmilnik na spletu. |
Prijava z admin je zavrnjena |
Geslo je bilo spremenjeno med namestitvijo. Vprašajte monterja. Geslo računa Reduxi tu ne deluje. |
reduxi.local se ne naloži |
Vaša naprava ni v istem omrežju kot krmilnik. Uporabite naslov IP ali tunelsko povezavo. |
| Test komunikacije ne uspe, naprava je videti brez povezave | Preverite dosegljivost, naslov IP / vrata / unit ID in ali je protokol na napravi omogočen. |