Как да свържете sonnenBatterie (Gen. 8 или по-нова, връзка чрез REST API) с Reduxi контролер
Свържете sonnenBatterie Gen. 8 или по-нова към Reduxi Controller чрез REST API.
Текстово описание на това изображение
Снимка на sonnenBatterie, изображение от производителя. Тъмносива бетонна стена в слабо осветена стая. На стената отляво виси сив правоъгълен модул с ребриста или перфорирана лицева страна, хибридният инвертор според надписа. До него отдясно стои висок светлосив шкаф със светлосин светещ кръгъл пръстен близо до горната част. По устройствата няма четим текст.
- Техническа документация
- Необходимо оборудване
- Локален достъп до sonnenBatterie
- Конфигуриране на устройството sonnenBatterie
- Влизане в уеб интерфейса на Reduxi
- Добавете sonnenBatterie към Reduxi
- Проверете показанията и настройте стратегии
- Контролен списък
- Обобщение
- Често срещани проблеми
- Свързани статии
1 Техническа документация
Страници на производителя за sonnenBatterie:
- sonnenBatterie 10 – Страница на продукта от производителя
- Ръководства за експлоатация на Sonnen – Ръководства за експлоатация от производителя
Видео уроци:
2 Необходимо оборудване
Подгответе следното:
- Reduxi Controller (инсталиран и онлайн)
- sonnenBatterie Gen. 8 или по-нова (REST API)
- Локален IP адрес на sonnenBatterie
- Парола на монтажника (Installer) на sonnenBatterie (вж. Точка 4)
- Компютър в същата локална мрежа като sonnenBatterie
- Лаптоп или таблет с достъп до интернет за конфигуриране на устройството в Reduxi
3 Локален достъп до sonnenBatterie
Преди да започнете, уверете се, че имате локалния IP адрес на sonnenBatterie и че компютърът Ви е свързан към същата локална мрежа.
sonnenBatterie получава IP адреса си от:
- рутера,
- мрежов суич,
- или локален DHCP сървър.
За да намерите IP адреса или DNS името на sonnenBatterie, използвайте find-my.sonnen-batterie.com и следвайте инструкцията на Sonnen.
Отворете уеб браузър и въведете локалния IP адрес на sonnenBatterie, за да отворите уеб интерфейса ѝ. Пример: http://<IP>
4 Конфигуриране на устройството sonnenBatterie
4.1 Вход като монтажник (Installer)
След като отворите IP адреса в браузъра, се появява екран за вход. Изберете Installer като тип вход и въведете паролата на монтажника.
Ако Ви е необходим достъп, свържете се с монтажника, въвел системата в експлоатация, или с поддръжката на Sonnen. Поддръжката на Sonnen може да провери заявката, да отключи достъпа или да направи необходимите промени от Ваше име.
Текстово описание на това изображение
Екранна снимка на екрана за вход в уеб интерфейса на sonnenBatterie, широк прозорец с логото на sonnen в тъмната горна лента. Централно разположено поле за вход със заглавие Dashboard. Текст: Please choose a login. Падащ списък с избрана стойност Installer. Етикет на поле Password, полето е празно. Светлосин бутон Login.
4.2 Dashboard
След успешен вход се показва Menu / Dashboard.
Текстово описание на това изображение
Екранна снимка на уеб интерфейса на sonnenBatterie, страница Dashboard, с логото на sonnen в тъмната горна лента. Ляво меню: Dashboard (открояно в светлосиньо), System, Settings, Battery, Inverter, Powermeter, Powermeter Setup, IOs, Software-Installer, Commissioning Assistant, System-Status, Network, Software-Integration. Заглавие на основната област: Dashboard. Диаграма на енергийните потоци с четири блока: production 3145 W (жълт, икона на соларен панел); consumption 1875 W (син, икона на къща); FeedIn 1273 W (сив, икона на електропровод); active power със статус idle, rSOC: 16% и uSOC: 9% (зелен, икона на батерия). Жълта стрелка върви от production към блока на батерията, зелена стрелка върви от блока на батерията нагоре към consumption.
4.3 Включване на REST API на sonnenBatterie
В dashboard направете следното:
Текстово описание на това изображение
Екранна снимка на уеб интерфейса на sonnenBatterie, страница Software-Integration (логото на sonnen в тъмната горна лента; серийният номер и версията на софтуера са показани горе вдясно с дребен текст). Ляво меню: Dashboard, System, Settings, Battery, Inverter, Powermeter, Powermeter Setup, I/Os, Software-Installer, Commissioning Assistant, System-Status, Network, Software-Integration (открояно с червена рамка). Раздели: JSON API (избран), WebSocket API, Generated Docs (дребен текст). Два превключвателя, и двата включени (сини) и всеки отбелязан с червена рамка: Read API (текст отдолу: allows to request the current status of the sonnenBatterie, measurements and configuration values) и Write API (текст отдолу: send requests to change or discharge the sonnenBatterie and set configuration values). Червена рамка отбелязва реда API Token: стойност на токен (не е показана тук, замазана) и бутон Create New. Отдолу: примерна curl команда със заглавка Auth-Token и URL, завършващ на /api/v2/latestdata. Заглавие Documentation с връзка към документацията на JSON API на sonnenBatterie.
4.4 Задаване на режима на работа
Отворете менюто Settings вляво и изберете режим на работа Manual.
Текстово описание на това изображение
Екранна снимка на уеб интерфейса на sonnenBatterie, страница Settings (горе вдясно е показано Software: 1.15.6, остатъкът е отрязан). Ляво меню: Dashboard, System, Inverter, Settings (открояно в синьо), Network, Software-Integration. Заглавие на основната област: Settings. Секция: Operating Mode. Отворен е падащ списък с избран запис Manual (открояно в сиво). Изброените опции са: Manual; Automatic - Self-Consumption; Battery-Module-Extension (30%); Time-Of-Use. Под падащия списък се вижда изключен (сив) превключвател с етикет Surplus fullcharge.
5 Влизане в уеб интерфейса на Reduxi
Можете да отворите уеб интерфейса на Reduxi по два начина:
Текстово описание на това изображение
Екранна снимка на три екрана на мобилното приложение Reduxi един до друг, с циан рамки и номерирани значки от 2 до 4. Ляв екран (табло, тъмна тема): иконка за меню горе вляво, отбелязана с рамка и значка 2; лого 'reduxi'; раздели 'Real time data' (активен) и 'Statistics'; цена 5.79 € и температура 3.2 °C; диаграма на енергийния поток с къща в центъра (-1.25 kW) и иконки със стойности 69.0 W, 1.3 kW, 1.1 kW (червен кръг), -165.0 W с 97 % (червен кръг) и стойности 0.0 W долу; раздели 'Power' и 'Energy'; долна навигация: Dashboard, Diagnostics, Device control, Settings. Среден екран (странично меню): лого 'reduxi', 'Number of locations: 1233', заглавие 'Reduxi device management', записи '+ Add Reduxi location' и 'Reduxi devices' (отбелязан с рамка и значка 3), след това 'My profile' и 'About app'. Десен екран (страница на устройство): Back; картина на черен контролер Reduxi с два Ethernet порта; статус 'Connected'; карта 'Update available': 'New update is available for your Reduxi device.' с бутон 'Download and install update'; карта 'Connect to configurator': 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' с бутон 'Activate tunnel connection' (отбелязан с рамка и значка 4); карта 'Unit details' с поле 'Unit ID'.
Текстово описание на това изображение
Екранна снимка, съставена от две части една до друга. Лява част: екран на мобилното приложение Reduxi на тъмен фон. Горе: бутон Back; картина на черен контролер Reduxi с два Ethernet порта и клемен блок; статус 'Connected' с иконка на Wi-Fi. Карта 'Update available': 'New update is available for your Reduxi device.' с бутон 'Download and install update'. Карта 'Connect to configurator' с иконка на ключ: 'Tunnel connection enables remote access to your Reduxi configurator, without need to be connected to the same local network.' и бутон 'Open configurator', отбелязан с циан рамка и номерирана значка 5. Отдолу: карта 'Unit details' с поле 'Unit ID' (стойността не се вижда). Дясна част: Reduxi Configurator, отворен в браузър, отбелязан с циан рамка и номерирана значка 6. Заглавна лента: стрелка за назад, 'Tunnel connection', иконка за презареждане. Лява странична лента с иконки (мълния, чип, светкавица, стълбовидна диаграма, зъбно колело). Страница 'Home' със зелена иконка на връзка. Зелено съобщение: 'New patch available. Click here to apply.' със затварящо X. Час 09:12:56. Диаграма на енергийния поток с къща в центъра (1.700 kW) и иконки за мрежа (0.000 kW), слънце (1.700 kW), батерия (зелена, 0.000 kW и 0.800 kW), устройство вляво (0.900 kW), електрически автомобил и зарядно устройство или друго устройство долу. Етикет 'Energy manager' най-долу.
http://reduxi.local. IP адреса на контролера ще намерите в списъка с устройства на рутера или в приложението Reduxi под Reduxi devices.admin · Парола: admin (фабрична настройка)Текстово описание на това изображение
Екранна снимка на страницата за вход в Reduxi Configurator в прозорец на Chrome. Адресната лента показва 'Not secure' и 'reduxi.local'; адресната лента е отбелязана с циан рамка и увеличено копие на нея (циан рамка, текст 'Not secure reduxi.local') е показано вляво, свързано с циан линия. Фон на страницата: светлосив линеен чертеж на къща със соларни панели (зелени), стенна кутия, инвертор, кола и зарядно устройство. Горе вляво: лого 'reduxi configurator'. В центъра е кутия за вход със заглавие 'Login', избор на език (английско знаме, 'English'), поле за потребителско име и поле за парола и тъмен бутон 'Login'.
Текстово описание на това изображение
Екранна снимка на уеб интерфейса на Reduxi Configurator след влизане, светла тема. Горе вляво: лого 'reduxi configurator'. Заглавна лента: 'Home' вляво, зелен статус 'Connected' горе вдясно. Лява странична лента: разгъната секция 'Devices' със списък от записи, след това свити секции 'Manager', 'Configuration' и 'Settings'. Основна област: диаграма на енергийния поток. Къща в центъра с пръстен, стойност 24.20 kW. Иконка Grid горе вляво, 24.20 kW (червена точка на линията ѝ). Иконка Solar горе вдясно, стойност '-'. Лява иконка (батерия или устройство), 6.700 kW (зелена точка на линията ѝ). Десни иконки (батерия и устройство), стойности '-'. Иконка EV charger долу вляво, 31.00 kW. Друга иконка на устройство долу вдясно. Етикет 'Energy manager' под къщата.
6 Добавете sonnenBatterie към Reduxi
Използвайте тези стъпки, за да добавите ново устройство към Reduxi Controller.
6.1 Основни настройки
Влезте в Reduxi Configurator (вж. Точка 5; вж. също Как да влезете в Reduxi Configurator през браузър) и щракнете върху + Add device.
Текстово описание на това изображение
Екранна снимка на лявото меню на Reduxi Configurator под логото reduxi Configurator. Записи в менюто: Devices (разгъната, със знак минус), съдържаща бутона '+ Add device' (с контур); Strategies (знак плюс); Utility Rate Plan; Settings (знак плюс). Дясната страна е празна, бяла.
В първата стъпка дефинирайте основните настройки:
- Device type:
Hybrid Inverter - Type:
Sonnen - Name: име по Ваш избор
Текстово описание на това изображение
Екранна снимка на форма в Reduxi Configurator със заглавие Basic settings. Полета: Device type (падащ списък, стойността е с дребен текст); Type (падащ списък, стойността изглежда гласи Sonnen, дребен текст); Name (текстово поле, стойността изглежда гласи sonnen, дребен текст). Отдолу е секция Include in Strategy с таблица: колони Strategy, Measurement Device, Regulated Device; два реда, и двата с етикет Energy manager, всеки с малък индикатор в колоните Measurement Device и Regulated Device. Бутони: Back (долу вляво, бял), Next (долу вдясно, черен). Изображението е с ниска резолюция и повечето текст е дребен.
Щракнете върху Next.
6.2 Настройки за комуникация
| Параметър | Стойност |
|---|---|
| Връзка | TCP/IP |
| IP | IP адрес на sonnenBatterie |
| API token | API token от Точка 4, точка 4.3 |
| PV | Изберете типа на инвертора: AC‑coupled (батерията и инверторът са отделни) или Hybrid (батерията и инверторът са интегрирани в една система) |
Текстово описание на това изображение
Екранна снимка на форма в Reduxi Configurator със заглавие Communication channel and device configuration. Изображението е с ниска резолюция. Полета: Connection type (падащ списък); IP (текстово поле, празно) с черен бутон Scan for IP; Port: 80; Reconnect IP recovery (превключвател с етикет Yes, включен); API token (текстово поле, празно); втори превключвател с кратко заглавие и текст Yes/No; Number of AC system units: 1; What is type of inverter (падащ списък): AC coupled system. Бутони: Back (долу вляво), Test communication и Done (долу вдясно, Done е черен).
6.3 Проверка на комуникацията
Щракнете върху Test communication най-долу в съветника. Той отчита sonnenBatterie веднъж и не запазва нищо. Ако тестът е успешен, щракнете върху Done: само Done създава устройството.
Текстово описание на това изображение
Екранна снимка на долната лента с бутони на страница на Reduxi Configurator. Вляво: бутон 'Back'. Вдясно: бутон 'Test communication' (отбелязан с циан рамка) и тъмен бутон 'Done'.
Текстово описание на това изображение
Екранна снимка на страницата 'Communication channel and device configuration' в Reduxi Configurator. Connection *: TCP/IP (падащ списък). IP *: 192.168.50.243, с бутон 'Scan for IP'. Port *: 502, с бутон 'Test port'. Modbus unit ID *: 1. Бутони най-долу: Back (вляво), Test communication и Done (вдясно). Бутонът Done е отбелязан с циан рамка.
Тестът връща един от два резултата:
Текстово описание на това изображение
Екранна снимка на диалога Test communication в Reduxi Configurator с икона за затваряне (x) горе вдясно. Бяло поле с резултат, зелен текст: Successful readout from device. Стойности: 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. Бутон: Close (тъмен, долу вдясно).
Текстово описание на това изображение
Екранна снимка на диалог със заглавие Test communication (X за затваряне горе вдясно). Първо поле: Unable to communicate with device. Второ поле с червен текст: 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. Бутон: Close (тъмен).
Ако получите съобщението “Unable to communicate with device”, проверете настройките (вж. Точка 8).
7 Проверете показанията и настройте стратегии
7.1 Last measurements
След като комуникацията е установена, проверете измерените стойности под Devices – your Sonnen device – Last measurements в Reduxi Configurator.
7.2 Reduxi Cloud
Как да добавите и свържете контролера към Reduxi Cloud: Reduxi Cloud
7.3 Стратегии
За да настроите стратегии и AI Energy Manager, използвайте документацията по-долу.
8 Контролен списък
Прегледайте този контролен списък за правилна настройка и надеждна работа.
8.1 В Reduxi Controller
- IP адрес: За свързаното устройство е въведен правилният IP адрес.
- API token: Въведен е валиден API token.
- Тип система: Избран е правилният тип система: AC‑coupled или Hybrid.
- Тест на комуникацията: Тестът на комуникацията е завършен успешно.
- Достъпност: IP адресът на устройството е достъпен от Reduxi Controller.
8.2 В уеб интерфейса на sonnenBatterie
- Права на API: Включени са и Read API, и Write API.
- Режим на работа: Режимът на работа е Manual.
8.3 Стратегия
- Активна стратегия: Избраната стратегия е зададена като Active.
- AI енергийна оптимизация: Оптимизацията AI Energy Manager е включена в стратегията.
- Една активна стратегия: Само една стратегия е активна в даден момент.
- Лимити за внос/износ: Лимитите за внос и износ са дефинирани и конфигурирани.
✓ Обобщение
Подготовка (точки 1–3): Подгответе локалния IP адрес, паролата на монтажника и компютър в същата мрежа. Отворете уеб интерфейса на sonnenBatterie.
sonnenBatterie (точка 4): Влезте като Installer, включете Read API и Write API, копирайте или създайте API token и задайте режима на работа на Manual.
Добавяне в Reduxi (точки 5–6): Отворете Configurator и добавете устройството с тип Sonnen. Въведете IP адрес, API token и типа на инвертора (AC‑coupled или Hybrid). Стартирайте Test communication.
Пускане в работа (точки 7–8): Проверете показанията, настройте стратегиите и преминете през контролния списък.
→ Често срещани проблеми
| Проблем | Решение |
|---|---|
| Test communication показва “Unable to communicate with device” | Системата не е конфигурирана правилно. Проверете IP адреса, API token, типа на системата (AC‑coupled или Hybrid) и дали IP адресът е достъпен от контролера (вж. Точка 8). |
| Входът като монтажник не е възможен | Паролата на монтажника не е достъпна за крайните потребители. Свържете се с монтажника, въвел системата в експлоатация, или с поддръжката на Sonnen (вж. Точка 4). |
| Няма наличен API token | Отворете Software Integration в уеб интерфейса на sonnenBatterie и щракнете върху Create new най-долу на страницата. |
| Командите на Reduxi нямат ефект върху батерията | Проверете дали режимът на работа е Manual, дали Read API и Write API са включени, дали стратегията е Active и дали е активна само една стратегия (вж. Точка 8). |
| Open configurator не се отваря или остава празен | Тунелът все още не е активен. Изчакайте около 30 секунди и проверете дали контролерът е онлайн. |
Влизането с admin се отхвърля |
Паролата е променена по време на инсталацията. Попитайте инсталатора. Паролата на профила в Reduxi тук не работи. |
reduxi.local не се зарежда |
Вашето устройство не е в същата мрежа като контролера. Използвайте IP адреса или тунелната връзка. |
| Тестът на комуникацията не успява, устройството е офлайн | Проверете достъпността, IP адреса / порта / unit ID и дали протоколът е включен на устройството. |