= Произвольный датчик =

== Содержание ==
 * [#name Имя датчика]
 * [#group Группа датчика]
 * [#role Роль в системе]
 * [#port_type Тип порта ввода/вывода]
 * [#port_num Номер порта/источника телеметрии]
 * [#ratio_adjustment Коэффициент, поправка]
 * [#valid_from_to Диапазон валидных значений]

Для случаев, когда задача выходит за рамки предложенных типовых датчиков 
(консоль администратора → карточка транспортного средства → закладка «Типовые датчики»), 
есть возможность сконфигурировать любые источники телеметрии (произвольные датчики, источники событий и т.д.) в любом количестве.

Для этого в карточке транспортного средства в закладке «Произвольные датчики» нужно добавить необходимое количество датчиков и описать их. 

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

=== Имя датчика === #name
Каждый датчик имеет '''имя'''. Имя датчика используется в отчетах и графиках для визуального обозначения. В качестве имени произвольного датчика удобно указывать измеряемую величину и единицу измерения.

=== Группа датчика === #group
В карточке датчика может быть указана '''группа''' датчика. В зависимости от прикладной задачи, аналитика может группироваться по этому признаку. Например, для учета суммарного расхода топлива по двум топливным бакам, есть смысл указать у датчиков уровня топлива для этих баков одну и ту же группу, тогда в отчетах по расходу топлива будет дополнительно отображена информация по этой группе.

=== Роль в системе === #role
'''Роль''' датчика в системе позволяет включать показания датчика в ту или иную прикладную аналитику (например, учет топлива, учет работы механизмов и т.д.). Если ни одна из ролей не подходит, то следует выбрать роль «Неспециализированный датчик».

Но если необходимо сконфигурировать датчик уровня топлива, то нужно описывать его в системе не как [wiki:Sensor «Произвольный датчик»], а как специализированный [FuelLevelMeter «Датчик уровня топлива»], что позволит настраивать параметры тарировки и сглаживания первичных данных.

[=#port_num]
=== Тип и номер порта ввода/вывода или источника телеметрии === #port_type
Необходимо указать способ подключение датчика к трекеру. Физически, датчик может быть подключен к определенному порту трекера, либо находиться на шине, общей для нескольких датчиков, либо, датчиком можем называть любой источник телеметрической информации, которую необходимо контролировать. Для описания подключения служат параметры '''тип порта (шины)''' и '''номер порта (датчика, параметра)'''. 

'''Тип порта''' выбирается из списка поддерживаемых типов:

 Логический::
  порт трекера, работающий в логическом режиме и передающий системе одно из значений: 0 или 1. Типичное применение - подключение концевых замыкателей, различных кнопок, датчика зажигания и т.д.

 Аналоговый/частотный::
  порт трекера, передающий в систему произвольное числовое значение, соответствующее величине напряжения на этом входе или частоте сигнала (меандра, первой гармоники и т.д.). Типичное применение - подключение датчиков уровня топлива с аналоговым или частотным интерфейсом.

 Счетчик::
  порт, на котором трекер ведет нарастающий подсчет импульсов (фронтов). Типичное применение - подключение счетчиков пассажиропотока, тахометра.

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

 Цифровой RS485/232::
  порт для подключения устройств с соответствующим интерфейсом. Типичное применение - подключение датчиков уровня топлива с интерфейсом RS485, RS232.

 Цифровой CAREUCAN::
  порт трекера S&T Care-U U-CAN, подключенный к CAN шине и транслирующий ограниченный набор параметров. В качестве номера порта указывается номер параметра в соответствии с [wiki:CareUCAN таблицей].

 Цифровой OBD2/SAE J1979::
  порт трекера, получающий информацию из OBDII интерфейса автомобиля. В качестве номера порта указывается номер параметра (PID) в соответствии со спецификацией протокола SAE J1979 в десятичной форме. Набор стандартных параметров приведен тут: http://en.wikipedia.org/wiki/OBD-II_PIDs

 Цифровой CAN/FMS/SAE J1939::
  порт трекера, получающий информацию из CAN-шины автомобиля в соответствии с протоколом FMS или SAE J1939. В качестве номера порта указывается номер параметра (SPN), популярные номера приведены в [wiki:FMS_J1939_SPN таблице].

 Цифровой CANLOG::
  порт трекера, получающий информацию от устройства CAN-LOG, подключенного к CAN-шине автомобиля и передающий в систему определенный набор параметров. В качестве номера порта указывается номер параметра в соответствии с [wiki:CANLOG таблицей]

=== Коэффициент, поправка === #ratio_adjustment
'''Коэффициент''' и '''поправка''' используются для линейного преобразования значения датчика в условных отсчетах в измеряемую величину. Их можно рассматривать как параметры уравнения прямой y = Ax + C. Например, подключен расходомер, передающий 200 импульсов на каждый литр потраченного топлива. В этом случае коэффициент будет равен 0.005 (литров на импульс), поправка 0.

=== Диапазон валидных значений === #valid_from_to
Датчику можно задать ограниченный '''диапазон валидных значений'''. Все значения вне этого диапазона игнорируются и трактуются как признак отключения датчика. Типичное применение - отсечение нулевых и максимальных значений датчиков топлива и прочих датчиков, которые могут быть отключены при отключении зажигания/массы, в то время как трекер продолжает работать от аккумулятора.