AI Energy Manager

Подключает ioBroker к backend AI energy management для dynamic tariffs, PV forecasts, battery charging and controlled writable datapoints.

Текущий релиз
0.4.3
Разработчик
Christoph Böhrs
Лицензия
MIT

Адаптер AI Energy Manager подключает ioBroker к бэкэнду SmartEnergy для динамического расчета тарифов на электроэнергию, прогнозирования выработки солнечной энергии, телеметрии, управления батареями, интеграции с настенными зарядными устройствами и контролируемой записи данных.

Адаптер непрерывно отправляет нормализованные данные об энергопотреблении на серверную часть, получает конфигурацию системы, специфичную для пользователя, и выполняет команды управления только для точек данных, явно выбранных пользователем в ioBroker. Он поддерживает бытовые счетчики, фотоэлектрические системы, балконные электростанции, аккумуляторные батареи, универсальные системы хранения энергии, счетчики энергии и настенные зарядные устройства.

документация

Документация на английском языке

функции

  • Подключение к бэкэнду SmartEnergy на основе токенов.
  • Конфигурация адаптера, управляемая сервером и соответствующая фактической системе пользователя.
  • Передача телеметрических данных о потреблении, подаче электроэнергии в сеть, выработке электроэнергии от фотоэлектрических систем, мощности батареи, уровне заряда батареи и значениях настенного зарядного устройства.
  • Автоматическое определение единиц измерения и нормализация для Вт·ч, кВт·ч, Вт и кВт.
  • Динамические таблицы данных по каждому домохозяйству и учреждению.
  • Объектный браузер ioBroker для выбора точек данных
  • Dashboard Lite с системными плитками, 6-часовым планом и распознаванием шаблонов.
  • Предыдущая, текущая и следующая 15-минутная цена на электроэнергию по тарифу, выбранному в личном кабинете пользователя.
  • Управляемые команды управления батареей для зарядки, разрядки и поддержания резервного заряда.
  • Защита от записи: Команды выполняются только для настроенных и доступных для записи точек данных.

Требования

  • Node.js 22 или новее
  • js-controller 6.0.11 или новее
  • ioBroker Admin 7.6.20 или более поздняя версия
  • Учетная запись пользователя SmartEnergy с адаптерным токеном
  • Настроены точки данных ioBroker для используемых счетчиков, батарей, фотоэлектрических систем и настенных зарядных устройств.

установка

Установите адаптер через репозиторий адаптеров ioBroker или через npm.

конфигурация

Откройте конфигурацию адаптера в административной панели ioBroker.

  1. Вставьте токен адаптера через веб-интерфейс SmartEnergy.
  2. Сохраните конфигурацию.
  3. Нажмите «Запросить конфигурацию» .
  4. Откройте вкладку « Точки данных» .
  5. Выберите необходимые пути к состоянию ioBroker через обозреватель объектов.
  6. Сохраните конфигурацию.

Токен адаптера зашифрован и надежно хранится в собственной конфигурации адаптера.

Запрос конфигурации

Кнопка «Запросить конфигурацию» получает текущую конфигурацию системы пользователя из бэкэнда. В ответе определяются необходимые значения для домохозяйства и доступные значения, специфичные для системы. Затем адаптер отображает таблицу домохозяйств и дополнительную таблицу для каждой установленной системы.

Количество систем не фиксировано. Если пользователь добавляет или удаляет системы в веб-интерфейсе, адаптер получает новую структуру при следующей проверке конфигурации.

Существующие сопоставления точек данных будут сохранены до тех пор, пока сохраняются логические ключи.

Точки данных

Адаптер работает с логическими точками данных, а не с жестко заданными путями ioBroker. Типичные точки данных для домохозяйства:

  • Потребление домохозяйств
  • Счетчик потребления электроэнергии из сети
  • Счетчик подачи электроэнергии в сеть
  • текущая производительность сети
  • Энергия настенного блока

Типичные показатели параметров растения:

  • выработка фотоэлектрической энергии
  • Уровень заряда батареи
  • Питание от батареи
  • Емкость аккумулятора
  • Регулируемая выходная мощность переменного тока

Адаптер автоматически нормализует значения источника перед передачей. Например, данные о потреблении кВт·ч могут быть отправлены как телеметрия в Вт·ч, а данные о потреблении кВт — как телеметрия в Вт.

Телеметрия

Адаптер считывает выбранные состояния ioBroker и генерирует на их основе нормализованный телеметрический пакет. Этот пакет отправляется на бэкэнд с заданным интервалом.sendOnlyChanged При активации этой функции неизмененные пакеты пропускаются для уменьшения объема передаваемых данных.

Телеметрия используется на бэкэнде для:

  • ежедневное потребление домохозяйств
  • Потребление электроэнергии из сети и подача электроэнергии в сеть
  • Выход фотоэлектрической энергии
  • доступная емкость батареи
  • Решения о зарядке и разрядке
  • распознавание образов
  • Панель управления и 6-часовой план

Управление батареей и настенным зарядным устройством

Бэкенд может отправлять команды управления для разрешенных логических адресов назначения. Адаптер сопоставляет эти адреса назначения с точками данных ioBroker, выбранными пользователем.

Поддерживаемая логика управления:

  • Зарядка аккумулятора за счет избыточной энергии солнечных батарей.
  • Заряжайте аккумулятор от сети в периоды действия тарифов, не входящих в пиковую нагрузку.
  • Работа от сети с питанием от батареи или кратковременной зарядкой батареи.
  • Батарея разряжается, если план предусматривает резервное питание от батареи.

Адаптер никогда не записывает данные в произвольные идентификаторы состояния из бэкэнда. Операция записи происходит только в том случае, если:

  • Цель является частью конфигурации сервера.
  • Пользователь выбрал точку данных для этого пункта назначения.
  • Объект ioBroker существует
  • Объект доступен для записи.
  • значение соответствует ожидаемому типу
  • Сохраняется заданный минимальный интервал между командами записи.

Штаты

Адаптер создает внутренние состояния ниже уровня своего экземпляра:

  • info.connection
  • info.lastSync
  • info.lastError
  • info.configValid
  • info.tokenValid
  • info.detectedFeatures
  • info.serverConfigVersion
  • info.serverConfigRevision
  • info.serverConfigLastRequest
  • status.backendReachable
  • status.lastPayload
  • status.lastCommand
  • status.lastCommandResult

Токен адаптера никогда не записывается в Штаты.

цены на электроэнергию на фондовой бирже

КаналelectricityPrices Предоставляет тарифные цены, которые также используются веб-интерфейсом SmartEnergy. Эти значения включают надбавку выбранного в учетной записи пользователя поставщика тарифов, а также плату за использование сети, настроенную для системы:

  • electricityPrices.last : предыдущая цена за 15 минут вct/kWh
  • electricityPrices.current Действующая цена за 15 минут в настоящее время.ct/kWh
  • electricityPrices.next : цена за следующие 15 минутct/kWh
  • electricityPrices.status Классификация текущей цены

В статусе используются те же ценовые окна и цвета, что и на веб-интерфейсе:

  • 0— Стандартный диапазон или отсутствие классификации
  • 1 — более дешевый зарядный слот (желтый)
  • 2 — Загрузочный слот моста (синий)
  • 3 — Избегайте подключения к электросети / никогда не заряжайте (черный цвет; не менее 150% от максимального 7-дневного срока службы)

Если текущие данные из бэкэнда недоступны, состояния цен будут отображаться на0 перезагрузить.

Безопасность

  • Токен адаптера хранится в зашифрованном и защищенном виде.
  • В логах токены скрыты.
  • Команды бэкэнда используют логические цели вместо прямых путей к ioBroker.
  • Записываемые точки данных должны быть явно выбраны пользователем.
  • После обработки команды подтверждаются на серверной стороне.
  • Взаимодействие с серверной частью осуществляется по протоколу HTTPS.

Поиск неисправностей

Если телеметрия отсутствует, проверьте на вкладке «Точки данных» , установлены ли все необходимые пути к состоянию.

Если соединение с бэкэндом отсутствует, проверьте:

  • info.connection
  • info.tokenValid
  • status.backendReachable
  • info.lastError

Если команда не выполняется, проверьте, доступно ли для записи выбранное состояние ioBroker и соответствует ли тип значения этому состоянию.

Changelog

WORK IN PROGRESS

0.4.3 (2026-07-28)

  • Update dependencies and GitHub Actions.
  • Expose account-specific 15-minute electricity prices and the current web price classification.

0.4.2 (2026-07-14)

  • General adapter improvements

0.4.1 (2026-07-06)

  • FIX: React state object selector for ioBroker datapoint paths

0.4.0 (2026-07-06)

  • Code Cleanup
  • ioBroker checker changes.
  • Update admin dependencies and keep the React/MUI admin UI compatible with the ioBroker Admin runtime.
  • Fix ApiClient timer fallback

0.2.0 (2026-05-22)

  • Initial release of the AI Energy Manager adapter.

License

MIT License

Copyright (c) 2026 Christoph Böhrs

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.