Suntech ST3940B
Make your Suntech ST3940B 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 Suntech ST3940B with flespi.
Usage specifics
Parameters (192)
Settings (5)
Commands (1)
Suntech ST3940B
Flespi parses telemetry data from your Suntech ST3940B into a standardized JSON and
lets you send commands to Suntech ST3940B 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": "Suntech ST3940B",
"channel.id": 1111,
"protocol.id": "suntech"
"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 Suntech ST3940B?
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 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
ble.sensor.payload.hex
string
HEX Payload received from BLE sensor
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 (engine work time) 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.economy
number
km/liters
CAN instantaneous fuel economy
can.fuel.level
number
percentage
Fuel level in tank read from CAN
can.fuel.pressure
number
kPa
Fuel pressure read from CAN
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.temperature
number
celsius
Temperature of device
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
driving.cumulative.time
number
minutes
Driving cumulative time
engine.ignition.status
boolean
Engine ignition or ACC 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.shape
string
Geofence shape
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 of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)
gsm.cellid
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) base station ID
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.status
boolean
Registration status in the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)
gsm.signal.dbm
number
dbm
Strength of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal
gsm.sim.status
boolean
SIM card is active
gsm.timing.advance
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) 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
ibutton.connected.status
boolean
iButton connection status
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.state
number
Network state enum
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.cumulative.time
number
minutes
Parking cumulative 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.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
profile.version
string
The last downloaded profile version
protocol.id
number
ID of protocol
report.reason
number
Transmission reason code
rf.device.serial.number
string
Serial number of RF device which is in emergency mode
rf.device.signal.rssi
number
dbm
RSSI from RF device which is in emergency mode
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
sos.alarms.count
number
The number of times SOS alarm button was pushed
timestamp
number
seconds
Message timestamp
timestamp.key
number
Message timestamp in seconds with message sequence number appended as the value fractional part. Used to distinguish between several messages that have the same 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.dead.center.time
number
seconds
Accumulated time that the vehicle was driven putting the gear in dead center during 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.moving.time
number
seconds
Duration of moving during trip
trip.over.rpm
number
seconds
Duration of over RPM during trip
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.can.standard
number
Vehicle Prototype: 0 => unknown, 1 => J1939, 2 => J1708, 3 => ISO15765
vehicle.mileage
number
km
Total calculated mileage
vehicle.vin
string
VIN of vehicle
x.acceleration
number
g
Accelerometer value X
y.acceleration
number
g
Accelerometer value Y
z.acceleration
number
g
Accelerometer value Z
Properties
ALT Assigned Headers
alt_assigned_map
Request assigned headers for alert report
mask: ALT Assigned Headers Mask
l_headers: Large Assigned Headers
m_headers: Medium Assigned Headers
s_headers: Small Assigned Headers
GSM Network Setup
network
Access point settings, backend server, PIN
auth: Auth
host: Host
port: Port
pin_num: PIN number to release pin lock
sms_num: Phone number for SMS reports
host_backup: Secondary host
port_backup: Secondary port
Report Parameters
reporting_st3940
Report generation conditions setup
emergency_thres: Sensor threshold
driving_interval: Driving mode interval
parking_interval: Parking mode interval
emergency_attempts: Emergency attempts
emergency_interval: Emergency mode interval
Request Status
status
Requesting status of the device
STT Assigned Headers
stt_assigned_map
Request assigned headers for status report
mask: STT Assigned Headers Mask
l_headers: Large Assigned Headers
m_headers: Medium Assigned Headers
s_headers: Small Assigned Headers
More devices from Suntech (54)
Tags
