Адаптер ioBroker для инверторов Absaar EMS. Адаптер считывает данные об инверторах и станциях из облачного API Absaar EMS, используемого приложением Absaar EMS.
Информация о продукте и производителе доступна в разделе Официальный сайт AdvanSol Power.
Адаптер не содержит закрытых учетных данных, закрытых имен хостов или данных, специфичных для пользователя. Учетные данные хранятся в защищенных и зашифрованных полях собственной конфигурации ioBroker.
Функции
- Опрос через облако с помощью
https://mini-ems.com:8081 - Войдите в систему, используя учетные данные приложения Absaar EMS.
- Автоматическая обработка токенов и повторная аутентификация
- Настраиваемый интервал опроса
- Состояние станций по суточному, месячному и суммарному объему выработки энергии.
- Дополнительные параметры станции, такие как текущая мощность и счетчики дохода/окружающей среды.
- Состояние коллектора, такое как входная мощность, статус подключения, имя коллектора и время последнего подключения.
- Состояния инвертора для переменного тока, фотоэлектрических панелей, температуры, батареи и нагрузки.
- Дополнительные параметры: необработанные JSON-состояния для устранения неполадок.
- Административная конфигурация на основе JSON
Требования
- ioBroker js-controller
>= 6.0.11 - ioBroker Admin
>= 7.8.23 - Node.js
>= 22 - Учетная запись Absaar EMS, в которой как минимум один инвертор или станция настроены в приложении Absaar EMS.
- Сетевой доступ с хоста ioBroker к
mini-ems.com:8081
Конфигурация
Откройте конфигурацию экземпляра адаптера в административной панели ioBroker.
| Настройки | Описание |
|---|---|
| Адаптер активен | Включает или отключает опрос. |
| Имя пользователя Absaar | Имя пользователя, используемое в приложении Absaar EMS. В зависимости от учетной записи это может быть адрес электронной почты или имя пользователя. |
| Пароль Absaar | Пароль, используемый в приложении Absaar EMS. Хранится в зашифрованном и защищенном виде в конфигурации ioBroker. |
| Интервал опроса в секундах | Интервал опроса в секундах, от 30 до 86400. Значение по умолчанию — 120. Рекомендуется использовать это значение в умеренных количествах, чтобы избежать ограничений скорости облачных сервисов. |
| Базовый URL API | По умолчанию: https://mini-ems.com:8081. Обычно его не следует изменять. |
| Сохраняет необработанные данные в формате JSON | Записывает полный полученный JSON в состояния для устранения неполадок. По умолчанию отключено. |
Штаты
Адаптер создает состояния, находящиеся ниже этой структуры:
absaar.0.info.*
absaar.0.stations.<stationId>.*
absaar.0.stations.<stationId>.inverters.<inverterId>.*
Информационные состояния
| Штат | Тип | Описание |
|---|---|---|
info.connection | логическое значение | true если последний опрос прошел успешно. |
info.lastError | строка | Последнее сообщение об ошибке. Пусто после успешного опроса. |
info.lastError | строка | Последнее сообщение об ошибке. Пусто после успешного опроса. |
Штаты станции
| Штат | Подразделение | Описание |
|---|---|---|
dailyPowerGeneration | кВт·ч | Ежедневное количество выработанной энергии, предоставляемое API Absaar. |
totalPowerGeneration | кВт·ч | Общее количество выработанной энергии, указанное в API Absaar. |
currentPower | W | Текущая мощность станции, сообщаемая API Absaar. |
incomeOfTheDay | Счетчик ежедневного дохода, предоставляемый API. | |
currentMonthsIncome | Счетчик ежемесячного дохода, предоставляемый API. | |
cumulativeIncome | Счетчик совокупного дохода, предоставляемый API. | |
saveStandardCoal | Счетчик параметров окружающей среды, предоставленный API. | |
emissionReductionCO2 | Счетчик сокращения выбросов CO2, отображаемый API. | |
protectTrees | Счетчик защиты деревьев, отображаемый API. | |
inverterTotal | Количество назначенных инверторов. | |
inOnCount | Количество подключенных инверторов. | |
inOnCount | Количество подключенных инверторов. |
Штаты-коллекционеры
Состояния сборщика создаются ниже stations.<stationId>.inverters.<inverterId>. Они создаются даже в том случае, если отдельная конечная точка данных инвертора не возвращает ни одной строки.
| Штат | Подразделение | Описание |
|---|---|---|
collectorId | Идентификатор сборщика. | |
inverterId | Идентификатор инвертора. | |
inverterName | Название инвертора. | |
communicationStatus | Статус связи, сообщаемый API. | |
onlineStatus | Информация о состоянии сети, предоставляемая API. | |
networkStatus | Числовой статус сети. | |
inPower | W | Входная или текущая мощность, указанная в списке коллекторов. |
ipAddress | IP-адрес на стороне облака, сообщаемый API. | |
onlineTime | Последнее время подключения к сети. | |
exhibitionTime | Последняя метка времени, отображаемая API. | |
collectorType | Тип коллектора. | |
equipmentType | Тип оборудования. | |
modelReplace | Идентификатор модели. | |
modelReplace | Идентификатор модели. |
Состояния инвертора
| Штат | Подразделение | Описание |
|---|---|---|
acPower | Вт | Выходная мощность переменного тока. |
acFrequency | Гц | Частота переменного тока. |
acElectric | A | Переменный ток. |
pv1Power | Вт | Входная мощность фотоэлектрической панели 1. |
pv2Power | Вт | Мощность на входе фотоэлектрической панели 2. |
pv1Voltage | V | Входное напряжение PV 1. |
pv2Voltage | V | Входное напряжение PV 2. |
pv1Electric | A | Входной ток фотоэлектрической панели 1. |
pv2Electric | A | Входной ток фотоэлектрической панели 2. |
inPower | Вт | Входная мощность, сообщаемая API. |
temperature | °C | Температура инвертора. |
batteryVoltage | В | Напряжение батареи, если оно отображается устройством. |
batteryCurrent | A | Ток батареи, если он отображается устройством. |
batteryPower | W | Уровень заряда батареи, если он отображается устройством. |
loadPower | Вт | Мощность нагрузки, если она отображается устройством. |
controllerTemperature | °C | Температура контроллера, если она сообщается устройством. |
controllerTemperature | °C | Температура контроллера, если она отображается устройством. |
Не каждое устройство Absaar отображает все поля. Отсутствующие значения остаются неизменными до тех пор, пока API не сообщит допустимое числовое значение.
Поиск неисправностей
- Проверьте
absaar.0.info.connection. - Проверьте
absaar.0.info.lastError. - Убедитесь, что те же учетные данные работают в приложении Absaar EMS.
- Во время тестирования поддерживайте интервал опроса на уровне 120 секунд или выше.
- Включайте необработанный JSON только временно, поскольку он может создавать большие состояния в зависимости от ответа API.
Changelog
0.1.13 (2026-07-14)
- Added complete adapter description translations and a manufacturer link.
- Enforced a safe polling interval range of 30 seconds to 24 hours.
- Enabled TLS certificate verification for cloud API requests.
- Improved state roles and avoided redundant object creation during polling.
- (ioBroker-Bot) Adapter requires admin >= 7.8.23 now.
0.1.12
- Added the release script configuration required by the repository checker.
0.1.11
- Added ioBroker development tooling used by common adapter maintenance workflows.
- Switched admin translations to the short i18n file format.
0.1.10
- Switched the CI workflow to the standard ioBroker testing actions.
- Added package and integration test scripts expected by the ioBroker checker.
0.1.9
- Added trusted publishing workflow configuration for signed npm releases.
- Added repository housekeeping updates requested by the ioBroker checker.
Older entries are archived in CHANGELOG_OLD.md.
License
MIT License
Copyright (c) 2026 TheBam