suntech

This protocol is used by all Suntech GPS tracking devices.

Below is the list of parameters that can appear in the messages received by the channel via suntech protocol. In most parameters, the name consists of tags split by dots: tag1.tag2.tag3.tag4... Each tag defines a certain area of an application, e.g. any parameter that contains mileage data has the 'mileage' tag in the name and any parameter related to fuel control contains the 'fuel' tag. By default JSON fields of the message received by a channel via this protocol can only contain the below-specified parameters. Any additional parameter will be prefixed by the "custom" tag, e.g. "custom.unspecified-name".

Name Type Unit Description
absolute.acceleration number g Module of accelerometer vector
ain number volts Voltage on the analog input
alarm.code number Alarm ID Numer
alarm.data string Alarm additional data
alarm.event boolean Alarm event triggered
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.voltage number volts Backup battery voltage
battery.low.alarm boolean Battery low alarm event
battery.voltage number volts Internal battery voltage
box.status boolean Box status: true -opened, false - 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.dtc string Diagnostic trouble code read from CAN
can.dtc.number number Number of diagnostic trouble codes
can.fuel.consumed number liters Fuel volume totally consumed by vehicle 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
engine.ignition.status boolean Engine ignition status
engine.motorhours number hours Total calculated engine motorhours
engine.rpm number rpm Engine RPM read from CAN
event.enum number Event code, full list of codes available at separate table
event.seqnum number Unique event sequence number
external.powersource.voltage number volts External power voltage
fuel.sensor.value string mm Level of Fuel Sensor in mm. In case of Omnicomm shows raw value
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.vehicle.mileage number km Vehicle mileage calculated by global navigation system (GNSS)
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
ident string Device unique identificator and optional password
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
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 Operating mode
overspeeding.event boolean Overspeeding detected
overspeeding.status boolean Overspeeding detected
parking.lock.status boolean Emergency report parking lock event
payload.hex string HEX 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
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
tacho.driver.card.code string Driver identification card id for tacho
tacho.driver.card.status boolean Tacho driver card presence
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.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.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
x.acceleration number g Accelerometer value X

Below is the list of commands that can be sent to devices to change their configuration or to send signals to various outputs. When sending a command you can specify the transport type defining how the command will be delivered - the address parameter can take values connection (via network connection once the device goes online), sms (via SMS message), push (via PUSH notification). A comprehensive format of each command with all possible parameter values, parameter types, default values, etc. can be found in the REST API documentation in your flespi.io account.

Title Name Description Properties
Custom command custom Send custom command to device payload: Text data to send
Request the device of fmaily ST300 and ident 100850000 to report parameters setting values and current device status
{"payload":"ST300CMD;100850000;02;Preset"}