⚡

Virtual Integrator — виртуальный интегратор

Накопление энергии в кВт·ч по мощности источника
Virtual Integrator (virtualIntegrator) — виртуальное устройство RealIoT, которое интегрирует мощность источника по времени и показывает накопленную энергию в кВт·ч. Результат сохраняется в параметр value: его можно показывать на рабочем поле, писать в историю, строить по нему график и использовать в сценариях.
Для чего нужен Как добавить Настройка Методы Пропуски данных Примеры Сценарии и графики Вопросы

Для чего нужен виджет

  • Переводит мгновенную мощность в накопленную энергию без отдельного счётчика кВт·ч.
  • Работает с устройством рабочего поля или с виртуальным сенсором Node-RED.
  • Показывает результат сразу на плитке в единицах кВт·ч.
  • Пишет историю параметра value при изменении накопления.
  • Позволяет сбросить накопление к заданному начальному значению.
Интегратор считает энергию из мощности: энергия = мощность × время. Если у источника уже есть готовый накопительный параметр энергии, используйте его напрямую в графиках. Virtual Integrator нужен, когда есть только мощность (W или kW).
📷 Место для снимка виджета Virtual Integrator на рабочем поле
Виджет Virtual Integrator с накопленной энергией

Как добавить

1 Добавьте виджет на рабочее поле
  1. Откройте нужное рабочее поле.
  2. Перейдите в режим редактирования (кнопка ☰ слева вверху, затем «Редактировать»).
  3. Нажмите «Добавить иконку».
  4. На панели выбора найдите карточку «Интегратор».
  5. Виджет появится на текущей вкладке. Переместите его в нужное место.
📷 Место для снимка карточки «Интегратор» в списке виджетов
Карточка «Интегратор» в списке виртуальных устройств
2 Откройте свойства

Щёлкните по виджету правой кнопкой мыши. На сенсорном экране используйте длительное нажатие. Откроется панель свойств Virtual Integrator.

📷 Место для снимка панели свойств Virtual Integrator
Панель свойств: источник мощности, метод и интервалы

Настройка

Основные параметры
Параметр Описание
Название Подпись виджета на рабочем поле.
Device SN Уникальный идентификатор интегратора. По нему его находят сценарии, графики и Node-RED.
Выходной параметр Всегда value в единицах кВт·ч. Поле только для чтения.
Тип источника Устройство рабочего поля или Виртуальный сенсор Node-RED.
Источник мощности Устройство, с которого берётся мощность. Для Node-RED указывается его Device SN.
Параметр мощности Имя числового параметра источника, например power, active_power, value.
Единица мощности Вт или кВт. RealIoT приводит значение к ваттам перед интегрированием.
Метод интегрирования Способ расчёта приращения энергии между двумя точками мощности.
Начальное значение, кВт·ч Стартовое накопление. Используется при первом запуске и после сброса.
Max sub interval, сек Периодическое доначисление энергии, если источник долго не присылает новые точки, но ещё не считается оффлайн. По умолчанию 60. Значение 0 отключает периодическое доначисление.
Offline-интервал, сек Максимальный допустимый разрыв между обновлениями источника. Должен быть больше Max sub interval. По умолчанию 300.
Знаков после запятой Точность отображения результата: от 0 до 6. По умолчанию 3.
Текущее состояние Служебный статус интегратора: idle, ok, gap или error.
Сброс накопления Кнопка «Сбросить к начальному значению» возвращает накопление к начальному значению и очищает служебные метки времени.
Интегратор не может использовать сам себя как источник. Device SN интегратора и Device SN источника должны быть разными.

Методы интегрирования

Между двумя соседними точками мощности RealIoT вычисляет приращение энергии. Формула всегда приводит результат к кВт·ч.

Метод Как считается мощность на интервале Когда удобен
Трапеции trapezoidal Среднее между предыдущей и текущей мощностью Рекомендуемый режим по умолчанию для плавно меняющейся мощности
Левый прямоугольник left Берётся предыдущая мощность на весь интервал Когда новое значение ещё не должно влиять на уже прошедший интервал
Правый прямоугольник right Берётся текущая мощность на весь интервал Когда актуально именно последнее измеренное значение
Для большинства счётчиков и инверторов достаточно метода «Трапеции», единицы «Вт» и параметра power.
📷 Место для снимка выбора метода интегрирования
Выбор метода интегрирования в свойствах

Пропуски данных и состояния

Состояние Что означает
idle Интегратор настроен, но накопление ещё не началось или было сброшено.
ok Накопление идёт штатно, данные источника приходят вовремя.
gap Обнаружен слишком длинный разрыв: источник не обновлялся дольше Offline-интервала. Этот интервал не доначисляется, чтобы не «дорисовывать» энергию вслепую.
error Ошибка конфигурации или данных, например некорректная мощность или удалённый источник.
  • Если источник временно молчит, но разрыв ещё меньше Offline-интервала, RealIoT может доначислять энергию по последней известной мощности с шагом Max sub interval.
  • Если разрыв больше Offline-интервала, интегратор переходит в gap и показывает сообщение о пропуске данных.
  • После возобновления данных накопление продолжается с текущего значения, без задним числом заполнения длинного простоя.
📷 Место для снимка состояния gap / ошибки на виджете
Сообщение о пропуске данных источника

Примеры настройки

Энергия инвертора по активной мощности

  • Тип источника: устройство рабочего поля
  • Параметр мощности: power
  • Единица: Вт
  • Метод: Трапеции
  • Начальное значение: 0
  • Max sub interval: 60
  • Offline-интервал: 300

Мощность из Node-RED

  • Тип источника: виртуальный сенсор Node-RED
  • Node-RED deviceSN: Device SN вашего виртуального датчика
  • Параметр мощности: value или имя параметра из потока
  • Единица: кВт, если поток уже отдаёт киловатты

Продолжение учёта с уже известного остатка

  • Начальное значение: например 125.450 кВт·ч
  • После сохранения интегратор стартует с этого значения
  • Кнопка сброса возвращает накопление именно к нему
📷 Место для снимка готового примера на рабочем поле
Пример: мощность источника и накопленная энергия

История, сценарии и графики

После успешного интегрирования RealIoT сохраняет результат в value и при изменении значения добавляет точку истории.

  • Графики. Virtual Integrator можно выбрать как источник в VirtualGraph, графике энергии и расширенном графике или в виджете «График энергии» по Device SN и параметру value. Для расхода за период в «Графике энергии» удобна агрегация «Изменение счётчика».
  • Сценарии If-Else. Интегратор доступен как аналоговый датчик с операторами >, >=, <, <=, ==, != по параметру value.
  • Node-RED. Используйте Device SN интегратора как обычный числовой источник с параметром value в кВт·ч.
Если на плитке показано состояние gap или error, сначала проверьте источник мощности и интервалы. Накопленное значение при этом сохраняется.

Частые вопросы

Почему на виджете показано «—»?

Интегратор ещё не получил достаточно данных для первого расчёта или находится в состоянии idle после добавления либо сброса. Убедитесь, что источник мощности выбран и уже присылает числовые значения.

Накопление растёт слишком быстро или слишком медленно

Чаще всего неверно выбрана единица мощности. Если источник отдаёт ватты, нужна единица Вт. Если источник уже в киловаттах — кВт. Также проверьте, что выбран именно параметр мощности, а не энергии.

Источник не найден в рабочем поле

Для типа «Устройство рабочего поля» источник должен существовать на этом же workspace. Если устройство удалили, заново выберите источник в свойствах интегратора и сохраните.

Появилось сообщение про offline / отсутствие обновлений

Источник не обновлялся дольше Offline-интервала. RealIoT не доначисляет энергию за этот разрыв. После восстановления данных накопление продолжится с текущего значения. При необходимости увеличьте Offline-интервал, но не делайте его слишком большим без причины.

Как обнулить счётчик энергии?

Откройте свойства и нажмите «Сбросить к начальному значению». Накопление вернётся к полю «Начальное значение, кВт·ч». Если нужно начать с нуля, сначала установите начальное значение 0, сохраните и сбросьте.

Чем Virtual Integrator отличается от Virtual Formula?

Virtual Formula считает мгновенное выражение из текущих значений параметров. Virtual Integrator накапливает энергию во времени по мощности и хранит нарастающий итог в кВт·ч.

← Назад к справке