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

Чтобы создавать, изменять и удалять датчики, нужно использовать команду 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>
					}
			       ]}

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

• 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 - датчик мгновенного определения движения.

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

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

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

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

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

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

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

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

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

Замечание: 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>,
		\"text_params\":<uint>
	     }" 

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

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

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

Пример:

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

Уточнение по «calc_fuel», «fuel_params», engine_sensors, engine_efficiency: новые опции могут быть использованы опционально (если работать только через api), и старые запросы и логика по прежнему актуальны (но до тех пор пока не были выполнены изменения в конфигурации датчиков)

Параметр «calc_fuel» устанавливает флаг расчета расхода топлива для каждого типа датчика соответственно :

• «ignoreStayTimeout»:<uint>, /* игнорировать сообщения после начала движения, секунд */
• «minFillingVolume»:<double>, /* минимальный объем заправки, литров */
• «minTheftTimeout»:<uint>, /* минимальное время остановки для определения слива, секунд */
• «minTheftVolume»:<double>, /* минимальный объем слива, литров */
• «filterQuality»:<ubyte>, /* степень фильтрации (0..255) */
• «fillingsJoinInterval»:<uint>, /* таймаут для разделения заправок, секунд */
• «theftsJoinInterval»:<uint>, /* таймаут для разделения сливов, секунд */
• «extraFillingTimeout»:<uint> /* таймаут для определения полного объема заправки, секунд */

«flags» - флаги устанавливают остальные настройки расхода топлива по ДУТ :

Пример новых параметров в конфигурации: ДУТ «fuel_params»

"fuel_params":{\"flags\":1728,\"ignoreStayTimeout\":20,\"minFillingVolume\":21,\"minTheftTimeout\":0,\"minTheftVolume\":15,\"filterQuality\":0,\"fillingsJoinInterval\":300,\"theftsJoinInterval\":300,\"extraFillingTimeout\":0}.

ДМРТ «fuel_params»

 "fuel_params":{\"maxImpulses\":10, \"skipZero\":0}

• «maxImpulses»:<uint> - максимум импульсов
• «skipZero»:<bool> - пропускать начальные нулевые значения

Специальных настроек нет, «calc_fuel» - флаг для включения (нулевое значение - опция выключена) опции "Рассчитывать расход топлива по датчику":

• «calc_fuel»:8 для ДАРТ
• «calc_fuel»:32 для ДМРТ

Пример конфигурации ДМРТ

c: "{"act":1,"appear_in_popup":false,"calc_fuel":8,"ci":{},"cm":1,"fuel_params":{"flags":0},"mu":0,"pos":24,"show_time":false,"timeout":0}"

Расход топлива по расчету (Расход топлива: расход по расчету - старый метод) использует настройки датчиков моточасов (датчик зажигания и датчики двигателя)

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

[
	<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
]