Tbit protocol

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

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

alarm.event
boolean
Alarm event triggered
battery.capacity.full
number
Ah
Full battery capacity
battery.capacity.remaining
number
Ah
Remaining battery capacity
battery.charging.cycles
number
Number of charges/discharges of the battery
battery.current
number
amperes
Battery current
battery.health
number
percentage
Battery health level (SoH)
battery.level
number
percentage
Internal battery level
battery.low.alarm
boolean
Battery low alarm event
battery.manufacturer
string
Battery manufacturer name
battery.serial
string
Scooter battery serial number
battery.voltage
number
volts
Internal battery voltage
bms.serial.number
string
BMS (Battery Management System) serial number
channel.id
number
ID of channel that received a message
device.id
number
ID of device that received a message
device.imei
string
IMEI of the device
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
event.enum
number
Protocol-specific event 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.signal.level
number
percentage
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal strength level
gsm.sim.imsi
string
IMSI of SIM card of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)
hall.sensor.frequency
number
hz
The number of Hall changes of the vehicle controller
ident
string
Device unique identifier like serial number, IMEI, etc
message.enum
number
Message code
message.seqnum
number
Message sequence number
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.latitude
number
degrees
Latitude coordinate value
position.longitude
number
degrees
Longitude coordinate value
position.outdated
boolean
Position information is outdated
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.valid
boolean
Is position information accurate and valid for given timestamp
protocol.id
number
ID of protocol
server.timestamp
number
seconds
Timestamp when server received a message
software.version
string
Software version string
timestamp
number
seconds
Message timestamp
trip.mileage
number
km
Distance driven since engine start
vehicle.mileage
number
km
Total calculated mileage
vehicle.state.bitmask
number
Vehicle state flags bitmask
vendor.code
string
Vendor identification string code
vibration.alarm
boolean
Vibration alarm event
Properties
Custom command
custom
Send custom command to device
code: HEX
payload: HEX data to send