Произвольный абсолютный датчик показывает числовую величину, которая вычисляется выражением из данных телеметрии и при необходимости пересчитывается по таблице соответствия пар XY. Инженер настраивает его для параметров, которым нет отдельного типа оборудования, — например, CAN-параметров бортового компьютера.
Датчик добавляется в карточке объекта мониторинга (вкладка Объекты → «Дополнительное оборудование» → «Добавить новое оборудование»): после выбора типа открывается показанная выше форма.
¶ Назначение и влияние на систему
Произвольный абсолютный датчик позволяет вычислить любую величину из телеметрии по формуле на встроенном языке выражений платформы, без выбора входа/выхода или атрибута. Платформа сначала проверяет выражение валидации, затем считает значение по основному выражению, при необходимости переводит его через таблицу соответствия пар XY и хранит заданную единицу измерения.
Рассчитанное значение записывается в точки трека и в текущее состояние объекта. Датчик работает и на стационарном объекте — для любой величины, которую передает трекер, например уровня в емкости: значение не зависит от движения и зажигания (раздел «Датчики на стационарном объекте»).
¶ Где видны данные произвольного абсолютного датчика
- Отчет Трассировка датчиков — у каждого произвольного датчика своя колонка с именем датчика и единицей измерения.
- Графики — линия с именем датчика и единицей измерения, тип графика «Произвольный мгновенный датчик».
- Карточка объекта WALIOT.Навигатор — блок «Произвольные датчики» (см. Карточка объекта).
- Уведомления — «Неприемлемые показания произвольных датчиков» по выходу значения за пороги (см. раздел «Пороги допустимых значений и уведомления»).
В отчетах с настройкой «Маски датчиков» в отчет попадают только произвольные датчики, имя которых подходит под маску.
¶ Как платформа считает
Значение считается выражением над телеметрией. Если задано выражение валидации и оно вернуло «ложь», результат пустой; итог обязан быть числом, иначе значение отсутствует.
Таблица соответствия пар XY (при включенном флажке): линейная интерполяция — сырые значения сопоставляются реальным значениям, итог равен интерполяции от рассчитанного значения; значение вне диапазона таблицы дает пустой результат. Таблица хранит целые значения X и Y, отрицательные значения допустимы. Если выражение обернуто в round, floor или ceil, то же округление применяется к результату таблицы.
¶ Пороги допустимых значений и уведомления
Пороги допустимых значений у произвольного абсолютного датчика задают диапазон, в котором значение считается допустимым: значения в пределах порогов включительно допустимы. Если значение остается за пределами порогов не меньше значения поля «Минимальная длительность» в условии уведомления «Неприемлемые показания произвольных датчиков», приходит уведомление — одно на эпизод (см. Уведомления о работе техники). Полем «Маска датчиков» уведомление ограничивают датчиками с подходящим именем. Если задан только один порог, вторая граница не ограничена.
¶ Поля формы
Форма произвольного абсолютного датчика в карточке объекта содержит поля:
- Последнее валидное значение — флажок; при невалидном показании берется последнее корректное значение. У нового датчика флажок включен.
- Игнорирование показаний дополнительного оборудования — флажок зарезервирован и пока недоступен.
- Имя (обязательное) — текстовое поле.
- Псевдоним (наименование для произвольных выражений) — текстовое поле.
- Параметр (произвольное выражение) (обязательное) — произвольное выражение, задающее значение датчика (не «регулярное выражение»).
- Валидатор (произвольное логическое выражение) — текстовое поле.
- Единица измерения — текстовое поле; по умолчанию пустая строка.
- Нижний порог допустимых значений устройства — допускаются отрицательные и дробные значения, дробная часть отделяется точкой (например,
-12.5). - Верхний порог допустимых значений устройства — допускаются отрицательные и дробные значения, дробная часть отделяется точкой (например,
-12.5). - Использовать таблицу соответствия пар XY — флажок; при включении появляется кнопка открытия таблицы, а сама таблица требует минимум 2 пары XY.
- Таблица соответствия пар XY — кнопка открывает встроенную таблицу с графиком (ось X, ось Y). При включенной, но невалидной таблице блок получает красную рамку.
- Комментарий — многострочное поле.
¶ Что доступно в выражении
В выражении произвольного абсолютного датчика доступны:
- атрибуты телеметрии по ключу и другое дополнительное оборудование объекта по его псевдониму;
- каналы трекера:
analog[n],digital[n],impulse[n],fuel[n],temperature[n]; tracker_id, а такжеinterval_metersиinterval_seconds— расстояние и время от предыдущей точки;- поля самой телеметрии (время фиксации, серверное время, признак валидности, широта, долгота, высота, скорость, курс, число спутников);
- поля текущего прицепного или навесного оборудования:
equipment_attachment[width]— ширина,equipment_attachment[equipment_above_ground_height]— высота над землей.
Префикс «#» берет значение из предыдущей телеметрии. В выражениях десятичный разделитель — точка: целая и дробная части числа разделяются точкой (value*0.001), а запятая разделяет только параметры функций (round(value,2)). Полный синтаксис — Синтаксис выражений.
¶ Нюансы и типовые ошибки
Как настраивать CAN-параметры, таблицу XY и что происходит при пропуске значения:
- Параметры бортового компьютера (скорость, обороты, температура, расход топлива и произвольные CAN-атрибуты) настраиваются через этот датчик, датчик измерительных приборов и произвольные логические датчики (см. таблицу параметров). Активные коды диагностики SAE J1939 с терминалов Galileosky приходят атрибутами телеметрии — см. Прием активных кодов диагностики по протоколу SAE J1939.
- Таблица соответствия пар XY показывается двухступенчато: флажок включает валидацию и кнопку, кнопка открывает саму таблицу с графиком; при включении требуется не менее 2 пар, при невалидной таблице блок получает красную рамку.
- Флажок «Последнее валидное значение» работает так: если текущего значения нет, платформа пересчитывает его по последней валидной телеметрии, а если и это не удалось — возвращает предыдущее валидное значение.
- Если выражение не дает числа, значение в точке отсутствует и точка не учитывается.
¶ Что дальше
- Отчет «Трассировка датчика» — датчик настроен: проверьте рассчитанные показания по времени.
- Уведомление о неприемлемых показаниях — получайте сообщение, когда значение выходит за пороги.
¶ Связанные возможности
- Дополнительное оборудование
- Совместимое оборудование и протоколы
- Работа техники
- Отчетность и автоматизация
В зависимости от роли пользователя и назначенного ему набора прав доступ к операциям с оборудованием может быть ограничен.