Eelink protocol

Integration level: params + settings
Protocol used by GPS tracking devices manufactured by Shenzhen Eelink Communication Technology Co Ltd headquartered in China.
flespi parses the Eelink protocol messages into a JSON object with the fields listed below in the Parameters tab.
ain
number
volts
Voltage on the analog input
alarm.event
boolean
Alarm event triggered
battery.voltage
number
volts
Internal battery voltage
carbon.dioxide.alarm
boolean
CO2 concentration if out of predefined range
carbon.dioxide.ppm
number
ppm
Carbon dioxide concentration
channel.id
number
ID of channel that received a message
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
displacement.alarm
boolean
Displacement alarm event
engine.ignition.status
boolean
Engine ignition status
event.enum
number
Event code, full list of codes available at separate table
fall.alarm
boolean
Fall alarm event
geofence.status
boolean
Geofence entered status
gnss.antenna.open.circuit.status
boolean
GNSS antenna open-circuit status
gnss.antenna.short.circuit.status
boolean
GNSS antenna short circuit status
gnss.status
boolean
GNSS receiver on/off 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.dbm
number
dbm
Strength of GSM signal
humidity.alarm
boolean
Humidity is out of predefined range
ident
string
Device unique identificator and optional password
illuminance.alarm
boolean
Illuminance if out of predefined range
internal.battery.low.alarm
boolean
Internal battery low alarm event
message.content
string
Message content
movement.event
boolean
Movement detected
obd.connected.status
boolean
OBDII device is connected to vehicle
overspeeding.event
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.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
sensor.humidity
number
percentage
Humidity sensor value, i.e. relative air humidity level
sensor.illuminance
number
lux
Illuminance measured by light sensor
sensor.temperature
number
celsius
Temperature sensor value
sensor.temperature.alarm
boolean
Sensor temperature value is out of predefined ranges
server.timestamp
number
seconds
Timestamp when server received a message
steps.count
number
Accumulated steps count for today
temperature.alarm
boolean
Internal temperature value is out of predefined range
timestamp
number
seconds
Message timestamp
underspeed.event
boolean
Underspeed event
vehicle.mileage
number
km
Total calculated mileage
walk.time
number
seconds
Accumulated walking time today
wifi.mac.address
string
WiFi MAC address
wifi.signal.strength
number
dbm
WiFi signal strength
Properties
Custom command
custom
Send custom command to device
payload: Command text
Set heartbeat timer to 5 minutes
{"payload":"HBT,5#"}
Change time zone of the device to UTC
{"payload":"GMT,E,0,0,0#"}

To connect your tracker using the Eelink protocol, you need to have an eelink channel created first.

Point your tracker to the channel's IP:port via SMS or configuration tool provided by the vendor.

Send the SMS with the following command to the tracker's phone number (don't forget to replace Xs with appropriate numbers):

SERVER,"tcp://193.193.XX.XX:XXXXX"#

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.