Sensors: create, update and delete

To create, edit or delete sensors, use the command 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>
					}
			       ]}

Sensor flags:

Clarification for 0x20:
- actual for the next sensors:

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

If 0x20-flag is NOT set then sensor works as follows: delta of change is equal to abs(V2 - V1), where V2 – new message value, V1 – prev message value, abs() – absolute value; if flag is set, then when V2 < V1 delta is equal to V2 (i.e. V1 = 0).

Clarification for 0x40:

1. if flag unset: any bound is applied to raw data (in case of FLS there are difficulties with setting lower/upper bound for RAW data);
2. if flag is set: any bound is applied to calculated (processed) data.

Sensor types:

• absolute fuel consumption - absolute fuel consumption sensor;
• accelerometer - accelerometer;
• alarm trigger - alarm trigger;
• counter - counter sensor;
• custom - custom sensor;
• digital - custom digital sensor;
• driver - driver binding;
• engine efficiency - engine efficiency sensor;
• engine hours - absolute engine hours;
• engine operation - engine ignition sensor;
• engine rpm - engine revs sensor;
• fuel level impulse sensor - fuel level impulse sensor;
• fuel level - fuel level sensor;
• impulse fuel consumption - impulse fuel consumption sensor;
• instant fuel consumption - instant fuel consumption sensor;
• mileage - mileage sensor;
• odometer - relative odometer;
• private mode - private mode;
• relative engine hours - relative engine hours;
• temperature coefficient - temperature coefficient;
• temperature - temperature sensor;
• trailer - trailer binding;
• voltage - voltage sensor;
• weight sensor - weight sensor.
• tag - passenger sensor;
• real-time motion sensor - real-time motion sensor.

Here you can read more about sensor types.

Sensor configuration params:

Note: JSON-object is sent as a string, that's why it must be within double quotes, all key and value double quotes must be escaped (\“).

    	    "{
		\"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>
	     }" 

Clarification for “act”: inverted logic is used for that option: checked option (value 0) means historically older logic version, unchecked option (value 1) reters to newer logic version (data is used for popups, handy when important params are rare to come). Older logic version is chosen by default.

Clarification for “filter”:
- this option allows to redefine filtration level; valid for the next sensors:

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

Example:

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

Clarification for “calc_fuel”, “fuel_params”, engine_sensors, engine_efficiency - new parameters are optional to used. The previous requests and logic is still actual.

Example for fuel sensors with new parameters in configuration : FLS “fuel_params”

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

Impulse fuel consumption sensor “fuel_params”

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

Validation types:

On create and edit:

[
	<long>,		/* sensor ID */
	{
		"id":<long>,	/* sensor ID */
		"n":<text>,	/* name */
		"t":<text>,	/* type */
		"d":<text>,	/* description */
		"m":<text>,	/* metrics */
		"p":<text>,	/* parameter */
		"f":<uint>,	/* sensor flags */
		"c":<object>,	/* configuration */
		"vt":<int>,	/* validation type*/
		"vs":<long>,	/* validating sensor ID */
		"tbl":[			/* calculation table */
			{			/* parameters */
				"x":<double>, 
				"a":<double>,
				"b":<double>
			}
		]
	}
]

On delete:

[
	<long>,		/* sensor ID */
	null
]