Topflytech TLW1-8A

Topflytech TLW1-8A is a compact GPS tracker for versatile tracking applications with LTE support. The device features crash detection, motion detection, driver behavior monitoring, geo-fencing, 2 digital inputs, 1 digital output, 1 analog input, Bluetooth 4.0, FOTA, fuel level and temperature sensors support, and more.

Make your Topflytech TLW1-8A 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 Topflytech TLW1-8A with flespi.

Protocol: topflytech Manufacturer: Topflytech Change log: topflytech

Usage specifics

Parameters (106)

Settings (20)

Commands (1)

AI Assistant

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 TLW1-8A",
    "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'

Explore REST API Show more ways to consume data How to connect my Topflytech TLW1-8A to flespi

How to send commands to Topflytech TLW1-8A?

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

acceleration.array

array

Array of objects with acceleration data by x, y, and z axis

Message Type 0x16,
Message Type 0x18

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,
Message Type 0x16,
Message Type 0x18

alarm.event

boolean

Alarm event triggered

Alarm Code 3,
Alarm Type 3,
Message Type 0x10,
Message Type 0x12

alarm.time

number

seconds

Accumulated time of the specific alarm

Message Type 0x13,
Message Type 0x14

antitheft.event

boolean

Antitheft event triggered

Alarm Type 10

average.fuel.consumption

number

liters/100km

Average fuel consumption

Message Type 0x02,
Message Type 0x04,
Message Type 0x16,
Message Type 0x18

battery.level

number

percentage

Internal battery level

Message Type 0x02,
Message Type 0x04,
Message Type 0x13,
Message Type 0x14,
Message Type 0x16,
Message Type 0x18

battery.low.status

boolean

Battery low status

Alarm Code 6,
Alarm Code 7,
Alarm Type 2,
Alarm Type 24

battery.voltage

number

volts

Internal battery voltage

Message Type 0x02,
Message Type 0x13,
Message Type 0x14

ble.beacons

array

Standard parameter names used: *id* - beacon identification string. Usually it is beacon's UUID or MAC-address *local_name* - Beacons's Local Name *rssi* - BLE signal level. Units = dBm *battery.voltage* - Beacon's battery voltage. Units = volts *battery.level* - Beacon's battery level. Units = percentage *temperature* - Beacon's temperature. Units = celsius

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

can.dtc

array

Diagnostic trouble code array read from CAN May content list of OBDII codes or list of objects with codes. Standard object parameter names used: *standard* - Protocol standard (J1939, J1708(J1587), OBDII) *mid* - Message Identifier (J1708) *sid* - Subsystem Identifier (J1708) *fmi* - Failure Mode Identifier (J1939, J1708) *spn* - Suspect Parameter Number (J1939) *sa* - Source Address (J1939, OBDII) *oc* - Occurrence Count (J1939) *cm* - Conversion Method (J1939) *status* - Status of error code (active, pending, historical, permanent)

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,
Message Type 0x13,
Message Type 0x14,
Message Type 0x16,
Message Type 0x18

can.engine.load.level

number

percentage

Calculated engine load level read from CAN

Message Type 0x02,
Message Type 0x04,
Message Type 0x13,
Message Type 0x14,
Message Type 0x16,
Message Type 0x18

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,
Message Type 0x16,
Message Type 0x18

can.fuel.consumed

number

liters

Fuel volume totally consumed by vehicle read from CAN

Message Type 0x13,
Message Type 0x14

can.fuel.level

number

percentage

Fuel level in tank read from CAN

Message Type 0x02,
Message Type 0x13,
Message Type 0x14,
Message Type 0x16,
Message Type 0x18

can.fuel.volume

number

liters

CAN fuel volume

Message Type 0x02,
Message Type 0x16,
Message Type 0x18

can.intake.air.temperature

number

celsius

Intake air temperature

Message Type 0x02,
Message Type 0x04,
Message Type 0x16,
Message Type 0x18

can.intake.map

number

kPa

Intake manifold absolute pressure

Message Type 0x02,
Message Type 0x04,
Message Type 0x16,
Message Type 0x18

can.maf.air.flow.rate

number

g/sec

MAF air flow rate read from CAN

Message Type 0x02,
Message Type 0x04,
Message Type 0x16,
Message Type 0x18

can.throttle.pedal.level

number

percentage

Throttle pedal push level read from CAN

Message Type 0x02,
Message Type 0x04,
Message Type 0x16,
Message Type 0x18

can.vehicle.speed

number

km/h

Vehicle speed read from CAN

Message Type 0x13,
Message Type 0x14

case.status

boolean

Case opened status

Alarm Code 2,
Alarm Code 22

channel.id

number

ID of channel that received a message

crash.status

boolean

Crash event status true - collision detected, false - collision stopped

Alarm Code 10,
Alarm Code 27

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

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

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,
Message Type 0x16,
Message Type 0x18

displacement.status

boolean

Device displacement status true - device removed, false - device mounted (triggered by back light sensor)

Alarm Code 1,
Alarm Code 21

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 (fuel cutoff relay), true - engine is blocked, false - engine isn't blocked

Message Type 0x02,
Message Type 0x13,
Message Type 0x14,
Message Type 0x16,
Message Type 0x18

engine.ignition.status

boolean

Engine ignition or ACC status

Alarm Code 16,
Alarm Code 17,
Bit14 of Digital I/O status,
Bit2 of Status,
Message Type 0x02,
Message Type 0x04,
Message Type 0x10,
Message Type 0x12,
Message Type 0x13,
Message Type 0x14,
Message Type 0x16,
Message Type 0x18,
Message Type 0x21,
Message Type 0x23

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 0x04,
Message Type 0x13,
Message Type 0x14,
Message Type 0x16,
Message Type 0x18,
Message Type 0x24,
Message Type 0x25

external.powersource.status

boolean

External power source connection status

Alarm Type 1,
Message Type 0x02,
Message Type 0x04,
Message Type 0x13,
Message Type 0x14,
Message Type 0x16,
Message Type 0x18

external.powersource.voltage

number

volts

External power voltage

Message Type 0x02,
Message Type 0x04,
Message Type 0x13,
Message Type 0x14,
Message Type 0x16,
Message Type 0x18

fall.status

boolean

Device fall status true - device is falling, false - falling stopped

Alarm Code 24,
Alarm Code 5

fuel.consumed

number

liters

Fuel volume totally consumed by vehicle

Message Type 0x02,
Message Type 0x04,
Message Type 0x16,
Message Type 0x18

geofence.status

boolean

Geofence entered status

Alarm Code 14,
Alarm Code 15,
Alarm Type 5,
Alarm Type 6

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 0x16,
Message Type 0x17,
Message Type 0x18,
Message Type 0x24,
Message Type 0x25

gsm.cellid

number

Mobile network (GSM, 3G, 4G, LTE, 5G, ...) base station ID

gsm.jamming.event

boolean

Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal jamming detected

Alarm Type 21,
Alarm Type 22

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

Message Type 0x05,
Message Type 0x11

gsm.pcid

number

Physical layer Cell ID in the Mobile network (LTE and NR)

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,
Message Type 0x16,
Message Type 0x18

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 Type 19,
Alarm Type 20

light.sensor.voltage

number

volts

Front light sensor voltage

Message Type 0x02

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

string

Message type

movement.distance

number

meters

Distance since last Location or Alarm data on Ignition On state

Message Type 0x13

movement.event

boolean

Movement detected

Alarm Type 8

movement.status

boolean

Current movement state

Message Type 0x02

onewire.payload.hex

string

OneWire HEX payload received from device

Message Type 0x23

onewire.sensor.serial

string

External 1-Wire sensor serial number in HEX representation

Message Type 0x23

overspeeding.event

boolean

Overspeeding detected

Alarm Type 4,
Message Type 0x05

payload.text

string

Text Payload received from device

Message Type 0x81

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 0x16,
Message Type 0x17,
Message Type 0x18,
Message Type 0x24,
Message Type 0x25

position.direction

number

degrees

Heading angle at position detection moment

position.hdop

number

Horizontal dilution of precision

Message Type 0x13,
Message Type 0x14,
Message Type 0x24,
Message Type 0x25

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

position.speed

number

km/h

Instant speed at position detection moment

position.valid

boolean

Is position information accurate and valid for given timestamp

power.on.status

boolean

Power-on device status

Alarm Code 20,
Alarm Code 29

protocol.id

number

ID of protocol

report.reason

number

Transmission reason code

rs485.device.id

number

ID of device connected to RS-485

Message Type 0x21

rs485.payload.hex

string

RS485 HEX payload received from device

Message Type 0x21

server.timestamp

number

seconds

Timestamp when server received a message

solar.panel.charging.status

boolean

Solar panel charging device

Message Type 0x02

solar.panel.voltage

number

volts

Solar panel voltage

Message Type 0x02

tilt.status

boolean

Device tilt status (true - device is tilted, false - device is in normal position)

Alarm Code 11,
Alarm Code 28

timestamp

number

seconds

Message timestamp

Message Type 0x02,
Message Type 0x04,
Message Type 0x05,
Message Type 0x06,
Message Type 0x07,
Message Type 0x09,
Message Type 0x10,
Message Type 0x11,
Message Type 0x12,
Message Type 0x13,
Message Type 0x14,
Message Type 0x15,
Message Type 0x16,
Message Type 0x17,
Message Type 0x18,
Message Type 0x21,
Message Type 0x22,
Message Type 0x23,
Message Type 0x24,
Message Type 0x25

time.valid.status

boolean

Time is accurate

towing.alarm.status

boolean

Towing alarm state

Alarm Type 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

vehicle.mileage

number

Total calculated mileage

Message Type 0x02,
Message Type 0x04,
Message Type 0x13,
Message Type 0x14,
Message Type 0x16,
Message Type 0x18

vehicle.vin

string

VIN of vehicle

Message Type 0x09,
Message Type 0x22

vibration.status

boolean

Vibration status of the device. true - device is vibrated, false - device is in still state

Alarm Code 26,
Alarm Code 9

wifi.mac.address

string

WiFi MAC address

Message Type 0x15,
Message Type 0x24,
Message Type 0x25

wifi.signal.strength

number

WiFi signal strength, RSSI

Message Type 0x15,
Message Type 0x24,
Message Type 0x25

x.acceleration

number

Accelerometer value X

Message Type 0x02,
Message Type 0x06,
Message Type 0x07

y.acceleration

number

Accelerometer value Y

Message Type 0x02,
Message Type 0x06,
Message Type 0x07

z.acceleration

number

Accelerometer value Z

Message Type 0x02,
Message Type 0x06,
Message Type 0x07

Title

Name

Description

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

Setup Low Power Alert

aepower

Send low power alert if power supply voltage is lower than specified value

send_sms: Duplicate alert over SMS

threshold: Threshold power value

Enable/Disable Antitheft (ACC ON) Alert

antitheft

enable: Enable Antitheft alert

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

Enable Connection to 2 Target Hosts

bothip

enable: Enable 2 IP work together

Enable/Disable BT

enable_bt: Enable BT

Communication Mode Setup

dmode

Setup Communication mode: TCP/UDP

report_mode: Report mode

Setup Drag alert

drag

time: Vibration detection time

towing_distance: Send alert after specified number of meters moved

Setup Heartbeat Interval

hbt

hbt_interval: Heartbeat interval

Turn LED on/off

ledon

led: Turn on LED

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

Control Relay Workmode

rlymode

Switch relay with speed control or not. Cyclic relay switch on and off.

mode: Relay workmode

Control Network Modem and GPS Modem Sleep Mode

sleepmode

Control network modem and GPS modem status when ACC OFF and no vibration (when sleep network still keep alive with server)

mode: Sleepmode: when acc off and no vibration

Speed Limit for Overspeeding Event

speed

speed: Speed

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

Setup Vibration Alert

vibration

Vibration alert will be raised if the following conditions are met: 1. ACC is OFF for "inactive state period" seconds 2. Vibration detected for "motion period" seconds 3. ACC is still OFF for "later period" seconds

later_period: ACC still OFF after vibration period

motion_period: ACC OFF period

inactive_period: Inactive state period

vibration_sensitivity: Vibration sensitivity

Title

Name

Description

Properties

Custom command Examples

custom

Send custom command to device

payload: Command payload