sonnenBatterien (Gen. 8 tai uudempi, REST API -yhteys) liittäminen Reduxi-ohjaimeen
Liitä sonnenBatterie Gen. 8 tai uudempi Reduxi Controlleriin REST API:n kautta.
Kuvan tekstikuvaus
Valokuva sonnenBatteriesta, valmistajan kuva. Tummanharmaa betoniseinä hämärässä huoneessa. Seinällä vasemmalla roikkuu harmaa suorakulmainen moduuli, jonka etuosa on uurrettu tai rei'itetty ja joka on kuvatekstin mukaan hybridi-invertteri. Sen vieressä oikealla seisoo korkea vaaleanharmaa kaappi, jonka yläosassa on pyöreä vaaleansininen valaistu rengas. Laitteissa ei ole luettavaa tekstiä.
- Tekninen dokumentaatio
- Tarvittavat välineet
- Paikallinen yhteys sonnenBatterieen
- Laitteen määritys sonnenBatteriessa
- Kirjautuminen Reduxin verkkokäyttöliittymään
- Lisää sonnenBatterie Reduxiin
- Tarkista lukemat ja määritä strategiat
- Tarkistuslista
- Yhteenveto
- Yleisiä ongelmia
- Aiheeseen liittyvät artikkelit
1 Tekninen dokumentaatio
Valmistajan sivut sonnenBatterielle:
- sonnenBatterie 10 – Valmistajan tuotesivu
- Sonnenin käyttöoppaat – Valmistajan käyttöoppaat
Videoppaat:
2 Tarvittavat välineet
Valmistele seuraavat:
- Reduxi Controller (asennettu ja verkossa)
- sonnenBatterie Gen. 8 tai uudempi (REST API)
- sonnenBatterien paikallinen IP-osoite
- sonnenBatterien asentajan salasana (ks. kohta 4)
- Tietokone samassa paikallisessa verkossa kuin sonnenBatterie
- Kannettava tietokone tai tabletti internet-yhteydellä laitteen määrittämiseen Reduxissa
3 Paikallinen yhteys sonnenBatterieen
Varmista ennen aloittamista, että sinulla on sonnenBatterien paikallinen IP-osoite ja että tietokoneesi on liitetty samaan paikalliseen verkkoon.
sonnenBatterie saa IP-osoitteensa seuraavilta:
- reitittimeltä,
- verkkokytkimeltä
- tai paikalliselta DHCP-palvelimelta.
Löydät sonnenBatterien IP-osoitteen tai DNS-nimen palvelusta find-my.sonnen-batterie.com noudattamalla Sonnenin ohjetta.
Avaa verkkoselain ja syötä sonnenBatterien paikallinen IP-osoite avataksesi sen verkkokäyttöliittymän. Esimerkki: http://<IP>
4 Laitteen määritys sonnenBatteriessa
4.1 Asentajan kirjautuminen
Kun avaat IP-osoitteen selaimessa, näyttöön tulee kirjautumisruutu. Valitse kirjautumistyypiksi Installer ja syötä asentajan salasana.
Jos tarvitset pääsyn, ota yhteyttä järjestelmän käyttöön ottaneeseen asentajaan tai Sonnenin tukeen. Sonnenin tuki voi tarkistaa pyynnön, avata pääsyn tai tehdä tarvittavat muutokset puolestasi.
Kuvan tekstikuvaus
Kuvakaappaus sonnenBatterien verkkokäyttöliittymän kirjautumisruudusta, leveä ikkuna, tummassa yläpalkissa sonnen-logo. Keskitetty kirjautumisruutu otsikolla Dashboard. Teksti: Please choose a login. Avattava valikko, valittuna arvo Installer. Kentän nimiö Password, kenttä tyhjä. Vaaleansininen painike Login.
4.2 Dashboard
Onnistuneen kirjautumisen jälkeen näkyviin tulee Menu / Dashboard.
Kuvan tekstikuvaus
Kuvakaappaus sonnenBatterien verkkokäyttöliittymästä, sivu Dashboard, tummassa yläpalkissa sonnen-logo. Vasen valikko: Dashboard (korostettu vaaleansinisellä), System, Settings, Battery, Inverter, Powermeter, Powermeter Setup, IOs, Software-Installer, Commissioning Assistant, System-Status, Network, Software-Integration. Pääalueen otsikko: Dashboard. Energiavirtakaavio neljällä laatikolla: production 3145 W (keltainen, aurinkopaneelikuvake); consumption 1875 W (sininen, talokuvake); FeedIn 1273 W (harmaa, pylväskuvake); active power, tila idle, rSOC: 16% ja uSOC: 9% (vihreä, akkukuvake). Keltainen nuoli kulkee tuotannosta akkulaatikkoon, vihreä nuoli akkulaatikosta ylös kulutukseen.
4.3 Ota sonnenBatterien REST API käyttöön
Tee dashboardilla seuraavasti:
Kuvan tekstikuvaus
Kuvakaappaus sonnenBatterien verkkokäyttöliittymästä, sivu Software-Integration (tummassa yläpalkissa sonnen-logo; sarjanumero ja ohjelmistoversio näkyvät oikealla ylhäällä pienellä tekstillä). Vasen valikko: Dashboard, System, Settings, Battery, Inverter, Powermeter, Powermeter Setup, I/Os, Software-Installer, Commissioning Assistant, System-Status, Network, Software-Integration (korostettu punaisella laatikolla). Välilehdet: JSON API (valittuna), WebSocket API, Generated Docs (pieni teksti). Kaksi kytkintä, molemmat päällä (sininen) ja kumpikin merkitty punaisella laatikolla: Read API (alla teksti: allows to request the current status of the sonnenBatterie, measurements and configuration values) ja Write API (alla teksti: send requests to change or discharge the sonnenBatterie and set configuration values). Punainen laatikko merkitsee rivin API Token: tunnusarvo (ei näytetä tässä, peitetty) ja painike Create New. Alla esimerkki curl-komennosta, jossa Auth-Token-otsikko ja URL, joka päättyy /api/v2/latestdata. Otsikko Documentation ja linkki sonnenBatterien JSON API -dokumentaatioon.
4.4 Aseta toimintatila
Avaa vasemmalla puolella oleva Settings-valikko ja valitse toimintatilaksi Manual.
Kuvan tekstikuvaus
Kuvakaappaus sonnenBatterien verkkokäyttöliittymästä, Settings-sivu (oikealla ylhäällä Software: 1.15.6, loppu leikkautunut). Vasen valikko: Dashboard, System, Inverter, Settings (korostettu sinisellä), Network, Software-Integration. Pääalueen otsikko: Settings. Osio: Operating Mode. Avattava valikko on auki, valittuna merkintä Manual (korostettu harmaalla). Luetellut vaihtoehdot: Manual; Automatic - Self-Consumption; Battery-Module-Extension (30%); Time-Of-Use. Valikon alla näkyy kytkin nimiöllä Surplus fullcharge, pois päältä (harmaa).
5 Kirjautuminen Reduxin verkkokäyttöliittymään
Reduxin verkkokäyttöliittymän voi avata kahdella tavalla:
Kuvan tekstikuvaus
Kuvakaappaus kolmesta vierekkäisestä Reduxi-mobiilisovelluksen näytöstä, syaaninsinisillä laatikoilla ja numeromerkeillä 2–4. Vasen näyttö (dashboard, tumma teema): valikkokuvake vasemmassa yläkulmassa, merkitty laatikolla ja merkillä 2; 'reduxi'-logo; välilehdet 'Real time data' (aktiivinen) ja 'Statistics'; hinta 5.79 € ja lämpötila 3.2 °C; energiavirtakaavio, jossa talo keskellä (-1.25 kW) ja kuvakkeet arvoilla 69.0 W, 1.3 kW, 1.1 kW (punainen rengas), -165.0 W ja 97 % (punainen rengas) sekä alhaalla 0.0 W -arvot; välilehdet 'Power' ja 'Energy'; alanavigointi: Dashboard, Diagnostics, Device control, Settings. Keskimmäinen näyttö (sivuvalikko): 'reduxi'-logo, 'Number of locations: 1233', otsikko 'Reduxi device management', kohdat '+ Add Reduxi location' ja 'Reduxi devices' (merkitty laatikolla ja merkillä 3), sen jälkeen 'My profile' ja 'About app'. Oikea näyttö (laitesivu): Back; kuva mustasta Reduxi-ohjaimesta, jossa on kaksi Ethernet-porttia; tila 'Connected'; kortti 'Update available': 'New update is available for your Reduxi device.' ja painike 'Download and install update'; kortti 'Connect to configurator': 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' ja painike 'Activate tunnel connection' (merkitty laatikolla ja merkillä 4); kortti 'Unit details' ja kenttä 'Unit ID'.
Kuvan tekstikuvaus
Kuvakaappaus, joka koostuu kahdesta vierekkäisestä osasta. Vasen osa: Reduxi-mobiilisovelluksen näyttö tummalla taustalla. Ylhäällä: Back-painike; kuva mustasta Reduxi-ohjaimesta, jossa on kaksi Ethernet-porttia ja riviliitin; tila 'Connected' ja Wi-Fi-kuvake. Kortti 'Update available': 'New update is available for your Reduxi device.' ja painike 'Download and install update'. Kortti 'Connect to configurator' avainkuvakkeella: 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' ja painike 'Open configurator', merkitty syaaninsinisellä laatikolla ja numeromerkillä 5. Alla: kortti 'Unit details' ja kenttä 'Unit ID' (arvo ei näy). Oikea osa: Reduxi Configurator avattuna selaimessa, merkitty syaaninsinisellä kehyksellä ja numeromerkillä 6. Yläpalkki: takaisin-nuoli, 'Tunnel connection', päivityskuvake. Vasemmalla sivupalkki kuvakkeineen (salama, piiri, salamanuoli, pylväskaavio, ratas). Sivu 'Home' vihreällä linkkikuvakkeella. Vihreä ilmoitus: 'New patch available. Click here to apply.' ja sulkemis-X. Kellonaika 09:12:56. Energiavirtakaavio, jossa talo keskellä (1.700 kW) ja kuvakkeet sähköverkolle (0.000 kW), auringolle (1.700 kW), akulle (vihreä, 0.000 kW ja 0.800 kW), laitteelle vasemmalla (0.900 kW), sähköautolle sekä latauslaitteelle tai laitteelle alhaalla. Alareunassa merkintä 'Energy manager'.
http://reduxi.local. Ohjaimen IP-osoite löytyy reitittimen laiteluettelosta tai Reduxi-sovelluksesta kohdasta Reduxi devices.admin · Salasana: admin (tehdasasetus)Kuvan tekstikuvaus
Kuvakaappaus Reduxi Configuratorin kirjautumissivusta Chrome-selainikkunassa. Osoiterivillä lukee 'Not secure' ja 'reduxi.local'; osoiterivi on merkitty syaaninsinisellä laatikolla, ja siitä on suurennettu kopio (syaaninsininen laatikko, teksti 'Not secure reduxi.local') vasemmalla, yhdistettynä syaaninsinisellä viivalla. Sivun tausta: vaaleanharmaa viivapiirros talosta, jossa on aurinkopaneeleja (vihreä), seinälatauslaite, invertteri, auto ja latauspiste. Vasemmassa yläkulmassa 'reduxi configurator' -logo. Keskellä kirjautumisruutu, jonka otsikko on 'Login', kielenvalitsin (englannin lippu, 'English'), käyttäjänimikenttä ja salasanakenttä sekä tumma 'Login'-painike.
Kuvan tekstikuvaus
Kuvakaappaus Reduxi Configuratorin verkkokäyttöliittymästä kirjautumisen jälkeen, vaalea teema. Vasemmassa yläkulmassa 'reduxi configurator' -logo. Otsikkopalkki: 'Home' vasemmalla, vihreä 'Connected'-tila oikeassa yläkulmassa. Vasen sivupalkki: laajennettu osio 'Devices' ja luettelo kohdista, sitten suljetut osiot 'Manager', 'Configuration' ja 'Settings'. Pääalue: energiavirtakaavio. Talo keskellä renkaan kanssa, arvo 24.20 kW. Grid-kuvake vasemmalla ylhäällä, 24.20 kW (punainen piste sen linjalla). Solar-kuvake oikealla ylhäällä, arvo '-'. Vasemmanpuoleinen kuvake (akku tai laite), 6.700 kW (vihreä piste sen linjalla). Oikeanpuoleiset kuvakkeet (akusto ja laite), arvot '-'. EV charger -kuvake vasemmalla alhaalla, 31.00 kW. Toinen laitekuvake oikealla alhaalla. Merkintä 'Energy manager' talon alla.
6 Lisää sonnenBatterie Reduxiin
Näillä vaiheilla lisäät uuden laitteen Reduxi Controlleriin.
6.1 Perusasetukset
Kirjaudu Reduxi Configuratoriin (ks. kohta 5; ks. myös How to log in to Reduxi Configurator via browser) ja napsauta + Add device.
Kuvan tekstikuvaus
Kuvakaappaus Reduxi Configuratorin vasemmasta valikosta reduxi Configurator -logon alla. Valikon kohdat: Devices (laajennettuna, miinusmerkki), jonka sisällä painike '+ Add device' (ääriviiva); Strategies (plusmerkki); Utility Rate Plan; Settings (plusmerkki). Oikea puoli on tyhjä valkoinen.
Määritä ensimmäisessä vaiheessa perusasetukset:
- Device type:
Hybrid Inverter - Type:
Sonnen - Name: valitsemasi nimi
Kuvan tekstikuvaus
Kuvakaappaus Reduxi Configuratorin lomakkeesta otsikolla Basic settings. Kentät: Device type (avattava valikko, arvo pienellä tekstillä); Type (avattava valikko, arvo vaikuttaa olevan Sonnen, pieni teksti); Name (tekstikenttä, arvo vaikuttaa olevan sonnen, pieni teksti). Alla osio Include in Strategy ja taulukko: sarakkeet Strategy, Measurement Device, Regulated Device; kaksi riviä, molemmat nimeltä Energy manager, kummassakin pieni ilmaisin sarakkeissa Measurement Device ja Regulated Device. Painikkeet: Back (vasemmassa alakulmassa, valkoinen), Next (oikeassa alakulmassa, musta). Kuvan resoluutio on matala ja suurin osa tekstistä on pientä.
Napsauta Next.
6.2 Tiedonsiirtoasetukset
| Parametri | Arvo |
|---|---|
| Yhteys | TCP/IP |
| IP | sonnenBatterien IP-osoite |
| API-tunnus | API-tunnus kohdasta kohta 4, kohta 4.3 |
| PV | Valitse invertterin tyyppi: AC‑coupled (akku ja invertteri ovat erillisiä) tai Hybrid (akku ja invertteri on integroitu yhdeksi järjestelmäksi) |
Kuvan tekstikuvaus
Kuvakaappaus Reduxi Configuratorin lomakkeesta otsikolla Communication channel and device configuration. Kuvan resoluutio on matala. Kentät: Connection type (avattava valikko); IP (tekstikenttä, tyhjä) ja musta painike Scan for IP; Port: 80; Reconnect IP recovery (kytkin, nimiö Yes, päällä); API token (tekstikenttä, tyhjä); toinen kytkin, jonka nimenä lyhyt otsikko ja teksti Yes/No; Number of AC system units: 1; What is type of inverter (avattava valikko): AC coupled system. Painikkeet: Back (vasemmassa alakulmassa), Test communication ja Done (oikeassa alakulmassa, Done on musta).
6.3 Tiedonsiirron testaus
Napsauta ohjatun toiminnon alareunassa Test communication. Se lukee sonnenBatterien kerran eikä tallenna mitään. Jos testi onnistuu, napsauta Done: vain Done luo laitteen.
Kuvan tekstikuvaus
Kuvakaappaus Reduxi Configuratorin sivun alareunan painikepalkista. Vasemmalla: painike 'Back'. Oikealla: painike 'Test communication' (merkitty syaaninsinisellä laatikolla) ja tumma painike 'Done'.
Kuvan tekstikuvaus
Kuvakaappaus Reduxi Configuratorin sivusta 'Communication channel and device configuration'. Connection *: TCP/IP (avattava valikko). IP *: 192.168.50.243, painikkeella 'Scan for IP'. Port *: 502, painikkeella 'Test port'. Modbus unit ID *: 1. Painikkeet alareunassa: Back (vasemmalla), Test communication ja Done (oikealla). Done-painike on merkitty syaaninsinisellä laatikolla.
Testi antaa jommankumman seuraavista tuloksista:
Kuvan tekstikuvaus
Kuvakaappaus Reduxi Configuratorin Test communication -ikkunasta, oikeassa yläkulmassa sulkemiskuvake (x). Valkoinen tulosruutu, vihreä teksti: Successful readout from device. Arvot: 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. Painike: Close (tumma, oikeassa alakulmassa).
Kuvan tekstikuvaus
Kuvakaappaus ikkunasta otsikolla Test communication (sulkemis-X oikeassa yläkulmassa). Ensimmäinen ruutu: Unable to communicate with device. Toinen ruutu, punainen teksti: 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. Painike: Close (tumma).
Jos saat ilmoituksen “Unable to communicate with device”, tarkista asetukset (ks. kohta 8).
7 Tarkista lukemat ja määritä strategiat
7.1 Last measurements
Kun yhteys on muodostettu, tarkista mitatut arvot Reduxi Configuratorissa kohdassa Devices – your Sonnen device – Last measurements.
7.2 Reduxi Cloud
Ohjaimen lisääminen ja liittäminen Reduxi Cloudiin: Reduxi Cloud
7.3 Strategiat
Strategioiden ja AI Energy Managerin määrittämiseen on alla olevat ohjeet.
8 Tarkistuslista
Käy tämä tarkistuslista läpi, jotta määritys on oikea ja toiminta luotettavaa.
8.1 Reduxi Controllerissa
- IP-osoite: Liitetylle laitteelle on syötetty oikea IP-osoite.
- API-tunnus: Voimassa oleva API-tunnus on syötetty.
- Järjestelmätyyppi: Oikea järjestelmätyyppi on valittu: AC‑coupled tai Hybrid.
- Viestintätesti: Viestintätesti on suoritettu onnistuneesti.
- Tavoitettavuus: Laitteen IP-osoite on tavoitettavissa Reduxi Controllerista.
8.2 sonnenBatterien verkkokäyttöliittymässä
- API-oikeudet: Sekä Read API että Write API on otettu käyttöön.
- Toimintatila: Toimintatilana on Manual.
8.3 Strategia
- Aktiivinen strategia: Valittu strategia on asetettu tilaan Active.
- AI-energiaoptimointi: AI Energy Manager -optimointi on otettu käyttöön strategiassa.
- Yksi aktiivinen strategia: Vain yksi strategia on aktiivinen kerrallaan.
- Oton ja syötön rajat: Oton ja syötön rajat on määritetty.
✓ Yhteenveto
Valmistelu (kohdat 1–3): Valmistele paikallinen IP-osoite, asentajan salasana ja tietokone samassa verkossa. Avaa sonnenBatterien verkkokäyttöliittymä.
sonnenBatterie (kohta 4): Kirjaudu sisään asentajana, ota käyttöön Read API ja Write API, kopioi tai luo API-tunnus ja aseta toimintatilaksi Manual.
Lisääminen Reduxiin (kohdat 5–6): Avaa Configurator ja lisää laite tyypillä Sonnen. Syötä IP-osoite, API-tunnus ja invertterin tyyppi (AC‑coupled tai Hybrid). Suorita Test communication.
Käyttöönotto (kohdat 7–8): Tarkista lukemat, määritä strategiat ja käy tarkistuslista läpi.
→ Yleisiä ongelmia
| Ongelma | Ratkaisu |
|---|---|
| Test communication näyttää viestin “Unable to communicate with device” | Järjestelmää ei ole määritetty oikein. Tarkista IP-osoite, API-tunnus, järjestelmätyyppi (AC‑coupled tai Hybrid) ja että IP-osoite on tavoitettavissa ohjaimesta (ks. kohta 8). |
| Asentajan kirjautuminen ei onnistu | Asentajan salasana ei ole loppukäyttäjien saatavilla. Ota yhteyttä järjestelmän käyttöön ottaneeseen asentajaan tai Sonnenin tukeen (ks. kohta 4). |
| API-tunnusta ei ole saatavilla | Avaa sonnenBatterien verkkokäyttöliittymässä Software Integration ja napsauta sivun alareunassa Create new. |
| Reduxin komennoilla ei ole vaikutusta akkuun | Tarkista, että toimintatila on Manual, että Read API ja Write API on otettu käyttöön, että strategia on Active ja että vain yksi strategia on aktiivinen (ks. kohta 8). |
| Open configurator ei avaudu tai pysyy tyhjänä | Tunneli ei ole vielä aktiivinen. Odota noin 30 sekuntia ja tarkista, että ohjain on verkossa. |
Kirjautuminen tunnuksella admin hylätään |
Salasana on vaihdettu asennuksen aikana. Kysy sitä asentajalta. Reduxi-tilin salasana ei toimi tässä. |
reduxi.local ei lataudu |
Laitteesi ei ole samassa verkossa kuin ohjain. Käytä IP-osoitetta tai tunneliyhteyttä. |
| Tiedonsiirtotesti epäonnistuu, laite näkyy offline-tilassa | Tarkista tavoitettavuus, IP-osoite / portti / unit ID ja että protokolla on otettu käyttöön laitteessa. |