Xirgo XG3700 XTCAN SDK

Xirgo XG3700 XTCAN SDK is an advanced vehicle GPS tracker with MQTT protocol support. The device features an SDK to craft unique scenarios and algorithms, MQTT-based data transfer, LTE connectivity, 2 simultaneous CAN-BUS connections, OBDII and CAN protocols of light vehicles, geofencing and overspeeding, fuel level sensors support, RFID / driver ID support, and a lot more.

Usage specifics
Parameters (123)
Settings (7)
Commands (1)
Xirgo XG3700 XTCAN SDK
Flespi parses telemetry data from your Xirgo XG3700 XTCAN SDK into a standardized JSON and lets you send commands to Xirgo XG3700 XTCAN SDK via API.

Here’s the like of JSON you get

{
    "ident": "352625333222111",
    "position.altitude": 273.61,
    "position.hdop": 0.7,
    "position.latitude": 49.069782,
    "position.longitude": 28.632826,
    "position.satellites": 18,
    "server.timestamp": 1650636570.426424,
    "timestamp": 1650636570.426424,
    "device.type.id": "Xirgo XG3700 XTCAN SDK",
    "channel.id": 1111,
    "protocol.id": "xirgo-mqtt"
    "engine.ignition.status": true
    ...
}

How to consume this nice JSON

The easiest way is to make a REST API request like this
curl -X GET  --header 'Authorization: FlespiToken XXX' 'https://flespi.io/gw/devices/<device id>/messages'

How to send commands to Xirgo XG3700 XTCAN SDK?

You can send a specific command. Show all commands
You can use pre-defined settings to send instructions more conveniently. Show all settings

You can also

Modify messages

Add or remove parameters, inject data from LBS and reverse-geocoding services, etc.
Learn what plugins can do

Aggregate data

Determine trips and stops, catch events, detect geofence ins/outs, and more.
Learn about flespi analytics capabilities
absolute.acceleration
number
g
Module of accelerometer vector
ain
number
volts
Voltage on the analog input
armed.status
boolean
Armed/disarmed status
battery.voltage
number
volts
Internal battery voltage
can.abs.failure.indicator.status
boolean
ABS failure indicator status read from CAN
can.activity.status
boolean
CAN activity status: if there were messages received last 10 seconds on CAN1 or on CAN2.
can.adblue.level
number
percentage
AdBlue (diesel exhaust fluid) level read from CAN
can.airbag.fired.status
boolean
CAN airbag fired status
can.ambient.air.temperature
number
celsius
CAN ambient air temperature
can.axle.weight
number
kg
Weight on the axle read from CAN
can.bitrate
number
CAN bitrate
can.check.engine.status
boolean
CAN check engine warning is on
can.command.id
number
Command Identifier, that is used by canbase_b function on CAN
can.coolant.level.low.indicator.status
boolean
Coolant level low indicator status read from CAN
can.cruise.state
number
Cruise control state
can.cruise.status
boolean
CAN cruise control is active
can.driver.seatbelt.indicator.status
boolean
Driver seatbelt indicator status read from CAN
can.dtc
string
Diagnostic trouble code read from CAN
can.electronic.power.control.status
boolean
Electronic power constrol status, read from CAN
can.engine.coolant.temperature
number
celsius
Engine coolant temperature read from CAN
can.engine.fuel.rate
number
liters/h
Engine fuel rate read from CAN
can.engine.load.level
number
percentage
Calculated engine load level read from CAN
can.engine.motorhours
number
hours
Total engine motorhours (engine work time) read from CAN
can.engine.rpm
number
rpm
Engine RPM read from CAN
can.esp.status
boolean
CAN ESP warning is on
can.front.left.door.status
boolean
CAN front left door is opened
can.front.right.door.status
boolean
CAN front right door is opened
can.fuel.consumed
number
liters
Fuel volume totally consumed by vehicle read from CAN
can.fuel.consumed.high.resolution
number
liters
Fuel volume totally consumed by vehicle calculated with high resolution (HRLFC), read from CAN
can.fuel.consumption
number
liters/h
Engine fuel rate read from CAN
can.fuel.economy
number
km/liters
CAN instantaneous fuel economy
can.gear
number
Current gear read from CAN. Numeric negative values are reverse gears, positive values are forward gears, zero is neutral
can.gross.combination.vehicle.weight
number
kg
Gross combination vehicle weight read from CAN
can.handbrake.status
boolean
CAN handbrake is pulled up
can.j1979.engine.coolant.temperature
number
celsius
CAN J1979 engine coolant temperature
can.j1979.engine.fuel.rate
number
liters/h
CAN J1979 Engine fuel rate
can.j1979.engine.rpm
number
rpm
CAN J1979 Engine RPM
can.master.warning.light.status
boolean
Status of master warning light, read from CAN
can.messages.missed
number
Counter of missed messages from CAN bus
can.messages.received
number
Counter of received messages from CAN bus
can.passenger.seatbelt.indicator.status
boolean
Passenger seatbelt indicator status read from CAN
can.pedal.brake.status
boolean
CAN brake pedal pressed
can.pto.status
boolean
Power take-off status, read from CAN
can.rear.left.door.status
boolean
CAN rear left door is opened
can.rear.right.door.status
boolean
CAN rear right door is opened
can.retarder.selection
number
percentage
Retarder selection read from CAN
can.retarder.torque.load
number
percentage
Retarder torque load percentage read from CAN
can.retarder.torque.mode
number
Retarder torque mode read from CAN
can.service.mileage
number
km
Service distance read from CAN
can.throttle.pedal.level
number
percentage
Throttle pedal push level read from CAN
can.tire.pressure.status
boolean
CAN tire pressure warning is on
can.trunk.status
boolean
CAN trunk is opened
can.vehicle.mileage
number
km
Total vehicle mileage read from CAN
can.vehicle.mileage.high.resolution
number
km
Total vehicle mileage calculated with high resolution (VDHR), read fomr CAN
can.wheel.speed
number
km/h
Vehicle wheel based speed, read from CAN
channel.id
number
ID of channel that received a message
counter.impulses
number
Impulses counter
device.firmware.version
string
Firmware revision
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
driver.id
string
Driver identification card id
engine.ignition.status
boolean
Engine ignition status
event.enum
number
Protocol-specific event code
event.function
number
Event function
external.powersource.voltage
number
volts
External power voltage
fuel.sensor.value
number
Value reported by fuel sensor
geofence.id
number
Geofence ID
geofence.status
boolean
Geofence entered status
gnss.signal.weak.status
boolean
GNSS signal weak
gprs.status
boolean
GPRS mobile network status
gsm.cellid
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) base station ID
gsm.jamming.alarm.status
boolean
Alarm status for the Mobile network (GSM, 3G, 4G, LTE, 5G, ...) jamming
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
gsm.network.status
boolean
Registration status in the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)
gsm.signal.dbm
number
dbm
Strength of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal
gsm.sim.iccid
string
Integrated Circuit Card Id of SIM card of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)
headlight.status
boolean
Headlights status
ibutton.code
string
Hexadecimal code of connected iButton
ibutton.connected.status
boolean
iButton connection status
ident
string
Device unique identifier like serial number, IMEI, etc
locked.status
boolean
Locked/unlocked status
movement.status
boolean
Current movement state
onewire.sensor.temperature
number
celsius
External 1-Wire temperature sensor value
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.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
script.name
string
Script name
sensor.boolean.value
boolean
User-defined sensor boolean value
sensor.float.value
number
User-defined sensor float value
sensor.frequency
number
hz
Frequency sensor value
sensor.int16.value
number
User-defined 2 bytes sensor value stored as int16, indexed parameter
sensor.int32.value
number
User-defined 4 bytes sensor value stored as int32, indexed parameter
sensor.int8.value
number
User-defined 1 byte sensor value stored as int8, indexed parameter
sensor.static.signal
boolean
User defined Static Signal flag, indexed parameter
sensor.string.value
string
User-defined sensor string value
sensor.uint16.value
number
User-defined 2 bytes sensor value stored as uint16, indexed parameter
sensor.uint32.value
number
User-defined 4 bytes sensor value stored as uint32, indexed parameter
sensor.uint64.value
number
User-defined 8 bytes sensor value stored as uint64, indexed parameter
sensor.uint8.value
number
User-defined 1 byte sensor value stored as uint8, indexed parameter
server.timestamp
number
seconds
Timestamp when server received a message
tacho.slot.activity
number
Slot activity from tachograph
tacho.slot.distance
number
Slot distance from tachograph
tacho.slot.time
number
Slot time from tachograph
tacho.timestamp
number
seconds
Time reported by tacho
tacho.vehicle.mileage
number
km
Total mileage calculated by tacho
timestamp
number
seconds
Message timestamp
turn.acceleration
number
g
Acceleration on turn
vehicle.mileage
number
km
Total calculated mileage
wiegand.code
string
Wiegand26 RFID code
x.acceleration
number
g
Accelerometer value X
y.acceleration
number
g
Accelerometer value Y
z.acceleration
number
g
Accelerometer value Z
Properties
Output 1
output1
Output 1 control
ttl: Time to Live
enable: Enable
timeout: Timeout
Output 2
output2
Output 2 control
ttl: Time to Live
enable: Enable
timeout: Timeout
Signal 1
signal1
Static Signal 1 Control
ttl: Time to Live
enable: Enable
Signal 2
signal2
Static Signal 2 Control
ttl: Time to Live
enable: Enable
Signal 3
signal3
Static Signal 3 Control
ttl: Time to Live
enable: Enable
Signal 4
signal4
Static Signal 4 Control
ttl: Time to Live
enable: Enable
Signal 5
signal5
Static Signal 5 Control
ttl: Time to Live
enable: Enable
Properties
Custom command
custom
Send custom command to device
ttl: Command time to live in seconds
output: Output ID
payload: Hex data to be sent to the device
Send script remote command
{"output":13,"payload":"616E792062696E617279207061796C6F6164"}