Cellocator Programmer Manual
Cellocator Programmer Manual
Programmer Manual
Cellocator Programmer
Manual
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.
Page 2 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
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 2016. All rights reserved.
Page 3 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Table of Contents
1
Introduction .............................................................................................................. 7
1.1
1.2
Abbreviations .............................................................................................................. 7
1.3
3.1
3.1.1
3.1.2
3.1.3
3.1.4
3.1.5
3.2
4.1
4.2
4.3.1
4.3.2
4.3.3
4.3.4
Cello-IQ 30 PL ............................................................................................................23
Cello-CANiQ PL ...........................................................................................................24
CR300 PL ...................................................................................................................25
CelloTrack PL ..............................................................................................................25
5.1
5.2
5.3
5.4
6.1
Maintenance ...............................................................................................................30
6.1.1
6.1.2
6.1.3
6.1.4
6.1.5
6.1.6
6.1.7
Page 4 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
6.1.8
6.1.9
6.1.10
6.1.11
6.1.12
6.2
PL Editing ...................................................................................................................41
6.2.1
6.2.2
6.2.3
6.2.4
6.3
PL Management ..........................................................................................................43
7.1
Overview ...................................................................................................................44
7.2
7.2.1
7.2.2
7.2.3
7.2.4
7.2.5
7.2.6
7.3
7.3.1
7.3.2
7.3.3
7.3.4
7.3.5
7.3.6
7.3.7
7.3.8
7.4
7.4.1
7.4.2
7.4.3
7.4.4
7.4.5
7.4.6
7.4.7
8.1
Overview ...................................................................................................................67
Page 5 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Viewing a real-time overview of the Nano and any paired MultiSense devices .....................71
8.4
8.5
8.6
Page 6 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Introduction
1.1
1.2
Abbreviations
Abbreviation
Description
Cello-IQ
CC
Communication Center
CSA
CM
CSA Manager
CAN
CCC
DB
Database
FMS
OTA
Page 7 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
1.3
Abbreviation
Description
PGN
RMS
RSSI
SMS
Revision History
Version
Date
Description
1.0
May 30 2014
1.1
1.2
February 8, 2015
1.3
May 3, 2015
1.4
1.5
July 6, 2015
1.6
November 9, 2015
1.7
1.8
Page 8 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Page 9 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
3.1
Menu bar
Toolbar
Address bar
PL pane
Main pane
Page 10 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Description
File
Edit
Search
View
Communication
Provides access to the features that are also included on the main
toolbar. Refer to the Toolbar section for further information.
Page 11 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Menu Name
Description
CAN
Enables you to work with the CAN filter editor (for Compact CAN
this is an archived product, for further information please
contact Customer Support).
Help
and
Page 12 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Page 13 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
3.1.2 Toolbar
From the Programmer toolbar you can perform a variety of actions, as described in the
following table. For further explanations of the various toolbar options, refer to the
Cellocator Programmer Functionality section on page 30.
Icon
Description
Create a new PL file (this is normally used only by Cellocator personnel, as
the user usually loads pre-configured PL files).
Browse to open an existing PL file on your computer.
Save the current PL file.
Includes the configuration values in the parameter library: this is the
default configuration meaning all names, details and values of the
parameters are saved. By default, the icon button is pressed.
If you click the button to deactivate this feature, only parameter definitions
(such as caption, address, units, and hints) are saved to the library, without
values.
Sends a basic query to the unit. The unit replies with the unit's ID, firmware
and hardware type and modem type of the connected unit. Refer to the
Querying the Cellocator Unit section on page 31 for further information.
Enables you to upload values currently programmed in the units
configuration memory. After the upload the values are monitored by
relevant parameters.
Enables you to download modified parameters and save their values to the
units configuration memory. Refer to the Modifying Parameters in the
Cellocator Programmer section on page 26 for further information.
Note that after downloading a modified PL file, the unit must be reset by
power disconnection or by serial/OTA reset.
Enables you to download the modified parameters values to the unit's
memory, but also includes verification of the programmed data.
Provides debug information regarding the connection status of the unit.
Refer to the Master Unit Status Request section on page 32 for further
information.
Enables you to test the unit's inputs and outputs. Refer to the Testing a
Unit's Inputs and Outputs section on page 32 for further information.
Enables you to set up a bidirectional communication link between the unit
serial port and the cellular network, thus allowing communication from the
Mobile Data Terminal, connected to the unit serial port, to the back office
application. Refer to the Forwarding Data to wireless channel section on
page 34 for further information.
Page 14 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Icon
Description
Allows the activating of voice features (e.g. initiate call, received call, reject
call, etc.) for testing and integrating voice devices such as the Handsfree
module. Refer to the Voice Call Management section on page 36 for further
information.
Manufacturing Info Request - to be used by Customer Support. Refer to the
Manufacturing Info Request section on page 37 for further information.
Learn vehicle locking/unlocking sequences. This function is relevant to the
Cello-R unit only (this is an archived product, for further information please
contact Customer Support).
Allows the sending of AT commands to the units cellular modem, mainly for
debug purposes. Refer to the Forwarding AT Command section on page 37
for further information.
Platform Manifest. Provides maintenance information about the units
hardware and software. Refer to the Platform Manifest section on page 38.
Enables the configuration of a list of prioritized operators for roaming
purposes. Refer to the Configuring Roaming Settings section on page 41 for
further information.
Enables you to define the frequency of time events by linearly adjusting
according to the speed of the vehicle. Refer to the Configuring VTrek
Settings section on page 42 for further information.
Enables you to test the usage counters. Up to two inputs can be defined.
Refer to the Configuring Counters Inputs Settings section on page 38 for
further information.
Enables you to define the authentication parameter. Refer to the
Authentication Table section on page 42 for further information.
Compact CAN Filters parameters editor - relevant only for Compact CAN
units (this is an archived product, for further information please contact
Customer Support).
Opens the CAN Editor (for Cello-CANiQ units). Refer to the Working with the
CAN Editor section on page 44 for further information.
Enables you to reset the unit. The actual reset is initiated 5 seconds after
receipt of the reset command.
Opens the Nano Editor (for CelloTrack Nano and MultiSense devices). Refer
to the Working with the Nano Editor section on page 67 for further
information.
Opens the Geo-fence Editor: currently not implemented.
For use by Cellocator personnel only.
Enables you to activate shipment mode in the unit (available for the Cello
and CR300 variants with battery only).
Page 15 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Icon
Description
Displays the Cello Platform Manifest, which provides more detailed
hardware and software maintenance information than the standard Platform
Manifest (see above).
Assists in browsing between PL folders (click to go back to the previous
folder view).
Assists in browsing between PL folders (click to go forward to the next
folder view in the browsing sequence). For example, if you clicked back a
few steps you can click this button to return to your current folder view.
Assists in browsing between PL folders (click to go up one level).
Displays the default view of PL folders and parameters. Refer to the
Modifying your Programmer View section on page 12 for further
information.
Displays a memory map. The memory map enables you to view the real
allocation of configuration memory values, without any translation. Refer to
the Modifying your Programmer View section on page 12 for further
information.
Provides access to the configuration of communications and memory
parameters. Note that only the Communication tab should be used; other
tabs are for use by Cellocator personnel only. Refer to the Configuring
Communications and Memory Parameters section on page 26 for further
information.
Enables you to open/close the Com Port.
The communication port is open.
The communication port is closed.
Page 16 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
3.1.4 PL Pane
The PL pane lists the various sections of the PL file, as shown in the example below.
The PL pane also provides an additional method of searching for parameters. By drilling
down to the relevant section, you can find the relevant parameters (which are displayed
in the Main pane) for a specific section simply by clicking on the section.
Page 17 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
3.2
Page 18 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
4. In order to be able to communicate with the unit, from the Communication menu,
select Configuration. The following screen is displayed.
5. In the Communication Port field select the port number used for communication
with the unit (4 in the example above).
6. The Baud Rate should be set to 115000.
7. Click OK.
In order to be able to change the parameters in the unit memory and to select the
appropriate PL for the unit you should query the Cellocator unit information.
Page 19 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
The programmer saves the Unit Number for future communication with the unit.
-----------------------------------------------------------------------------------------------NOTE: You can also use OTA (through Parsing Message Type 0 and also via the Cellocator
Communication Center) to locate Cellocator unit information. These methods are
described in the Cellocator Programming Manual.
------------------------------------------------------------------------------------------------
Page 20 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
4.1
4.2
Page 21 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Please note that the above links require access to the Cellocator Knowledge Base section
on the website.
When downloading, save the default PL file in the relevant location on your computer;
when required, it can be loaded in the Programmer.
Page 22 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
4.3
4.3.1 Cello-IQ 30 PL
The Cello-IQ 30 PL contains all the parameters required for the Fleet Management
application. These parameters are arranged in groups which are shown in the PL pane.
Page 23 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
4.3.2 Cello-CANiQ PL
Page 24 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
4.3.3 CR300 PL
The CR300 PL includes subset of the Fleet Management parameters available for the
Cello-IQ 30. Unavailable parameters are removed or grayed.
4.3.4 CelloTrack PL
The CelloTrack PL includes all appropriate Fleet Management parameters similar to the
Cello-IQ. CelloTrack parameters and its unique capabilities can be updated in the 08
CelloTrack section.
Cellocator Programmer Manual
Page 25 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
5.1
From the menu bar, select Search > by Parameter Name to display the following:
Note that you can only enter part of the parameter's name.
You can find a list of all parameters and their descriptions in the Cellocator Programming
Manual.
Cellocator Programmer Manual
Page 26 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Once you have located the relevant parameter, you can then proceed to modify it, as
described in the following section.
Another alternative is to use the Find feature. From the menu bar, select Search > Find
(also available via the keyboard shortcut of Ctrl+F, as in standard Microsoft Office
applications), to display the Find Parameters window shown below.
In this window you can search for both addresses and parameter names simultaneously.
You can also search for specific values in the enumeration fields and comments by
entering the relevant search criteria, selecting the relevant checkbox, and then clicking
Find.
Once you have a number of search results displayed, clicking Search > Find Next (F3)
jumps directly to the next found entry in the list of results.
5.2
There are parameters that can be defined with one of two values, usually selected
from a dropdown list, as shown in the example below (Disable/Enable).
Page 27 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
There are other parameters that can be defined with a specific value, such as a
decimal value, as shown in the example below.
-----------------------------------------------------------------------------------------------NOTE: Before modifying a parameter you should always verify via the Cellocator
Programming Manual the specific values available for a parameter.
-----------------------------------------------------------------------------------------------You can also view an information tooltip for each parameter by hovering over the
parameter, as shown below.
5.3
Page 28 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
5.4
The Protected Blocks area lists several memory ranges provided by Cellocator. They
should not be modified.
You can add additional memory ranges according to the example provided in the screen
above.
Please note that for proper operation of the Cellocator+ application, the protected
memory blocks ranges should be arranged in memory-range ascending order.
Page 29 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
6.1
Maintenance
This section includes the following:
Querying the unit, page 31
Master unit status request, page 32
Testing a unit's inputs and outputs, page 32
Forwarding data to wireless channel, page 34
Page 30 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Page 31 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
to provide identification.
The Testing window contains three tabs: General, Inputs and Outputs.
Page 32 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Page 33 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Page 34 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
The green arrow in the lower right corner expands the window to display the Received
Message pane.
Page 35 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Page 36 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Page 37 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Page 38 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Page 39 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
6.1.12.1
Communication Tab
This tab enables you to set a variety of communication settings, including the port and
baud rate, according to the unit type.
Page 40 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
6.2
PL Editing
This section includes the following:
Configuring roaming settings, see below
Configuring VTrek settings, page 42
Authentication table, page 42
Navigation options: go up a level, back/forward (see the Toolbar section for further
information)
Display parameters page or memory map (see the Toolbar section for further
information)
Dallas Key Code programming, page 42
For information about the CAN Editor, see the Working with the CAN Editor section on
page 44. For information about the Nano Editor, refer to the Working with the Nano Editor
section on page 67.
Page 41 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
5. Scroll down the Units Status data, where the last detected Dallas number is listed.
6. Copy the number and close the Master Status window.
7. In the Security >Dallas folder, select the required Dallas code entry and double-click it.
Page 42 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
8. Paste the copied Dallas Code in the Enter Value field and click OK.
9. Repeat the steps above for the remaining Dallas buttons.
6.3
PL Management
This section includes the following:
Creating, opening and saving PL files (see the Toolbar section for further information)
Including configuration memory content in parameter library (see the Toolbar section
for further information)
Uploading parameters from unit (see the Toolbar section for further information)
Downloading parameters to unit (see the Toolbar section for further information)
Downloading and verifying parameters (see the Toolbar section for further
information)
Page 43 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
7.1
Overview
Using the CAN Editor, you can set up CAN configuration schemes using various CAN
parameters and operators that will create trigger criteria that enforce events via the unit.
There are two options to work with the CAN Editor:
Build the CAN configuration for a PL (complete with default rules and schema), as
described on page 48.
Build a vehicle library (meaning a library of the relevant parameters required for each
car model), as described on page 58.
7.2
2. In the displayed message box, click Yes to edit the CAN configuration file of the
programmed PL, otherwise click No.
The CAN Editor window is then displayed. See the following sections for a description
of the CAN Editor window components.
Page 44 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Menu bar
Toolbar
Tabs
Status bar
Description
File
Actions
Edit
Load/Save configuration
Print report
Exit
Read from PL
Write to PL
Verify logic
Clear configuration
Page 45 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Menu Option
Description
View
Help
Zoom to fit
7.2.4 Toolbar
The Toolbar options are either intuitive or explained in the table below.
Icon
Description
Read CAN configuration from PL
Write CAN configuration to PL
Undo
Redo
Print diagram view
Optimize diagram layout
Verify logic
7.2.5 Tabs
The CAN Editor window has three main tabs: the Diagram View tab, the Table View
tab, and the Vehicle Library tab.
The Diagram View tab allows you to define a CAN configuration scheme by building a CAN
configuration diagram using graphic tools. The CAN configuration scheme defines the
required CAN parameters, the logic operations activated on these parameters and the
event generated when the conditions are fulfilled. The Diagram View tab is described in
the Building the CAN Configuration for a PL section.
The Table View tab allows you to view and edit the characteristics of each instance of CAN
parameter, operator or event which are included in the CAN configuration diagram. The
Table View tab is described in more detail in the Building the CAN Configuration for a PL
section.
Page 46 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
The Vehicle Library tab allows the definition of non-standard (custom) CAN parameters
and their properties, and the functionality of CAN Bus characteristics. You can also
prepare a set of CAN parameters and to save them in a library file. The library files
generally describe the CAN parameters of certain vehicle models and years. The Vehicle
Library tab is described in more detail in the Building Vehicle Libraries section.
The Status bar, located at the bottom of the CAN Editor window, provides visual indication
of the following:
Current CAN Editor status, from one of Ready (before you create your configuration
diagram), Verified OK (indication that your diagram logic is valid), or
Warnings/Errors (see the warnings and errors in the panel just above the Status
bar, accessed by clicking the arrow icon on the far left of the status bar, as shown
below).
Memory usage; the value indicated (example: 60/1960) will change according to the
number of non-standard and J1939 parameters used, as well as Operators, as they all
have some memory volume. The standard parameters have no memory volume and
will not impact this value. Note that the memory bar to the left of this value provides a
visual "traffic light" indicator of the current memory usage.
The number of parameters currently in use, up to a maximum of 25.
The signature ID of the PL file.
The last performed action; a textual indicator of the last performed action, such as
Configuration cleared or Errors/warning found. The name of the relevant XML file is also
displayed in the line below the red text, for example when saving the configuration.
Page 47 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
7.3
Page 48 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Click Yes to reload the PL configuration data. If you have changed the CAN configuration
these changes will be overwritten. If you have just the CAN Editor open, you can click No.
From the File menu in the CAN Editor window, click Load Configuration to load the
appropriate configuration file in .XML format. Generally, you have to load a configuration
file with the same name as the PL file (which can be verified in the PL signature). The
parameters and operators relevant to that PL file are loaded and available for use in the
configuration diagram.
If starting a configuration from scratch, you can take an existing configuration file that is
similar to your requirements, load it (as described above) and modify as required. For
example, if you want to create a new configuration file for a Chevrolet 2011 model and
you have an existing, almost identical Chevrolet 2010 model, first load the 2010 model
configuration file.
Page 49 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
A warning message is displayed, informing you that the PL signature is no longer updated
and that you need to write the changes to the PL file. Click Yes if you want to update the
PL. The file is saved in XML format to your selected destination.
In addition, click
on the toolbar to write the CAN configuration diagram to a PL file
to update the PL with your changes. The memory map in the Cellocator Programmer (or
OTA Programmer) is updated according to the configuration in the CAN Editor; to update
the unit you should download the PL with the Cellocator Programmer (or OTA
Programmer) interface.
7.3.6 Building CAN Configuration Rules via the Diagram View Tab
7.3.6.1 Overview of the Diagram View Tab
The Diagram View tab is the visual composer that enables you to build a configuration
diagram from operators and parameters selected in the Components Set pane and Gallery
(see also the Component Set Pane and Gallery sections below).
A configuration diagram is a flow diagram consisting of filtering, triggering, and reporting
elements. Note that in each configuration diagram, which flows from left to right, there
must be at least one parameter (either OBDII or J1939, shown in the workspace in a light
blue square), one Operator (shown in the workspace with an orange square), and one
Generate Event Operator (shown in the workspace with a light green square).
For details on how to build a configuration diagram, refer to page 52.
Page 50 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Component
Set pane
Workspace
Gallery
Zoom tool
In the image above, the Standard OBDII component set is selected; the Gallery displays
all the relevant operators and two basic CAN rules are presented in the workspace.
Note that there are five types of parameters to choose from (select the relevant option
from the Component Set pane column to display the available parameters). See the
following Component Set Pane section.
7.3.6.3 Gallery
The Gallery lists the available parameters of the selected component set. For example, if
Standard OBDII was selected in the Component Set pane, the Gallery displays only the
Standard OBDII parameters.
Note that you can click the View Galleries arrow icon at the bottom of the Gallery to
toggle on / off the display of the Component Set pane.
7.3.6.4 Workspace
The workspace is where you build the CAN configuration diagram (subsequently it is only
displayed in the Diagram View tab).
Page 51 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Page 52 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
4. In the Component Set pane, click on Operators. The available Operators are
displayed in the Gallery.
5. Drag the required Operator from the list of available Operators and place it next to the
parameters you selected in Step 2 in the workspace.
You can use the same Operator more than once; in this case, the ID assigned to the
Operator will increase sequentially, depending on the number of times used.
6. (Optional) To edit an Operator's properties, click
in the lower right-corner of the
Operator. The Properties dialog for the specific Operator is displayed.
7. To connect a parameter with the Operator, click on the parameter box to display the
Connect output connector (on the right side of the parameter box, as shown below).
Click on the Connect output connector and drag the connector arrow to the input
connector of the Operator (which should automatically be displayed when dragging the
connector towards it).
8. From the list of displayed Operators, drag the Generate Event Operator to the
workspace. To edit the Generate Event properties to ensure its relevancy to your
diagram, click
in the lower right-corner of the Operator. The Properties dialog is
displayed via which you can edit the relevant properties.
9. To connect the Operator you selected in Step 6 with the Generate Event Operator,
click on the Operator box to display the Connect output connector (on the right side of
the Operator box). Click on the Connect output connector and drag the connector
arrow to the input connector of the Generate Event Operator (which should
automatically be displayed when dragging the connector towards it).
10. Repeat as required (you can use the same parameter more than once).
-----------------------------------------------------------------------------------------------TIP: To zoom in on the diagram you have built, click
to "zoom to fit" or
to
automatically optimize the diagram layout. See the CAN Editor Window Components
section for further information.
------------------------------------------------------------------------------------------------
Page 53 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
7.3.8 Modifying the CAN Configuration via the Table View Tab
As required, you can also edit and name the CAN configuration components in table
format via the Table View tab. This is an important part of the CAN configuration process,
because without defined names (which you cannot define in the Diagram View tab)
integrators will not be able to identify the parameters and activate the required logic.
The Table View tab provides a data format view of what is displayed in the Diagram View
tab, only displaying parameters and Operators that have been used in the Diagram View
tab. The tab is divided into three sub-tabs, in which you can see and edit the hexadecimal
values and raw data for Operators, Parameter Descriptors, and Standard Parameter IDs.
In addition, the Table View tab presents each instance of the parameters and operators
according to the number of times they are used in the configuration diagram.
The operators are used to filter the parameters reported by the CAN Bus, allowing the
generating of events only when all event conditions are fulfilled. The operator fields are
listed in the following table.
Field
Description
Editable
(click to
expand)
Yes
Name
Yes
Page 54 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Field
Description
Editable
Description
Yes
Type
No
ID
No
Sources
No
Raw Data
No
Address
No
Length
No
The Parameter Descriptors tab presents information regarding the Custom Parameters
defined in the Vehicle Library tab. The Parameter Descriptor fields are listed in the
following table. Note that if you modify values in this tab, the parameters will also be
modified in the vehicle library definition for that specific vehicle model. Therefore, it is
only recommended to modify the Name field; all other parameters should be modified in
the Vehicle Library tab only.
Field
Description
Editable
No
Name
Yes
Filter
Yes
Page 55 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Field
Description
Editable
Arbitration ID
Yes
Parameter ID
No
Response mode
(SID)
Yes
PID length
Yes
PID1
Yes
PID2
Yes
Start bit
Yes
Yes
Little Endean
Yes
Consider PGN
only
Yes
Raw Data
No
Address
No
Multiplier
Yes
Divider
Yes
Coefficient
Yes
Page 56 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Field
Description
Editable
Offset
Yes
Units
Yes
Decimal Places
Yes
The Standard PIDs tab allows you to define the periodic polling time for each instance of
the built in OBDII standard parameters. This tab is not relevant for J1939 parameters.
The Standard PIDs fields are listed in the following table.
Field
Description
Editable
Parameter ID
No
Parameter Name
No
Polling Time
(Seconds)
Yes
Page 57 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
7.4
Page 58 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
3. Click OK and then browse for an existing vehicle library file in XML format (with a
*.VehicleLibrary suffix). The parameters and Operators relevant to that file are loaded
and available for use in the configuration diagram
Page 59 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
2. Click Add Filter or Add Parameter, and define the relevant fields for the new
filter/parameter (if modifying an existing parameter or filter, refer to the following
sections that describe each of the available parameters and filters).
For example, when adding a Filter, in the Filters tab click Add Filter and then define
the following:
Select the Enabled checkbox to ensure the Filter is enabled and available for
selection
Bits Selection Mask value (select from Exact match, Ignore last 2 bits of
filter, Ignore last 3 bits of filter, or Ignore last 4 bits of filter)
Arbitration IDs automatically displays the selected Arbitration IDs (you cannot
define it), according to the value you selected in the Bits Selection Mask column.
3. From the File menu, select Save Configuration to save the modified CAN
configuration diagram; for vehicle libraries select Save Vehicle Library from the File
menu. Note that when you modify a vehicle library file it should be saved with the
relevant name.
The CAN Bus Settings tab allows you to define the following CAN Bus characteristics:
CAN Operational Modes: Select from Disable CAN, RX Only Mode, Full RX & TX
mode, or RX & TX mode w/o std OBD queries.
CAN Bus Format: Select from 11 Bits, 29 Bits, or Auto Detection.
CAN Bus Rate: Select from the relevant rate available, or select Auto Rate Detect.
DTC Process Control: Select the checkbox to enable DTC process control.
Page 60 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
The Filters tab allows you to view and define the properties of the filters required for the
definition of J1939 or OBDII parameters. The filter is required to isolate the bits of the
required parameter from the information received from the CAN bus. The Filter fields are
described in the following table.
Field
Description
Editable
Title
Yes
Enabled
Yes
Arbitration ID
Yes
Bits Selection
Mask ID
Yes
FilterSize
Yes
FrameFormat
Yes
Arbitration
IDs
No
Page 61 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
A
B
The J1939 Parameters tab allows you to view and define the properties of the custom
J1939 parameters. The Parameter fields are listed in the following table.
Note that in this tab an additional table of rows for each of the 8 bytes of the CAN frame
is displayed at the bottom of the tab. The top row indicates what the CAN Editor and
Cellocator products use for the CAN BUS frame presentation (shown in line A in the above
image), while the second row shows the CAN BUS frame presentation that complies with a
measuring device (Vehicle Spy) supporting the CAN Bus interface (shown in line B
above).
The relevant bits location of the required parameter are automatically highlighted in green
when you define the start bits and data length, as described in the following table and
shown in the image above.
Field
Description
Editable
Title
Yes
Filter
Yes
Arbitration ID
Yes
Page 62 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Field
Description
Editable
Parameter ID
No
Start bit
Yes
Start bit
Vehicle Spy
Yes
Data length
(bits)
Yes
Little Endean
Yes
Consider PGN
only
Yes
Function
Yes
Multiplier
Yes
Divider
Yes
Coefficient
Yes
Offset
Yes
Units
Yes
Decimal
Places
Yes
Page 63 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
The OBDII Parameters tab allows you to view and define the properties of the custom
OBDII parameters. The Parameter fields are listed in the table below.
Note that in this tab an additional table of rows describing the location of the parameter in
the CAN frame is displayed at the bottom of the tab, as described in the J1939
Parameters Tab section on page 62.
Field
Description
Editable
Title
Yes
Filter
Yes
Arbitration ID
Yes
Parameter ID
No
Response
mode (SID)
Yes
PID length
Yes
PID1
Yes
PID2
Yes
Start bit
Yes
Start bit
Vehicle Spy
Yes
Data length
(bits)
Yes
Page 64 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Field
Description
Editable
Little Endean
Yes
Consider PGN
only
Yes
Function
Yes
Multiplier
Yes
Divider
Yes
Coefficient
Yes
Offset
Yes
Units
Yes
Decimal
Places
Yes
The Custom Queries tab allows you to view and define OBDII queries which are not
included in the set of OBDII queries built into the unit.
The query fields are listed in the table below.
Page 65 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Field
Description
Editable
Active
Yes
Title
Yes
Header
Format
Yes
DLC
Yes
Polling Time
Yes
Query
Response
Timeout
Yes
Arbitration ID
Yes
Number of
additional
data bytes
Yes
Mode
Yes
PID1
Yes
PID2
Yes
Query Data
Yes
Page 66 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
8.1
Overview
Using the Nano Editor, you can monitor the status of Nano and MultiSense devices in realtime (and also see statuses in a simulated environment), as well as configure each
individual device so that it works at its optimum for the environment in which it is located.
In order to make things easier in regards to defining the initial PL for use with the Nano
and MultiSense devices, use the pre-defined template to help you set the configuration of
parameters for the first time. When working with the Nano Editor, as described in the
following sections, you can select this template from the toolbar or menu bar.
Page 67 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Upload parameters
or
Sensors configuration tab
2
4
Write to PL
Download parameters
File open
File save
6
Dashboard
direct link
1. Clicking the Upload Parameters button (labeled above as 1) reads the configuration
file from the hardware unit to the main application.
2. Either of the Download Parameters buttons (2) can transfer the configuration file from
the main application to the unit.
3. When the Nano Editor is launched (3), the data from the main application to the Nano
Editor application is transmitted automatically.
4. Once the Nano Editor application is open, it will not transfer the parameters
automatically back and forth to the main application. This has to be done manually
when needed by pressing either the Read from PL (3) or Write to PL (4) buttons.
5. At any time, the configuration file from the main application only can be saved to a file
or read from a file using the relevant buttons (5).
6. Only when actively watching the Dashboard or Sensors status tabs (when set as the
foreground window on your PC), the application opens a direct live link (6) with the
hardware and displays real-time status information coming from the unit.
7. You can disable the active link or change its pace from the Communication menu (as
shown below). In order to change the pace, the link should first be disabled, and once
modified, re-enabled.
Page 68 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
8.2
Menu bar
Toolbar
Tabs
Status bar
Description
File
Actions
Exit
Page 69 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Menu Option
Description
Communication
Help
8.2.2 Toolbar
The Toolbar options are explained in the Menu Bar table in the previous section.
Icon
Description
Read from PL (see explanation in the
Menu Bar section)
Write to PL (see explanation in the
Menu Bar section)
Template selection (see explanation in
the Menu Bar section)
8.2.3 Tabs
The Nano Editor window has four main tabs: the Dashboard tab, the Sensors status
tab, the Sensors Configuration tab, and the Legacy events type-11 configuration
tab.
The Dashboard tab provides you with a real-time overview of the entire system when the
Nano is connected to the Cellocator Programmer. The Dashboard tab is described on page 71.
The Sensors status tab provides you with a real-time view of the status of the CelloTrack
Nano unit and any of the paired 16 MultiSense devices, when the Nano is connected to
the Cellocator Programmer. When the Nano Editor is not connected, you can modify the
fields to adjust the dashboard indicators (especially useful for simulation purposes). The
Sensors status tab is described on page 71.
The Sensors Configuration tab enables you to adjust the settings of the Nano unit and up
to 16 paired MultiSense devices. The Sensors Configuration tab is described on page 73.
The Legacy events type-11 configuration tab allows the definition of legacy events as type
11 or not. The Legacy events type-11 configuration tab is described on page 76.
Page 70 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
The Status bar, located at the bottom of the Nano Editor window, provides visual
indication of the following:
Communication status: green means there is a connection between the unit and the
Nano Editor, red means there is no current connection.
Last operation activated.
8.3
Page 71 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
8.4
2. Click on the relevant row to see the dashboard indicators (located at the bottom of the
Nano Editor window) for a specific device.
The following dashboard indicators are available:
Temperature (in C)
Magnetic Sensor (OPEN means the MultiSense does not currently recognize the
magnetic sensor alongside it (indicating the door or entry point is open), CLOSED
means the MultiSense device recognizes the magnetic sensor (indicating the door
or entry point is closed))
Page 72 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
The new label will be associated with the MAC address and saved locally on your
computer.
It will be retrieved from the local file whenever this MAC is displayed again.
-----------------------------------------------------------------------------------------------NOTE: For simulation purposes (when not connected), you can adjust any of the fields to
modify the dashboard indicators. For example, adjust the Acc X, Acc Y, and Acc Z fields to
tilt the orientation view of the MultiSense device.
------------------------------------------------------------------------------------------------
8.5
2. Click on the CelloTrack Nano row (the top row) to select it. On the right of the Nano
Editor window a Properties section is displayed.
3. Configure the following:
Temperature thresholds: Define the working temperature range for the Nano
unit by adjusting the values in the left and right boxes using the arrow buttons
alongside each box, or drag the slider bar accordingly to adjust the range.
Page 73 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
Package open/closed light threshold: Drag the slider or click on the arrows to
define the open/close light threshold. Note that you can click Typical closed box
to use the recommended default values.
-----------------------------------------------------------------------------------------------NOTE: You can also manually adjust the values for the above thresholds in the main
table of displayed values (except for the MAC address fields); simply click in the
relevant field and enter/define the required value.
-----------------------------------------------------------------------------------------------4. Click Apply to implement your settings.
Page 74 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
-----------------------------------------------------------------------------------------------NOTE: You can select multiple MultiSense lines and apply any changes to all of them
(using the Shift / Ctrl keys). However, you cannot select both the CelloTrack Nano and
MultiSense as they have different configurable parameters.
-----------------------------------------------------------------------------------------------3. Configure the following:
MultiSense Type:
Enable sensors: Select the relevant checkboxes for the sensors you want to
enable (by default the Temperature sensor is enabled and thus greyed out).
Note that if you do not need all sensors enabled, disable those that you do not
need to preserve the energy of the MultiSense battery.
Package open/closed light threshold: Drag the slider or click on the arrows to
define the open/close light threshold. Note that you can click Typical closed box
to use the recommended default values.
-----------------------------------------------------------------------------------------------NOTE: You can also manually adjust the values for the above thresholds in the main
table of displayed values (except for the MAC address fields); simply click in the
relevant field and enter/define the required value.
-----------------------------------------------------------------------------------------------4. Click on the Description label if you want to edit it.
The new label will be associated with the MAC address and saved locally on your
computer.
It will be retrieved from the local file whenever this MAC is displayed again.
Page 75 of 76
Copyright 2016 by Pointer Telocation, Ltd.
Cellocator Programmer
Manual
8.6
2. Click on a row to select it, and in the Type column, click on the current value (by
default, Disable). In the displayed dropdown box, select from one of the following:
Note that you can select multiple rows for modification using the standard Windows
Ctrl or Shift buttons on your keyboard.
3. Repeat as required.
-----------------------------------------------------------------------------------------------NOTE: The Base Address and Bit Offset columns indicate the location of the specific
bit in the memory.
------------------------------------------------------------------------------------------------
Page 76 of 76
Copyright 2016 by Pointer Telocation, Ltd.