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)

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

accident.event

boolean

Accident event detected

ain

number

volts

Voltage on the analog input

alarm.event

boolean

Alarm event triggered

antitheft.event

boolean

Antitheft event triggered

average.fuel.consumption

number

liters/100km

Average fuel consumption

battery.level

number

percentage

Internal battery level

battery.low.alarm

boolean

Battery low alarm event

battery.low.status

boolean

Battery low status

battery.voltage

number

volts

Internal battery voltage

ble.asset.rssi

number

BLE (Bluetooth Low Energy) asset signal strength

ble.asset.tag.code

string

BLE (Bluetooth Low Energy) asset tag ID

ble.door.open.status

boolean

BLE (Bluetooth Low Energy) door opened status

ble.relay.id

string

BLE relay ID

ble.relay.status

boolean

BLE relay status, true - ON, false - OFF

ble.sensor.battery.level

number

percentage

BLE (Bluetooth Low Energy) sensor battery level

ble.sensor.battery.voltage

number

volts

BLE (Bluetooth Low Energy) sensor battery voltage

ble.sensor.humidity

number

percentage

BLE (Bluetooth Low Energy) sensor Humidity value

ble.sensor.illuminance

number

lux

BLE (Bluetooth Low Energy) sensor illuminance

ble.sensor.light.status

boolean

BLE (Bluetooth Low Energy) light status: false - light off, true - light on

ble.sensor.state

number

BLE (Bluetooth Low Energy) sensor state

ble.sensor.temperature

number

celsius

BLE (Bluetooth Low Energy) sensor Temperature value

box.status

boolean

Box status (true - box is opened, false - box is closed)

can.dtc

string

Diagnostic trouble code read from CAN

can.dtc.state

number

DTC state: 1 - confirmed error, 2 - con confirmed error (error probably is, may disappear or happen again)

can.engine.coolant.temperature

number

celsius

Engine coolant temperature read from CAN

can.engine.load.level

number

percentage

Calculated engine load level read from CAN

can.engine.rpm

number

rpm

Engine RPM read from CAN

can.fuel.level

number

percentage

Fuel level in tank read from CAN

can.intake.air.temperature

number

celsius

Intake air temperature

can.intake.map

number

kPa

Intake manifold absolute pressure

can.maf.air.flow.rate

number

g/sec

MAF air flow rate read from CAN

can.throttle.pedal.level

number

percentage

Throttle pedal push level read from CAN

case.status

boolean

Case opened status

channel.id

number

ID of channel that received a message

collision.status

boolean

Collision status: true - collision detected, false - collision stopped

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

device.temperature.high.status

boolean

Device temperature high status: true - device temperature is higher than predefined threshold, false - device temperature is in normal range

device.temperature.low.status

boolean

Device temperature low status: true - device temperature is lower than predefined threshold, false - device temperature is in normal range

device.type.id

number

ID of device type of device that received a message

din

number

Digital inputs bitmask

displacement.status

boolean

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

dout

number

Digital outputs bitmask

driver.id

string

Driver identification card id

engine.blocked.status

boolean

Engine blocked status, true - engine is blocked, false - engine isn't blocked

engine.ignition.status

boolean

Engine ignition status

engine.rpm

number

rpm

Engine RPM read

event.code

string

Protocol-specific event code string

event.enum

number

Protocol-specific event code

external.powersource.status

boolean

External power source connection status

external.powersource.voltage

number

volts

External power voltage

fall.status

boolean

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

fuel.consumed

number

liters

Fuel volume totally consumed by vehicle

geofence.status

boolean

Geofence entered status

gnss.status

boolean

GNSS receiver on/off status

gsm.cellid

number

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

gsm.earfcn

number

E-UTRA absolute radio-frequency channel number of the Mobile network (LTE)

gsm.jamming.event

boolean

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

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

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

gsm.sim.iccid

string

Integrated Circuit Card Id of SIM card of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)

gsm.sim.imsi

string

IMSI of SIM card of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)

harsh.acceleration.event

boolean

Harsh acceleration detected

harsh.braking.event

boolean

Harsh braking detected

harsh.cornering.event

boolean

Harsh cornering detected

ident

string

Device unique identifier like serial number, IMEI, etc

idle.status

boolean

Vehicle is in idling state

light.sensor.voltage

number

volts

Front light sensor voltage

lock.data

string

Lock data in HEX format

lock.state

number

Numeric value of a lock status

message.buffered.status

boolean

Black box message

message.type

string

Message type

movement.event

boolean

Movement detected

movement.status

boolean

Current movement state

overspeeding.event

boolean

Overspeeding detected

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

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

solar.panel.voltage

number

volts

Solar panel voltage

tilt.status

boolean

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

timestamp

number

seconds

Message timestamp

tire.pressure

number

bar

Tire pressure

tire.temperature

number

celsius

Tire temperature

towing.alarm.status

boolean

Towing alarm state

usb.connection.status

boolean

Status of USB connection (true - USB cable is connected, false - USB cable is disconnected)

vehicle.mileage

number

Total calculated mileage

vehicle.vin

string

VIN of vehicle

vibration.status

boolean

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

x.acceleration

number

Accelerometer value X

y.acceleration

number

Accelerometer value Y

z.acceleration

number

Accelerometer value Z

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

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

name: Command name in capital letters