Magicyo protocol

binary
mqtt
Protocol used by GPS tracking devices manufactured by Magicyo.
flespi parses the Magicyo protocol messages into a JSON object with the fields listed below in the Parameters tab.
Access parsed data via MQTT & REST API Send commands to configure devices
All protocols
Usage specifics Parameters (62)

To connect your tracker using the Magicyo protocol, you need to have an magicyo 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 in the ident field.

Use the Logs & Messages tab on the device screen to check if the messages are coming.

Name
Type
Unit
Description
Sources
accelerometer.calibration.state
number
Accelerometer calibration state
Data subtype 0x07 of Data type 0x02
average.fuel.consumption
number
liters/100km
Average fuel consumption
Attribute ID 407 of Data subtype 0x02 of Data type 0x04,
Attribute ID 407 of Data subtype 0x03 of Data type 0x04,
Attribute ID 407 of Data subtype 0x04 of Data type 0x04,
Attribute ID 407 of Data subtype 0x05 of Data type 0x04
battery.voltage
number
volts
Internal battery voltage
Attribute ID 102 of Data subtype 0x02 of Data type 0x04,
Attribute ID 102 of Data subtype 0x03 of Data type 0x04,
Attribute ID 102 of Data subtype 0x04 of Data type 0x04,
Attribute ID 102 of Data subtype 0x05 of Data type 0x04,
Data subtype 0x00 of Data type 0x02,
Data subtype 0x01 of Data type 0x02
bluetooth.connected.status
boolean
Bluetooth connection status
Attribute ID 302 of Data subtype 0x02 of Data type 0x04,
Attribute ID 302 of Data subtype 0x03 of Data type 0x04,
Attribute ID 302 of Data subtype 0x04 of Data type 0x04,
Attribute ID 302 of Data subtype 0x05 of Data type 0x04
bootloader.version
string
Bootloader version
Frame type 0x01
can.data.frame
string
CAN data frame value in HEX representation, indexed by CAN message ID or element identifier
Data subtype 0x0D of Data type 0x04
can.engine.temperature
number
celsius
Engine temperature read from CAN
Attribute ID 401 of Data subtype 0x02 of Data type 0x04,
Attribute ID 401 of Data subtype 0x03 of Data type 0x04,
Attribute ID 401 of Data subtype 0x04 of Data type 0x04,
Attribute ID 401 of Data subtype 0x05 of Data type 0x04
can.gear
number
Current gear read from CAN
Attribute ID 412 of Data subtype 0x02 of Data type 0x04,
Attribute ID 412 of Data subtype 0x03 of Data type 0x04,
Attribute ID 412 of Data subtype 0x04 of Data type 0x04,
Attribute ID 412 of Data subtype 0x05 of Data type 0x04
can.throttle.position
number
percentage
Absolute throttle position for corresponding throttle position sensor read from CAN
Attribute ID 403 of Data subtype 0x02 of Data type 0x04,
Attribute ID 403 of Data subtype 0x03 of Data type 0x04,
Attribute ID 403 of Data subtype 0x04 of Data type 0x04,
Attribute ID 403 of Data subtype 0x05 of Data type 0x04
channel.id
number
ID of channel that received a message
current.trip.mileage
number
km
Mileage from the latest ACC ON time to current time
Attribute ID 209 of Data subtype 0x02 of Data type 0x04,
Attribute ID 209 of Data subtype 0x03 of Data type 0x04,
Attribute ID 209 of Data subtype 0x04 of Data type 0x04,
Attribute ID 209 of Data subtype 0x05 of Data type 0x04
device.hardware.state.flag
number
Device hardware state flag
Data subtype 0x0F of Data type 0x04
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
device.wakeup.source
number
Device wakeup source
Data subtype 0x01 of Data type 0x02
ecu.hardware.version
string
ECU hardware version
Frame type 0x01
engine.ignition.status
boolean
Engine ignition or ACC status
Attribute ID 306 of Data subtype 0x02 of Data type 0x04,
Attribute ID 306 of Data subtype 0x03 of Data type 0x04,
Attribute ID 306 of Data subtype 0x04 of Data type 0x04,
Attribute ID 306 of Data subtype 0x05 of Data type 0x04,
Data subtype 0x01 of Data type 0x01,
Data subtype 0x02 of Data type 0x01
engine.rpm
number
rpm
Engine RPM read
Attribute ID 413 of Data subtype 0x02 of Data type 0x04,
Attribute ID 413 of Data subtype 0x03 of Data type 0x04,
Attribute ID 413 of Data subtype 0x04 of Data type 0x04,
Attribute ID 413 of Data subtype 0x05 of Data type 0x04
event.enum
number
Protocol-specific event code
Data type 0x01,
Data type 0x02,
Data type 0x04
event.timestamp
number
seconds
Timestamp of the event
Data subtype 0x00 of Data type 0x02,
Data subtype 0x01 of Data type 0x01,
Data subtype 0x01 of Data type 0x02,
Data subtype 0x02 of Data type 0x01,
Data subtype 0x03 of Data type 0x02,
Data subtype 0x07 of Data type 0x02
external.powersource.voltage
number
volts
External power voltage
Attribute ID 103 of Data subtype 0x02 of Data type 0x04,
Attribute ID 103 of Data subtype 0x03 of Data type 0x04,
Attribute ID 103 of Data subtype 0x04 of Data type 0x04,
Attribute ID 103 of Data subtype 0x05 of Data type 0x04
gsm.cellid
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) base station ID
Data subtype 0x01 of Data type 0x04
gsm.lac
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) location area code
Data subtype 0x01 of Data type 0x04
gsm.mcc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) country code
Data subtype 0x01 of Data type 0x04
gsm.mnc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) code
Data subtype 0x01 of Data type 0x04
gsm.network.type
string
The type of the Mobile network the device is currently registered to
Data subtype 0x01 of Data type 0x04
gsm.signal.level
number
percentage
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal strength level
Attribute ID 6 of Data subtype 0x02 of Data type 0x04,
Attribute ID 6 of Data subtype 0x03 of Data type 0x04,
Attribute ID 6 of Data subtype 0x04 of Data type 0x04,
Attribute ID 6 of Data subtype 0x05 of Data type 0x04,
Data subtype 0x01 of Data type 0x04
ident
string
Device unique identifier like serial number, IMEI, etc
ignition.state
number
Ignition state according to device manual
Data subtype 0x01 of Data type 0x01,
Data subtype 0x02 of Data type 0x01
immobilizer.service.status
boolean
immobilizer is in the service mode status
Attribute ID 307 of Data subtype 0x02 of Data type 0x04,
Attribute ID 307 of Data subtype 0x03 of Data type 0x04,
Attribute ID 307 of Data subtype 0x04 of Data type 0x04,
Attribute ID 307 of Data subtype 0x05 of Data type 0x04
message.buffered.status
boolean
Black box message
Data subtype 0x00 of Data type 0x02,
Data subtype 0x00 of Data type 0x04,
Data subtype 0x01 of Data type 0x01,
Data subtype 0x01 of Data type 0x02,
Data subtype 0x02 of Data type 0x01
message.seqnum
number
Sequence number of the message
message.type
string
Message type
Data type 0x01,
Data type 0x02,
Data type 0x04,
Frame type 0x01,
Frame type 0x0C
message.type.enum
number
Message Type
Frame type 0x01,
Frame type 0x0C
modem.hardware.version
string
Firmware hardware of the modem
Frame type 0x01
peer
string
IP:port from which device connecting to the channel
position.accuracy
number
meters
Position data accuracy in meters
Data subtype 0x00 of Data type 0x02,
Data subtype 0x00 of Data type 0x04,
Data subtype 0x01 of Data type 0x01,
Data subtype 0x01 of Data type 0x02,
Data subtype 0x02 of Data type 0x01
position.altitude
number
meters
Altitude value for position
Data subtype 0x00 of Data type 0x02,
Data subtype 0x00 of Data type 0x04,
Data subtype 0x01 of Data type 0x01,
Data subtype 0x01 of Data type 0x02,
Data subtype 0x02 of Data type 0x01
position.direction
number
degrees
Heading angle at position detection moment
Data subtype 0x00 of Data type 0x02,
Data subtype 0x00 of Data type 0x04,
Data subtype 0x01 of Data type 0x01,
Data subtype 0x01 of Data type 0x02,
Data subtype 0x02 of Data type 0x01
position.hdop
number
Horizontal dilution of precision
Data subtype 0x00 of Data type 0x02,
Data subtype 0x00 of Data type 0x04,
Data subtype 0x01 of Data type 0x01,
Data subtype 0x01 of Data type 0x02,
Data subtype 0x02 of Data type 0x01
position.latitude
number
degrees
Latitude coordinate value
Data subtype 0x00 of Data type 0x02,
Data subtype 0x00 of Data type 0x04,
Data subtype 0x01 of Data type 0x01,
Data subtype 0x01 of Data type 0x02,
Data subtype 0x02 of Data type 0x01
position.longitude
number
degrees
Longitude coordinate value
Data subtype 0x00 of Data type 0x02,
Data subtype 0x00 of Data type 0x04,
Data subtype 0x01 of Data type 0x01,
Data subtype 0x01 of Data type 0x02,
Data subtype 0x02 of Data type 0x01
position.pdop
number
Position dilution of precision
Data subtype 0x00 of Data type 0x02,
Data subtype 0x00 of Data type 0x04,
Data subtype 0x01 of Data type 0x01,
Data subtype 0x01 of Data type 0x02,
Data subtype 0x02 of Data type 0x01
position.satellites
number
Quantity of satellites used to calculate coordinates for given position information
Attribute ID 8 of Data subtype 0x02 of Data type 0x04,
Attribute ID 8 of Data subtype 0x03 of Data type 0x04,
Attribute ID 8 of Data subtype 0x04 of Data type 0x04,
Attribute ID 8 of Data subtype 0x05 of Data type 0x04,
Data subtype 0x00 of Data type 0x02,
Data subtype 0x00 of Data type 0x04,
Data subtype 0x01 of Data type 0x01,
Data subtype 0x01 of Data type 0x02,
Data subtype 0x02 of Data type 0x01
position.speed
number
km/h
Instant speed at position detection moment
Data subtype 0x00 of Data type 0x02,
Data subtype 0x00 of Data type 0x04,
Data subtype 0x01 of Data type 0x01,
Data subtype 0x01 of Data type 0x02,
Data subtype 0x02 of Data type 0x01
position.valid
boolean
Is position information accurate and valid for given timestamp
Attribute ID 301 of Data subtype 0x02 of Data type 0x04,
Attribute ID 301 of Data subtype 0x03 of Data type 0x04,
Attribute ID 301 of Data subtype 0x04 of Data type 0x04,
Attribute ID 301 of Data subtype 0x05 of Data type 0x04
position.vdop
number
Vertical dilution of precision
Data subtype 0x00 of Data type 0x02,
Data subtype 0x00 of Data type 0x04,
Data subtype 0x01 of Data type 0x01,
Data subtype 0x01 of Data type 0x02,
Data subtype 0x02 of Data type 0x01
power.on.reason
string
Power on reason
Data subtype 0x02 of Data type 0x02
power.on.reason.enum
number
Power ON reason enum
Data subtype 0x02 of Data type 0x02
protocol.id
number
ID of protocol
protocol.version
string
Protocol version string
Frame type 0x01
server.timestamp
number
seconds
Timestamp when server received a message
sleep.mode
number
Sleep mode
Data subtype 0x00 of Data type 0x02
software.version
string
Software version string
Frame type 0x01
timestamp
number
seconds
Message timestamp
Attribute ID 0 of Data subtype 0x02 of Data type 0x04,
Attribute ID 0 of Data subtype 0x03 of Data type 0x04,
Attribute ID 0 of Data subtype 0x04 of Data type 0x04,
Attribute ID 0 of Data subtype 0x05 of Data type 0x04,
Data subtype 0x00 of Data type 0x02,
Data subtype 0x00 of Data type 0x04,
Data subtype 0x01 of Data type 0x01,
Data subtype 0x01 of Data type 0x02,
Data subtype 0x01 of Data type 0x04,
Data subtype 0x02 of Data type 0x01,
Data subtype 0x02 of Data type 0x02,
Data subtype 0x0D of Data type 0x04,
Data subtype 0x0F of Data type 0x04,
Frame type 0x01,
Frame type 0x0C
tire.pressure
number
bar
Tire pressure
Attribute ID 204 of Data subtype 0x02 of Data type 0x04,
Attribute ID 204 of Data subtype 0x03 of Data type 0x04,
Attribute ID 204 of Data subtype 0x04 of Data type 0x04,
Attribute ID 204 of Data subtype 0x05 of Data type 0x04,
Attribute ID 206 of Data subtype 0x02 of Data type 0x04,
Attribute ID 206 of Data subtype 0x03 of Data type 0x04,
Attribute ID 206 of Data subtype 0x04 of Data type 0x04,
Attribute ID 206 of Data subtype 0x05 of Data type 0x04
tire.temperature
number
celsius
Tire temperature
Attribute ID 205 of Data subtype 0x02 of Data type 0x04,
Attribute ID 205 of Data subtype 0x03 of Data type 0x04,
Attribute ID 205 of Data subtype 0x04 of Data type 0x04,
Attribute ID 205 of Data subtype 0x05 of Data type 0x04,
Attribute ID 207 of Data subtype 0x02 of Data type 0x04,
Attribute ID 207 of Data subtype 0x03 of Data type 0x04,
Attribute ID 207 of Data subtype 0x04 of Data type 0x04,
Attribute ID 207 of Data subtype 0x05 of Data type 0x04
trip.mileage
number
km
Distance driven since engine start
Attribute ID 210 of Data subtype 0x02 of Data type 0x04,
Attribute ID 210 of Data subtype 0x03 of Data type 0x04,
Attribute ID 210 of Data subtype 0x04 of Data type 0x04,
Attribute ID 210 of Data subtype 0x05 of Data type 0x04
vehicle.mileage
number
km
Total calculated mileage
Attribute ID 203 of Data subtype 0x02 of Data type 0x04,
Attribute ID 203 of Data subtype 0x03 of Data type 0x04,
Attribute ID 203 of Data subtype 0x04 of Data type 0x04,
Attribute ID 203 of Data subtype 0x05 of Data type 0x04
vehicle.speed
number
km/h
Vehicle speed
Attribute ID 208 of Data subtype 0x02 of Data type 0x04,
Attribute ID 208 of Data subtype 0x03 of Data type 0x04,
Attribute ID 208 of Data subtype 0x04 of Data type 0x04,
Attribute ID 208 of Data subtype 0x05 of Data type 0x04
wakeup.trigger
string
Wake up trigger
Data subtype 0x01 of Data type 0x02