Cellocator protocol

Integration level: params + settings
Protocol used by GPS tracking devices manufactured by Pointer Cellocator headquartered in Israel.
flespi parses the Cellocator protocol messages into a JSON object with the fields listed below in the Parameters tab.
accelerometer.idling.duration
number
seconds
Number of seconds Idling detection is based on Accelerometer
ain
number
volts
Voltage on the analog input
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
box.status
boolean
Box status (true - box is opened, false - box is closed)
calibrating.status
boolean
Calibrating status
channel.id
number
ID of channel that received a message
device.id
number
ID of device that received a message
device.name
string
Name of device that received a message
device.temperature
number
celsius
Temperature of device
device.type.id
number
ID of device type of device that received a message
din
number
Digital inputs bitmask
dout
number
Digital outputs bitmask
driver.id
string
Driver identification card 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
event.enum
number
Event code, full list of codes available at separate table
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
fuel.level
number
percentage
Fuel level percentage
fuel.volume
number
liters
Fuel volume
gnss.idle.duration
number
seconds
Number of seconds Idling detection is based on Valid GNSS position
gnss.status
boolean
GNSS receiver on/off status
gps.mode
number
GPS mode
gsm.bsic
number
Base station identity code
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
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.source
number
Measurement source index
message.buffered.status
boolean
Black box message
message.type
string
Message type
modem.type.enum
number
Modem type
module.id
number
ID of received data module. Refer to Cellocator device documentation.
onewire.sensor.serial
string
External 1-Wire sensor serial number in HEX representation
onewire.sensor.temperature
number
celsius
External 1-Wire temperature sensor value
operation.mode.enum
string
Unit's operation mode
operator.id
number
ID of operator that triggered the event, refer to Cello-CANiQ Integration Manual
operator.type
number
Type of operator that triggered the event, refer to Cello-CANiQ Integration Manual
package.open.status
boolean
Package opened/closed status: false - closed, true - opened
payload.hex
string
HEX Payload received from device
peer
string
IP:port from which device connecting to the channel
pl.signature
number
PL signature - a unique 32-bit code identifying the PL, refer to Cello-CANiQ Integration Manual
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
ID of protocol
protocol.version
string
Protocol version string
record.seqnum
number
Registered record sequence number
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.dead.status
boolean
Sensor battery dead status, true - battery is dead, false - battely is recovered
sensor.battery.level
number
percentage
External sensor battery level
sensor.battery.low.status
boolean
Sensor battery status, true - battery low, false - battery ok
sensor.connected.status
boolean
Sensor connected status, true - connected, false - not connected
sensor.humidity
number
percentage
Humidity sensor value, i.e. relative air humidity level
sensor.illuminance
number
lux
Illuminance measured by light 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.power.on.status
boolean
Sonser power on status, true - sensor power-up, false - sensor power-down by button
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
server.timestamp
number
seconds
Timestamp when server received a message
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.fuel.consumed
number
liters
Fuel consumed in the last 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 increasing every engine-ON event
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
variable.data.hex
string
Variable data in hex format, refer to Cello-CANiQ Integration Manual
variable.id
number
Variable ID, refer to Cello-CANiQ Integration Manual
vehicle.mileage
number
km
Total calculated mileage
vehicle.odometer
number
Vehicle mileage in base units configured in device (km, miles, 100m etc)
volatile.memory
number
Size of volatile memory
work.id
number
Work ID counter
x.acceleration
number
g
Accelerometer value X
y.acceleration
number
g
Accelerometer value Y
z.acceleration
number
g
Accelerometer value Z
Properties
Generic Command
custom_message_type_0
Generic command, message type 0
code: Command code
spec: Command specific data field
data1: Command data field 1
data2: Command data filed 2
Reset device
{"code":2,"data1":2}
Request status from device
{"code":0}
Commence gradual engine stop
{"code":7}
Tracking control with resolution of time events 4
{"code":5,"data1":4}
Programming command
custom_message_type_1
Programming command (message type 1) - allows to configure the device
data: Block data - 16 bytes HEX
block: Block code number
bitmask: Bitmask - 2 bytes HEX
Set maintenance server connection period 2 days
{"data":"00000000000000200000000000000000","block":87,"bitmask":"8000"}
Register Dallas key 2 (iButton code 2) with value 112233445566
{"data":"00000066554433221100000000000000","block":27,"bitmask":"F801"}
Modular Message Request
custom_message_type_9
Modular message request, message type 9
data: Sub-Data
type: Sub-Data type
CAN data request
{"type":2}
Firmware manifest request
{"type":1}
Time and location stamp request
{"type":4}
Output state change
output
Output state change
state: Desired state of output
ordinal: Output ordinal number
Set Output 0 (siren) ON
{"state":true,"ordinal":0}