Bitrek-cicada protocol

Protocol used by Cicada series of GPS tracking devices manufactured by Bitrek headquartered in Ukraine.
flespi parses the Bitrek-cicada protocol messages into a JSON object with the fields listed below in the Parameters tab.

To connect your tracker using the Bitrek Cicada protocol, you need to have a bitrek-cicada 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.

battery.voltage
number
volts
Internal battery voltage
bluetooth.mac.address
string
Bluetooth MAC address
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.temperature
number
celsius
Temperature of device
device.type.id
number
ID of device type of device that received a message
device.wakeup.source
number
Device wakeup source
gnss.fix.duration
number
seconds
Time used to fetch device GNSS position ("Time to GPS fix")
gps.error.enum
number
GPS position obtaining error code
gsm.cellid
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) base station ID
gsm.lac
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) location area code
gsm.mcc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) country code
gsm.mnc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) code
gsm.network.name
string
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) operator name
gsm.operator.code
string
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) operator code, which is MCC joined with MNC
gsm.signal.dbm
number
dbm
Strength of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal
gsm.sim.iccid
string
Integrated Circuit Card Id of SIM card of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)
gsm.stations.updated
boolean
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) station info after TA parameter update
gsm.timing.advance
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) timing advance
ident
string
Device unique identifier like serial number, IMEI, etc
last.sleep.reason
number
The last reason for device sleep
last.sleep.timeout
number
seconds
Last device sleep timeout
modem.power.on.count
number
The number of times the modem has been powered on
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.fix.type
number
GNSS fix type enum (0 = "not fixed", 1 = "2D", 2 = "3D", null = "unknown")
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.satellites
number
Quantity of satellites used to calculate coordinates for given position information
position.speed
number
km/h
Instant speed at position detection moment
position.timestamp
number
seconds
Timestamp when coordinates where calculated
position.valid
boolean
Is position information accurate and valid for given timestamp
position.vdop
number
Vertical dilution of precision
protocol.id
number
ID of protocol
reboot.reason.bitmask
number
Device reboot reason bitmask
scan.duration
number
Scan duration
scan.previous.duration
number
Previous scan duration
scan.start.count
number
Number of scans
scan.start.success.count
number
Number of successful scans
server.timestamp
number
seconds
Timestamp when server received a message
software.version
string
Software version string
timestamp
number
seconds
Message timestamp
total.device.uptime
number
seconds
Total device working time
Properties
Send custom payload to device
custom
Send custom command in response to the device request. Command payload will be automatically prepended with '&'-sign
payload: Command payload to send
Change parameter XXXX value to YYYY
{"payload":"setparam XXXX YYYY"}