Xirgo protocol
Integration level: params
Protocol used by GPS tracking devices manufactured by Xirgo Technologies headquartered in the USA.
flespi parses the Xirgo protocol messages into a JSON object with the
fields listed below in the Parameters tab.
absolute.acceleration
number
g
Module of accelerometer vector
absolute.deceleration
number
g
Module of deceleration value from accelerometer
ain
number
volts
Voltage on the analog input
average.fuel.consumption
number
liters/100km
Average fuel consumption
backup.battery.voltage
number
volts
Backup battery voltage
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.motorhours
number
hours
Total engine motorhours read from CAN
can.engine.oil.level
number
Engine oil level
can.engine.oil.temperature
number
celsius
Engine oil temperature
can.mil.status
boolean
Malfunction indicator lamp status 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.type.id
number
ID of device type of device that received a message
din
number
Digital inputs bitmask
dout
number
Digital outputs bitmask
engine.coolant.level
number
percentage
Engine coolant level
engine.coolant.pressure
number
Engine coolant pressure
engine.ignition.status
boolean
Engine ignition status
engine.motorhours
number
hours
Total calculated engine motorhours
engine.oil.pressure
number
Engine oil pressure
engine.rpm
number
rpm
Engine RPM read from CAN
event.enum
number
Event code, full list of codes available at separate table
external.powersource.voltage
number
volts
External power voltage
fuel.level
number
percentage
Fuel level percentage
gnss.state.enum
number
GNSS state code. May contain information about GNSS fix status, sleep status, ON/OFF, Overcurrent/protect state. Full list of codes available at separate table
gps.state.enum
number
GPS state
gsm.signal.level
number
percentage
GSM signal strength level
ident
string
Device unique identificator and optional password
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.fix.age
number
seconds
Time since the last position fix
position.hdop
number
Horizontal dilution of precision
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
protocol.id
number
ID of protocol
server.timestamp
number
seconds
Timestamp when server received a message
timestamp
number
seconds
Message timestamp
trip.mileage
number
km
Distance driven since engine start
vehicle.vin
string
VIN of vehicle
x.acceleration
number
g
Accelerometer value X
y.acceleration
number
g
Accelerometer value Y
z.acceleration
number
g
Accelerometer value Z
Tags
To connect your tracker using the Xirgo protocol, you need to have a xirgo 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 and use a 15-character IMEI (usually specified on the tracker casing) in the ident field.
Use the Toolbox tab on the device screen to check if the messages are coming.
To connect Xirgo to Wialon or another platform via flespi please read this article.