cellocator

This protocol is used by Pointer Cellocator GPS tracking devices

Below is the list of parameters that can appear in the messages received by the channel via cellocator 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
accelerometer.idling.duration number seconds Number of seconds Idling detection is based on Accelerometer
ain number volts Voltage on the analog input
air.humidity.level number percentage Relative air humidity level
ambient.illumination number lux Ambient light illumination
battery.level number percentage Internal battery level
ble.signal.dbm number dBm Strength of BLE (BlueTooth Low Energy) signal
calibrating.status boolean Calibrating status
device.temperature number celsius Temperature of device
din number Digital inputs bitmask
dout number Digital outputs bitmask
driver.id string Driver id
driving.status boolean Driving status
engine.on.idling.duration number seconds Number of seconds Engine is on during idling session (engine running)
engine.status boolean Engine status
external.alarm.status boolean External alarm status
external.memory number Size of external non-volatile memory
external.memory.type.enum number External non-volatile memory type
firmware.id number CSA Firmware id
gps.idling.duration number seconds Number of seconds Idling detection is based on Valid GPS
gps.mode number GPS mode
gps.status boolean GPS navigation module status
gsm.bsic number Base station identification code
gsm.cellid number GSM base station ID
gsm.lac number GSM location area code
gsm.mcc number GSM mobile country code
gsm.mnc number GSM mobile network code
gsm.network.roaming.status boolean GSM network in roaming mode
gsm.signal.dbm number dbm Strength of GSM signal
hardware.interface.enum number Hardware interface and peripherals identifier
hardware.type string Hardware type
hardware.version.enum number Hardware version enum
ibutton.code string Hexadecimal code of connected iButton
ident string Device unique identificator and optional password
ignition.on.idling.duration number seconds Number of seconds Ignition is on during idling session (ignition switch is on, Motor is off)
internal.memory number Size of internal non-volatile memory
maneuver.abs.state number ABS sensor reading for braking event only
maneuver.average.speed number km/h Maneuver average speed
maneuver.average.speed.green number km/h Average speed in zone Green
maneuver.average.speed.red number km/h Average speed in zone Red
maneuver.average.speed.yellow number km/h Average speed in zone Yellow
maneuver.delta.speed number km/h Maneuver speed delta
maneuver.duration number seconds Maneuver duration
maneuver.engine.rpm.average number rpm Average engine RPM in maneuver
maneuver.engine.rpm.max number rpm Max engine RPM in maneuver
maneuver.id number Maneuver id
maneuver.max.fuel.flow number Maximum fuel flow during acceleration events
maneuver.max.speed number km/h Maneuver max speed
maneuver.risk.score number Maneuver risk value 0-100
maneuver.start.latitude number degrees GPS location latitude of the maneuver start moment
maneuver.start.longitude number degrees GPS location longitude of the maneuver start moment
maneuver.stop.latitude number degrees GPS location latitude of the maneuver stop moment
maneuver.stop.longitude number degrees GPS location longitude of the maneuver stop moment
maneuver.time.green number seconds Time in maneuver zone Green
maneuver.time.red number seconds Time in maneuver zone Red
maneuver.timestamp number seconds Maneuver start time timestamp
maneuver.time.yellow number seconds Time in maneuver zone Yellow
maneuver.total.events.green number Total events in maneuver zone Green
maneuver.total.events.red number Total events in maneuver zone Red
maneuver.total.events.yellow number Total events in maneuver zone Yellow
maneuver.total.fuel.flow number Integral of Fuel flow
maneuver.total.severity.enum number Total Maneuver Severity: 1 – green, 2-yellow, 3-red
maneuver.type.enum string Maneuver type
maneuver.x.acceleration.average number g Accelerometer X axes average
maneuver.x.acceleration.max number g Max accelerometer value X in maneuver
maneuver.y.acceleration.average number g Accelerometer Y axes average
maneuver.y.acceleration.max number g Max accelerometer value Y in maneuver
maneuver.z.acceleration.max number g Max accelerometer value Z in maneuver
measurement.humidity.delay number seconds Delay from previous sample
measurement.temperature number celsius Temperature
measurement.temperature.delay number seconds Delay from previous sample
measurement.timestamp number seconds Measurement timestamp
measurement.type string Measurement type
message.buffered.status boolean Black box message
modem.type.enum number Modem type
operation.mode.enum string Unit's operation mode
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.timestamp number seconds Timestamp when coordinates where calculated
private.status boolean Device is in private mode
processor.enum number Processor family identifier
program.memory number Size of program memory
protocol.id number CSA Protocol id
protocol.version string Protocol version string
report.reason number Transmission reason code
report.reason.data number Additional transmission data
report.reason.enum string Transmission reason
row.logging.status boolean Row logging status
secondary.engine.status boolean Standby engine status
sensor.battery.level number percentage External sensor battery level
sensor.connect.timestamp number seconds Time of last communication from the sensor
sensor.illumination number lux Illumination sensor value
sensor.mac.address string External sensor MAC address
sensor.magnet.status boolean Magnetic field detected by sensor
sensor.temperature number celsius Temperature sensor value
sensor.x.acceleration number g Acceleration sensor X-axis value
sensor.y.acceleration number g Acceleration sensor Y-axis value
sensor.z.acceleration number g Acceleration sensor Z-axis value
short.idling.duration number seconds Short Idling duration from 'Short idling TO' to end of Idling session or until 'Long Idling TO'
software.version string Software version string
software.version.enum number Software version enum
speed.source string Source of speed: gps or pulse frequency input
temperature.valid boolean Temperature readings validity
timestamp number seconds Message timestamp
time.valid.status boolean Time is accurate
trailer.id string Trailer ID
trip.average.speed number km/h Average speed of the trip
trip.duration number seconds Trip duration
trip.eco.score number percentage A value representing the weighted Eco score of the trip
trip.highway.driving.score number Highway driving score of the trip
trip.highway.score.time number seconds Highway driving score time of the trip
trip.id number Trip id
trip.idle.score number Idle score of the trip
trip.idle.score.time number seconds Idle score time of the trip
trip.idle.time number seconds Time the vehicle was idle based on GPS and accelerometer information, according to corresponding threshold
trip.max.speed number km/h Maximum speed of the trip
trip.mileage number km Distance driven since engine start
trip.movement.time number seconds Time the vehicle has moved from Ignition on to Ignition off event or until driver was replaced
trip.safety.score number percentage A value representing the weighted safety score of the trip
trip.start.fuel.level number percentage Fuel level upon trip start
trip.start.timestamp number seconds Timestamp value upon trip start
trip.stop.fuel.level number percentage Fuel level upon trip end
trip.urban.driving.score number Urban driving score of the trip
trip.urban.score.time number seconds Urban driving score time of the trip
trip.x.acceleration.max number g Maximum accel input on X axis of the trip
trip.y.acceleration.max number g Maximum accel input on Y axis of the trip
trip.z.acceleration.max number g Maximum accel input on Z axis of the trip
vehicle.mileage number km Total calculated mileage
volatile.memory number Size of volatile memory
x.acceleration number g Accelerometer value X
y.acceleration number g Accelerometer value Y
z.acceleration number g Accelerometer value Z

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 flespi.io account.

Title Name Description Properties
CAN data request generic.can CAN data
Commence gradual engine stop generic.engine_stop PWM Immobilizer - from 100% to 0% duty cycle
Firmware manifest request generic.firmware Firmware manifest request
Time and location stamp request generic.location Time and location stamp request
Output state change generic.output Output state change state: Desired state of output

ordinal: Output ordinal number
Reset generic.reset Reset device
Request status from device generic.status Immediate status request
Tracking control generic.track_time Tracking control based on time events timeout: Resolution of time events