sonnenBatterien liittäminen Reduxi-ohjaimeen
Liitä sonnenBatterie Reduxi Controlleriin ja anna Reduxi-strategioiden ladata ja purkaa sitä parhaisiin hintoihin. Tämä opas käsittelee JSON API -yhteyttä ja kertoo, milloin Gen. 8:n tai uudemman REST API -opas on käyttökelpoinen.
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ä.
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 ja JSON API kohdassa Software Integration
- sonnenBatterien paikallinen IP-osoite
- Tietokone samassa paikallisessa verkossa kuin sonnenBatterie
- Kannettava tietokone tai tabletti internet-yhteydellä laitteen määrittämiseen Reduxissa
3 Paikallinen yhteys sonnenBatterieen
Liitä sonnenBatterie paikalliseen verkkoon LAN-yhteydellä. Reduxi Controllerin on oltava samassa verkossa.
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
Kirjaudu sonnenBatterien verkkokäyttöliittymään (katso kohta 3). Tarvitset API-tunnuksen ja IP-osoitteen Reduxi Controlleria varten (katso kohta 6).
4.1 Software Integrationin avaaminen
Kuvan tekstikuvaus
Kuvakaappaus sonnenBatterien verkkokäyttöliittymästä selaimessa, sivu Software-Integration, välilehti JSON API. Osoitepalkissa näkyy paikallinen IP-osoite ja sen perässä polku dash/software-integration/json-api; IP-osoite on merkitty punaisella laatikolla ja nuolella, jonka teksti on SonnenBatterie IP. Vasen valikko: Dashboard, System, Inverter, Settings, Network ja Software-Integration (korostettu). Välilehdet: JSON API (aktiivinen), Webhook API ja sonnenKNX Module. Kaksi kytkintä on päällä: Read API (Allows to request the current status of the sonnenBatterie, measurements and configuration values) ja Write API (Send requests to charge/discharge the sonnenBatterie and set configuration values). Niiden alla on kenttä API Token ja tunnusarvo, merkitty punaisella laatikolla ja tekstillä API Token, sekä Create New -painike. Esimerkkirivillä toistuvat tunnus ja IP-osoite samoilla merkinnöillä. Alareunassa on linkki sonnenBatterie JSON API v2 documentation.
4.2 Read API:n ja Write API:n käyttöönotto
Kytke päälle Read API ja Write API. Molemmat tarvitaan: Reduxi lukee mittaukset Read API:lla ja lähettää lataus- ja purkukomennot Write API:lla.
Kuvan tekstikuvaus
Rajattu kuvakaappaus JSON API -välilehdestä, jossa on välilehdet JSON API, Webhook API ja sonnenKNX Module. Read API -kytkin on päällä. Sen alla vaaleansininen ilmoitus kertoo This functionality is disabled while VPP is active, ja sen jälkeen on harmaa Write API -kytkin pois päältä -asennossa tekstillä Send requests to charge/discharge the sonnenBatterie and set configuration values. Sininen suorakulmio korostaa ilmoitusta ja Write API -kytkintä.
4.3 Käyttötilan asettaminen
Avaa vasemmalla puolella oleva Settings-valikko ja aseta käyttötilaksi Manual. Vasta silloin Reduxi Controller voi ottaa akun ohjauksen haltuunsa.
Kuvan tekstikuvaus
Kuvakaappaus sonnenBatterien Settings-sivusta (ohjelmisto 1.15.6). Vasen valikko: Dashboard, System, Inverter, Settings (korostettu), Network ja Software-Integration. Kortissa Operating Mode on avattava luettelo, jossa näkyy Manual; avattu luettelo tarjoaa vaihtoehdot Manual, Automatic - Self-Consumption, Battery-Module-Extension (30%) ja Time-Of-Use. Kortin alla näkyy kytkin Surplus fullcharge.
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 sonnenBatterien uutena laitteena Reduxi Controlleriin.
6.1 Perusasetukset
Kirjaudu Reduxi Configuratoriin (katso kohta 5; katso 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:
- Laitetyyppi: 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
Anna yhteysparametrit Reduxi Controllerin ja sonnenBatterien välille. Käytä kohdan 4 IP-osoitetta ja API-tunnusta.
| Parametri | Arvo |
|---|---|
| Yhteys | TCP/IP |
| IP | sonnenBatterien IP-osoite |
| Portti | 80 |
| API-tunnus | JSON API -välilehden API-tunnus (kohta 4, kohta 4.1) |
| Nimellisteho | Valitse sonnenBatteriesi mukainen nimellisteho |
| PV | Valitse Yes, jos PV-mittari on asennettu, muuten No |
Kuvan tekstikuvaus
Kuvakaappaus Reduxi Configuratorin lomakkeesta Communication channel and device configuration. Kentät ylhäältä alas: Connection (TCP/IP), IP (tyhjä, vaaleansininen nuoli osoittaa kenttää), Port (80), API token (tyhjä, vaaleansininen nuoli; vihje: API token is located in inverter web interface in section Software-Integration / JSON API), Rated power (14.4 kW) ja PV (Yes; vihje: Is PV meter installed?). Painikkeet alareunassa: Back, Test communication ja Next.
6.3 Tiedonsiirron testaus
Napsauta ohjatun toiminnon alareunassa Test communication. Testi lukee sonnenBatterien kerran eikä tallenna mitään. Jos testi onnistuu, napsauta Next.
Testi antaa jommankumman seuraavista tuloksista:
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 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).
6.4 Lisäasetukset
Lisäasetukset ovat valinnaisia, ja ne riippuvat kohteen tarpeista. Kun olet valmis, napsauta Done: vasta Done luo laitteen.
Kuvan tekstikuvaus
Kuvakaappaus Reduxi Configuratorin ohjatun toiminnon vaiheesta 3/3 Advanced settings; edistymispalkissa näkyvät Basic settings, Communication channel ja Advanced settings. Yes/No-kytkimet, kaikki asennossa 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). Kolme avattavaa luetteloa L1, L2 ja L3 is connected to main feed on asetettu arvoihin L1, L2 ja L3. Painikkeet: Back vasemmalla ja Done oikealla.
7 Tarkista lukemat ja määritä strategiat
7.1 Last measurements
Kun yhteys on muodostettu, tarkista mitatut arvot kohdasta Devices – Sonnen-laitteesi – Last measurements Reduxi Configuratorissa.
7.2 Control type
Avaa Devices – Sonnen-laitteesi Reduxi Configuratorissa ja aseta control type arvoon AUTO. Strategian komennot vaikuttavat sen jälkeen akkuun.
7.3 Reduxi Cloud
Ohjaimen lisääminen ja liittäminen Reduxi Cloudiin: Reduxi Cloud
Kun laite on lisätty, voit seurata ja ohjata sitä myös Reduxi-sovelluksessa.
7.4 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 ja portti: sonnenBatterien IP-osoite ja portti
80on annettu. - API-tunnus: Voimassa oleva API-tunnus on syötetty.
- Nimellisteho ja PV: nimellisteho ja PV-valinta vastaavat järjestelmää.
- Viestintätesti: Viestintätesti on suoritettu onnistuneesti.
- Control type: laitteen control type on AUTO.
- 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.
- VPP: akku on irrotettu VPP:stä.
- 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 ja tietokone samassa verkossa. Avaa sonnenBatterien verkkokäyttöliittymä.
sonnenBatterie (kohta 4): Avaa Software-Integration, JSON API -välilehti. Ota käyttöön Read API ja Write API (irrota akku ensin VPP:stä), kopioi tai luo API-tunnus ja aseta käyttötilaksi Manual.
Lisääminen Reduxiin (kohdat 5–6): Avaa Configurator ja lisää laite tyypillä Sonnen. Anna IP-osoite, portti 80, API-tunnus, nimellisteho ja PV. Suorita Test communication ja napsauta sitten Done.
Käyttöönotto (kohdat 7–8): Tarkista lukemat, aseta control type arvoon AUTO, määritä strategiat ja käy tarkistuslista läpi.
→ Yleisiä ongelmia
| Ongelma | Ratkaisu |
|---|---|
| Test communication näyttää viestin “Unable to communicate with device” | Tarkista IP-osoite, portti 80, API-tunnus ja että IP-osoite on tavoitettavissa ohjaimesta (katso kohta 8). |
| Write API:ta ei voi kytkeä päälle | Näkyviin tulee ilmoitus “This functionality is disabled while VPP is active”. Irrota akku VPP:stä ja ota sitten Write API käyttöön (katso kohta 4.2). |
| API-tunnusta ei ole saatavilla | Avaa sonnenBatterien verkkokäyttöliittymässä Software-Integration, JSON API -välilehti, ja napsauta Create New. |
| Reduxin komennoilla ei ole vaikutusta akkuun | Tarkista, että käyttötila on Manual, että Read API ja Write API on otettu käyttöön, että control type on AUTO, että strategia on Active ja että vain yksi strategia on aktiivinen (katso 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 ja portti sekä että API on otettu käyttöön laitteessa. |