flespi telematics hub supports erm protocol. The list of supported devices is: StarLink Tracker StarLink Tracker3G StarLink TrackerGNSS StarLink AVL

We've added custom command to the erm protocol It allows you to send any command to StarLink devices connected to flespi. For example, To send command 23 - Request immobilizer rule #2 - use the following REST API request: curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: FlespiToken XXXX' -d '[{"address":{"ident":"123456789012345","type":"connection"},"name":"custom","properties":{"command":23,"payload":"2"},"ttl":86400}]' 'https://flespi.io/gw/channels/<channel_id>/commands-queue' just replace: XXXX - with your flespi token 123456789012345 - device ident <channel_id> - ID of flespi erm channel For more details read: How to send a command to the device over the channel’s connection?

Erm protocol is updated - new dynamic parameters are added: JAM (Jamming detection state) - parameter gsm.jamming.alarm.status LOCA (Location accuracy, meters) - parameter location.accuracy LOCS (Location source) - parameter location.source LOCF (Location filter reason) - parameter location.filter.reason NC (Network code) - parameters gsm.mcc and gsm.mnc

[Changelog] erm protocol

namo

We enhanced support of 02 - Error report messages for StarLink devices (up to Version 2.32, March, 2019).
Descriptions for all 24 error types available at the moment are stored in error.type.description parameter.

namo

02 - Error report: parsing of additional information added for Error number 20: Cellular signal degradation

namo

Parameter renaming in erm protocol: vehicle.battery.health parameter is renamed into battery.health.
Both parameters will be registered during one week. 17-Apr-2020 old parameter vehicle.battery.health will be removed.

namo

namo
Erm protocol updated: old parameter vehicle.battery.health is removed after renaming

namo

Erm protocol is updated - new dynamic parameters are added:

JAM (Jamming detection state) - parameter gsm.jamming.alarm.status
LOCA (Location accuracy, meters) - parameter location.accuracy
LOCS (Location source) - parameter location.source
LOCF (Location filter reason) - parameter location.filter.reason
NC (Network code) - parameters gsm.mcc and gsm.mnc

namo

Announcement:
Command get_location will be deleted from ERM protocol in a week, 25-Jun-2020.
Please, use custom command instead, see examples here

kial

Next Monday, 03-May-2021, message parameter "gsm.signal.level" parsed from the #CSS# dynamic tag will be renamed to "gsm.signal.dbm".
Currently, we're registering the same value for both parameters, and in a week the old name "gsm.signal.level" will be removed.

kial

kial parameter "gsm.signal.level" renamed to "gsm.signal.dbm"

kial

We've added the read-only setting "Dynamic parameters" to all StarLink devices.
setting

That setting is used to preserve dynamic parameters format (parameter 177) between device connections, to correctly parse dynamic events.
If you will change that parameter through the device configurator - please remove that setting in the flespi device Settings to trigger its re-reading.

If you will not create a device (i.e. you're working on the channel-level only) - the command to read dynamic parameters format (parameter 177) will be sent to the device at the beginning of every connection.

baja

Extra field for Event number 18 is stored as report.reason parameter

kial

Next Thursday, 23-Dec-2021, message parameter "location.accuracy" parsed from the #LOCA# dynamic tag will be renamed to "position.accuracy".
Currently, we're registering the same value for both parameters, and in a week the old name "location.accuracy" will be removed.

kial

kial Old parameter name removed

baja

The protocol will be affected by the change in type of parameters gsm.mcc and gsm.mnc to be installed in 2 weeks - May 23rd, 2022: both parameters that now have type "string" will be stored as "number". The possible leading zeroes in MNC will be ignored (e.g. the value "01" will be stored as 1).

YuryAheichyk

ERM protocol has been changed. gsm. network.type parameter parsed from the #NT# dynamic tag was added.

YuryAheichyk

ERM protocol has been updated, added TrackerWi-Fi device

baja

parameter renaming announcement which will happen in a week (May 22):
parameter total.idle.seconds will be renamed to total.idle.time

YuryAheichyk

Added #FIX# and #CU# parameters parsing (flespi parameters: position.fix.type, transmition.channel)