Описание

Показывает, сколько времени дверь остаётся открытой, и отмечает превышение заданного срока. Подходит для холодильных камер, шкафов, ворот и люков.
Задайте допустимое время открытия. Когда оно истечёт, обработчик включит логический сигнал. Закрытие сбросит его, а следующее открытие начнёт новый отсчёт.
На выходе вы получите длительность открытия, флаг превышения и признак корректности данных.
Требования
- Оборудование: датчик положения двери с периодической передачей состояния и времени измерения в миллисекундах Unix UTC. true означает открытую дверь.
- Подключение: любой поддерживаемый RIC протокол. Обработчик получает параметры внутри платформы, отдельное сетевое подключение ему не нужно.
- Настройка после импорта: сопоставьте входные и выходные кросс-элементы с параметрами своей модели.
- Проверка: импорт и расчёты проверены в RIC Sandbox на тестовых данных. Испытания на оборудовании не проводились.
Состав
door-open-duration.handler.json: обработчик для импорта в RIC.preview.png: изображение для карточки решения.
Входы, выходы и настройки перечислены в параметрах подключения.
Настройка и запуск
- Импортируйте JSON в разделе Обработчики → Создать → Импорт.
- На вкладке Назначение на модели сопоставьте КЭ с измерениями и выходными параметрами модели.
- Задайте разрешённую длительность открытия. По умолчанию это 60 секунд.
- Назначьте обработчик нужным объектам и проверьте результаты в обработанных данных.
Свяжите входы и выходы состояния с одними и теми же параметрами модели, чтобы следующий расчёт получил предыдущий результат. Их список есть в параметрах подключения.
Пример. При лимите 60 секунд сообщение на 59-й секунде открытия ещё не вызовет тревогу. На 60-й секунде сигнал включится. После закрытия двери длительность и сигнал сбросятся.
Входные измерения
| КЭ | Назначение | Тип | Начальное значение |
|---|---|---|---|
door_open |
Дверь открыта. true — открыта; false — закрыта. Инвертируйте сигнал до сопоставления, если у датчика обратная логика | boolean | — |
sample_time_ms |
Время измерения. Unix timestamp UTC в миллисекундах, положительное целое; время именно этого измерения | number | — |
Настройки
| КЭ | Назначение | Тип | Начальное значение |
|---|---|---|---|
allowed_open_s |
Разрешённая длительность открытия. Секунды; неотрицательное число | number | 60 |
Состояние: вход предыдущего и выход нового значения
| КЭ | Назначение | Тип | Начальное значение |
|---|---|---|---|
previous_open |
Предыдущее состояние двери | boolean | false |
last_time_ms |
Время предыдущего измерения. Unix мс; 0 при первом запуске | number | 0 |
opened_at_ms |
Начало текущего открытия. Unix мс; при закрытой двери 0 | number | 0 |
Свяжите служебные вход и выход каждого КЭ с одним параметром модели. Источник данных устройства для этого параметра не задавайте. Если на объекте несколько обработчиков, выделите каждому свои выходные параметры и состояние.
Выходные параметры
| КЭ | Назначение | Тип | Начальное значение |
|---|---|---|---|
open_duration_s |
Длительность текущего открытия. Секунды; при закрытии 0 | number | — |
open_too_long |
Превышено время открытия | boolean | — |
previous_open |
Предыдущее состояние двери | boolean | — |
last_time_ms |
Время предыдущего измерения. Unix мс; 0 при первом запуске | number | — |
opened_at_ms |
Начало текущего открытия | number | — |
data_valid |
Входные данные корректны. При false остальные результаты не обновляются; проверьте входы и настройки | boolean | — |
Ограничения
- Для своевременного срабатывания нужны периодические сообщения об открытой двери: без новых данных отсчёт не обновляется.
- Если дверь была открыта до запуска, время считается с первого принятого измерения. Пропущенное закрытие и повторное открытие неотличимы от непрерывного открытия.
- Проверяйте корректность и свежесть данных. Обработчик не использует внешние сервисы и сторонние библиотеки.


