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

Below is the list of parameters that can appear in the messages received by the channel via cguard protocol. In most parameters, the name consists of tags split by dots: tag1.tag2.tag3.tag4... Each tag defines a certain area of an application, e.g. any parameter that contains mileage data has the 'mileage' tag in the name and any parameter related to fuel control contains the 'fuel' tag. By default JSON fields of the message received by a channel via this protocol can only contain the below-specified parameters. Any additional parameter will be prefixed by the "custom" tag, e.g. "custom.unspecified-name".

Name Type Unit Description
ain number volts Voltage on the analog input
battery.voltage number volts Internal battery voltage
channel_id number ID of channel that received message
counter.impulses number Impulses counter
din number Digital inputs bitmask
event.seqnum number Unique event sequence number
external.powersource.voltage number volts External power voltage
gsm.signal.level number percentage GSM signal strength level
ibutton.code string Hexadecimal code of connected iButton
ident string Device unique identificator and optional password
input.frequency number Frequency input
liquid.sensor.fuel.volume number liters Fuel volume reported by LLS
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
relay.status boolean Relay status
server.timestamp number seconds Timestamp when server received message
timestamp number seconds Message timestamp

Below is the list of commands that can be sent to devices to change their configuration or to send signals to various outputs. When sending a command you can specify the transport type defining how the command will be delivered - the address parameter can take values connection (via network connection once the device goes online), sms (via SMS message), push (via PUSH notification). A comprehensive format of each command with all possible parameter values, parameter types, default values, etc. can be found in the REST API documentation in your account.

Title Name Description Properties
Get device ID get_device_id get_device_id
Get HW version get_hardware_version Get HW version
Reboot reboot Reboot
Set device ID set_ident Set device ID new_ident: Device ID
Set ping period set_ping_period Set ping period port: Ping period
Set IP or domain set_server_host Set IP or domain ip_or_domain: IP or domain
Set ping period set_server_port Set ping period port: Port