Protocol used by GPS tracking devices manufactured by KingSword ComTech (Shenzhen) Co., Ltd headquartered in China.
flespi parses the Kingsword protocol messages into a JSON object with the
fields listed below in the Parameters tab.
To connect your tracker using the Kingsword protocol, you need to have a kingsword channel created first.
Point your tracker to the channel's domain name:port via SMS or configuration tool provided by the vendor.
Then create a device instance for your tracker and use a 15-character IMEI (usually specified on the tracker casing) in the ident field.
Use the Toolbox tab on the device screen to check if the messages are coming.
adc.alarm
boolean
ADC alarm
Device status code
alarm.event
boolean
Alarm event triggered
Device status code
battery.level
number
percentage
Internal battery level
Command key word AM,
Command key word CC,
Command key word DW,
Command key word HB
Command key word CC,
Command key word DW,
Command key word HB
battery.low.alarm
boolean
Battery low alarm event
Device status code
channel.id
number
ID of channel that received a message
device.id
number
ID of device that received a message
device.name
string
Name of device that received a message
device.type.id
number
ID of device type of device that received a message
din
number
Digital inputs bitmask
Device status code
dout
number
Digital outputs bitmask
Device status code
driving.status
boolean
Car is driving status
Device status code
engine.ignition.status
boolean
Engine ignition or ACC status
Device status code
fuel.level
number
percentage
Fuel level percentage
Command key word AM,
Command key word CC,
Command key word DW,
Command key word HB
Command key word CC,
Command key word DW,
Command key word HB
fuel.level.alarm
boolean
Fuel level alarm triggered
Device status code
geofence.status
boolean
Geofence entered status
Device status code
gnss.status
boolean
GNSS receiver on/off status
Device status code
gsm.cellid
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) base station ID
Command key word JZ
gsm.jamming.event
boolean
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal jamming detected
Device status code
gsm.lac
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) location area code
Command key word JZ
gsm.mcc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) country code
Command key word JZ
gsm.mnc
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) code
Command key word JZ
gsm.signal.level
number
percentage
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal strength level
Command key word AM,
Command key word CC,
Command key word DW,
Command key word HB
Command key word CC,
Command key word DW,
Command key word HB
harsh.acceleration.event
boolean
Harsh acceleration detected
Device status code
harsh.braking.event
boolean
Harsh braking detected
Device status code
ident
string
Device unique identifier like serial number, IMEI, etc
movement.event
boolean
Movement detected
Device status code
overspeeding.event
boolean
Overspeeding detected
Device status code
peer
string
IP:port from which device connecting to the channel
position.altitude
number
meters
Altitude value for position
Command key word AM,
Command key word CC,
Command key word DW,
Command key word HB
Command key word CC,
Command key word DW,
Command key word HB
position.direction
number
degrees
Heading angle at position detection moment
Command key word AM,
Command key word CC,
Command key word DW,
Command key word HB
Command key word CC,
Command key word DW,
Command key word HB
position.latitude
number
degrees
Latitude coordinate value
Command key word AM,
Command key word CC,
Command key word DW,
Command key word HB
Command key word CC,
Command key word DW,
Command key word HB
position.longitude
number
degrees
Longitude coordinate value
Command key word AM,
Command key word CC,
Command key word DW,
Command key word HB
Command key word CC,
Command key word DW,
Command key word HB
position.speed
number
km/h
Instant speed at position detection moment
Command key word AM,
Command key word CC,
Command key word DW,
Command key word HB
Command key word CC,
Command key word DW,
Command key word HB
position.valid
boolean
Is position information accurate and valid for given timestamp
Command key word AM,
Command key word CC,
Command key word DW,
Command key word HB
Command key word CC,
Command key word DW,
Command key word HB
power.cut.alarm
boolean
External power cut-off alarm event
Device status code
protocol.id
number
ID of protocol
report.code
string
Report code
rfid.code
string
Hexadecimal code of connected RFID
Command key word HB
sensor.temperature
number
celsius
Temperature sensor value
Command key word HB
server.timestamp
number
seconds
Timestamp when server received a message
sleep.mode.status
boolean
Device is in sleep mode
Device status code
sos.alarm
boolean
SOS alarm trigerred
Device status code
temperature.alarm
boolean
Temperature value is outside of predefined range
Device status code
timestamp
number
seconds
Message timestamp
Command key word AM,
Command key word CC,
Command key word DW,
Command key word HB
Command key word CC,
Command key word DW,
Command key word HB
urgent.brake.event
boolean
Urgent brake alarm event
Device status code
vehicle.mileage
number
km
Total calculated mileage
Command key word AM,
Command key word CC,
Command key word DW,
Command key word HB
Command key word CC,
Command key word DW,
Command key word HB
vehicle.state.bitmask
number
Vehicle state flags bitmask
Device status code
vibration.alarm
boolean
Vibration alarm event
Device status code
Properties
Custom command
Examples
custom
Send custom command to device
text: Text payload
wait_response: Wait Response
Tags
