xexun

The protocol for Xexun GPS tracking devices.

Below is the list of parameters that can appear in the messages received by the channel via xexun protocol. In most parameters, the name consists of tags split by dots: tag1.tag2.tag3.tag4... Each tag defines a certain area of an application, e.g. any parameter that contains mileage data has the 'mileage' tag in the name and any parameter related to fuel control contains the 'fuel' tag. By default JSON fields of the message received by a channel via this protocol can only contain the below-specified parameters. Any additional parameter will be prefixed by the "custom" tag, e.g. "custom.unspecified-name".

Name Type Unit Description
acc.alarm.event boolean ACC alarm event trigerred
acc.event boolean ACC state changed event, true - ACC ON, false - ACC OFF
can.dtc string Diagnostic trouble code read from CAN
can.engine.coolant.temperature number celsius Engine coolant temperature read from CAN
can.engine.load.level number percentage Engine load level read from CAN
can.engine.rpm number rpm Engine RPM read from CAN
can.fuel.consumption number liters/h Engine fuel rate read from CAN
can.fuel.consumption.distance number liters/100km Fuel consumption read from CAN
can.onboard.power.voltage number volts CAN onboard power voltage
can.throttle.pedal.level number percentage Throttle pedal push level read from CAN
can.total.driving.time number hours Engine run time read from CAN
can.vehicle.mileage number km Total vehicle mileage read from CAN
can.vehicle.speed number km/h Vehicle speed read from CAN
channel.id number ID of channel that received message
device.id number ID of device that received message
device.name number Name of device that reveiced message
device.temperature number celsius Temperature of device
device.type.id number ID of device type of device that recevied message
door.open.status boolean Door open status
engine.ignition.status boolean Engine ignition status
fuel.level number percentage Fuel level percentage
gnss.status boolean GNSS receiver on/off status
gsm.cellid number GSM base station ID
gsm.lac number GSM location area code
gsm.mcc string GSM mobile country code
gsm.mnc string GSM mobile network code
gsm.signal.dbm number dbm Strength of GSM signal
ident string Device unique identificator and optional password
movement.event boolean Movement detected
overspeeding.event boolean Overspeeding detected
peer string IP:port from which device connecting to the channel
position.altitude number meters Altitude value for position
position.direction number degrees Heading angle at position detection moment
position.latitude number degrees Latitude coordinate value
position.longitude number degrees Longitude coordinate value
position.speed number km/h Instant speed at position detection moment
position.valid boolean Is position information accurate and valid for given timestamp
power.on.status boolean Power-on device status
protocol.id number ID of protocol
server.timestamp number seconds Timestamp when server received message
timestamp number seconds Message timestamp
vehicle.mileage number km Total calculated mileage