Xexun protocol

Protocol used by GPS tracking devices manufactured by Xexun headquartered in China.
flespi parses the Xexun protocol messages into a JSON object with the fields listed below in the Parameters tab.

To connect your tracker using the Xexun protocol, you need to have a xexun channel created first.

Point your tracker to the channel's domain name:port via SMS or configuration tool provided by the vendor.

Then create a device instance for your tracker using the identifier specified on the tracker casing in the ident field — it can be either a 15-character IMEI or a 12-character identifier (0 + 11 last digits of IMEI). You can check which type of identifier your device has in the channel Toolbox.

Use the Toolbox tab on the device screen to check if the messages are coming.

If the messages in Toolbox are colored red (past) or grey (future), try changing the timezone setting via the SMS command.

acc.alarm
boolean
ACC alarm event
alarm.code
number
Protocol-specific alarm code number
alarm.event
boolean
Alarm event triggered
arm.status
boolean
Device arm status (true - device armed, false - device disarmed)
battery.balanced.status
boolean
Battery balanced status
battery.capacity
number
Ah
Nominal battery capacity
battery.capacity.full
number
Ah
Full battery capacity
battery.capacity.remaining
number
Ah
Remaining battery capacity
battery.charge.equilibrium.ratio
number
percentage
Battery charing equilibrium ratio
battery.charge.overcurrent.status
boolean
Charge overcurrent status
battery.charge.propection.current
number
amperes
Battery charge protection current
battery.charge.protection.voltage
number
volts
Battery charge protection voltage
battery.charge.recovery.voltage
number
volts
Battery charge recovery voltage
battery.charge.switch.status
boolean
Battery charge switch status
battery.charging.propection.failure.status
boolean
Battery charging protection failure status, true means failure, false mean normal operation
battery.charging.status
boolean
Battery charging status
battery.current
number
amperes
Battery current
battery.cycle.index
number
Battery cycle index
battery.discharge.overcurrent.status
boolean
Discharge overcurrent status
battery.discharge.peak.propection.current
number
amperes
Battery discharge peak protection current
battery.discharge.propection.current
number
amperes
Battery discharge and overcurrent protection current
battery.discharge.propection.delay
number
seconds
Battery discharge protection time delay
battery.discharge.protection.voltage
number
volts
Battery discharge protection voltage
battery.discharge.recovery.voltage
number
volts
Battery discharge recovery voltage
battery.discharge.switch.status
boolean
Battery discharge switch status
battery.discharging.propection.failure.status
boolean
Battery discharging protection failure status, true means failure, false mean normal operation
battery.drop.line.status
boolean
Battery drop line status
battery.equalization.accuracy
number
mV
Battery equalization accuracy
battery.equalization.protection.temperature
number
celsius
Battery equalized temperature protection value
battery.equalization.voltage
number
volts
Battery equalize the start-up and control voltage
battery.equalizer.switch.status
boolean
Battery equalizer switch status
battery.level
number
percentage
Internal battery level
battery.low.alarm
boolean
Battery low alarm event
battery.low.capacity.status
boolean
Low capacity status
battery.mos.tube.protection.temperature
number
celsius
Battery MOS tube temperature protection value
battery.mos.ultra.temperature.status
boolean
MOS ultra-temperature status
battery.number
number
The number of batteries
battery.overheating.status
boolean
Battery overheating, false means normal temperature, true - battery overheated
battery.protection.temperature
number
celsius
Battery temperature protection value
battery.recovery.temperature
number
celsius
Battery temperature recovery value
battery.residual.capacity.alarm.threshold
number
percentage
Battery residual capacity alarm value
battery.special.charge.switch.status
boolean
Battery special charge switch status
battery.temperature
number
celsius
Battery temperature
battery.temperature.probes
number
Battery temperature probes
battery.voltage
number
volts
Internal battery voltage
can.dtc
array
Diagnostic trouble code array 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.imei
string
IMEI of the device
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.blocked.status
boolean
Engine blocked status (fuel cutoff relay), true - engine is blocked, false - engine isn't blocked
engine.ignition.status
boolean
Engine ignition or ACC status
equilibrium.plate.temperature
number
celcius
Equilibrium.plate.temperature
event.code
string
Protocol-specific event code string
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
gsm.cellid
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) base station ID
gsm.lac
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) location area code
gsm.mcc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) country code
gsm.mnc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) code
ident
string
Device unique identifier like serial number, IMEI, etc
low.speed.alarm
boolean
Vehicle speed is below lower threshold alarm event
movement.event
boolean
Movement detected
overspeeding.event
boolean
Overspeeding detected
payload.text
string
Text Payload received from device
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
power.plate.temperature
number
celcius
Power plate temperature
protocol.id
number
ID of protocol
server.timestamp
number
seconds
Timestamp when server received a message
sos.alarm
boolean
SOS alarm triggerred
timestamp
number
seconds
Message timestamp
total.voltage
number
volts
Total voltage of the electric vehicle
towing.event
boolean
Towing event detected
vehicle.factory.date
string
Vehicle date written on factory information board
vehicle.factory.number
number
Vehicle number written on factory information board
vehicle.mileage
number
km
Total calculated mileage
vibration.alarm
boolean
Vibration alarm event
Properties
Custom Command
custom
Send custom command to device
payload: Command payload
Cut OFF restore and electricity of the car [123456 - device password]
{"payload":"powercar123456 11"}
Cut OFF oil and electricity of the car to stop the car [123456 - device password]
{"payload":"powercar123456 00"}