BTG01L

BTG01L is a 6-wire Bluetooth vehicle tracker with digital and analog inputs/outputs. It supports LTE Cat-1/3G/2G GNSS (GLONASS) and features 128Mb external flash memory. The device includes geofence alarm functionality for both circular and polygonal fences, reports tow alarm and driving behavior monitoring. It’s equipped with a 200mAh backup battery and complies with IP65 requirements.

Make your BTG01L devices a part of any infrastructure by connecting them via flespi telematics hub. Manage the device settings using flespi device management platform. Learn how to configure BTG01L with flespi.

Protocol: btg-iot Manufacturer: BTG IoT Change log: btg-iot

Usage specifics

Parameters (90)

Settings (5)

Commands (1)

Here’s the like of JSON you get

{
    "ident": "352625333222111",
    "position.altitude": 273.61,
    "position.hdop": 0.7,
    "position.latitude": 49.069782,
    "position.longitude": 28.632826,
    "position.satellites": 18,
    "server.timestamp": 1650636570.426424,
    "timestamp": 1650636570.426424,
    "device.type.id": "BTG01L",
    "channel.id": 1111,
    "protocol.id": "btg-iot"
    "engine.ignition.status": true
    ...
}

How to consume this nice JSON

The easiest way is to make a REST API request like this

curl -X GET  --header 'Authorization: FlespiToken XXX' 'https://flespi.io/gw/devices/<device id>/messages'

Explore REST API Show more ways to consume data How to connect my BTG01L to flespi

How to send commands to BTG01L?

You can send a specific command. Show all commands

You can use pre-defined settings to send instructions more conveniently. Show all settings

You can also

Modify messages

Add or remove parameters, inject data from LBS and reverse-geocoding services, etc.

Learn what plugins can do

Aggregate data

Determine trips and stops, catch events, detect geofence ins/outs, and more.

Learn about flespi analytics capabilities

Name

Type

Unit

Description

Sources

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

gsm.mcc

number

Mobile network (GSM, 3G, 4G, LTE, 5G, ...) country code

gsm.mnc

number

Mobile network (GSM, 3G, 4G, LTE, 5G, ...) code

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

position.direction

number

degrees

Heading angle at position detection moment

position.hdop

number

Horizontal dilution of precision

position.latitude

number

degrees

Latitude coordinate value

position.longitude

number

degrees

Longitude coordinate value

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

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.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

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

Title

Name

Description

Properties

Backend Server Setup

backend_server

Configure the backend server information

host: Host

port: Port

heartbeat: Heartbeat Interval

buffer_mode: Buffering mode

report_mode: Report Mode

sack_enable: Server ACK

Device Information

device_info

Generic device information

name: Device Name

protocol: Protocol Version

Modem Information

modem_info

Modem versions information

hw_ver: Hardware Version

sw_ver: Sofrware Version

Time Zone

time_zone

Configure time zone of the device

dst: Dayligh Saving

sign: Sign

hours_offset: Hour Offset

minutes_offset: Minute Offset

Versions Information

versions

Device versions information

fw_ver: Firmware Version

hw_ver: Hardware Version

mcu_ver: MCU Version

Title

Name

Description

Properties

Custom command

custom

Send custom command to device

payload: Command text

BTG01L

Here’s the like of JSON you get

How to consume this nice JSON

How to send commands to BTG01L?

You can also

Modify messages

Aggregate data

More devices from BTG IoT