Датчики

От устройств мониторинга информация приходит в формате «параметр» = «значение». Это может быть как информация от встроенных датчиков устройства, например, скорость, уровень сигнала, заряд батареи, так и от внешних датчиков, например, датчик уровня топлива, зажигание автомобиля, данные с CAN-шины, и т.д.
Для обособления и настройки этой информации в системе мониторинга предусмотрен функционал «Датчик».

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

Для создания любого датчика необходимо знать его параметр. Узнать параметр датчика можно как в системе мониторинга, посмотрев приходящие от устройства сообщения, так и в настройках самого устройства, например в диагностических данных конфигуратора. Так же стандартные параметры можно уточнить в документации к используемому устройству.

Создание датчика #

Чтобы создать датчик зайдите в свойства объекта, перейдите во вкладку «Датчики», и нажмите на кнопку «+».

Далее нужно заполнить необходимые поля в свойствах датчика.

Импорт датчика #

Датчик можно создать с помощью загрузки JSON файла.
При необходимости можно проставить чекбокс «Заменить существущие датчики», тогда дублей датчиков не будет. Сравнение идёт по имени или типу.

Свойства датчика #

В свойствах датчика настройки разделены на две вкладки — «Основное» и «Таблица расчёта».

Основное #

Имя — название датчика . Можно указать любое имя, например «Датчик уровня топлива». Это имя датчика будет отображаться в отчётах, сообщениях, и в карточке объекта.

Тип датчика — описаны ниже, в разделе «Типы датчиков».

Описание — любая дополнительная и необязательная информация.

Параметр — параметр, значения которого присылает устройство, например, in1, in2, hdop, gsm, и т.д. Можно выбрать параметр, предлагаемый в выпадающем списке, или вести данные вручную.

Дополнительно предусмотрена возможность использования в качестве параметров имена других датчиков. Это может быть полезно, если нужно вычислить итоговое значение на основе данных от других датчиков. Например, если на объекте установлено несколько датчиков топлива, и суммарную информацию по ним нужно вывести в один общий датчик.

Единица измерения — величина, в которой будут отображаться значения датчика, например, километры, вольты, тонны и т.д.

Валидатор — любой другой датчик объекта, контролирующий валидность данных основного датчика. Когда значение валидатора равно нулю, значения основного датчика считаются невалидными, и не учитываются в отчётах. Любые значения валидатора больше нуля пропускают сообщения основного датчика как корректные.

Например, устройство может присылать данные по скорости в то время, когда объект стоит на месте. Для решения этой проблемы можно использовать датчик зажигания в качестве валидатора датчика «акселерометр». В этом случае скорость будет учитываться только в том случае, если включено зажигание.

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

Таймаут — время в секундах, которое определяет валидность сообщений датчика. Если интервал между сообщениями больше, чем установленный таймаут, то сообщения в этом интервале не учитывается.

Таблица расчёта #

На вкладке «Таблица расчёта» доступна возможность добавления X и Y значений, для последующей генерации таблиц расчёта.

Таблицы расчёта используются для изменения или калибровки значений датчиков, например, для занесения тарировочных таблиц для датчиков уровня топлива.

Пары значений X и Y вносятся в правой части окна. С помощью кнопки «Сгенерировать» формируются значения X, A, и B в левой части окна.

В нижней части окна присутствуют два поля для указания нижней и верхней границы допустимых значений. Если необходимо ограничить значения датчика в рамках определённого диапазона, то нужно указать наименьшее и наивысшее из допустимых значений датчика в этих полях.

Применять после расчёта — опция, позволяющая переключать режим нижней и верхней границы с необработанных данных на обработанные.

  • Если опция не включена (по умолчанию), то данные для нижней и верхней границы нужно указывать в необработанном виде, т.е. именно так, как они приходят от устройства.
  • Если опция включена, то данные нужно указывать в обработанном (преобразованном, конечном) виде, например, в литрах, вольтах и т.д.

Арифметические операции #

С параметрами датчика можно выполнять арифметические операции, такие как сложение, вычитание, умножение, или деление. Ниже приведены примеры этих операций:

param1 + param2
param1 - param2
param1 * param2
param1 / const1000

Пробел между математическим оператором и параметрами не обязателен:

param1+param2
param1-param2
param1*param2
param1/const1000

Для определения последовательности выполнения арифметических операций можно использовать скобки приоритета:

(param1 − param2) / param3

Расширенные возможности #

Расширенные возможности в виде специальных слов и символов позволяют выполнять дополнительные манипуляции с данными. Для всех них доступны стандартные арифметические операторы, описанные выше.

const1000 — Константный параметр. Используется для изменения параметра на определённую величину. Величина указывается после ключевого слова const. В следующем примере параметр in1 будет умножен на 1000:

in1 * const1000

#param1 — Параметр из предыдущего сообщения. Используется для манипуляций с параметрами из предыдущего сообщения. В следующем примере из параметра in1 вычитается его предыдущее значение.

in1 - #in1

param1[2] — Побитовое извлечение, где 2 — номер бита. Используется для получения определённого бита из значения датчика.

[Название датчика] — Указав имя датчика в квадратных скобках можно использовать его для взаимодействия с другими датчиками. В следующем примере складываются два датчика уровня топлива для получения общего значения.

[Топливо бак1] + [Топливо бак2]

get(param1,param2) — Логический оператор «Или». Используется для получения первого существующего параметра по порядку. Количество параметров в функции через запятую не ограничено.

hex(param1) — Перевод из десятичной системы счисления в шестнадцатеричную.

slice(param1, const1, const2) — Получение диапазона символов, где const0 — начало диапазона, const10 — конец диапазона, param1 — имя параметра.
Например: из параметра param1=RUD0000002282403 нужно убрать первые три буквы чтобы значение начиналось с цифр, т.е. с четвёртого символа.

slice(param1,const3,const14)
00000022824 // Результат

Обратите внимание, что отсчёт для const начинается с нуля. То есть в значении «12345» число 1 = const0, а число 3 = const2.

Типы датчиков #

Пробег #

  • Одометр — датчик пробега. Единицы измерения: км, мили.

Цифровые #

Цифровые датчики могут иметь только 2 значения — 1 (вкл) или 0 (выкл)

  • Датчик зажигания — отображает состояние зажигания.
  • Произвольный цифровой датчик — любой цифровой датчик.
  • Датчик мгновенного определения движения.

Показатели #

  • Датчик напряжения — напряжение в вольтах.
  • Датчик веса — вес в тонах или фунтах.
  • Акселерометр — ускорение в g.
  • Датчик температуры — температура в цельсиях или в фаренгейтах.

Двигатель #

  • Датчик оборотов двигателя — количество оборотов двигателя в минуту.
  • Датчик полезной работы двигателя — время полезной работы двигателя в любых единицах измерения.
  • Абсолютные моточасы;
  • Относительные моточасы;

Топливо #

Датчики расхода и уровня топлива в литрах или галлонах.

  • Импульсный датчик расхода топлива — расход топлива основанный на подсчёте импульсов.
  • Датчик абсолютного расхода топлива — расход топлива за весь период эксплуатации.
  • Датчик мгновенного расхода топлива — расход топлива на основе сравнения текущих данных с данными предыдущего измерения.
  • Датчик уровня топлива — определяет объем уровня топлива в баке.

Другие #

  • Назначение водителя — предназначен для автоматического назначения водителя на объект.
  • Произвольный датчик — любой датчик с произвольными параметрами.
  • BLE датчик — bluetooth датчик с низким энергопотреблением.

Рассчитываемые датчики #

Рассчитываемый датчик — опция датчика «Одометр» или «Абсолютные моточасы», которая позволяет рассчитывать значения, даже если данные не поступают в параметрах с can-шины автомобиля.
В этом датчике можно рассчитывать данные не с нуля, а с заданного значения. Зачастую это значение — фактический пробег/фактическое значение моточасов объекта.

Моточасы

  • Метод расчёта — по зажиганию;
  • Текущее значение — необходимо указать текущее значение датчика;
  • Интервал расчёта — нужно выбрать раз в какое время будут сниматься показания по датчику. Раз в 1 час, 3 часа, 6 часов, 12 часов.

Одометр

  • Метод расчёта — можно выбрать GPS или GPS+датчик зажигания;
  • Текущее значение — необходимо указать текущее значение датчика;
  • Интервал расчёта — нужно выбрать раз в какое время будут сниматься показания по датчику. Раз в 5 минут, 15 минут, 30 минут или раз в 1 час;
  • Таймаут — интервал для отсечки неактуальных значений, например, из черного ящика.