Jak połączyć sonnenBatterie (Gen. 8 lub nowsza, połączenie REST API) ze sterownikiem Reduxi
Połączenie sonnenBatterie Gen. 8 lub nowszej ze sterownikiem Reduxi przez REST API.
Opis tekstowy tego obrazu
Zdjęcie sonnenBatterie, zdjęcie producenta. Ciemnoszara betonowa ściana w przyciemnionym pomieszczeniu. Na ścianie po lewej wisi szary prostokątny moduł z żebrowanym lub perforowanym przodem — według podpisu jest to falownik hybrydowy. Obok, po prawej, stoi wysoka jasnoszara szafa z okrągłym jasnoniebieskim podświetlanym pierścieniem w górnej części. Na urządzeniach nie ma czytelnego tekstu.
- Dokumentacja techniczna
- Wymagane wyposażenie
- Lokalny dostęp do sonnenBatterie
- Konfiguracja urządzenia w sonnenBatterie
- Logowanie do interfejsu internetowego Reduxi
- Dodawanie sonnenBatterie do Reduxi
- Sprawdzenie odczytów i konfiguracja strategii
- Lista kontrolna
- Podsumowanie
- Typowe problemy
- Powiązane artykuły
1 Dokumentacja techniczna
Strony producenta dotyczące sonnenBatterie:
- sonnenBatterie 10 – strona produktu producenta
- Instrukcje obsługi Sonnen – instrukcje obsługi producenta
Filmy instruktażowe:
2 Wymagane wyposażenie
Należy przygotować:
- Sterownik Reduxi Controller (zainstalowany i online)
- sonnenBatterie Gen. 8 lub nowszą (REST API)
- Lokalny adres IP sonnenBatterie
- Hasło instalatora sonnenBatterie (zob. Punkt 4)
- Komputer w tej samej sieci lokalnej co sonnenBatterie
- Laptop lub tablet z dostępem do internetu do konfiguracji urządzenia w Reduxi
3 Lokalny dostęp do sonnenBatterie
Przed rozpoczęciem należy upewnić się, że znany jest lokalny adres IP sonnenBatterie oraz że komputer jest połączony z tą samą siecią lokalną.
sonnenBatterie otrzymuje adres IP z:
- routera,
- przełącznika sieciowego (switcha),
- lub lokalnego serwera DHCP.
Aby znaleźć adres IP lub nazwę DNS sonnenBatterie, należy użyć find-my.sonnen-batterie.com i postępować zgodnie z instrukcją Sonnen.
Aby otworzyć interfejs WWW sonnenBatterie, należy otworzyć przeglądarkę i wpisać jej lokalny adres IP. Przykład: http://<IP>
4 Konfiguracja urządzenia w sonnenBatterie
4.1 Logowanie instalatora
Po otwarciu adresu IP w przeglądarce pojawia się ekran logowania. Jako typ logowania należy wybrać Installer i wpisać hasło instalatora.
Jeśli potrzebny jest dostęp, należy skontaktować się z instalatorem, który uruchomił system, lub z wsparciem Sonnen. Wsparcie Sonnen może zweryfikować prośbę, odblokować dostęp lub wprowadzić wymagane zmiany w imieniu użytkownika.
Opis tekstowy tego obrazu
Zrzut ekranu ekranu logowania interfejsu WWW sonnenBatterie, szerokie okno z logo sonnen w ciemnym górnym pasku. Wyśrodkowane pole logowania z nagłówkiem Dashboard. Tekst: Please choose a login. Lista rozwijana z wybraną wartością Installer. Etykieta pola Password, pole puste. Jasnoniebieski przycisk Login.
4.2 Dashboard
Po pomyślnym zalogowaniu wyświetla się Menu / Dashboard.
Opis tekstowy tego obrazu
Zrzut ekranu interfejsu WWW sonnenBatterie, strona Dashboard, z logo sonnen w ciemnym górnym pasku. Menu po lewej: Dashboard (podświetlone jasnoniebieskim), System, Settings, Battery, Inverter, Powermeter, Powermeter Setup, IOs, Software-Installer, Commissioning Assistant, System-Status, Network, Software-Integration. Nagłówek obszaru głównego: Dashboard. Diagram przepływu energii z czterema polami: production 3145 W (żółte, ikona panelu słonecznego); consumption 1875 W (niebieskie, ikona domu); FeedIn 1273 W (szare, ikona słupa); active power ze stanem idle, rSOC: 16% i uSOC: 9% (zielone, ikona baterii). Żółta strzałka biegnie od production do pola baterii, zielona strzałka biegnie od pola baterii w górę do consumption.
4.3 Włączanie REST API sonnenBatterie
Na dashboardzie należy wykonać następujące czynności:
Opis tekstowy tego obrazu
Zrzut ekranu interfejsu WWW sonnenBatterie, strona Software-Integration (logo sonnen w ciemnym górnym pasku; numer seryjny i wersja oprogramowania małym drukiem w prawym górnym rogu). Menu po lewej: Dashboard, System, Settings, Battery, Inverter, Powermeter, Powermeter Setup, I/Os, Software-Installer, Commissioning Assistant, System-Status, Network, Software-Integration (zaznaczone czerwoną ramką). Karty: JSON API (wybrana), WebSocket API, Generated Docs (mały tekst). Dwa przełączniki, oba włączone (niebieskie) i każdy zaznaczony czerwoną ramką: Read API (tekst poniżej: allows to request the current status of the sonnenBatterie, measurements and configuration values) i Write API (tekst poniżej: send requests to change or discharge the sonnenBatterie and set configuration values). Czerwona ramka zaznacza wiersz API Token: wartość tokenu (niepokazana, zaczerniona) i przycisk Create New. Poniżej: przykładowe polecenie curl z nagłówkiem Auth-Token i adresem URL kończącym się na /api/v2/latestdata. Nagłówek Documentation z linkiem do dokumentacji JSON API sonnenBatterie.
4.4 Ustawianie trybu pracy
Należy otworzyć menu Settings po lewej stronie i wybrać tryb pracy Manual.
Opis tekstowy tego obrazu
Zrzut ekranu interfejsu WWW sonnenBatterie, strona Settings (w prawym górnym rogu Software: 1.15.6, reszta ucięta). Menu po lewej: Dashboard, System, Inverter, Settings (podświetlone na niebiesko), Network, Software-Integration. Nagłówek obszaru głównego: Settings. Sekcja: Operating Mode. Lista rozwijana jest otwarta z wybraną pozycją Manual (podświetlona na szaro). Dostępne opcje: Manual; Automatic - Self-Consumption; Battery-Module-Extension (30%); Time-Of-Use. Pod listą widoczny przełącznik Surplus fullcharge, wyłączony (szary).
5 Logowanie do interfejsu internetowego Reduxi
Interfejs internetowy Reduxi można otworzyć na dwa sposoby:
Opis tekstowy tego obrazu
Zrzut ekranu trzech ekranów aplikacji mobilnej Reduxi obok siebie, z cyjanowymi ramkami i plakietkami z numerami od 2 do 4. Lewy ekran (dashboard, ciemny motyw): ikona menu w lewym górnym rogu zaznaczona ramką i plakietką 2; logo 'reduxi'; karty 'Real time data' (aktywna) i 'Statistics'; cena 5.79 € i temperatura 3.2 °C; schemat przepływu energii z domem pośrodku (-1.25 kW) i ikonami z wartościami 69.0 W, 1.3 kW, 1.1 kW (czerwony pierścień), -165.0 W przy 97 % (czerwony pierścień) oraz wartościami 0.0 W na dole; karty 'Power' i 'Energy'; dolna nawigacja: Dashboard, Diagnostics, Device control, Settings. Środkowy ekran (menu boczne): logo 'reduxi', 'Number of locations: 1233', nagłówek 'Reduxi device management', pozycje '+ Add Reduxi location' i 'Reduxi devices' (zaznaczona ramką i plakietką 3), następnie 'My profile' i 'About app'. Prawy ekran (strona urządzenia): Back; zdjęcie czarnego sterownika Reduxi z dwoma portami Ethernet; status 'Connected'; karta 'Update available': 'New update is available for your Reduxi device.' z przyciskiem 'Download and install update'; karta 'Connect to configurator': 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' z przyciskiem 'Activate tunnel connection' (zaznaczony ramką i plakietką 4); karta 'Unit details' z polem 'Unit ID'.
Opis tekstowy tego obrazu
Zrzut ekranu złożony z dwóch części obok siebie. Lewa część: ekran aplikacji mobilnej Reduxi na ciemnym tle. U góry: przycisk Back; zdjęcie czarnego sterownika Reduxi z dwoma portami Ethernet i listwą zaciskową; status 'Connected' z ikoną Wi-Fi. Karta 'Update available': 'New update is available for your Reduxi device.' z przyciskiem 'Download and install update'. Karta 'Connect to configurator' z ikoną klucza: 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' i przycisk 'Open configurator', zaznaczony cyjanową ramką i plakietką 5. Niżej: karta 'Unit details' z polem 'Unit ID' (wartość niewidoczna). Prawa część: Reduxi Configurator otwarty w przeglądarce, zaznaczony cyjanową ramką i plakietką 6. Nagłówek: strzałka wstecz, 'Tunnel connection', ikona odświeżania. Lewy pasek boczny z ikonami (błyskawica, układ scalony, piorun, wykres słupkowy, koło zębate). Strona 'Home' z zieloną ikoną połączenia. Zielony komunikat: 'New patch available. Click here to apply.' z krzyżykiem zamykania. Godzina 09:12:56. Schemat przepływu energii z domem pośrodku (1.700 kW) i ikonami sieci (0.000 kW), słońca (1.700 kW), baterii (zielona, 0.000 kW i 0.800 kW), urządzenia po lewej (0.900 kW), pojazdu elektrycznego oraz ładowarki lub urządzenia na dole. Etykieta 'Energy manager' na dole.
http://reduxi.local. Adres IP sterownika można znaleźć na liście urządzeń routera lub w aplikacji Reduxi w sekcji Reduxi devices.admin · Hasło: admin (ustawienie fabryczne)Opis tekstowy tego obrazu
Zrzut ekranu strony logowania Reduxi Configurator w oknie przeglądarki Chrome. Pasek adresu pokazuje 'Not secure' i 'reduxi.local'; pasek adresu jest zaznaczony cyjanową ramką, a jego powiększona kopia (cyjanowa ramka, tekst 'Not secure reduxi.local') widoczna jest po lewej, połączona cyjanową linią. Tło strony: jasnoszary rysunek liniowy domu z panelami słonecznymi (zielonymi), wallboxem, falownikiem, samochodem i ładowarką. U góry po lewej: logo 'reduxi configurator'. Pośrodku okno logowania z tytułem 'Login', wyborem języka (flaga angielska, 'English'), polem nazwy użytkownika i polem hasła oraz ciemnym przyciskiem 'Login'.
Opis tekstowy tego obrazu
Zrzut ekranu interfejsu internetowego Reduxi Configurator po zalogowaniu, jasny motyw. W lewym górnym rogu logo 'reduxi configurator'. Pasek nagłówka: 'Home' po lewej, zielony status 'Connected' w prawym górnym rogu. Pasek boczny po lewej: rozwinięta sekcja 'Devices' z listą pozycji, następnie zwinięte sekcje 'Manager', 'Configuration' i 'Settings'. Główny obszar: schemat przepływu energii. Dom pośrodku z pierścieniem, wartość 24.20 kW. Ikona sieci w lewym górnym rogu, 24.20 kW (czerwona kropka na jej linii). Ikona słońca w prawym górnym rogu, wartość '-'. Lewa ikona (bateria lub urządzenie), 6.700 kW (zielona kropka na jej linii). Prawe ikony (magazyn energii i urządzenie), wartości '-'. Ikona ładowarki EV w lewym dolnym rogu, 31.00 kW. Kolejna ikona urządzenia w prawym dolnym rogu. Etykieta 'Energy manager' pod domem.
6 Dodawanie sonnenBatterie do Reduxi
Poniższe kroki służą do dodania nowego urządzenia do Reduxi Controller.
6.1 Ustawienia podstawowe
Należy zalogować się do Reduxi Configurator (zob. Punkt 5; zob. też Jak zalogować się do Reduxi Configurator przez przeglądarkę) i kliknąć + Add device.
Opis tekstowy tego obrazu
Zrzut ekranu lewego menu Reduxi Configurator pod logo reduxi Configurator. Pozycje menu: Devices (rozwinięte, ze znakiem minus) zawierające przycisk '+ Add device' (z obrysem); Strategies (znak plus); Utility Rate Plan; Settings (znak plus). Prawa strona jest pusta, biała.
W pierwszym kroku należy zdefiniować ustawienia podstawowe:
- Device type:
Hybrid Inverter - Type:
Sonnen - Name: dowolna nazwa
Opis tekstowy tego obrazu
Zrzut ekranu formularza Basic settings w Reduxi Configurator. Pola: Device type (lista rozwijana, wartość małym drukiem); Type (lista rozwijana, wartość wygląda na Sonnen, mały druk); Name (pole tekstowe, wartość wygląda na sonnen, mały druk). Poniżej sekcja Include in Strategy z tabelą: kolumny Strategy, Measurement Device, Regulated Device; dwa wiersze, oba opisane Energy manager, każdy z małym wskaźnikiem w kolumnach Measurement Device i Regulated Device. Przyciski: Back (lewy dolny róg, biały), Next (prawy dolny róg, czarny). Obraz ma niską rozdzielczość, a większość tekstu jest mała.
Należy kliknąć Next.
6.2 Ustawienia komunikacji
| Parametr | Wartość |
|---|---|
| Połączenie | TCP/IP |
| IP | Adres IP sonnenBatterie |
| Token API | Token API z Punktu 4, punkt 4.3 |
| PV | Należy wybrać typ falownika: AC‑coupled (bateria i falownik są oddzielne) lub Hybrid (bateria i falownik są zintegrowane w jednym systemie) |
Opis tekstowy tego obrazu
Zrzut ekranu formularza Communication channel and device configuration w Reduxi Configurator. Obraz ma niską rozdzielczość. Pola: Connection type (lista rozwijana); IP (pole tekstowe, puste) z czarnym przyciskiem Scan for IP; Port: 80; Reconnect IP recovery (przełącznik z etykietą Yes, włączony); API token (pole tekstowe, puste); drugi przełącznik z krótkim nagłówkiem i tekstem Yes/No; Number of AC system units: 1; What is type of inverter (lista rozwijana): AC coupled system. Przyciski: Back (lewy dolny róg), Test communication i Done (prawy dolny róg, Done jest czarny).
6.3 Test komunikacji
Należy kliknąć Test communication na dole kreatora. Jednorazowo odczytuje on sonnenBatterie i niczego nie zapisuje. Jeśli test się powiedzie, należy kliknąć Done: tylko Done tworzy urządzenie.
Opis tekstowy tego obrazu
Zrzut ekranu dolnego paska przycisków strony Reduxi Configurator. Po lewej: przycisk 'Back'. Po prawej: przycisk 'Test communication' (zaznaczony cyjanową ramką) i ciemny przycisk 'Done'.
Opis tekstowy tego obrazu
Zrzut ekranu strony 'Communication channel and device configuration' w Reduxi Configurator. Connection *: TCP/IP (lista rozwijana). IP *: 192.168.50.243, z przyciskiem 'Scan for IP'. Port *: 502, z przyciskiem 'Test port'. Modbus unit ID *: 1. Przyciski na dole: Back (po lewej), Test communication i Done (po prawej). Przycisk Done jest zaznaczony cyjanową ramką.
Test daje jeden z dwóch wyników:
Opis tekstowy tego obrazu
Zrzut ekranu okna Test communication w Reduxi Configurator z ikoną zamknięcia (x) w prawym górnym rogu. Białe pole wyniku, zielony tekst: Successful readout from device. Wartości: 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. Przycisk: Close (ciemny, prawy dolny róg).
Opis tekstowy tego obrazu
Zrzut ekranu okna Test communication (X zamykający w prawym górnym rogu). Pierwsze pole: Unable to communicate with device. Drugie pole z czerwonym tekstem: 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. Przycisk: Close (ciemny).
Jeśli pojawi się komunikat “Unable to communicate with device”, należy sprawdzić ustawienia (zob. Punkt 8).
7 Sprawdzenie odczytów i konfiguracja strategii
7.1 Last measurements
Po nawiązaniu komunikacji należy sprawdzić zmierzone wartości w Devices – your Sonnen device – Last measurements w Reduxi Configurator.
7.2 Reduxi Cloud
Jak dodać i połączyć sterownik z Reduxi Cloud: Reduxi Cloud
7.3 Strategie
Aby skonfigurować strategie i AI Energy Manager, należy skorzystać z poniższej dokumentacji.
8 Lista kontrolna
Poniższa lista kontrolna pomaga zapewnić prawidłową konfigurację i niezawodne działanie.
8.1 W Reduxi Controller
- Adres IP: Dla podłączonego urządzenia wpisano prawidłowy adres IP.
- Token API: Wpisano prawidłowy token API.
- Typ systemu: Wybrano prawidłowy typ systemu: AC‑coupled lub Hybrid.
- Test komunikacji: Test komunikacji zakończył się powodzeniem.
- Osiągalność: Adres IP urządzenia jest osiągalny z Reduxi Controller.
8.2 W interfejsie WWW sonnenBatterie
- Uprawnienia API: Włączone są zarówno Read API, jak i Write API.
- Tryb pracy: Tryb pracy to Manual.
8.3 Strategia
- Aktywna strategia: Wybrana strategia jest ustawiona jako Active.
- Optymalizacja energii przez AI: W strategii włączona jest optymalizacja AI Energy Manager.
- Jedna aktywna strategia: Aktywna jest tylko jedna strategia naraz.
- Limity importu/eksportu: Limity importu i eksportu są zdefiniowane i skonfigurowane.
✓ Podsumowanie
Przygotowanie (punkty 1–3): Przygotować lokalny adres IP, hasło instalatora i komputer w tej samej sieci. Otworzyć interfejs WWW sonnenBatterie.
sonnenBatterie (punkt 4): Zalogować się jako Installer, włączyć Read API i Write API, skopiować lub utworzyć token API i ustawić tryb pracy na Manual.
Dodanie do Reduxi (punkty 5–6): Otworzyć Configurator i dodać urządzenie typu Sonnen. Wpisać adres IP, token API i typ falownika (AC‑coupled lub Hybrid). Uruchomić Test communication.
Uruchomienie (punkty 7–8): Sprawdzić odczyty, skonfigurować strategie i przejść przez listę kontrolną.
→ Typowe problemy
| Problem | Rozwiązanie |
|---|---|
| Test communication pokazuje „Unable to communicate with device” | System nie jest poprawnie skonfigurowany. Należy sprawdzić adres IP, token API, typ systemu (AC‑coupled lub Hybrid) oraz czy adres IP jest osiągalny ze sterownika (zob. Punkt 8). |
| Logowanie jako instalator nie jest możliwe | Hasło instalatora nie jest dostępne dla użytkowników końcowych. Należy skontaktować się z instalatorem, który uruchomił system, lub z wsparciem Sonnen (zob. Punkt 4). |
| Brak dostępnego tokenu API | Należy otworzyć Software Integration w interfejsie WWW sonnenBatterie i kliknąć Create new na dole strony. |
| Polecenia Reduxi nie mają wpływu na baterię | Należy sprawdzić, czy tryb pracy to Manual, czy Read API i Write API są włączone, czy strategia jest Active i czy aktywna jest tylko jedna strategia (zob. Punkt 8). |
| Open configurator nie otwiera się lub pozostaje pusty | Tunel nie jest jeszcze aktywny. Odczekać około 30 sekund i sprawdzić, czy sterownik jest online. |
Logowanie jako admin jest odrzucane |
Hasło zostało zmienione podczas instalacji. Należy zapytać instalatora. Hasło do konta Reduxi tutaj nie działa. |
reduxi.local się nie ładuje |
Urządzenie nie jest w tej samej sieci co sterownik. Należy użyć adresu IP lub połączenia tunelowego. |
| Test komunikacji kończy się błędem, urządzenie jest offline | Sprawdzić dostępność, adres IP / port / unit ID oraz to, czy protokół jest włączony w urządzeniu. |