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 boolean ACC alarm event
alarm.event boolean Alarm event triggered
battery.charging.status boolean Battery charging status
battery.low.alarm boolean Battery low alarm event
battery.voltage number volts Internal battery voltage
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 Calculated 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 a message
device.id number ID of device that received a message
device.name string Name of device that received a message
device.temperature number celsius Temperature of device
device.type.id number ID of device type of device that received a message
door.alarm boolean Door alarm event
door.open.status boolean Door open status
engine.ignition.status boolean Engine ignition status
fuel.alarm boolean Fuel alarm event
fuel.level number percentage Fuel level percentage
geofence.alarm boolean Geofence alarm event
gnss.status boolean GNSS receiver on/off status
gps.rollover.timestamp number seconds Received timestamp. Message timestamp calculated by shifting this value forward for 1024 weeks to solve GPS Rollover problem.
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
oil.power.cut.off.event boolean Oil and power cut off event occured, when vehicle speed was less than 20 km/h
oil.power.cut.off.status boolean Oil and power cut off status, true - cut off, false - restored
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.satellites number Quantity of satellites used to calculate coordinates for given position information
position.speed number km/h Instant speed at position detection moment
position.valid boolean Is position information accurate and valid for given timestamp
power.off.alarm boolean Power of alarm event
power.on.status boolean Power-on device status
protocol.id number ID of protocol
server.timestamp number seconds Timestamp when server received a message
timestamp number seconds Message timestamp
vehicle.mileage number km Total calculated mileage
vibration.alarm boolean Vibration alarm event