DriveWare

User's Manual

DriveDebug

DriveDebug

User's Manual

DriveWare
Code: 3AFE 64289918 Rev O

EFFECTIVE: 01.03.2005
SUPERSEDES: 31.05.2002

2002-2005 ABB Oy. All rights reserved.

Table of Contents

Table of Contents................................................................................................................................................v
Chapter 1 - General..........................................................................................................................................1-1
General Information .................................................................................................................................1-1
Chapter 2 Installation of DriveDebug..........................................................................................................2-1
Installing DriveDebug Software ...............................................................................................................2-1
Installing DriveDebug Hardware..............................................................................................................2-1
Installing the DDCS PCMCIA Card ...............................................................................................2-2
Installing the DDCS ISA Board......................................................................................................2-2
Installing the PCI / PCMCIA adapter .............................................................................................2-2
Chapter 3 - Use of DriveDebug .......................................................................................................................3-1
Starting the DriveDebug Program ...........................................................................................................3-1
Screen Layout..........................................................................................................................................3-1
Targets.....................................................................................................................................................3-2
Target List Window ..................................................................................................................................3-3
Colors in the Target List ................................................................................................................3-3
Monitoring (Numerical Display) ...............................................................................................................3-3
Application Variables .....................................................................................................................3-5
Pin Connections ............................................................................................................................3-6
Recording Numeric Values to a File ........................................................................................................3-6
Trending (Graphical Display)...................................................................................................................3-7
Trend Buffer...................................................................................................................................3-9
Speed and Torque Steps ............................................................................................................3-10
Trend Save ..................................................................................................................................3-10
Control Panel .........................................................................................................................................3-11
Target's Status.............................................................................................................................3-11
Parameter Window ................................................................................................................................3-12
Backup and Restore of Parameters ............................................................................................3-12
Fault Logger Window.............................................................................................................................3-12
Data Logger Window .............................................................................................................................3-13
Data Logger Monitor....................................................................................................................3-14
Macros ...................................................................................................................................................3-15
Write the Macro into an Empty Macro Window ...........................................................................3-16
Convert a Saved Monitor Window Data into a Macro .................................................................3-17
Macro Execution Window............................................................................................................3-17
Definition Files .......................................................................................................................................3-19
Help........................................................................................................................................................3-19
Exit .........................................................................................................................................................3-19
Chapter 4 - File Menu.......................................................................................................................................4-1
Save Current Window As.........................................................................................................................4-1
Print Current Window...............................................................................................................................4-1
Display Trend Text File............................................................................................................................4-1
Display Recorder File ..............................................................................................................................4-1
Display DriveBDU File .............................................................................................................................4-1
Current Symbol File .................................................................................................................................4-2
Select Symbol File ...................................................................................................................................4-2
Current Appl Var File ...............................................................................................................................4-2
User's Manual

0-v

Table of Contents
Select Appl Var File .................................................................................................................................4-2
Exit ...........................................................................................................................................................4-2
Chapter 5 - Edit Menu ......................................................................................................................................5-1
Cut ...........................................................................................................................................................5-1
Copy.........................................................................................................................................................5-1
Paste........................................................................................................................................................5-1
Delete.......................................................................................................................................................5-1
Chapter 6 - Target Menu..................................................................................................................................6-1
Open Target List Window ........................................................................................................................6-1
Update Target List Window (with Names)...............................................................................................6-1
Change Default Target ............................................................................................................................6-1
Open Control Panel .................................................................................................................................6-1
Open Parameter Window ........................................................................................................................6-1
Open Fault Window .................................................................................................................................6-1
Data Logger Monitor ................................................................................................................................6-1
Backup .....................................................................................................................................................6-1
Restore ....................................................................................................................................................6-1
Enable Communication............................................................................................................................6-2
Disable Communication...........................................................................................................................6-2
Comm Statistics.......................................................................................................................................6-2
Start DriveBDU ........................................................................................................................................6-2
Chapter 7 - Config Menu .................................................................................................................................7-1
New Configuration ...................................................................................................................................7-1
Change Title ............................................................................................................................................7-1
Open Configuration..................................................................................................................................7-1
Save Configuration ..................................................................................................................................7-1
Chapter 8 - MonWin Menu...............................................................................................................................8-1
New Monitor Window...............................................................................................................................8-1
Change Window Title...............................................................................................................................8-1
Change Window Target ...........................................................................................................................8-1
Enable Monitoring....................................................................................................................................8-1
Disable Monitoring ...................................................................................................................................8-1
Open Monitor Window .............................................................................................................................8-1
Save Monitor Window..............................................................................................................................8-1
Add Symbol..............................................................................................................................................8-1
Add Abs Address .....................................................................................................................................8-1
Add Parameter.........................................................................................................................................8-2
Add Appl Variable ....................................................................................................................................8-2
Add Dataset Item .....................................................................................................................................8-2
Search/Update Symbols ..........................................................................................................................8-2
Remove Item............................................................................................................................................8-3
Change Display Mode .............................................................................................................................8-3
Define Comment......................................................................................................................................8-3
Define Pointer ..........................................................................................................................................8-3
Change Item Target.................................................................................................................................8-3
Set Item Value .........................................................................................................................................8-3
Undo Item Value Setting..........................................................................................................................8-3
Start/Stop Recorder .................................................................................................................................8-3
Change Line Layout.................................................................................................................................8-3
Chapter 9 AC80Win Menu ............................................................................................................................9-1
New AC80 Window..................................................................................................................................9-1

0 - vi

User's Manual

Table of Contents
Change Window Title...............................................................................................................................9-1
Open AC80 Window ................................................................................................................................9-1
Save AC80 Window.................................................................................................................................9-1
Add Symbol..............................................................................................................................................9-1
Add Abs Address .....................................................................................................................................9-1
Remove Item............................................................................................................................................9-1
Change Display Mode .............................................................................................................................9-1
Define Comment......................................................................................................................................9-1
Chapter 10 - TrendWin Menu ........................................................................................................................10-1
New Trend Window ...............................................................................................................................10-1
Change Window Title.............................................................................................................................10-1
Change Window Target .........................................................................................................................10-1
Open Trend Window..............................................................................................................................10-1
Save Trend Window ..............................................................................................................................10-1
Symbol ...................................................................................................................................................10-1
Abs Address ..........................................................................................................................................10-1
Parameter ..............................................................................................................................................10-1
Appl Variable .........................................................................................................................................10-2
Dataset Item...........................................................................................................................................10-2
Display Helper List.................................................................................................................................10-2
Change Num Display Mode...................................................................................................................10-2
Change Item Target...............................................................................................................................10-2
Set Item Value .......................................................................................................................................10-2
Undo Item Value Setting........................................................................................................................10-2
Change Sample Interval ........................................................................................................................10-3
Change Buffer Size................................................................................................................................10-3
Start/Stop Trending................................................................................................................................10-3
Set Trig Condition ..................................................................................................................................10-3
Clear Graph Area...................................................................................................................................10-3
Define Steps ..........................................................................................................................................10-3
Step........................................................................................................................................................10-3
Mouse and Keyboard Operations..........................................................................................................10-3
Vertical Scrolling and Scaling......................................................................................................10-3
Horizontal Scrolling and Scaling..................................................................................................10-4
Chapter 11 - MacroWin Menu........................................................................................................................11-1
New Macro Window...............................................................................................................................11-1
Open Macro ...........................................................................................................................................11-1
Save Macro............................................................................................................................................11-1
Save Macro As ......................................................................................................................................11-1
Execute Macro.......................................................................................................................................11-1
Execute Selected Lines .........................................................................................................................11-2
Chapter 12 - DLogWin Menu .........................................................................................................................12-1
New Data Logger Window.....................................................................................................................12-1
Change Window Title.............................................................................................................................12-1
Read Data Logger Info ..........................................................................................................................12-1
Initialize Data Logger .............................................................................................................................12-1
Data Logger Control ..............................................................................................................................12-1
Upload Data Logger Samples ...............................................................................................................12-1
Numeric Display of Samples .................................................................................................................12-1
Chapter 13 - Windows Menu.........................................................................................................................13-1
Tile .........................................................................................................................................................13-1
Cascade.................................................................................................................................................13-1

User's Manual

0 - vii

Table of Contents
Arrange Icons ........................................................................................................................................13-1
Close All.................................................................................................................................................13-1
Chapter 14 - Help Menu .................................................................................................................................14-1
Contents.................................................................................................................................................14-1
About DriveDebug .................................................................................................................................14-1
Chapter 15 - Appendices...............................................................................................................................15-1
Appendix 1......................................................................................................................................................15-1
Startup Parameters................................................................................................................................15-1
Table of Startup Parameters .......................................................................................................15-2
Appendix 2......................................................................................................................................................15-3
Special Comments.................................................................................................................................15-3
Value Type Interpretation ............................................................................................................15-3
Appendix 3......................................................................................................................................................15-4
AC80 and NCB ......................................................................................................................................15-4
Appendix 4......................................................................................................................................................15-5
Macro Language....................................................................................................................................15-5
Summary of Macro Statements...................................................................................................15-5
Assignment Statements ..............................................................................................................15-7
Decision Statements....................................................................................................................15-7
Loop Statements .........................................................................................................................15-7
Target Statement.........................................................................................................................15-7
Wait Statement ............................................................................................................................15-7
Dataset Statements .....................................................................................................................15-8
Macro Chaining Statement..........................................................................................................15-8
File and User Interface Statements.............................................................................................15-9
Data Logger Statements ...........................................................................................................15-13
Fault Logger Statements ...........................................................................................................15-13
Parameter List Statement..........................................................................................................15-14
User Function Statement...........................................................................................................15-14
Exit Statement ...........................................................................................................................15-14
Comment Statement..................................................................................................................15-14
Notes about the Macro Statements...........................................................................................15-15
Example.....................................................................................................................................15-16
Appendix 5....................................................................................................................................................15-17
Remote Operation ...............................................................................................................................15-17
Installation of the Server Program (DDsrvr.exe) .......................................................................15-17
Installation of the DriveDebug Program to a Remote PC .........................................................15-17
Some Differences between the Local and Remote Use ...........................................................15-18
Appendix 6....................................................................................................................................................15-19
Visual Basic Interface ..........................................................................................................................15-19

0 - viii

User's Manual

Chapter 1 - General
General
Information

DriveDebug is a Windows based diagnostic tool program for devices

that use the DDCS communication protocol. These devices include
e.g. ACS600, ACS800 and AC80.
DriveDebug is designed to run under the Microsoft Windows XP,
Windows 2000 or Windows NT 4.0 operating environment on IBMcompatible PCs.
The following functions can be performed by using DriveDebug:
display of the list of all connected targets with their statuses
graphical trending of actual values of user-selected parameters,
application variables, dataset items and/or memory locations (max
6 items in one window) from one or more targets.
Min sample time is from 1 msec (with 1 trend) to 6 msec (with 6
trends).
horizontal scrolling and scaling of the trend history (in addition to
the vertical scrolling and scaling of trends)
numerical monitoring of actual values of user-selected parameters,
application variables, dataset items and/or memory locations from
one or more targets in different formats
numerical recording of actual values of user-selected parameters,
appliaction variables, dataset items and/or memory locations (max
500 items) from one or more targets
setting of values of parameters, datasets and/or memory locations
of targets
backup and restore of targets parameters (complete or version
update)
backup and restore of the whole target software
control of targets data logger operation and display of the
collected sample values in graphical and numeric form
local control and status display of the selected target
upload, display, save and clear of targets fault logger
creation and execution of macros. A macro is an user-written
sequence of macro statements.
numerical monitoring of actual values of user-selected AC80
memory locations in different formats (if used with AC80)
saving/restoring the current DriveDebug configuration to/from a
disk file

User's Manual

1-1

General

saving/restoring the definitions of the selected window to/from disk

files
saving the data of the selected window to a file
start of the DriveBDU program
display of the files created by the DriveBDU program
remote operation

Other features related to DriveDebug:

possibility to create Visual Basic or C applications that use drive
data (e.g. parameters and datasets)
possibility to translate DriveDebug to other languages than English
by separate text files

1-2

User's Manual

Chapter 2 Installation of DriveDebug

The DriveDebug is designed to run under the Microsoft Windows XP,
Windows 2000 or Windows NT 4.0 operating environment on IBMcompatible PCs.
If you are using DDCS PCMCIA card and there are no PCMCIA slots
in your PC (and there is a free PCI slot), you must first install a PCI /
PCMCIA adapter.
Please follow the installation instructions of the PCI / PCMCIA
adapter (these instructions are in the Readme.txt file of the adapter).
Note: If you are using DDCS PCMCIA card, do not insert the
PCMCIA card before you have installed the DriveDebug software.

Installing
DriveDebug
Software

Note: You must have Administrator privileges to your PC.

Insert the DriveDebug CD-ROM into the CD drive of your PC.
Read file Readme.txt from the CD-ROM. It may contain additional
installation information.
Start the Control Panel program (Start -> Settings -> Control Panel)
and double click its Add/Remove Programs icon.
Click the Add New Programs button and follow the instructions that
appear on the screen (select file Setup.exe from the CD-ROM).
When the software installation is ready, you can add startup
parameters (normally no startup parameters are needed).
The startup parameters are described in Appendix 1.

Installing
DriveDebug
Hardware

User's Manual

DriveDebug can be used with DDCS PCMCIA(NDPA-02) cards or

with DDCS ISA(NISA-03) boards or with PCI / PCMCIA adapter and
DDCS PCMCIA card.
You cannot start using DDCS ISA(NISA-03) boards immediately after
installing DriveDebug under Windows 2000 and Windows XP. You
have to tell Windows their presence first (Add Hardware).

2-1

Installation of DriveDebug

Installing the
DDCS PCMCIA
Card

Insert the DDCS card into a vacant PCMCIA slot of the PC.
Connect optical cables between the PCMCIA card and the target
device(s) or between the PCMCIA card and the (first) branching
unit.
The target channel number of the optical connector pair is 0.

Installing the
DDCS ISA Board

Note: If you do not know how to install option boards into your PC,
consult a service technician.
Unplug the power cord of the PC.
Open the cover of the PC.
Insert the DDCS board into a vacant ISA-bus slot of the PC.
Close the cover of the PC.
Connect optical cables between the DDCS board and the target
device(s) or between the DDCS board and the (first) branching
unit.
The target channel numbers of the two optical connector pairs are 0
and 1.

Installing the PCI

/ PCMCIA
adapter

Please follow installation instructions of PCI / PCMCIA adapter.

These installation instructions are in the Readme.txt file of the
adapter.
Installation order is:

2-2

Adapter software
PCI / PCMCIA adapter
DriveDebug software
DDCS PCMCIA card.

User's Manual

Chapter 3 - Use of DriveDebug

Starting the
DriveDebug
Program

You start the DriveDebug program by using the Start button in the
Taskbar (Start -> Programs -> DriveWare -> DriveDebug if you
have used the default settings in the software installation).
Note: During the startup the program tries to read the application
variable file and/or the symbol file (if defined during the previous
session). If it cannot find the file it displays an error message "Cannot
open file xxxxxx.yyy". You can ignore this error message and
continue but you cannot use any application variables and/or
symbolic addresses during this DriveDebug session.

Screen Layout

When the program starts it displays the main Frame Window (usually
full screen) and user-defined child windows (if any) inside the Frame
Window. There are nine types of child windows:
Target List Window displays the list of all connected targets and
their statuses.
Monitor Window (one or more) for numerical monitoring and
recording of actual values of user-selected parameters, application
variables, dataset items and/or memory locations from one or
more targets
Trend Window (one or more) for graphical trending of actual
values of user-selected parameters, application variables, dataset
items and/or memory locations (max 6 items in one Trend
Window) from one or more targets. Min sample time is from 1
msec (if 1 trend) to 6 msec (if 6 trends).
Parameters Window for upload, compare, change, backup and
restore of the parameters of the current Default Target (the term
Default Target is described in the next section Targets).
Fault Window for upload, display and clear of the faults of the
current Default Target.
Data Logger Window (one or more) for control of targets data
logger operation and display of the collected sample values in
graphical and numeric form
Control Panel Window for local control and status display of the
selected target
Macro Window (one or more) for creation and execution of
macros. A macro is an user-written sequence of macro
statements.
AC80 Window for numerical monitoring of actual values of userselected AC80 memory locations (if DriveDebug is connected to
AC80, see Appendix 3).

User's Manual

3-1

Use of DriveDebug

Communication status information is shown at the end of the title line

of the Frame Window:
Default Target = c,n (communication is working and the
channel and node numbers of the Default Target are c and n)
or
LINK BREAK date time (no response from the Default Target)
or
COMM DISABLED date time (you have disabled the
communication)
Note: If there is no response from the Default Target then the whole
DriveDebug communication stops. Failure in one or more other
targets does not prevent the communication with the working targets
(if the failed target comes back then DriveDebug automatically starts
to communicate with it).
You can change the title of the Frame Window by menu command
Config - Change Title and the title of the selected child window by
xxxWin - Change Window Title.

Targets

Every child window of DriveDebug and every item in a Monitor or

Trend Window is associated with a drive (or some other device, like
AC80). This device is called window's or item's target.
A target is identified by its channel number (see Chapter 2, section
Installing DriveDebug Hardware) and node number (defined in the
target).
There are three target levels (listed below from the highest level to
the lowest):
Default Target is the Window Target of all child windows without
user-specified (or system-specified) Window Target. This target is
defined by menu command Target - Change Default Target or by
double clicking on the desired target in the Target List Window (if
this window is visible).
Window Target of a child window can be the Default Target (this is
the default case) or an user-specified target (defined by menu
command xxxWin - Change Window Target) or a systemspecified target.
Item Target of an item in a Monitor and Trend Window can be
either the Window Target of item's window (this is the default case)
or an user-specified target (defined by menu command xxxWin Change Item Target).

3-2

User's Manual

Use of DriveDebug

Target List Window

You open the Target List Window by menu command Target Open
Target List Window. All targets connected to the PC are searched
during the first execution of this command and the target list (channel
and node numbers without target names) is displayed in the window.
The real-time value of target's status bits (Ready / Running / ALARM /
FAULT) is displayed in text format after target's channel and node
numbers.
You can update the target list by menu command Target Update
Target List Window (with Names). This command also reads the
target names.
Note: This update command is available only if you have opened the
Target List Window by menu command Target - Open Target List
Window.
You can select the Default Target from the target list by double
clicking on the desired target in the list.

Colors in the
Target List

The background color of the Default Target is always black.

The background color of the other targets (if any) is as follows:

If there are no faults in the targets then the background color of all
targets is green.

If a fault is detected in one or more of the connected targets then

the background color of the faulty target(s) is red and the
background color of all non-faulty targets is yellow.

The text color of the Default Target is determined by using the same
color selection algorithm that is described above for background
colors of the non-Default targets.
The text color of the other targets (if any) is always black.

Monitoring
(Numerical
Display)

When you want to display numerically the real-time values of one or

more data items (or an array of memory locations), you first
create a new Monitor Window by menu command MonWin - New
Monitor Window or
select an existing Monitor Window and the item in this window (if
not already selected)
and then add the item definition into the window (after the selected
item, if any):

User's Manual

3-3

Use of DriveDebug

Parameter is added by menu command MonWin - Add

Parameter
Application variable is added by menu command MonWin - Add
Appl Variable (see section Application Variables later in this
chapter)
Dataset item is added by menu command MonWin - Add Dataset
Item.
Symbol name is added by menu command MonWin - Add
Symbol
Absolute address is added by menu command MonWin - Add
Abs Address
Note: Check the box 16 Data Bits with DPM memory locations of
AC80.
The default layout of a monitor item line is as follows:
value item ;comment (address)
where:

value =
item =
comment =
address =

current value of this item

parameter, application variable, dataset item
or memory location (symbol or absolute)
optional user-specified comment (special
comments are described in Appendix 2)
address of this item (used only with
application variables, symbols and arrays)

You can make some changes to this line layout by menu command
MonWin - Change Line Layout (this command changes the line
layout of all items of all Monitor and Trend Windows).
Note: If a parameter, application variable or symbol (defined during
some previous DriveDebug session) is now unknown then its value is
displayed as a string of question marks.
The Item Target of the new item is the Window Target of the selected
window. You can change items target by menu command MonWin Change Item Target.
You can change the value display format of the selected item by
menu command MonWin - Change Display Mode (this command is
not available with Real type parameters).
If display mode is Boolean then numeric value 0 is displayed as text
FALSE and any other value is displayed as text TRUE.
You can add, change and/or remove optional line comments by menu
command MonWin - Define Comment (special comments are
described in Appendix 2).
3-4

User's Manual

Use of DriveDebug

You remove the selected item line by menu command MonWin Remove Item.
If you click on an item line while holding down the Alt key then
DriveDebug displays the help text of this item (if the help text exists).
You set the value of the selected item by pressing F5 (or by starting
to write the new value directly or by menu command MonWin - Set
Item Value) and undo the previous setting by pressing Ctrl-F5 (or by
menu command MonWin - Undo Item Value Setting).
You can save the data of the selected Monitor Window to a disk file
by menu command File - Save Current Window As.
Later you can e.g. import this file into the document you are working
with or you can download these saved values by a Macro Window
(see section Macros later in this chapter).
Note: The definitions of the selected Monitor Window are
saved/restored by the Save/Open commands in the MonWin menu.
You can select a Monitor Window by pressing (while holding down
the Alt key) the number key that corresponds to the parenthesized
window number of the desired window (see startup parameter N in
Appendix 1).

Application
Variables

Application variables (i.e. pins of the blocks of targets application

software) are defined in an application variable file (the filename
extension of these files is X01).
You select the desired X01 file by menu command File Select Appl
Var File. The name of this file is saved to configuration files and the
application variable file is automatically read when the configuration
file is opened.
Menu command MonWin - Add Appl Variable (or TrendWin - Appl
Variable) opens an Application Variable Window.
On the left side of this window there is a list of all application blocks.
When you select a block from this list, all pins (with their real-time
values) of this block are displayed in the list on the right side of the
window (if this list is too narrow you can make it wider by moving the
right edge of the Application Variable Window to the right).
Note: Pins with time values (the size of these values is 48 bits) are
displayed as two separate pins (low part and high part of the real
pin).
You can change the display mode of the selected value by the
Display Mode radio buttons.

User's Manual

3-5

Use of DriveDebug

If you have selected an application variable (i.e. pin) from the pin list,
you can put this application variable to the Monitor (or Trend) Window
by the OK (or Apply) button.
The Apply button works as the OK button but the Application
Variable Window does not disappear and you can immediately select
the next item.
If you have not selected an application variable then all pins of the
selected block are put to the Monitor Window by the OK button.

Pin Connections

Recording Numeric
Values to a File

A list of all pins that are connected to a pin in an Application Variable,

Monitor, Trend or Data Logger Window can be displayed by clicking
on the pin in the window while holding down the Ctrl key.

You can record the numeric values of the items of a Monitor Window
to a file.
First, select the desired parameters, application variables, dataset
items and/or memory locations (max 500 items) to the desired
Monitor Window as described in section Monitoring above in this
chapter.
Then, define the name of the recorder file, record interval and the
number of lines in the recorder file by menu command MonWin
Start/Stop Recorder.
The minimum value of the record interval (in milliseconds) is the
same as the number of items in the Monitor Window (i.e. 1500
msec) and the maximum value is 60000 msec (= 1 min).
One line in the recorder file contains the values of one record interval.
The maximum allowable number of lines depends on the amount of
free disk space. If the recorder file becomes full during recording then
the oldest line is replaced by the new line.
Finally, start the record operation by the Start button.
You can set the values of the items in the recorder window (= Monitor
Window) when the recording is on.
Note: The values of other windows are not updated during recording.
You stop the recording by the F4 key (or by menu command MonWin
Start/Stop Recorder).
You can display graphically the data of the recorder file by menu
command File - Display Recorder File.

3-6

User's Manual

Use of DriveDebug

Trending
(Graphical Display)

When you want to display graphically (and numerically, too) the realtime values of one or more data items, you first
create a new Trend Window by menu command TrendWin - New
Trend Window or
select an existing Trend Window (if not already selected)
There can be max 6 items defined in one Trend Window. These items
are listed in the box at the top of the window (initially all items are
marked with question marks). You click on the item line which you
want to replace with a new item and then make the item definition as
follows:
Parameter is defined by clicking the Param button (or by menu
command TrendWin - Parameter)
Application variable is defined by menu command TrendWin Appl Variable (see section Application Variables above in this
chapter)
Dataset item is defined by menu command TrendWin - Dataset
Item
Symbol name is defined by menu command TrendWin - Symbol
Absolute address is defined by menu command TrendWin - Abs
Address
Note: Check the box 16 Data Bits with DPM memory locations of
AC80.
The default layout of a trend item line is as follows:
value item (address)
where:

value =
item =
address =

current value of this item

parameter, application variable, dataset item
or memory location (symbol or absolute)
address of this item (used only with
application variables and symbols)

You can make some changes to this line layout by menu command
MonWin - Change Line Layout (this command changes the line
layout of all items of all Monitor and Trend Windows).
Note: If a parameter, application variable or symbol (defined during
some previous DriveDebug session) is now unknown then its value is
displayed as a string of question marks.

User's Manual

3-7

Use of DriveDebug

The Item Target of the new item is the Window Target of the selected
window. You can change items target by clicking the Target button
(or by menu command TrendWin - Change Item Target).
You can change the numeric value display format of the selected item
by menu command TrendWin - Change Num Display Mode (this
command is not available with Real type parameters).
If display mode is Boolean then numeric value 0 is displayed as text
FALSE and any other value is displayed as text TRUE (the value
FALSE is displayed as graph value 0 and TRUE as graph value 1).
If you click on an item line of a Trend Window while holding down the
Alt key then DriveDebug displays the help text of this item (if the help
text exists).
After you have defined one or more items, select the item(s) you want
to display during trending by checking the desired check box(es) in
front of the item definition lines.
After you have checked an item then you can set the Y values of the
selected graph by clicking on the top, middle and/or bottom white Y
value text area. You can change these values at any time later on by
selecting first the desired item and then clicking on the desired Y
value text area (this also enables the vertical scrolling and scaling of
existing trend graphs when the trending has been stopped).
The displayed graph Y value texts are normally signed integers (or
reals), but if the numeric display format of the selected item is Fract
then the Y values are fracts as well.
You set the sampling interval (in milliseconds) by clicking the Interval
button (or by menu command TrendWin - Change Sample Interval).
The minimum value is the same as the number of selected graphs
(i.e. 16 msec) and the maximum value is 60000 msec (= 1 min).
You can define a triggering condition by menu command TrendWin
Set Trig Condition. Black value means a value of the first (black)
graph and "Red value means a value of the second (red) graph.
If you want to save the trend history during trending then you must
define the size of the trend buffer before you start trending (see
section Trend Buffer later in this chapter).
If you want to make speed or torque steps during trending then you
must define the speed and torque steps before you start trending (see
section Speed and Torque Steps later in this chapter).
You start (and stop) the trending by pressing the F4 key (or by menu
command TrendWin - Start/Stop Trending).

3-8

User's Manual

Use of DriveDebug

You can change item definitions and selections, sample interval and
Y values during trending.
If you have defined a triggering condition and this condition is met
during trending then the trending stops automatically after the
Sample Count after Trig.
Note: When trending has been started the Trend Window can update
only the numeric actual values of the items selected for trending.
Therefore, the unselected items are dimmed when the trending is on.
The values of other windows are not updated during trending.
You set the value of the selected item by pressing F5 (or by starting
to write the new value directly or by menu command TrendWin - Set
Item Value) and undo the previous setting by pressing Ctrl-F5 (or by
menu command TrendWin - Undo Item Value Setting).
Note: If you want to set (during trending) the value of an item that is
not in the Trend Window then you can display the Helper List box by
the F7 key (or by the List button), select an item from Helper's item
list and press the F5 key (or click Helper's Set Value button). The
Helper List box lists the items that are in the Monitor Window with title
TrendWinHelper. You can put the desired items into this Monitor
Window before you start trending.
With the trending stopped, you can press the mouse button while the
cursor is on the graph area and the numeric values of the samples at
the cursor location are displayed in the list box at the top of the
window on the gray background (the cursor time is displayed above
the graph area). You can move the mouse while holding down the
mouse button. When you release the mouse button then the current
(real-time) values are again displayed in the list box.
You can save the sample values of the selected Trend Window to a
file (in bitmap or text format) by menu command File - Save Current
Window As (with the trending stopped). See sectionTrend Save later
in this chapter.
You can clear the trend graph area by menu command TrendWin Clear Graph Area (when the trending is stopped).

Trend Buffer

The trend graph area of a Trend Window can horizontally display 500
sample batches (sample intervals). One sample batch contains the
sample values of the user-specified trending items (16 items) that
are collected during the time span of the user-specified sampling
interval.
If you want to save and display more sample batches than the last
500 collected ones then you have to set the trend buffer size by menu
command TrendWin - Change Buffer Size. The buffer size defines

User's Manual

3-9

Use of DriveDebug

how many sample batches can be saved to the buffer. The maximum
allowable size of the buffer depends on the free PC disk space.
Note: If you change the buffer size at a later time, and there are
samples in the buffer, then these samples are lost!
When you start trending, all sample batches are now always saved to
the buffer. If the buffer becomes full during trending then the oldest
sample batch is replaced by the new one.
After you stop trending, you can scroll the collected samples
horizontally to the right (or left) by the right (or left) arrow key while
holding down the Alt key (the size of the scroll move is the half of the
trend graph area width).
You can compress the trend graph horizontally to 1/10 from its
previous width using the right arrow key while holding down the
Shift key. The compressing means that every 10th trend sample is
displayed in the Trend Window.
Using the left arrow key (while holding down the Shift key) you can
expand the compressed trend graph.
If you use the Ctrl key instead of the Shift key then the
compress/expand ratio is 2 instead of 10.
If you restart trending after the compress then the collected samples
are displayed on the screen according to the current compress ratio
but all collected samples are always saved to the trend buffer and it is
possible to see the undisplayed intermediate sample values when
you stop trending and expand the trend.

Speed and
Torque Steps

There are two step buttons in the Trend Window:

You make step definitions (speed or torque steps) using the Step
button (or menu command TrendWin Define Steps)
You make a defined speed or torque step by pressing the button at
the right of the Step button or by menu command TrendWin Step (alternatively Step1 and Step2)

Trend Save

You can save the sample values of the selected Trend Window to a
file by menu command File - Save Current Window As (when the
trending is stopped).
The save format can be either graph (bitmap filename extension is
BMP) or text (filename extension is TXT). It is not necessary to write
the filename extension because DriveDebug appends it automatically
to the filename you specify.
If you select the graph format then you can select Black-and-White or
Color mode. In Black-and-White mode, the widths of the graph lines

3 - 10

User's Manual

Use of DriveDebug

are different so it is possible to differentiate the graphs in a BW

picture.
If you select the text format and you have compressed the graph (see
section Trend Buffer above in this chapter), then there are two save
mode alternatives:
The Time-scaled values in the time range mode saves the
compressed samples of the graph area (this means that there are
max 500 sample lines in the output file).
The All values in the time range mode saves all samples of the
trend buffer that are between the start and end time instances of
the graph area (this mode enables e.g. the save of all samples of
the trend buffer to one file).
You can display graphically the data of the saved text file by menu
command File - Display Trend Text File.

Control Panel

The Control Panel is opened by menu command Target Open

Control Panel. The buttons of the Control Panel are:
The Loc/Rem button switches the current Default Target to Local
Control mode. The value of this Default Target is set to the
Window Target of the Control Panel (this means that the target of
the Local Control do not change if you change the Default Target
while the Local Control is active). If you want to change the target
of the local mode then you must switch back to the remote mode
by the Loc/Rem button, change the Default Target (if not already
changed) and click the Loc/Rem button again.
The Start button starts the target.
The Stop button brings the target down
The CoastStop button stops the target immediately
The Reset button resets target's fault
By the RefValue button you can set target's new reference value
Note: Positive reference = forward and negative reference = reverse.
By means of the Reference scroll bar, you can change the target's
reference value. The reference is changed by pressing the control's
left or right-hand button. The speed of change increases with the time
the button is held down. It is also possible to change the reference
value by dragging the thumb with the mouse.

Target's Status

User's Manual

The status info of the target is displayed at the bottom of the Control
Panel.

3 - 11

Use of DriveDebug

The target is either the Default Target (if Remote Control mode) or
the Window Target of the Control Panel (if Local Control mode).

Parameter Window

The Parameter Window is opened by menu command Target Open

Parameter Window.
You can upload the parameter list of the Default Target with values by
clicking the Upload button.
By double clicking on a parameter you can change its value.
The uploaded parameter list with values can be saved to a file by
menu command File - Save Current Window As.
Using the Compare button, you can compare the uploaded
parameter list with the contents of a previously saved parameter list
file.

Backup and
Restore of
Parameters

There are two parameter backup/restore modes:

Complete (the filename extension of the backup file is PAC)
backups/restores all parameters
Version Update (the filename extension of the backup file is PAU)
backups/restores the ID RUN results and the Motor data.
You can backup parameters of the Default Target to a Backup file by
the Backup button.
Note: It is not necessary to make the Upload operation before
Backup.
You can restore the contents of a Backup file to the Default Target by
the Restore button.
Note: The target software is always restarted at the end of the
Restore operation.
Note: The node number of the Default Target after the Complete
Restore will be the same as it was during the Complete Backup.
Note: If possible, use a point-to-point connection between the PC and
the Default Target during Restore. If this is not possible (i.e. there are
other targets connected to the PC in addition to the Default Target)
then the node numbers of these other targets must be greater than
one (1).

Fault Logger
Window
3 - 12

You open the Fault Window by menu command Target Open Fault
Window. During the execution of this command the fault logger of the

User's Manual

Use of DriveDebug

Default Target is uploaded and displayed in the Fault Window (active

items in the list are marked with +).
You can save the uploaded fault list to a disk file by clicking the Save
button.
You can clear the fault logger by clicking the Clear button.

Data Logger
Window

You open a new Data Logger Window by menu command DLogWin

New Data Logger Window.
The current value of the Default Target is set to the Window Target of
the new window.
If there are more than one data logger in the target then the data
logger number is asked (the numbering of the loggers starts from 1).
The data logger number is displayed at the windows top left corner
(after the targets identifier).
You can read the definitions (and trigger time if triggered) of the data
logger with menu command DLogWin Read Data Logger Info.
You can define the data logger settings with menu command
DLogWin Initialize Data Logger. This command displays a dialog
box with the following buttons:
By means of the Remove button you can remove the selected
variable from the Variables list.
By means of the Param button you can add a new parameter to
the Variables list (either to the start of the list, if nothing selected,
or after the selected variable).
By means of the Appl Var button you can add the index of a new
application variable to the Variables list (either to the start of the
list, if nothing selected, or after the selected variable).
By means of the Rem button you can remove the trigger variable.
By means of the Par button you can define a new trigger
parameter.
By means of the A V button you can define the index of a new
trigger application variable.
By menu command DLogWin Data Logger Control you can
manually start, stop, trigger or reset the data logger.
You can upload the collected samples by menu command DLogWin
Upload Data Logger Samples. If the data logger has been
triggered then the triggering time is at the origin of the X axis; else the
X origin is at the right edge of the graph area.

User's Manual

3 - 13

Use of DriveDebug

The numeric values of the samples at the cursor location are

displayed in the list box at the top of the window together with names
of the data logger channel variables (the cursor time is displayed
above the graph area).
You can move the cursor either with the mouse while holding down
the mouse button, or with the right and left arrow keys.
You can vertically scroll and scale the sample graphs in the same
way as in a Trend Window (see section Trending above in this
chapter).
You can display the uploaded sample values in numeric form using
menu command DLogWin Numeric Display of Samples.
You can save the sample values to a disk file using menu command
File - Save Current Window As.
The save format can be either graph (bitmap filename extension is
BMP) or text (filename extension is TXT). It is not necessary to write
the filename extension because DriveDebug appends it automatically
to the filename you type.
If you select the graph format then you can select Black-and-White or
Color mode. In Black-and-White mode the widths of the graph lines
are different so it is possible to differentiate the graphs in a BW
picture.
Later you can e.g. import this saved file into the document you are
working with or display graphically the saved text file by the Excel
program (you must set the value of the Decimal symbol to dot '.' by
the Control Panel program before you start Excel).

Data Logger
Monitor

Menu command Target Data Logger Monitor searches all data

loggers of all targets connected to the PC and displays the Data
Logger Monitor Window. Now you can define the name and directory
of the monitor log file (all sample files will be written to this directory,
too).
When you click the Start button then DriveDebug continuously polls
for the statuses of all data loggers of all connected targets.
Note: Data logger monitoring starts automatically by startup
parameter /L when the DriveDebug program is started (see Appendix
1).
After the start the text on the Cancel button is changed to Stop.
On the STATE line the current monitoring status is displayed.
If a data logger has been triggered then DriveDebug:
uploads the collected samples of this data logger to a file. The
name of this file is DLMxxxxx.TXT, where xxxxx is unique

3 - 14

User's Manual

Use of DriveDebug

sequence number that distinguishes the sample files from each

other. If the disk becomes full then the oldest DLM*.TXT file is
replaced by the new file.
restarts the triggered data logger (if the triggering was caused by a
fault then DriveDebug waits until the targets fault state has been
removed before restarting the data logger).
restarts the polling of the statuses of all data loggers.

Macros

A macro is an user-written sequence of macro statements in a Macro

Window. The syntax of macro statements is defined in the
DriveDebug Macro Language (see Appendix 4).
By macros it is possible e.g. to set the values of parameters in
target(s) or to write a simple PC-based application program for the
control of target(s).
There are two basic methods to create a new macro:
Write the required macro statements into an empty Macro Window
(see below for details)
Convert a saved Monitor Window data file into a macro (see below
for details)
A previously saved macro file is opened by menu command
MacroWin - Open Macro.
Now you can modify the macro in the created (or opened) Macro
Window and/or you can start the execution of the macro by pressing
the F9 key (or by menu command MacroWin - Execute Macro). The
selected macro statement lines only are executed by menu command
MacroWin - Execute Selected Lines.
The Macro Execution Window (see below for details) is displyed on
the screen during the execution of the macro and you can create a
simple user interface by using this window.
It is possible to read from one file and to write to one file during the
execution of a macro by macro statements #FILENAMEIN =
"filename", #FILENAMEOUT = "filename", V = #FILEIN,
#FILEINRESET and #FILEOUT = ....
You can create a chain of macros by using macro statement
#GOTOMACRO = "macrofilename".
During the execution of some macro statements (e.g. wait
statements) DriveDebug can update numeric values of the items in
Monitor and Trend Windows.

User's Manual

3 - 15

Use of DriveDebug

You can stop the execution of the macro by pressing the Esc key.
You can save your macro to the macro file shown at the title of the
Macro Window by menu command MacroWin - Save Macro (or to a
new macro file by menu command MacroWin - Save Macro As).

Write the Macro

into an Empty
Macro Window

A new Macro Window is opened by menu command MacroWin New Macro Window.
You can add and edit text in a Macro Window in the same way as you
edit text e.g. in the Notepad program. The following "standard"
keyboard key combinations are available:
Ctrl - C
Ctrl - V
Ctrl - X
Del

copies the selected macro text to the clipboard

pastes the text in the clipboard to the insertion point
cuts the selected macro text
deletes the selected macro text

You can use menu commands Edit - Copy, Edit - Paste, Edit - Cut
and Edit - Delete instead of the above-mentioned keys.
Example: Write the following assignment statements into your new
Macro Window:
50.01 = 1234.5
70.07 = 2
22.05 = 12
By pressing the F9 key the parameters listed in the macro are set to
their defined values in the current Default Target. By changing the
Default Target and pressing the F9 key again the same value settings
can be done for other targets too.
With a target statement you can define that the following statements
will use the target of the target statement instead of the Default
Target. This target specification is in effect until the next target
statement (or to the end of the macro if no more target statements
exist).

3 - 16

User's Manual

Use of DriveDebug

Example: If you want to set the values of the first two parameters (see
the example above) in the target 0,5 and the value of parameter
22.05 in the target 0,2 then the macro example above must be edited
into the following form:
#TARGET
50.01 =
70.07 =
#TARGET
22.05 =

= 0,5
1234.5
2
= 0,2
12

By pressing the F9 key the parameters listed in the macro are set to
their defined values in the defined targets.
When you have finished the macro you should save it by menu
command MacroWin Save Macro As. The filename extension of a
macro file is always MAC.

Convert a Saved
Monitor Window
Data into a
Macro

First, select the desired items (e.g. parameters) to a Monitor Window.

Then, save the contents of this Monitor Window (it contains now the
current values of the selected items) to a disk file (filename extension
is TXT) by menu command File - Save Current Window As.
Finally, change (e.g. by the Windows Explorer program) the filename
extension from TXT to MAC.
Example: Insert the SPEED SCALING parameters (assume 50.01) of
all targets (assume targets 0,2 0,5) into an empty Monitor Window:
0,2:50.01
0,3:50.01
0,4:50.01
0,5:50.01
Save the contents of this Monitor Window to a disk file
SCALING.TXT.
Rename SCALING.TXT to SCALING.MAC.
At a later time, the SPEED SCALING values saved above can be
sent back to the same targets in the following way:
open the file SCALING.MAC (created above) with menu command
MacroWin Open Macro
press the F9 key
Of course, you can change the content of the SCALING.MAC macro
(as any other macro) before or after the macro execution. Remember
to save the changed macro with menu command MacroWin Save
Macro if you want to use the changed macro afterwards.

Macro Execution
Window
User's Manual

The Macro Execution Window is displayed on the screen during the

execution of a macro. This window can be divided into three areas:

3 - 17

Use of DriveDebug

The top area (the String area) is used to display text strings (e.g.
help texts) to the user.
The middle area (the Value area) contains the Value input field
and the Enter button (the Enter key can be used instead of this
button)
The bottom area (the Variable area) contains the Variable input
field and the Set Variable button.
It is possible to create a simple user interface by user interface
statements. Here is an example:
You can e.g. display help information to the user by macro
statement #PUTSTR = "character string" and read user's
input by macro statement V = #GETVAL.
You can write e.g. the default input value by macro statement
#PUTVAL = "character string" (before the V = #GETVAL
statement) and if the user accepts this default value (s)he can
continue by pressing only the Enter key.
If the user wrote an invalid value then you can display an error
message e.g. by macro statement #MSGBOX = "character
string".
The Value input field and the Enter button can be removed by macro
statement #SHOWGETVAL = 0.
The V = #GETVAL statement above halts the execution of the macro
until the user presses the Enter key.
You can set values of macro variables (%c and %Rc) "on the fly" (i.e.
without halting the macro execution) by writing the value setting
command (e.g. %k=123) to the Variable input field and clicking the
Set Variable button.
Note that it is a good practice to read the value of this variable only in
one statement in the macro (e.g. by statement %p = %k) because it
is not possible to know where the execution of the macro is when the
user clicks the Set Variable button.
The Variable input field and the Set Variable button can be removed
by macro statement #SHOWSETVAR = 0.

3 - 18

User's Manual

Use of DriveDebug

Definition Files

You can save the current DriveDebug configuration (the definitions of

all current Monitor, Trend and Macro Windows) with menu command
Config - Save Configuration. The Frame Window title is used as file
name (the length of this title can be up to 80 characters).
A previously saved DriveDebug configuration can be restored by
menu command Config - Open Configuration.
You can save the definitions of the selected Monitor Window with
menu command MonWin - Save Monitor Window and the
definitions of the selected Trend Window with menu command
TrendWin - Save Trend Window. The window title is used for the file
name (the length of this title can be up to 80 characters).
Note: The data of the selected window is saved with menu command
File - Save Current Window As.
A previously saved Monitor Window can be added to the current
configuration with menu command MonWin - Open Monitor Window
and a Trend Window with menu command TrendWin - Open Trend
Window.

Help

Menu command Help Contents displays the main index of the

DriveDebug Help.
Another help method is context-sensitive help, i.e. you can press the
F1 key in order to get information about the selected menu command,
child window etc.

Exit

When you exit DriveDebug (e.g. with menu command File - Exit), all
current configuration settings of all current Monitor, Trend and Macro
Windows are always saved into the AMCTOOL.ATC file in the current
directory (if this file already exists it is overwritten).
During the next startup the settings of this file are automatically
copied to the initial configuration settings of the DriveDebug program.

User's Manual

3 - 19

Use of DriveDebug

3 - 20

User's Manual

Chapter 4 - File Menu

Save Current
Window As

Using this command you can save the data of the selected window to
a file.
You can later e.g. import this file into the document you are working
with.
Note: The definitions of the selected window are saved/restored
using the Save/Open commands in the MonWin, AC80Win and
TrendWin menus.

Print Current
Window

Using this command you can print the graphs of the selected Trend
Window.

Display Trend Text

File

Using this command you can display graphically the contents of a

previously saved trend file (the trends must have been saved in the
text format, not in the graph format).
If there are no drives connected to DriveDebug then the type (Real or
non-Real) of every parameter to be displayed is asked.
This command creates a new Trend Window based on the
information in the saved trend text file.
You can scroll and scale the trends in this new Trend Window (and
even start a new trending, if needed).

Display Recorder
File

Using this command you can display graphically the contents of a

previously created recorder file.
When you have selected the recorder file, you can select the recorder
items (16 items) for display.
If there are no drives connected to DriveDebug, the type (Real or
non-Real) of every parameter to be displayed is asked.
This command creates a new Trend Window based on the selected
information in the saved recorder file.
You can scroll and scale the trends in this new Trend Window (and
even start a new trending, if needed).

Display DriveBDU
File

Using this command you can display graphically the contents of a file
saved by the DriveBDU program (see menu command Target Start
DriveBDU).
When you have selected the DriveBDU file, you can select the BDU
logger items (16 items) for display.
This command creates a new window based on the selected
information in the DriveBDU file.
You can scroll and scale the graphs in this new window.

User's Manual

4-1

File Menu

Current Symbol
File

This command displays the name and date of the symbol file that is
currently in use.
This command is grayed out if DriveDebug has not found a symbol
file.

Select Symbol File

By this command you can select a new symbol file(*.CLD).

This command is grayed out if the target is an AC80 because in that
case the symbol file is selected automatically by DriveDebug.
The name of the selected symbol file is saved to the configuration file
when you save configuration using Config - Save Configuration.

Current Appl Var

File

This command displays the name and date of the application variable
file that is currently in use.
This command is grayed out if DriveDebug has not found an
application variable file.

Select Appl Var

File

With this command, you can select a new application variable file
(*.X01).
The name of the selected application variable file is saved to the
configuration file when you save configuration by Config - Save
Configuration.

Exit

When you exit DriveDebug, all configuration settings of all current

Monitor, Trend and Macro Windows are always saved into the
AMCTOOL.ATC file in the current directory (if this file already exists it
is overwritten).
During the next startup the settings of this file are automatically
copied to the initial configuration settings of the DriveDebug program.

4-2

User's Manual

Chapter 5 - Edit Menu

Cut

This command copies the selected Macro Window text to the

clipboard and removes the text from the screen.
You can now paste it into another location of the macro you are
working with (or into another Macro Window).

Copy

This command copies the selected Macro Window text to the

clipboard.
You can now paste it into another location of the macro you are
working with (or into another Macro Window).

Paste

This command inserts the previously copied (or cut) text into the
selected location of the macro you are working with.

Delete

User's Manual

This command removes the selected Macro Window text from the
screen (or the next character of the window if no text selected).

5-1

Edit Menu

5-2

User's Manual

Chapter 6 - Target Menu

Open Target List
Window

This command displays the list of all targets connected to the PC and
their statuses.

Update Target List

Window (with
Names)

This command updates the target list and also reads the names of
the targets.

Change Default
Target

If the Target List Window is not visible, you can change the Default
Target with this command (if the Target List Window is visible then
you change the Default Target by double clicking on the desired
target in the list).
The channel and node numbers of the Default Target are shown at
the end of the title line of the Frame Window when the communication
is working.

Note: This command is available only if you have opened the Target
List Window by menu command Target - Open Target List Window.

Note: If the Default Target goes down then the whole DriveDebug
communication stops. Failure in one or more other targets does not
prevent the communication with the working targets (if the failed
target comes back then DriveDebug automatically starts to
communicate with it).

Open Control
Panel

This command opens the Control Panel Window (see Chapter 3,

section Control Panel).

Open Parameter
Window

This command opens the Parameter Window (see Chapter 3, section

Parameter Window).

Open Fault
Window

This command opens the Fault Window and uploads the items of the
fault logger of the Default Target.

Data Logger
Monitor

This command displays the Data Logger Monitor Window (see

Chapter 3, section Data Logger Monitor).

Backup

This command backups the whole Default Target software to a

Backup file (the filename extension of the Backup file is TAR).
Note: Use the Backup button of the Parameter Window if you want
to backup only parameters.

Restore

This command restores the contents of a Backup file to the Default

Target.
Note: The node number of the Default Target after the Restore will be
the same as it was during the Backup.

User's Manual

6-1

Target Menu

Note: If possible use a point-to-point connection between the PC and

the Default Target during Restore. If this is not possible (i.e. there are
other targets connected to the PC in addition to the Default Target)
then the node numbers of these other targets must be greater than
one (1).
Note: If the Restore operation fails then you have to switch the power
of the Default Target off and on before you can continue.

Enable
Communication

This command enables the communication with the target(s).

Disable
Communication

This command disables the communication with the target(s).

Note: The communication is always disabled when DriveDebug is
minimized (iconic).

Comm Statistics

This command displays communication statistics (cumulative values

since the startup of the DriveDebug and since the opening of this
statistics box).

Start DriveBDU

With this command, you start the DriveBDU program.

You cannot use DriveDebug while the DriveBDU is executing.
With the DriveBDU program you can:

6-2

connect to a Branching & Datalogging Unit for parallel

inverters

upload the samples from the selected (triggered) BDU logger

(User, First and/or Last logger)

save the uploaded samples to a disk file.

You can display the data of this file graphically either by the
File Display DriveBDU File menu command or by Excel
(you must set the value of the Decimal symbol to dot '.' by the
Control Panel program before you start Excel).

start the BDU User logger

trig the BDU User logger

User's Manual

Chapter 7 - Config Menu

New Configuration

Using this command, you can create a new configuration.

Note: All Monitor, Trend and Macro Windows of the current
configuration will be closed!

Change Title

Using this command you can change the Frame Window title of the
current configuration (max 80 characters at the top line).
If you save the definitions of this configuration (see the Save
Configuration command below) then this title is used as the file
name of the saved file.

Open
Configuration

Using this command you can restore a previously saved DriveDebug

configuration (see the Save Configuration command below).

Save Configuration

Using this command you can save the current DriveDebug

configuration (all definitions of all Monitor, Trend and Macro
Windows) to a file. The Frame Window title is used as the file name.

User's Manual

7-1

Config Menu

7-2

User's Manual

Chapter 8 - MonWin Menu

New Monitor
Window

Using this command you can create a new Monitor Window.

Change Window
Title

Using this command you can change the window title of the selected
Monitor Window (max 80 characters).
If you save the definitions of this Monitor Window (see the Save
Monitor Window command below) then this title is used as the file
name of the saved file.

Change Window
Target

Using this command you can change the target of the selected
Monitor Window. If the Window Target is not specified as the Default
Target, the channel and node numbers of the Window Target are
shown in front of the title of the window.

Enable Monitoring

This command enables the update of the item values of the selected
Monitor Window.

Disable Monitoring

This command disables the update of the item values of the selected
Monitor Window. The text of the disabled window is grayed out.
By pressing the space bar you can update the value of the selected
item in the disabled window.

Open Monitor
Window

Using this command you can add a previously saved Monitor Window
(see the Save Monitor Window command below) to the current
configuration.

Save Monitor
Window

Using this command you can save all definitions of the selected
Monitor Window to a file. The window title is used as the file name.

Add Symbol

Using this command you can add a symbol (or an array of memory
locations starting from this symbol) after the selected line in the active
Monitor Window (or to the end of the list if no line is selected).
As you type the symbol name, the symbol list scrolls automatically to
display the first symbol whose initial letters match the characters you
have typed. In this way, you can quickly find the desired symbol.
The Apply (= Alt + A) button works as the OK button but the dialog
box does not disappear and you can immediately select a new
symbol.
Note: Check the box 16 Data Bits with DPM memory locations of an
AC80.

Add Abs Address

User's Manual

Using this command you can add an absolute address (or an array of
addresses starting from this address) after the selected line in the
active Monitor Window (or to the end of the list if no line is selected).
The Apply (= Alt + A) button works as the OK button but the dialog
8-1

MonWin Menu

box does not disappear and you can immediately type a new
address.
Note: Check the box 16 Data Bits with DPM memory locations of
AC80.

Add Parameter

Using this command you can add a parameter after the selected line
in the active Monitor Window (or to the end of the list if no line is
selected).
As you type the parameter number, the parameter list scrolls
automatically to display the first parameter whose initial numbers
match the characters you have typed. In this way, you can quickly
find the desired parameter.
The Apply (= Alt + A) button works as the OK button but the dialog
box does not disappear and you can immediately select a new
parameter.
If you want to add several parameters to the Monitor Window, first
select one parameter by clicking on it in the parameter list and then
select the other parameters by clicking on them while holding
down the Ctrl key (if you want to select individual parameters) or
click on the last parameter of the range while holding down the
Shift key (if you want to select a range of parameters)
Finally click OK or Apply (= Alt + A).

Add Appl Variable

Using this command you can add an application variable after the
selected line in the selected Monitor Window (or to the end of the list
if no line selected).
See Chapter 3, section Application Variables for details.

Add Dataset Item

Using this command you can add a dataset item after the selected
line in the selected Monitor Window (or to the end of the list if no line
selected).
The Apply (= Alt + A) button works as the OK button but the dialog
box does not disappear and you can immediately select a new
dataset item.

Search/Update
Symbols

This command scans all memory location items of the selected

Monitor Window. If the absolute address of an item is the same as the
absolute address of a symbol then the original item text is replaced
with the name of this symbol.
Example: If you add an array of absolute memory locations with the
Add Abs Address command then you can, using this command,
automatically replace the absolute address items with the names of
the symbols whose absolute addresses lie within this memory
location array.

8-2

User's Manual

MonWin Menu

Remove Item

This command deletes the selected line from the active Monitor
Window.

Change Display
Mode

Using this command you can change the display mode of the actual
value of the selected item in the active Monitor Window (this
command is not available with Real type parameters).
If display mode is Boolean then numeric value 0 is displayed as text
FALSE and any other value is displayed as text TRUE.

Define Comment

Using this command you can add, change and/or remove one or
more optional item comments in the active Monitor Window.
Special comments are described in Appendix 2.

Define Pointer

Using this command you can define that the actual value of the
selected item is used as a pointer to the memory type you specify (X,
Y or P memory).
The pointed value is displayed at the beginning of the item line. The
actual value of the item (i.e. the pointer value) is now displayed at the
end of the line.

Change Item
Target

Using this command you can change the target of the selected item.
If the Item Target is not specified to be the Window Target then the
channel and node numbers of the Item Target are shown before the
name of the item.

Set Item Value

By this command (or by pressing F5) you can set the value of the
selected item in the active Monitor Window (the current value is
displayed in the value dialog box for editing).
Note: You can start typing value characters without selecting this
command (or pressing the F5 key) because the value dialog box
appears automatically when you have entered the first value
character.

Undo Item Value

Setting

This command (or Ctrl-F5) undoes the previous value setting.

Note: It is not possible to undo if you have changed the active child
window after the value setting.

Start/Stop
Recorder

This command either displays the Value Recorder dialog box or stops
the recording (see Chapter 3, section Recording for details).

Change Line
Layout

Using this command you can:

specify the number of spaces (1...9) between the value text and
the item name text.
change the display mode of the item name texts of memory
location arrays.
Normally all array item texts (except the first one) are in the

User's Manual

8-3

MonWin Menu

base+offset format but you can prevent the display of the array
base (on the other array lines except the first one).
prevent the display of parenthesized address values at the end of
item lines.
Note: This command changes the line layout of all items of all Monitor
and Trend Windows.

8-4

User's Manual

Chapter 9 AC80Win Menu

New AC80 Window
Change Window Title
Open AC80 Window
Save AC80 Window
Add Symbol
Add Abs Address
Remove Item
Change Display Mode
Define Comment
The operation of these menu commands is similar to the operation of
their Monitor Window counterparts (see Chapter 8) but they operate
with the active AC80 Window (there can be no more than one AC80
Window).

User's Manual

9-1

AC80Win Menu

9-2

User's Manual

Chapter 10 - TrendWin Menu

New Trend Window

Using this command you can create a new Trend Window.

Change Window
Title

Using this command you can change the window title of the selected
Trend Window (max 80 characters).
If you save the definitions of this Trend Window (see the Save Trend
Window command below) then this title is used as the file name of
the saved file.

Change Window
Target

Using this command you can change the target of the selected Trend
Window. If the Window Target is not specified to be the Default
Target then the channel and node numbers of the Window Target are
shown before the title of the window.

Open Trend
Window

Using this command you can add a previously saved Trend Window
(see the Save Trend Window command below) to the current
configuration.

Save Trend
Window

Using this command you can save all definitions of the selected
Trend Window to a file. The window title is used as the file name.

Symbol

Using this command you can replace the selected item in the
selected Trend Window with a symbol.
When you are entering the symbol name, the symbol list scrolls
automatically to display the first symbol whose initial letters match the
characters you have typed. In this way, you can quickly find the
desired symbol.
Note: Check the box 16 Data Bits with DPM memory locations of an
AC80.

Abs Address

Using this command you can replace the selected item in the
selected Trend Window with an absolute address.
Note: Check the box 16 Data Bits with DPM memory locations of an
AC80.

Parameter

User's Manual

Using this command (or by clicking the Param button) you can
replace the selected item in the selected Trend Window with a
parameter.
As you type the parameter number, the parameter list scrolls
automatically to display the first parameter whose initial numbers
match the characters you have typed. In this way, you can quickly
find the desired parameter.

10 - 1

TrendWin Menu

Appl Variable

Using this command you can replace the selected item in the
selected Trend Window with an application variable.
See Chapter 3, section Application Variables for details.

Dataset Item

Using this command you can replace the selected item in the
selected Trend Window with a dataset item.

Display Helper List

This command (or the F7 key) displays a dialog box that contains the
items of the Monitor Window with title TrendWinHelper.
You create this Monitor Window and put the desired items into this
Monitor Window before you start trending.
By this dialog box you can set values of the items in the dialog box
and/or copy items from the dialog box to Trend Window.

Change Num
Display Mode

Using this command you can change the numeric display mode of the
actual value of the selected item in the selected Trend Window (this
command is not available with Real type parameters).
If display mode is Boolean then numeric value 0 is displayed as text
FALSE and any other value is displayed as text TRUE (the value
FALSE is displayed as graph value 0 and TRUE as graph value 1).

Change Item
Target

Using this command (or by clicking the Target button) you can
change the target of the selected item. If the Item Target is not
specified as the Window Target then the channel and node numbers
of the Item Target are shown before the name of the item.

Set Item Value

Using this command (or by pressing F5) you can set the value of the
selected item in the selected Trend Window (the current value is
displayed in the value dialog box for editing).
Note: You can start typing value characters without selecting this
command (or pressing the F5 key) because the value dialog box
appears automatically when you have entered the first value
character.
Note: If you want to set (during trending) the value of an item that is
not in the Trend Window then you can display the Helper List box by
the F7 key (or by the List button), select an item from Helper's item
list and press the F5 key (or click Helper's Set Value button). The
Helper List box lists the items that are in the Monitor Window with title
TrendWinHelper. You can put the desired items into this Monitor
Window before you start trending.

Undo Item Value

Setting

This command (or the pressing of the Ctrl-F5 keys) undoes the
previous value setting.
Note: It is not possible to undo if you have changed the active child
window after the value setting.

10 - 2

User's Manual

TrendWin menu

Change Sample
Interval

Using this command (or by clicking the Interval button) you can set
the sampling interval (in milliseconds). The minimum value is the
same as the number of selected graphs (i.e. 16 msec) and the
maximum value is 60000 msec (= 1 min).

Change Buffer Size

Using this command you can change the size of the trend buffer (see
Chapter 3, section Trend Buffer for details).

Start/Stop
Trending

This command (or the F4 key) starts (or stops) the trending. You can
change item definitions and selections, sample interval and Y values
during the trending.

Set Trig Condition

Using this command you can define a triggering condition.

Black value means a value of the first (black) graph and "Red value
means a value of the second (red) graph.
If you have defined a triggering condition and this condition is met
during trending then the trending stops automatically after the
Sample Count after Trig.

Clear Graph Area

This command clears the trend graph area (trending must be

stopped).

Define Steps

Using this command you can make step definitions (speed or torque
steps).

Step

This command carries out one of the defined speed or torque steps
(alternatively Step1 and Step2).

Mouse and
Keyboard
Operations

You can select an item in the item list box using the up and down
keys or by clicking on an item name text.

Vertical Scrolling
and Scaling

By clicking on the top graph Y value text you can set a new
maximum Y value.
By clicking on the middle graph Y value text you can set a new
offset Y value.
By clicking on the bottom graph Y value text you can set a new
minimum Y value.
Note: The increment in the following operations is half of current area
height.
By holding down the Alt key and pressing the up or down key you
can move the selected graph up or down.
By holding down the Shift key and pressing the up or down key you
can change the value of the top graph Y value text.
By holding down the Ctrl key and pressing the up or down key you
can change the value of the bottom graph Y value text.

User's Manual

10 - 3

TrendWin Menu

Horizontal
Scrolling and
Scaling

10 - 4

Note: Trending must be stopped and the trend buffer defined.

By holding down the Alt key and pressing the right or left key you
can move the graphs to the right or to the left (the move length is half
of graph area width).
By holding down the Shift key and pressing the right or left key
you can compress or expand the graphs (compress/expand ratio is
10).
By holding down the Ctrl key and pressing the right or left key
you can compress or expand the graphs (compress/expand ratio is
2).

User's Manual

Chapter 11 - MacroWin Menu

See also the commands in the Edit Menu (Chapter 5).

New Macro Window

Open Macro

This command creates a new (empty) Macro Window.

This command restores a previously saved macro. The name of the
opened file is displayed as the title of the Macro Window.
Note: You can also open a previously saved Monitor Window data file
(see Chapter 3, section Macros).

Save Macro

This command saves the macro text of the selected Macro Window to
a file whose name is the title of the Macro Window.

Save Macro As

This command saves the macro text of the selected Macro Window to
an user-specified file. The name of the file is displayed as the title of
the Macro Window.

Execute Macro

This command (or the F9 key) starts the execution of the macro of the
selected Macro Window.
The Macro Execution Window is displyed on the screen during the
execution of the macro and you can create a simple user interface by
using this window.
It is possible to read from one file and to write to one file during the
execution of a macro by macro statements #FILENAMEIN =
"filename", #FILENAMEOUT = "filename", V = #FILEIN,
#FILEINRESET and #FILEOUT = ....
You can create a chain of macros by using macro statement
#GOTOMACRO = "macrofilename".
During the execution of some macro statements (e.g. wait
statements) DriveDebug can update numeric values of the items in
Monitor and Trend Windows.
You can stop the execution of the macro by pressing the Esc key.

User's Manual

11 - 1

MacroWin Menu

Execute Selected
Lines

This command starts the execution of the selected macro statement

lines of the selected Macro Window.
The Macro Execution Window is displyed on the screen during the
execution of the macro and you can create a simple user interface by
using this window.
It is possible to read from one file and to write to one file during the
execution of a macro by macro statements #FILENAMEIN =
"filename", #FILENAMEOUT = "filename", V = #FILEIN,
#FILEINRESET and #FILEOUT = ....
You can create a chain of macros by using macro statement
#GOTOMACRO = "macrofilename".
During the execution of some macro statements (e.g. wait
statements) DriveDebug can update numeric values of the items in
Monitor and Trend Windows.
You can stop the execution of the macro by pressing the Esc key.

11 - 2

User's Manual

Chapter 12 - DLogWin Menu

See also Chapter 3, section Data Logger Window.

New Data Logger

Window

This command creates a new (empty) Data Logger Window.

Change Window
Title

Using this command you can change the window title of the selected
Data Logger Window (max 80 characters).

Read Data Logger

Info

Using this command you can read the definitions (and triggering time
if triggered) of the data logger.

Initialize Data
Logger

Using this command you can define the data logger settings.

Data Logger
Control

Using this command you can manually start, stop, trigger or reset the
data logger.

Upload Data
Logger Samples

Using this command you can upload the collected samples.

Numeric Display of
Samples

Using this command you can display the uploaded sample values in
numeric form.

User's Manual

12 - 1

DLogWin Menu

12 - 2

User's Manual

Chapter 13 - Windows Menu

Tile

This command tiles the child windows.

Cascade

This command cascades the child windows.

Arrange Icons

This command arranges the iconic child windows (if any).

Close All

This command closes all child windows.

User's Manual

13 - 1

Windows Menu

13 - 2

User's Manual

Chapter 14 - Help Menu

Contents

This command displays the main index of the DriveDebug Help.

Note: Instead of this menu command you can press the F1 key in
order to get information about the selected menu command, child
window etc.

About DriveDebug

User's Manual

This command displays the DriveDebug information box.

14 - 1

Help Menu

14 - 2

User's Manual

Chapter 15 - Appendices
Appendix 1
Startup Parameters

By startup parameters you can customize your copy of the

DriveDebug program.
Startup parameters are in the Target line of the Properties definition
of the DriveDebug text in the Start menu.
You set/change values of startup parameters as follows:

stop DriveDebug (if it is running)

right-click the DriveDebug text (Start -> Programs ->

DriveWare -> DriveDebug)

click Properties

add the required startup parameters to the end of the Target

line as follows :
path\DriveDebug.EXE /X /Y ...
where X and Y are identifier letters of the startup parameters
(see below).

User's Manual

click the OK button

start DriveDebug

15 - 1

Appendices

Table of Startup
Parameters

15 - 2

Param

Meaning and Values

By this parameter DriveDebug is always the

topmost program on the screen.
Example: /T

This parameter displays (during the startup of

DriveDebug) a dialog box for the setting of DDCS
communication parameters (e.g. the light beam
intensity for long optical cables).
Example: /D

This parameter starts the data logger monitoring

after the start of the DriveDebug program.
Example: /L

This parameter prevents the display of window

numbers in window titles (and the use of key
combination Alt + window number).
Example: /N

Normally DriveDebug uses (and displays) 24

address bits of memory locations. If you only use
shorter 16-bit memory addresses (as e.g. with an
AC80) then this parameter prevents the display of
the eight most significant (unused) address bits.
Example: /S

Language selection.
Texts for other languages than English are in
separate AMCTLNXY.DLL files (where XY are
language identifier letters, e.g. FI). You must
copy the desired text file(s) to your DriveDebug
directory before you can use this parameter.
The parameter K is followed by the language
identifier (XY) of the desired text file name.
Example: /KFI

User's Manual

Appendices

Appendix 2
Special Comments

A special comment is a comment that starts with an user-specified

definition string.
DriveDebug reads and interprets the definition strings of special
comments.
The format of a special comment is as follows:
[definition]comment
where:

Definition =
Comment =

definition string
optional text string

Note: No space characters are allowed before the "]" character!

The allowable definition string formats are as follows:
Format
=nnn
==nnn
!=nnn
>nnn
>=nnn
<nnn
<=nnn
&nnn

Value Type
Interpretation

Effect
Item line text is red if item's value is equal to nnn
Item line text is red if item's value is equal to nnn
Item line text is red if item's value is not equal to nnn
Item line text is red if item's value is greater than nnn
Item line text is red if item's value is greater or equal than nnn
Item line text is red if item's value is lesser than nnn
Item line text is red if item's value is lesser or equal than nnn
Item line text is red if item's value AND nnn is not zero

If used with a Real type parameter then the value string nnn is
assumed to be a real value.
If the value string nnn includes the character "." then it is assumed to
be a fraction.
If the value string nnn starts with the character "+" (or "-") then it is
assumed to be a signed value.
If the value string nnn ends with the character "h" then it is assumed
to be a hex value.
Otherwise the value string nnn is assumed to be an unsigned value.

User's Manual

15 - 3

Appendices

Appendix 3
AC80 and NCB

The AC80 contains two separate processor boards:

Main processor board (AC80)
Communication processor board (NCB)
These two boards communicate with each other through the dual port
memory (DPM) between them.
DriveDebug is connected to the DDCS-protocol Tool Link (ch3) of the
NCB and it can access the data of the main AC80 board via the DPM.

15 - 4

User's Manual

Appendices

Appendix 4
Macro Language
Summary of
Macro
Statements

X=C
X=Y
X = Y oper C
X = Y oper Z
#IF (X comp C)
#IF (X comp Y)
#ENDIF
#WHILE (X comp C)
#WHILE (X comp Y)
#ENDWHILE
#TARGET = CV, CV
#WAIT = CV
.DSnn = iV
iV = .DSnn
#GOTOMACRO = "macrofilename"
#FILENAMEIN = "filename"
#FILENAMEOUT = "filename"
V = #FILEIN
#FILEINRESET
#FILEOUT = V
#FILEOUT = "character string"
#FILEOUT = #FILEIN
#FILEOUT = #DATETIME
#FILEOUT = #GETVAL
#PUTSTR = V
#PUTSTR = "character string"
#PUTSTR = #FILEIN
#PUTVAL = V
#PUTVAL = "character string"
#PUTVAL = #FILEIN
V = #GETVAL
#MSGBOX = "character string"
#MSGBOX = #FILEIN
#SHOWGETVAL = C
#SHOWSETVAR = C

User's Manual

15 - 5

Appendices

iV
iV
iV
iV
iV
iV

=
=
=
=
=
=

#DLSTATUS, CV
#DLSTART, CV
#DLSTOP, CV
#DLTRIG, CV
#DLRESET, CV
#DLUPLOAD, CV

iV = #FLUPLOAD
iV = #FLCLEAR
iV = #FLCOUNT
iV = #PARUPLOAD
iV = #USERFUNCTION
#EXIT

; Comment text

Descriptions of macro statements are on the following pages

(the meaning of X, Y, Z, C, CV, V, iV, oper and comp is
explained at the end of this Appendix).

15 - 6

User's Manual

Appendices

Assignment
Statements

X=C
X=Y
X = Y oper C
X = Y oper Z

Decision
Statements

#IF (X comp C)
#IF (X comp Y)
#ENDIF

Loop Statements

#WHILE (X comp C)
#WHILE (X comp Y)
#ENDWHILE

Target Statement

#TARGET = CV, CV

; channel, node

All subsequent statements (up to the next #TARGET statement, if any)

will use this target.
Statements before the first #TARGET statement (if any) use the
Default Target.

Wait Statement

#WAIT = CV

; wait time (1...60000 msec)

During the execution of a #WAIT statement DriveDebug updates the

numeric values of the items in Monitor and Trend Windows (update
rate is about one value in one millisecond of a #WAIT statement).

User's Manual

15 - 7

Appendices

Dataset
Statements

.DSnn = iV
Puts the value of the integer variable iV and the values of the next
two integer variables to target's dataset nn, reads the values of
target's next dataset and puts the read values to the next three
integer variables.
Example: Statement .DS1 = %k puts the values of variables %k, %l
and %m to target's dataset 1 and reads the values of target's dataset 2
to variables %n, %o and %p.
iV = .DSnn
Reads the values of target's dataset nn and puts the read values to
integer variable iV and to the next two integer variables.
Example: Statement %x = .DS11 reads the values of target's
dataset 11 to variables %x, %y and %z.

Macro Chaining
Statement

15 - 8

#GOTOMACRO = "macrofilename"
Stops the execution of the current macro, closes the current Macro
Window, opens a new Macro Window with macro macrofilename
and starts this new macro.

User's Manual

Appendices

File and User

Interface
Statements

#FILENAMEIN = "filename"
#FILENAMEOUT = "filename"
These statements specify the names of the input and output files.
No macro statements are allowed before these statements.
The input and output files contain character lines. Max line length in
the input file is 100 characters.
The input and output files are opened automatically when the
execution of the macro is started and closed when the execution of
the macro is stopped.
If the output file already exists when the execution of the macro is
started then it is overwritten by the new output file.
If the #FILENAMEIN statement is missing then the default name of
the input file is MACRO.IN.
If the #FILENAMEOUT statement is missing then the default name of
the output file is MACRO.OUT.
V = #FILEIN
Reads a character line from the input file, converts the read
characters to a numeric value and puts this value to (integer or real)
variable V.
The conversion stops at the first non-numeric character.
#FILEINRESET
Moves the read position of the input file back to the beginning of the
file.
#FILEOUT = V
Converts the (integer or real) variable V to a character string and
writes this string to the output file.
#FILEOUT = "character string"
Writes the character string to the output file.
If the string is empty (i.e. "") then a CR/LF character pair is written to
the output file.

User's Manual

15 - 9

Appendices

#FILEOUT = #FILEIN
Reads a character line from the input file and writes the read line to
the output file.
If the read line is empty then a CR/LF character pair is written to the
output file.
#FILEOUT = #DATETIME
Writes the current date and time (e.g. 12/27/01 13:28:57) to the
output file.
#FILEOUT = #GETVAL
Waits until the user has clicked the Enter button of the Macro
Execution Window and then this statement reads the character string
from the Value input field of the Macro Execution Window and finally,
writes the read string to the output file.
If the read string is empty then a CR/LF character pair is written to the
output file.
During the execution of this statement DriveDebug updates the
numeric values of the items in Monitor and Trend Windows.
#PUTSTR = V
Converts the (integer or real) variable V to a character string and
appends this string to the content of the String area of the Macro
Execution Window.
#PUTSTR = "character string"
Appends the character string to the content of the String area of
the Macro Execution Window.
Every vertical bar character (|) in the string (if any) explicitly starts a
new line in the String area.
If the string is empty (i.e. "") then the String area is cleared.

15 - 10

User's Manual

Appendices

#PUTSTR = #FILEIN
Reads a character line from the input file and appends the read line
to the content of the String area of the Macro Execution Window.
Every vertical bar character (|) in the read line (if any) explicitly starts
a new line in the String area.
If the read line is empty then the String area is cleared.
#PUTVAL = V
Converts the (integer or real) variable V to a character string and
appends this string to the content of the Value input field of the Macro
Execution Window.
#PUTVAL = "character string"
Appends the character string to the content of the Value input
field of the Macro Execution Window.
If the string is empty (i.e. "") then the Value input field is cleared.
#PUTVAL = #FILEIN
Reads a character line from the input file and appends the read line
to the content of the Value input filed of the Macro Execution
Window.
If the read line is empty then the Value input field is cleared.
V = #GETVAL
Waits until the user has clicked the Enter button of the Macro
Execution Window and then this statement reads the character string
from the Value input field of the Macro Execution Window, converts
the read characters to a numeric value and puts this value to (integer
or real) variable V.
The conversion stops at the first non-numeric character.
During the execution of this statement DriveDebug updates the
numeric values of the items in Monitor and Trend Windows.

User's Manual

15 - 11

Appendices

#MSGBOX = "character string"

Displays a message box with the character string.
During the execution of this statement DriveDebug updates the
numeric values of the items in Monitor and Trend Windows.
The execution of the macro continues when the user has clicked the
OK button of the message box.
#MSGBOX = #FILEIN
Reads a character line from the input file and displays a message box
with the read line.
During the execution of this statement DriveDebug updates the
numeric values of the items in Monitor and Trend Windows.
The execution of the macro continues when the user has clicked the
OK button of the message box.
#SHOWGETVAL = C
Hides the Value area components of the Macro Execution Window (if
the value of the constant C is zero) or shows these components (if the
value of the constant C is non-zero).
When a macro is started these components are displayed by default.
#SHOWSETVAR = C
Hides the Variable area components of the Macro Execution Window
(if the value of the constant C is zero) or shows these components (if
the value of the constant C is non-zero).
When a macro is started these components are displayed by default.

15 - 12

User's Manual

Appendices

Data Logger
Statements

iV = #DLSTATUS, CV
Reads the status word of data logger CV (1 or 2) and puts the read
value to integer variable iV. If error, iV = -1.
Example: Statement %s = #DLSTATUS,1 reads the status of data
logger 1 to variable %s.
iV = #DLSTART, CV
Starts data logger CV (1 or 2). If OK, integer variable iV = 0.
iV = #DLSTOP, CV
Stops data logger CV (1 or 2). If OK, integer variable iV = 0.
iV = #DLTRIG, CV
Triggers data logger CV (1 or 2). If OK, integer variable iV = 0.
iV = #DLRESET, CV
Resets data logger CV (1 or 2). If OK, integer variable iV = 0.
iV = #DLUPLOAD, CV
Uploads the samples in data logger CV (1 or 2) and saves them to
disk file
Drive_Datalogger_C_NNN_L_YY-MM-DD-HH-MM-SS.txt.
If OK, integer variable iV = 0.

Fault Logger
Statements

iV = #FLUPLOAD
Uploads the faults in the fault logger and saves them to disk file
Drive_Faultlogger_C_NNN_YY-MM-DD-HH-MM-SS.txt.
If OK, integer variable iV = 0.
iV = #FLCLEAR
Clears the fault logger. If OK, integer variable iV = 0.
iV = #FLCOUNT
Reads the fault count of the fault logger and puts the read value to
integer variable iV. If error, iV = -1.

User's Manual

15 - 13

Appendices

Parameter List
Statement

iV = #PARUPLOAD
Uploads the parameter list and saves it to disk file
Drive_Parameters_C_NNN_YY-MM-DD-HH-MM-SS.txt.
If OK, integer variable iV = 0.
If needed, you can use this file in parameter value comparison in the
Parameter Window.

User Function
Statement

iV = #USERFUNCTION

Exit Statement

#EXIT

Executes an user-written C-language function.

See document DD_MLE.PDF (in the DriveDebug directory) for more
information.

Stops the execution of the macro program.

Comment
Statement

15 - 14

; Comment text

User's Manual

Appendices

Notes about the

Macro
Statements

X, Y and Z = Variable ID, Parameter ID, Application variable,

Symbol name or Absolute address
Variable ID = %c (int var, where c is char az or AZ)
%Rc (real var, where c is char az or AZ)
The initial value of all integer and real variables is zero.
C =

signed or hex constant (or &symbol in statement X = C).

Hex constants must be ended with character 'h' (i.e. xxh).

CV = unsigned constant or integer variable (%c)

V =

integer or real variable (%c or %Rc)

iV = integer variable (%c)

oper =

signed operation: +, -, * or /
integer operation: & (AND) or | (OR)

comp =

signed comparison: =, ==, !=, <, <=, > or >=

Parameter ID (nn.nn) must be prefixed by character 'P' (i.e. Pnn.nn)

in order to avoid ambiguity with a constat value in the following
statements:
X=Y
X = Y oper Z
#IF (X comp Y)
#WHILE (X comp Y)
The case of characters P (in Parameter ID) and R (in Variable ID) is
not significant but the case of character c (in Variable ID) is
significant.
Spaces and tabs are insignificant.

User's Manual

15 - 15

Appendices

Example

15 - 16

; Triangle waveform generator.

; Runs forever (stop e.g. by Esc).
; Fictitious param 12.34 used in this example.
; If this parameter is in a MonWin then you
; can see its value during the execution.
;
%D = 1
; Direction (1 = up, -1 = down)
;
12.34 = 0 ; Init value of param 12.34 is zero
;
#WHILE (%z = 0)
; Loop forever
%b = %b + %D
#IF (%b > 100)
%D = -1
; Change direction
#ENDIF
#IF (%b < -100)
%D = 1
; Change direction
#ENDIF
%p = %D * 100
12.34 = 12.34 + %p
#WAIT = 100
; Enables MonWin display
#ENDWHILE

User's Manual

Appendices

Appendix 5
Remote Operation

In the remote mode of DriveDebug there are actually two separate

programs that communicate with each other via a TCP/IP network:
The DriveDebug program (DriveDebug.exe) that runs in a
remote PC. This is called a client program.
The server program runs in the PC that is optically connected to
the drive(s). This program (DDsrvr.exe) is included with the
DriveDebug software package.
Note: A client can use the server only if no other client is using it.
The remote operation may not work if the network between the server
and the client is too slow.

Installation of
the Server
Program
(DDsrvr.exe)

Install DriveDebug into the PC that is optically connected to the drives

(if not yet installed). This PC must be connected to a TCP/IP network,
too.
Start the DDsrvr.exe program in the DriveDebug directory (e.g. by
double-clicking its name).
The DriveDebug directory is specified during the installation of
DriveDebug and the default directory name is
C:\ProgramFiles\DriveWare\DriveDebugx.x
Write down the IP address of this server PC (e.g. 121.111.1.1)
Note: DDsrvr.exe and the DriveDebug program
DriveDebug.exe do not work at the same time in the same PC.

Installation of
the DriveDebug
Program to a
Remote PC

Install DriveDebug into a PC that connected to a TCP/IP network (if

not yet installed). No DriveDebug hardware card is needed.
Create a new directory
Copy all files of the DriveDebug directory to this new directory
Create an icon for the DriveDebug.exe program in the new
directory
Copy the Dwc_ddcp.dll file from the Remote DriveDebug
directory (under the DriveDebug directory) to the new directory. This
file overwrites the existing file with the same name.
Start the Notepad program, write the IP address of the PC where the
DDserver.exe is (e.g. 121.111.1.1) to the screen of the Notepad

User's Manual

15 - 17

Appendices

program and finally save this text line (= IP address) to file

SERV_IP.TXT (to the new directory)
Start the execution of DriveDebug in the remote PC by doubleclicking the new icon

Some
Differences
between the
Local and
Remote Use

In the remote mode:

With fast network the execution time of DriveDebug operations is
about three times longer but with slower networks the execution
time can be much longer
The time scale in Trend Windows (and Recording in Monitor
Window) is not accurate and there is no warning if the sample
interval is too short
Local Control may work with fast network but not with slower
networks
Menu command Target - Restore does not work if the memory of
the target drive is empty.
Target restore operation should always do locally and by using a
point-to-point connection to the drive.

15 - 18

User's Manual

Appendices

Appendix 6
Visual Basic
Interface

Visual Basic (and C) programs can use DriveDebug functions to:

Upload parameter list
Read/write parameter values
Upload Data Logger samples and control Data Logger
Upload fault list and clear Fault Logger
Execute Local Control operations
Transmit and receive datasets
Use the digital and analogue inputs/outputs connected to PC
Visual Basic programs can be either local programs (i.e. they run in a
PC that is optically connected to the drives) or remote programs (i.e.
they run in a remote PC that is connected to the drive PC via a
TCP/IP network).
In addition to the stand-alone MS Visual Basic product, these
functions can be used (in the local mode only) with the Visual Basic
for Applications language that is integrated with MS Excel and other
MS Office products.
The details of the functionality mentioned above are described in
document DD_VB.PDF. This file is in the Visual Basic
Interface directory (under the DriveDebug directory). The
DriveDebug directory is specified during the installation of
DriveDebug and the default directory name is
C:\ProgramFiles\DriveWare\DriveDebugx.x.

User's Manual

15 - 19

Appendices

15 - 20

User's Manual

3AFE 64289918 Rev O

EFFECTIVE: 01.03.20052000
ABB Oy
Drives
P.O.Box 184
FI-00381 HELSINKI
FINLAND
Telephone
Telefax

+ 358 10 22 11
+ 358 10 22 22681