[Changelog] cellocator protocol

namo

namo
One more Module 28 event is supported for Message type 11 for cellocator protocol:

Event 15 MultiSense Door/Window Open/Close - flespi parameter door.open.status

namo

Cellocator protocol updated: added parsing of Message Type 11 > Module 28 > Events:

3 - Man Down - flespi parameter mandown.alarm.status=true is registered for this event
11 - Check-In
18 - Sudden Pressure Change - flespi parameter altitude.difference is registered for this event (value is in meters)
19 - Check-out by timeout event
20 - Check-out by user event
23 - MultiSense button pressed event - flespi parameter button.pressed.event=true

namo

The list of supported devices for Cellocator protocol has been extended to include the following ones:

namo

namo
Cellocator protocol updated: added parsing of one more Message Type 11 > Module 28 event:

21 - No MultiSense received

Time elapsed from the last reception of sensor value is stored into flespi parameter sensor.reading.fix.age

namo

Some changes in parameters are introduced for Cellocator protocol:

parameters din and dout are deprecated and will be removed in a week, 30-Mar-2021 at 9:00 UTC approx.
parameters device.io.bitmask.1 - device.io.bitmask.4 are registered instead, containing 1st - 4th Bytes of Device's I/O Status accordingly

namo

namo
Cellocator protocol is updated: deprecated parameters are removed.

namo

Cellocator protocol updated: added new modules of Message type 11:

Module 70: Driver Behavior Event
Module 75: Driver Behavior Maneuver Extended Data

namo

Cellocator protocol is updated: Event Code 13 (Guest MultiSense raw data) of Module 28 (General Status Event) is supported.
The following flespi parameters are registered:

sensor.rssi.1 - byte 10 RSSI, dBm
sensor.mac.address - bytes 11-16 MAC Address
sensor.battery.voltage.1 - bytes 18-19 Battery Level, V
sensor.temperature - bytes 26-27 Temperature, Celsius degrees
sensor.humidity - bytes 28-29 Humidity, %
sensor.illumination - bytes 30-31 Light Level, lux
sensor.x.acceleration - bytes 33-34 Last measured X acceleration, g
sensor.y.acceleration - bytes 35-36 Last measured Y acceleration, g
sensor.z.acceleration - bytes 37-38 Last measured Z acceleration, g
sensor.battery.voltage.2 - bytes 39-40 Battery Level, V
temperature.alert - bit 2 of byte 41, Temp Alert
himidity.alert - bit 6 of byte 41, Humidity Alert
sensor.rssi.2 - byte 42 RSSI, dBm

namo

Cellocator protocol is updated: Event code 8 (MultiSense Added) and Event code 9 (MultiSense Removed) of Module 28 (General Status Event) are supported.
The following flespi parameters are registered for these events:

sensor.mac.address - MAC Address
sensor.battery.level - Battery level, %
sensor.rssi - Last RSSI value (SR-RF) (Signed, dBm units)

namo

The following settings are added for Cellocator CelloTrack Nano device, Actions tab:

Request Position
Request SIM ICCID
Connect to Server
Reset Unit

namo

Cellocator protocol is updated: Module 1 - DTC Event of Message Type 11 is supported.
The following flespi parameters are registered for this module:

moduel.id=1 signifying that Module 1 DTC Event is received from the device
can.dtc.number - Number of DTCs received by Mode 3
can.dtc (indexed parameter, optional) - Mode 3 DTCs
can.pending.dtc (indexed parameter, optional) - Mode 7 DTCs

namo

Event code 17: Tag mode MultiSense raw data of Module 28 of Message type 11 is supported for CelloTrack Nano device. The following parameters are registered:

byte 10: RSSI - sensor.rssi, dBm
bytes 11 - 16: MAC Address - sensor.mac.address
bytes 18,19, bits 0-13: Battery Level - sensor.battery.voltage, volts
byte 25, bits 5-7: Zone # - sensor.zone

namo

Module 46 - 2G/3G/4G Cell-ID of Message Type 11 is supported for Cellocator protocol.
The following flespi parameters are registered for this module:

bytes 10,11: Serving Cell MCC - gsm.mcc
bytes 12,13: Serving Cell MNC - gsm.mnc
bytes 14,15: Serving Cell LAC / TAC - gsm.lac
bytes 16 - 22: Serving Cell Global Cell ID - gsm.cellid
bytes 23, 24: Serving Cell PSC / Physical Cell ID - gsm.pcid
byte 25: Serving Cell Reference Signal Received Power, dBm - network.signal.rsrp
byte 26: Serving Cell Access Technology: 2G=0, 3G=2, 4G=7 - gsm.network.type

For the neighbor cells, if any, the same parameters are registered additionally with indexes starting from 1.

namo

Cellocator protocol is updated: now position parameters are copied into all messages for different modules of Message Type 11.

namo

New settings are added for Cellocator Cello IQ: Dallas Key 2 and Dallas Key 3, Miscellaneous tab:

namo

Module 90: Primary Battery Fuel Gauge Status is supported for Message type 11 of Cellocator protocols. The following flespi parameters are registered for this module:

byte 5: Battery State of Health, % - battery.health
byte 6: Battery Fuel Gauge Status 1 - battery.state.bitmask.1
byte 7: Battery Fuel Gauge Status 2 - battery.state.bitmask.2
bytes 10,11: Temperature Reading, degrees - battery.temperature
byte 14: Cellular RSSI, dBm - gsm.signal.dbm

The update is applicable for Cellocator CelloTrack 10Y

namo

Cellocator protocol updated: added Module 35 EDR Crash Attributes and Module 43 Calibration Matrix Response of CSA (Cellocator Safety Application) OTA Protocol
Mapping to flespi parameters is the following:

Module 35

Crash ID - crash.id
Vehicle Type - vehicle.type
Crash Type - crash.type
Acceleration Max (X or Y) during Crash - crash.max.acceleration
Crash Orientation - crash.orientation
Roll Indication - rollover.event
Parking Indication - driving.status
Crash Duration - crash.duration
Number of Acceleration Samples Between Last GPS Before Crash and Crash - samples.before.crash
Number of Acceleration Samples Between Crash and Next GPS - samples.after.crash
Number of Complete GPS Seconds Before Crash - time.before.crash
Number of Complete GPS Seconds After Crash - time.after.crash

Module 43

Index 1 ... Index 21 - calibration.matrix.index.1 ... calibration.matrix.index.21

namo

Cellocator protocol is updated as a part of big refactoring process. The following changes are introduced.
Modules 46: 2G/3G/4G Cell-ID, 70: Driver Behavior Event and 75: Driver Behavior Maneuver Extended Data will not be registered a separate message any more, instead all parameters that come for these modules will be registered into one message for each packet received from device.

Below is a layout of modules values into flespi parameters.

Module 70: Driver Behavior Event

Calibration Status - calibration.status: true - calibration is in progress, false - calibration is finished
Engine - engine.ignition.status: true - ignition is On, false - ignition is OFF
Driver ID - driver.id
Event Reason 2 - Accident (Crash) event:
-- crash.event=true will always present for Accident (Crash) event
-- Crash Orientation- crash.direction.enum
-- Roll - rollover.alarm.status: true - roll detected, false - roll not detected
-- Parking - crash.movement.status: true - crash while driving, false - crash while parking
Event Reason 5 - Calibration event:
-- Calibration Status - calibration.state.enum
-- Calibration Step - calibration.step
-- Calibration Phase - calibration.phase
Event Reason 6 - Harsh Acceleration:
-- harsh.acceleration.event=true will be registered for this event
Event Reason 7 - Harsh Braking:
-- harsh.braking.event=true will be registered for this event
Event Reason 8 - Harsh Turn:
-- harsh.turn.event=true will be registered for this event
-- harsh.turn.right.event=true will be registered for right turn detected
-- harsh.turn.left.event=true will be registered for left turn detected
Event Reason 9 - Over Speeding:
-- overspeeding.event: true - for Over Speeding Start event, false for - Over Speeding Stop event.

Module 75: Driver Behavior Maneuver Extended Data

Maneuver Type: depending on the value one of the following parameters will ve registered:
-- maneuver.harsh.acceleration.event=true
-- maneuver.harsh.braking.event=true
-- maneuver.harsh.turn.right.event=true
-- maneuver.harsh.turn.left.event=true
-- maneuver.overspeeding.event=true
Maneuver Start Longitude - maneuver.start.longitude ,degrees
Maneuver Start Latitude - maneuver.start.latitude, degrees
Maneuver Stop Longitude - maneuver.stop.longitude, degrees, registered only for over speeding event
Maneuver Stop Latitude - maneuver.stop.latitude, degrees, registered only for over speeding event
Maneuver Start GPS Fix - maneuver.start.position.valid: true - GPS fix is valid, false - no GPS fix
Maneuver Start time and date - maneuver.start.timestamp, seconds
Maneuver Stop GPS Fix - maneuver.stop.position.valid: true - GPS fix is valid, false - no GPS fix, registered only for over speeding event
Maneuver Stop time and date - maneuver.stop.timestamp, seconds, registered only for over speeding event
Maneuver Duration - maneuver.duration, seconds
Max X Acceleration - maneuver.max.x.acceleration, g
Max Y Acceleration - maneuver.max.y.acceleration, g
Max Speed - maneuver.max.speed, km/h
Turn Direction Change - maneuver.harsh.turn.angle, degrees

Module 46: 2G/3G/4G Cell-ID: see parameters layout in this post namo

namo

Below is a layout of values of MultiSense modules of message type 11 into flespi parameters for Cellocator CelloTrack Nano

Module 40: Measurement Readings

Event Code - sensor.readings.type: 1 - temperature °C, 2 - humidity %
Metadata Source - measurement.source
Readings with corresponding timestamp are regiatered into JSON object parameter sensor.readings:

"sensor.readings": [
    {
      "timestamp": 1636952492,
      "value": 41.8
    },
    {
      "timestamp": 1636952552,
      "value": 41.9
    },
    {
      "timestamp": 1636952612,
      "value": 42
    },
    ...
]

Module 42: Nano Inherent Sensors

X acceleration - device.x.acceleration, g
Y acceleration - device.y.acceleration, g
Z acceleration - device.z.acceleration, g
Ambient Light - device.illuminance, lux
Air pressure translated to altitude above sea-level - device.pressure.altitude, m
Current temperature from the most accurate available source - device.temperature, °C
Temperature Readings Validity - device.temperature.valid: true - valid, false - invalid
Nano battery level - device.battery.level, %
RSSI of cellular modem - gsm.signal.dbm, dbm

Module 44: MultiSense Additional Information

MultiSense MAC address - sensor.mac.address.additional
Battery level - sensor.battery.level.additional, %
Last BLE RSSI - sensor.rssi.additional, dBm
Time of last communication from the specific MultiSense - sensor.last.timestamp.additional, s
Last measured temperature - _sensor.temperature.additional, °C
Last measured humidity - sensor.humidity.additional, %
Last measured light level - sensor.illuminance.additional, lux
Last measured X acceleration - sensor.x.acceleration.additional, g
Last measured Y acceleration - sensor.y.acceleration.additional, g
Last measured Z acceleration - sensor.z.acceleration.additional, g
Magnetic Sensor State - sensor.magnet.status.additional: true - magnet present, false - magnet not present
Package State - sensor.package.status.additional: true - opened, false - closed

namo

Below is a layout of values of MultiSense module 28 of message type 11 into flespi parameters.
Applicable for Cellocator CelloTrack Nano

Module 28: General Status Event

Event Category - event.category, event.category.1, event.category.2 etc
Event Code - event.enum, event.enum.1, event.enum.2 etc

Since this module can contian several events, parameters event.category and event.enum are registered with indices staring with 1 and increasing by 1 for the second and subsequest events (if present). If module 28 contains only one event - only one pair of parameters will be registered: event.category and event.enum without indexes.

The other parameters depend on the event.category and event.enum value.

event.enum=1 (event.category=1): Impact

impact.event=true
Source of measurement - measurement.source.<event.enum>
Impact acceleration RMS value = SQRT (X² + Y² + Z²) - acceleration.rms.<measurement.source>

event.enum=3 (event.category=1): Man Down

mandown.event=true

event.enum=4 (event.category=1): Package Open/Closed

Source of measurement - measurement.source.<event.enum>
Open/Close - sensor.package.status.<measurement.source>, true - opened, false - closed
Filtered current light value - sensor.illuminance.<measurement.source>, lux

event.enum=7 (event.category=1): MultiSense Provisioning

Source of measurement - measurement.source.<event.enum>
Problem Code - sensor.error.code.<measurement.source>
Battery level - sensor.battery.level.<measurement.source>, %
Last RSSI value - sensor.rssi.<measurement.source>, dBm
Time of last communication from the specific MultiSense - sensor.last.timestamp.<measurement.source>, s
Last measured temperature - sensor.temperature.<measurement.source>, °C
Last measured humidity - sensor.humidity.<measurement.source>, %
Last measured light level - sensor.illuminance.<measurement.source>, lux
Last measured X acceleration - sensor.x.acceleration.<measurement.source>, g
Last measured Y acceleration - sensor.y.acceleration.<measurement.source>, g
Last measured Z acceleration - sensor.z.acceleration.<measurement.source>, g
Magnetic Sensor State - sensor.magnet.status.<measurement.source>: true - magnet present, false - magnet not present
Package State - sensor.package.status.<measurement.source>: true - open, false - closed

event.enum=8 (event.category=1): MultiSense Added

Source of measurement - measurement.source.<event.enum>
sensor.paired.status.<measurement.source>=true
MAC Address - sensor.mac.address.<measurement.source>
HW-TYPE of added MultiSense - sensor.type.bitmask.<measurement.source>
Battery level - sensor.battery.level.<measurement.source>, %
Last RSSI value - sensor.rssi.<measurement.source>, dBm

event.enum=9 (event.category=1): MultiSense Removed

Source of measurement - measurement.source.<event.enum>
_sensor.paired.status.<measurement.source>=false
MAC Address - sensor.mac.address.<measurement.source>
HW-TYPE of added MultiSense - sensor.type.bitmask.<measurement.source>
Battery level - sensor.battery.level.<measurement.source>, %
Last RSSI value - sensor.rssi.<measurement.source>, dBm

event.enum=10 (event.category=1): Work-ID/Activation

Work-ID - work.id

event.enum=13 (event.category=1): Guest MultiSense raw data

Source of measurement - measurement.source.<event.enum>
RSSI - sensor.rssi.<measurement.source>, dBm
MAC Address - sensor.mac.address.<measurement.source>
Group ID - sensor.group.id.<measurement.source>
Battery Level - sensor.battery.voltage.<measurement.source>, V
TX Reason - sensor.report.reason.<measurement.source>
Temperature - sensor.temperature.<measurement.source>, °C
Humidity - sensor.humidity.<measurement.source>, %
Light Level - sensor.illuminance.<measurement.source>, lux
Magnetic Sensor State - sensor.magnet.status.<measurement.source>
Package State - sensor.package.status.<measurement.source>
Last measured X acceleration - sensor.x.acceleration.<measurement.source>, g
Last measured Y acceleration - sensor.y.acceleration.<measurement.source>, g
Last measured Z acceleration - sensor.z.acceleration.<measurement.source>, g
Battery Level - sensor.battery.voltage.<measurement.source>, V
Temperature Alert - sensor.temperature.alert.<measurement.source>
Humidity Alert - sensor.humidity.alert.<measurement.source>
RSSI - sensor.rssi.<measurement.source>, dBm

event.enum=15 (event.category=1): MultiSense Door/Window Open/Close

Source of measurement - measurement.source.<event.enum>
Open/Close - sensor.door.status.<measurement.source>: true - open, false - closed

event.enum=16 (event.category=1): Free-fall

free.fall.event=true
Source of measurement - measurement.source.<event.enum>
Free fall acceleration RMS value = SQRT (X² + Y² + Z²) - acceleration.rms.<measurement.source>

event.enum=17 (event.category=1): Tag mode MultiSense raw data

Source of measurement - measurement.source.<event.enum>
RSSI - sensor.rssi.<measurement.source>, dBm
MAC Address - sensor.mac.address.<measurement.source>
Group ID - sensor.group.id.<measurement.source>
Battery Level - sensor.battery.voltage.<measurement.source>, V
TX Reason - sensor.report.reason.<measurement.source>
Zone - sensor.zone.<measurement.source>

event.enum=18 (event.category=1): Sudden Pressure Change

Difference between the last stable altitude and current filtered one - altitude.difference, m

event.enum=21 (event.category=1): No MultiSense received

Source of measurement - measurement.source.<event.enum>
Time elapsed from last reception - sensor.reading.age.<measurement.source>, s

event.enum=23 (event.category=1): MultiSense button pressed event

Source of measurement - measurement.source.<event.enum>

« Previous Page Next Page »