Topflytech TLW2-12B

Topflytech TLW2-12B is a hardwired trailer tracker with a large internal battery and BLE 5.0. The device features driving behavior detection, BLE 5.0 for sensors, IP67 waterproof casing, movement alerts, disconnection alerts, 9600 mAh backup battery, 3 digital outputs, 3 configurable inputs, and more.

Usage specifics
Parameters (106)
Settings (13)
Commands (1)
Topflytech TLW2-12B
Flespi parses telemetry data from your Topflytech TLW2-12B into a standardized JSON and lets you send commands to Topflytech TLW2-12B via API.

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": "Topflytech TLW2-12B",
    "channel.id": 1111,
    "protocol.id": "topflytech"
    "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'

How to send commands to Topflytech TLW2-12B?

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
accident.event
boolean
Accident event detected
Message Type 0x07
ain
number
volts
Voltage on the analog input
Message Type 0x02,
Message Type 0x04,
Message Type 0x13,
Message Type 0x14
alarm.event
boolean
Alarm event triggered
Alarm Code 3,
Message Type 0x10,
Message Type 0x12,
Message Type 0x13,
Message Type 0x14
antitheft.event
boolean
Antitheft event triggered
Alarm Code 10
average.fuel.consumption
number
liters/100km
Average fuel consumption
Message Type 0x02,
Message Type 0x04
battery.level
number
percentage
Internal battery level
Message Type 0x02,
Message Type 0x04,
Message Type 0x13,
Message Type 0x14
battery.low.alarm
boolean
Battery low alarm event
Message Type 0x10,
Message Type 0x12
battery.low.status
boolean
Battery low status
Alarm Code 2,
Alarm Code 24,
Alarm Code 6,
Alarm Code 7,
Message Type 0x13,
Message Type 0x14
battery.voltage
number
volts
Internal battery voltage
Message Type 0x02,
Message Type 0x04,
Message Type 0x13,
Message Type 0x14
ble.asset.rssi
number
BLE (Bluetooth Low Energy) asset signal strength
Message Type 0x10,
Message Type 0x12
ble.asset.tag.code
string
BLE (Bluetooth Low Energy) asset tag ID
Message Type 0x10,
Message Type 0x12
ble.door.open.status
boolean
BLE (Bluetooth Low Energy) door opened status
Message Type 0x10,
Message Type 0x12
ble.relay.id
string
BLE relay ID
Message Type 0x10,
Message Type 0x12
ble.relay.status
boolean
BLE relay status, true - ON, false - OFF
Message Type 0x10,
Message Type 0x12
ble.sensor.battery.level
number
percentage
BLE (Bluetooth Low Energy) sensor battery level
Message Type 0x10,
Message Type 0x12
ble.sensor.battery.voltage
number
volts
BLE (Bluetooth Low Energy) sensor battery voltage
Message Type 0x10,
Message Type 0x12
ble.sensor.humidity
number
percentage
BLE (Bluetooth Low Energy) sensor Humidity value
Message Type 0x10,
Message Type 0x12
ble.sensor.illuminance
number
lux
BLE (Bluetooth Low Energy) sensor illuminance
Message Type 0x10,
Message Type 0x12
ble.sensor.light.status
boolean
BLE (Bluetooth Low Energy) light status: false - light off, true - light on
Message Type 0x10,
Message Type 0x12
ble.sensor.state
number
BLE (Bluetooth Low Energy) sensor state
Message Type 0x10,
Message Type 0x12
ble.sensor.temperature
number
celsius
BLE (Bluetooth Low Energy) sensor Temperature value
Message Type 0x10,
Message Type 0x12
box.status
boolean
Box status (true - box is opened, false - box is closed)
Alarm Code 23,
Alarm Code 4,
Message Type 0x13,
Message Type 0x14
can.dtc
string
Diagnostic trouble code read from CAN
Message Type 0x09
can.dtc.state
number
DTC state: 1 - confirmed error, 2 - con confirmed error (error probably is, may disappear or happen again)
Message Type 0x09
can.engine.coolant.temperature
number
celsius
Engine coolant temperature read from CAN
Message Type 0x02,
Message Type 0x04
can.engine.load.level
number
percentage
Calculated engine load level read from CAN
Message Type 0x02,
Message Type 0x04
can.engine.rpm
number
rpm
Engine RPM read from CAN
Message Type 0x02,
Message Type 0x04,
Message Type 0x05,
Message Type 0x06,
Message Type 0x07
can.fuel.level
number
percentage
Fuel level in tank read from CAN
Message Type 0x02,
Message Type 0x04
can.intake.air.temperature
number
celsius
Intake air temperature
Message Type 0x02,
Message Type 0x04
can.intake.map
number
kPa
Intake manifold absolute pressure
Message Type 0x02,
Message Type 0x04
can.maf.air.flow.rate
number
g/sec
MAF air flow rate read from CAN
Message Type 0x02,
Message Type 0x04
can.throttle.pedal.level
number
percentage
Throttle pedal push level read from CAN
Message Type 0x02,
Message Type 0x04
case.status
boolean
Case opened status
Alarm Code 2,
Alarm Code 22,
Message Type 0x13,
Message Type 0x14
channel.id
number
ID of channel that received a message
collision.status
boolean
Collision status: true - collision detected, false - collision stopped
Alarm Code 10,
Alarm Code 27,
Message Type 0x13,
Message Type 0x14
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
Message Type 0x02,
Message Type 0x13,
Message Type 0x14
device.temperature.high.status
boolean
Device temperature high status: true - device temperature is higher than predefined threshold, false - device temperature is in normal range
Alarm Code 25,
Alarm Code 8,
Message Type 0x13,
Message Type 0x14
device.temperature.low.status
boolean
Device temperature low status: true - device temperature is lower than predefined threshold, false - device temperature is in normal range
Alarm Code 30,
Alarm Code 31,
Message Type 0x13,
Message Type 0x14
device.type.id
number
ID of device type of device that received a message
din
number
Digital inputs bitmask
Message Type 0x02,
Message Type 0x04,
Message Type 0x13,
Message Type 0x14
displacement.status
boolean
Device displacement status: true - device removed, false - device mounted (triggered by back light sensor)
Alarm Code 1,
Alarm Code 21,
Message Type 0x13,
Message Type 0x14
dout
number
Digital outputs bitmask
Message Type 0x13
driver.id
string
Driver identification card id
Message Type 0x10,
Message Type 0x12
engine.blocked.status
boolean
Engine blocked status, true - engine is blocked, false - engine isn't blocked
Message Type 0x02,
Message Type 0x13,
Message Type 0x14
engine.ignition.status
boolean
Engine ignition or ACC status
Alarm Code 16,
Alarm Code 17,
Message Type 0x02,
Message Type 0x04,
Message Type 0x10,
Message Type 0x12,
Message Type 0x13,
Message Type 0x14
engine.rpm
number
rpm
Engine RPM read
Message Type 0x13,
Message Type 0x14
event.code
string
Protocol-specific event code string
Message Type 0x09
event.enum
number
Protocol-specific event code
Message Type 0x02,
Message Type 0x13,
Message Type 0x14
external.powersource.status
boolean
External power source connection status
Alarm Code 1,
Message Type 0x02,
Message Type 0x04,
Message Type 0x13,
Message Type 0x14
external.powersource.voltage
number
volts
External power voltage
Message Type 0x02,
Message Type 0x04,
Message Type 0x13,
Message Type 0x14
fall.status
boolean
Device fall status: true - device is falling, false - falling stopped
Alarm Code 24,
Alarm Code 5,
Message Type 0x13,
Message Type 0x14
fuel.consumed
number
liters
Fuel volume totally consumed by vehicle
Message Type 0x02,
Message Type 0x04
geofence.status
boolean
Geofence entered status
Alarm Code 14,
Alarm Code 15,
Alarm Code 5,
Alarm Code 6,
Message Type 0x13,
Message Type 0x14
gnss.status
boolean
GNSS receiver on/off status
Message Type 0x02,
Message Type 0x04,
Message Type 0x06,
Message Type 0x07,
Message Type 0x10,
Message Type 0x12,
Message Type 0x13,
Message Type 0x14,
Message Type 0x17
gsm.cellid
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) base station ID
Message Type 0x02,
Message Type 0x04,
Message Type 0x06,
Message Type 0x07,
Message Type 0x10,
Message Type 0x12,
Message Type 0x13,
Message Type 0x14,
Message Type 0x17
gsm.earfcn
number
E-UTRA absolute radio-frequency channel number of the Mobile network (LTE)
Message Type 0x02,
Message Type 0x04,
Message Type 0x06,
Message Type 0x07,
Message Type 0x10,
Message Type 0x12,
Message Type 0x13,
Message Type 0x14,
Message Type 0x17
gsm.jamming.event
boolean
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal jamming detected
Alarm Code 21,
Alarm Code 22
gsm.lac
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) location area code
Message Type 0x02,
Message Type 0x04,
Message Type 0x06,
Message Type 0x07,
Message Type 0x10,
Message Type 0x12,
Message Type 0x13,
Message Type 0x14,
Message Type 0x17
gsm.mcc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) country code
Message Type 0x02,
Message Type 0x04,
Message Type 0x06,
Message Type 0x07,
Message Type 0x10,
Message Type 0x12,
Message Type 0x13,
Message Type 0x14,
Message Type 0x17
gsm.mnc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) code
Message Type 0x02,
Message Type 0x04,
Message Type 0x06,
Message Type 0x07,
Message Type 0x10,
Message Type 0x12,
Message Type 0x13,
Message Type 0x14,
Message Type 0x17
gsm.network.name
string
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) operator name
Message Type 0x05,
Message Type 0x11
gsm.pcid
number
Physical layer Cell ID in the Mobile network (LTE and NR)
Message Type 0x02,
Message Type 0x04,
Message Type 0x06,
Message Type 0x07,
Message Type 0x10,
Message Type 0x12,
Message Type 0x13,
Message Type 0x14,
Message Type 0x17
gsm.signal.level
number
percentage
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal strength level
Message Type 0x02,
Message Type 0x04,
Message Type 0x13,
Message Type 0x14
gsm.sim.iccid
string
Integrated Circuit Card Id of SIM card of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)
Message Type 0x05,
Message Type 0x11
gsm.sim.imsi
string
IMSI of SIM card of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)
Message Type 0x05,
Message Type 0x11
harsh.acceleration.event
boolean
Harsh acceleration detected
Message Type 0x05,
Message Type 0x06
harsh.braking.event
boolean
Harsh braking detected
Message Type 0x05,
Message Type 0x06
harsh.cornering.event
boolean
Harsh cornering detected
Message Type 0x06
ident
string
Device unique identifier like serial number, IMEI, etc
idle.status
boolean
Vehicle is in idling state
Alarm Code 18,
Alarm Code 19,
Alarm Code 20,
Message Type 0x13,
Message Type 0x14
light.sensor.voltage
number
volts
Front light sensor voltage
Message Type 0x02,
Message Type 0x04
lock.data
string
Lock data in HEX format
Message Type 0x17
lock.state
number
Numeric value of a lock status
Message Type 0x17
message.buffered.status
boolean
Black box message
Message Type 0x02,
Message Type 0x04,
Message Type 0x06,
Message Type 0x07,
Message Type 0x10,
Message Type 0x12,
Message Type 0x13,
Message Type 0x14,
Message Type 0x17
message.type
string
Message type
Message Type 0x02,
Message Type 0x04,
Message Type 0x06,
Message Type 0x07,
Message Type 0x10,
Message Type 0x12,
Message Type 0x13,
Message Type 0x14,
Message Type 0x17
movement.event
boolean
Movement detected
Alarm Code 8
movement.status
boolean
Current movement state
Message Type 0x02,
Message Type 0x04
overspeeding.event
boolean
Overspeeding detected
Alarm Code 4,
Message Type 0x05
peer
string
IP:port from which device connecting to the channel
position.altitude
number
meters
Altitude value for position
Message Type 0x02,
Message Type 0x04,
Message Type 0x05,
Message Type 0x06,
Message Type 0x07,
Message Type 0x10,
Message Type 0x12,
Message Type 0x13,
Message Type 0x14,
Message Type 0x17
position.direction
number
degrees
Heading angle at position detection moment
Message Type 0x02,
Message Type 0x04,
Message Type 0x05,
Message Type 0x06,
Message Type 0x07,
Message Type 0x10,
Message Type 0x12,
Message Type 0x13,
Message Type 0x14,
Message Type 0x17
position.latitude
number
degrees
Latitude coordinate value
Message Type 0x02,
Message Type 0x04,
Message Type 0x05,
Message Type 0x06,
Message Type 0x07,
Message Type 0x10,
Message Type 0x12,
Message Type 0x13,
Message Type 0x14,
Message Type 0x17
position.longitude
number
degrees
Longitude coordinate value
Message Type 0x02,
Message Type 0x04,
Message Type 0x05,
Message Type 0x06,
Message Type 0x07,
Message Type 0x10,
Message Type 0x12,
Message Type 0x13,
Message Type 0x14,
Message Type 0x17
position.satellites
number
Quantity of satellites used to calculate coordinates for given position information
Message Type 0x02,
Message Type 0x04,
Message Type 0x06,
Message Type 0x07,
Message Type 0x10,
Message Type 0x12,
Message Type 0x13,
Message Type 0x14,
Message Type 0x17
position.speed
number
km/h
Instant speed at position detection moment
Message Type 0x02,
Message Type 0x04,
Message Type 0x05,
Message Type 0x06,
Message Type 0x07,
Message Type 0x10,
Message Type 0x12,
Message Type 0x13,
Message Type 0x14,
Message Type 0x17
position.valid
boolean
Is position information accurate and valid for given timestamp
Message Type 0x02,
Message Type 0x04,
Message Type 0x05,
Message Type 0x06,
Message Type 0x07,
Message Type 0x10,
Message Type 0x12,
Message Type 0x13,
Message Type 0x14,
Message Type 0x17
power.on.status
boolean
Power-on device status
Alarm Code 20,
Alarm Code 29,
Message Type 0x13,
Message Type 0x14
protocol.id
number
ID of protocol
report.reason
number
Transmission reason code
server.timestamp
number
seconds
Timestamp when server received a message
solar.panel.charging.status
boolean
Solar panel charging device
Message Type 0x02,
Message Type 0x04
solar.panel.voltage
number
volts
Solar panel voltage
Message Type 0x02,
Message Type 0x04
tilt.status
boolean
Device tilt status (true - device is tilted, false - device is in normal position)
Alarm Code 11,
Alarm Code 28,
Message Type 0x13,
Message Type 0x14
timestamp
number
seconds
Message timestamp
tire.pressure
number
bar
Tire pressure
Message Type 0x10,
Message Type 0x12
tire.temperature
number
celsius
Tire temperature
Message Type 0x10,
Message Type 0x12
towing.alarm.status
boolean
Towing alarm state
Alarm Code 7
usb.connection.status
boolean
Status of USB connection (true - USB cable is connected, false - USB cable is disconnected)
Alarm Code 12,
Alarm Code 13,
Message Type 0x13,
Message Type 0x14
vehicle.mileage
number
km
Total calculated mileage
Message Type 0x02,
Message Type 0x04,
Message Type 0x13,
Message Type 0x14
vehicle.vin
string
VIN of vehicle
Message Type 0x09
vibration.status
boolean
Vibration status of the device: true - device is vibrated, false - device is in still state
Alarm Code 26,
Alarm Code 9,
Message Type 0x13,
Message Type 0x14
x.acceleration
number
g
Accelerometer value X
Message Type 0x02,
Message Type 0x04,
Message Type 0x06,
Message Type 0x07
y.acceleration
number
g
Accelerometer value Y
Message Type 0x02,
Message Type 0x04,
Message Type 0x06,
Message Type 0x07
z.acceleration
number
g
Accelerometer value Z
Message Type 0x02,
Message Type 0x04,
Message Type 0x06,
Message Type 0x07
Properties
Detect ACC
accdet
If this device can't get the right ACC signal from car, you can set it to TRUE, and device will use virbation and voltage as ACC ON and ACC OFF detection
acc_vibr: Use vibration and voltage as ACC
Backend Server Setup
backend_server
Main server parameters where the monitoring data will be transmitted to
host: Host
port: Port
Secondary Backend Server Setup
backend_server2
Secondary server parameters where the monitoring data will be transmitted to
host: Host
port: Port
Communication Mode Setup
dmode
Setup Communication mode: TCP/UDP
report_mode: Report mode
Output 1
dout1
Activate/deactivate digital output 1
enable: Enable
Output 2
dout2
Activate/deactivate digital output 2
enable: Enable
Output 3
dout3
Activate/deactivate digital output 3
enable: Enable
Setup Heartbeat Interval
hbt
hbt_interval: Heartbeat interval
Set the device odometer value
mileagec
odometer: Odometer value
GSM Network Setup
network
Access point settings for SIM card
apn: APN
password: APN Password
username: APN Username
Reboot
reboot
Reboot the device
Switch the relay
relay
After device get the command, it will check whether GPS fixed and the speed is lower than 20km/h then relay will be switched immidately, otherwise it will hold the command until, conditions met
switch_relay: Switch
Setup Report Workmode
timer
Setup report sending options: timing and angle/distance compensation
angle: Angle
distance: Distance
acc_on_period: ACC ON period
acc_off_period: ACC OFF period
Properties
Custom command
custom
Send custom command to device
name: Command name in capital letters
payload: Command data ending with #
Get device IP2 setting
{"name":"IP2","payload":",2#"}
Setup communication mode to UDP
{"name":"DMODE","payload":",2#"}
Set APN with username and password
{"name":"APN","payload":",APN_name,APN_username,APN_password#"}