Detroit Diesel Auto Cal Tool Manual 2

AutoCal
Copyright ©
AutoCal
Table of contents
2-D Graph Control Chart Recorder properties ....................................................... 5

2-D Graph Control Graph properties .................................................................... 5
2-D Graph Control properties .............................................................................. 6
Accessing data ................................................................................................... 6
Adding a fixed amount to the values of a selection of cells ...................................... 8
Analog Meter Control properties .......................................................................... 8
Navigator pop-up menus .................................................................................... 9
AutoCal Workspaces ......................................................................................... 12
Bar Control properties ....................................................................................... 13
Button Control properties .................................................................................. 13
...................................................................................................................... 14
...................................................................................................................... 14
panels ............................................................................................................. 14
Carrying out a search ........................................................................................ 15
Changing the orientation of a table ..................................................................... 15
Channelset user-defined groups ......................................................................... 17
Channelsets - monitoring variables in the ECU ..................................................... 19
Choosing what to display in a table with three dimensions .................................... 19
Colors ............................................................................................................. 20
Transferring data between AutoCal and the ECU .................................................. 21
Contents ......................................................................................................... 21
Controls Toolbar .............................................................................................. 24
...................................................................................................................... 25
Copying data - Mix and Match ............................................................................ 25
Copying the value of a watched variable to a Dataset ............................................ 27
Copying the values of cells from one part of a table to another .............................. 28
Creating and working with AutoCal data controls ................................................. 28
Creating, saving and opening panels in AutoCal ................................................... 28
Deleting, copying and pasting controls ................................................................ 29
Documenting a Dataset ..................................................................................... 30
Edit ................................................................................................................ 32
Edit Control properties ...................................................................................... 33
Editing a single data value ................................................................................. 33
Editing data using a Parameter Viewer Control .................................................... 34
Editing data using the 2-D Graph Control ............................................................ 35
Editing data with the button control .................................................................... 36
Editing table data ............................................................................................. 36
Editing the data using a Slider Control ................................................................ 37
File ................................................................................................................. 37
Fonts .............................................................................................................. 38
...................................................................................................................... 39
Glossary .......................................................................................................... 39
Help ............................................................................................................... 40
Indicator Control properties ............................................................................... 40
Interpolating the values across a selection ........................................................... 41
Layout ............................................................................................................ 42
Alignment toolbox ............................................................................................ 42
2 / 107
AutoCal
...................................................................................................................... 43
Linking data to controls ..................................................................................... 43
Marking variables for watching ........................................................................... 43
...................................................................................................................... 45
Menus ............................................................................................................. 45
Menus and Toolbars summary .......................................................................... 45
Moving and resizing controls on a panel .............................................................. 45
Multiplying the values of a selection of cells by a fixed amount .............................. 46
Opening Channelsets ........................................................................................ 47
Opening a Dataset ............................................................................................ 48
Opening found Datasets .................................................................................... 49
Overview ......................................................................................................... 49
Parameter Viewer Control Properties .................................................................. 50
Periodic and state Watching ............................................................................... 51
Placing controls on an AutoCal panel .................................................................. 51
Reading a Dataset from the ECU ........................................................................ 53
Regrading a Dataset ......................................................................................... 53
Relinking controls to parameters in a different Dataset .......................................... 54
Removing a Channelset ..................................................................................... 55
Removing found Datasets from Search Results .................................................... 55
Saving a Channelset ......................................................................................... 55
Saving and removing Datasets ........................................................................... 56
Search Criteria dialogue box - Keywords page ..................................................... 58
Search Criteria dialogue box - Location page (disk searching only) ......................... 60
Search Criteria dialogue box - Timestamps page .................................................. 60
Searching for Datasets ...................................................................................... 62
Selecting a group of cells in a table .................................................................... 63
Selecting controls ............................................................................................. 64
Sending a Dataset Off-line ................................................................................. 65
Sending a Dataset to the ECU ............................................................................ 65
Sending a Parameter On-line - patching .............................................................. 65
Setting Data Source properties in AutoCal ........................................................... 66
Setting Search Criteria ...................................................................................... 66
Setting AutoCal control properties ...................................................................... 67
Setting the rate for periodic watching and marking variables ................................. 68
Setting the values of a selection of cells to the same value .................................... 69
Slider Control properties ................................................................................... 69
General Toolbar ............................................................................................... 70
...................................................................................................................... 70
Switching Watching on and off ........................................................................... 71
Table Control properties ................................................................................... 71
Text Control properties ..................................................................................... 72
The AutoCal interface ....................................................................................... 73
The Static Text Control ..................................................................................... 74
Thermometer Control properties ........................................................................ 74
...................................................................................................................... 75
Toolbars ......................................................................................................... 75
Item menu ...................................................................................................... 75
User setups ..................................................................................................... 76
User-defined groups ......................................................................................... 76
3 / 107
AutoCal
Using Virtual Instrument Controls to view data .................................................... 78

Using the 2-D Graph Control to view and edit data ............................................... 78
Using the Button Control to control data ............................................................. 79
Using the Edit Control to view and edit data ........................................................ 79
Using the Parameter Viewer Control (ParamView) ................................................ 79
Using the Pi Metafile Compiler to create a sample Dataset ..................................... 80
Using the Slider Control to view and edit data ..................................................... 81
Using the Table Control to view and edit data ...................................................... 81
Using the Table Editor to view and edit data ........................................................ 81
Version folders ................................................................................................. 82
View ............................................................................................................... 83
Viewing and editing the data - Edit Control ......................................................... 83
Viewing table data ............................................................................................ 84
3.3.3 Viewing the comments in a Dataset found by a search ................................. 86
Workbook ....................................................................................................... 88
Working with Datasets ...................................................................................... 88
...................................................................................................................... 88
Viewing data using a Parameter Viewer Control ................................................... 89
...................................................................................................................... 89
Aligning controls on a panel .............................................................................. 89
Command Button properties .............................................................................. 90
Using the Command Button control .................................................................... 90
Design mode ................................................................................................... 91
Working with a grid .......................................................................................... 91
Logging the values of watched variables to a file .................................................. 92
Converting a log file to a readable format ........................................................... 93
General Properties ............................................................................................ 94
Taking snapshots of parameter values ................................................................ 95
Applying constraints to parameters in a Dataset ................................................... 96
Dataset linked and parameter changed indicators ................................................. 98
Reverting a parameter to its last saved value ....................................................... 98
Linking watch variables to controls ..................................................................... 99
Choosing the units for a parameter .................................................................... 99
Matching conditions for copy operations ............................................................. 99
Comparing Datasets ........................................................................................ 100
Comparing Datasets, groups or parameters ....................................................... 101
Choosing what to compare .............................................................................. 101
Choosing which comparisons to display ............................................................ 102
Viewing the results of a comparison ................................................................. 103
Viewing the results of a value comparison ......................................................... 104
Refreshing the comparison .............................................................................. 105
Saving a log of the comparison ........................................................................ 105
Compare control toolbar ................................................................................. 106
Removed only ................................................................................................ 107
Removed only ................................................................................................ 107
Removed only ................................................................................................ 107
Removed only ................................................................................................ 107
4 / 107
AutoCal
2-D Graph Control Chart Recorder properties
The 2-D Graph Control Chart Recorder is not supported in this release of the software.
Next topic
Editing data using the 2-D Graph Control
Previous topic
2-D Graph Control - Graph properties
Created with the Personal Edition of HelpNDoc: Benefits of a Help Authoring Tool
2-D Graph Control Graph properties
To set Graph options for a 2-D Graph Control:

1. Choose the style of graph from the drop-down list box. You can choose:
· Plot (the default) - for two-dimensional tables, a separate line is drawn for each row in the
table.
· Area - this option fills in the area beneath the lines in a Plot with a solid color; for two-
dimensional tables, separate areas are drawn for each of the rows in the table and the areas
drawn superimposed on top of each other, so that areas for rows later in the table cover the
areas for rows earlier in the table.
· Bar Graph - for two-dimensional tables, at each axis value, separate bars are drawn next to
each other for each of the rows in the table.
· Stacking Bar - these are the same as Bar Graphs for one dimensional tables; for two-
dimensional tables, at each axis value, separate bars are drawn for each of the rows in the
table and plotted cumulatively (stacked one above the other if the bars are vertical).
· Pie Chart - a separate pie chart is drawn for each column in the table.
2. Check Show Legend to display a key identifying the colors used to plot each of the tableʼs
rows.
3. Check Invert Axes to interchange the horizontal and vertical axes.
5 / 107
AutoCal
4. Check Data Transpose to transpose the rows and columns in the table.
5. Check Multiple Sources if you are running Watch Data Manager and want to plot data from
multiple sources.
6. Check Time X-axis to monitor live data from the ECU - it converts the 2D graph to a chart
recorder.
7. Check Update Continuously if you are running Watch Data Manager and want to display live
data.
Next topic
2-D Graph Control - Chart Recorder properties
Previous topic
2-D Graph Control properties
Created with the Personal Edition of HelpNDoc: News and information about help authoring tools and
software
See Setting control properties for how to display the 2dgraph Control Properties dialog box.
See General properties for how to set those general properties that apply to 2-D Graph Controls - the
2dgraph Control Properties dialog box does not have Colors or Font pages.
In addition to the General page, the 2dgraph Control Properties dialog box has Graph and Chart
Recorder pages - these are described in the following topics.
Next topic
Previous topic
Using the 2-D Graph Control to view and edit data
Created with the Personal Edition of HelpNDoc: Easily create Web Help sites
Accessing data
Once you have loaded a Dataset into the Navigator, you can use it to access the data contained in the
Dataset.
The Navigator is designed to look, feel and behave like the familiar Microsoft® Windows® Explorer.
6 / 107
AutoCal
As in Explorer, you can expand and contract items in the Navigator by clicking on the + and - icons to the
left of the labels. The picture above shows the Sample Dataset (see Using the Pi Metafile Compiler to create
a sample Dataset) after you have expanded it one level, and shows that the Sample Dataset has three
groups within it - other Datasets will have different structures. These groups are represented by folder icons,
showing that they contain other items, which may be subgroups or parameters:
Notice that the icon representing parameters in the Navigator shows the parameter type. For example,
Parameter A1 in the picture above is a 1-dimensional table, Parameter A2 is a 2-dimensional table and
Parameter C1 is a scalar.
Key Selected Action

Backspace Group or parameter Select parent group
Up arrow Group or parameter Select the item displayed above the selected item
in the navigator
Down arrow Group or parameter Select the item displayed below the selected item
in the navigator
7 / 107
AutoCal
Left arrow Open group Close the group

Closed group or parameter Select the parent of the selected item
Right arrow Closed group Open group
Open group Select the first child item in the group
Parameter None
Another way to view the contents of groups and to get more information about parameters is to use the
ParamView Control - see Using the Parameter Viewer Control (ParamView).
Next topic
User-defined groups
Previous topic
Removing found Datasets from Search Results
Created with the Personal Edition of HelpNDoc: Create iPhone web-based documentation
Adding a fixed amount to the values of a selection of cells
To add a fixed amount to the values of a selection of cells (this operation does not apply to enumerated
values):
1. Select the cells (see Selecting a group of cells in a table).
2. Choose Block Offset from the Edit > Control submenu or the menu displayed when you right-
click in the table to display the Block Offset dialog box.
3. Enter the value you want to add to each value in the selected cells.
4. Press OK to close the dialog box and carry out the operation.
Note: If any of the results of this operation would be less than the minimum or greater than the maximum
value set in the Metafile, they will be set to the minimum or maximum value, respectively.
Next topic
Multiplying the values of a selection of cells by a fixed amount
Previous topic
Setting the values of a selection of cells to the same value
Created with the Personal Edition of HelpNDoc: What is a Help Authoring tool?
Analog Meter Control properties
See Setting control properties for how to display the Analog Meter Control Properties dialog box and set
those properties on the General, Colors and Font pages that can be applied to Analog Meter Controls.
The Analog Meter Control Properties dialog box also has a Dial page:
8 / 107
AutoCal
To set the Analog Meter Control Properties:

1. In the Warning Level box, set the percentage of full scale deflection at which you want the
meterʼs Warning Zone (shown in blue) to start.
2. In the Critical Level box, set the percentage of full scale deflection at which you want the
meterʼs Critical Zone (shown in red) to start.
3. In the Number of Labels box, set the number of graduations on the meter. You can choose any
number from 3 through 21.
4. In the Angle of display arc box, enter the angle between minimum and maximum deflection of
the meter pointer. You can choose any angle from 30 through 180 degrees.
Next topic
Bar Control properties
Previous topic
Using Virtual Instrument Controls to view data
Created with the Personal Edition of HelpNDoc: Produce online help for Qt applications
Navigator pop-up menus
The following pop-up menus are displayed when you right-click on objects in the Navigator.
Calibration Manager
Open Displays the Open dialog box so that you can open Datasets and
Channelsets
Remove All Closes all open Datasets and removes them from the Navigator -
you will be warned if any of them are in use and given the opportunity
to save any changes
Find on Disk Displays the Search Criteria dialog box so that you can specify
search criteria and carry out a search for saved Datasets
Search Datasets Displays the Search Criteria dialog box so that you can specify
search criteria and carry out a search for Datasets already loaded
Search Results
9 / 107
AutoCal
Remove Results Clears all found Datasets from Search Results

Open Results Opens all the found Datasets in Search Results
Found Dataset in Search Results

View Comments Displays the Comments Preview dialog box showing comment list
for the found Dataset
Remove Result Removes the found Dataset from Search Results
Open Result Opens the found Dataset
Loaded Dataset
Dataset Information Displays the Dataset Information dialog box so that you can view or
add Dataset information
Remove Dataset Removes the Dataset from the Navigator
Save Dataset Saves the Dataset using its current name
Save As Saves the Dataset using a new name
Run Constraints on Dataset Check whether all the parameters in a Dataset satisfy any
constraints defined for them
Auto Constrain Chooses whether or not to maintain automatically any constraints
defined for the parameters in the Dataset
Start Patching/ Sets patching mode on or off for the Dataset
Stop Patching - Currently
Patching
Send Dataset to ECU Sends the calibration data in the Dataset to the ECU
Read Dataset from ECU Reads the calibration in the ECU into the Dataset
Regrade Dataset Regrades the Dataset
Snapshot Displays the Snapshot Active dialog box so that you can enter a
comment, then saves a record of the Dataset file path and name, the
date and time it was saved, the comment, followed by the current
Dataset parameter values to a comma-separated values format file
User-defined group in Dataset

Remove All Removes all the contents of the user-defined group
Properties Displays a dialog box so that you can change the name of the user-
defined group
Parameter group in Dataset (not user-defined group)

values of the parameters contained in the group to a comma-
separated values format file
Parameter in user-defined group in Dataset

Remove Removes the parameter from the user-defined group
Run Constraint Checks whether the parameter satisfies any constraints defined for
it
value of the parameter to a comma-separated values format file
10 / 107
AutoCal
Revert Change the value of the parameter back to its last saved value
Parameter in Dataset
it
Revert Change the value of the parameter back to its last saved value
Channelset
Start Watching All marked Starts watching all of the marked parameters in the Channelset
Stop Watching All marked Stops watching all of the marked parameters in the Channelset
Start Watching All Starts watching all of the parameters in the Channelset
Stop Watching All Stops watching all of the parameters in the Channelset
Mark All Marks all the parameters in the Channelset for watching
Unmark All Unmarks all the parameters in the Channelset for watching
Start Logging All Starts saving results from all watched parameters to the log file
Stop Logging All Stops saving results from all watched parameters to the log file
User Event Displays a dialog box so that you can enter text for the user event
then log the event at the current point in the log file
Remove Channelset Removes the Channelset from the Navigator
Save Channelset Saves the Channelset using its current name
Save As Saves the Channelset using a new name
Add User Defined Group Adds a user-defined group to the Channelset
Parameter in Channelset (but not in user-defined group)

Start Watching Parameter Starts watching for the parameter
Stop Watching Parameter Stops watching for the parameter
Marked for Watching Marks or unmarks selected parameter for watching - the command
is checked in the menu when the parameter is marked
Properties Displays a dialog box so that you can specify the watching rate for a
periodic watching parameter and mark or unmark the parameter for
watching
Copy Displays a dialog box so that you can select a Dataset to copy the
value of the parameter to
User-defined group in Channelset

Start Watching Marked in Starts watching all of the marked parameters in the group
Group
Stop Watching Marked in Stops watching all of the marked parameters in the group
Group
Start Watching Group Starts watching all of the parameters in the group
Stop Watching Group Stops watching all of the parameters in the group
Mark All Marks all the parameters in the group for watching
Unmark All Unmarks all the parameters in the group for watching
11 / 107
AutoCal
Remove All Removes all the contents of the user-defined group

Remove User Defined Group Removes the user-defined group
Properties Displays a dialog box so that you can change the name of the user-
defined group
Parameter in user-defined group in Channelset

Start Watching Parameter Starts watching for the parameter
Stop Watching Parameter Stops watching for the parameter
Marked for Watching Marks or unmarks selected parameter for watching - the command
is checked in the menu when the parameter is marked
Copy Displays a dialog box so that you can select a Dataset to copy the
value of the parameter to
Start Logging Parameter Starts saving results from the watched parameter to the log file
Stop Logging Parameter Stops saving results from the watched parameter to the log file
Properties Displays a dialog box so that you can specify the watching rate for a
periodic watching parameter and mark or unmark the parameter for
watching
it
Remove Removes the parameter from the user-defined group
comment, then saves a record of the Channelset file path and name,
the date and time it was saved, the comment, followed by the current
Next topic
Toolbars
Previous topic
Help
Created with the Personal Edition of HelpNDoc: Free iPhone documentation generator
AutoCal Workspaces
Workspaces allow you to save a set of panels together with a group of Datasets.
To save the currently open panels and Datasets with a new name:
1. Choose Save Workspace As from the File menu to display the Save As dialog box.
This is a standard Windows® dialog box.
2. Use the Save As dialog box to select a folder and enter a name for the Workspace - see the
context-sensitive Help for this dialog box if you need more information.
3. Click Save to save the file and close the dialog box.
To save a previously saved Workspace again into the same file:
Choose Save from the File menu. If the Workspace has not been saved previously, the Save As dialog box
will be displayed so that you can enter a name and location with which to save the Workspace.
12 / 107
AutoCal
To open a previously saved Workspace:

1. Choose Open Workspace... from the File menu to display the Open dialog box.
Note: You can only have one Workspace open at a time, so if there are any unsaved changes in the
existing Workspace, you will be asked if you want to save them first.
2. Use the Open dialog box to select the folder and file containing the Workspace - see the
3. Click Open to open the Workspace.
Next topic
Comparing Datasets
Previous topic
Working with a grid
Created with the Personal Edition of HelpNDoc: Produce electronic books easily
See Setting control properties for how to display the Bar Control Properties dialog box and set those
properties on the General, Colors and Font pages that can be applied to Bar Controls. The Bar Control
Properties dialog box has no other pages.
Next topic
Thermometer Control properties
Previous topic
Created with the Personal Edition of HelpNDoc: Full-featured Help generator
Button Control properties
See Setting control properties for how to display the Button Control Properties dialog box and set those
properties on the General, Colors and Font pages that can be applied to Button Controls.
The Button Control Properties dialog box also has a Button page:
13 / 107
AutoCal
To specify the type of button:

From the Button Type drop-down list box, choose:
On/Off Latch if you want the button to stay on or off after you have pressed it;
Or
On/Off Non-Latch if you want the button to be on only while you keep it pressed with the
mouse - it reverts to off when the mouse is released.
Note: The Button Type drop-down list box also contains a Spin Dial option, which enables the Direction
and Step Size boxes. However, this option has not been implemented in this release of the
software.
Next topic
Editing data with the button control
Previous topic
Using the Button Control to control data
Panel's Controls Pane.
Created with the Personal Edition of HelpNDoc: Free EPub and documentation generator
Created with the Personal Edition of HelpNDoc: Create help files for the Qt Help Framework
panels
When you create Controls in AutoCal you place them on a panel.

You can create as many panels as you require for each Dataset and include controls linked to different
Datasets on the same panel.
Next topic
Creating, saving and opening panels
Previous topic
14 / 107
AutoCal
User setups
Created with the Personal Edition of HelpNDoc: Qt Help documentation made easy
Carrying out a search
To carry out a search:

Press Search in the Search Criteria dialog box.
If you change your mind about carrying out the search while it is running, press Stop in the Search Criteria
dialog box.
When the search is complete, the Search Results dialog box will be displayed showing the results. If no
Datasets have been found by the search, you will be given the opportunity to leave the Search Criteria
dialog box to set new search criteria.
If the search is successful, when you close the Search Results dialog box, the Datasets found will be
displayed under Search Results in the Navigator:
Next topic
Viewing the comments in found Datasets
Previous topic
Search Criteria dialog box - Timestamps page
Created with the Personal Edition of HelpNDoc: Easily create HTML Help documents
Changing the orientation of a table
To change the orientation of a table:

Choose the required orientation from the Axis Orientation drop-down list box - the horizontal
axis is shown first.
For example you can swap the axes in the display of a one dimensional table like Parameter A2 axis 1, to
change:
15 / 107
AutoCal
to
or for a two dimensional table like Parameter A2 to change:
to
Next topic
Choosing what to display in a table with three dimensions
16 / 107
AutoCal
Previous topic
Viewing table data
Created with the Personal Edition of HelpNDoc: Free Qt Help documentation generator
Channelset user-defined groups
You can create user-defined groups in the Channelset to collect together sets of related watch variables.
To create a Channelset user-defined group:
1. Right-click on the Channelset icon to pop up a menu.
2. Choose Add User Defined Group.
The new user-defined group will appear in the Channelset:
To add a watch variable to a Channelset user-defined group:

1. Drag the watch variable and drop it onto the user-defined group.
2. A menu will be displayed allowing you to choose whether to add the parameter or cancel the
operation.
Note: As you drag the watch variable, the pointer has a short-cut icon attached to it to show that you are
just creating another way of accessing the watch variable and not changing the structure of the
Channelset.
The watch variables will be shown in the Channelset user-defined group:
17 / 107
AutoCal
To remove a watch variable from a Channelset user-defined group:

1. Right-click on the watch variable in the user-defined group to pop up a menu.
2. Choose Remove.
To empty a user-defined group:
1. Right-click on the group in the Channelset to pop up a menu.
2. Choose Remove All.
To change the name of a user-defined group:
2. Choose Properties to display the User defined Properties dialog box (where User defined is
the current name of the group):
18 / 107
AutoCal
3. Edit the name shown in the Group Name box.

4. Press OK to close the dialog box and set the new name.
Note: The names and contents of any user-defined groups are saved with the Channelset when you save it.
To remove a Channelset user-defined group:
2. Choose Remove User Defined Group.
Next topic
Linking watch variables to controls
Previous topic
Opening Channelsets
Channelsets - monitoring variables in the ECU
AutoCal allows you to ‘watchʼ variables in an ECU in real time. To do this you use a Channelset - this
defines the variables that you can watch and their location in the ECU. Channelsets are defined as text
Metafiles in a similar way to Datasets and then compiled using the Pi Metafile Compiler.
To display the value of a watched variable, you link it to a control on a panel in the same way as you link Dataset
parameters to controls.
Next topic
Opening Channelsets
Previous topic
Reading a Dataset from the ECU
Created with the Personal Edition of HelpNDoc: iPhone web sites made easy
Parameter B3 in Group1>>Group1b is an example of a table with three axes:
19 / 107
AutoCal
Note that in the picture above the axis label Parameter B3 axis 1 is shown in black text, so the axis is
itself a table and can be edited, but Parameter B3 axis 1 is shown in gray text, so the axis cannot be
edited.
To choose which part of the table to display on the screen:
1. Choose the vertical and horizontal axes for the table from the Axis Orientation drop-down list
box. (There are three ways to choose the first axis and two ways to choose the second, so the
list has six entries.)
The drop-down list box to the left of the Axis Orientation drop-down list box is labeled by the
third axis. This allows you to choose the value of the third axis for which the other two axes are
displayed.
2. From the drop-down list box to the left of the Axis Orientation drop-down list box, choose the
value of the third axis for which to display the table.
Next topic
Editing table data
Previous topic
Colors
See Setting control properties for how to display the Properties dialog box for a control.
To set the color of a component of the control:

1. Choose the component from the Property Name drop-down list. For example: choose
BackColor to set the background color; ForeColor to set the color of the text; SlideBackColor
to set the color of the sliderʼs body in a Slider control; MercuryColour to set the color of the
liquid in a Thermometer control; and so on.
2. To choose a color for the component, either:
click on one of the color patches,
or
select one of the colors assigned to a Windows® component by selecting the component from
20 / 107
AutoCal
the System Color drop-down list.

3. Press Apply to set the color of the selected control component without closing the dialog box so
that you can set other colors; press OK to set the color of the control component and close the
dialog box.
Next topic
Fonts
Previous topic
General properties
Created with the Personal Edition of HelpNDoc: Free help authoring environment
Transferring data between AutoCal and the ECU
The instructions in the rest of this section of the Help system assume that you have correctly connected the
ECU physically to the PC and that the communications software has been correctly configured.
Next topic
Sending a Dataset to the ECU
Previous topic
Compare control toolbar
Contents
Overview
Using the Pi Metafile Compiler to create a sample Dataset
The AutoCal interface
Working with Datasets
Opening a Dataset
Version folders
Documenting a Dataset
Searching for Datasets
Setting Search Criteria
Search Criteria dialog box - Location page (disk searching only)
Search Criteria dialog box - Keywords page
Opening found Datasets
Accessing data
21 / 107
AutoCal
User-defined groups
Copying data between Datasets - Mix and Match
Reverting a parameter to its last saved value
Saving and removing Datasets
Regrading a Dataset
Creating and working with AutoCal data controls
Placing controls on a panel
Linking data to controls
Relinking controls to parameters in a different Dataset
Selecting controls
Moving and resizing controls on a panel
Aligning controls on a panel
Deleting, copying and pasting controls
Setting control properties
General properties
Colors
Fonts
Setting Data Source properties
Using the Parameter Viewer Control (ParamView)
Parameter Viewer Control Properties
Viewing data using a Parameter Viewer Control
Editing data using a Parameter Viewer Control
Using the Table Control to view and edit data
Table Control properties
Viewing table data
Editing table data
Editing a single data value
Selecting a group of cells in a table
Interpolating the values across a selection
Copying the values of cells from one part of a table to another
Using the Table Editor to view and edit data
22 / 107
AutoCal

Using the Edit Control to view and edit data
Edit Control properties
Viewing and editing the data
Using the Slider Control to view and edit data
Slider Control properties
Editing the data
Indicator Control properties
The Text Control
Text Control properties
Using the Command Button control
Command Button Control properties
User setups
Panels
Design mode
Working with a grid
Workspaces
Comparing Datasets
Comparing Datasets, groups or parameters
Choosing what to compare
Choosing which comparisons to display
Viewing the results of a comparison

Viewing the results of a value comparison
Refreshing the comparison
Saving a log of the comparison

Sending a Dataset Off-line
Sending a Parameter On-line - patching
23 / 107
AutoCal
Opening Channelsets
Periodic and state Watching
Marking variables for watching
Setting the rate for periodic watching and marking variables
Switching Watching on and off
Copying the value of a watched variable to a Dataset
Saving a Channelset
Removing a Channelset
Menus and Toolbars - summary
Menus
File
Edit
View
Layout
Item
Window
Help
Toolbars
General Toolbox
Alignment Toolbar
Controls Toolbar
Glossary
Created with the Personal Edition of HelpNDoc: Free EPub producer
Controls Toolbar
The Controls toolbar contains tools for placing controls on panels:
Dragging a control from the Controls toolbox is roughly equivalent to choosing Insert Visual Object from
the Edit menu to display the Insert Control dialog box, selecting the control from the list in the dialog box,
and clicking OK. However, when you drag the control from the toolbar you can choose where to drop it on
the panel, but when you use the menu command the control is placed at a default position, and you will
probably need to move it.
Furthermore, you can use the tools on the Controls toolbar in another way, which allows you to choose the
size and shape of the control as well as its position. For this method, click the control on the toolbar - the
button will become depressed to show it is selected. Now drag out a rectangle on the panel to define the
size, shape and position of the control.
For more details of how to work with controls, including how to link them to data, see Creating and working
with AutoCal data controls. For details of how to work with individual controls, click on the buttons in the
tables in the following table.
24 / 107
AutoCal
Control View Data Edit Data Click for details
2D-Graph Yes Yes
Analog Meter Yes No
Bar Yes No
Button No Yes
Edit Yes Yes
Indicator Yes No
Slider Yes Yes
Static Text No No
Thermometer Yes No
Command Button No No
Table Yes Yes
Compare No No
ParamView Yes Yes
Next topic
Glossary
Previous topic
Alignment Toolbox
Created with the Personal Edition of HelpNDoc: Full-featured EPub generator

Controls toolbar.
Copying data - Mix and Match
AutoCal makes it very easy to copy parameter values within and between Datasets. You may want to do
this, for example, to transfer a set of parameter values from an old version of a Dataset to a new version.
To copy parameter values within a Dataset or from one Dataset to another:
1. Open the Dataset(s) so that both the source and target are visible (see Note 2 below for copying
parameters between Datasets in different AutoCal Data Managers) - see the tables below for the
allowed sources and targets.
2. Drag the source onto the target.
Note: If you are going to Copy by tag into a different Dataset, it doesnʼt matter where you drop the
parameter in the target Dataset.
3. A menu will be displayed allowing you to choose (see the tables below for the commands
displayed for different combinations of source and target):
25 / 107
AutoCal
Copy - to copy the value of the first parameter in the source to the first parameter in the
target, the second parameter in the source to the second parameter in the target,
irrespective of the names of the parameters (see Matching conditions for copy operations for
the conditions that must be satisfied if a copy operation is to succeed).
Copy by tag - to copy the value(s) of the source parameters to the parameters in the target
Dataset with the same name (see Matching conditions for copy operations for the conditions
that must be satisfied if a copy operation is to succeed).
Add reference - to create a reference to the source parameter(s) in the target user-defined
group (or references to the equivalent source parameters if you are dragging a user-defined
group from one Dataset onto a user-defined group in another Dataset)
Assign Dataset - to relink the controls linked to the source Dataset to the equivalent
parameters in the target Dataset (see Relinking controls to parameters in a different Dataset
for details)
Cancel Operation.
Note 1: You can also display the source parameter or group in a ParamView control and drag from there
onto or into the target Dataset in the Navigator. However, dragging a source parameter into a
target parameter or group displayed in a ParamView control does not copy the data to the target -
it just makes the ParamView control display the source parameter/group.
Note 2: The source and target Datasets do not need to be in the same AutoCal Data Manager. To drag
and drop between Datasets in different AutoCal Data Managers, first display the target AutoCal
Data Manager and make sure that the target Dataset is displayed. Then display the source
AutoCal Data Manager and drag the required item from the source over the targetʼs Data Manager
button. After a short pause, the target AutoCal Data Manager will be displayed. Then drop the
item onto the target Dataset.
Note 3: The value copied is the value in engineering units, irrespective of any scaling or the type of the
parameter.
Commands displayed when you drag a source in a Dataset and drop it onto a target in the same
Dataset
Target (same Dataset)

Dataset Group User Group Parameter
Dataset --- --- Add reference ---
Group --- Copy Add reference ---
Source Copy
User Group --- Copy Add reference ---
Copy
Parameter --- --- Add reference Copy
Note: Entries marked --- mean that you cannot drop that source onto that target.
Note: All menus also have a Cancel command so that you can abort the operation.
Commands displayed when you drag a source in a Dataset and drop it onto a target in a different
Dataset
Target (different Dataset)

Dataset Group User Group Parameter
Dataset Assign Dataset Copy Copy ---
Copy by tag
26 / 107
AutoCal
Group Copy by tag Copy Copy ---

Source Copy by tag Copy by tag
User Group Copy by tag Copy Copy ---
Copy by tag Copy by tag
Add reference
Parameter Copy by tag Copy by tag Add reference Copy
Note: Entries marked --- mean that you cannot drop that source onto that target.
Note: All menus also have a Cancel command so that you can abort the operation.
Next topic
Matching conditions for copy operations
Previous topic
User-defined groups
Created with the Personal Edition of HelpNDoc: Free HTML Help documentation generator
To copy the value of a watched variable to the corresponding parameter in a Dataset:

1. Right-click on the variable in the Channelset to pop up a menu.
2. Choose Copy to display the Copy to Dataset dialog box.
The dialog box lists all the Datasets open in the Navigator that have a parameter with the same
identifier, type and size as the selected Channelset variable.
3. Click on the Dataset in the list to which you want to copy the value.
4. Press OK.
Next topic
Saving a Channelset
Previous topic
Created with the Personal Edition of HelpNDoc: iPhone web sites made easy
27 / 107
AutoCal
To copy the values of a selection of cells in a table:

2. Choose Copy cells into Clipboard from the Edit > Control submenu or the menu displayed
when you right-click in the table.
Note: If the selection is discontinuous, the cells will be copied as a continuous table (for example, if you
copy columns 1 and 3 in a table, they will become columns 1 and 2 in the table in the clipboard).
To paste the copied values into a table (which can be the same or a different table):
1. Click in the cell where you want the first value pasted (the top left-hand corner of the selection).
2. Choose Paste into Table from the Edit>Control submenu or the menu displayed when you
right-click in the table.
Any cells in the pasted table extending beyond the table you are pasting into will be ignored.
Next topic
Previous topic
To view, edit and control data in AutoCal, you place controls on a panel.
This section of the Help system begins by showing you several ways to create controls and how to link the
controls to data. It goes on to show you how to select, move, resize, delete, copy, cut and paste controls,
and how to set various control properties.
Press {button ,AL(`control',1,`',`')} for details of individual controls.
Next topic
Previous topic
Taking snapshots of parameter values
Created with the Personal Edition of HelpNDoc: Easily create iPhone documentation
Creating, saving and opening panels in AutoCal
To create a new panel:
Choose Panel from the File menu (or press cTRL+N).

To save a panel with a new name:
28 / 107
AutoCal
1. Click in the panel to select it.

2. Choose Save As from the File menu to display the Save As dialog box.
3. Use the Save As dialog box to select a folder and enter a name for the panel - see the context-
sensitive Help for this dialog box if you need more information.
To save a previously saved panel again into the same file:
1. Click in the panel to select it.
2. Choose Save from the File menu. If the panel has not been saved previously, the Save As
dialog box will be displayed so that you can enter a name and location with which to save the
panel.>
To open a previously saved panel:
1. If they are not already open and you want the controls relinked to their parameters, open the
Datasets linked to the panel.
2. Choose Panel... from the File menu to display the Open dialog box.
3. Use the Open dialog box to select the folder and file containing the panel - see the context-
sensitive Help for this dialog box if you need more information.
4. Click Open to open the panel.
Provided you opened the Datasets first, the controls will be relinked to their parameters.
Next topic
Design mode
Previous topic
Panels
Created with the Personal Edition of HelpNDoc: Free Web Help generator
To delete one or more controls from a panel:

1. Select the control(s).
2. Choose Delete from the Edit menu or press ctrl+del.
To copy one or more controls, including any links, to the Windows® clipboard:
2. Choose Copy from the Edit menu or press ctrl+c.
To cut one or more controls, including any links, to the Windows® clipboard:
2. Choose Cut from the Edit menu or press ctrl+x.
To paste one or more controls, including any links, from the Windows® clipboard onto a panel:
Choose Paste from the Edit menu or press ctrl+v.
The control will be placed on the panel to the right of the selected control (if more than one is selected, it is
29 / 107
AutoCal
placed to the right of the one that was selected first; if none is selected, it will be placed near the top left-
hand corner of the panel).
Next topic
Previous topic
To document a Dataset:
1. Right-click on the Dataset in the Navigator to pop up a menu.
2. Choose Dataset Information to display the Dataset Information dialog box:
The read-only boxes at the top of the dialog box show the name of the Dataset file and the
Application Name, Description and Version number defined in the Metafile.
2. Enter or edit text in the Dataset Description box to document the Dataset.
3. To add a time-stamped comment, press New Comment to display the New Comment dialog
box:
30 / 107
AutoCal
4. Enter the comment and press OK. The new comment will be added to the list in the Comments
table:
5. To edit a time-stamped comment, double-click in the Comment field to place a cursor and edit
the text in the normal way.
Note: If your comment is wider than the Comment column, the fact that some of the comment is not
visible is shown by the ellipsis mark ... (see the example above). You can see the rest of the
comment by placing a cursor in the Comment field and moving the cursor to the right. However, you
can also change the width of the columns in the Comments table by dragging the dividing lines in
the heading bar. If you drag the right-hand dividing line off the right-hand side of the table, a horizontal
scroll bar will appear at the bottom of the table so that you can scroll to see the full text in the
comment.
6. Press OK to close the dialog box.
As well as the time-stamped user comments, AutoCal also prompts you to enter a time-stamped comment
when you save the Dataset, patch parameter values in an ECU or send data to an ECU - see for example
Saving and removing Datasets.
You can view the comment later using the Dataset information dialog box as above, for example:
31 / 107
AutoCal
Note: No entry is made in the table if you do not enter a comment.

Next topic
Previous topic
Version folders
Created with the Personal Edition of HelpNDoc: Easy to use tool to create HTML Help files and Help web sites
Edit
The Edit menu has the following commands:
Cut Removes the selected control(s) and place it on the Windows ®

clipboard
Copy Copy the selected control(s) onto the Windows® clipboard
Paste Paste the contents of the Windows ® clipboard onto the panel
Delete Delete the selected control(s)

Select All Select all objects on the displayed panel
Insert Visual Object... Display the Insert Control dialog box so that you can choose a
control, and then place selected control on the panel
Control Object Submenu (Control is the name of the selected control)
Properties Display the Properties dialog box for selected control
Data Source Properties This function is not implemented in this release of the software
Next topic
32 / 107
AutoCal
View
Previous topic
File
Created with the Personal Edition of HelpNDoc: Easy EPub and documentation editor
See Setting control properties for how to display the Edit Control Properties dialog box and set those
properties on the General, Colors and Font pages that can be applied to Edit Controls.
Next topic
Previous topic
To edit a single data value in a table:

1. Make sure the cell containing the data is displayed.
2. Click on the value in the cell.
Note: You can also change which cell is selected by pressing the arrow keys, CTRL + an arrow key and
the Page Up/Down keys.
If the cell contains a scalar value spin buttons will appear at the right-hand end of the cell:
If the cell contains an enumeration, a drop-down list box will appear:
33 / 107
AutoCal
(Note that this example is not taken from Sample.dat.)

3. Edit a scalar value by typing in a new value or by clicking on a spin button to increase or
decrease the value; edit an enumeration by selecting a new value from the drop-down list or by
typing in the new value (the value you type in must be exactly one of the possible enumeration -
for example, the case of all letters must be the same).
4. Use an arrow key to move to the next cell, if required.
If you try to enter a value greater than the maximum or less than the minimum value set in the Metafile, the
value will be set to the maximum or minimum value, respectively.
Next topic
Previous topic
Editing table data
Created with the Personal Edition of HelpNDoc: Easily create Qt Help files
To select an item in the Parameter Viewer Control:

Click on it.
You can use the Up/Down arrow, Page Up/Page Down and Home/End keys to change the selection in the
Parameter Viewer Control.
You can scroll the Parameter Viewer Control using the left and right arrow keys.
Double-clicking on an item (or selecting the item and pressing the RETURN key) in the ParamView control
has the following effects:
Item Effect
Parameter Group Displays contents of group in the ParamView control.
Parameter table Opens a table editor window with the parameter table loaded - see
Using the Table Editor to view and edit data.
Scalar parameter Selects the value in the Value column (shown by highlighting) so that it
can be edited.
34 / 107
AutoCal
Enumeration parameter Displays a drop-down list box in the Value column so that you can select
one of the enumerated values.
Note: Enumeration parameters are parameters that can only take one of a fixed set of values. These values
are enumerated in the Metafile by an 'enum' declaration.
Next topic
Previous topic
Created with the Personal Edition of HelpNDoc: News and information about help authoring tools and
software
You can use the 2-D Graph Control (unless it is in pie chart mode) to edit the data it displays.
For example, to edit data in a Plot:
1. Place the pointer over the data point you want to change:
2. Drag the data point to its new position:
You can edit the data using Area, Bar Graph and Stacking Bar charts using a similar technique - the data
points are not shown as circles in these charts, so you drag the edge of the area or bar.
35 / 107
AutoCal
Editing the data in this way is quick and easy, but can be less precise than entering the data directly in a
table. However, if you display the table in a Table Control or the Table Editor, you will be able to see the
exact value of the data as you adjust it in the 2-D Graph Control.
Next topic
Previous topic
Created with the Personal Edition of HelpNDoc: Easy CHM and documentation editor
To turn a latching button control on or off:

Click on the button.
To turn a non-latching button control on:
Move the pointer over the button control and press the mouse button. The button will turn off
when you release the mouse button.
Next topic
The Static Text Control
Previous topic
Editing table data
You can edit the value of an individual cell in a table (see Editing a single data value) or edit the values of a
group of cells together (see Selecting a group of cells in a table).
When you edit the values for a selection of cells you can:
· set them all to the same value
· add a fixed amount to their current values
· multiply their current values by a fixed amount
· interpolate the values between one end of the selection and the other
· copy a block of cells from one part of a table to another
Next topic
Previous topic
36 / 107
AutoCal
Editing the data using a Slider Control
To edit the data linked to a slider control:

Press the following keyboard keys:
Key Action
Down arrow decrease value by a small amount
or left arrow for a horizontal slider
or right arrow for a vertical slider
Up arrow increase value by a small amount
or right arrow for a horizontal slider
or left arrow for a vertical slider
Page Down decrease value by a larger amount
Page Up increase value by a larger amount
Home set to lowest value
End set to highest value
If the Mouse Select property is set, you can also set the slider position using the mouse.
To adjust the setting of a slider control using the mouse:
Click to the right or left of the slider to move the slider in increments of half a graduation.
Or
Drag the slider to the appropriate position.
Next topic
Previous topic
Created with the Personal Edition of HelpNDoc: Full-featured Documentation generator
File
The File menu has the following commands:
Panel Creates a new panel
Panel... Displays the Open dialog box so that you can open a previously
saved panel
Close Closes the selected panel
Save Saves the selected panel to its existing file - displays the Save As
dialog box if not previously saved
Save As... Displays the Save As dialog box so that you can enter a location and
file name for saving the selected panel
37 / 107
AutoCal
Open Workspace... Displays the Open dialog box so that you can open a previously
saved Workspace
Save Workspace Saves the current Workspace to its existing file - displays the Save
As dialog box if not previously saved
Save Workspace As... Displays the Save As dialog box so that you can enter a location and
file name for saving the current Workspace
Design Mode Switches Design mode on or off - the command is checked and the
button depressed when Design Mode is on
Print Prints a screen shot of the selected panel
Most recently used files The File menu lists the names of recently used files - choose the
name from the menu to re-open it
Exit Close ToolBench
Next topic
Edit
Previous topic
Menus
Created with the Personal Edition of HelpNDoc: Single source CHM, PDF, DOC and HTML Help creation
Fonts
See Setting control properties for how to display the Properties dialog box for a control.
To set the font used for a component of the control:

1. Choose the component from the Property Name drop-down list. For example: choose
CaptionFont to set the font used for the caption, value and unit in Slider, Thermometer etc
controls; GraduationFont to set the font used for the scale on these controls; Edit to set the
font used for the data in an edit control; and so on.
2. Choose a typeface from the Font box.
3. Choose Regular, Bold, Italic or Bold Italic from the Font Style box.
38 / 107
AutoCal
4. Check Strikeout and/or Underline from the Effects box to apply these effects to the text.
5. Press Apply to set the font for the selected control component without closing the dialog box so
that you can set the font for other components; press OK to set the font for the component and
close the dialog box.
Next topic
Previous topic
Colors
Created with the Personal Edition of HelpNDoc: Easily create PDF Help documents
General toolbar.
Glossary
Calibration Manager Windows ® style navigator

Control The tool used to control, edit or view the data
Dataset The parameters used by the ECUʼs control logic
Design Mode Switch Design Mode on to define the type and layout of controls; switch it off
to work with controls to calibrate ECU.
You can carry out all operations when working with Design Mode On but
switching Design Mode Off locks the controls in position so that you can
concentrate on using them
Workspace Saved file including the panels and the Data Manager/Navigator
Device The mechanical element controlled by the ECU
Electronic Control Unit A module that receives data from sensors monitoring external parameters
(ECU) (such as engine speed, barometric pressure and load), and adapts its
control strategy to suit the monitored variables
Legend On a Graph Control, a list showing the color used to identify each of the
curves on a graph
Metafile, Script A text document, created by an AutoCal user, defining the format and structure
of data controlling the embedded application.
Metafile, Binary A binary file describing the format and structure of data controlling the
embedded application
Metafile Compiler Converts script Metafiles to binary Metafiles
Off-line editing Editing a Dataset in AutoCal with no active connection to the ECU
On-line editing Editing a Dataset in AutoCal, and sending edited parameters to the ECU
while it is controlling the device
Panel The area on which controls are dropped and parameters controlled, edited
and viewed
Patching Sending edited parameters to the ECU while it is controlling the device -
carrying out On-line editing
Read Dataset Copy data from the ECU into AutoCal
39 / 107
AutoCal
Regrade Update the version of a Dataset in the ECU
Previous topic
Controls Toolbar
Created with the Personal Edition of HelpNDoc: Produce Kindle eBooks easily
Help
The Help menu has the following commands:
Help Contents... Display the Contents page for the Help system
About... Display the About dialog box showing information about the version
of ToolBench you are running
Next topic
Previous topic
Window
Created with the Personal Edition of HelpNDoc: Free help authoring tool
See Setting control properties for how to display the Indicator Control Properties dialog box and set those
properties on the General, Colors and Font pages that can be applied to Indicator Controls.
Note: The Indicator will show its ‘offʼ state (Red and showing the ‘Offʼ text - see below) if the value of the
linked parameter is in the lower half of its allowed range set in the Metafile; otherwise it will be in its
‘onʼ state.
The Indicator Control Properties dialog box also has an Indicator page:
To set the text shown by the Indicator Control:
40 / 107
AutoCal
Enter the text to be displayed when the Indicator is On and Off. The length of the text is limited
by the size of the control - if it will not fit in the control it wonʼt be displayed.
Next topic
Previous topic
Created with the Personal Edition of HelpNDoc: Easily create EPub books
To interpolate the values across a selection (this operation does not apply to enumerated values):
1. Set the contents of the cells at the ends of the selection to the required values (see Editing a
single data value).
2. Select the block of cells through which you want to interpolate the values (see Selecting a group
of cells in a table).
3. Choose Interpolate Selection from the Edit > Control submenu or the menu displayed when
you right-click in the table.
The values of the cells will be linearly interpolated between the values at the ends of the selection using the
axis settings. For example, the values in the selected row have been set by interpolation:
value set in the Metafile, they will be set to the minimum or maximum value, respectively - this can
happen if the value of one of the intermediate axis points is greater or less than the values of the axis
points at the ends of the selection.
Next topic
Previous topic
Created with the Personal Edition of HelpNDoc: Create cross-platform Qt Help files
41 / 107
AutoCal
Layout
The Layout menu has the following commands:
Centre in Panel Submenu

Horizontal Centres selected control to the horizontal centre of the panel
Vertical Centres selected control to the vertical centre of the panel
Align Controls Submenu
Left Aligns all selected controls to the left-hand edge of the control
furthest to the left
Right Aligns all selected controls to the right-hand edge of the control
furthest to the right
Top Aligns all selected controls to the top edge of the control nearest to
the top
Bottom Aligns all selected controls to the lower edge of the control nearest
to the bottom
Horizontal Centre Aligns the horizontal centre of each selected control to the horizontal
centre of all the selected controls
Vertical Centre Aligns the vertical centre of each selected control to the vertical
Snap To Grid When selected, edges of controls will be forced to align with the grid
when you create them
Change Grid Spacing... Displays the Change Grid Spacing dialog box so that you can set the
X and Y spacing of the alignment grid
Next topic
Item
Previous topic
View
Alignment toolbox
The Alignment Toolbox contains a collection of tools for aligning controls with each other:
The equivalent commands all appear on the Align Controls submenu in the Layout menu.
Menu command Action
Left Aligns all selected controls to the left-hand edge of the control
furthest to the left
Right Aligns all selected controls to the right-hand edge of the control
furthest to the right
42 / 107
AutoCal
Top Aligns all selected controls to the top edge of the control nearest
to the top
Bottom Aligns all selected controls to the lower edge of the control
nearest to the bottom
Horizontal Centre Aligns the horizontal centre of each selected control to the
horizontal centre of all the selected controls
Vertical Centre Aligns the vertical centre of each selected control to the vertical
Next topic
Controls Toolbox
Previous topic
General Toolbar
Alignment toolbox.
To link data to a control (if you did not link it to a parameter when you created it, or if you want to link it to a
different parameter):
1. Display the parameter in the Navigator (or a ParamView control - see Using the Parameter
Viewer Control (ParamView)).
2. Drag the parameter onto the control.
Note: An advantage of using a ParamView control here is that it shows a description of the parameter so
that you can check that you are linking the parameter to a suitable type of control.
Note: The Navigator shows when a Dataset has unsaved changes with an asterisk between the Dataset
icon and the Dataset name - the parameters that have been changed are marked similarly:
Next topic
Previous topic
43 / 107
AutoCal
AutoCal allows you to mark variables so that you can switch Watching on or off for all the marked variables
(or all the marked variables in a group) at the same time.
To mark (or unmark) an individual variable:
1. Right-click on the variable that you want to mark (unmark) to pop up a menu.
2. Choose Marked for Watching.
To mark (or unmark) all the variables in a group or the whole Channelset together:
1. Right-click on the group or the whole Channelset that you want to mark (unmark) to pop up a
menu.
2. Choose Mark All (or Unmark All).
When a variable is marked, the command is checked in the menu and the variable is marked by a tick in the
Data Manager:
The two variables in the User defined group are marked; the other variables are unmarked.
Note: All marked variables are shown with a tick - blue if they are not currently being watched and red if
they are. However, a red tick does not necessarily mean that the variable is marked since all
currently watched variables are shown with a red tick whether marked or not. To check if a watched
variable is also marked, right-click on it and see if the Marked for Watching command is checked,
or look at the variable properties.
When you save a Channelset, the marked/unmarked status of each variable is also saved and will be
restored when you open it again.
Next topic
Previous topic
Periodic and state watching
44 / 107
AutoCal
menus topics for more information.
Menus
This section gives a summary of the commands in the following menus:

File
Edit
View
Layout
Item
Window
Help
Next topic
File
Previous topic
Menus and Toolbars summary
This section of the Help system contains information about each of the menus and toolbars in the program.
Next topic
Menus
Previous topic
Created with the Personal Edition of HelpNDoc: Free PDF documentation generator
Note The setting of Snap to Grid in the Layout menu or the menu displayed when you right-click in the
panel has no effect on moving or resizing controls.
To resize a control on a panel:
1. Click on the control to select it - the border of the control will be hatched and there will be drag
handles at the corners and middle of each side:
45 / 107
AutoCal
2. Move the pointer over one of the drag handles - the pointer will change to a two-headed arrow
showing the direction in which you can reshape the control.
3. Drag the box to resize/reshape the control.
To move one or more controls on a panel:
2. Move the pointer over the border of the control (avoid the drag handles if you are just moving one
control; move the pointer over the border of any of the controls if you are moving more than one) -
the pointer will change to a four-headed arrow.
3. Drag the control to the required position on the panel.
Next topic
Previous topic
Selecting controls
Created with the Personal Edition of HelpNDoc: Easily create CHM Help documents
To multiply the values of a selection of cells by a fixed amount (this operation does not apply to enumerated
values):
2. Choose Block Multiply from the Edit > Control submenu or the menu displayed when you
right-click in the table to display the Block Multiply dialog box.
3. Enter the value by which you want to multiply each value in the selected cells.
Next topic
Previous topic
46 / 107
AutoCal
Created with the Personal Edition of HelpNDoc: Easily create Qt Help files
Opening Channelsets
To open a Channelset:
1. In the Navigator, right-click on Calibration Manager to display a pop-up menu.
2. Choose Open to display a standard Windows® Open dialog box.
3. In the Files of type drop-down list box, either select Metafiles (.met) if you want to open a
compiled Metafile, or select AutoCal Files (.dat; .ise) to open a Channelset (.ise file) saved
previously in AutoCal.
4. Use the Look in drop-down list and the file/folder list box to select the drive and folder containing
the required Channelset - see the context-sensitive Help for this dialog box if you need more
information.
The files of the type selected at Step 3 will be listed.
5. Select the required file and press Open, or just double-click on the file.
Note: You can select more than one file by extending the selection using SHIFT-click and/or CTRL-click in
the normal way. In this way you can open Channelsets and Datasets at the same time.
The Channelset will be displayed in the appropriate version folder in the Navigator (the color of the icons
distinguishes Channelsets (red) from Datasets (yellow)):
The Channelset lists the variables that you can watch.

Next topic
47 / 107
AutoCal
Previous topic
Opening a Dataset
To open a Dataset (such as the sample Dataset created in Using the Pi Metafile Compiler to create a
sample Dataset):
1. Launch Pi ToolBench.
2. Right-click on Calibration Manager in the Navigator to display a pop-up menu.
3. Choose Open to display the Open Dataset dialog box.
4. In the Files of type drop-down list box, either select Metafiles (.met) if you want to open a
compiled Metafile (such as the Metafile saved in Using the Pi Metafile Compiler to create
sample data), or select AutoCal Files (.dat; .ise) to open a Dataset saved previously in
AutoCal.
Note: The .ise files are Channelsets, which you use to monitor variables in the ECU.
5. Use the Look in drop-down list and the file/folder list box to select the drive and folder containing
the required Dataset - see the context-sensitive Help for this dialog box if you need more
information.
The files of the type selected at Step 4 will be listed.
6. Select the required file (for example Sample.met for the file containing the sample data).
Note: You can select more than one file by extending the selection using SHIFT-click and/or CTRL-click in
the normal way. In this way you can open Datasets and Channelsets at the same time.
7. Click Open.
A numbered green folder will appear under Calibration Manager:
The number next to the folder is the version number given in the Metafile.
To see the Dataset (Metafiles are converted into Datasets when they are loaded into AutoCal):
Click on the + icon next to the folder to open it:
You can close the folder again by clicking on the - icon.

Next topic
Dataset linked and parameter changed indicators
48 / 107
AutoCal
Previous topic
Created with the Personal Edition of HelpNDoc: Free EBook and documentation generator
To open all the Datasets found during a disk search:

1. Right-click on Search Results to pop up a menu.
2. Choose Open Results.
To open one of the Datasets found during a disk search:
1. Right-click on the Dataset in Search Results to pop up a menu.
2. Choose Open Result.
Next topic
Previous topic
Overview
AutoCal provides a programmable software interface to the Electronic Control Unit (ECU) in an engine. Using
AutoCal, you can:
· View and edit the control parameters in the ECU to optimize the control logic
· View instrumentation variables, such as rpm or fluid temperatures and pressures, while the engine is
running.
The control parameters and variables can be of many different types (such as integer, floating point or
enumerated values) and structure (such as, single-valued scalars or one, two or three dimensional tables).
AutoCal provides a wide range of controls for viewing and editing all these types of values, including:
· Virtual instruments such as analog meters, thermometers, bars and sliders.
· 2D graphs.
· Buttons.
· Text and Table controls.
The control parameters for an ECU are defined in a file called a Dataset, which can be created using Piʼs
Metafile Compiler. Datasets can be edited off-line or on-line:
· To edit a Dataset off-line, you can either:
(a) Open a file containing a saved version of the Dataset, or
(b) Connect to the ECU, read the Dataset, and then disconnect.
You can then edit the Dataset in AutoCal and either save the edited version to download to the
Dataset at a later time, or connect to the ECU and download the Dataset to the ECU immediately.
· To edit a calibration on-line, you set the Dataset to ‘patchingʼ mode - AutoCal first sends the current
49 / 107
AutoCal
state of the Dataset from the PC to the ECU; then, until you leave patching mode, any changes you
make to the Dataset parameters in AutoCal are sent immediately to the ECU while it is running.
The instrumentation variables are also defined in a file, which is called a Channelset and which can also be
created using Piʼs Metafile Compiler.
Typical applications for AutoCal include:
· debugging new ECU control logic;
· optimizing operation by fine-tuning individual control parameters for a device while it is running;
· reprogramming an ECU to accommodate changing requirements.
Main sections of the Help system
AutoCal data controls
User setups
Comparing Datasets
Communicating with the ECU
Glossary
See also
Created with the Personal Edition of HelpNDoc: Create HTML Help, DOC, PDF and print manuals from 1 single
source
See Setting control properties for how to display the ParamView Control Properties dialog box:
1. Check Display Path to show the complete path to the parameter in the controlʼs title bar instead
of just the parameterʼs name.
50 / 107
AutoCal
2. Click on a radio button to choose whether values should be displayed in:

· Engineering Units
· ECU units in Decimal format
· ECU units in Hex format.
Next topic
Previous topic
Periodic and state Watching
You can watch one, two and three-dimensional table parameters as well as scalar parameters. However, for
efficiency, table parameters are not watched in quite the same way as scalar parameters:
· For scalar variables, AutoCal polls the ECU periodically (at a rate that you can set) and updates the
value of the Channelset parameter in AutoCal - this is called periodic watching since the Channelset
parameter is updated periodically irrespective of whether it has actually changed.
· For table variables, AutoCal waits until it receives a message from the Communications Service
saying that the table has changed in the ECU, and then updates the value of the Channelset
parameter in AutoCal - this is called state watching since the Channelset parameter is only updated if
the state of the table in the ECU changes.
Terminology: A table parameter that is being state watched is called an adaptive map.
Next topic
Previous topic
Placing controls on an AutoCal panel
You can place controls on a panel:

· Using the Controls toolbox
· Using a menu command
· Using the Navigator or a ParamView control.
To place a control on a panel using the Controls toolbox:
1. Press the required controlʼs button in the toolbox - the button will be shown as depressed in the
toolbox.
2. Drag out the required outline of the control on the panel (drag from the top left-hand corner to the
bottom right-hand corner).
Alternatively:
51 / 107
AutoCal
Drag the required control from the Controls toolbox onto the panel - the control will be placed on
the panel with a default size and with its top left-hand corner at the point you dropped it.
To place a control on a panel using a menu command:
1. Choose Insert Visual Object from the Edit menu (or the menu displayed when you right-click in
the panel) to display the Insert Control dialog box:
2. Click on the required control in the list to select it.

3. Press OK to place the control on the panel with a default size and position.
To place a control on a panel and link it to a parameter in a Dataset at the same time:
1. Display the parameter in the Navigator or a ParamView control.
2. Drag the parameter from the Navigator or ParamView control over the panel to the required
position .
3. Drop the parameter in the required position.
The Insert Control dialog box will be displayed:
4. Click on the required control in the list to select it.

5. Press OK to place the control on the panel with a default size in the selected position.
Next topic
Previous topic
Created with the Personal Edition of HelpNDoc: Easy EBook and documentation generator
52 / 107
AutoCal
Note: In order to read a Dataset from the ECU, you must first open a Dataset with the same configuration
in AutoCal. When you read the Dataset from the ECU, it will overwrite the Dataset in AutoCal.
1. Open the appropriate Dataset (see Opening a Dataset).
2. Select the Dataset in the Navigator.
3. Right-click on the Dataset in the Navigator to pop up a menu, and choose Read Dataset from
ECU.
The Read Dataset Succeeded dialog box will be displayed when the process is complete.
Next topic
Previous topic
Regrading a Dataset
When you create a new version of a metafile the structure of existing Datasets from the previous version
may become invalid. AutoCal allows you to ‘regradeʼ existing Datasets to match the structure of a new
version of the metafile.
To regrade a Dataset:
1. Right-click on the Dataset in the Navigator to select it and pop up a menu.
2. Choose Regrade Dataset from the pop-up menu to display the Select Metafile To Convert To
dialog box.
This is a standard Windows® Open dialog box.
3. Use the dialog box to select the new version of the metafile and press Open to display the Save
Regraded Calibration As dialog box.
This is a standard Windows® Save dialog box.
4. Use the dialog box to select a folder for the Dataset and enter a name for it.
The new regraded Dataset will be loaded into the Navigator and the Regrade Output dialog box will be
displayed summarizing the actions taken:
53 / 107
AutoCal
You can select text in the dialog box using the usual Windows® techniques - for example, drag the cursor
through the text, or click at the beginning of the selection and SHIFT-click at the end or right click in the text
box to pop up a menu and choose Select All.
To copy the text selected in the Regrade Output dialog box to the Windows® clipboard:
Right click in the text box to pop up a menu and choose Copy.
You can paste the copied text into a word processor or text editor.
Next topic
Choosing the units for a parameter
Previous topic
Created with the Personal Edition of HelpNDoc: Write EPub books for the iPad
To relink the controls that are linked to one Dataset (Dataset A for example), to parameters with the same
name in a different Dataset (Dataset B for example):
1. Drag the Dataset icon for Dataset A and drop it on the icon for Dataset B.
A menu will pop up.
2. Choose Assign Dataset to link the controls previously linked to parameters in Dataset A to the
equivalent parameters in Dataset B.
Note: If you drop the Dataset on one of the parameters or parameter groups in the target Dataset, the
menu will contain the Copy Tree Parameters command, allowing you to copy parameter values
from Dataset B to Dataset B - see Copying data - Mix and Match for details.
Next topic
Selecting controls
Previous topic
54 / 107
AutoCal
To remove a Channelset from the Navigator:

1. Right-click on the Channelset in the Navigator to select it and pop up a menu.
2. Choose Remove Channelset from the pop-up menu.
The Channelset entry will be removed from the Navigator.
Next topic
Previous topic
Saving a Channelset
To remove all the Datasets from Search Results:

1. Right-click on Search Results to pop up a menu.
2. Choose Remove Results.
To remove one of the Datasets found during a disk search:
2. Choose Remove Result.
Next topic
Accessing data
Previous topic
Created with the Personal Edition of HelpNDoc: Easy EPub and documentation editor
Saving a Channelset
Note: Channelsets are saved in files with a ‘.iseʼ extension.

To save a Channelset:
1. Right-click on the Channelset icon in the Navigator to select it and pop up a menu.
2 Either, if the Channelset has been saved previously in AutoCal and you want to save it again in
the same file:
Choose Save Channelset.
Or, if you want to save the Channelset for the first time, or want to save it in a new file:
a. Choose Save As from the pop-up menu to display the Save As dialog box.
55 / 107
AutoCal

b. Use the Save As dialog box to select a folder and enter a name for the Channelset - see
the context-sensitive Help for this dialog box if you need more information.
c. Press Save to save the Channelset.
When the Channelset is saved, any user groups you have created, the Watching state of the variables and
their polling rates will be saved.
Next topic
Previous topic
Created with the Personal Edition of HelpNDoc: Full-featured multi-format Help generator
Note: Dataset are saved in files with a ‘.datʼ extension.

The Navigator shows when a Dataset has unsaved changes by displaying an asterisk between the Dataset
icon and the Dataset name - the parameters that have been changed are marked similarly:
To save a Dataset with a new name:

2. Choose Save As from the pop-up menu to display the Save As dialog box.
3. Use the Save As dialog box to select a folder and enter a name for the Dataset - see the
4. Press Save to display the Save Dataset As dialog box:
5. Type into the Enter comment box any comment you want saved with the Dataset - the
56 / 107
AutoCal
comment will be timestamped to show the time the Dataset was saved. See Documenting a
Dataset for how to view comments and add them to Datasets at other times.
6. Enter or edit your name in the Who box and the location in the Where box - these context fields
will be appended to the comment.
7. Uncheck Copy existing comments to new dataset if you want the new comment to replace
any existing ones; leave it checked if you want to add it to the existing comments.
8. Press OK to save the Dataset.
To save a Dataset after you have changed it using its current name:
2. Choose Save from the pop-up menu to display the Save Dataset dialog box:
3. Type into the Enter comment box any comment you want saved with the Dataset - the
comment will be timestamped to show the time the Dataset was saved.
4. Enter or edit your name in the Who box and the location in the Where box - these context fields
will be appended to the comment.
5. Press OK to save the Dataset.
To remove a Dataset from the Navigator:

2. Choose Remove Dataset from the pop-up menu.
If there are any unsaved changes, you will be asked if you want to save them.
The Dataset entry will be removed from the Navigator.
To remove all of the Datasets from the Navigator:
1. Right-click on Calibration Manager in the Navigator to select it and pop up a menu.
2. Choose Remove All from the pop-up menu.
If there are any unsaved changes in any of the Datasets, you will be asked if you want to save them.
Next topic
Regrading a Dataset
Previous topic
57 / 107
AutoCal
Search Criteria dialogue box - Keywords page
The Keywords page in the Search Criteria dialog box allows you to set conditions on the text contained in
the Dataset comments list:
To specify conditions on the text contained in the Dataset comments list:

1. Check Keywords if you want to search for specific text in the Dataset comments and enter the
required text in the Keywords box.
· Separate alternative keywords with semicolons. The search will succeed if any of the
keywords is found.
· See Step 4 for how to use regular expressions in searches.
2. Check Match whole words only if you want the search to succeed only if the comment
contains exactly the word(s) in the Keywords box. For example:
save will only find save if Match whole words only is checked, but will find both save
and saved if it is unchecked.
3. Check Match case if you want the search to succeed only if the comment contains the text in
the Keywords box with exactly the same case.
4. Check Regular expression if you want to the Keywords interpreted as regular expressions
rather than literally - see the table below for the special characters that can be used in regular
expressions
Character Description Examples

search string matches
() Defines a subexpression see below for

within the regular examples
expression
| Matches either of the fi|are fire
subexpressions on each
fare
side of the |
t(hrot)|(ur)tle throttle
turtle
[] Matches any of the 1[234]5 125
subexpressions between
135
the brackets
145
58 / 107
AutoCal
[89(10)]5 85
95
105
[-] Matches any character in 1[2-4]5 125
the (alphabetical) range
135
145
[b-e]at bat
cat
dat
eat
[^ ] Matches any character [^1] any character except 1
except those following ^ in
[^0-9] any character except a digit
the brackets
^ Matches the ^(patched) patched by John Doe
subexpression following
but not
the ^ if it occurs at the
beginning of the string dataset patched by John Doe
$ Matches the $(injector) calibrated injector
subexpression following
but not
the $ if it occurs at the end
of the string injector calibrated
. Matches any character s...d saved
speed
* Matches the previous spee*d sped
subexpression zero or
speed
more times
speeed
+ Matches the previous spe+d sped
subexpression one or
speed
more times
speeed
? Matches the previous spee?d sped
subexpression zero or one
speed
times
but not speeed
\ Matches the special $25$ (25)
character following \
literally
Note: The comments found by the Keywords search criteria must also satisfy any Timestamps criteria -
see the next topic.
Next topic
Previous topic
59 / 107
AutoCal
Search Criteria dialogue box - Location page (disk searching

only)
The Location page in the Search Criteria dialog box allows you to set conditions on the location, names
and types of the Dataset files searched for:
To specify conditions on the location, names and types of the Dataset files searched for:
1. In the File spec box, specify the names of the files to be found.
· You can use the * and ? wild panels in the usual way to specify a class of names. For
example:
*.dat will search all .dat files
s*.dat will search all .dat files with file name beginning with s
???.dat will search all .dat files with three letter file names.
· You can use a semicolon to specify multiple file specifications. For example:
s*.dat; p*.met will search all .dat files beginning with s or p.
2. In the Search Paths box, specify the folders where the files are to be found.
· You can use a semicolon to specify multiple paths - all the paths will be searched.
· You can press the button to display a folder browser so that you can select the required
folder path rather than have to type it in the path. If you have already specified a path, the
new path will be added to the existing one with a semicolon separator.
3. Check Include subfolders if you want to search all the folders within the folders specified in the
Search Paths box; uncheck it if you just want to find files directly within the specified folders.
Next topic
Previous topic
Search Criteria dialogue box - Timestamps page
60 / 107
AutoCal
The Timestamps page in the Search Criteria dialog box allows you to set conditions on the date and time
of any comments satisfying any Keywords criteria:
If you do not want to set any conditions on the time or date of comments:
Click on the All comments radio button.
To specify conditions on the date and time of comments, do one of the following:
· To search for Datasets containing comments added within a set number of days:
1. Click on the during the previous ... day(s) radio button.
2. Click on the up/down arrows at the right-hand edge of the day(s) box or type in the required
number.
· To search for Datasets containing comments added within a set number of months:
1. Click on the during the previous ... month(s) radio button.
2. Click on the up/down arrows at the right-hand edge of the month(s) box or type in the required
number.
· To search for Datasets containing comments added between two specified dates:
1. Click on the between ... and ... radio button.
2. To set the earliest and latest dates in the range, either:
Click on the day, month and year figures in turn and type in the required numbers.
or
Click the down-arrow to display a calendar so that you can specify the dates - see the
instructions later in this topic for how to use the calendar.
3. If you want to refine the range by specifying times within the earliest and/or latest dates, check
the check boxes in the relevant time box. Then, click on the Hours figure and type in the required
number, or click on the up/down arrows at the right-hand edge of the time box. Repeat for the
Minutes and Seconds.
To specify a date using a calendar:
1. Click on the down arrow at the right-hand side of the date box to display the calendar:
61 / 107
AutoCal
The selected date is highlighted.

2. If required, click on Today to set the calendar to todayʼs date.
3. To change the year, click on the Year at the top of the calendar to display an edit box there:
Use the up/down arrows to change the year.

4. To change the month:
Either:
Click on the left or right arrow buttons at the top left-hand and right-hand corners of the
calendar to set the previous or next month.
Or:
a. Click on the month to pop up a menu showing the months.
b. Select the required month from the menu.
5. Click on the required day in the calendar.
Next topic
Previous topic
62 / 107
AutoCal
AutoCal allows you to search for Dataset using the comments in the Datasets. You can search for Dataset
files on disk or amongst the Datasets loaded into the Navigator. You can search for text in the comments
and/or for the date/time that the comment was added. When searching for Dataset files, you can also
specify the location(s) of the files.
Note: It is important to remember that the search is performed on the comments in the Datasets - if a
Dataset does not contain a comment, it cannot be found by a search.
To search for Datasets:
1. Right-click on Calibration Manager in the Navigator to pop up a menu.
2. Display the Search Criteria dialog box by choosing:
· Find on disk to search for Datasets saved on Disk.
· Search Datasets to search the Datasets loaded into the Navigator.
Note: Once you have displayed the Search Criteria dialog box, any previous search results will be
destroyed. If the search is successful, the previous results will be replaced by the new ones; if the
search is unsuccessful or if you do not carry out the search, the previous results will be removed,
leaving the Search Results empty.
The next topic shows you how to use the Search Criteria dialog box to set search criteria.
Next topic
Previous topic
Created with the Personal Edition of HelpNDoc: Write eBooks for the Kindle
To select all the displayed cells of a table with two or more dimensions:
Click on the box where the two axes meet at the top left-hand corner of the table:
Click again to deselect all the cells.

To select all the cells in a column (row):
Click on the axis box labeling the column (row) - the pointer changes to a vertical (horizontal)
arrow when it is in the box:
63 / 107
AutoCal
To add adjacent columns (rows) to the selection:

Drag the pointer from the selected columnʼs (rowʼs) axis box into the axis boxes for the columns
(rows) you want to add.
Or
SHIFT-click in the axis box for last column (row) in the required selection.
To add an individual column (row) to a selection:
CTRL-click in the axis box for the column (row).
To select a block of cells in a table:
Drag from one corner of the block to the diagonally opposite corner.
or
Press Shift+arrow keys.
Next topic
Previous topic
Selecting controls
To select one or more controls on a panel:

1. Click on the first control you want to select.
2. CTRL-click (or SHIFT-click) on any other tools you want to add to the selection.
Or
Using the pointer, drag a selection box around the controls you want to select - any controls
completely enclosed by the selection box will become selected.
To select all the controls on a panel:
Choose Select All from the Edit menu or the pop-up menu displayed when you right-click on the
panelʼs background.
Next topic
64 / 107
AutoCal
Previous topic
To send a Dataset to the ECU:

1. Open the Dataset that you want to send to the ECU (see Opening a Dataset).
3. Right-click on the Dataset to display a pop-up menu and choose Send Dataset to ECU.
A dialog box will be displayed showing that the Dataset has been sent successfully.
Next topic
Previous topic
You can send parameters to the ECU in two ways: off-line, when the complete Dataset is sent; or on-line,
when individual parameters are sent while the ECU is controlling the device.
Next topic
Previous topic
To patch an ECU:
1. Ensure that you have the correct Dataset for the ECU open in AutoCal.
Note: When you start patching, the complete Dataset will be sent from AutoCal to the ECU before you
make any on-line changes to individual parameters. This means that you may want to read the
Dataset from the ECU before you start patching to ensure there are no other changes before you
start editing the values of individual parameters.
2. Right-click on the Dataset in the Navigator to pop up a menu, and choose Start Patching - the
command will change to Stop Patching - Currently Patching to show that patching is in
65 / 107
AutoCal
progress.
The Patching Indicator will be displayed in the Windows® Task Bar system tray while you are in
patching mode:
Note also that the CAN Connection Indicator will be green to show that there is a current CAN
connection.
3. Edit the Dataset as required - see Creating and working with AutoCal data controls and the
topics following it.
4. Right-click on the Dataset in the Navigator to pop up a menu, and choose Stop Patching -
Currently Patching.
The Save changes to Dataset dialog box will be displayed:
5. Press Yes to confirm that you want to keep the changes you have made to the Dataset (in the
ECU and in the PC) since starting patching ; press No to revert the Dataset (in the ECU and in
the PC) to the parameter values it had when you started patching.
The Finished Patching dialog box will be displayed when the changes have been committed or
the Dataset has been reverted to its previous state.
Next topic
Previous topic
Created with the Personal Edition of HelpNDoc: Free EBook and documentation generator
Setting Data Source properties in AutoCal
This function has not been implemented in this release of AutoCal.

Next topic
Previous topic
Fonts
The Search Criteria dialog box has a number of pages (three for a disk search; two for a loaded Dataset
66 / 107
AutoCal
search), which enable you to specify the search conditions:

· The Location page allows you to specify the location of the Dataset files and the name and types of
the files (naturally, this is only relevant for disk searching).
· The Keywords page allows you to specify text that must appear in the Dataset comments for a
Dataset to be found.
· The Timestamps page allows you to specify the dates of the comments specified on the Keywords
page.
When the search is carried out, the results will show the Datasets satisfying all the conditions on all the
pages. The following topics describe each of the Search Criteria dialog box pages in turn.
Next topic
Previous topic
Created with the Personal Edition of HelpNDoc: Generate EPub eBooks with ease
Setting AutoCal control properties
As well as being able to change the position, size and shape of controls on the panel, you can customize
their appearance in many other ways. To do this you set the controlʼs properties.
Note: The following instructions do not apply to Compare controls.
To set a controlʼs properties:
Choose Properties... from the CtrlType Control Properties submenu in the Edit menu or the
menu displayed when you right-click on the control.
The CtrlType Control Properties dialog box will be displayed.
The CtrlType Control Properties dialog box has a number of different pages. Three of these pages are
common to many controls (though not all of the properties they contain can be applied to all controls) and
are described in General properties - controls. For details of properties specific to each of the different types
of control, see:
Control Click for details

2D-Graph
Analog Meter
Bar
Button
Edit
Indicator
Slider
Static Text
67 / 107
AutoCal
Thermometer
Command Button
Table
ParamView
Next topic
General properties
Previous topic
To set the rate at which the data is refreshed for periodic watching (see Periodic and state Watching) and/or
to mark or unmark a variable:
1. Right-click on the variable you want to modify to pop up a menu.
2. Choose Properties to pop up the Watch variable Properties dialog box (where Watch
variable is the name of the selected watch variable):
The example picture shows the appearance of the dialog box when a scalar variable is selected -
the Watch Rate box does not appear if a table variable is selected.
3. For a scalar variable, enter the refresh rate you require in the Watch Rate box.
4. Check Marked for Watching to mark the variable if you want to be able to include it amongst a
set of variables for which Watching can be switched on or off together.
5. Press OK to confirm the settings and close the dialog box.
Next topic
Previous topic
68 / 107
AutoCal
Created with the Personal Edition of HelpNDoc: Full-featured Kindle eBooks generator
To set the values of a selection of cells to the same value:

2. Choose Fill Selection from the Edit > Control submenu or the menu displayed when you right-
click in the table to display the Block Fill dialog box.
3. Enter the value to which you want to set the selected cells.
Next topic
Previous topic
See Setting control properties for how to display the Slider Control Properties dialog box and set those
properties on the General, Colors and Font pages that can be applied to Edit Controls.
The Slider Control Properties dialog box also has a Slider page:
To set the properties of a slider control:

1. Type the required number of graduations on the slider into the Graduations box. The maximum
allowable is 50.
2. Check Mouse Select if you want to be able to use the mouse to adjust the slider position.
69 / 107
AutoCal
3. Check Highlight if you want the slider control highlighted when it is selected - this will enable
you to see which slider will be adjusted by keyboard input.
Next topic
Editing the data using a Slider Control
Previous topic
Created with the Personal Edition of HelpNDoc: Easily create Help documents
General Toolbar
The General toolbar contains a collection of tools for carrying out file and document operations:
Menu command Action

File > Panel Create a new panel
File > Panel... Display the Open dialog box so that you can open a previously saved
panel
File > Save Save the selected panel to its existing file - display the Save As dialog
box if not previously saved
File > Design Mode Switch Design mode on or off - button depressed when Design mode
on
View > Show Grid Show/hide the grid on the panel
Edit > Cut Remove the selected control(s) and place it on the Windows ®
clipboard
Edit > Copy Copy the selected control(s) onto the Windows ® clipboard
Edit > Paste Paste the contents of the Windows ® clipboard onto the panel
File > Print Print the selected panel
Help > About Display the About dialog box showing information about the version of
ToolBench you are running
Context-sensitive Help is not implemented in this release of the
software
Next topic
Alignment Toolbox
Previous topic
Toolbars
70 / 107
AutoCal
To switch Watching on or off for an individual watch variable in a Channelset:

2. Choose Start Watching Parameter or Stop Watching Parameter.
To switch Watching on or off for all the watch variables in a user group:
1. Right-click on the user group icon to pop up a menu.
2. Choose Start Watching Group or Stop Watching Group.
To switch Watching on or off for all the marked variables in a group:
1. Right-click on the group icon to pop up a menu.
2. Choose Start Watching Marked in Group or Stop Watching Marked in Group.
To switch Watching on or off for all the watch variables in a Channelset:
2. Choose Start Watching All or Stop Watching All.
To switch Watching on or off for all the marked variables in the whole Channelset:
2. Choose Start Watching All Marked or Stop Watching All Marked.
Watched variables are shown with a red tick in the Navigator, whether marked or not To check if a watched
variable is also marked, right-click on it and see if the Marked for Watching command is checked, or look
at the variable properties.
Next topic
Logging the values of watched variables to a file
Previous topic
See Setting control properties for how to display the TablCtrl Control Properties dialog box.
None of the properties on the General, Colors and Font pages can be applied to Table Controls. However,
you can apply the properties on the Table Editor page:
71 / 107
AutoCal
To set the Table Control properties:

1. Check Display Name to show a title bar at the top of the Table Control showing the name of the
parameter shown in the table; uncheck it to hide the title bar.
2. Check Display Status to show a Status bar at the bottom of the Table Control; uncheck it to
hide the Status bar. The minimum and maximum values allowed for the parameter are shown at
the right-hand end of the Status bar - you may need to make the control wider to be able to see
these values.
3. Check Display Path to show the complete path to the parameter in the controlʼs title bar instead
of just the parameterʼs name - this has no effect if Display Name is unchecked.
4. Check Display Toolbar to display a toolbar containing the Axis configuration controls at the
top of the table editor control so that you can change the orientation of the table, and for a three
dimensional table, the point along the third axis, without opening this dialog box.
5. Check Automatic Op Pt to highlight the position in a control table at which the ECU is currently
operating.
6. Choose Decimal or Hexadecimal from the Number base drop-down list box to choose how to
display the data.
7. Choose whether to automatically select another cell when you press the ENTER key with a cell
selected, and if so which direction to move. This can greatly speed up data entry.
8. Use the Axis configuration to set the orientation of the table, and for a three dimensional table,
which Plane along the third axis to display - see the next topic for how to do this using the
equivalent Table Control toolbar controls.
Next topic
Viewing table data
Previous topic
Created with the Personal Edition of HelpNDoc: Generate Kindle eBooks with ease
See Setting control properties for how to display the Text Control Properties dialog box and set those
properties on the Colors and Font pages that can be applied to Static Text Control.
72 / 107
AutoCal
The General page in the Static Text Control Properties dialog box is different from that on other
Properties dialog boxes:
To enter the text displayed by the Static Text Control:

Type into the Text box.
Next topic
Previous topic
The Text Control
AutoCal runs in the Pi ToolBench Environment:

{bmc bm86.SHG}
Click on the different parts of the picture to find out what they are.
To display or hide a toolbar or the Navigator:
Choose the name of the toolbar or Navigator from the View menu.
The corresponding command is checked in the menu when a toolbar or Navigator is displayed.
The Navigator and all the toolbars can be docked against one of the edges of the ToolBench window - in the
picture the Navigator is docked against the left-hand edge of the window (this is the only position the
Navigator can be docked) and the General and Alignment toolbars are docked against the top edge (these
toolbars and the Controls toolbox can be docked against any edge; the Script Recorder toolbar, which is
not shown in the picture, can only be docked against the top or bottom edge).
The Navigator and all the toolbars can also be made to float so that they can be positioned anywhere on the
desktop - the Controls toolbox in the picture is floating.
To move the navigator or a toolbar:
1. Move the pointer over the edge of the Navigator or toolbar but avoiding the tools.
2. Drag the Navigator or toolbar to the required position.
73 / 107
AutoCal
You can drag a docked toolbar:

· along the window edge it is docked to
· to another window edge
· away from the window edges so that it floats.
You can drag the Navigator when it is docked:
· away from the window edges so that it floats.
You can drag the Navigator or a toolbar when it is floating:
· to any point on the desktop
· to a window edge to dock it there (double-clicking in the title bar of the floating Navigator or toolbar
also docks it).
You use the navigator and the tools on toolbars in exactly the same way whether they are floating or
docked.
For summary details for all the tools and menu commands, see Menus and Toolbars - summary.
Next topic
Previous topic
The Static Text Control
You can use the Static Text Control to place labels or comments on the panel - text controls are not linked
to data in Datasets.
You can create a Static Text Control using the Static Text Control button in the Controls
toolbox - see Creating and working with AutoCal data controls for full information about creating
controls and linking them to data in a Dataset.
Next topic
Previous topic
See Setting control properties for how to display the Thermometer Control Properties dialog box and set
those properties on the General, Colors and Font pages that can be applied to Thermometer Controls.
The Thermometer Control Properties dialog box also has a Thermometer page:
74 / 107
AutoCal
To set the number of divisions to be marked on the thermometer scale:

Enter the number in the Number of divisions box. You can enter from 0 through 100.
Next topic
Previous topic
Toolbars
AutoCal has three toolbars/toolboxes: General, Alignment and Controls.

See The AutoCal interface for general information about working with toolbars.
Next topic
General Toolbar
Previous topic
Item menu
The contents of the Item menu depend on what item is selected in the Navigator - it has the same contents
as the corresponding Navigator pop-up menu.
Next topic
Window
75 / 107
AutoCal
Previous topic
Layout
User setups
This section of the Help system describes:

Panels
Workspaces
Next topic
Panels
Previous topic
User-defined groups
In addition to the groups defined in the Metafile, the Navigator shows five user-defined groups. You can use
these to group together sets of parameters that you want to get to quickly without having to navigate the
hierarchy defined in the Metafile.
Note: The user-defined groups are provided for convenience when you are using AutoCal. Placing a
parameter in a group gives you another way of accessing that parameter - the parameters in user-
defined groups are just shortcuts or references to the original parameters not a new copy that you
can change independently. Adding and using parameters in user-defined groups has no effect on the
way data is downloaded to an ECU.
To add a parameter to a user-defined group:
1. Display the parameter in the Navigator by opening the relevant groups.
2. Drag the parameter and drop it onto the user-defined group.
3. A menu will be displayed allowing you to choose whether to add a 'reference' to the parameter or
cancel the operation.
Note: As you drag the parameter, the pointer has a short-cut icon attached to it to show that you are just
creating another way of accessing the parameter and not changing the structure of the Dataset.
To add all the parameters in a group, another user-defined group, or the complete dataset to a user-defined
group:
1. Drag the group or the dataset onto or into the user-defined group.
2. A menu will be displayed allowing you to choose, when appropriate:
Add Reference - to add references to all the parameters within the group (or dataset) and
within any subgroups within the group (or dataset).
Copy - (not available if you are dragging the dataset) to set the values of the parameters
referred to in the target user-defined group to the values of the parameters in the source group
(see Matching conditions for copy operations for the conditions that must be satisfied if a copy
76 / 107
AutoCal
operation is to succeed).
Cancel Operation.
To copy the structure of a user defined group from one Dataset to another:
1. Drag the source user-defined group onto the target user-defined group.
2. A menu will be displayed.
3. Choose Add Reference.
The parameters in the source user-defined group will be added to the target user-defined group (provided
they appear in the target Dataset), but the values of the parameters will not be changed. This means that
once you have set up the user-defined groups in one Dataset, you can use this technique to copy their
structure (the list of parameters they contain) to other similar Datasets and do not need to build them again
from scratch.
Note: The menu also has Copy and Copy by tag commands: see Copying data - Mix and Match for more
information about these commands.
To remove a parameter from a user-defined group:

1. Right-click on the parameter in the user-defined group to pop up a menu.
2. Choose Remove.
To empty a user-defined group:

1. Right-click on the group in the Navigator to pop up a menu.
2. Choose Remove All.
To change the name of a user-defined group:

1. Right-click on the group in the Navigator to pop up a menu.
2. Choose Properties to display the User defined Properties dialog box:
3. Edit the name shown in the Group Name box.

4. Press OK to close the dialog box and set the new name.
Note: The names and contents of any user-defined groups are saved with the Dataset when you save it.
Next topic
Previous topic
77 / 107
AutoCal
Accessing data
AutoCal provides a range of instrument controls for viewing data. These ‘Virtual Instrumentsʼ include:
Analog Meters
Bars
Thermometers
Indicators
You can create these controls using the appropriate control button in the Controls toolbox - see Creating
and working with AutoCal data controls for full information about creating controls and linking them to data in
a Dataset.
The following picture shows in the first column an Analog Meter, a Bar, and an Indicator, a Chart Recorder in
the center and a Thermometer on the right-hand side:
Next topic
Previous topic
Editing data using a Slider Control
Created with the Personal Edition of HelpNDoc: Easily create EBooks
2-D Graph Controls allow you to view and edit data in one- and two-dimensional tables.
You can create a 2-D Graph Control using the 2dgraph Control button in the Controls toolbox -
see Creating and working with AutoCal data controls for full information about creating controls
78 / 107
AutoCal
and linking them to data in a Dataset.

Next topic
Previous topic
The Button control is an On/Off control with latching and non-latching options.
You can create a Button Control using the Button Control button in the Controls toolbox - see
Creating and working with AutoCal data controls for full information about creating controls and
linking them to data in a Dataset.
Note: When a button is used to turn a parameter on (off), it sets the parameter to the maximum (minimum)
value set for the parameter in the Metafile. This means that turning a parameter on and then off (or
vice versa) does not reset it to its original value if it was not initially at the minimum (maximum)
value.
Next topic
Previous topic
Edit Controls allow you to view and edit scalar (single value) parameters (you can link a table to an Edit
Control, but this only allows you to edit the first cell in the table).
You can create an Edit Control using the Edit Control button in the Controls toolbox - see
Next topic
Previous topic
79 / 107
AutoCal
The ParamView control gives a quick way of viewing the contents of items in the Dataset. In particular, it
shows the type of data and any comments added to the script Metafile to help you choose the most
suitable controls for viewing and editing parameters.
You can create a Parameter Viewer control using the ParamView button in the Controls
toolbox - see Creating and working with AutoCal data controls for full information about creating
controls and linking them to data in a Dataset.
Next topic
Previous topic
This topic shows you how to create a sample Dataset using the Pi Metafile Compiler. Many of the
instructions in this Help system use this sample Dataset to illustrate AutoCalʼs functionality.
Note: The Pi Metafile Compiler is a separate program supplied with Pi ToolBench.
The sample Dataset is in the form of a script Metafile with an .smf extension. Before you can open the
sample Dataset in AutoCal, you need to compile the script Metafile to create a binary Metafile file, which will
be saved with a .met extension.
To compile and save a Metafile:
1. Launch the Pi Metafile Compiler.
2. Choose Open Sample from the File menu. The Sample.smf Metafile will be displayed in a
window.
3. Choose Compile from the File menu to display the Output window, followed by the Save As
dialog box.
4. Use the Save As dialog box to select a folder and enter a name for the compiled file - see the
A message in the Output window will confirm that the file has been saved.
6. Choose Exit from the File menu to close the Pi Metafile Compiler.
You will now be able to open, view and edit the sample Dataset in AutoCal.
Note: You can also use the Pi Metafile Compiler to create, view and edit Channelset metafiles.
Next topic
Previous topic
Overview
80 / 107
AutoCal
Slider Controls allow you to view and edit scalar (single value) parameters (you can link a table to a Slider
Control, but this only allows you to edit the first cell in the table).
You can create a Slider Control using the Slider Control button in the Controls toolbox - see
Next topic
Previous topic
You can use a Table Control to view and edit scalar or table parameters.
Note: You can also use a Table Editor to view and edit table data.
You can create a Table Control using the TablCtrl button in the Controls toolbox - see Creating
and working with AutoCal data controls for full information about creating controls and linking
them to data in a Dataset.
Next topic
Previous topic
As an alternative to displaying a table in a Table control, you can display it in a Table Editor. You can think
of a Table Editor as an extension of the ParamView control - just as you can rapidly view and change scalar
parameters in the ParamView control without having to create and set up other controls on a panel, a Table
Editor allows you to view and change table parameters without having to create and set up a Table Control.
To display a table in a Table Editor:
1. Display the table parameter in the ParamView control (see Using the Parameter Viewer Control
(ParamView)).
2. Double-click on the entry for the table.
Note: If you double-click on another table parameter in the same ParamView control, it will be displayed
in the same Table Editor; if you double-click on a table parameter in a different ParamView control,
it will be displayed in a new Table Editor.
81 / 107
AutoCal
The table will be displayed in a Table Editor:
A Table Editor is a free-floating window. You can move it and resize it in exactly the same way as other
windows.
When a Table Editor is displayed, you can display other tables in it by dragging the table from the Navigator
or a ParamView control into the Table Editor.
To close a Table Editor:
Click on the Table Editor windowʼs close button.
Or
Delete the ParamView control from which the Table Editor was created.
The table in a Table Editor is displayed the same way as in a Table Control, and you use the same
techniques for choosing the Axis Orientation, and (for tables with more than two dimensions) the displayed
axes and position along the undisplayed axes - see Viewing table data.
You can change the values of individual cells in the same way as in a Table Control (see Editing table data).
However, unlike in a Table Control, you cannot change the values of a block of cells at the same time.
Next topic
Previous topic
Created with the Personal Edition of HelpNDoc: Generate Kindle eBooks with ease
Version folders
When you open a Dataset in AutoCal it is placed in a folder within Calibration Manager. If you open two
Metafiles or Datasets with the same version number, they will both appear in the same version folder:
82 / 107
AutoCal
If you open another Metafile or Dataset with a new version number, it will appear in a new version folder
showing its version number:
Next topic
Previous topic
View
The View menu has the following commands:
Navigator Shows/hides the Navigator

Script Recorder Shows/hides the Script Recorder
General Toolbar Shows/hides the General toolbar
Status Bar Shows/hides the Status Bar
Controls Toolbox Shows/hides the Controls toolbox
Alignment Toolbox Shows/hides the Alignment toolbox
Show Grid Shows/hides the grid on the panel
Next topic
Layout
Previous topic
Edit
Viewing and editing the data - Edit Control
The Edit Control shows the value of the linked parameter with the precision selected on the General page in
the Edit Control Properties dialog box (Digits after DP).
83 / 107
AutoCal
To edit the value shown in an Edit Control:

1. Click in the control to place an editing caret. (Double-click to select the value if you want to
replace it completely.)
Note: To carry out this operation using the keyboard: press F6 to tab between the controls until the edit
control is selected, press the down or right arrow key to select the value and either type in a new
value or use the arrow keys to move an editing caret in the text to edit the existing value.
2. Edit the value, or enter a new value.
3. Press ENTER to finish editing the value.
If you try to enter a value greater than the maximum or less than the minimum value set for the parameter in
the Metafile, the value will be set to the maximum or minimum value, respectively.
You can use the default or User-defined Caption (see General properties) to show which parameter it is
linked to. However, even if you donʼt use a caption, you will be able to identify the linked parameter by
moving the pointer over the Edit Control: after a few seconds, a tool tip will be displayed showing the Edit
Controlʼs value and linked parameter:
This shows the Edit Control is linked to parameter C2.

Next topic
Previous topic
Viewing table data
Tables can have one, two or three dimensions.

Note: You can also view and edit scalars (single-value parameters) in a Table Control - they behave like a
one-dimensional table with a single cell.
As an example of a one-dimensional table, if you link the parameter Parameter A2 axis 1 from
Group2>Subgroup1 in the Sample file to a Table Control (see Using the Pi Metafile Compiler to create a
sample Dataset and Linking data to controls), you get:
As its name implies, the content of this table acts as one of the axes of another table - Parameter A2 in
Group 1:
84 / 107
AutoCal
Here the Parameter A2 axis 1 table sets the horizontal axis; the table Parameter A2 axis 2 sets the
vertical axis. The fact that the axes are themselves tables is shown by the axis labels being in black text
rather than gray.
When the axis of a table is itself a table, you can edit the axes. You could drag the axis table from the
Navigator onto a table control (as in the picture of the one-dimensional table), but AutoCal provides a
shortcut.
Note: You can only edit the axis for a table (for example axis 2 in Parameter A2) if the axis table (for
example Parameter A2 axis 2) appears independently in the AutoCal Data Manager so that you can
view and edit it in a Table Control. This means that the axis table must be included in the Metafileʼs
Display Tree.
To edit an axis table:
Double-click on the axis label. The Axis table will be displayed in the table control:
Note that the orientation of the axis is maintained - the vertical axis is shown vertically; the horizontal axis would be
shown horizontally.
You can now edit the values in the axis tables to change the scales. For example:
85 / 107
AutoCal
To display the original table again:
Click the arrow button near the top-left hand corner of the box (to the left of the Axis Orientation box).
For the example above, the two-dimensional table Parameter A2 table changes as follows:
Note: You can only edit the axis for a table (for example axis 2 in Parameter A2) if the axis table (for
example Parameter A2 axis 2) appears independently in the Navigator so that you can view and
edit it in a Table Control. This means that the axis table must be included in the Metafileʼs Display
Tree.
Next topic
Previous topic
Created with the Personal Edition of HelpNDoc: Write EPub books for the iPad
3.3.3 Viewing the comments in a Dataset found by a search
To view the comments in one of the Datasets found by a search:

2. Choose View Comments to display the Comments Preview dialog box:
86 / 107
AutoCal
3. Click on View comments that match the search criteria to view just the comments satisfying
the keyword and timestamp criteria; click on View all comments to view all the comments:
Next topic
Previous topic
87 / 107
AutoCal
Workbook
The Window menu has the following commands:
Cascade Rearranges the open non-minimized panels so that they overlap

with only the title bars and left-hand edges of lower panels showing
Tile Horizontally Rearranges the open non-minimized panels so that they do not
overlap, fill the document area and each panel is wider than it is tall
(landscape format)
Tile Vertically Rearranges the open non-minimized panels so that they do not
overlap, fill the document area and each panel is taller than it is wide
(portrait format)
Arrange Icons Rearranges the icons of minimized panels along the bottom edge of
the document area
Open panels The Window menu lists the names of the open panels - choose a
panel name from the list to select the panel (bring it to the front if it is
not minimized; restore it and bring it to the front if it is minimized)
Next topic
Help
Previous topic
Item
Using the Pi Metafile Compiler to create a sample Dataset showed you how to create a binary metafile
Dataset (.met) file from a script metafile (.smf) file. The metafile contains definitions of the data structures
and default parameter values. Typically, the software developers will only create a new metafile when they
produce a new version of the ECU software. You can think of the metafile as a template for producing
Datasets for the corresponding version of the ECU software; each of these Datasets contains the specific
parameter values for an individual ECU.
You can use AutoCal to create Datasets from a binary metafile, then edit the default parameter values in the
Dataset for use with a specific ECU and save the Dataset as a Dataset (.dat) file. You can also load
Datasets into AutoCal to view and edit the calibration parameters they contain.
Next topic
Opening a Dataset
Previous topic
Created with the Personal Edition of HelpNDoc: Free EPub producer
88 / 107
AutoCal
As an example, if you drag Group 2 from the Sample Dataset (created in Using the Pi Metafile Compiler to
create a sample Dataset), you will see:
Note that the 'path' to the item shown in the ParamView control is given at the top of the control.
The ParamView control shows that Group2 contains two sub-groups, SubGroup1 and SubGroup2
(subgroups are identified by the icon next to the name in the Name column and ParameterGroup in the
Type column) and a parameter table (parameters are identified by Parameter in the Type column; the fact
that it is a table is shown in the Value column).
The Description column shows a text description of the parameter entered with its definition in the Metafile.
If you open Group3 in the Navigator and drag BlockC into the ParamView control, you get:
All the parameters in BlockC are scalars (single values), whose value is shown in the Value column.
Next topic
Previous topic
The commands in the Align Controls and Centre in Panel submenus of the Layout menu allow you to
position the selected controls relative to each other or the panel, respectively.
To align two or more controls relative to each other:
1. Select the controls.
2. Choose the relevant command from the Align Controls submenu in the Layout menu or the
menu displayed when you right-click on one of the controls.
89 / 107
AutoCal
or
Press the relevant button in the Alignment toolbox:
For example: if you choose Align Controls>Left, all the selected controls will be aligned to the left-hand
edge of the leftmost selected control; if you choose Align Controls>Horizontal Centre, all the selected
controls will be aligned so that their horizontal centres coincide with the point half way between the left-hand
edge of the leftmost selected control and the right-hand edge of the rightmost selected control.
To align one or more controls relative to the panel:
2. Choose Horizontal or Vertical from the Centre in Panel submenu in the Layout menu or the
menu displayed when you right-click on one of the controls.
Note If you select a group of controls, they will be aligned to the panel as a group, not individually.
Next topic
Previous topic
Moving and resizing controls on a card
Created with the Personal Edition of HelpNDoc: Create HTML Help, DOC, PDF and print manuals from 1 single
source
Command Button properties
See Setting control properties for how to display the Command Button Control Properties dialog box and
set those properties on the General, Colors and Font pages that can be applied to Command Button
Controls.
The Command Button Control Properties dialog box also has a Verbs page:
The Select Verb drop-down list box lists the commands in the pop-up menu for the Navigator item linked to
the button - it is empty if the button is not linked to anything, or if the linked item has no pop-up menu.
To choose which command will be chosen by pressing the button:
Select it from the Select Verb drop-down list box.
Next topic
User setups
Previous topic
The Command Button control provides an alternative mechanism for running the commands in Navigator pop-up
menus.
90 / 107
AutoCal
Pressing a Command Button to carry out a command replaces the three steps of displaying the relevant item in
the Navigator, right-clicking on it to display the menu and then choosing the required menu item with a single step.
However, Command Buttons do take up space on a panel, so you would probably only want to use them for
frequently used commands or if you want to use panels without displaying the Navigator.
You can create a Command Button Control using the Command Button Control button in the
Controls toolbox - see Creating and working with AutoCal data controls for full information
about creating controls.
Unlike other controls, you can link other Navigator items within the Calibration Manager besides
parameters to a Command Button. For example, if you drag Calibration Manager itself on to a button, you
will be able to assign any of the Calibration Manager pop-up menu commands to the button.
Next topic
Previous topic
Design mode
You use AutoCalʼs design mode to create panels and to place move and resize the controls on the panels.
When you have finished designing the panels, you can turn Design mode off to lock the controls in place
while you use the panels to work with AutoCal.
To turn Design Mode on or off:
Choose Design Mode from the File menu.

Design Mode is checked in the File menu and the button shown as depressed when it is selected.
Next topic
Working with a grid
Previous topic
Working with a grid
When a panel is In Design mode, you can display a grid on the panel and choose to make controls snap to
the grid when you place them on the panel.
To display or hide a grid on a panel:
1 Click in the panel to select it.
2 Choose Show Grid from the View menu.

To set the spacing of the points in a grid:
91 / 107
AutoCal
1 Right-click in the panel to select it and pop up a menu.

2 Choose Change Grid Spacing from the menu to display the Change Grid Spacing dialog
box.
3 Set the vertical (Y) and horizontal (X) spacing of the grid points.
4 Press OK to close the dialog box.
To choose whether to make controls snap to the grid when you place them on the panel:
1 Right-click in the panel to select it and pop up a menu.
2 Choose Snap To Grid from the menu.
Next topic
Workspaces
Previous topic
Design Mode
Created with the Personal Edition of HelpNDoc: Full-featured Kindle eBooks generator
AutoCal allows you to record the results from watched variables in a log file. For efficiency, the data is
recorded in a special format, which you can convert to a readable format using the LogFileProcessor utility
supplied with AutoCal.
If logging is turned on for a watched variable in a Channelset, each time the value is updated, the ECU time,
variable name and variable value will be recorded in the log file.
To switch logging on or off for all the watched variables in a Channelset:
2. Choose Start Logging All or Stop Logging All.
To switch logging on or off for all the watched variables in a group:
1. Right-click on the group icon to pop up a menu.
2. Choose Start Logging Group or Stop Logging Group.
To switch logging on or off for an individual watched variable in a Channelset:
2. Choose Start Logging Parameter or Stop Logging Parameter.
Note 1 A new log file will be created when you start logging.
Note 2 The log file will only log data for variables that are watched when the Start Logging command is
chosen - you can start watching other variables after logging has been started, but their results will
not be recorded.
Note 3 You can use Stop Logging All to stop all logging even if you were only logging an individual
parameter or group of parameters. On the other hand, if you are logging all parameters or a group of
parameters, you cannot use Stop Logging Parameter to switch off logging for just an individual
parameter. Similarly, if you are logging all parameters, you cannot use Stop Logging Group to
switch off logging for an individual group of parameters.
As well as automatically recording the values of watched variables as they are updated, you can insert a
manual mark in the log file.
92 / 107
AutoCal
To add a manual mark at the current point in the log file:

2. Choose User Event.
Note The time of a user event is not recorded explicitly but can be determined approximately from the
times of the watched variable results recorded in the log file immediately before it and after it.
Next topic
Converting a log file to a readable format
Previous topic
Converting a log file to a readable format
For efficiency, the log file is recorded in a binary format, so you will need to use convert it to another format
to read it.
To convert the log file to a readable format:
1. Start the LogFileProcessor utility (LogFileProcessor.exe):
2. Press Open File to display a standard Windows® Open dialog box.

3. Use the Open dialog box to select the required (*.AClog) log file.
93 / 107
AutoCal
The File Contents box will show a preview of the log data.
4. Press Text File to save the log data in a plain text file.
Press Excel File to save the log data in a tab separated values format suitable for loading into a
spreadsheet.
5. Press Close File to close the log file.
6 Repeat Steps 2-5 for any other log files you want to convert.
Next topic
Previous topic
General Properties
See Setting control properties for how to open the Properties dialog box for a control.
Note: Some of the properties on the General page do not apply to some controls.
The following paragraphs describe the settings you can make on the General page.
User-defined Caption
Check User-defined Caption to use the text in the Caption text box as a caption on the control; uncheck
it to use the parameterʼs name/source. This setting only has an effect on the control if Display Data Name
is also checked.
Caption
This is enabled when User-defined Caption is checked. Enter text in the Caption box to use as a caption
on the control instead of the parameterʼs name/source - it will only be displayed on the control if Display
Data Name is also checked.
Display Data Name
94 / 107
AutoCal
Check or uncheck Display Data Name to show or hide the Caption (if User-defined Caption is checked)
or the parameterʼs name/source (if User-defined Caption is not checked) on the control.
Display Units
This function is not implemented in this release of the software.
Display Value
Check Display Value to show the parameterʼs value on the control.
Auto-format Display
Check Auto-format Display to let AutoCal define the number of digits before and after the decimal point
automatically.
Digits after DP
When Auto-format Display is not checked, enter the number of digits to appear after the decimal point - if
necessary the display will be padded with trailing 0s.
Digits before DP
When Auto-format Display is not checked, enter the number of digits to appear before the decimal point - if
necessary the display will be padded with leading 0s.
Auto-range Values
For 2-D and 3-D Graph controls, check Auto-range Values to allow AutoCal to choose the most
appropriate minimum and maximum values.
Minimum Value
When Auto-range Values is not checked, enter the minimum value of the control into the Minimum Value
box.
Maximum Value
When Auto-range Values is not checked, enter the maximum value of the control into the Maximum
Value box.
Next topic
Colors
Previous topic
AutoCal allows you to save snapshots showing the values of individual parameters, parameter groups or the
complete Dataset.
The Snapshot command appears on the Item menu when any of the following items are selected in the
Navigator (and in the menus displayed when you right-click on the item in the Navigator):
· a Dataset
· a parameter group (but not a user-defined group)
95 / 107
AutoCal
· a parameter
When you choose the command for any of these items, the Snapshot Active dialog box will be displayed:
Enter any comments you want to document the snapshot.

The snapshots are saved in comma separated value format in the Datasetʼs folder with a file name with the
following structure:
dataset_date_time.csv
where:
· dataset is the file name of the Dataset (without the .dat extension),
· date is the current year, month and day in numbers without any punctuation separating them, and
· time is the current hour, minute and second in numbers without any punctuation separating them.
Note that this means that sorting the files alphabetically will also sort them chronologically for each Dataset.
The snapshot file will contain a record of the Dataset file path and name, the date and time it was saved, the
comments from the Snapshot Active dialog box, followed by the parameter values.
Next topic
Previous topic
Applying constraints to parameters in a Dataset
You can define maximum and minimum values for parameters in a Dataset in its Metafile. However, you can
also define and impose much more complex and powerful constraints. For example, you could require that
the values in a table are strictly increasing as you go down the table. To define the constraint, you include
Visual Basic code in the metafile - this gives you the freedom to define virtually any constraints you like.
You can then impose the constraints on the Dataset in AutoCal. You can choose to check that all the
constraints in a Dataset are satisfied, or just those that affect a specific parameter. You can also choose to
make AutoCal automatically check that any changes you make to parameters satisfy any constraints.
Note: The definition of constraints is beyond the scope of this manual. The constraints feature is provided
to allow users to access their own code within the Metafile. Responsibility for the correctness and
use of this code remains entirely with the user, so Pi Technology cannot provide any support for the
use of the constraint functions in AutoCal.
To choose whether AutoCal should automatically maintain any constraints defined for a Dataset:
1. Right-click on the Dataset in the AutoCal Data manager to pop up a menu.
2. Choose Auto Constrain.
96 / 107
AutoCal
Auto Constrain is checked in the menu when constraints are automatically maintained. Auto Constrain is
on by default.
When Auto Constrain is in force, if you try to change a parameter in a way that violates a constraint, a
dialog box will be displayed warning you and the parameter value will be left unchanged - there is a check
box in the dialog box allowing you to turn further warnings off.
Note: When you switch Auto Constrain on, AutoCal does not check that all constraints are currently
satisfied. If, while Auto Constrain is on, you try to edit a value that violates a constraint, AutoCal will
let you change it to a value that satisfies all constraints, but if you try to change it to another value
that also violates a constraint, AutoCal will leave the original (constraint violating) value unchanged.
You can check whether the Dataset or an individual parameter satisfies the constraints. (You may want to
do this if Auto Constrain is not selected, or if it is selected but you think some parameters violated
constraints before it was selected.)
To check whether all the parameters in a Dataset satisfy any constraints:
1. Right-click on the Dataset in the AutoCal Data manager to pop up a menu.
2. Choose Run Constraints on Dataset.
If a parameter violates a constraint, a dialog box will be displayed:
The dialog box shows the parameter that violated a constraint and an error message that is defined in the
Metafile with the constraint definition.
Press:
Abort to stop checking the constraints on any remaining parameters
Retry to apply the constraint again
Ignore to continue checking the constraints on any remaining parameters.
If you press Ignore, and a further violation of a constraint is found, the dialog box will be redisplayed
appropriately. When all checks are complete, a dialog box will be displayed showing a summary of the
constraint violations found:
To check whether a parameter satisfies any constraints defined for it:

1. Right-click on the parameter in the AutoCal Data manager to pop up a menu.
2. Choose Run Constraint.
If the parameter violates a constraint, a dialog box will be displayed, as above.
Next topic
97 / 107
AutoCal

Previous topic
The Navigator shows if there are any parameters in a Dataset linked to a panel control by giving the Dataset icon a
background. The Navigator also shows if any parameter has been changed since the Dataset was last saved by
an asterisk (*) Dataset icon and the Datasetʼs name - the changed parameters are marked in the same way:
In this example, Parameter A1 has been linked to a control (hence the background to the Dataset icon), and has
been changed (hence the asterisks in front of Sample.dat and Parameter A1).
Next topic
Version folders
Previous topic
Opening a Dataset
The Data Manager shows when a parameter has been changed sine the Dataset was last saved by
displaying an asterisk between the parameter and its icon:
In this example Parameter A1 has been changed.

To revert the value of a parameter back to its last saved value:
1. Right-click on the parameter in the Navigator to select it and pop up a menu.
2. Choose Revert from the pop-up menu.
Next topic
98 / 107
AutoCal
Previous topic
You can display the value of a watch variable by linking it to a control on a panel in the same way as you link a
Dataset parameter to a control by dragging it from the Navigator onto the control.
When you link a watch variable to a control watching for that variable is started automatically. If you delete a control
linked to watch variable (and the variable is not linked to any other controls), watching for that variable will be
switched off automatically and the variable unmarked for watching. See later topics in this section for more
information about marking variables for watching and for other ways to turn variable watching on and off.
Next topic
Periodic and state watching

Previous topic
To specify the units to be used for a parameter:

1. Right-click on the parameter in the Navigator to select it and pop up a menu.
2. Choose Select Units from the pop-up menu to display the Select Units dialog box - this lists all
the units defined for the parameter by conversion factors in the Metafile.
3. Click on the unit you want to use to select it.
4. Click on OK to confirm your selection and close the dialog box.
The selected unit will be used to display the value of the parameter in all new and existing controls to which
it is linked.
Next topic
Previous topic
Regrading a Dataset
When you select the Copy and Copy by tag commands to copy parameter values within a Dataset or from
one Dataset to another, AutoCal checks that the source and target parameters 'match', and no data is
copied if any of the matches fail.
Two parameters match if they have:
99 / 107
AutoCal
· the same size and shape

· the same units (the string comparison is case-sensitive)
· compatible ranges. This means that the source range must be the same as or lie within the target
range. For example, a parameter with a range of 15-80 can be copied onto a target with a range of 10-
90, but not vice-versa. (Note that the comparison is performed in engineering units.)
· for tables, any axis parameters must also match between the source and target.
Also, when a group is copied on to a group, the structure of the source and target groups must match.
Next topic
Previous topic
Comparing Datasets
You can use a Compare Control to compare two Datasets, parameter groups or parameters (the parameter
groups and parameters may be in the same or different Datasets). The control can be used to compare the
parameter structures or values, and when comparing different Datasets, whether corresponding parameters
(parameters with the same tagname) exist in the two Datasets.
You can create a Compare Control using the Compare button on the AutoCal page of the Controls
toolbar - see Creating and working with AutoCal data controls for full information about creating
controls.
When you first create a Compare Control it will look something like this:
The Compare control has two panes displayed side-by-side - these will display the Datasets or groups being
compared. The Compare control also has a toolbar allowing you to control the way it behaves - see Compare
control toolb ar for a summary.
The following topics show you how to use the compare control:

100 / 107
AutoCal

Next topic
Previous topic
Workspaces
To compare two Datasets, parameter groups or parameters:

1. Drag the first Dataset, group or parameter from the AutoCal Data Manager and drop it into the
left-hand pane in the Compare control.
Any existing Dataset, group or parameter in the left-hand pane will be replaced and any existing
Dataset, group or parameter in the right-hand pane will be removed.
Note: If you do not want to remove the contents of the right-hand pane, press the Shift key while you drag
and drop the Dataset, group or parameter into the left-hand pane.
2. Drag the second Dataset, group or parameter from the AutoCal Data Manager and drop it into the
right-hand pane of the Compare Control. Any existing Dataset, group or parameter in the right-
hand pane will be replaced.
Note: If you press the Shift key while you drag and drop the Dataset, group or parameter into the right-hand
pane, the contents of the left-hand pane will be removed.
The panes will be labeled with the names of the Datasets, groups or parameters and will display the comparison -
see the following topics for how to choose what features to compare and what information to display.
Next topic
Previous topic
Comparing Datasets
You can choose how parameters in different Datasets should be paired for comparison and whether to compare
the parameter values or their structure.
Note: This release of the Compare Control does not support the comparison of tables with more than two
dimensions.
To choose how parameters should be paired for comparison, either:
101 / 107
AutoCal
Press the Compare by Tag button to compare parameters in different Datasets according to their
tagnames.
or:
Press the Compare by Order button to compare the parameters in the Datasets or groups
according to their order in the Dataset display trees. For example, if you are comparing group A
in the left-hand pane with group B in the right-hand pane, the first parameter in group A will be
compared with the first parameter in group B, without any reference to their tagnames.
Note 1: Since tagnames are unique within a Dataset, the Compare by Tag button is disabled unless you are
comparing parameters from different Datasets.
Note 2: When you make a comparison by tag AutoCal attempts to pair each of the parameters in the group
or Dataset dropped into the left-hand pane with a parameter in the Dataset dropped in the right-hand
pane or, if you dropped a parameter or group into the right-hand pane, the Dataset containing the
group or parameter.
To choose what features to compare, either:
Press the Compare Values button to compare the values of the parameters.
or:
Press the Compare Structure button to compare the structures of the parameters - the column
headings in the comparison panes shows the structural features compared.
See Viewing the results of a comparison for examples.
Next topic
Previous topic
You can choose whether to display:

· Everything - displays all parameters in both panes
· Differences only - displays only those parameters that have been paired and differ in value or structure
(depending on what has been compared)
· Same only - displays only those parameters that have been paired and have the same value or
structure (depending on what has been compared)
· Additions only - displays only the parameters in the Dataset or group dropped into the left-hand pane
that cannot be paired with parameters in the Dataset or group dropped into the right-hand pane (the
right-hand pane will always be blank for this option)
· Removed only - displays only the parameters in the Dataset or group dropped into the right-hand pane
that cannot be paired with parameters in the Dataset or group dropped into the left-hand pane (the left-
hand pane will always be blank for this option).
To choose which comparisons to display:
Select the required option from the View Filter drop-down list box in the Compare control toolbar.
See the next topic for examples.
102 / 107
AutoCal
Next topic
Previous topic
Created with the Personal Edition of HelpNDoc: Free CHM Help documentation generator
After you have performed a comparison, the results are shown in the Comparison control according to the display
options selected.
For example:
In this example, the parameters are paired by tagnames, the comparison is made on the data values, and
Everything is displayed.
Parameters with differences are shown with a gray background and the differences highlighted in red. Added
parameters (parameters in the right-hand pane but not the left-hand pane) are highlighted in blue and removed
parameters (parameters in the left-hand pane but not the right-hand pane) are highlighted in green.
Note: Although the comparison in this example is made on parameter values, added and removed
parameters and differences in Name (Parameter B3 and Parameter B4 in the example have the
same tagname but different Names) and Units (for example, Parameter D3) are also shown with a
gray background.
See the following pop-up topics to see what happens to this example when you choose other display options:
Differences only
Additions only
103 / 107
AutoCal
Removed only
Comparing parameter structures (with Differences only displayed):
Next topic
Previous topic
When you make a value comparison, the Value column in the Compare control shows the values of scalar
parameters but only the word Table for table parameters.
To view the value differences in a table parameter:
Click in the Value column for the table parameter (it will show the word Table). A table viewer
will be displayed:
Cells where there are differences are shown with a gray background and the values of the parameter in the other
pane (the pane you did not click in to display the viewer) are shown in red and in parentheses.
To invert the axes in the table display:
Press the invert axes button in the displayʼs toolbar. The display will show the table with the
axes swapped around:
To copy the contents of the table display to the clipboard:
Press the copy button in the displayʼs toolbar. You can then paste the contents of the table
104 / 107
AutoCal
display into documents in a spreadsheet, word processor or other application.

Next topic
Previous topic
For efficiency, the Compare Control does not automatically update when the parameters in the Dataset(s) being
compared are changed. However, if a parameter in a compared Dataset is changed, the Refresh button in the
Compare control toolbar is enabled.
To update the comparison in a Compare Control:
Press the Refresh button.

Note: When you save a Workspace that has a Compare control on a panel the contents and display
options selected for the control are saved: when you reopen the Workspace the comparison will be
refreshed automatically.
Next topic
Previous topic
To save a log of the comparison in a Compare control:

{bmc bm119.WMF} 1. Press the Save Comparison button to display the Produce Difference
dialog box:
2. Select an option from the Filter drop-down list box to choose which parameters to include in the
log.
You can select from the same options (and with the same meaning) as in the Compare control
itself - the option selected in the Compare control sets the initial selection for the Filter, but this
105 / 107
AutoCal
can be overridden by selecting a different option.

3. Click on the Summary or Detailed radio button to choose how much information to include for
each parameter:
· A Summary log shows for each included parameter whether it is different or the same in
both Datasets or groups or whether it has been added or removed.
· A Detailed log also shows the values or structures (and changes if any) of the included
parameters.
4. Check Preview log before saving to display a preview of the log when you press OK.
5. Press OK:
If you selected Preview log before saving, a preview will be displayed for example:
Press Save if you want to save the log; press Cancel if you want to close the preview without
saving the log.
If you did not select Preview log before saving, or if you did and pressed Save, a standard
Windows Save As dialog box will be displayed.
6. Use the Save As dialog box to select a folder and enter a name for the log file, and press Save
to save it.
The log file is a plain text file, which you can open in a word processor or other text editor.
Next topic
Previous topic
106 / 107
AutoCal
Tool Action
View Filter Chooses whether to show all parameters, or only those that are the same,
different, added, or removed
Compare Values Compares the values of corresponding parameters in the comparison panes
Compare Structure Compares the structure of corresponding parameters in the comparison

panes
Compare by Tag Chooses the parameters for comparison in different Datasets according to
their tags (names)
Compare by Order Chooses the parameters for comparison in the Datasets or groups according
to their order in the Dataset display tree
Previous/Next These functions are not implemented in this release of the software
Comparison
Save Comparison Displays a dialog box so that you can save a log of the comparison - you can
choose the amount of detail to save and then, in a separate dialog box, the fil
to be used to save the log
Refresh Comparison Perform the comparison again if you have changed the value of any
parameters in the compared Dataset(s)
Next topic
Previous topic
Removed only
Created with the Personal Edition of HelpNDoc: Benefits of a Help Authoring Tool
Removed only
Removed only
Created with the Personal Edition of HelpNDoc: Full-featured Help generator
Removed only
107 / 107

Detroit Diesel Auto Cal Tool Manual 2

Caricato da

Informazioni sul documento

Titolo originale

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

Detroit Diesel Auto Cal Tool Manual 2

Caricato da

Copyright:

Formati disponibili

AutoCal

2-D Graph Control Chart Recorder properties ....................................................... 5

Using Virtual Instrument Controls to view data .................................................... 78

2-D Graph Control Chart Recorder properties

2-D Graph Control Graph properties

To set Graph options for a 2-D Graph Control:

2-D Graph Control properties

Key Selected Action

Left arrow Open group Close the group

Adding a fixed amount to the values of a selection of cells

Analog Meter Control properties

To set the Analog Meter Control Properties:

Navigator pop-up menus

Remove Results Clears all found Datasets from Search Results

Found Dataset in Search Results

User-defined group in Dataset

Parameter group in Dataset (not user-defined group)

Parameter in user-defined group in Dataset

Parameter in Channelset (but not in user-defined group)

User-defined group in Channelset

Remove All Removes all the contents of the user-defined group

Parameter in user-defined group in Channelset

To open a previously saved Workspace:

Bar Control properties

Created with the Personal Edition of HelpNDoc: Full-featured Help generator

Button Control properties

To specify the type of button:

When you create Controls in AutoCal you place them on a panel.

Carrying out a search

To carry out a search:

Changing the orientation of a table

To change the orientation of a table:

or for a two dimensional table like Parameter A2 to change:

Channelset user-defined groups

To add a watch variable to a Channelset user-defined group:

To remove a watch variable from a Channelset user-defined group:

3. Edit the name shown in the Group Name box.

Channelsets - monitoring variables in the ECU

Choosing what to display in a table with three dimensions

Parameter B3 in Group1>>Group1b is an example of a table with three axes:

To set the color of a component of the control:

the System Color drop-down list.

Transferring data between AutoCal and the ECU

Editing data using the 2-D Graph Control

Choosing which comparisons to display

Viewing the results of a comparison

Transferring data between AutoCal and the ECU

Created with the Personal Edition of HelpNDoc: Free EPub producer

The Controls toolbar contains tools for placing controls on panels:

Control View Data Edit Data Click for details

2D-Graph Yes Yes

Analog Meter Yes No

Edit Yes Yes

Slider Yes Yes

Table Yes Yes

ParamView Yes Yes

Created with the Personal Edition of HelpNDoc: Full-featured EPub generator

Copying data - Mix and Match

Target (same Dataset)

Target (different Dataset)

Group Copy by tag Copy Copy ---

Copying the value of a watched variable to a Dataset

To copy the value of a watched variable to the corresponding parameter in a Dataset: