Protocol used by GPS tracking devices manufactured by Sierra Wireless Inc. headquartered in Canada.
flespi parses the Sierrawireless protocol messages into a JSON object with the
fields listed below in the Parameters tab.
To connect your tracker using the Sierra Wireless protocol, you need to have a sierrawireless 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 Serial Number without leading zeroes in the ident field.
Use the Logs & Messages tab on the device screen to check if the messages are coming.
Important note on Report configuration
Report Columns of the device must be configured to have column 28 Serial Number at the first place, as Serial Number is used as unique identifier of GNX device. Report Columns configuration example:
REPORT_COLUMNS=28.3.4.7.8.10.11.13.17.23.36.130.82.46.41.61.56.70.93.74.75.77.89.90.112.113.99.141.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0;
Parsing of telematics reports is performed according to the Report Columns setting of the device. Important: If you changed the report composition in any way other than via the flespi setting (e.g. via SMS or Serial Port), you need to synchronize the setting with the flespi device. To do this, click the "Request setting from device" (red round arrow) button for the Report Columns setting.
absolute.acceleration
number
g
Module of accelerometer vector
report column ID 10
absolute.deceleration
number
g
Module of deceleration value from accelerometer
report column ID 10
ain
number
volts
Voltage on the analog input
report column ID 42
battery.voltage
number
volts
Internal battery voltage
report column ID 61
bluetooth.state
string
Bluetooth state
report column ID 141
can.ambient.air.temperature
number
celsius
CAN ambient air temperature
report column ID 72
can.bus.state
string
Shows if J1939 bus is intermittent on a dual bus (J1708/J1939) vehicle
report column ID 56
can.derived.fuel.consumed
number
liters
Derived fuel usage, read from CAN
report column ID 89
can.derived.gas.fuel.consumed
number
kg
Derived natural gas fuel usage, read from CAN
report column ID 91
can.derived.vehicle.mileage
number
km
Derived vehicle mileage read from CAN
report column ID 93
can.dtc
array
Diagnostic trouble code array read from CAN
May content list of OBDII codes or list of objects with codes.
Standard object parameter names used:
*standard* - Protocol standard (J1939, J1708(J1587))
*mid* - Message Identifier (J1708)
*sid* - Subsystem Identifier (J1708)
*fmi* - Failure Mode Identifier (J1939, J1708)
*spn* - Suspect Parameter Number (J1939)
*sa* - Source Address (J1939)
*oc* - Occurrence Count (J1939)
*cm* - Conversion Method (J1939)
report column ID 10
can.dtc.objects
array
!! temporary parameter, see changelog !!
Diagnostic trouble code array read from CAN
Standard object parameter names used:
*standard* - Protocol standard (J1939, J1708(J1587), OBDII)
*mid* - Message Identifier (J1708)
*sid* - Subsystem Identifier (J1708)
*fmi* - Failure Mode Identifier (J1939, J1708)
*spn* - Suspect Parameter Number (J1939)
*sa* - Source Address (J1939)
*oc* - Occurrence Count (J1939)
*cm* - Conversion Method (J1939)
*code* - Error code (OBDII)
report column ID 10
can.dtc.strings
array
!! temporary parameter, see changelog !!
Diagnostic trouble code array read from CAN
May content list of OBDII codes or list of objects with codes.
Standard object parameter names used:
*standard* - Protocol standard (J1939, J1708(J1587))
*mid* - Message Identifier (J1708)
*sid* - Subsystem Identifier (J1708)
*fmi* - Failure Mode Identifier (J1939, J1708)
*spn* - Suspect Parameter Number (J1939)
*sa* - Source Address (J1939)
*oc* - Occurrence Count (J1939)
*cm* - Conversion Method (J1939)
report column ID 10
can.engine.coolant.temperature
number
celsius
Engine coolant temperature read from CAN
report column ID 74
can.engine.load.level
number
percentage
Calculated engine load level read from CAN
report column ID 76
can.engine.motorhours
number
hours
Total engine motorhours (engine work time) read from CAN
report column ID 112
can.engine.oil.pressure
number
kPa
CAN Engine oil pressure
report column ID 105
can.engine.oil.temperature
number
celsius
Engine oil temperature read from CAN
report column ID 104
can.engine.rpm
number
rpm
Engine RPM read from CAN
report column ID 77
can.fuel.consumed
number
liters
Fuel volume totally consumed by vehicle read from CAN
report column ID 108
can.fuel.economy
number
km/liters
CAN instantaneous fuel economy
report column ID 71
can.fuel.level
number
percentage
Fuel level in tank read from CAN
report column ID 100,
report column ID 99
report column ID 99
can.gas.fuel.consumed
number
kg
Natural gas fuel amount totally consumed by vehicle read from CAN
report column ID 109
can.gas.fuel.economy
number
km/kg
CAN instantaneous natural gas fuel economy
report column ID 81
can.idle.fuel.consumed
number
liters
Total idle fuel used, read from CAN
report column ID 110
can.idle.gas.fuel.consumed
number
kg
Total natural gas idle fuel used, read from CAN
report column ID 111
can.j1939.dm1.dtc.awl
number
J1939 Diagnostic Message 1 (Active Diagnostic Trouble Codes) amber warning lamp status: 0 - off, 1 - on, 2 - reserved, 3 - unknown
report column ID 10
can.j1939.dm1.dtc.awl.flash
number
J1939 Diagnostic Message 1 (Active Diagnostic Trouble Codes) amber warning lamp flash status: 0 - slow, 1 - fast, 2 - reserved, 3 - unknown
report column ID 10
can.j1939.dm1.dtc.mil
number
J1939 Diagnostic Message 1 (Active Diagnostic Trouble Codes) malfunction indicator lamp status: 0 - off, 1 - on, 2 - reserved, 3 - unknown
report column ID 10
can.j1939.dm1.dtc.mil.flash
number
J1939 Diagnostic Message 1 (Active Diagnostic Trouble Codes) malfunction indicator lamp flash status: 0 - slow, 1 - fast, 2 - reserved, 3 - unknown
report column ID 10
can.j1939.dm1.dtc.pl
number
J1939 Diagnostic Message 1 (Active Diagnostic Trouble Codes) protect lamp status: 0 - off, 1 - on, 2 - reserved, 3 - unknown
report column ID 10
can.j1939.dm1.dtc.pl.flash
number
J1939 Diagnostic Message 1 (Active Diagnostic Trouble Codes) protect lamp flash status: 0 - slow, 1 - fast, 2 - reserved, 3 - unknown
report column ID 10
can.j1939.dm1.dtc.rsl
number
J1939 Diagnostic Message 1 (Active Diagnostic Trouble Codes) red stop lamp status: 0 - off, 1 - on, 2 - reserved, 3 - unknown
report column ID 10
can.j1939.dm1.dtc.rsl.flash
number
J1939 Diagnostic Message 1 (Active Diagnostic Trouble Codes) red stop lamp flash status: 0 - slow, 1 - fast, 2 - reserved, 3 - unknown
report column ID 10
can.onboard.power.voltage
number
volts
CAN onboard power voltage
report column ID 107
can.pending.dtc
string
Pending diagnostic trouble code read from CAN
report column ID 10
can.powersource.takeoff.enum
number
CAN power takeoff bitmask
report column ID 65
can.seatbelt.state
string
Seat belt status, read from CAN
report column ID 114
can.throttle.pedal.level
number
percentage
Throttle pedal push level read from CAN
report column ID 78
can.total.engine.idle.time
number
hours
Time of engine running in idling status (vehicle stopped) since vehicle manufacture, read from CAN
report column ID 113
can.vehicle.mileage
number
km
Total vehicle mileage read from CAN
report column ID 70
can.vehicle.speed
number
km/h
Vehicle speed read from CAN
report column ID 75
cargo.temperature
number
celsius
Cargo temperature sensor value
report column ID 73
channel.id
number
ID of channel that received a message
cornering.acceleration
number
g
Cornering acceleration
report column ID 10
crash.acceleration
number
g
Crash acceleration
report column ID 10
crash.event
boolean
Crash event detected
report column ID 10
device.id
number
ID of device that received a message
device.name
string
Name of device that received a message
device.self.name
string
Device name reported by the device
report column ID 1
device.temperature
number
celsius
Temperature of device
report column ID 50
device.type.id
number
ID of device type of device that received a message
din
number
Digital inputs bitmask
report column ID 37,
report column ID 38,
report column ID 39,
report column ID 40
report column ID 38,
report column ID 39,
report column ID 40
dout
number
Digital outputs bitmask
report column ID 79
engine.ignition.status
boolean
Engine ignition or ACC status
report column ID 10,
report column ID 11
report column ID 11
event.enum
number
Protocol-specific event code
report column ID 10
event.seqnum
number
Unique event sequence number
report column ID 7
external.powersource.voltage
number
volts
External power voltage
report column ID 41
geofence.status
boolean
Geofence entered status
report column ID 10
gnss.snr
number
dB
GNSS signal-to-noise ratio
report column ID 49
gnss.state.enum
number
Protocol-specific GNSS state code. May contain information about GNSS fix status, sleep status, ON/OFF, Overcurrent/protect state.
report column ID 48
harsh.acceleration.event
boolean
Harsh acceleration detected
report column ID 10
harsh.braking.event
boolean
Harsh braking detected
report column ID 10
harsh.cornering.event
boolean
Harsh cornering detected
report column ID 10
ibutton.code
string
Hexadecimal code of connected iButton
report column ID 82
ident
string
Device unique identifier like serial number, IMEI, etc
longitudinal.acceleration
number
g
Acceleration component along the longitudinal axis of the vehicle
report column ID 10
modem.sid
string
System identifier of the cellular modem
report column ID 43
movement.status
boolean
Current movement state
report column ID 10
network.signal.rssi
number
dbm
Network signal strength
report column ID 44
onewire.sensor.humidity
number
percentage
External 1-Wire humidity sensor value
report column ID 131
onewire.sensor.temperature
number
celsius
External 1-Wire temperature sensor value
report column ID 130
peer
string
IP:port from which device connecting to the channel
position.altitude
number
meters
Altitude value for position
report column ID 25,
report column ID 26
report column ID 26
position.direction
number
degrees
Heading angle at position detection moment
report column ID 17
position.latitude
number
degrees
Latitude coordinate value
report column ID 3
position.longitude
number
degrees
Longitude coordinate value
report column ID 4
position.pdop
number
Position dilution of precision
report column ID 135
position.satellites
number
Quantity of satellites used to calculate coordinates for given position information
report column ID 46
position.speed
number
km/h
Instant speed at position detection moment
report column ID 13,
report column ID 14
report column ID 14
position.timestamp
number
seconds
Timestamp when coordinates where calculated
report column ID 36
power.off.event
boolean
Device power off event
report column ID 10
power.on.event
boolean
Device power on event
report column ID 10
protocol.id
number
ID of protocol
report.reason
number
Transmission reason code
report column ID 87
reset.event
boolean
Device reset event
report column ID 10
segment.can.fuel.consumed
number
liters
Fuel volume consumed by vehicle on the last segment using CAN data
report column ID 90
segment.can.gas.fuel.consumed
number
kg
Natural gas fuel amount consumed by vehicle on the last segment using CAN data
report column ID 92
segment.vehicle.mileage
number
km
Segment mileage
report column ID 98
sensor.temperature
number
celsius
Temperature sensor value
report column ID 57,
report column ID 58
report column ID 58
server.timestamp
number
seconds
Timestamp when server received a message
sos.alarm
boolean
SOS alarm triggerred
report column ID 10
tilt.acceleration
number
g
Tilt accelerometer value
report column ID 10
tilt.event
boolean
Tilt event
report column ID 10
timestamp
number
seconds
Message timestamp
report column ID 2,
report column ID 36
report column ID 36
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.
report column ID 2,
report column ID 36,
report column ID 7
report column ID 36,
report column ID 7
trip.mileage
number
km
Distance driven since engine start
report column ID 97
vehicle.mileage
number
km
Total calculated mileage
report column ID 23,
report column ID 24
report column ID 24
vehicle.state
string
Vehicle state, such as moving, idling, parked etc
report column ID 31
vehicle.vin
string
VIN of vehicle
report column ID 10
visible.satellites
number
Quantity of visible satellites by GNSS receiver
report column ID 47
