Gosafe protocol

Integration level: params
Protocol used by GPS tracking devices manufactured by Gosafe Company Limited headquartered in China.
flespi parses the Gosafe protocol messages into a JSON object with the fields listed below in the Parameters tab.
absolute.acceleration
number
g
Module of accelerometer vector
accident.event
boolean
Accident event detected
ain
number
volts
Voltage on the analog input
backup.battery.voltage
number
volts
Backup battery voltage
backup.battery.voltage.status
boolean
Backup battery voltage if normal (true - inside the predefined range) or abnormal (false - outside of the predefined range)
battery.voltage
number
volts
Internal battery voltage
brake.acceleration
number
g
Acceleration on brake
can.ambient.air.temperature
number
celsius
CAN ambient air temperature
can.dtc.number
number
Number of diagnostic trouble codes
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.rpm
number
rpm
Engine RPM read from CAN
can.engine.run.time
number
seconds
Run time since engine start read from CAN
can.engine.temperature
number
celsius
Engine temperature read from CAN
can.fuel.pressure
number
kPa
Fuel pressure
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.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.monitor.status
number
Monitor status since DTCs cleared, read from CAN
can.short.fuel.trim
number
percentage
Short term fuel trim read from CAN
can.throttle.pedal.level
number
percentage
Throttle pedal push level read from CAN
can.timing.advance
number
degrees
Ignition timing advance read from CAN
can.vehicle.speed
number
km/h
Vehicle speed read from CAN
channel.id
number
ID of channel that received a message
collision.event
boolean
Collision event
counter.impulses
number
Impulses counter
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.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
event.enum
number
Event code, full list of codes available at separate table
external.powersource.voltage
number
volts
External power voltage
external.powersource.voltage.status
boolean
Voltage of external supply is normal (true - inside the predefined range) or abnormal (false - outside of the predefined range)
flash.storage.status
boolean
Flash storage status
frequency.counter.din
number
Frequency counter value on digital input
fuel.weight
number
kg
Fuel weight
geofence.alarm
boolean
Geofence alarm event
geofence.status
boolean
Geofence entered status
gsm.cellid
number
GSM base station ID
gsm.jamming.alarm.status
boolean
Alarm status for GSM jamming
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.roaming.status
boolean
GSM network in roaming mode
gsm.network.status
boolean
Registration in GSM network
gsm.signal.dbm
number
dbm
Strength of GSM signal
hardware.version
string
Hardware version
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 identificator and optional password
idle.status
boolean
Vehicle is in idling state
idle.status.duration
number
seconds
Duration of vehicle being in the last idling state
movement.status
boolean
Current movement state
onewire.sensor.serial
string
External 1-Wire sensor serial number in HEX representation
onewire.sensor.temperature
number
celsius
External 1-Wire temperature sensor value
overspeeding.event
boolean
Overspeeding detected
overspeeding.speed
number
km/h
GNSS based speed when overspeeding event is triggered
overspeeding.status
boolean
Overspeeding detected
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.fix.type
number
GNSS fix type enum (0 = "not fixed", 1 = "2D", 2 = "3D")
position.hdop
number
Horizontal dilution of precision
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
position.vdop
number
Vertical dilution of precision
private.status
boolean
Device is in private mode
protocol.id
number
ID of protocol
protocol.version
string
Protocol version string
report.reason
number
Transmission reason code
sensor.status
boolean
Sensor status: true - normal, false - abnormal
server.timestamp
number
seconds
Timestamp when server received a message
socket.connection.status
boolean
Socket connection status
software.version
string
Software version string
timestamp
number
seconds
Message timestamp
towing.alarm.status
boolean
Towing alarm state
towing.event
boolean
Towing event detected
trip.status
boolean
Trip status, true if trip started, false - if stopped
turn.acceleration
number
g
Acceleration on turn
turnover.event
boolean
Turnover event
vehicle.mileage
number
km
Total calculated mileage
vehicle.vin
string
VIN of vehicle

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

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