Sierrawireless protocol

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.

To connect Sierra Wireless to Wialon or another platform via flespi please read this article.


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
absolute.deceleration
number
g
Module of deceleration value from accelerometer
ain
number
volts
Voltage on the analog input
battery.voltage
number
volts
Internal battery voltage
bluetooth.state
string
Bluetooth state
can.ambient.air.temperature
number
celsius
CAN ambient air temperature
can.bus.state
string
Shows if J1939 bus is intermittent on a dual bus (J1708/J1939) vehicle
can.derived.fuel.consumed
number
liters
Derived fuel usage, read from CAN
can.derived.gas.fuel.consumed
number
kg
Derived natural gas fuel usage, read from CAN
can.derived.vehicle.mileage
number
km
Derived vehicle mileage read from CAN
can.dtc
string
Diagnostic trouble code 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.oil.temperature
number
celsius
Engine oil temperature read from CAN
can.engine.rpm
number
rpm
Engine RPM 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.gas.fuel.consumed
number
kg
Natural gas fuel amount totally consumed by vehicle read from CAN
can.gas.fuel.economy
number
km/kg
CAN instantaneous natural gas fuel economy
can.idle.fuel.consumed
number
liters
Total idle fuel used, read from CAN
can.idle.gas.fuel.consumed
number
kg
Total natural gas idle fuel used, read from CAN
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
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
can.j1939.dm1.dtc.cm
number
J1939 Diagnostic Message 1 (Active Diagnostic Trouble Codes) SPN conversion method
can.j1939.dm1.dtc.fmi
number
J1939 Diagnostic Message 1 (Active Diagnostic Trouble Codes) failure mode identifier
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
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
can.j1939.dm1.dtc.oc
number
J1939 Diagnostic Message 1 (Active Diagnostic Trouble Codes) occurrence count
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
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
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
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
can.j1939.dm1.dtc.spn
number
J1939 Diagnostic Message 1 (Active Diagnostic Trouble Codes) suspect parameter number
can.onboard.power.voltage
number
volts
CAN onboard power voltage
can.pending.dtc
string
Pending diagnostic trouble code read from CAN
can.powersource.takeoff.enum
number
CAN power takeoff bitmask
can.seatbelt.state
string
Seat belt status, read from CAN
can.throttle.pedal.level
number
percentage
Throttle pedal push level read from CAN
can.total.engine.idle.time
number
hours
Time of engine running in idling status (vehicle stopped) since vehicle manufacture, 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
cargo.temperature
number
celsius
Cargo temperature sensor value
channel.id
number
ID of channel that received a message
cornering.acceleration
number
g
Cornering acceleration
crash.acceleration
number
g
Crash acceleration
crash.event
boolean
Crash event detected
device.id
number
ID of device that received a message
device.name
string
Name of device that received a message
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
engine.ignition.status
boolean
Engine ignition status
event.enum
number
Protocol-specific event code
event.seqnum
number
Unique event sequence number
external.powersource.voltage
number
volts
External power voltage
geofence.status
boolean
Geofence entered status
gnss.snr
number
dB
GNSS signal-to-noise ratio
gnss.state.enum
number
Protocol-specific GNSS state code. May contain information about GNSS fix status, sleep status, ON/OFF, Overcurrent/protect state.
harsh.acceleration.event
boolean
Harsh acceleration detected
harsh.braking.event
boolean
Harsh braking detected
harsh.cornering.event
boolean
Harsh cornering detected
ibutton.code
string
Hexadecimal code of connected iButton
ident
string
Device unique identifier like serial number, IMEI, etc
longitudinal.acceleration
number
g
Acceleration component along the longitudinal axis of the vehicle
modem.sid
string
System identifier of the cellular modem
movement.status
boolean
Current movement state
network.signal.rssi
number
dbm
Network signal strength
onewire.sensor.humidity
number
percentage
External 1-Wire humidity sensor value
onewire.sensor.temperature
number
celsius
External 1-Wire temperature sensor value
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.pdop
number
Position dilution of precision
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.timestamp
number
seconds
Timestamp when coordinates where calculated
power.off.event
boolean
Device power off event
power.on.event
boolean
Device power on event
protocol.id
number
ID of protocol
reset.event
boolean
Device reset event
segment.can.fuel.consumed
number
liters
Fuel volume consumed by vehicle on the last segment using CAN data
segment.can.gas.fuel.consumed
number
kg
Natural gas fuel amount consumed by vehicle on the last segment using CAN data
segment.vehicle.mileage
number
km
Segment mileage
sensor.temperature
number
celsius
Temperature sensor value
server.timestamp
number
seconds
Timestamp when server received a message
sos.alarm
boolean
SOS alarm trigerred
tilt.acceleration
number
g
Tilt acceleration
tilt.event
boolean
Tilt event
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.
trip.mileage
number
km
Distance driven since engine start
vehicle.mileage
number
km
Total calculated mileage
vehicle.state
string
Vehicle state, such as moving, idling, parked etc
vehicle.vin
string
VIN of vehicle
visible.satellites
number
Quantity of visible satellites by GNSS receiver
Properties
Custom Command
custom
Send custom text to the device
payload: Command text
Query REPORT_COLUMNS(24) parameter value
{"payload":"DIAG PARAMS=24"}