Topin protocol

Protocol used by GPS tracking devices manufactured by Topin headquartered in China.
flespi parses the Topin protocol messages into a JSON object with the fields listed below in the Parameters tab.

To connect your tracker using the Topin protocol, you need to have a topin 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 Logs & Messages tab on the device screen to check if the messages are coming.

It is possible to configure Topin devices OTA using the flespi web-based configurator tool. To connect Topin to Wialon or another platform via flespi please read this article.

battery.level
number
percentage
Internal battery level
Protocol Number 0x13
channel.id
number
ID of channel that received a message
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
error.type
number
Protocol-specific error identification number
Protocol Number 0x80
event.enum
number
Protocol-specific event code
gsm.cellid
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) base station ID
Protocol Number 0x17,
Protocol Number 0x69
gsm.lac
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) location area code
Protocol Number 0x17,
Protocol Number 0x69
gsm.mcc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) country code
Protocol Number 0x17,
Protocol Number 0x69
gsm.mnc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) code
Protocol Number 0x17,
Protocol Number 0x69
gsm.signal.dbm
number
dbm
Strength of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal
Protocol Number 0x17,
Protocol Number 0x69
gsm.signal.level
number
percentage
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal strength level
Protocol Number 0x13
gsm.sim.iccid
string
Integrated Circuit Card Id of SIM card of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)
Protocol Number 0xB3
ident
string
Device unique identifier like serial number, IMEI, etc
message.buffered.status
boolean
Black box message
Protocol Number 0x10,
Protocol Number 0x11,
Protocol Number 0x17,
Protocol Number 0x69
payload.hex
string
HEX Payload received from device
peer
string
IP:port from which device connecting to the channel
position.direction
number
degrees
Heading angle at position detection moment
Protocol Number 0x10,
Protocol Number 0x11
position.latitude
number
degrees
Latitude coordinate value
Protocol Number 0x10,
Protocol Number 0x11
position.longitude
number
degrees
Longitude coordinate value
Protocol Number 0x10,
Protocol Number 0x11
position.satellites
number
Quantity of satellites used to calculate coordinates for given position information
Protocol Number 0x10,
Protocol Number 0x11
position.speed
number
km/h
Instant speed at position detection moment
Protocol Number 0x10,
Protocol Number 0x11
position.valid
boolean
Is position information accurate and valid for given timestamp
Protocol Number 0x10,
Protocol Number 0x11
protocol.id
number
ID of protocol
server.timestamp
number
seconds
Timestamp when server received a message
software.version.enum
number
Software version enum
Protocol Number 0x13
timestamp
number
seconds
Message timestamp
Protocol Number 0x10,
Protocol Number 0x11,
Protocol Number 0x17,
Protocol Number 0x69
wifi.mac.address
string
WiFi MAC address
Protocol Number 0x17,
Protocol Number 0x69
wifi.signal.strength
number
WiFi signal strength, RSSI
Protocol Number 0x17,
Protocol Number 0x69
Properties
Custom command
custom
Send custom command to device
hex: Binary payload in HEX form
Restart the device
{"hex":"4801"}