Assistant-telematics protocol

Parse and decode Assistant Telematics binary messages into JSON. Get parsed data from Assistant Telematics devices via REST API and MQTT. Forward normalized data from Assistant Telematics trackers to AWS, Azure.
flespi parses the Assistant-telematics protocol messages into a JSON object with the fields listed below in the Parameters tab.

To connect your tracker using the Assistant-Telematics protocol, you need to have a assistant-telematics 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.

ain
number
volts
Voltage on the analog input
Packet head RPT
battery.charging.state
string
Protocol-specific battery charging state
Packet head RPT
battery.level
number
percentage
Internal battery level
Packet head RPT
battery.low.alarm
boolean
Battery low alarm event
Packet head RPT
battery.voltage
number
volts
Internal battery voltage
Packet head RPT
beidou.visible.satellites
number
Quantity of visible satellites from BEIDOU
Packet head RPT
can.abs.failure.indicator.status
boolean
ABS failure indicator status read from CAN
Packet head RPT
can.accelerator.pedal.kickdown.indicator.status
boolean
Accelerator pedal kickdown switch status, read from CAN
Packet head RPT
can.accelerator.pedal.position
number
percentage
Accelerator pedal position read from CAN, index 1 - sensor D, index 2 - sensor E, etc
Packet head RPT
can.adblue.level
number
percentage
AdBlue (diesel exhaust fluid) level read from CAN
Packet head RPT
can.airbag.indicator.status
boolean
Airbag indicator status read from CAN
Packet head RPT
can.air.condition.status
boolean
CAN air conditioning is on
Packet head RPT
can.ambient.air.temperature
number
celsius
CAN ambient air temperature
Packet head RPT
can.axle.weight
number
kg
Weight on the axle read from CAN
Packet head RPT
can.battery.indicator.status
boolean
Battery indicator status read from CAN
Packet head RPT
can.brake.fluid.low.indicator.status
boolean
Brake fuel low indicator status read, from CAN
Packet head RPT
can.brake.system.failure.indicator.status
boolean
Brake system failure indicator status, read from CAN
Packet head RPT
can.central.lock.status
boolean
CAN central lock is locked
Packet head RPT
can.check.engine.indicator.status
boolean
Check engine indicator status read from CAN
Packet head RPT
can.coolant.level.low.indicator.status
boolean
Coolant level low indicator status read from CAN
Packet head RPT
can.cruise.status
boolean
CAN cruise control is active
Packet head RPT
can.driver.seatbelt.indicator.status
boolean
Driver seatbelt indicator status read from CAN
Packet head RPT
can.dtc
array
Packet head RPT
can.dtc.number
number
Number of diagnostic trouble codes
Packet head RPT
can.engine.all.starts.count
number
Engine all starts count read from CAN
Packet head RPT
can.engine.braking.factor
number
Engine braking factor value, read from CAN
Packet head RPT
can.engine.cold.starts.count
number
Engine cold starts count read from CAN
Packet head RPT
can.engine.coolant.temperature
number
celsius
Engine coolant temperature read from CAN
Packet head RPT
can.engine.hot.indicator.status
boolean
Engine hot indicator status, read from CAN
Packet head RPT
can.engine.ignition.starts.count
number
Engine starts by ignition read from CAN
Packet head RPT
can.engine.motorhours
number
hours
Total engine motorhours (engine work time) read from CAN
Packet head RPT
can.engine.oil.temperature
number
celsius
Engine oil temperature read from CAN
Packet head RPT
can.engine.rpm
number
rpm
Engine RPM read from CAN
Packet head RPT
can.engine.torque.level
number
percentage
Engine torque level, read from CAN
Packet head RPT
can.eps.failure.indicator.status
boolean
EPS failure indicator status, read from CAN
Packet head RPT
can.front.left.door.status
boolean
CAN front left door is opened
Packet head RPT
can.front.right.door.status
boolean
CAN front right door is opened
Packet head RPT
can.fuel.consumed
number
liters
Fuel volume totally consumed by vehicle read from CAN
Packet head RPT
can.fuel.consumption
number
liters/h
Engine fuel rate read from CAN
Packet head RPT
can.fuel.consumption.distance
number
liters/100km
Fuel consumption read from CAN
Packet head RPT
can.fuel.level
number
percentage
Fuel level in tank read from CAN
Packet head RPT
can.fuel.low.indicator.status
boolean
CAN low fuel indicator is on
Packet head RPT
can.fuel.volume
number
liters
CAN fuel volume
Packet head RPT
can.gaseous.fuel.level
number
percentage
Gaseous fuel level, read from CAN
Packet head RPT
can.gaseous.fuel.volume
number
liters
Gaseous fuel volume, read from CAN
Packet head RPT
can.handbrake.applies.count
number
Handbrake applies during ride count from CAN
Packet head RPT
can.handbrake.status
boolean
CAN handbrake is pulled up
Packet head RPT
can.hood.status
boolean
CAN hood is opened
Packet head RPT
can.idle.fuel.consumed
number
liters
Total idle fuel used, read from CAN
Packet head RPT
can.lights.front.fog.light.status
boolean
CAN lights info - front fog light status
Packet head RPT
can.lights.hazard.lights.status
boolean
CAN lights info hazard lights status
Packet head RPT
can.lights.high.beam.status
boolean
CAN lights info - high beam status
Packet head RPT
can.lights.low.beam.status
boolean
CAN lights info - low beam status
Packet head RPT
can.lights.rear.fog.light.status
boolean
CAN lights info - rear fog light status
Packet head RPT
can.lights.running.lights.status
boolean
CAN lights info - running lights status
Packet head RPT
can.oil.level.low.indicator.status
boolean
Oil level low indicator status read from CAN
Packet head RPT
can.oil.pressure.indicator.status
boolean
Oil pressure indicator status read from CAN
Packet head RPT
can.pedal.brake.status
boolean
CAN brake pedal pressed
Packet head RPT
can.pedal.braking.factor
number
Pedal braking factor value, read from CAN
Packet head RPT
can.pedal.clutch.status
boolean
CAN clutch pedal pressed
Packet head RPT
can.pto.status
boolean
Power take-off status, read from CAN
Packet head RPT
can.rear.left.door.status
boolean
CAN rear left door is opened
Packet head RPT
can.rear.right.door.status
boolean
CAN rear right door is opened
Packet head RPT
can.retarder.torque.load
number
percentage
Retarder torque load percentage read from CAN
Packet head RPT
can.reverse.gear.status
boolean
CAN reverse gear is on
Packet head RPT
can.service.call.indicator.status
boolean
Service call indicator status, read from CAN
Packet head RPT
can.service.mileage
number
km
Service distance read from CAN
Packet head RPT
can.total.accelerator.kickdowns
number
Total number accelerator kick-downs, read from CAN
Packet head RPT
can.total.accelerator.kickdowns.time
number
hours
Total driving time when accelerator kick-down, read from CAN
Packet head RPT
can.total.brake.applications
number
Total count of brake applications, read from CAN
Packet head RPT
can.total.cruise.control.time
number
hours
Total driving time when cruise control is ON, read from CAN
Packet head RPT
can.total.driving.time
number
hours
Engine run time read from CAN
Packet head RPT
can.total.effective.engine.speed.time
number
hours
Total effective engine speed timem read from CAN
Packet head RPT
can.total.engine.cold.time
number
seconds
Total engine cold running time from CAN
Packet head RPT
can.total.engine.idle.time
number
hours
Time of engine running in idling status (vehicle stopped) since vehicle manufacture, read from CAN
Packet head RPT
can.total.engine.overspeed.time
number
hours
CAN total time, when vehicle engine rpm was greater than the limit defined in CAN configuratio
Packet head RPT
can.total.rapid.accelerations
number
Total number of rapid accelerations
Packet head RPT
can.total.rapid.brakes
number
Total number of rapid brakes
Packet head RPT
can.total.vehicle.overspeed.time
number
hours
CAN total time, when vehicle speed was greater than the limit defined in CAN configuration
Packet head RPT
can.tpms.indicator.status
boolean
Tire pressure monitoring system indicator status, read from CAN
Packet head RPT
can.trailer.vin
string
Trailer VIN number, read from CAN
Packet head RPT
can.trunk.status
boolean
CAN trunk is opened
Packet head RPT
can.vehicle.battery.charging.status
boolean
Vehicle battery charging status get from CAN Bus
Packet head RPT
can.vehicle.mileage
number
km
Total vehicle mileage read from CAN
Packet head RPT
can.vehicle.speed
number
km/h
Vehicle speed read from CAN
Packet head RPT
can.wear.brake.pads.indicator.status
boolean
Wear brake pads indicator status, read from CAN
Packet head RPT
channel.id
number
ID of channel that received a message
counter.impulses
number
Impulses counter
Packet head RPT
crash.event
boolean
Crash event detected
Packet head RPT
device.firmware.version
string
Firmware revision
Packet head VER
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
Packet head RPT
dout
number
Digital outputs bitmask
Packet head RPT
engine.ignition.status
boolean
Engine ignition or ACC status
Packet head RPT
engine.motorhours
number
hours
Total calculated engine motorhours
Packet head RPT
event.code
string
Protocol-specific event code string
event.enum
number
Protocol-specific event code
Packet head RPT
event.name
string
Protocol-specific event name
Packet head RPT
external.powersource.status
boolean
External power source connection status
Packet head RPT
external.powersource.voltage
number
volts
External power voltage
Packet head RPT
galileo.visible.satellites
number
Quantity of visible satellites from GALILEO
Packet head RPT
geofence.status
boolean
Geofence entered status
Packet head RPT
glonass.visible.satellites
number
Quantity of visible satellites from GLONASS
Packet head RPT
gps.visible.satellites
number
Quantity of visible satellites from GPS
Packet head RPT
gsm.cellid
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) base station ID
Packet head QNI,
Packet head RPT
gsm.lac
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) location area code
Packet head RPT
gsm.mcc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) country code
Packet head RPT
gsm.mnc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) code
Packet head RPT
gsm.network.type
string
The type of the Mobile network the device is currently registered to
Packet head QNI,
Packet head RPT
gsm.signal.dbm
number
dbm
Strength of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal
Packet head QNI,
Packet head RPT
gsm.signal.quality
number
The quality (bit error rate) of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal
Packet head QNI
gsm.sim.iccid
string
Integrated Circuit Card Id of SIM card of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)
Packet head QNI
gsm.sim.imsi
string
IMSI of SIM card of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)
Packet head QNI
hardware.version
string
Hardware version
Packet head VER
harsh.acceleration.event
boolean
Harsh acceleration detected
Packet head RPT
harsh.braking.event
boolean
Harsh braking detected
Packet head RPT
harsh.cornering.event
boolean
Harsh cornering detected
Packet head RPT
ibutton.code
string
Hexadecimal code of connected iButton
Packet head RPT
ident
string
Device unique identifier like serial number, IMEI, etc
idle.event
boolean
Idle detected
Packet head RPT
idle.status
boolean
Vehicle is in idling state
Packet head RPT
ignition.state
number
Ignition state according to device manual
Packet head RPT
main.power.low.status
boolean
Main power low status
Packet head RPT
message.buffered.status
boolean
Black box message
modem.firmware.version
string
Firmware version of the modem
Packet head VER
movement.status
boolean
Current movement state
Packet head RPT
network.ip.address
string
IP address of the network
Packet head QNI
onewire.sensor.humidity
number
percentage
External 1-Wire humidity sensor value
Packet head RPT
onewire.sensor.serial
string
External 1-Wire sensor serial number in HEX representation
Packet head RPT
onewire.sensor.temperature
number
celsius
External 1-Wire temperature sensor value
Packet head RPT
overspeeding.event
boolean
Overspeeding detected
Packet head RPT
payload.hex
string
HEX Payload received from device
Packet head BMR
peer
string
IP:port from which device connecting to the channel
position.altitude
number
meters
Altitude value for position
Packet head RPT
position.direction
number
degrees
Heading angle at position detection moment
Packet head RPT
position.hdop
number
Horizontal dilution of precision
Packet head RPT
position.latitude
number
degrees
Latitude coordinate value
Packet head RPT
position.longitude
number
degrees
Longitude coordinate value
Packet head RPT
position.speed
number
km/h
Instant speed at position detection moment
Packet head RPT
position.valid
boolean
Is position information accurate and valid for given timestamp
Packet head RPT
power.on.status
boolean
Power-on device status
Packet head RPT
protocol.id
number
ID of protocol
protocol.version
string
Protocol version string
Packet head HBD,
Packet head RPT,
Packet head VER
remaining.range
number
km
Current remaining range
Packet head RPT
send.timestamp
number
seconds
Message send timestamp
server.timestamp
number
seconds
Timestamp when server received a message
temperature.high.alarm
boolean
Temperature hight alarm
Packet head RPT
temperature.low.alarm
boolean
Temperature low alarm
Packet head RPT
timestamp
number
seconds
Message timestamp
Packet head RPT
total.mileage
number
km
Total mileage
Packet head RPT
towing.event
boolean
Towing event detected
Packet head RPT
trip.engine.motorhours
number
Engine hours for current trip
Packet head RPT
vehicle.mileage
number
km
Total calculated mileage
Packet head RPT
vehicle.registration.number
string
Vehicle registration number
Packet head RPT
vehicle.vin
string
VIN of vehicle
Packet head RPT
Properties
Custom Command
custom
Send custom command to a device over TCP connection
text: Text payload
Toggle Digital output
{"text":"AT@OUT=at,1,0,2,0,0001#"}
Get Server Information Settings
{"text":"AT@SIS?at,,0001#"}