Jak połączyć sonnenBatterie ze sterownikiem Reduxi
Połącz sonnenBatterie z Reduxi Controller i pozwól strategiom Reduxi ładować i rozładowywać ją po najlepszych cenach. Ten przewodnik opisuje połączenie przez JSON API i wskazuje, kiedy obowiązuje przewodnik dla REST API w Gen. 8 lub nowszych.
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.
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 z JSON API w sekcji Software Integration
- Lokalny adres IP sonnenBatterie
- 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
Podłącz sonnenBatterie do sieci lokalnej przez LAN. Reduxi Controller musi znajdować się w tej samej sieci.
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
Zaloguj się do interfejsu internetowego sonnenBatterie (zob. punkt 3). Token API i adres IP będą potrzebne dla Reduxi Controller (zob. punkt 6).
4.1 Otwieranie Software Integration
Opis tekstowy tego obrazu
Zrzut ekranu interfejsu internetowego sonnenBatterie w przeglądarce, strona Software-Integration, zakładka JSON API. Pasek adresu pokazuje lokalny adres IP, a po nim ścieżkę dash/software-integration/json-api; adres IP jest zaznaczony czerwoną ramką i strzałką z podpisem SonnenBatterie IP. Lewe menu: Dashboard, System, Inverter, Settings, Network i Software-Integration (wyróżnione). Zakładki: JSON API (aktywna), Webhook API i sonnenKNX Module. Dwa przełączniki są włączone: Read API (Allows to request the current status of the sonnenBatterie, measurements and configuration values) i Write API (Send requests to charge/discharge the sonnenBatterie and set configuration values). Pod nimi pole API Token z wartością tokenu, zaznaczone czerwoną ramką i podpisem API Token, oraz przycisk Create New. Przykładowy wiersz powtarza token i adres IP z takimi samymi oznaczeniami. Na dole: link sonnenBatterie JSON API v2 documentation.
4.2 Włączanie Read API i Write API
Włącz Read API i Write API. Oba są wymagane: Reduxi odczytuje pomiary przez Read API, a polecenia ładowania i rozładowania wysyła przez Write API.
Opis tekstowy tego obrazu
Przycięty zrzut ekranu zakładki JSON API z zakładkami JSON API, Webhook API i sonnenKNX Module. Przełącznik Read API jest włączony. Pod nim jasnoniebieska uwaga o treści This functionality is disabled while VPP is active, a następnie wyszarzony przełącznik Write API w pozycji wyłączonej z tekstem Send requests to charge/discharge the sonnenBatterie and set configuration values. Niebieski prostokąt wyróżnia uwagę i przełącznik Write API.
4.3 Ustawianie trybu pracy
Otwórz menu Settings po lewej stronie i ustaw tryb pracy na Manual. Dopiero wtedy Reduxi Controller może przejąć sterowanie baterią.
Opis tekstowy tego obrazu
Zrzut ekranu strony Settings sonnenBatterie (oprogramowanie 1.15.6). Lewe menu: Dashboard, System, Inverter, Settings (wyróżnione), Network i Software-Integration. Karta Operating Mode zawiera listę rozwijaną z wybranym Manual; otwarta lista poniżej oferuje Manual, Automatic - Self-Consumption, Battery-Module-Extension (30%) i Time-Of-Use. Pod kartą widoczny jest przełącznik Surplus fullcharge.
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
Wykonaj te kroki, aby dodać sonnenBatterie jako nowe urządzenie w Reduxi Controller.
6.1 Ustawienia podstawowe
Zaloguj się do Reduxi Configurator (zob. punkt 5; zob. też How to log in to Reduxi Configurator via browser) i kliknij + 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
Wpisz parametry połączenia między Reduxi Controller a sonnenBatterie. Użyj adresu IP i tokenu API z punktu 4.
| Parametr | Wartość |
|---|---|
| Połączenie | TCP/IP |
| IP | Adres IP sonnenBatterie |
| Port | 80 |
| Token API | Token API z zakładki JSON API (punkt 4, punkt 4.1) |
| Moc znamionowa | Wybierz moc znamionową odpowiadającą Twojej sonnenBatterie |
| PV | Wybierz Yes, jeśli zainstalowano licznik PV, w przeciwnym razie No |
Opis tekstowy tego obrazu
Zrzut ekranu formularza Communication channel and device configuration w Reduxi Configurator. Pola od góry do dołu: Connection (TCP/IP), IP (puste, z jasnoniebieską strzałką wskazującą pole), Port (80), API token (puste, z jasnoniebieską strzałką; podpowiedź: API token is located in inverter web interface in section Software-Integration / JSON API), Rated power (14.4 kW) i PV (Yes; podpowiedź: Is PV meter installed?). Przyciski na dole: Back, Test communication i Next.
6.3 Test komunikacji
Kliknij Test communication na dole kreatora. Test jednorazowo odczytuje dane z sonnenBatterie i niczego nie zapisuje. Jeśli test się powiedzie, kliknij Next.
Test daje jeden z dwóch wyników:
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 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).
6.4 Advanced settings
Ustawienia zaawansowane są opcjonalne i zależą od potrzeb miejsca instalacji. Po ich zakończeniu kliknij Done: urządzenie powstaje dopiero po kliknięciu Done.
Opis tekstowy tego obrazu
Zrzut ekranu kreatora Reduxi Configurator, krok 3 z 3 Advanced settings; pasek postępu pokazuje Basic settings, Communication channel i Advanced settings. Przełączniki Yes/No, wszystkie ustawione na No: set data saving interval (domyślnie 1 min), set reading delay (domyślnie 1000 ms), set writing delay (domyślnie 1000 ms), set power generation limits and capabilities, set power consumption limits and capabilities, limit communication with the device to read-only (domyślnie No), invert direction for energy import and export (domyślnie No), exclude device from summary (domyślnie No). Trzy listy rozwijane L1, L2 i L3 is connected to main feed są ustawione na L1, L2 i L3. Przyciski: Back po lewej i Done po prawej.
7 Sprawdzenie odczytów i konfiguracja strategii
7.1 Last measurements
Po nawiązaniu komunikacji sprawdź zmierzone wartości w sekcji Devices – Twoje urządzenie Sonnen – Last measurements w Reduxi Configurator.
7.2 Typ sterowania
Otwórz Devices – swoje urządzenie Sonnen w Reduxi Configurator i ustaw control type na AUTO. Polecenia ze strategii zaczną wtedy wpływać na baterię.
7.3 Reduxi Cloud
Jak dodać i połączyć sterownik z Reduxi Cloud: Reduxi Cloud
Po dodaniu urządzenia możesz je także monitorować i sterować nim w aplikacji Reduxi.
7.4 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 i port: Wpisano adres IP sonnenBatterie i port
80. - Token API: Wpisano prawidłowy token API.
- Moc znamionowa i PV: Moc znamionowa i wybór PV odpowiadają systemowi.
- Test komunikacji: Test komunikacji zakończył się powodzeniem.
- Typ sterowania: Typ sterowania urządzenia jest ustawiony na AUTO.
- 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.
- VPP: Bateria jest odłączona od VPP.
- 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): Przygotuj lokalny adres IP i komputer w tej samej sieci. Otwórz interfejs internetowy sonnenBatterie.
sonnenBatterie (punkt 4): Otwórz Software-Integration, zakładkę JSON API. Włącz Read API i Write API (najpierw odłącz baterię od VPP), skopiuj lub utwórz token API i ustaw tryb pracy na Manual.
Dodawanie do Reduxi (punkty 5–6): Otwórz Configurator i dodaj urządzenie z typem Sonnen. Wpisz adres IP, port 80, token API, moc znamionową i PV. Uruchom Test communication, a następnie kliknij Done.
Uruchomienie (punkty 7–8): Sprawdź odczyty, ustaw control type na AUTO, skonfiguruj strategie i przejdź przez listę kontrolną.
→ Typowe problemy
| Problem | Rozwiązanie |
|---|---|
| Test communication pokazuje „Unable to communicate with device” | Sprawdź adres IP, port 80, token API oraz to, czy adres IP jest osiągalny z kontrolera (zob. punkt 8). |
| Nie można włączyć Write API | Wyświetlana jest uwaga “This functionality is disabled while VPP is active”. Odłącz baterię od VPP, a następnie włącz Write API (zob. punkt 4.2). |
| Brak dostępnego tokenu API | Otwórz Software-Integration, zakładkę JSON API, w interfejsie internetowym sonnenBatterie i kliknij Create New. |
| Polecenia Reduxi nie mają wpływu na baterię | Sprawdź, czy tryb pracy to Manual, czy Read API i Write API są włączone, czy control type to AUTO, czy strategia ma status 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 | Sprawdź osiągalność, adres IP i port oraz to, czy API jest włączone na urządzeniu. |