Reachfar protocol

Protocol used by GPS tracking devices manufactured by Shenzhen ReachFar Technology Co., Ltd. headquartered in China.
flespi parses the Reachfar protocol messages into a JSON object with the fields listed below in the Parameters tab.

To connect your tracker using the ReachFar protocol, you need to have a reachfar 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 ReachFar devices OTA using the flespi web-based configurator tool. To connect ReachFar to Wialon or another platform via flespi please read this article.

battery.level
number
percentage
Internal battery level
battery.low.alarm
boolean
Battery low alarm event
battery.low.status
boolean
Battery low status
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
fall.alarm.status
boolean
Fall alarm status
geofence.alarm
boolean
Geofence alarm event
geofence.status
boolean
Geofence entered status
gsm.cellid
number
GSM base station ID
gsm.lac
number
GSM location area code
gsm.mcc
string
GSM mobile country code
gsm.mnc
string
GSM mobile network code
gsm.signal.level
number
percentage
GSM signal strength level
gsm.timing.advance
number
GSM timing advance
ident
string
Device unique identifier like serial number, IMEI, etc
message.type
string
Message type
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.outdated
boolean
Position information is outdated
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
protocol.id
number
ID of protocol
server.timestamp
number
seconds
Timestamp when server received a message
sos.alarm
boolean
SOS alarm trigerred
steps.count
number
The total number of steps for the day
timestamp
number
seconds
Message timestamp
turnover.number
number
Turnover times
vehicle.state
string
Vehicle state, such as moving, idling, parked etc
vehicle.state.bitmask
number
Vehicle state flags bitmask
vendor.code
string
Vendor identification string code
wifi.mac.address
string
WiFi MAC address
wifi.signal.strength
number
dbm
WiFi signal strength
wifi.ssid
string
Wi-Fi SSID name
wristband.connected.status
boolean
Wristband connection status
wristband.takeoff.alarm
boolean
Wristband take off alarm
Properties
Custom command
custom
Send custom command to device
payload: Payload string
Restore factory settings
{"payload":"FACTORY"}
Data upload interval setting for 10 seconds
{"payload":"UPLOAD,10"}