Расход по накопительному счётчику

Описание
По накопительным показаниям счётчика рассчитывает потребление за интервал и средний расход в час. Подходит для воды, газа, электроэнергии и импульсного учёта.
Обработчик дополняет показания счётчика расчётом потребления между измерениями. Он учитывает коэффициент пересчёта и уменьшение показаний, а при заданном модуле обрабатывает переполнение. Данные можно вывести на дашборд или использовать в сценариях контроля потребления.
В результат входят потребление за интервал и средний расход в час. Отдельные флаги показывают сброс, переполнение и пригодность интервала для расчёта.
Требования
- Оборудование: накопительный счётчик и время каждого измерения. Время передаётся в миллисекундах Unix UTC.
- Подключение: любой поддерживаемый RIC протокол. Обработчик получает параметры внутри платформы, отдельное сетевое подключение ему не нужно.
- Настройка после импорта: сопоставьте входные и выходные кросс-элементы с параметрами своей модели.
- Проверка: импорт и расчёты проверены в RIC Sandbox на тестовых данных. Испытания на оборудовании не проводились.
Состав
counter-consumption.handler.json: обработчик для импорта в RIC.preview.png: изображение для карточки решения.
Входы, выходы и настройки перечислены в параметрах подключения.
Настройка и запуск
- Импортируйте JSON в разделе Обработчики → Создать → Импорт.
- На вкладке Назначение на модели сопоставьте КЭ с измерениями и выходными параметрами модели.
- Задайте количество единиц ресурса на единицу счётчика. Для прибора с переполнением укажите модуль счётчика, например 65536 для 16 бит.
- Назначьте обработчик нужным объектам и проверьте результаты в обработанных данных.
Свяжите входы и выходы состояния с одними и теми же параметрами модели, чтобы следующий расчёт получил предыдущий результат. Их список есть в параметрах подключения.
Пример. За минуту показание счётчика выросло с 1000 до 1010. При коэффициенте 0,01 потребление составит 0,1 единицы ресурса, а средний расход будет равен 6 единицам в час.
Входные измерения
| КЭ | Назначение | Тип | Начальное значение |
|---|---|---|---|
counter_value |
Накопительное показание. Неотрицательное число в исходных единицах счётчика | number | — |
sample_time_ms |
Время измерения. Unix timestamp UTC в миллисекундах, положительное целое; время именно этого измерения | number | — |
Настройки
| КЭ | Назначение | Тип | Начальное значение |
|---|---|---|---|
unit_factor |
Коэффициент пересчёта. Количество единиц ресурса на одну единицу счётчика; строго больше 0 | number | 1 |
counter_modulus |
Модуль переполнения. 0 — переполнение не обрабатывать; иначе верхняя исключённая граница счётчика, например 65536 для 16 бит | number | 0 |
Состояние: вход предыдущего и выход нового значения
| КЭ | Назначение | Тип | Начальное значение |
|---|---|---|---|
previous_counter |
Предыдущее показание | number | 0 |
last_time_ms |
Время предыдущего измерения. Unix мс; 0 при первом запуске | number | 0 |
Свяжите служебные вход и выход каждого КЭ с одним параметром модели. Источник данных устройства для этого параметра не задавайте. Если на объекте несколько обработчиков, выделите каждому свои выходные параметры и состояние.
Выходные параметры
| КЭ | Назначение | Тип | Начальное значение |
|---|---|---|---|
consumption_delta |
Потребление за интервал. В единицах ресурса | number | — |
consumption_per_hour |
Средний расход за интервал. Единиц ресурса в час | number | — |
counter_reset |
Обнаружено уменьшение без модуля | boolean | — |
counter_wrapped |
Применён переход через модуль | boolean | — |
interval_valid |
Интервал пригоден для расчёта | boolean | — |
previous_counter |
Предыдущее показание | number | — |
last_time_ms |
Время предыдущего измерения. Unix мс; 0 при первом запуске | number | — |
data_valid |
Входные данные корректны. При false остальные результаты не обновляются; проверьте входы и настройки | boolean | — |
Ограничения
- Первое измерение задаёт начальную точку. При инициализации и сбросе расход ещё не определён; учитывайте признак пригодности интервала.
- При заданном модуле уменьшение трактуется как одно переполнение. Сброс прибора и несколько переполнений за интервал однозначно не распознаются.
- Проверяйте корректность и свежесть данных. Обработчик не использует внешние сервисы и сторонние библиотеки.


