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.

Make your Xirgo XG3700 XTCAN SDK devices a part of any infrastructure by connecting them via flespi telematics hub. Manage the device settings using flespi device management platform. Learn how to configure Xirgo XG3700 XTCAN SDK with flespi.

Protocol: xirgo-mqtt Manufacturer: Xirgo Global Change log: xirgo-mqtt

Usage specifics

Parameters (123)

Settings (7)

Commands (1)

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'

Explore REST API Show more ways to consume data How to connect my Xirgo XG3700 XTCAN SDK to flespi

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

Name

Type

Unit

Description

absolute.acceleration

number

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

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

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

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

Total vehicle mileage read from CAN

can.vehicle.mileage.high.resolution

number

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

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

Total mileage calculated by tacho

timestamp

number

seconds

Message timestamp

turn.acceleration

number

Acceleration on turn

vehicle.mileage

number

Total calculated mileage

wiegand.code

string

Wiegand26 RFID code

x.acceleration

number

Accelerometer value X

y.acceleration

number

Accelerometer value Y

z.acceleration

number

Accelerometer value Z

Title

Name

Description

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

Title

Name

Description

Properties

Custom command Examples

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"}

Xirgo XG3700 XTCAN SDK

Here’s the like of JSON you get

How to consume this nice JSON

How to send commands to Xirgo XG3700 XTCAN SDK?

You can also

Modify messages

Aggregate data

More devices from Xirgo Global (14)