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 number ID of channel that received a message
counter.impulses number Impulses counter number ID of device that received a message string Name of device that received a message number ID of device type of device that received a message
din number Digital inputs bitmask
event.enum number Event code, full list of codes available at separate table
external.powersource.voltage number volts External power voltage
gsm.signal.level number percentage GSM signal strength level
gsm.sim.status boolean SIM card is active
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
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 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

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