CR300 Wireless Communication Protocol
CR300 Wireless Communication Protocol
CR300 Wireless Communication Protocol
Communication Protocol -
CR300
Version 4.4.1.3
POINTER TELOCATION LTD. 14 HAMELACHA ST. ROSH HA'AYIN 4809133, ISRAEL ● TEL: 972-3-5723111 ● FAX: 972-3-5723100 ● WWW.POINTER.COM
Legal Notices
IMPORTANT
1. All legal terms and safety and operating instructions should be read thoroughly before
the product accompanying this document is installed and operated.
2. This document should be retained for future reference.
3. Attachments, accessories or peripheral devices not supplied or recommended in
writing by Pointer Telocation Ltd. May be hazardous and/or may cause damage to the
product and should not, in any circumstances, be used or combined with the product.
General
The product accompanying this document is not designated for and should not be used in
life support appliances, devices, machines or other systems of any sort where any
malfunction of the product can reasonably be expected to result in injury or death.
Customers of Pointer Telocation Ltd. Using, integrating, and/or selling the product for use
in such applications do so at their own risk and agree to fully indemnify Pointer Telocation
Ltd. For any resulting loss or damages.
Intellectual Property
Copyright in and to this document is owned solely by Pointer Telocation Ltd. Nothing in
this document shall be construed as granting you any license to any intellectual property
rights subsisting in or related to the subject matter of this document including, without
limitation, patents, patent applications, trademarks, copyrights or other intellectual
property rights, all of which remain the sole property of Pointer Telocation Ltd. Subject to
applicable copyright law, no part of this document may be reproduced, stored in or
introduced into a retrieval system, or transmitted in any form or by any means
(electronic, mechanical, photocopying, recording or otherwise), or for any purpose,
without the express written permission of Pointer Telocation Ltd.
© Copyright 2019. All rights reserved.
Table of Contents
1 Introduction .............................................................................................................. 7
1.1 About this Document .................................................................................................... 7
1.2 Abbreviations ............................................................................................................... 8
1.3 References .................................................................................................................. 9
2 Telemetry Channel (Outbound Messages) ............................................................... 10
2.1 Overview ................................................................................................................... 10
2.2 Status/Location Message (Message Type 0) ................................................................... 11
2.2.1 Message Ingredients ................................................................................................... 11
2.2.2 Byte-Aligned Table ..................................................................................................... 12
2.2.3 Detailed Per-Field Specifications ................................................................................... 14
2.2.4 Distress (Emergency) Queue Description ....................................................................... 37
2.3 Programming Data (Message Type 3) ........................................................................... 38
2.3.1 Message Ingredients ................................................................................................... 38
2.3.2 Byte-Aligned Table ..................................................................................................... 38
2.3.3 Detailed Per-Field Specifications ................................................................................... 39
2.4 Logged Fragment of Forwarded Data from Serial Port to Wireless Channel (Message Type 7) 40
2.4.1 Message Ingredients ................................................................................................... 40
2.4.2 Byte-Aligned Table ..................................................................................................... 40
2.4.3 Detailed Per-Field Specifications ................................................................................... 42
2.5 Real Time Forwarded Data from Serial Port to Wireless Channel (Message Type 8) ............. 46
2.5.1 Message Ingredients ................................................................................................... 46
2.5.2 Byte-Aligned Table ..................................................................................................... 46
2.5.3 Detailed Per-Field Specifications ................................................................................... 48
2.6 Modular Message (Message Type 9) .............................................................................. 50
2.6.1 Message Ingredients ................................................................................................... 50
2.6.2 Byte-Aligned Table ..................................................................................................... 50
2.6.3 Detailed Per-Field Specifications ................................................................................... 51
2.6.4 Outbound Sub-Data Types Table .................................................................................. 52
2.6.5 Firmware Platform Manifest ......................................................................................... 52
2.6.6 Time and Location Stamp ............................................................................................ 54
2.6.7 Usage Counter ........................................................................................................... 57
2.6.8 Authentication Table Update ........................................................................................ 57
2.6.9 Neighbor list of the Serving GSM Cell ............................................................................ 58
2.6.10 Maintenance Server Platform Manifest........................................................................... 59
2.6.11 3G Cell ID Data .......................................................................................................... 65
2.6.12 Compressed Vector Change Report ............................................................................... 67
2.6.13 Modular Platform Manifest ........................................................................................... 69
2.6.14 Pulse Counter Measurement Response .......................................................................... 77
2.6.15 One-Wire Temperature Sensor Measurement ................................................................. 78
1 Introduction
1.1 About this Document
This document describes the unit wireless communication protocol structure,
implemented in Cellocator units. It describes every byte of the inbound/outbound
messages, which can be sent/received by the unit over the air.
The document comprises of the following main parts:
Telemetry Channel (outbound messages initiated from the unit towards the server)
Command Channel (inbound messages initiated from the server towards the unit)
CSA Channel
Most communication flow scenarios between the unit and the server implement
acknowledge from the receiving side to the sending side. Some are done using generic
ACK (acknowledge) message, and some are done using other messages dedicated to the
specific scenario.
A large portion of the outbound messages from the unit to the server, are initiated by the
unit in a response to a certain trigger (e.g. GPIO activation, speed violation, etc.). Those
messages are referred as events. The unit supports the following kinds of events:
Logged Event: If the condition for a specific logged event is met, the unit will create
an event and store it into its non-volatile memory. The event will be sent to the server
only during the GPRS session and will be deleted from the memory of the unit only
after reception of acknowledge from the server. Note: Plain events will never be
delivered by SMS.
Distress Event: If the condition for a specific distress event is met, the unit will
create a series of messages (session). The messages will be sent to the server
immediately with the first available communication transport (during GPRS session –
over IP, otherwise by SMS). The messages are not stored in the unit memory and if
there is no cellular coverage at the moment of sending the message will be lost.
Distress events do not require acknowledge from the server.
Active Logged Event: This event is designed to enhance the functionality of legacy
logged events. It is important for units such as CelloTrack, which are battery operated
and mostly hibernating while periodically communicating with the server. Enabling the
Active Logged Event feature changes the behavior of the unit in the following way:
During Hibernation
When a new event is generated, the unit will turn its modem and GPS on, wait for
a GPS fix and then queue the event into the event queue. The event will be
transmitted to the server, acknowledged by the server and removed from the
queue. Active Logged Event turns the unit on from hibernation for up to 2 minutes.
If a GPS fix is not detected within 1.5 minutes from the beginning of the session,
the event will be queued into the events queue and sent towards the server while
giving an extra 30 seconds for the server to acknowledge the event. If a cellular
link is not available the unit will be turned off and the message will wait in the
queue for later delivery.
Event
Queue Event
Transmit Event
1.2 Abbreviations
Abbreviation Description
ACK Acknowledge
DB Database
FW Firmware
HW Hardware
1.3 References
All the reference documents listed in the following table can be downloaded from the
support section of the Pointer Website (www.pointer.com).
# Reference Description
Real Time Forwarded Data from Serial Port to Wireless Channel (Message
Type 8) – this legacy message is sent when the terminal, connected to the serial port
of the unit is forwarding data to the central control without logging it.
Modular Message (Message Type 11) – this modular message type implements an
extended modular protocol, intended to replace older message types (0, 3, and 9). It
is currently used for CAN bus applications, CelloTrack Nano, CelloTrack-4 family,
configuration memory programming and uploading of devices with 8 Kbytes of
configuration memory, etc.
Longitude – 4 bytes
Latitude – 4 bytes
Altitude – 4 bytes
Byte Description
6 Unit ID
11
19 Transmission Reason
31
32
35
36
37
38
40
42 Mode 1
43 Mode 2
45 Longitude
46
47
48
49 Latitude
50
51
52
53 Altitude
54
55
56
57 Ground Speed
58
59
60
62
69
Multiple byte fields are sent Intel style (i.e. least significant bytes sent first).
2.2.3.3 Unit ID
This field contains a value that is uniquely assigned for every Cellocator unit during the
manufacturing process. All messages sent by the same unit contain the same value in the
Unit ID field.
Message initiative
0 – Active transmissions (initiated by the unit, based on its logic and decisions)
1 – Passive responses (response to a command or a query message)
Message Source
0 – Direct message (not from memory)1
1 – Message from memory (the unit tries to resend the message from the memory, until
ACK from the server is received)
Multi-Purpose Field (Bytes 33-38) Assignment
This 2 bits, along with bit 7 in byte 41 of this message (Service and Status), define the
data provided in bytes 33-38 of this message according to the following table:
1 0 0 IMEI
1
The only exception is the "Transmission Reason 32 - IP changed/Connection up" message, which always requires ACK from
server, even if it was sent as a direct message and not through memory.
Note: The Communication Control Field is sent also in other (than 0) message types. In
those message types the Multi-Purpose Field (Bytes 33-38) Assignment indication is a
don't care.
Firmware Sub-Version
This field (5 bits) defines the firmware sub-version of the unit. The number of Cellocator
firmware is built from two parts: [Firmware version][Firmware sub-version], where
firmware version usually defines the unit family and the sub-version defines the list of
supported features.
For example, 30a:
Version – 30
Sub-Version – a (1)
0 No identifier
1 a
2 b
3 c
… …
26 z
Business/Private Mode
It is possible to enable usage of Lock input as a Private/Business mode toggle. If enabled,
every time the Lock input is triggered the unit switches to the opposite mode (Private
Business Private). The default mode is Business. The Private mode is finished upon
Lock input trigger, or when the active ID is erased from RAM after trip end.
0 – Bussiness
1 – Private
Momentary/Max Speed
0 – Momentary speed
1 – Max speed recorded from last event
Note: The Communication Control Field is sent also in other (than 0) message types. In
those message types the Momentary/Max Speed indication is a “don't care”.
GSM Hibernation
0 – Unit is not in GSM hibernation
1 – Unit is in GSM hibernation (message sent during GSM peeking)
--------------------------------------------------------------------------------------------
NOTE: The unit assigns different message numerator sequences for the logged events
and for real-time events. In passive transmission (reply to command), the value in this
field represents the number from the Command Numerator Field in an incoming
command.
--------------------------------------------------------------------------------------------
2 2 CFE 0 No Modem
The table for new products, which will be identified by the New HW ID is detailed
below:
Version – 30
Sub-Version – a (1)
Protocol Version
GPS Comm.
0 – Communication with GPS is available
1 – Communication with GPS is not available
Home/Roam Network
0 – Home network
1 – Roam network
Correct Time
0 – Valid time stamp
1 – Invalid/estimated time stamp
Source of Speed
0 – GPS
1 – Pulse frequency input
Current GSM Operator
The current GSM Operator (PLMN) is represented as a 5 character hexadecimal number.
After conversion into decimal it represents the MCC-MNC of a cellular operator (country
code + network number). The 5 PLMN nibbles (nibble for each character) are provided in
the following places:
(4MSbits)
Current GSM Operator (PLMN), 2nd Nibble Current GSM Operator (PLMN), 3rd Nibble
12
1-Wire
Temperature
Sensor 0 - Low
Measurement Sensor ID (0-3)
1 - High
Event
15
Crash detection Peak RMS value of the impact in
Light Heavy
Reserved crash crash 1g resolution minus 1g
event event (16g=0xF, 1g=0x0)
21 0 – Stop
Coasting 1 – Start
detection
(speed and
RPM)
22 0 – Falling
st
Violation of 1 1 – Rising
Additional GP
Frequency
Threshold
23 0 – Falling
nd
Violation of 2 1 – Rising
Additional GP
Frequency
Threshold
34 0 – Plain
Over speed 1 – Threshold changed by input
start
42 0 – Plain
Over speed end 1 – Threshold changed by input
46
Driver Group ID status Unused Unused User Type
authentication
update 0 – Not Driver ID 0 – Driver ID
Authenticated Card 1 – Passenger
1 – Authenticated Introduced/ ID
Removed
0–
Introduced
1-
Removed
47 0 - Legacy logics
Driving without
authentication
Door 0 – Normal
48 - Close 1 – Robbery Event
64 - Open 2 – Car Sharing 2: End Of Reservation
Shock/Unlock2 0 – Normal
1 – Car Sharing 2: Modem Off Ended
49 - Inactive 2 – Car Sharing 2: Modem Off Started
65 - Active 3 – Car Sharing 2: Business Mode started
4 – Car Sharing 2: Private Mode started
53 0 – Accelerometer based
Driving stop
69 0 – Accelerometer based
Driving start 1 – GPS based (CelloTrack family only)
158
Tamper active 1 – Reserved
2 – Nano and PointerCept(CR300): Tilt tamper
191
Geo hotspot
violation Direction The index of the geo-fence
0 – exit from hot spot
1 – entry to hot spot
192
Frequency
measurement Violating Violation Violation Violation Reserved
threshold input status type direction
violation number
0– 0– In case of
0– Violation Threshold Threshold
Door start 1– 0 – Low
1– 1– Range threshold
Shock Violation 1 – High
End threshold
In case of
range
0 – Keep
In
1 – Keep
Out
194
Analog
measurement Violating Violation Violation Violation Reserved
threshold input status type direction
violation number
0– 0– 0 – Low
0 – Door Violation Threshold threshold
1– start 1 – Range 1 – High
Shock 1– threshold
Violation
End
200
AHR (Auto AHR reason Number of performed AHR
Hardware 0 – Modem non responsiveness attempts
Reset)
1 – Registration problem
2 – GPS AHR
206
Jamming Not used GSM GSM jamming
detection jamming ignition state
state 0 – GSM jamming
0 – Legacy (Not detection start
associated with 1 – GSM jamming
Ignition state) detection end
Advanced
Jamming Mode:
1 – Ignition Off
2 – Ignition On
207
Radio off mode
Spare Airplane Early GPS Modem
Mode Radio Status Status
Off 0 – Off 0 – Off
Event 1 – On 1 – On
0 0 0 0 0 Detection of internal
backup battery voltage
discharging to 3.25V or
below for longer than 1
second (100 samples). The
unit will enter shipment
mode only after
generating this event.
0 0 0 0 0 1 N/A
0 0 0 0 1 0 Detection of internal
backup battery voltage
lower than 3.46V (on any
temperature) for longer
than 1 second (100
samples) upon sole work
from internal backup
battery. The unit will
switch off the radio 2
seconds after event
generation. Once switched
off, the modem will be
switched back on only
upon main power
reconnection.
0 0 0 0 1 1
N/A
0 0 0 1 0 0 N/A
0 0 0 1 0 1 N/A
0 0 0 1 1 0 N/A
0 0 0 1 1 1 N/A
213
Geo-fence over
speed end
222 0 – Reserved
PointerCept 1 – PointerCept operational beacon transmission start
beacon 2 – PointerCept operational beacon transmission stop
3 – PointerCept OTA command initiated beacon transmission start
4 – PointerCept OTA command initiated beacon transmission stop
5 – PointerCept periodic beacon transmission start
6 – PointerCept periodic beacon transmission stop
252
Com location 3 – logged events upload due to timer expiration
glancing /
4 – logged events upload due to full memory
Offline tracking
5 – logged events upload due to events amount
6 – logged events upload due to end of trip
7 – logged events upload due to input activation
254
Violation of
keep out fence
255
Violation of
waypoint
8 Towing
11 Communication idle
15 Crash detection
31 Reply to command
322 IP changed/connection up
2
Always requires acknowledge from server, even if it was sent as a direct message and not through memory.
36 Distance event
44 Timed event3
48 Door close
49 Shock/Unlock2 inactive
53 Driving stop
64 Door open
65 Shock/Unlock2 active
69 Driving start
3
In Cello-CANiQ, this event is used also for the 1 second GPS data reporting.
85 Go (movement start)
92 Satellite communication
0x10 Towed mode (same as Standby Engine On, but with ignition off)
Note: Driving Status (bit 5) provides indication if the unit is in logical Ignition On/Off,
according to the configuration of the detection source (physical ignition or accelerometer).
It will indicate "1" when logical Ignition On is detected, and "0" when logical Ignition Off is
detected.
Notes: Accelerometer Status (bit 6) provides indication if the accelerometer has detected
Ignition On/Off, regardless of the configuration of the detection source (physical ignition
or accelerometer). It will indicate "1" when accelerometer Ignition On is detected, and "0"
when accelerometer Ignition Off is detected. Ignition Port Status (bit 7) provides
indication if the physical ignition input is high/low, regardless of the configuration of the
detection source (physical ignition or accelerometer). It will indicate "1" when the ignition
input is high, and "0" when the ignition input is low.
Current GSM Operator (PLMN), 4th Nibble Current GSM Operator (PLMN), 5th Nibble
0 No source
20 RSSI
4
The analog inputs measurement resolution is variable (either in 9.8mA or 117.6mA resolution), and controlled by
programmable parameter.
1 0 0 IMEI
90 78 56 34 12 00
Note: for CDMA devices, the IMEI is replaced with MEID, which is 18 decimal digits long.
Thus, MEID will not be transmitted in these bytes (only in Type 9, sub data 0x12).
IMSI
In case of a Wake Up event (TR 202), the unit reports the 12 first characters of the SIM
IMSI converted to hex (Little Endian).
The IMSI number consists of up to 15 numerical characters (0-9). An IMSI consists of a
three digit mobile country code (MCC, which is not reported by Cellocator Protocol) and a
variable length national mobile station identity (NMSI).
The NMSI consists of two variable length parts: the mobile network code (MNC) and the
mobile station identification number (MSIN). A Class 0 IMSI is 15 digits in length. A Class
1 IMSI is less than 15 digits in length.
Example: 425020315229000 (Cellcom IL)
MNC 02 Cellcom IL
MSIN 0315229000
Value (hex) 00 5A 16 0F 03 02
Conversion table:
DEC values 02 03 15 22 90 00
Bit Bit Bit Bit Bit Bit Bit Bit Bit Bit Bit Bit Bit Bit Bit Bit
4 3 2 1 0 4 3 2 1 0 5 4 3 2 1 0
Byte 40 Byte 39
---------------------------------------------------------------------------------------------
NOTE: The easiest way to define if the GPS data in the message is valid and updated, or
historical, is to compare between the time of the timestamps and UTC time (see below).
---------------------------------------------------------------------------------------------
If "Enable Tight GPS PMODE Filter" is enabled, the unit considers the GPS data as
valid only if Mode 1 = 3 or 4 AND Mode 2 = 2
If "Enable Tight GPS PMODE Filter" is disabled, the unit considers the GPS data as
valid only if Mode 1 =2, 3, 4, 5 and 6
2.2.3.24 Altitude
Altitude of current position fix. Represented as a 32-bit signed integer, in 10-2 meter
resolution (altitude is represented in centimeters).
---------------------------------------------------------------------------------------------
NOTE: For configuration spaces larger than 4K (Typically in Cello-IQ and Cello-CANiQ
units) it is mandatory to use Type 11 programming command (modules 10, 11).
---------------------------------------------------------------------------------------------
Spare – 1 byte
Byte Description
6 Unit ID
11
13 Spare
14 Block Code
2.3.3.3 Unit ID
.2.3.3
Refer to Section 2
Requires acknowledge from the server (Message type 4) in order to erase the specific
message from the log.
Byte Description
Byte Description
6 Unit ID
11
1 – N/A 0 – Not
connected
2 – COM2 (BT)
1–
3 – COM3 Connected
4 – COM4
5 – COM5
6 – CFE Micro
7 – N/A
Byte Description
2.4.3.3 Unit ID
.2.3.3
Refer to Section 2
payload from serial port is escorted by 48 bytes of FM (fleet management) data, and 2
bytes of total length of payload + FM data.
If the unit is configured to work with simple payload ("Forward Data as Container"
parameter (address 285, bit 6) is disabled), the payload will be in a form of a simple
payload: forwarded payload from serial port only.
In addition, this byte includes a container/simple payload sequential ID.
Byte Description
1
Payload length (X)
2
3+X
4+X Unit Status + Current GSM Operator (1st nibble) (same as byte 16 of type 0)
5+X Current GSM Operator (2nd and 3rd nibbles) (same as byte 17 of type 0)
6+X Current GSM Operator (4th and 5th nibbles) (same as byte 25 of type 0)
16+X
18+X
19+X
20+X
23+X
24+X
25+X
Last GPS Fix (same as bytes 39-40 of type 0)
26+X
28+X Mode 1
29+X Mode 2
31+X
32+X
Longitude
33+X
34+X
35+X
36+X
Latitude
37+X
38+X
39+X
40+X Altitude
41+X
43+X
44+X
Speed direction (true course)
45+X
Spare – 2 bytes
Spare – 1 byte
Byte Description
Byte Description
6 Unit ID
11 Spare
12
1 – N/A 0 – Not
connected
2 – COM2 (BT)
1–
3 – COM3 Connected
4 – COM4
5 – COM5
6 – CFE Micro
7 – N/A
14 Spare
Byte Description
17 Payload Length
18
… Payload
2.5.3.3 Unit ID
.2.3.3
Refer to Section 2
If the unit is configured to work with simple payload ("Forward Data as Container"
parameter (address 285, bit 6) is disabled), the payload will be in a form of a simple
payload: forwarded payload from serial port only.
In addition, this byte includes a container/simple payload sequential ID.
……
Byte Description
6 Unit ID
11
12 Message Numerator
… …
Last Error Detection Code (8-bit additive checksum, excluding system code)
Byte
2.6.3.3 Unit ID
.2.3.3
Refer to Section 2
Direction
0 – Data from the unit
1 – Request (unit-bound)
Out of Space Indication
0 – All the requested data present in the message
1 – Some Sub-Data was not returned due to data size
2.6.3.7 Length
That field includes the number of data bytes with their types and lengths. It includes the
number of bytes from byte 15 to the byte of the checksum, which is not included.
Code Function
(Hex)
Byte Description
Byte Description
1 Length – 18
6-7 Size of volatile memory (Divided by 128 bytes and rounded up/down to
closest integer) (LSB)
8-9 Size of internal non-volatile memory (Divided by 128 bytes and rounded
up/down to closest integer) (LSB)
Byte Description
10-11 Size of external non-volatile memory (in 1024 bytes units) (LSB)
13 Hardware Version
See Unit Hardware Version
Byte Description
1 Length – 25
0 – Time is
accurate 0 – Connected
1 – Time is 1 – Not
Inaccurate Connected
6 Longitude
7
8
10 Latitude
11
12
13
14 Altitude
15
16
17 Ground speed
18
20
21 UTC time – seconds
2.6.6.4 Altitude
.2.3.24
Refer to Section 2
Byte Description
1 Length – 9
2 Spare
10
Byte Description
1 Length – 9
2 Spare
Byte Description
Byte Description
1 Length – 53
2 Spare (0x00)
3 seconds (0-59)
4 minutes (0-59)
5 hours (0-23)
6 day (1-31)
7 month (1-12)
Byte Description
… …
Zero Padding to complete the 55 bytes assigned for single event (if it's a
logged event, i.e. sent actively)
Byte Description
1 Length – 34
6-7 Size of volatile memory (Divided by 128 bytes and rounded up/down to
closest integer) (LSB)
Byte Description
8-9 Size of internal non-volatile memory (Divided by 128 bytes and rounded
up/down to closest integer) (LSB)
10-11 Size of external non-volatile memory (in 1024 bytes units) (LSB)
13 Hardware Version
See: Unit Hardware Version
Byte Description
Current PL ID (MSB)
Infrastructure only, currently not supported
Byte Description
30 Reserved (0)
33 Maintenance Configuration
0 Formal Release
Modem Revision ID
0 Unknown All
(Used also in Nano from
FW version 34d and on).
1 0.7.6 Enfora II
2 0.7.8
3,4 reserved
6 6.1.1 (Beta)
7 1.1.1PKG30
8 1.1.1PKG41
9 D3-1.1.2PKG47
10 D4-1.1.2PKG47
11 D10.1.1.2
12-20 reserved
21 7.02.002 Telit II
22 7.02.100
24 7.02.003
25 7.02.004
26 7.03.000
27 7.03.030 (Automotive)
28 7.03.002
29 7.03.032
31 10.00.036
32 10.00.035 (Obsolete)
33 10.00.016
34-40 reserved
52 02.000 Nano:
Cinterion BGS2-W.Rel2
(Used only up to FW
version 34c).
53 03.001_arn00.000.14 Nano:
Cinterion EHS5-E
(Used only up to FW
version 34c).
54 03.001_arn00.000.14 Nano:
Cinterion EHS5-US
(Used only up to FW
version 34c).
55 03.001_arn00.000.14 Nano:
Cinterion EHS6A
(Used only up to FW
version 34c).
56 03.001_arn01.000.08 Nano:
Cinterion BGS2-W.Rel3
(Used only up to FW
version 34c).
83-255 Reserved
Passively, as a reply to Cell ID data request (0x09). In this case the sub-data will be
sent using the same communication transport as the request.
Actively, if enabled in unit configuration, separately for home and roam GSM
networks, on address 201 and 203 respectively, bits 0, 1, 3 and 4.
Byte Description
1 Length – 53
2 Spare
5
Supported for 3G variants only
Byte Description
3 seconds (0-59)
4 minutes (0-59)
5 hours (0-23)
6 day (1-31)
7 month (1-12)
RSCP
15 (Received Signal Code Power - Energy after processing with gain from
coding, which is equivalent to RSSI [RSCP=RSSI+EC/No]; dBm units, (-
120)≤RSCP≤(-25))
16
17
Cell ID
(Expanded 3G Cell ID (RNC + Cell ID + possible sector))
18
19
Power
20
(Received signal strength (hex); the sign is not saved, this value is always
representing a negative number; dBm units)
Byte Description
Zero Padding to complete the 55 bytes assigned for single event (if it's a
…
logged event, i.e. sent actively)
Upon detection of 6th vector change detection occurrence - in this case the system
will generate a Message Type-9 containing all 6 vector change detection occurrences.
Timeout - if at least one vector change event is stored in unit's memory and no other
vector changes were generated by the unit during the pre-programmed period, the
system will generate Message Type-9 containing all previous vector change detection
occurrences.
Upon Stop - Message Type-9 containing all previous vector change detection
occurrences (if any) will be generated immediately upon stop report.
Upon reset command - the Message Type-9 containing all previous vector change
detection occurrences (if any) will be generated.
Byte Description
1 Length – 53
7-10 Latitude
11-13 Odometer
14 Spare
15 Course
16 Speed (km/h)
17-19 Time
20 Speed (km/h)
Each message will contain up to 6 vector change occurrences, while the first one is
reported in its full format, and the rest are reported as a delta relative to the last point
(see full message format on the next page).
Each vector change detection occurrence (except the first one) consumes 7 bytes
containing a data of location change from the last vector change (or from the start
event), time from the last event and speed.
The latitude, longitude and time of the first vector detection will be stored in its full
format.
True course of the first location is reported as 8-bit unsigned integer. The conversion to
degrees is according the equation below:
𝑅𝑒𝑐𝑒𝑖𝑣𝑒𝑑 𝑣𝑎𝑙𝑢𝑒 ∗ 360
𝐶𝑜𝑢𝑟𝑠𝑒 [𝑑𝑒𝑔𝑟] =
255
Possible values are 0 to 2π.
Timestamp of the first Vector change:
Delta Longitude and latitude (from last vector change) both are stored as signed integers,
in 10^-8 radian resolution. Possible values are -Π to +Π for longitude, or –Π/2 to +Π/2
for latitude.
Time from last vector change is recorded in seconds.
The reported value of speed may monitor the immediate value of speed recorded upon
generation of the message or the maximum value of speed from the last report (as per
the configuration). Byte 10, bit 6 of the message is monitoring the actual reported type.
If there are less than 6 vector change detections in this message, the unit pads unused
bytes of missing occurrences by zeros. The message length will remain constant.
Byte Description
1 Length – Variable
2 Field 1 – Identifier
4 Field 1 – Payload
… …
… Field N – Identifier
Byte Description
… Field N – Payload
Fields Definition
Processor Family Identifier
Accelerometer Identifier
Modem Type
Field ID – 0xA Same as in Type-0 message. See new table here (only the 3
modem ID bits, for backwards compatibility)
Bytes 45-47 of Maintenance Platform Manifest contain the value of modem revision. The
modem type is declared in a hardware byte; this field provides an additional definition.
Reserved (sent as zero) Modem revision ID, as per Reserved (sent as zero)
table below
The new Modem firmware reporting mechanism is supported by the following products and
FW versions:
Cello-CAN(IQ) from FW version 33x and later
CR300/B from FW version 43c and later
CelloTrack Nano from FW 34d and later
GPS Type
GPS Firmware
Field ID – 0xE
Byte Description
0 Year
1 Month
2 Day
3 Second
4 Minute
5 Hour
FW Upgrade Date/Time
Field ID – 0xF
Byte Description
0 Year
1 Month
2 Day
3 Second
4 Minute
5 Hour
Field ID – 0x10
Byte Description
0 Year
1 Month
2 Day
3 Second
4 Minute
5 Hour
Boot Loader ID
Field ID – 0x14
Byte Description
Cello-CANiQ VIN
IMSI/IMEI/MEID
Originating FW ID
Field ID – 0x17 This module holds the originating FW version or the last
version the code tree was merged with.
Byte Description
0 Originating Version ID
Example: 33b
33 – Version ID
b – Sub Version subversion Letter – ‘a’ = ‘b’-‘a’=1
BT Module/Extender Identification
Field ID – 0x1B
Byte Description
0 Module ID
0 – CSR 1010
Byte Description
0 Module ID
1 – BlueGiga BT121
1 HW Revision
3 FW Version – Bootloader
5 FW Version – Major
7 FW Version – Minor
9 FW Version – Patch
10
11 FW Version – Build
12
13 Spare
SIM ICCID
Maintenance Configuration
Field ID – 0x1F
Byte Description
1 Length – 26
2 Spare
3 Spare
4
Counter 1 (Liter)
5 4 bytes forming unsigned 32 bits value representing the amount of litters
consumed from the last pulse counter reset. The value is a multiplication of
6 the pulse counter value by the scaling factor value (PL address 2442-2443
for Door input and 2444-2445 for Shock input).
7
8
Counter 2 (Liter)
9 4 bytes forming unsigned 32 bits value representing the amount of litters
consumed from the last pulse counter reset. The value is a multiplication of
10 the pulse counter value by the scaling factor value (PL address 2442-2443
for Door input and 2444-2445 for shock input).
11
12 Spare
Byte Description
13 Spare
14 Spare
15 Spare
16 Spare
17 Spare
18 Spare
19 Spare
20 Spare
21 Spare
22 Spare
23 Spare
24 Spare
25 Spare
26 Spare
27 Spare
---------------------------------------------------------------------------------------------
NOTE: Litters are only one example for volume measurement units. Actually the real
measurement units are defined by the measuring device and its fuel volume vs. pulses
relation.
---------------------------------------------------------------------------------------------
Byte Description
Byte Description
1 Length – 26
Byte Description
26 Spare
27 Spare
Byte Description
1 Length – 53
2 Slot Number
3 Spare
Driver ID (SCN)
4–9
Bytes 0-5 of reservation table entry
Byte Description
1 Length (0x35)
2 Spare
3 seconds (0-59)
4 minutes (0-59)
5 hours (0-23)
6 day (1-31)
7 month (1-12)
RSSI
13
(Received Signal Strength Index [RSSI=Rx Power + EC/Io]; dBm units)
14
BSID
15
(Base Station ID (Cell ID + possible sector))
16
6
Supported for CDMA variants only
Byte Description
17
Zero Padding to complete the 55 bytes assigned for single event (if it's a
…
logged event, i.e. sent actively)
Message header
System Code – 4 bytes
Message Type – 1 byte
Unit ID – 4 bytes
Communication Control Field – 2 bytes
Message Numerator – 1 byte
Spare – 4 bytes
Byte Description
6 Unit ID
11
12 Message Numerator
14 Length of the modules section (From byte #16 and not including the last byte
of the checksum)
15
16 = 0x0000
18 Spare (sent as 0)
19
Other Modules
Last Error Detection Code (8-bit additive checksum, excluding system code)
Byte
2.7.3.3 Unit ID
.2.3.3
Refer to Section 2
Direction
0 – Data from the unit
1 – Request (unit-bound)
Out of Space Indication
0 – All the requested data is present in the message.
1 – Some Sub-data was not returned due to data size.
2.7.3.7 Length
That field includes the number of data bytes of the modules (with their codes and
lengths). It is the number of bytes from byte 16 to the byte of the checksum, which is not
included.
Byte Description
0 Module Code
Code Description
Code Description
8 FW ID
9 ACK/NACK
Byte Description
1 Length of module - 19
3 HDOP
7 Longitude
10
11 Latitude
12
13
14
15 Altitude
16
17
18
21
.2.3.21 until 2
Refer to Sections 2 .2.3.26 for more details about fields’ data formats.
Byte Description
1 Length of module - 7
2.7.8 Firmware ID
Byte Description
0 Module 8 - FW ID
1 Length of module - 6
6-15 - Reserved
7 HW ID (example: 20)
8 Spare
2.7.9 ACK/NACK
Byte Description
0 Module 9 – ACK/NACK
1 Length of module – 3
3 0 - ACK
1 - NACK
Upgrade Process
5 Spare
Byte Description
3 Numerator
Byte Description
3 Numerator
5 Number of Instances
6 Memory type – 0
0 – Bit
1 – Byte
2 – Word (16 bits)
3 – Double Word (32 bits)
(Only Byte entry unit type is currently supported)
10
11
12 Number of Entries
13
… Data Payload
… … Instance 2
… …
… …
Byte Description
1 Length of module – 21
3 Spare
4 Spare
5
Authenticated Features Matrix Byte 0
6
Authenticated Features Matrix Byte 1
7
Authenticated Features Matrix Byte 2
20 Spare
21 Spare
22 Spare
23 Spare
Byte Description
3 Spare
4 Spare
5 Spare
7 Spare
8 Spare
… Modem Version After Upgrade Attempt (ASCII String, 1st byte is length)
Generic Command (Message Type 0) – some commands are sent using this legacy
message. This message is always replied with a legacy status/location message from
the target unit (if the command is received successfully).
Forward Data Command (Message Type 5) – this message allows the sending of
data to the terminal attached to the unit.
Self Re-flash Chunks (Message Type 10) – this message forwards firmware file
data chunks for the self-re-flash process of the unit. The Self re-flash process
description is outside of the scope of the current document.
Modular Message Request (Message Type 11) – this modular message type
implements an extended modular protocol, intended to replace older message types
(0, 1, and 9). It is used to request the unit to send many types of data in a modular
message packet, like CAN bus applications, CelloTrack Nano, etc.
Byte Description
6 Unit ID
10 Command Numerator
11 Authentication Code
12
13
14
15 Command Code
22
23
24
3.2.3.3 Unit ID
This field contains the unique unit ID of the target unit. The unit ignores all received
commands that do not contain the appropriate unit ID number.
If the code is not verified as authentic – the unit will not perform/acknowledge the
command.
The feature should be switched on in the unit configuration (refer to Programming Manual
for more details).The feature is switched off by default.
The 4 bytes authentication code is generated as a function of two variables:
Unit ID
8 bytes Authentication Table, stored in the NVM of the unit and concurrently in the
Communication Center application (refer to Modular Message Definition for
modification instructions to this table).
The OTA Authentication table modification will be only accepted by the unit if the
Command Authentication feature is DISABLED.
The following are default values of the Authentication table:
Index 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
Value 2 15 7 9 12 1 4 6 8 3 11 14 0 5 10 13
Command Description
Code (Hex)
Command Description
Code (Hex)
according to the command configuration.
The command is sent with two parameters, the interval between each
emergency transmission and how many transmissions to send to the
operator.
If the number of transmissions chosen is 0, the unit sends the emergency
transmission constantly.
If the time between transmissions is set to 0, the unit sends the
emergency transmission according to the pre-programmed definition of
the Distress Mode in the NVM.
The emergency command is meant to emulate the action of a driver
pressing on the emergency button. It uses the same mechanism. If an
emergency command is sent and the driver simultaneously presses on the
emergency button, the emergency function that the driver initiated stops
the command sent by the operator and starts its own emergency session.
Here is an example of the emergency command sent to a unit:
Number of distress transmissions = 2
Time between distress transmissions Events = 5sec
4D 43 47 50 00 4B 01 00 00 1C 6E DF DD DD 02 02 01 01 00 00 02 05 00
00 7C
0x02: Reset
The following fields will be reset: The "Garmin Enabled", “Garmin
Connected" and GSM hibernation indication bit flags, Message numerator,
Unit’s status, Current GSM operator report, Unit’s mode of operation, I/O,
Analog inputs, Driver ID /PSP Specific Data/Accelerometer Status, Last
GPS Fix, Number of satellites, Longitude, Latitude, Altitude, Speed,
Course, System time, System date.
The modem will be re-initialized, the GPRS connection restored.
The RAM buffer used for data forwarding will be reset.
Configuration parameters will be reloaded from Configuration memory.
Command Description
Code (Hex)
04h / 14h: Blinkers (off / on)
05h / 15h: Standard immobilizer 1 (off / on)
06h / 16h: Speaker phone voltage (off / on), in 370-x0 only
07h / 17h: Internal lights (off / on), in 370-x0 only
08h / 18h: LED (off / on), in 370-x0 only
09h / 19h: General Output (off / on), in 370-x0 only
0Ah / 1Ah: Windows (off / on), in 370-x0 only
0Bh / 1Bh: Stop Light (off / on), in 370-x0 only
0Ch / 1Ch: Buzzer (off / on), in 370-x0 only
0Eh: Lock (performs pulse), in 370-x0 and Olympic modifications only
0Fh: Unlock (performs pulse), ), in 370-x0 and Olympic modifications only
Data field 2 and 2 bytes of Command Specific Data field:
Contain time of the output activation with one second resolution. Value of
0 cause permanent output change.
Example: Activate Siren for 5 minutes (300 seconds).
MCGP 00 ID ID ID ID 00 00 00 00 00 03 03 10 10 2C 2C 01 01 00 00 CS
Nested output activation: If the MSBit of the 3rd byte of command specific
data field is set, the command will be executed only after the vehicle
stops, e.g. after Ignition off or after 10 (by default) valid GPS packets
showing speed lower than 1 km/h).
Example:
Activate Siren Nested for 5 minutes (300 seconds).
MCGP 00 ID ID ID ID 00 00 00 00 00 03 03 10 10 2C 2C 01 01 80 00 CS
0x04 Disable Active Transmissions. This command will control the corresponding
bit in the unit's configuration (address 6, bit 1) and immediately stop or
restore active transmissions generated by the end unit. The existing GPRS
session will be disconnected upon "disable command" or restored upon
"Enable command".
Data field:
0 – Disable active transmissions
1 – Enable active transmissions
Command Specific Data field: don't care
Command Description
Code (Hex)
Command Description
Code (Hex)
2 – Maintenance Server
Data field 2:
In case of GP Frequency contains percent of maximum engine load (i.e
10 for 10%)
In case of speed – required distance in hundred's meters
(recommended value 5km).
Command Specific Data field: don't care
0x15 Control of transparent mode over COM (independent from control by Door
input (pin 14)).
Data field 1 contains action code: 0 - deactivate, 1- activate
Data field 2 contains activation time (in seconds); 1 to 255 seconds, 0 -
permanent activation
If activation by Door input (pin 14) is enabled: The OTA command
overwrites input setting.
---------------------------------------------------------------------------------------------
NOTE: For configuration spaces larger than 4K (Typically in Cello-IQ and Cello-CANiQ
units) it is mandatory to use Type 11 programming command (modules 10, 11).
---------------------------------------------------------------------------------------------
Byte Description
6 Unit ID
10 Command Numerator
11 Authentication Code
12
13
14
15 Block Code
15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0
17 Byte 17 Byte 16
3.3.3.3 Unit ID
.3.3.33.2.3.3
Refer to section 3
Spare – 2 bytes
Byte Description
6 Unit ID
10 Command Numerator
11 Authentication Code
12
13
14
21 Compressed Date
22 Day Month Year (-2000)
15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0
Byte 22 Byte 21
23 Compressed Time
24 Spare (sent as 128) Seconds Minutes Hours
23 22 21 20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0
25
Byte 25 Byte 24 Byte 23
26
Spare
27
3.4.3.3 Unit ID
Refer to section 3.2.3.3
Data length – 1 byte + 2 bits of Settings Byte (the 2 bits extension is applicable only
for transparent mode)
Data to Forward – variable length (up to 255 bytes (in regular forwarding mode) or up
to 518 bytes (in transparent mode))
Byte Description
6 Unit ID
10 Command Numerator
11 Authentication Code
12
13
14
15 Settings Byte
5 – COM5 1 – To
Garmin
6 – CFE Micro
7 – N/A
16 Data Length
17 Data to Forward
3.5.3.3 Unit ID
.3.3.33.2.3.3
Refer to section 3
……
Byte Description
10 Command Numerator
11 Authentication Code
12
13
14
… …
Last Error Detection Code (8-bit additive checksum, excluding system code)
Byte
3.6.3.3 Unit ID
.2.3.3
Refer to Section 3
Direction
0 – Data from the unit
1 – Request (unit-bound)
Out of Space Indication
0 – All the requested data is present in the message.
1 – Some Sub-data was not returned due to data size.
3.6.3.7 Length
That field includes the number of data bytes of the modules (with their types and
lengths). It is the number of bytes from byte 17 to the byte of the checksum, which is not
included.
Code Function
(Hex)
Byte Description
Byte Description
1 Length – 0
Byte Description
1 Length – 0
Byte Description
1 Length – 9
Byte Description
Control Byte
4 Spare
10
---------------------------------------------------------------------------------------------
NOTE: If both Action bits are zero (request command) the Counter 1/2 Value fields are
sent as zeros.
---------------------------------------------------------------------------------------------
Unit’s ID
8 bytes Authentication Table, stored in the NVM of the unit and concurrently in the
Communication Center application
---------------------------------------------------------------------------------------------
NOTE: The OTA Authentication table modification will be accepted by the unit only if the
Command Authentication feature is DISABLED in the unit's programming.
---------------------------------------------------------------------------------------------
The default values of the Authentication Table (8 bytes, 16 nibbles) are as follows:
Index 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
Value 2 15 7 9 12 1 4 6 8 3 11 14 0 5 10 13
Byte Description
1 Length – 10
Action Byte
Spare Read/Write
0 - Read Authentication
2 table from NVM
1 – Write Authentication
table to NVM
3 Spare
Byte Description
---------------------------------------------------------------------------------------------
NOTE: Reset is required in order to apply OTA Authentication table modification.
---------------------------------------------------------------------------------------------
Byte Description
1 Length – 2
3 Spare
Byte Description
1 Length – 6
Bit 0
Bit 0
Firmware ID Change Date/Time
number
Accelerometer identifier Current Firmware name
Bit 1
Bit 1
Bit 1
Hardware (string)
ID number
Size of Program memory Modem type System ID (STM
Bit 2
Bit 2
Bit 2
ID in case of STM
controller)
Communication Protocol
Bit 3
Bit 3
memory used by application firmware
Cellocator Wireless
(e.g. configuration)
Size of internal RAM Bit 4 GPS Type DFD/SD card
Bit 4
Bit 4
version
Size of external non-volatile GPS Cello-CANiQ
Bit 5
Bit 5
Bit 5
memory firmware VIN (Vehicle ID)
Amount of ext. non-volatile First IMSI/IMEI/MEID
Bit 6
Bit 6
Bit 6
memory used by application Activation
Bit Map 1
Bit Map 2
Bit Map 3
Size of external RAM FW Upgrade Originating FW ID
Bit 7
Bit 7
Bit 7
Date/Time
Byte
5
Cellocator Wireless
Communication Protocol
Byte Description
Configuration
Maintenance
Version
Firmware Sub
Modem
Function
Selected
PIN#8 HW
SIM ICCID
Identification
BT Extender
memory request
non-volatile
Size of internal
Information
Version
Nano sensors
Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0
Bit Map 4
Reserved
Reserved
Reserved
Reserved
Identification
Module
CSR BT
Identification
Gauge
Battery Fuel
version
4632 receiver
Silicon Labs
number
BT version
6
Bit Map 5
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
7
Byte Description
1 Length – 2
2 Spare
3 Spare
Byte Description
1 Length – 2
2 Spare
3 Spare
spare – 4 bytes
Byte Description
6 Unit ID
10 Command Numerator
(When transmitting ACK/NACK packet, it carries the numerator of the
original message)
11 Authentication Code
12
13
14
18 Spare (sent as 0)
19
20
21
22 Modules
… …
… …
Last Error Detection Code (8-bit additive checksum, excluding system code)
Byte
3.7.3.3 Unit ID
.2.3.3
Refer to Section 3
Direction
0 – Data from the unit
1 – Request (unit-bound)
Out of Space Indication
0 – All the requested data is present in the message.
1 – Some Sub-data was not returned due to data size.
3.7.3.7 Length
That field includes the number of data bytes of the modules (with their codes and
lengths). It is the number of bytes from byte 18 to the byte of the checksum, which is not
included.
Byte Description
0 Module Code
Code Description
32 General Command
3.7.6 ACK/NACK
Byte Description
0 Module 9 – ACK/NACK
1 Length of module – 3
3 0 - ACK
4 Spare
5 Spare
Byte Description
3 Numerator
5 Number of instances
6 Memory type – 0
10
11
12 Number of Entries
13
… Data payload
(according to the entry size and the number of
entries defined above)
… … Instance 2
… …
… …
Byte Description
3 Numerator
5 Number of instances
6 Memory type – 0
1 – Byte
2 – Word (16 bits)
3 – Double Word (32 bits)
(Only Byte entry unit type is currently supported)
10
11
12 Number of Entries
13
… … Instance 2
… …
… …
Byte Description
3 Control Byte
4 Spare
7 C[1]
8 C[2]
9 C[3]
10 Spare
11 Spare
12 Spare
13 Spare
14 Spare
15 Spare
17 C[1]
18 C[2]
19 C[3]
20 Spare
21 Spare
22 Spare
23 Spare
24 Spare
25 Spare
… …
C[1]
C[2]
C[3]
Spare
Spare
Spare
Spare
Spare
Spare
Byte Description
3 Control Byte
4 Spare
5 Spare
11
12 Spare
13 Spare
14-43 FTP Server Username (ASCII String, length 30, zero padded)
44-73 FTP Server Password (ASCII String, length 30, zero padded)
74 Spare
75 Spare
146 Spare
147 Spare
148-197 Full File Name (ASCII String, length 50, zero padded)
Byte Description
… …
Byte Description
… …