Интеграция Enpal AC-Box

Для чего нужен этот адаптер?

Считывает данные об энергопотреблении из локального экземпляра InfluxDB 2.x, предоставленного компанией Enpal Solar Systems, и предоставляет доступ к состояниям ioBroker для домашней автоматизации:

• Мониторинг производства солнечной энергии
• Отслеживание уровня заряда батареи (SoC)
• Проанализируйте потребление электроэнергии из сети и подачу электроэнергии в сеть.
• Автоматизация на основе выработки электроэнергии
• Визуализация потоков энергии на панели управления ioBroker.
• При желании управлять настенным зарядным устройством Enpal (режим зарядки, запуск/остановка) можно через локальный веб-интерфейс Enpal Box.

Функции

Адаптер подключается напрямую к локальной базе данных InfluxDB , в которую записывает данные устройство Enpal — облачная учетная запись или доступ в интернет не требуются.

• Автоматическое обнаружение всех измерений, устройств и полей, хранящихся в вашем хранилище InfluxDB.
• Динамическое создание состояния в рамкахenpal.0.<measurement>.<device>.<field>
• Настраиваемый интервал опроса (по умолчанию: 60 секунд)
• статус соединения черезinfo.connection — Экземпляр адаптера становится красным, когда база данных недоступна.
• Дополнительное управление настенным зарядным устройством (режим зарядки, запуск/остановка) через веб-интерфейс Enpal Box Blazor — используется тот же хост, что и URL-адрес InfluxDB (порт 80).

Точки данных

Точки данных создаются динамически на основе содержимого вашего хранилища InfluxDB. Структура соответствует следующему шаблону:

enpal.0.<measurement>.<device>.<field>

Типичные примеры (в зависимости от вашего инвертора и конфигурации Enpal):

• enpal.0.solar.inverter.power — Текущая мощность фотоэлектрической системы (Вт)
• enpal.0.solar.inverter.energy — Энергия, произведенная сегодня (Вт·ч)
• enpal.0.battery.storage.soc — Уровень заряда батареи (%)
• enpal.0.grid.meter.power — Мощность импорта/экспорта из сети (Вт)
• enpal.0.info.connection — Статус подключения к InfluxDB

Фактические названия полей зависят от версии вашей системы Enpal и конфигурации оборудования.

Управление настенным блоком (wallbox_control )

Если в конфигурации адаптера включено управление Wallbox , создается фиксированный канал (независимо от автоматического обнаружения InfluxDB):

enpal.0.wallbox_control.<state>

Как это работает

• Управление (режим, запуск, остановка): Адаптер подключается кhttp://<enpal-box>/wallbox с помощью Blazor SignalR (тот же подход, что и в интеграции Home Assistant Enpal ) и имитирует нажатия кнопок.
• Статус (currentMode ,connectorStatus ,automaticChargeStatus ): Читайте со страницы Enpal Boxhttp://<enpal-box>/deviceMessages (Mode.Charge.Connector.1 ,Status.Wallbox.Connector.1 ,Wallbox.Settings.AutomaticChargeStatus.Connector.1 Обновляется при каждом интервале синхронизации и после управляющих действий. Доступно для записи.mode Состояние также обновляется (с помощьюack: true Таким образом, выпадающие списки VIS остаются синхронизированными при изменении режима вне ioBroker.

Значения состояния разъема

connectorStatus Сообщает о состоянии разъема OCPP от настенного зарядного устройства Enpal/StarCharge. Значения нормализованы в соответствии с каноническим написанием (например,SuspendedEV , нетSuspendedev ).

Примечание: После полной зарядки вы часто увидитеSuspendedEV — Это нормально. Автомобиль перестал потреблять энергию; при необходимости отключите или возобновите зарядку.

Требования

• Прошивка Enpal Box 8.50+ (страница для настенной приставки Blazor)
• Флажок управления настенным блоком включен в конфигурации адаптера.
• Хост ioBroker должен быть подключен к Enpal Box в локальной сети (тот же IP-адрес, что и у InfluxDB, HTTP-порт 80).

Не поддерживается

• Изменение автоматического списания средств с плагина через ioBroker (настройка остается только для чтения; для переключения используйте приложение Enpal).

Установка

1. Установите адаптер через административный интерфейс ioBroker.
2. Создайте новый экземпляр.
3. Настройте следующие параметры (вкладка « Настройки» ):
   • URL InfluxDB : Адрес вашей локальной базы данных InfluxDB (например,http://192.168.1.100:8086 )
   • API-токен : Ваш API-токен InfluxDB (достаточно доступа на чтение)
   • Идентификатор организации : Ваша организация в InfluxDB
   • Корзина : Корзина, в которую Enpal записывает данные (обычно)enpal или аналогичное)
   • Интервал обновления : Интервал обновления данных в секундах (по умолчанию:60 )
   • Управление настенным боксом (опционально): Включите для созданияwallbox_control Позволяет задавать режимы зарядки, запускать и останавливать зарядку через веб-интерфейс Enpal Box (без дополнительного URL — хост берется из URL InfluxDB). При включении этой функции вкладка справки Wallbox объясняет значения параметров, режимов зарядки и состояния разъема.
4. Сохраните изменения и запустите экземпляр.

Как найти свои учетные данные InfluxDB

1. Войдите в веб-интерфейс вашего устройства Enpal или подключитесь к нему через SSH.
2. Откройте пользовательский интерфейс InfluxDB по адресу:http://<enpal-box-ip>:8086
3. Перейдите в раздел Данные → Токены API и создайте токен только для чтения.
4. Обратите внимание на название организации и категорию данных в разделе «Данные» → «Категории данных».

Конфиденциальность и обработка данных

• Этот адаптер подключается только к вашей локальной базе данных InfluxDB — данные не передаются ни в какие облачные сервисы.
• При включенном управлении настенным блоком адаптер также подключается к вашему локальному устройству Enpal (HTTP и WebSocket на том же хосте, что и InfluxDB) — доступ к облаку по-прежнему отсутствует.
• Ваш API-токен хранится в зашифрованном виде в базе данных ioBroker.
• Внешние серверы не подключаются.

Changelog

0.4.3 (2026-07-21)

• (skvarel) Sync wallbox_control.mode from status when charge mode is changed via the Enpal app

0.4.2 (2026-06-12)

• (skvarel) Fixed missing wallbox_help_readme translation in English and German admin UI
• (skvarel) Replaced plain timers in wallbox client with adapter-core setInterval, setTimeout and delay helpers
• (skvarel) Updated iobroker/types for js-controller 7.1 compatibility

0.4.1 (2026-06-10)

• (skvarel) Typed adapter and instance root namespaces as meta folders for a cleaner object tree

0.4.0 (2026-06-07)

• (skvarel) Added read-only wallbox state automaticChargeStatus (automatic charge on plug-in, from /deviceMessages)
• (skvarel) Fixed connectorStatus normalization for OCPP values (e.g. SuspendedEV instead of Suspendedev)
• (skvarel) Documented wallbox connector status values in README
• (skvarel) Added conditional wallbox help tab with data point and status documentation

0.3.0 (2026-06-07)

• (skvarel) Added optional wallbox control via Enpal Box web interface (Blazor SignalR)
• (skvarel) New config option: wallbox_enabled (checkbox); Enpal Box URL is derived automatically from InfluxDB URL
• (skvarel) New states under wallbox_control: start, stop, mode, currentMode, connectorStatus

License

MIT License

Copyright (c) 2026 skvarel skvarel@inventwo.com

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.