Btg-iot protocol

Protocol used by GPS tracking devices manufactured by BTG IoT headquartered in the USA.
flespi parses the Btg-iot protocol messages into a JSON object with the fields listed below in the Parameters tab.

To connect your tracker using the BTG IoT protocol, you need to have a btg-iot 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.event
boolean
Alarm event triggered
Report GTSOS
backup.battery.low.status
boolean
Backup battery low
Report GTBPL
backup.battery.voltage
number
volts
Backup battery voltage
Report GTBPL,
Report GTINF
battery.charging.status
boolean
Battery charging status
Report GTBTC,
Report GTINF,
Report GTSTC
battery.level
number
percentage
Internal battery level
Report GTFRI
channel.id
number
ID of channel that received a message
daylight.saving.status
boolean
Daylight saving is active
Report GTTMZ
device.firmware.version
string
Firmware revision
Report GTVER
device.id
number
ID of device that received a message
device.name
string
Name of device that received a message
device.self.name
string
Device name reported by the device
Report GTASP,
Report GTDIS,
Report GTDOG,
Report GTDRV,
Report GTEPS,
Report GTFRI,
Report GTGES,
Report GTGIN,
Report GTGOT,
Report GTIGL,
Report GTIOB,
Report GTLBC,
Report GTPNL,
Report GTRTL,
Report GTSOS,
Report GTSPD,
Report GTSRT,
Report GTSSP,
Report GTTMP,
Report GTTOW,
Report GTTSP
device.type.id
number
ID of device type of device that received a message
din
number
Digital inputs bitmask
Report GTDIS,
Report GTFRI,
Report GTINF,
Report GTIOS
dout
number
Digital outputs bitmask
Report GTDOS,
Report GTFRI,
Report GTINF,
Report GTIOS
engine.ignition.off.duration
number
seconds
Duration of ignition off
Report GTIGN,
Report GTVGN
engine.ignition.on.duration
number
seconds
Duration when engine is on
Report GTIGF,
Report GTIGN,
Report GTVGF
engine.ignition.status
boolean
Engine ignition or ACC status
Report GTFRI,
Report GTGSS,
Report GTIDF,
Report GTIGF,
Report GTIGL,
Report GTIGN,
Report GTINF,
Report GTIOS,
Report GTSRT,
Report GTSTT,
Report GTVGF,
Report GTVGN
engine.motorhours
number
hours
Total calculated engine motorhours
Report GTFRI,
Report GTIGF,
Report GTIGN,
Report GTVGF,
Report GTVGN
external.powersource.status
boolean
External power source connection status
Report GTBAT,
Report GTINF
external.powersource.voltage
number
volts
External power voltage
Report GTEPS,
Report GTFRI,
Report GTINF,
Report GTTMP
fuel.level
number
percentage
Fuel level percentage
Report GTFLA
fuel.loss.alarm.event
boolean
Fuel loss alarm
Report GTFLA
fuel.sensot.input.id
number
Input ID which fuel sensor is connected to
Report GTFLA
geofence.check.interval
number
seconds
The check interval of geofence
Report GTGES
geofence.id
number
Geofence ID
Report GTGES
geofence.radius
number
meters
The radius of geofence
Report GTGES
geofences.ids.bitmask
number
Geofences ids bitmask
Report GTGIN,
Report GTGOT
geofence.status
boolean
Geofence entered status
Report GTGIN,
Report GTGOT
geofence.type.enum
number
Geofence type enum
Report GTGIN,
Report GTGOT
geofencing.trigger.mode
string
The trigger mode of geofencing function
Report GTGES
gnss.status
boolean
GNSS receiver on/off status
Report GTGSS
gsm.cellid
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) base station ID
Report GTBPL,
Report GTBTC,
Report GTDOS,
Report GTFLA,
Report GTGSS,
Report GTIDF,
Report GTIDN,
Report GTIGF,
Report GTIGN,
Report GTLSP,
Report GTMPF,
Report GTMPN,
Report GTRMD,
Report GTSRT,
Report GTSTC,
Report GTSTP,
Report GTSTR,
Report GTSTT,
Report GTVGF,
Report GTVGN
gsm.lac
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) location area code
Report GTBPL,
Report GTBTC,
Report GTDOS,
Report GTFLA,
Report GTGSS,
Report GTIDF,
Report GTIDN,
Report GTIGF,
Report GTIGN,
Report GTLSP,
Report GTMPF,
Report GTMPN,
Report GTRMD,
Report GTSRT,
Report GTSTC,
Report GTSTP,
Report GTSTR,
Report GTSTT,
Report GTVGF,
Report GTVGN
gsm.mcc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) country code
Report GTBPL,
Report GTBTC,
Report GTDOS,
Report GTFLA,
Report GTGSS,
Report GTIDF,
Report GTIDN,
Report GTIGF,
Report GTIGN,
Report GTLSP,
Report GTMPF,
Report GTMPN,
Report GTRMD,
Report GTSRT,
Report GTSTC,
Report GTSTP,
Report GTSTR,
Report GTSTT,
Report GTVGF,
Report GTVGN
gsm.mnc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) code
Report GTBPL,
Report GTBTC,
Report GTDOS,
Report GTFLA,
Report GTGSS,
Report GTIDF,
Report GTIDN,
Report GTIGF,
Report GTIGN,
Report GTLSP,
Report GTMPF,
Report GTMPN,
Report GTRMD,
Report GTSRT,
Report GTSTC,
Report GTSTP,
Report GTSTR,
Report GTSTT,
Report GTVGF,
Report GTVGN
gsm.roaming.state
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) roaming state: 0 - home, 1 - known roaming, 2 - unknown roaming, 3 - blocking report
Report GTRMD
gsm.signal.dbm
number
dbm
Strength of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal
Report GTCSQ,
Report GTINF
gsm.signal.quality
number
The quality (bit error rate) of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal
Report GTCSQ,
Report GTINF
gsm.sim.iccid
string
Integrated Circuit Card Id of SIM card of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)
Report GTCID,
Report GTINF
hardware.version
string
Hardware version
Report GTVER
ident
string
Device unique identifier like serial number, IMEI, etc
idle.status
boolean
Vehicle is in idling state
Report GTIDN
idle.status.duration
number
seconds
Duration of vehicle being in the last idling state
Report GTIDF
input.output.alarm.event
boolean
Input/output port binding alarm event triggered
Report GTIOB
led.on.status
boolean
Power LED and gps LED working status
Report GTINF
main.powersource.status
boolean
Main power supply connection status
Report GTMPF,
Report GTMPN
message.buffered.status
boolean
Black box message
modem.firmware.version
string
Firmware version of the modem
Report GTVER
modem.hardware.version
string
Firmware hardware of the modem
Report GTVER
motion.alarm
boolean
Motion alarm
Report GTRSS
movement.status
boolean
Current movement state
Report GTFRI,
Report GTGSS,
Report GTIDF,
Report GTINF,
Report GTSTT
network.connected.event
boolean
GPRS connection established event
Report GTPDP
parking.geofence.active.status
boolean
The current parking geofence is active/inactive
Report GTGES
peer
string
IP:port from which device connecting to the channel
position.altitude
number
meters
Altitude value for position
Report GTBPL,
Report GTBTC,
Report GTDOS,
Report GTFLA,
Report GTGSS,
Report GTIDF,
Report GTIDN,
Report GTIGF,
Report GTIGN,
Report GTLSP,
Report GTMPF,
Report GTMPN,
Report GTRMD,
Report GTSRT,
Report GTSTC,
Report GTSTP,
Report GTSTR,
Report GTSTT,
Report GTVGF,
Report GTVGN
position.direction
number
degrees
Heading angle at position detection moment
Report GTBPL,
Report GTBTC,
Report GTDOS,
Report GTFLA,
Report GTGSS,
Report GTIDF,
Report GTIDN,
Report GTIGF,
Report GTIGN,
Report GTLSP,
Report GTMPF,
Report GTMPN,
Report GTRMD,
Report GTSRT,
Report GTSTC,
Report GTSTP,
Report GTSTR,
Report GTSTT,
Report GTVGF,
Report GTVGN
position.hdop
number
Horizontal dilution of precision
Report GTBPL,
Report GTBTC,
Report GTDOS,
Report GTFLA,
Report GTGSS,
Report GTIDF,
Report GTIDN,
Report GTIGF,
Report GTIGN,
Report GTLSP,
Report GTMPF,
Report GTMPN,
Report GTRMD,
Report GTSRT,
Report GTSTC,
Report GTSTP,
Report GTSTR,
Report GTSTT,
Report GTVGF,
Report GTVGN
position.latitude
number
degrees
Latitude coordinate value
Report GTBPL,
Report GTBTC,
Report GTDOS,
Report GTFLA,
Report GTGSS,
Report GTIDF,
Report GTIDN,
Report GTIGF,
Report GTIGN,
Report GTLSP,
Report GTMPF,
Report GTMPN,
Report GTRMD,
Report GTSRT,
Report GTSTC,
Report GTSTP,
Report GTSTR,
Report GTSTT,
Report GTVGF,
Report GTVGN
position.longitude
number
degrees
Longitude coordinate value
Report GTBPL,
Report GTBTC,
Report GTDOS,
Report GTFLA,
Report GTGSS,
Report GTIDF,
Report GTIDN,
Report GTIGF,
Report GTIGN,
Report GTLSP,
Report GTMPF,
Report GTMPN,
Report GTRMD,
Report GTSRT,
Report GTSTC,
Report GTSTP,
Report GTSTR,
Report GTSTT,
Report GTVGF,
Report GTVGN
position.satellites
number
Quantity of satellites used to calculate coordinates for given position information
Report GTGSS,
Report GTGSV
position.speed
number
km/h
Instant speed at position detection moment
Report GTBPL,
Report GTBTC,
Report GTDOS,
Report GTFLA,
Report GTGSS,
Report GTIDF,
Report GTIDN,
Report GTIGF,
Report GTIGN,
Report GTLSP,
Report GTMPF,
Report GTMPN,
Report GTRMD,
Report GTSRT,
Report GTSTC,
Report GTSTP,
Report GTSTR,
Report GTSTT,
Report GTVGF,
Report GTVGN
position.timestamp
number
seconds
Timestamp when coordinates where calculated
Report GTGPS,
Report GTINF,
Report GTSRT
power.on.status
boolean
Power-on device status
Report GTPFA,
Report GTPNA
prev.fuel.level
number
percentage
Previous fuel level
Report GTFLA
protocol.id
number
ID of protocol
protocol.version
string
Protocol version string
reboot.din.id
number
ID of digital input port that triggered reboot
Report GTDOG
reboot.reason.enum
number
Terminal reboot reason
Report GTDOG
record.seqnum
number
Registered record sequence number
report.code
string
Report code
Report GTASP,
Report GTDIS,
Report GTDOG,
Report GTDRV,
Report GTEPS,
Report GTFRI,
Report GTGES,
Report GTGIN,
Report GTGOT,
Report GTIGL,
Report GTIOB,
Report GTLBC,
Report GTPNL,
Report GTRTL,
Report GTSOS,
Report GTSPD,
Report GTSRT,
Report GTSSP,
Report GTTMP,
Report GTTOW,
Report GTTSP
report.reason
number
Transmission reason code
Report GTDIS,
Report GTDOG,
Report GTDRV,
Report GTEPS,
Report GTFRI,
Report GTIGL,
Report GTIOB,
Report GTRTL,
Report GTSOS,
Report GTSPD,
Report GTSRT,
Report GTTMP,
Report GTTOW
satellite.power
number
Satellite power
Report GTGSV
sensor.humidity
number
percentage
Humidity sensor value, i.e. relative air humidity level
Report GTRSS
sensor.id
string
Sensor ID
Report GTRSS,
Report GTTMP
sensor.temperature
number
celsius
Temperature sensor value
Report GTRSS,
Report GTTMP
sensor.type.enum
number
Accessory type: 1 - panic button, 2 - temperature sensor, 3 - temperature and humidity sensor
Report GTRSS
server.timestamp
number
seconds
Timestamp when server received a message
speed.alarm.status
boolean
Speed is in predefined speed range
Report GTSPD
temperature.alarm
boolean
Temperature value is outside of predefined range
Report GTTMP
temperature.alarm.status
boolean
Temperature alarm status: true - temperature is within predefined range, false - temperature is beyond predefined range
Report GTTMP
timestamp
number
seconds
Message timestamp
timestamp.key
number
Message timestamp in seconds with message sequence number appended as the value fractional part. Used to distinguish between several messages that have the same timestamp.
time.zone.offset
string
Time zone offset, +-HHMM
Report GTTMZ
towing.event
boolean
Towing event detected
Report GTFRI,
Report GTGSS,
Report GTIDF,
Report GTINF,
Report GTSTT
trip.status
boolean
Trip status, true if trip started, false - if stopped
Report GTLSP,
Report GTSTP,
Report GTSTR
vehicle.mileage
number
km
Total calculated mileage
Report GTASP,
Report GTDIS,
Report GTDOG,
Report GTDRV,
Report GTEPS,
Report GTFRI,
Report GTGES,
Report GTGIN,
Report GTGOT,
Report GTIDF,
Report GTIDN,
Report GTIGF,
Report GTIGL,
Report GTIGN,
Report GTIOB,
Report GTLSP,
Report GTPNL,
Report GTRTL,
Report GTSOS,
Report GTSPD,
Report GTSRT,
Report GTSSP,
Report GTSTP,
Report GTSTR,
Report GTTMP,
Report GTTOW,
Report GTTSP,
Report GTVGF,
Report GTVGN
vehicle.parked.event
boolean
Vehicle long stop event triggered
Report GTLSP,
Report GTSTP
vehicle.state
string
Vehicle state, such as moving, idling, parked etc
Report GTFRI,
Report GTGSS,
Report GTIDF,
Report GTINF,
Report GTSTT
virtual.ignition.mode
number
Virtual ignition detection mode: 2 - external power voltage, 4 - accelerometer
Report GTVGF,
Report GTVGN
voltage.range.status
boolean
Voltage is inside/outside predefined range: true - inside, false - outside
Report GTEPS
Properties
Custom command
custom
Send custom command to device
payload: Command text