Thingsys protocol

Protocol used by GPS tracking devices manufactured by Shenzhen Thingsys Co., Ltd.
flespi parses the Thingsys protocol messages into a JSON object with the fields listed below in the Parameters tab.

To connect your tracker using the Thingsys protocol, you need to have a thingsys 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.


alarm.code
number
Protocol-specific alarm code number
Protocol Number 0x13,
Protocol Number 0x16
alarm.event
boolean
Alarm event triggered
Protocol Number 0x13,
Protocol Number 0x16
battery.charging.status
boolean
Battery charging status
Protocol Number 0x13,
Protocol Number 0x16
battery.level
number
percentage
Internal battery level
Protocol Number 0x13,
Protocol Number 0x16
battery.low.alarm
boolean
Battery low alarm event
Protocol Number 0x13,
Protocol Number 0x16
channel.id
number
ID of channel that received a message
defense.active.status
boolean
Defense activated status
Protocol Number 0x13,
Protocol Number 0x16
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
engine.blocked.status
boolean
Engine blocked status (fuel cutoff relay), true - engine is blocked, false - engine isn't blocked
Protocol Number 0x13,
Protocol Number 0x16
engine.ignition.status
boolean
Engine ignition or ACC status
Protocol Number 0x13,
Protocol Number 0x16
external.powersource.voltage
number
volts
External power voltage
Protocol Number 0x94 with Information Type 0x00
geofence.status
boolean
Geofence entered status
Protocol Number 0x16
gnss.realtime.status
boolean
True - GNSS realtime positioning, False - differential positioning
Protocol Number 0x12,
Protocol Number 0x16
gnss.status
boolean
GNSS receiver on/off status
Protocol Number 0x13,
Protocol Number 0x16
gsm.cellid
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) base station ID
Protocol Number 0x12,
Protocol Number 0x16
gsm.lac
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) location area code
Protocol Number 0x12,
Protocol Number 0x16
gsm.mcc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) country code
Protocol Number 0x12,
Protocol Number 0x16
gsm.mnc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) code
Protocol Number 0x12,
Protocol Number 0x16
gsm.signal.level
number
percentage
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal strength level
Protocol Number 0x13,
Protocol Number 0x16
ident
string
Device unique identifier like serial number, IMEI, etc
language.enum
string
Language enum
Protocol Number 0x13,
Protocol Number 0x15,
Protocol Number 0x16
light.alarm
boolean
Light alarm active/not active status
Protocol Number 0x16
motion.alarm
boolean
Motion alarm
Protocol Number 0x16
overspeeding.event
boolean
Overspeeding detected
Protocol Number 0x16
peer
string
IP:port from which device connecting to the channel
position.direction
number
degrees
Heading angle at position detection moment
position.latitude
number
degrees
Latitude coordinate value
Protocol Number 0x12,
Protocol Number 0x16
position.longitude
number
degrees
Longitude coordinate value
Protocol Number 0x12,
Protocol Number 0x16
position.satellites
number
Quantity of satellites used to calculate coordinates for given position information
position.speed
number
km/h
Instant speed at position detection moment
Protocol Number 0x12,
Protocol Number 0x16
position.valid
boolean
Is position information accurate and valid for given timestamp
Protocol Number 0x12,
Protocol Number 0x16
power.cut.alarm
boolean
External power cut-off alarm event
Protocol Number 0x13,
Protocol Number 0x16
protocol.id
number
ID of protocol
protocol.number
number
Protocol number
server.timestamp
number
seconds
Timestamp when server received a message
timestamp
number
seconds
Message timestamp
Protocol Number 0x12,
Protocol Number 0x16
vibration.alarm
boolean
Vibration alarm event
Protocol Number 0x13,
Protocol Number 0x16
Properties
Custom Command for and MV22, MV208 device types
custom
Send custom command to devices of type MV22, MV208
payload: SMS/GPRS command Payload
Cut OFF engine
{"payload":"DYD#"}
Recover engine
{"payload":"HFYD#"}
Get device status
{"payload":"STATUS#"}