Maxtrack protocol
Integration level: params + settings
Protocol used by GPS tracking devices manufactured by Maxtrack headquartered in Brazil.
flespi parses the Maxtrack protocol messages into a JSON object with the
fields listed below in the Parameters tab.
air.pressure
number
bar
Air pressure
alarm.event
boolean
Alarm event triggered
alarm.state.enum
number
Alarm state
antitheft.event
boolean
Antitheft event triggered
battery.charging.status
boolean
Battery charging status
battery.connected.status
boolean
Internal battery is connected
battery.level
number
percentage
Internal battery level
battery.state
string
Battery state
battery.use.duration
number
seconds
Time device works on battery power
battery.voltage
number
volts
Internal battery voltage
can.ambient.air.temperature
number
celsius
CAN ambient air temperature
can.engine.oil.temperature
number
celsius
Engine oil temperature
can.engine.rpm
number
rpm
Engine RPM read from CAN
can.engine.temperature
number
celsius
Engine temperature read from CAN
can.fuel.consumption
number
liters/h
Engine fuel rate read from CAN
can.intake.air.temperature
number
celsius
Intake air temperature
can.maf.air.flow.rate
number
g/sec
MAF air flow rate read from CAN
can.throttle.pedal.level
number
percentage
Throttle pedal push level read from CAN
can.vehicle.mileage
number
km
Total vehicle mileage read from CAN
can.vehicle.speed
number
km/h
Vehicle speed read from CAN
channel.id
number
ID of channel that received a message
crash.accelerometer.status
boolean
Crash accelerometer is calibrated
device.id
number
ID of device that received a message
device.lifetime
number
minutes
Device operating time since production
device.model
string
Device model ID string
device.name
string
Name of device that received a message
device.temperature
number
celsius
Temperature of device
device.type.id
number
ID of device type of device that received a message
device.uptime
number
seconds
Tine in seconds since last device power on
din
number
Digital inputs bitmask
dout
number
Digital outputs bitmask
driver.id
string
Driver identification card id
engine.ignition.on.duration
number
seconds
Duration when engine is on
engine.ignition.status
boolean
Engine ignition status
engine.motorhours
number
hours
Total calculated engine motorhours
engine.rpm
number
rpm
Engine RPM read from CAN
event.code
string
Unique event identifier string
event.duration
number
seconds
Telemetry event duration
event.enum
number
Event code, full list of codes available at separate table
event.seqnum
number
Unique event sequence number
external.powersource.status
boolean
External power source connection status
external.powersource.voltage
number
volts
External power voltage
fuel.level
number
percentage
Fuel level percentage
gnss.antenna.status
boolean
GNSS receiver antenna status
gnss.type
string
GNSS type: gps, glonass, etc...
gnss.vehicle.mileage
number
km
Vehicle mileage calculated by global navigation system (GNSS)
gprs.status
boolean
GPRS mobile network status
gsm.cellid
number
GSM base station ID
gsm.jamming.event
boolean
GSM signal jamming detected
gsm.lac
number
GSM location area code
gsm.mcc
string
GSM mobile country code
gsm.mnc
string
GSM mobile network code
gsm.module.status
boolean
GSM module is ON
gsm.network.roaming.status
boolean
GSM network in roaming mode
gsm.network.status
boolean
Registration in GSM network
gsm.signal.dbm
number
dbm
Strength of GSM signal
gsm.signal.level
number
percentage
GSM signal strength level
gsm.sim.iccid
string
Integrated Circuit Card Id of SIM card
gsm.sim.status
boolean
SIM card is active
gsm.timing.advance
number
GSM timing advance
ident
string
Device unique identifier like serial number, IMEI, etc
ignition.calibration.automatic
boolean
Virtual ignition calibration source is automatic
ignition.calibration.max.detected
number
volts
Virtual ignition calibration maximum voltage value read since reset
ignition.calibration.max.used
number
volts
Virtual ignition calibration maximum voltage value used to calculate calibration
ignition.calibration.min.detected
number
volts
Virtual ignition calibration minimum voltage value read since reset
ignition.calibration.min.used
number
volts
Virtual ignition calibration minimum voltage value used to calculate calibration
ignition.calibration.timestamp
number
Timestamp when virtual ignition was calibrated
ignition.calibration.voltage
number
volts
Virtual ignition calibration set up voltage
ignition.state
number
Ignition state according to device manual
last.reboot.id
number
Reason from the last reset of the device
lora.fcntup
number
LoRa: The uplink counter for this packet
message.buffered.status
boolean
Black box message
movement.status
boolean
Current movement state
overspeeding.event
boolean
Overspeeding detected
overspeeding.status
boolean
Overspeeding detected
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.pdop
number
Position dilution of precision
position.speed
number
km/h
Instant speed at position detection moment
power.on.status
boolean
Power-on device status
power.state.enum
number
Power state
product.model.enum
number
Product model
protocol.id
number
ID of protocol
reboot.reason.enum
number
Terminal reboot reason
report.reason
number
Transmission reason code
server.timestamp
number
seconds
Timestamp when server received a message
sleep.mode.status
boolean
Device is in sleep mode
timestamp
number
seconds
Message timestamp
total.idle.seconds
number
seconds
Total time that vehicle was in idling state
trip.status
boolean
Trip status, true if trip started, false - if stopped
vehicle.battery.state
string
Battery state of the vehicle
vehicle.mileage
number
km
Total calculated mileage
vehicle.vin
string
VIN of vehicle
wifi.status
boolean
Wifi connection status
zigbee.status
boolean
Zigbee connection status
Properties
Custom binary command
Examples
custom_binary
Send custom command to device, message type 0x33. Note! This command is applicable to Maxtrack binary protocol devices, not protobuf!
payload: Parameter value. Variable length. Depends on parameter_id
parameter_id: HEX representation of number that defines which parameter to change
Custom protobuf command
custom_protobuf
Send custom command to device. Note! This command is applicable to Maxtrack PROTOBUF devices, not binary!
payload: Payload data. Variable length. Depends on message_type. Must be protobuf encoded HEX
message_code: Message type HEX formatted. Refer to Maxtrack protobuf specification
Tags
To connect your tracker using the Maxtrack protocol, you need to have a maxtrack 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.
It is possible to configure Maxtrack devices OTA using the flespi web-based configurator tool. To connect Maxtrack to Wialon or another platform via flespi please read this article.