Cguard protocol

Protocol used by GPS tracking devices manufactured by several manufacturers, but primarily by cGuard headquartered in Russia.
flespi parses the Cguard protocol messages into a JSON object with the fields listed below in the Parameters tab.

This protocol is used by all cGuard GPS tracking devices and by other tracker manufacturers (e.g. Italon and Agent GPS).

To connect your tracker using the cGuard protocol, you need to have a cguard 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.

ain
number
volts
Voltage on the analog input
battery.voltage
number
volts
Internal battery voltage
channel.id
number
ID of channel that received a message
counter.impulses
number
Impulses counter
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
event.enum
number
Protocol-specific event code
external.powersource.voltage
number
volts
External power voltage
gsm.signal.level
number
percentage
Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal strength level
gsm.sim.status
boolean
SIM card is active
ibutton.code
string
Hexadecimal code of connected iButton
ident
string
Device unique identifier like serial number, IMEI, etc
input.frequency
number
Frequency input
lls.value
number
LLS (Liquid level sensor) fuel value
movement.status
boolean
Current movement state
onewire.input.value
number
OneWinre input
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.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
protocol.id
number
ID of protocol
relay.status
boolean
Relay status
server.timestamp
number
seconds
Timestamp when server received a message
sleep.mode.status
boolean
Device is in sleep mode
timestamp
number
seconds
Message timestamp
Properties
Custom Command
custom
Send custom command over GPRS
payload: Payload
Reboot
{"payload":"PM_REBOOT"}
Get device ID
{"payload":"PARAM_READ:DEVICE_ID"}
Set device ID
{"payload":"PARAM_SET:DEVICE_ID:MY_DEVICE_ID"}
Set ping period
{"payload":"PARAM_SET:PING_PERIOD:10"}
Set server port
{"payload":"PARAM_SET:SERVER_PORT:11111"}
Get hardware version
{"payload":"PARAM_READ:HARDWARE_VERSION"}
Set server IP or domain
{"payload":"PARAM_SET:SERVER_HOST:11111.flespi.gw"}