Описание

По температуре воздуха и относительной влажности обработчик вычисляет точку росы и сравнивает её с температурой поверхности. В результат входят точка росы, температурный запас и флаг риска конденсации.
Используйте его для контроля стен и окон, поверхностей в холодильных камерах, шкафов автоматики и складского оборудования. Чтобы подключить обработчик к другой модели, сопоставьте кросс-элементы (КЭ) с её параметрами.
Флаг включён, если температура поверхности не выше точки росы плюс заданный запас. По умолчанию запас составляет 2 °C. Это расчётная оценка риска; воду на поверхности обработчик не обнаруживает.
Требования
- Оборудование: датчики температуры воздуха, относительной влажности и температуры поверхности. Подойдёт и одно многоканальное устройство, передающее все три показателя. Конкретный производитель, модель и версия прошивки не требуются.
- Подключение: любой поддерживаемый платформой протокол. Обработчик получает параметры объекта внутри RIC, поэтому отдельные адреса, порты и внешние подключения ему не нужны.
- Настройка после импорта: сопоставьте входные и выходные КЭ с параметрами каждой модели. Передавайте температуры в °C, влажность в %. Если вход отсутствует, используется последнее значение объекта. При необходимости измените запас до точки росы; по умолчанию это 2 °C.
- Проверка: 3 ноября 2026 года на sandbox.rightech.io проверены импорт JSON, создание обработчика, четыре входных и четыре выходных КЭ и три случая во встроенном тестировании. Номер сборки платформы не определялся. Проверка проходила на синтетических данных; сопоставления с моделью, запуск на объекте и оборудование не проверялись.
Состав
risk-condensation.handler.json: обработчик JavaScript с восемью КЭ. Проверяет входные значения и выполняет расчёт.
Обработчик подключается к существующим моделям и записывает результаты в параметры. События он не генерирует. Модель устройства, объекты, сценарии и дашборды в публикацию не входят.
Настройка и запуск
- Импортируйте
risk-condensation.handler.jsonв разделе Обработчики → Создать → Импорт → Из файла. - На вкладке Назначение на модели выберите модель и сопоставьте входы по таблице. Если моделей несколько, настройте каждую.
- Добавьте в модель недостающие выходные параметры и сопоставьте с ними выходные КЭ. Для этих параметров не задавайте источник данных устройства.
- Оставьте запас 2 °C или сопоставьте
risk_margin_cс числовым параметром модели. Значение настройки должно быть неотрицательным. - На вкладке Запуск на объекты назначьте обработчик тестовому объекту. Передайте согласованные измерения и проверьте результат в обработанных данных объекта.
- В сценариях и индикации учитывайте
condensation_riskвместе сdata_valid. Отдельно контролируйте свежесть телеметрии.
Входные КЭ
| КЭ | Назначение | Тип и единица |
|---|---|---|
air_temperature_c |
Температура воздуха | number, °C; от −45 до +60 включительно |
relative_humidity_pct |
Относительная влажность воздуха | number, %; больше 0 и не больше 100 |
surface_temperature_c |
Температура контролируемой поверхности | number, °C |
risk_margin_c |
Запас до точки росы | number, °C; не меньше 0; по умолчанию 2 |
Первые три входа обязательны. Если настройка risk_margin_c отсутствует или равна null, используется значение из кода.
Выходные КЭ
| КЭ | Назначение | Тип и единица |
|---|---|---|
dew_point_c |
Рассчитанная точка росы | number, °C |
temperature_margin_c |
Температура поверхности минус точка росы | number, °C |
condensation_risk |
true, если температурный запас меньше или равен risk_margin_c |
boolean |
data_valid |
true, если входные значения позволяют выполнить расчёт |
boolean |
Проверочный пример
Во встроенном режиме тестирования передайте:
{
"air_temperature_c": 25,
"relative_humidity_pct": 60,
"surface_temperature_c": 18,
"risk_margin_c": 2
}Ожидаемый результат с округлением:
{
"dew_point_c": 16.693149,
"temperature_margin_c": 1.306851,
"condensation_risk": true,
"data_valid": true
}При температуре поверхности 22 °C риск становится false. При влажности 0 % возвращается только data_valid = false. Все три случая проверены в Sandbox.
Ограничения
- Точка росы рассчитывается по приближённой формуле Магнуса над жидкой водой с коэффициентами 17,62 и 243,12 °C. Формула не учитывает давление и не рассчитывает точку инея. При очень низкой влажности результат может оказаться за пределами применимости аппроксимации. Источник: Sensirion, Introduction to Humidity.
- Измеряйте температуру поверхности отдельно: температура воздуха её не заменяет.
- Пустые строки и числовые строки не преобразуются в числа. При неверных входах обработчик возвращает только
data_valid = falseи не обновляет остальные результаты. Проверяйте качество и свежесть данных, прежде чем использовать предыдущие значения. - Если показатели приходят в разных пакетах, расчёт может использовать последние известные значения. Согласуйте время и частоту измерений; по возможности передавайте все три показателя вместе.


