Data sending methods
“Data recording” is responsible for structure of data, that being sent to MQTT broker.
It supports two methods of data structure - Simple and Extended.
In “Simple” - you can create packets, in “Extended” you can create separate sensors and set conditions and triggers to them. Meanwhile in “Simple” triggers can be set only to all packet, not separate sensors.
“Simple” - is recommended way to send data.
”Extended” - can be used in specific projects, when you need to track values of particular sensor, for example: temperatures, RPM, over-voltages or similar.
Note. Simple and Extended options can not be used simultaneously. If you set both - device would not send any data.
a) Simple data sending method.
You can create 4 different packets based on different conditions. To create a new packet, click on “+ Add” button. Also can check presets, created by XG team by clicking on “Import preset” button.
Signal conditions describes when this type of packet should be sent:
Speed, course, distance and time thresholds defines track quality settings.
Note. “GNSS register period” is responsible to how often device will send this kind of packet to server.
In “data register trigger” you can add additional triggers to send a message to server without waiting for “GNSS register period” to pass:
Into sensor list, you should add all sensors, which packet should include:
Maximum is 50 sensors.
b) Extended data sending method.
Using this method, you will receive only sensors created and nothing more. For example, if you have created temperature sensor, it will be sent alone, without coordinates, digital input sensors and so on. To send few sensors together - use the same timeout or link then together.
In “Sensor name” chose a parameter, which you want to send:
In “Signal conditions” you can set certain condition when it should be sent (for example IN5 On):
“Period” and “Threshold” - are the triggers of data sending. In case of “Period” - it’s time in seconds. In case of “Threshold” - it’s value of sensor.
“Link to sensor” let’s you send current parameter with any other, to which you link it.
Note. The most common use is to link all the sensors to “Sensor_GPS_coordinates (53248)” sensor. And set desired period in settings of Coordinates. Then in all other sensors - do not need to set any periods or thresholds.
“Registration type” lets you control data sending. When selected "Save to memory" (default) all data first saved into memory and after that sending to server firstly oldest data. When selected "Real time packed" sending current data to server without saving into memory.
“Value reset” is being used with cumulative parameters, counted by device. For example “odometer”. If you want data to be counted from 0 every time, need to enable this function:
“Real time packet trigger” lets make a group of sensors, which will be sent as a separate real time packet. Timeout of it can be controlled in Connectivity > Telemetry server > MQTT session parameters > Real time message period. All sensors marked as “Real time packet triggers” will be sent in one message:
Using “Extended” data sending method, you can create up to 200 sensors and their triggers.