The protocol for Coban GPS tracking devices.

Below is the list of parameters that can appear in the messages received by the channel via coban 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
acc.alarm boolean ACC alarm event
alarm.event boolean Alarm event triggered
battery.charging.status boolean Battery charging status
battery.low.alarm boolean Battery low alarm event
battery.voltage number volts Internal battery voltage
can.dtc string Diagnostic trouble code read from CAN
can.engine.coolant.temperature number celsius Engine coolant temperature read from CAN
can.engine.load.level number percentage Calculated engine load level read from CAN
can.engine.rpm number rpm Engine RPM read from CAN
can.fuel.consumption number liters/h Engine fuel rate read from CAN
can.fuel.consumption.distance number liters/100km Fuel consumption read from CAN
can.onboard.power.voltage number volts CAN onboard power voltage
can.throttle.pedal.level number percentage Throttle pedal push level read from CAN number hours Engine run time read from CAN
can.vehicle.mileage number km Total vehicle mileage read from CAN
can.vehicle.speed number km/h Vehicle speed read from CAN number ID of channel that received a message number ID of device that received a message string Name of device that received a message
device.temperature number celsius Temperature of device number ID of device type of device that received a message
door.alarm boolean Door alarm event boolean Door open status
engine.blocked.status boolean Engine blocked status, true - engine is blocked, false - engine isn't blocked
engine.ignition.status boolean Engine ignition status
event.code string Unique event identifier string
fuel.alarm boolean Fuel alarm event
fuel.level number percentage Fuel level percentage
geofence.alarm boolean Geofence alarm event
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
ident string Device unique identificator and optional password
movement.event boolean Movement detected boolean Oil and power cut off event occured, when vehicle speed was less than 20 km/h boolean Oil and power cut off status, true - cut off, false - restored
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 boolean Power of alarm event number ID of protocol
server.timestamp number seconds Timestamp when server received a message
timestamp number seconds Message timestamp
vibration.alarm boolean Vibration alarm event

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
Custom command custom Send custom command to device payload: Command text to send
Set geofence
Set server IP:port
Cut off oil and power