Topflytech SolarGuard X200

The SolarGuardX 200 is a solar-powered cargo GPS padlock optimized for outdoor asset tracking with a rugged construction and a super long-life battery. Compatible with 4G/3G/2G networks, it facilitates real-time location tracking, multiple control modes via RFID, BLE, SMS, and OTA, and provides high-powered performance with a 14400 mAh battery. The padlock features IP67 waterproofing, motion detection, BLE 5.1, strong magnet for easy installation, built-in geofence, and security alarms for various events including rope cutting.

Usage specifics
Parameters (105)
Settings (9)
Commands (1)
Topflytech SolarGuard X200
Flespi parses telemetry data from your Topflytech SolarGuard X200 into a standardized JSON and lets you send commands to Topflytech SolarGuard X200 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 SolarGuard X200",
    "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 SolarGuard X200?

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,
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
battery.level
number
percentage
Internal battery level
Message Type 0x02,
Message Type 0x04,
Message Type 0x13,
Message Type 0x14
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
Array with all detected BLE beacons data objects. Each object contain list of associated parameters sent by appropriate beacon. 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
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
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
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.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 0x04,
Message Type 0x13,
Message Type 0x14
can.fuel.volume
number
liters
CAN fuel volume
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
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
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
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 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 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
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
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 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 0x17,
Message Type 0x24,
Message Type 0x25
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,
Message Type 0x24,
Message Type 0x25
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
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 0x24,
Message Type 0x25
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,
Message Type 0x24,
Message Type 0x25
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,
Message Type 0x24,
Message Type 0x25
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,
Message Type 0x24,
Message Type 0x25
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 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 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 0x24,
Message Type 0x25
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.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 0x17,
Message Type 0x24,
Message Type 0x25
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,
Message Type 0x24,
Message Type 0x25
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
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,
Message Type 0x24,
Message Type 0x25
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,
Message Type 0x24,
Message Type 0x25
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,
Message Type 0x24,
Message Type 0x25
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,
Message Type 0x24,
Message Type 0x25
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,
Message Type 0x24,
Message Type 0x25
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 0x17,
Message Type 0x21,
Message Type 0x22,
Message Type 0x23,
Message Type 0x24,
Message Type 0x25
time.valid.status
boolean
Time is accurate
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 0x17,
Message Type 0x21,
Message Type 0x22,
Message Type 0x23,
Message Type 0x24,
Message Type 0x25
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
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,
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
g
Accelerometer value X
Message Type 0x02,
Message Type 0x06,
Message Type 0x07
y.acceleration
number
g
Accelerometer value Y
Message Type 0x02,
Message Type 0x06,
Message Type 0x07
z.acceleration
number
g
Accelerometer value Z
Message Type 0x02,
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
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
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
payload: Command data ending with #
Get device IP2 setting
{"payload":"IP2,2#"}
Setup communication mode to UDP
{"payload":"DMODE,2#"}
Set APN with username and password
{"payload":"APN,APN_name,APN_username,APN_password#"}