Bws-iot protocol

Protocol used by GPS tracking devices manufactured by BWS IoT headquartered in Brazil.
flespi parses the Bws-iot protocol messages into a JSON object with the fields listed below in the Parameters tab.

To connect your tracker using the Gosafe protocol, you need to have a bws-iot 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 Logs & Messages tab on the device screen to check if the messages are coming.

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

adc.alarm
boolean
ADC alarm
ain
number
volts
Voltage on the analog input
alarm.event
boolean
Alarm event triggered
battery.level
number
percentage
Internal battery level
battery.low.alarm
boolean
Battery low alarm event
channel.id
number
ID of channel that received a message
device.id
number
ID of device that received a message
device.name
string
Name of device that received a message
device.type.id
number
ID of device type of device that received a message
din
number
Digital inputs bitmask
dout
number
Digital outputs bitmask
driving.status
boolean
Car is driving status
engine.ignition.status
boolean
Engine ignition or ACC status
fuel.level
number
percentage
Fuel level percentage
geofence.status
boolean
Geofence entered status
gnss.status
boolean
GNSS receiver on/off status
gsm.cellid
number
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) base station ID
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.signal.level
number
percentage
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal strength level
harsh.acceleration.event
boolean
Harsh acceleration detected
harsh.braking.event
boolean
Harsh braking detected
ident
string
Device unique identifier like serial number, IMEI, etc
movement.event
boolean
Movement detected
overspeeding.event
boolean
Overspeeding detected
payload.size
number
Payload data size in bytes
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.cut.alarm
boolean
External power cut-off alarm event
protocol.id
number
ID of protocol
report.code
string
Report code
rfid.code
string
Hexadecimal code of connected RFID
sensor.temperature
number
celsius
Temperature sensor value
server.timestamp
number
seconds
Timestamp when server received a message
sleep.mode.status
boolean
Device is in sleep mode
sos.alarm
boolean
SOS alarm trigerred
temperature.alarm
boolean
Temperature value is outside of predefined range
timestamp
number
seconds
Message timestamp
urgent.brake.event
boolean
Urgent brake alarm event
vehicle.mileage
number
km
Total calculated mileage
vehicle.state.bitmask
number
Vehicle state flags bitmask
vibration.alarm
boolean
Vibration alarm event
Properties
Custom command
custom
Send custom command to device
text: Text payload
wait_response: Wait Response
Restart the device
{"text":"CQ","wait_response":true}