Suntech protocol

Integration level: params + settings
Protocol used by GPS tracking devices manufactured by Suntech headquartered in South Korea.
flespi parses the Suntech protocol messages into a JSON object with the fields listed below in the Parameters tab.

Step-by-step guide on how-to obtain telematics data from Suntech devices via API in 5 easy steps.

To connect your tracker using the Suntech protocol, you need to have a suntech 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.

It is possible to configure Suntech devices OTA using the flespi web-based configurator tool. To connect Suntech to Wialon or another platform via flespi please read this article.

absolute.acceleration
number
g
Module of accelerometer vector
ain
number
volts
Voltage on the analog input
alarm.code
number
Protocol-specific alarm code number
alarm.data
string
Alarm additional data
alarm.event
boolean
Alarm event triggered
alarm.panic.status
boolean
Panic alarm event occured
alcohol.fuel.percentage
number
percentage
Alcohol fuel percentage
antitheft.door.status
boolean
Emergency report by antitheft door
antitheft.event
boolean
Antitheft event triggered
antitheft.shock.status
boolean
Emergency report by antitheft shock
backup.battery.level
number
percentage
Backup battery level
backup.battery.voltage
number
volts
Backup battery voltage
battery.connected.status
boolean
Internal battery is connected
battery.level
number
percentage
Internal battery level
battery.low.alarm
boolean
Battery low alarm event
battery.voltage
number
volts
Internal battery voltage
box.status
boolean
Box status (true - box is opened, false - box is closed)
brake.acceleration
number
g
Acceleration on brake
bus.counter.passengers.in
number
The number of people riding on the bus
bus.counter.passengers.out
number
The number of people get off the bus
can.absolute.load
number
percentage
Absolute load value - the normalized value of air mass per intake stroke, read from CAN
can.accelerator.pedal.position
number
percentage
Accelerator pedal position read from CAN, index 1 - sensor D, index 2 - sensor E, etc
can.ambient.air.temperature
number
celsius
CAN ambient air temperature
can.barometric.pressure
number
kPa
Absolute barometric pressure read fron CAN
can.catalyst.temperature
number
degrees
Catalyst temperature of the corresponding oxygen sensor read from CAN
can.commanded.egr
number
percentage
Commanded EGR value read from CAN
can.control.module.voltage
number
volts
Control module voltage read from CAN
can.direct.fuel.rail.pressure
number
kPa
Fuel rail gauge pressure for diesel or gasoline direct injection
can.dtc
string
Diagnostic trouble code read from CAN
can.dtc.cleared.engine.time
number
hours
Engine runtime since DTCs cleared, read from CAN
can.dtc.cleared.mileage
number
km
Vehicle mileage since diagnostic trouble codes were cleared, read from CAN
can.dtc.cleared.warmups
number
Number of warm-ups since DTCs cleared read from CAN
can.dtc.number
number
Number of diagnostic trouble codes
can.egr.error
number
percentage
EGR Error read from CAN
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.motorhours
number
hours
Total engine motorhours read from CAN
can.engine.oil.pressure
number
kPa
CAN Engine oil pressure
can.engine.rpm
number
rpm
Engine RPM read from CAN
can.engine.run.time
number
seconds
Run time since engine start read from CAN
can.equivalence.ratio
number
Fuel-air commanded equivalence ratio read from CAN
can.evaporative.purge
number
percentage
Commanded evaporative purge read from CAN
can.evap.vapor.pressure
number
Pa
EVAP system vapor pressure, read from CAN
can.fuel.consumed
number
liters
Fuel volume totally consumed by vehicle read from CAN
can.fuel.level
number
percentage
Fuel level in tank read from CAN
can.fuel.pressure
number
kPa
Fuel pressure
can.fuel.system.state
number
Fuel system status read from CAN, bits 0 - open loop, 1 - closed loop, 2 - open loop drive, 3 - open loop fault, 4 - closed loop fault
can.fuel.type.enum
number
Fuel type read from CAN
can.intake.air.temperature
number
celsius
Intake air temperature
can.intake.map
number
kPa
Intake manifold absolute pressure
can.long.fuel.trim
number
percentage
Short term fuel trim read from CAN
can.maf.air.flow.rate
number
g/sec
MAF air flow rate read from CAN
can.maf.max.air.flow.rate
number
g/sec
Maximum value for air flow rate from mass air flow sensor, read from CAN
can.mil.mileage
number
km
Distance traveled while malfunction indicator lamp is activated, read from CAN
can.mil.status
boolean
Malfunction indicator lamp status read from CAN
can.mil.time
number
hours
Time run with malfunction indicator lamp activated, read from CAN
can.monitor.status
number
Monitor status this drive cycle read from CAN, bitmask
can.oxygen.sensor.current
number
mA
Oxygen sensor current read from CAN
can.oxygen.sensor.fuel.air.ratio
number
Fuel-air equivalence ratio for the corresponding oxygen sensor read from CAN
can.oxygen.sensor.fuel.trim
number
percentage
Short term fuel trim associated with current oxygen sensor
can.oxygen.sensor.max.current
number
mA
Maximum value for Oxygen sensor current
can.oxygen.sensor.max.fuel.air.ratio
number
Maximum value for the equivalence ratio of Oxygen sensor
can.oxygen.sensor.max.pressure
number
kPa
Maximum value for intake manifold absolute pressure
can.oxygen.sensor.max.voltage
number
volts
Maximum value for Oxygen sensor voltage
can.oxygen.sensor.output.voltage
number
volts
Oxygen sensor output voltage read from CAN
can.oxygen.sensors.state
number
Location of oxygen sensors, bits 0 - sensor 1, 1 - sensor 2, 2 - sensor 3 etc. Bank1 sensors 1,2, bank 2 sensors 3,4 etc.
can.oxygen.sensor.voltage
number
volts
Voltage of the corresponding oxygen sensor read from CAN
can.relative.fuel.rail.pressure
number
kPa
Fuel rail pressure relative to manifold vacuum
can.relative.throttle.position
number
percentage
Relative throttle position read from CAN
can.secondary.air.state
number
Commanded secondary air status read from CAN
can.secondary.long.fuel.trim
number
percentage
Long term secondary oxygen sensor fuel trim, index - the number of bank
can.secondary.short.fuel.trim
number
percentage
Short term secondary oxygen sensor fuel trim, index - the number of bank
can.short.fuel.trim
number
percentage
Short term fuel trim read from CAN
can.throttle.actuator
number
percentage
Commanded throttle actuator position read from CAN
can.throttle.position
number
percentage
Ansolute throttle position for corresponding throttle position sensor read from CAN, index 1 - sensor A, index 2 - sensor B, index 3 - sensor C, etc
can.timing.advance
number
degrees
Ignition timing advance read from CAN
can.vehicle.mileage
number
km
Total vehicle mileage read from CAN
can.vehicle.speed
number
km/h
Vehicle speed read from CAN
channel.id
number
ID of channel that received a message
device.id
number
ID of device that received a message
device.model
string
Device model ID string
device.name
string
Name of device that received a message
device.serial.number
string
Device serial number
device.type.id
number
ID of device type of device that received a message
din
number
Digital inputs bitmask
dout
number
Digital outputs bitmask
driver.id
string
Driver identification card id
engine.ignition.status
boolean
Engine ignition status
engine.motorhours
number
hours
Total calculated engine motorhours
engine.rpm
number
rpm
Engine RPM read
event.code
string
Protocol-specific event code string
event.enum
number
Protocol-specific event code
event.seqnum
number
Unique event sequence number
external.powersource.voltage
number
volts
External power voltage
fuel.sensor.value
number
Value reported by fuel sensor
geofence.id
number
Geofence ID
geofence.status
boolean
Geofence entered status
gnss.antenna.status
boolean
GNSS receiver antenna status
gnss.jamming.status
boolean
GNSS receiver signal jamming detected
gnss.odometer
number
Odometer value calculated from GNSS data
gnss.vehicle.mileage
number
km
Vehicle mileage calculated by global navigation system (GNSS)
gsm.bsic
number
Base station identity code
gsm.cellid
number
GSM base station ID
gsm.jamming.event
boolean
GSM signal jamming detected
gsm.lac
number
GSM location area code
gsm.mcc
string
GSM mobile country code
gsm.mnc
string
GSM mobile network code
gsm.network.status
boolean
Registration in GSM network
gsm.signal.dbm
number
dbm
Strength of GSM signal
gsm.sim.status
boolean
SIM card is active
gsm.timing.advance
number
GSM timing advance
harsh.acceleration.event
boolean
Harsh acceleration detected
harsh.braking.event
boolean
Harsh braking detected
harsh.cornering.event
boolean
Harsh cornering detected
histogram.speed.bin.counts
number
km/h
Counts of speed in the each of bins
histogram.speed.bin.values
number
km/h
Speed values that make the range for each BIN
ibutton.authorized.status
boolean
iButton authorized status
ibutton.code
string
Hexadecimal code of connected iButton
ident
string
Device unique identifier like serial number, IMEI, etc
idle.status
boolean
Vehicle is in idling state
message.buffered.status
boolean
Black box message
movement.event
boolean
Movement detected
movement.status
boolean
Current movement state
network.channel
number
Radiofrequency channel number in collaborative network
network.signal.rssi
number
dbm
Network signal strength
network.status
boolean
Collaborative network status: true - enabled. false - disabled
obd.pid
string
OBD PID indexed parameter value
obd.standard.enum
number
OBD standards this vehicle conforms to
onewire.sensor.serial
string
External 1-Wire sensor serial number in HEX representation
onewire.sensor.temperature
number
celsius
External 1-Wire temperature sensor value
operating.mode.enum
number
Protocol-specific device operating mode
overspeeding.event
boolean
Overspeeding detected
overspeeding.status
boolean
Overspeeding detected
overspeeding.time
number
seconds
Overspeeding time
parking.lock.status
boolean
Emergency report parking lock event
payload.hex
string
HEX Payload received from device
payload.text
string
Text Payload received from device
peer
string
IP:port from which device connecting to the channel
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
profile.version
string
The last downloaded profile version
protocol.id
number
ID of protocol
segment.average.speed
number
km/h
Average speed for time report
segment.duration
number
seconds
Segment duration
segment.max.speed
number
km/h
Maximum speed on the segment
server.timestamp
number
seconds
Timestamp when server received a message
software.version
string
Software version string
timestamp
number
seconds
Message timestamp
total.coins
number
Value of connected cons machine. Resets to 0 when ignition off
towing.event
boolean
Towing event detected
trip.average.speed
number
km/h
Average speed of the trip
trip.duration
number
seconds
Trip duration
trip.engine.motorhours
number
hours
Engine hours for current trip
trip.idle.events
number
The number of idle events during trip
trip.idle.time
number
seconds
Time the vehicle was idle based on GPS and accelerometer information, according to corresponding threshold
trip.max.speed
number
km/h
Maximum speed of the trip
trip.mileage
number
km
Distance driven since engine start
trip.overspeed.duration
number
Accumulated time that the car exceeded overspeed limit
trip.overspeed.events
number
The number of overspeed events during trip
trip.start.latitude
number
degrees
Trip start latitude coordinate value
trip.start.longitude
number
degrees
Trip start longitude coordinate value
trip.stop.latitude
number
degrees
Trip stop latitude coordinate value
trip.stop.longitude
number
degrees
Trip stop longitude coordinate value
turn.acceleration
number
g
Acceleration on turn
vehicle.mileage
number
km
Total calculated mileage
vehicle.vin
string
VIN of vehicle
x.acceleration
number
g
Accelerometer value X
Properties
Custom command
custom
Send custom command to device
payload: Text data to send
Request the device of family ST300 and ident 100850000 to report parameters setting values and current device status
{"payload":"ST300CMD;100850000;02;Preset"}