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