Maxtrack protocol

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.

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.

air.pressure
number
bar
Air pressure
Message Type 0x0001
alarm.event
boolean
Alarm event triggered
Message Type 0x0001,
Message Type 0x31
alarm.state.enum
number
Alarm state
Message Type 0x0001
antitheft.event
boolean
Antitheft event triggered
Message Type 0x31
battery.charging.status
boolean
Battery charging status
Message Type 0x31
battery.connected.status
boolean
Internal battery is connected
Message Type 0x31
battery.level
number
percentage
Internal battery level
Message Type 0x0001
battery.state
string
Battery state
Message Type 0x0001
battery.use.duration
number
seconds
Time device works on battery power
Message Type 0x0001,
Message Type 0x31
battery.voltage
number
volts
Internal battery voltage
Message Type 0x0001,
Message Type 0x31
can.ambient.air.temperature
number
celsius
CAN ambient air temperature
Message Type 0x0001
can.engine.oil.temperature
number
celsius
Engine oil temperature read from CAN
Message Type 0x0001
can.engine.rpm
number
rpm
Engine RPM read from CAN
Message Type 0x0001
can.engine.temperature
number
celsius
Engine temperature read from CAN
Message Type 0x0001
can.fuel.consumption
number
liters/h
Engine fuel rate read from CAN
Message Type 0x0001
can.intake.air.temperature
number
celsius
Intake air temperature
Message Type 0x0001
can.maf.air.flow.rate
number
g/sec
MAF air flow rate read from CAN
Message Type 0x0001
can.throttle.pedal.level
number
percentage
Throttle pedal push level read from CAN
Message Type 0x0001
can.vehicle.mileage
number
km
Total vehicle mileage read from CAN
Message Type 0x0001
can.vehicle.speed
number
km/h
Vehicle speed read from CAN
Message Type 0x0001
channel.id
number
ID of channel that received a message
crash.accelerometer.status
boolean
Crash accelerometer is calibrated
Message Type 0x0001
device.id
number
ID of device that received a message
device.lifetime
number
minutes
Device operating time since production
Message Type 0x0001
device.model
string
Device model ID string
device.name
string
Name of device that received a message
device.temperature
number
celsius
Temperature of device
Message Type 0x0001,
Message Type 0x31
device.type.id
number
ID of device type of device that received a message
device.uptime
number
seconds
Time in seconds since last device power on
Message Type 0x0001
din
number
Digital inputs bitmask
Message Type 0x0001,
Message Type 0x31
dout
number
Digital outputs bitmask
Message Type 0x0001,
Message Type 0x31
driver.id
string
Driver identification card id
Message Type 0x31
engine.ignition.on.duration
number
seconds
Duration when engine is on
Message Type 0x0001
engine.ignition.status
boolean
Engine ignition or ACC status
Message Type 0x31
engine.motorhours
number
hours
Total calculated engine motorhours
Message Type 0x31
engine.rpm
number
rpm
Engine RPM read
Message Type 0x0001
event.code
string
Protocol-specific event code string
Message Type 0x0001
event.duration
number
seconds
Telemetry event duration
Message Type 0x0001
event.enum
number
Protocol-specific event code
Message Type 0x0001,
Message Type 0x31
event.seqnum
number
Unique event sequence number
Message Type 0x0001,
Message Type 0x31
external.powersource.status
boolean
External power source connection status
Message Type 0x0001
external.powersource.voltage
number
volts
External power voltage
Message Type 0x0001,
Message Type 0x31
fuel.level
number
percentage
Fuel level percentage
Message Type 0x0001
gnss.antenna.status
boolean
GNSS receiver antenna status
Message Type 0x31
gnss.type
string
GNSS type: gps, glonass, etc...
Message Type 0x0001
gnss.vehicle.mileage
number
km
Vehicle mileage calculated by global navigation system (GNSS)
Message Type 0x0001,
Message Type 0x31
gprs.status
boolean
GPRS mobile network status
Message Type 0x0001
gsm.cellid
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) base station ID
Message Type 0x0001,
Message Type 0x31
gsm.jamming.event
boolean
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal jamming detected
Message Type 0x0001,
Message Type 0x31
gsm.lac
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) location area code
Message Type 0x0001,
Message Type 0x31
gsm.mcc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) country code
Message Type 0x0001,
Message Type 0x31
gsm.mnc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) code
Message Type 0x0001,
Message Type 0x31
gsm.module.status
boolean
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) module is ON
Message Type 0x0001
gsm.network.roaming.status
boolean
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) in roaming mode
Message Type 0x0001
gsm.network.status
boolean
Registration status in the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)
Message Type 0x0001,
Message Type 0x31
gsm.signal.dbm
number
dbm
Strength of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal
Message Type 0x0001
gsm.signal.level
number
percentage
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal strength level
Message Type 0x0001
gsm.sim.iccid
string
Integrated Circuit Card Id of SIM card of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)
Message Type 0x0001,
Message Type 0x0002,
Message Type 0x0003,
Message Type 0x0011
gsm.sim.status
boolean
SIM card is active
Message Type 0x0001
gsm.timing.advance
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) timing advance
Message Type 0x0001
ident
string
Device unique identifier like serial number, IMEI, etc
ignition.calibration.automatic
boolean
Virtual ignition calibration source is automatic
Message Type 0x0011
ignition.calibration.max.detected
number
volts
Virtual ignition calibration maximum voltage value read since reset
Message Type 0x0011
ignition.calibration.max.used
number
volts
Virtual ignition calibration maximum voltage value used to calculate calibration
Message Type 0x0011
ignition.calibration.min.detected
number
volts
Virtual ignition calibration minimum voltage value read since reset
Message Type 0x0011
ignition.calibration.min.used
number
volts
Virtual ignition calibration minimum voltage value used to calculate calibration
Message Type 0x0011
ignition.calibration.timestamp
number
Timestamp when virtual ignition was calibrated
Message Type 0x0011
ignition.calibration.voltage
number
volts
Virtual ignition calibration set up voltage
Message Type 0x0011
ignition.state
number
Ignition state according to device manual
Message Type 0x0001
last.reboot.id
number
Reason from the last reset of the device
Message Type 0x0001
lora.fcntup
number
LoRa: The uplink counter for this packet
Message Type 0x0001
message.buffered.status
boolean
Black box message
Message Type 0x31
movement.status
boolean
Current movement state
Message Type 0x0001,
Message Type 0x31
overspeeding.event
boolean
Overspeeding detected
Message Type 0x31
overspeeding.status
boolean
Overspeeding detected
Message Type 0x0001
peer
string
IP:port from which device connecting to the channel
position.altitude
number
meters
Altitude value for position
Message Type 0x0001
position.direction
number
degrees
Heading angle at position detection moment
Message Type 0x0001,
Message Type 0x31
position.hdop
number
Horizontal dilution of precision
Message Type 0x31
position.latitude
number
degrees
Latitude coordinate value
Message Type 0x0001,
Message Type 0x31
position.longitude
number
degrees
Longitude coordinate value
Message Type 0x0001,
Message Type 0x31
position.pdop
number
Position dilution of precision
Message Type 0x0001
position.speed
number
km/h
Instant speed at position detection moment
Message Type 0x0001,
Message Type 0x31
power.on.status
boolean
Power-on device status
Message Type 0x31
power.state.enum
number
Power state
Message Type 0x0001
product.model.enum
number
Product model
Message Type 0x0011
protocol.id
number
ID of protocol
reboot.reason.enum
number
Terminal reboot reason
Message Type 0x0001,
Message Type 0x0011
report.reason
number
Transmission reason code
Message Type 0x0001
server.timestamp
number
seconds
Timestamp when server received a message
sleep.mode.status
boolean
Device is in sleep mode
Message Type 0x31
timestamp
number
seconds
Message timestamp
Message Type 0x0001,
Message Type 0x0011,
Message Type 0x31
total.idle.seconds
number
seconds
Total time that vehicle was in idling state
Message Type 0x31
trip.status
boolean
Trip status, true if trip started, false - if stopped
Message Type 0x0001
vehicle.battery.state
string
Battery state of the vehicle
Message Type 0x0001
vehicle.mileage
number
km
Total calculated mileage
Message Type 0x0001
vehicle.vin
string
VIN of vehicle
Message Type 0x0001
wifi.status
boolean
Wifi connection status
Message Type 0x0001
zigbee.status
boolean
Zigbee connection status
Message Type 0x0001
Properties
Custom binary command
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
Activate output 2 (see SPC_OUTPUT_MACRO3 command)
{"payload":"02FFFFFFFFFFFF","parameter_id":"57"}
Activate output 1 for 5 seconds in 2 cycles (see SPC_OUTPUT_MACRO3 command)
{"payload":"010005FFFF0002","parameter_id":"57"}
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