Xirgo XT-4970

Xirgo XT-4970 is a solar harvesting LTE platform long-term remote deployments and logistics solutions. The device features configurable reporting frequency and event triggers, geofencing, configurable I/O, a high-efficiency solar panel, built-in Li-ion battery, IP67 water-resistant casing, and more.

Make your Xirgo XT-4970 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 XT-4970 with flespi.

Protocol: xirgo Manufacturer: Xirgo Technologies Change log: xirgo

Usage specifics

Parameters (116)

Settings (2)

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 XT-4970",
    "channel.id": 1111,
    "protocol.id": "xirgo"
    "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 XT-4970 to flespi

How to send commands to Xirgo XT-4970?

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

Sources

absolute.acceleration

number

Module of accelerometer vector

Event 4006,
Event 6004,
Event 6011,
Event 6015,
Event 6034,
Event 6036

absolute.deceleration

number

Module of deceleration value from accelerometer

Event 4006,
Event 6004,
Event 6011,
Event 6015,
Event 6034,
Event 6036

acceleration.end.direction

number

Acceleration end direction

Param ID 0x24 (Binary protocol)

acceleration.end.latitude

number

Latitude point at which the acceleration ended

Param ID 0x21 (Binary protocol)

acceleration.end.longitude

number

Longitude point at which the acceleration ended

Param ID 0x22 (Binary protocol)

acceleration.end.speed

number

Acceleration end speed

Param ID 0x23 (Binary protocol)

acceleration.end.timestamp

number

Acceleration end time

Param ID 0x20 (Binary protocol)

acceleration.start.direction

number

Acceleration start direction

Param ID 0x1D (Binary protocol)

acceleration.start.latitude

number

Latitude point from which acceleration began

Param ID 0x1A (Binary protocol)

acceleration.start.longitude

number

Longitude point from which acceleration began

Param ID 0x1B (Binary protocol)

acceleration.start.speed

number

Acceleration start speed

Param ID 0x1C (Binary protocol)

acceleration.start.timestamp

number

Acceleration start time

Param ID 0x19 (Binary protocol)

ain

number

volts

Voltage on the analog input

Event 4006,
Event 6004,
Event 6015,
Param ID 0x66 (Binary protocol),
Param ID 0xc9 (Binary protocol)

average.fuel.consumption

number

liters/100km

Average fuel consumption

Event 4006,
Event 6004,
Event 6011,
Event 6015,
Event 6036,
Param ID 0x7D (Binary protocol)

backup.battery.voltage

number

volts

Backup battery voltage

Event 4001,
Event 4002,
Event 4003,
Event 4004,
Event 4006,
Event 6004,
Event 6011,
Event 6012,
Event 6013,
Event 6014,
Event 6015,
Event 6034,
Event 6084

battery.voltage

number

volts

Internal battery voltage

Event 4001,
Event 4002,
Event 4003,
Event 4004,
Event 4006,
Event 6004,
Event 6011,
Event 6012,
Event 6013,
Event 6014,
Event 6015,
Event 6034,
Event 6036,
Event 6084,
Param ID 0x16 (Binary protocol),
Param ID 0xc8 (Binary protocol)

bluetooth.connected.status

boolean

Bluetooth connection status

Param ID 0x52 (Binary protocol)

can.accelerator.pedal.position

number

percentage

Accelerator pedal position read from CAN, index 1 - sensor D, index 2 - sensor E, etc

Param ID 0x7E (Binary protocol)

can.drive.gear.status

boolean

CAN drive gear is on

Param ID 0x79 (Binary protocol)

can.dtc

string

Diagnostic trouble code read from CAN

Event 6044,
Event 6045

can.engine.coolant.level

number

percentage

Engine coolant level read from CAN

Event 4006,
Event 6004,
Event 6015,
Param ID 0x86 (Binary protocol)

can.engine.coolant.pressure

number

kPa

Engine coolant pressure

Event 4006,
Event 6004,
Event 6015,
Param ID 0x83 (Binary protocol)

can.engine.coolant.temperature

number

celsius

Engine coolant temperature read from CAN

Event 4006,
Event 6004,
Event 6015,
Param ID 0x59 (Binary protocol)

can.engine.ignition.status

boolean

CAN engine ignition status

Param ID 0x2C (Binary protocol),
Param ID 0xd7 (Binary protocol)

can.engine.load.level

number

percentage

Calculated engine load level read from CAN

Event 4006,
Event 6004,
Event 6015,
Param ID 0x7F (Binary protocol)

can.engine.motorhours

number

hours

Total engine motorhours (engine work time) read from CAN

Event 4006,
Event 6004,
Event 6015,
Param ID 0x56 (Binary protocol),
Param ID 0xd6 (Binary protocol)

can.engine.oil.level

number

percentage

Engine oil level read from CAN

Event 4006,
Event 6004,
Event 6015,
Param ID 0x81 (Binary protocol)

can.engine.oil.pressure

number

kPa

CAN Engine oil pressure

Param ID 0x82 (Binary protocol)

can.engine.oil.temperature

number

celsius

Engine oil temperature read from CAN

Event 4006,
Event 6004,
Event 6015,
Event 6034,
Param ID 0x7B (Binary protocol)

can.engine.rpm

number

rpm

Engine RPM read from CAN

Param ID 0x58 (Binary protocol)

can.engine.status

boolean

Engine is runninng status, read from CAN

Param ID 0x2C (Binary protocol)

can.engine.torque.level

number

percentage

Engine torque level read from CAN

Param ID 0x80 (Binary protocol)

can.fuel.consumed

number

liters

Fuel volume totally consumed by vehicle read from CAN

Param ID 0x55 (Binary protocol),
Param ID 0x5E (Binary protocol)

can.fuel.level

number

percentage

Fuel level in tank read from CAN

Param ID 0x5A (Binary protocol)

can.fuel.temperature

number

celsius

Fuel temperature read from CAN

Param ID 0x7A (Binary protocol)

can.gear

number

Current gear read from CAN. Numeric negative values are reverse gears, positive values are forward gears, zero is neutral

Param ID 0x79 (Binary protocol)

can.intake.air.temperature

number

celsius

Intake air temperature

Param ID 0x84 (Binary protocol)

can.intake.manifold.temperature

number

celsius

Intake manifold temperature

Param ID 0x85 (Binary protocol)

can.mil.status

boolean

Malfunction indicator lamp status read from CAN

Event 6045

can.neutral.gear.status

boolean

CAN neutral gear is on

Param ID 0x79 (Binary protocol)

can.park.gear.status

boolean

CAN park gear status

Param ID 0x79 (Binary protocol)

can.powesource.takeof.duration

number

hours

PTO total duration read from CAN

Param ID 0x71 (Binary protocol)

can.pto.status

boolean

Power take-off status, read from CAN

Param ID 0x2C (Binary protocol)

can.reverse.gear.status

boolean

CAN reverse gear is on

Param ID 0x79 (Binary protocol)

can.seatbelt.status

boolean

Seatbelt status read from CAN, false - the belt is not buckled, true - the belt is buckled

Param ID 0xc7 (Binary protocol)

can.throttle.position

number

percentage

Absolute throttle position for corresponding throttle position sensor read from CAN

Param ID 0x7C (Binary protocol)

can.total.cruise.control.time

number

hours

Total driving time when cruise control is ON, read from CAN

Param ID 0x5C (Binary protocol)

can.total.driving.time

number

hours

Engine run time read from CAN

Param ID 0x5B (Binary protocol),
Param ID 0xD5 (Binary protocol)

can.total.engine.idle.time

number

hours

Time of engine running in idling status (vehicle stopped) since vehicle manufacture, read from CAN

Param ID 0x5D (Binary protocol)

can.vehicle.harsh.acceleration

number

km/h

Read from CAN. Acceleration of a vehicle

Param ID 0x93 (Binary protocol)

can.vehicle.harsh.braking

number

km/h

Read from CAN. Braking of a vehicle

Param ID 0x94 (Binary protocol)

can.vehicle.speed

number

km/h

Vehicle speed read from CAN

Param ID 0x57 (Binary protocol)

channel.id

number

ID of channel that received a message

device.firmware.version

string

Firmware revision

Param ID 0x73 (Binary protocol)

device.id

number

ID of device that received a message

device.imei

string

IMEI of the device

Param ID 0x95 (Binary protocol)

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

Event 4006,
Event 6004,
Event 6015,
Event 6034,
Param ID 0x0C (Binary protocol),
Param ID 0x53 (Binary protocol),
Param ID 0xd7 (Binary protocol)

dout

number

Digital outputs bitmask

Event 4006,
Event 6004,
Event 6015,
Param ID 0x0D (Binary protocol)

driver.id

string

Driver identification card id

Param ID 0x0E (Binary protocol),
Param ID 0x0F (Binary protocol)

engine.ignition.status

boolean

Engine ignition or ACC status

Event 4006,
Event 6015,
Event 6034

engine.motorhours

number

hours

Total calculated engine motorhours

Event 4001,
Event 4002,
Event 4003,
Event 4004,
Event 6011,
Event 6012,
Event 6013,
Event 6014

engine.oil.pressure

number

Engine oil pressure

Event 4006,
Event 6004,
Event 6015

engine.rpm

number

rpm

Engine RPM read

Event 4006,
Event 6004,
Event 6011,
Event 6015,
Event 6036

event.enum

number

Protocol-specific event code

Param ID 0x04 (Binary protocol)

external.powersource.voltage

number

volts

External power voltage

Event 4001,
Event 4002,
Event 4003,
Event 4004,
Event 4006,
Event 6004,
Event 6011,
Event 6012,
Event 6013,
Event 6014,
Event 6015,
Event 6034,
Event 6084

external.powersource.voltage.status

boolean

Voltage of external supply is normal (true - inside the predefined range) or abnormal (false - outside of the predefined range)

Param ID 0x53 (Binary protocol)

fuel.level

number

percentage

Fuel level percentage

Event 4006,
Event 6004,
Event 6011,
Event 6015,
Event 6036

garmin.status

boolean

Garmin FMI module status

Param ID 0x52 (Binary protocol)

geofences.ids.bitmask

number

Geofences ids bitmask

Param ID 0xcc (Binary protocol),
Param ID 0xcd (Binary protocol)

gnss.fix.status

boolean

GNSS fix status

Param ID 0x52 (Binary protocol)

gnss.state.enum

number

Protocol-specific GNSS state code. May contain information about GNSS fix status, sleep status, ON/OFF, Overcurrent/protect state.

Event 4006,
Event 6004,
Event 6011,
Event 6015,
Event 6034,
Event 6036

gnss.status

boolean

GNSS receiver on/off status

Param ID 0x52 (Binary protocol)

gps.state.enum

number

GPS state

Event 4001,
Event 4002,
Event 4003,
Event 4004,
Event 4006,
Event 6004,
Event 6011,
Event 6012,
Event 6013,
Event 6014,
Event 6015,
Event 6045,
Event 6084

gsm.module.status

boolean

Mobile network (GSM, 3G, 4G, LTE, 5G, ...) module is ON

Param ID 0x52 (Binary protocol)

gsm.network.type

string

The type of the Mobile network the device is currently registered to

Param ID 0xd4 (Binary protocol)

gsm.signal.level

number

percentage

Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal strength level

Event 4001,
Event 4002,
Event 4003,
Event 4004,
Event 4006,
Event 6004,
Event 6011,
Event 6012,
Event 6013,
Event 6014,
Event 6015,
Event 6034,
Event 6036,
Event 6084

gsm.signal.quality

number

The quality (bit error rate) of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal

Param ID 0x14 (Binary protocol)

harsh.acceleration.duration

number

seconds

Harsh acceleration event duration

Param ID 0x1F (Binary protocol)

ident

string

Device unique identifier like serial number, IMEI, etc

ignition.alarm

boolean

Ignition alarm

Param ID 0x53 (Binary protocol)

main.powersource.status

boolean

Main power supply connection status

Param ID 0x52 (Binary protocol),
Param ID 0xd7 (Binary protocol)

max.acceleration

number

Maximum accelerometer value

Param ID 0x1E (Binary protocol)

movement.status

boolean

Current movement state

Param ID 0x2C (Binary protocol),
Param ID 0x52 (Binary protocol),
Param ID 0xd7 (Binary protocol)

obd.state.enum

number

OBD communication status

Param ID 0x2D (Binary protocol)

peer

string

IP:port from which device connecting to the channel

position.altitude

number

meters

Altitude value for position

Event 4001,
Event 4002,
Event 4003,
Event 4004,
Event 4006,
Event 6004,
Event 6011,
Event 6012,
Event 6013,
Event 6014,
Event 6015,
Event 6034,
Event 6036,
Event 6044,
Event 6045,
Event 6071,
Event 6076,
Event 6084,
Param ID 0x09 (Binary protocol)

position.direction

number

degrees

Heading angle at position detection moment

Event 4001,
Event 4002,
Event 4003,
Event 4004,
Event 4006,
Event 6004,
Event 6011,
Event 6012,
Event 6013,
Event 6014,
Event 6015,
Event 6034,
Event 6036,
Event 6084,
Param ID 0x0A (Binary protocol)

position.fix.age

number

seconds

Time since the last position fix

Event 4006,
Event 6004,
Event 6011,
Event 6015,
Event 6034,
Event 6036,
Event 6045

position.hdop

number

Horizontal dilution of precision

Event 4001,
Event 4002,
Event 4003,
Event 4004,
Event 4006,
Event 6004,
Event 6011,
Event 6012,
Event 6013,
Event 6014,
Event 6015,
Event 6034,
Event 6036,
Event 6045,
Event 6084,
Param ID 0x12 (Binary protocol)

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

Event 4001,
Event 4002,
Event 4003,
Event 4004,
Event 4006,
Event 6004,
Event 6011,
Event 6012,
Event 6013,
Event 6014,
Event 6015,
Event 6034,
Event 6036,
Event 6044,
Event 6071,
Event 6076,
Event 6084,
Param ID 0x0B (Binary protocol)

protocol.id

number

ID of protocol

record.seqnum

number

Registered record sequence number

Param ID 0x05 (Binary protocol)

report.code

string

Report code

sensor.int16.value

number

User-defined 2 bytes sensor signed value stored as int16, indexed parameter

Param ID 0x42...0x49 (Binary protocol),
Param ID 0xB3...0xBA (Binary protocol)

sensor.int32.value

number

User-defined 4 bytes sensor signed value stored as int32, indexed parameter

Param ID 0x4A...0x51 (Binary protocol),
Param ID 0xBB...0xC2 (Binary protocol)

sensor.int8.value

number

User-defined 1 byte sensor signed value stored as int8, indexed parameter

Param ID 0x32...0x41 (Binary protocol),
Param ID 0xA3...0xB2 (Binary protocol)

sensor.temperature

number

celsius

Temperature sensor value

Param ID 0x30 (Binary protocol),
Param ID 0x31 (Binary protocol)

server.timestamp

number

seconds

Timestamp when server received a message

sleep.mode.status

boolean

Device is in sleep mode

Param ID 0x53 (Binary protocol)

timestamp

number

seconds

Message timestamp

total.mileage

number

Total mileage

Param ID 0x54 (Binary protocol)

trip.mileage

number

Distance driven since engine start

Event 4001,
Event 4002,
Event 4003,
Event 4004,
Event 4006,
Event 6004,
Event 6011,
Event 6012,
Event 6013,
Event 6014,
Event 6015,
Event 6034,
Event 6036,
Event 6084,
Param ID 0x10 (Binary protocol),
Param ID 0x2E (Binary protocol),
Param ID 0x88 (Binary protocol)

vehicle.battery.voltage

number

Vehicle battery voltage

Param ID 0x17 (Binary protocol)

vehicle.mileage

number

Total calculated mileage

Param ID 0x18 (Binary protocol)

vehicle.state.bitmask

number

Vehicle state flags bitmask

Param ID 0x52 (Binary protocol)

vehicle.vin

string

VIN of vehicle

Event 4006,
Event 6015,
Param ID 0x65 (Binary protocol)

vibration.alarm

boolean

Vibration alarm event

Param ID 0x53 (Binary protocol)

wake.reason

number

Wake reason

Param ID 0x53 (Binary protocol)

x.acceleration

number

Accelerometer value X

Event 4001,
Event 4002,
Event 4003,
Event 4004,
Event 4006,
Event 6004,
Event 6011,
Event 6012,
Event 6013,
Event 6014,
Event 6015,
Event 6036,
Event 6084

y.acceleration

number

Accelerometer value Y

Event 4001,
Event 4002,
Event 4003,
Event 4004,
Event 4006,
Event 6004,
Event 6011,
Event 6012,
Event 6013,
Event 6014,
Event 6015,
Event 6036,
Event 6084

z.acceleration

number

Accelerometer value Z

Event 4001,
Event 4002,
Event 4003,
Event 4004,
Event 4006,
Event 6004,
Event 6011,
Event 6012,
Event 6013,
Event 6014,
Event 6015,
Event 6036,
Event 6084

Title

Name

Description

Properties

Configure backend server settings

backend_server

Configure backend server settings

host: Server Host or IP

port: Server Port

transport: Transport

Configure remote phone number

remote_phone