Датчики: создание, редактирование и удаление

Чтобы создавать, изменять и удалять датчики, нужно использовать команду unit/update_sensor:

svc=unit/update_sensor&params={"itemId":<long>,
			       "id":<long>,
			       "callMode":<text>,
			       "unlink":<uint>,
			       "n":<text>,
			       "t":<text>,
			       "d":<text>,
			       "m":<text>,
			       "p":<text>,
			       "f":<uint>,
			       "c":<text>,
			       "vt":<uint>,
			       "vs":<long>,
			       "tbl":[	
					{
						"x":<double>,
						"a":<double>,
						"b":<double>
					}
			       ]}

Флаги датчика:

Уточнение для 0x20: - актуально для следующих датчиков:

• mileage;
• absolute fuel consumption;
• engine hours.

Если флаг 0x20 не задан, то датчик работает так: дельта изменения будет равна abs(V2 - V1), где V2 – новое сообщение, V1 – предыдущее, abs() – модуль числа; если флаг задан, то при V2 < V1 дельтой будет считаться V2 (т.е. V1 = 0).

Уточнение для 0x40:

1. если флаг не указан: граница применяется к сырым данным (в случае с ДУТ могут быть проблемы с указанием границ к сырым данным);
2. если флаг указан: граница будет применена к данным, полученным после преобразования.

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

• absolute fuel consumption - датчик абсолютного расхода топлива;
• accelerometer - акселерометр;
• alarm trigger - тревожная кнопка;
• counter - счетчик;
• custom - произвольный датчик;
• digital - произвольный цифровой датчик;
• driver - привязка водителя;
• engine efficiency - датчик полезной работы двигателя;
• engine hours - абсолютные моточасы;
• engine operation - датчик зажигания;
• engine rpm - датчик оборотов двигателя;
• fuel level impulse sensor - импульсный датчик уровня топлива;
• fuel level - датчик уровня топлива;
• impulse fuel consumption - импульсный датчик расхода топлива;
• instant fuel consumption - датчик мгновенного расхода топлива;
• mileage - датчик пробега;
• odometer - относительный одометр;
• private mode - частный режим;
• relative engine hours - относительные моточасы;
• temperature coefficient - коэффициент температуры;
• temperature - датчик температуры;
• trailer - привязка прицепа;
• voltage - датчик напряжения;
• weight sensor - датчик веса;
• tag - датчик пассажира;
• real-time motion sensor - датчик мгновенного определения движения.

Здесь можно прочитать о типах датчиков подробно.

Параметры конфигурации датчика:

Замечание: JSON-объект передается как строка, потому необходимо заключить его в кавычки, все двойные кавычки для ключей и значений необходимо экранировать (\«).

    	    "{
		\"act\":<bool>,
		\"appear_in_popup\":<bool>,
		\"ci\":<object>,
		\"filter\":<long>,
		\"mu\":<uint>,
		\"pos\":<uint>,
		\"show_time\":<bool>,
		\"unbound_code\":<text>,
		\"validate_driver_unbound\":<bool>,
		\"timeout\":<uint>,
		\"uct\":<bool>,
		\"lower_bound\":<double>,
		\"upper_bound\":<double>
	     }" 

Уточнение для «act»: для этой опции использована инверсивная логика: выбранная галочка (значение 0) – это исторически старая логика, а выключенная опция (значение 1) – это более новая логика (данные используются во всплывающих подсказках, удобны в ситуациях, когда некоторые важные параметры редко приходят). Старая логика всё так же активна по умолчанию.

Уточнение для «filter»:
- опция позволяет переопределить степень фильтрации (ширину окна медианной фильтрации), валидна для датчиков:

• fuel level;
• temperature;
• engine rpm;
• voltage;
• accelerometer;
• custom;
• weight

Пример:

"c":"{\"appear_in_popup\":true,\"pos\":1,\"ci\":{}}"

Типы валидации:

При создании и редактировании:

[
	<long>,		/* ID датчика */
	{
		"id":<long>,	/* ID датчика */
		"n":<text>,	/* название */
		"t":<text>,	/* тип */
		"d":<text>,	/* описание */
		"m":<text>,	/* единица измерения */
		"p":<text>,	/* параметр */
		"f":<uint>,	/* флаги датчика */
		"c":<object>,	/* конфигурация */
		"vt":<int>,	/* тип валидации */
		"vs":<long>,	/* ID валидирующего датчика */
		"tbl":[			/* таблица расчета */
			{			/* параметры */
				"x":<double>, 
				"a":<double>,
				"b":<double>
			}
		]
	}
]

При удалении:

[
	<long>,		/* ID датчика */
	null
]