DriveDebug User Manual

Drive:DUH
8VHU
V0DQXDO
Drive'HEXJ
Drive'HEXJ
8VHU
V0DQXDO
Drive:DUH
Code: 3AFE 64289918 R0125 Rev N
EFFECTIVE: 31.05.2002
SUPERSEDES: 11.02.2002
2002 ABB Oy. All rights reserved.
Table of Contents
7DEOHRI&RQWHQWV Y
&KDSWHU*HQHUDO
General Information................................................................................................................................. 1-1
&KDSWHU,QVWDOODWLRQRI'ULYH'HEXJ
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
&KDSWHU8VHRI'ULYH'HEXJ
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 ................................................................................................................................................ 3-3
Application Variables ..................................................................................................................... 3-5
Pin Connections ............................................................................................................................ 3-6
Recording ................................................................................................................................................ 3-6
Trending................................................................................................................................................... 3-7
Trend Buffer .................................................................................................................................. 3-9
Speed and Torque Steps ............................................................................................................ 3-10
Trend Save.................................................................................................................................. 3-10
Control Panel ......................................................................................................................................... 3-11
Targets Status ............................................................................................................................ 3-12
Parameter Window................................................................................................................................ 3-12
Backup and Restore of Parameters ............................................................................................ 3-12
Fault Logger Window............................................................................................................................. 3-13
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-18
Definition Files ....................................................................................................................................... 3-19
Help ....................................................................................................................................................... 3-19
Exit......................................................................................................................................................... 3-19
&KDSWHU)LOH0HQX
Save Current Window As ........................................................................................................................ 4-1
Print Current Window .............................................................................................................................. 4-1
Display Trend Text File............................................................................................................................ 4-1
Display Recorder File .............................................................................................................................. 4-1
Current Symbol File ................................................................................................................................. 4-2
Select Symbol File ................................................................................................................................... 4-2
Current Appl Var File ............................................................................................................................... 4-2
Select Appl Var File ................................................................................................................................. 4-2
8VHU
V0DQXDO
Y
7DEOHRI&RQWHQWV
Configuration File Operations .................................................................................................................. 4-2
Monitor Window File Operations ............................................................................................................. 4-2
AC80 Window File Operations ................................................................................................................ 4-2
Trend Window File Operations ................................................................................................................ 4-2
Exit........................................................................................................................................................... 4-2
&KDSWHU(GLW0HQX
Cut ........................................................................................................................................................... 5-1
Copy ........................................................................................................................................................ 5-1
Paste........................................................................................................................................................ 5-1
Delete ...................................................................................................................................................... 5-1
&KDSWHU7DUJHW0HQX
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
&KDSWHU&RQILJ0HQX
New Configuration ................................................................................................................................... 7-1
Change Title ............................................................................................................................................ 7-1
Open Configuration.................................................................................................................................. 7-1
Save Configuration .................................................................................................................................. 7-1
&KDSWHU0RQ:LQ0HQX
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-2
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
YL
8VHU
V0DQXDO
7DEOHRI&RQWHQWV
&KDSWHU$&:LQ0HQX
New AC80 Window.................................................................................................................................. 9-1
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
&KDSWHU7UHQG:LQ0HQX
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
&KDSWHU0DFUR:LQ0HQX
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
&KDSWHU'/RJ:LQ0HQX
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
&KDSWHU:LQGRZV0HQX
8VHU
V0DQXDO
YLL
7DEOHRI&RQWHQWV
Tile ......................................................................................................................................................... 13-1
Cascade................................................................................................................................................. 13-1
Arrange Icons ........................................................................................................................................ 13-1
Close All................................................................................................................................................. 13-1
&KDSWHU+HOS0HQX
Contents ................................................................................................................................................ 14-1
About DriveDebug ................................................................................................................................. 14-1
&KDSWHU$SSHQGLFHV
$SSHQGL[
Startup Parameters ............................................................................................................................... 15-1
Table of Startup Parameters ....................................................................................................... 15-2
$SSHQGL[
Special Comments ................................................................................................................................ 15-3
Value Type Interpretation ............................................................................................................ 15-3
$SSHQGL[
AC80 and NCB ...................................................................................................................................... 15-4
$SSHQGL[
Macro Language.................................................................................................................................... 15-5
Notes about the Macro Statements........................................................................................... 15-12
Example .................................................................................................................................... 15-13
$SSHQGL[
Remote Operation ............................................................................................................................... 15-15
Installation of the Server Program (DDsrvr.exe) ....................................................................... 15-15
Installation of the DriveDebug Program to a Remote PC.......................................................... 15-15
Some Differences between the Local and Remote Use ........................................................... 15-16
$SSHQGL[
Visual Basic Interface .......................................................................................................................... 15-17
YLLL
8VHU
V0DQXDO
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. ACS 600 and AC80.
DriveDebug is designed to run under the Microsoft Windows XP,
Windows 2000, Windows NT 4.0, Windows 95/98 or Windows 3.x
operating environment on IBM-compatible PCs.
The following functions can be performed by using Drive Debug:
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 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)
8VHU
V0DQXDO

*HQHUDO
saving/restoring the current DriveDebug configuration to/from a

disk file
saving/restoring the definitions of the selected window to/from disk
files
saving the data of the selected window to a file
remote operation
Other features related to DriveDebug:

possibility to create Visual Basic applications that use drive data
(e.g. parameters and datasets)
possibility to translate DriveDebug to other languages than English
by separate text files (a file with Finnish texts is included)

8VHU
V0DQXDO
Chapter 2 Installation of DriveDebug

Installing
DriveDebug
Software
Insert the DriveDebug CD-ROM into the CD drive of your PC.

If you have Windows XP, Windows 2000 or Windows NT4.0:
Note: You must have Administrator privileges to your PC.
You PC may be configured such in way that when you insert the
DriveDebug installation CD into your CD drive, installation start
automatically. If not start installation manually.
Start the Control Panel program and double click on its
Add/Remove Programs icon.
Click the Install button.
If you have Windows 95/98 or Windows 3.x:

In the File Manager program, select the drive containing the
DriveDebug CD-ROM.
Launch the SETUP3X.EXE file (not the SETUP.EXE file).
Follow the instructions that appear on the screen.

If you have Windows 95 or Windows 98 and you are installing
DriveDebug first time to your laptop PC (and you have not installed
DriveWindow earlier) you will find PCMCIA drivers from CD-ROM
directory DDCS Link Card Installation Disk.
After the installation you can add the required startup parameters (as
described in Appendix 1) if the default values of the startup
parameters are not suitable.
Installing
DriveDebug
Hardware
If you are using DDCS PCMCIA card with windows XP, with Windows
2000 or with Windows Nt 4.0 install software first and hardware after
that.
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)
8VHU
V0DQXDO

,QVWDOODWLRQRIDrive'HEXJ
boards immediately after installing DriveDebug under Windows 2000

and Windows XP. You have to tell Windows their presence first (Add
Hardware).
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 located in adapter readme.txt file.
Installation order is:

Software,
PCI / PCMCIA adapter,
DriveAP software and DDCS PCMCIA card.
8VHU
V0DQXDO
Chapter 3 - Use of DriveDebug

Starting the
DriveDebug
Program
Screen Layout
You start the DriveDebug program by double clicking the DriveDebug

icon.
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.
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).
8VHU
V0DQXDO

8VHRIDrive'HEXJ
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 windows or items 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 items window (this is the default
case) or an user-specified target (defined by menu command
xxxWin - Change Item Target).

8VHU
V0DQXDO
8VHRIDrive'HEXJ
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 targets status bits (Ready / Running / ALARM
/ FAULT) is displayed in text format after targets 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
When you want to monitor a data item (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):
Parameter is added by menu command MonWin - Add
Parameter
8VHU
V0DQXDO

8VHRIDrive'HEXJ
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).
You remove the selected item line by menu command MonWin Remove Item.

8VHU
V0DQXDO
8VHRIDrive'HEXJ
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.
8VHU
V0DQXDO

8VHRIDrive'HEXJ
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
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 the contents of the recorder file e.g. by menu
command File - Display Recorder File.

8VHU
V0DQXDO
8VHRIDrive'HEXJ
Trending
When you want to start the graphical trending 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
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.
8VHU
V0DQXDO

8VHRIDrive'HEXJ
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).
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).

8VHU
V0DQXDO
8VHRIDrive'HEXJ
You start (and stop) the trending by pressing the F4 key (or by menu
command TrendWin - Start/Stop Trending).
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 Helpers item
list and press the F5 key (or click Helpers 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
8VHU
V0DQXDO
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.

8VHRIDrive'HEXJ
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 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
th
Shift key. The compressing means that every 10 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

8VHU
V0DQXDO
8VHRIDrive'HEXJ
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
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 read the saved text file e.g. by:
Menu command File - Display Trend Text File or
The Excel program. Please note that you must set the value of the
Decimal symbol to dot . by the Control Panel program before you
start Excel.
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 push 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 targets fault
By the RefValue button you can set targets new reference value
Note: Positive reference = forward and negative reference = reverse.
By means of the Reference scroll bar, you can change the targets
reference value. The reference is changed by pressing the controls
8VHU
V0DQXDO

8VHRIDrive'HEXJ
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.
Targets Status
The status info of the target is displayed at the bottom of the Control
Panel.
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 pressing 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

8VHU
V0DQXDO
8VHRIDrive'HEXJ
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
You open the Fault Window by menu command Target Open Fault
Window. During the execution of this command the fault logger of
the Default Target is uploaded and displayed in the Fault Window
(active items in the list are marked with +).
You can clear the fault logger by pressing 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
8VHU
V0DQXDO

8VHRIDrive'HEXJ
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.
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 read the saved text file by the Excel program.
Please note that 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.

8VHU
V0DQXDO
8VHRIDrive'HEXJ
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
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.
Note: If DriveDebug displays error message "Parameter list has not
been uploaded" then you have to upload the parameter list before
you can start the execution of the macro (use menu command
MonWin Add Parameter).
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 = ....
8VHU
V0DQXDO

8VHRIDrive'HEXJ
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.
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).

8VHU
V0DQXDO
8VHRIDrive'HEXJ
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 File Manager 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.
8VHU
V0DQXDO

8VHRIDrive'HEXJ
Macro Execution
Window
The Macro Execution Window is displayed on the screen during the

execution of a macro. This window can be divided into three areas:
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 users
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.

8VHU
V0DQXDO
8VHRIDrive'HEXJ
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
DriveDebug 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.
8VHU
V0DQXDO

8VHRIDrive'HEXJ

8VHU
V0DQXDO
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
Display Trend Text
File
Using this command you can print the graphs of the selected Trend
Window.
Using this command you can display the contents of a previously
saved trend file (the trends must have been saved in the text format,
not in the graph format).
you can display the file (use menu command MonWin Add
Parameter).
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 the contents of a previously

saved recorder file.
When you have selected the recorder file then you can select the
recorder items (16 items) for display.
you can display the file (use menu command MonWin Add
Parameter).
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 recorder file.
8VHU
V0DQXDO

)LOH0HQX
You can scroll and scale the trends in this new Trend Window (and
even start a new trending, if needed).
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.
Configuration File
Operations
Monitor Window
File Operations
The current DriveDebug configuration and/or the definitions of the

selected Monitor or Trend Window are saved/restored using the
Save/Open commands in the Config, MonWin, AC80Win and
TrendWin menus. These commands use window titles as file names
(max length 80 characters).
AC80 Window File

Operations
Trend Window File
Operations
The File Operations commands show the relationship between the

above mentioned long "virtual" file names of Save/Open and the
short (normally invisible) "real" DOS filenames (8+3 characters,
generated automatically by DriveDebug). You can delete, rename
and/or copy these DOS files.
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 DriveDebug 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.

8VHU
V0DQXDO
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
8VHU
V0DQXDO
This command removes the selected Macro Window text from the
screen (or the next character of the window if no text selected).

(GLW0HQX

8VHU
V0DQXDO
Chapter 6 - Target Menu

Open Target List
Window
Update Target List
Window (with
Names)
Change Default
Target
This command displays the list of all targets connected to the PC and
their statuses.
This command updates the target list and also reads the names of
the targets.
Note: This command is available only if you have opened the Target
List Window by menu command Target - Open Target List Window.
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: 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
Open Parameter
Window
Open Fault
Window
Data Logger
Monitor
Backup
This command opens the Control Panel Window (see Chapter 3,

section Control Panel).
This command opens the Parameter Window (see Chapter 3, section
Parameter Window).
This command opens the Fault Window and uploads the items of the
fault logger of the Default Target.
This command displays the Data Logger Monitor Window (see
Chapter 3, section Data Logger Monitor).
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
8VHU
V0DQXDO
This command restores the contents of a Backup file to the Default

Target.

7DUJHW0HQX
Note: The node number of the Default Target after the Restore will
be the same as it was during the 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).
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).
Comm Statistics

Note: The communication is always disabled when DriveDebug is

minimized (iconic).
This command displays communication statistics (cumulative values
since the startup of the DriveDebug and since the opening of this
statistics box).
8VHU
V0DQXDO
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
Save Configuration
Using this command you can restore a previously saved DriveDebug

configuration (see the Save Configuration command below).
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.
Note: You can delete configuration files using menu command File Configuration File Operations.
8VHU
V0DQXDO

&RQILJ0HQX

8VHU
V0DQXDO
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.
Note: You can delete window definition files using menu command
File - Monitor Window File Operations.
Add Symbol
8VHU
V0DQXDO
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 parameter name whose initial letters match the
characters you have typed. In this way you can quickly find the name
of the desired symbol if the symbol list is long.
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.

0RQ:LQ0HQX
Note: Check the box 16 Data Bits with DPM memory locations of an
AC80.
Add Abs Address
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).
box does not disappear and you can immediately type a new
address.
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).
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).
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,

8VHU
V0DQXDO
0RQ:LQ0HQX
automatically replace the absolute address items with the names of

the symbols whose absolute addresses lie within this memory
location array.
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.
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
Start/Stop
Recorder
Change Line
Layout
8VHU
V0DQXDO
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.
This command either displays the Value Recorder dialog box or stops
the recording (see Chapter 3, section Recording for details).
Using this command you can:
specify the number of spaces (1...9) between the value text and
the item name text.

0RQ:LQ0HQX
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
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

8VHU
V0DQXDO
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).
8VHU
V0DQXDO

$&:LQ0HQX

8VHU
V0DQXDO
Chapter 10 - TrendWin Menu

New Trend Window
Using this command you can create a new Trend Window.
Change Window
Title
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.
Note: You can delete window definition files by menu command File Trend Window File Operations.
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 parameter name whose initial letters
match the characters you have typed. In this way you can quickly find
the name of the desired symbol if the symbol list is long.
AC80.
Abs Address
selected Trend Window with an absolute address.
AC80.
Parameter
8VHU
V0DQXDO
Using this command (or by clicking the Param button) you can
replace the selected item in the selected Trend Window with a
parameter.

7UHQG:LQ0HQX
Appl Variable
selected Trend Window with an application variable.
See Chapter 3, section Application Variables for details.
Dataset Item
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.
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 Helpers item
list and press the F5 key (or click Helpers 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.

8VHU
V0DQXDO
7UHQG:LQPHQX
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.
8VHU
V0DQXDO

7UHQG:LQ0HQX
Horizontal
Scrolling and
Scaling

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).
8VHU
V0DQXDO
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.
8VHU
V0DQXDO

0DFUR:LQ0HQX
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.

8VHU
V0DQXDO
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
Read Data Logger
Info
Initialize Data
Logger
Data Logger Window (max 80 characters).
Data Logger
Control
Upload Data
Logger Samples
Numeric Display of
Samples
8VHU
V0DQXDO
Using this command you can read the definitions (and triggering time
if triggered) of the data logger.
Using this command you can define the data logger settings.
Using this command you can manually start, stop, trigger or reset the
data logger.
Using this command you can upload the collected samples.
Using this command you can display the uploaded sample values in
numeric form.

'/RJ:LQ0HQX

8VHU
V0DQXDO
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.
8VHU
V0DQXDO

:LQGRZV0HQX

8VHU
V0DQXDO
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
8VHU
V0DQXDO
This command displays the DriveDebug information box.

+HOS0HQX

8VHU
V0DQXDO
Chapter 15 - Appendices
Appendix 1
Startup Parameters
By adding or modifying the startup parameters, you can customize

your copy of the DriveDebug program. The startup parameters are
used in the properties definition of the DriveDebug icon.
You can set/change values of the startup parameters in the following
way:
Stop DriveDebug (if it is running) and click (only once!) the
DriveDebug icon
On Windows XP, Windows 2000 or Windows NT:
select command File - Properties in the DriveDebug folder
click on the tab Shortcut
add the required startup parameters to the end of the Target line
as follows
path\DRIDEB.EXE /X /Y ...
click the OK button
On Windows 3.x:
select Program Manager command File - Properties
add the required startup parameters to the end of the Command
Line as follows
path\DRIDEB.EXE /X /Y ...
click the OK button
Startup parameters are listed on the following page.
8VHU
V0DQXDO

$SSHQGLFHV
Table of Startup
Parameters

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
8VHU
V0DQXDO
$SSHQGLFHV
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 items value is equal to nnn
Item line text is red if items value is equal to nnn
Item line text is red if items value is not equal to nnn
Item line text is red if items value is greater than nnn
Item line text is red if items value is greater or equal than nnn
Item line text is red if items value is lesser than nnn
Item line text is red if items value is lesser or equal than nnn
Item line text is red if items 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.
8VHU
V0DQXDO

$SSHQGLFHV
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.

8VHU
V0DQXDO
$SSHQGLFHV
Appendix 4
Macro Language
Summary of 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
#EXIT
8VHU
V0DQXDO

$SSHQGLFHV
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).

8VHU
V0DQXDO
$SSHQGLFHV
Dataset statements:
.DSnn = iV
This statement puts the value of the integer variable iV and the
values of the next two integer variables to targets dataset nn, reads
the values of targets 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 targets dataset 1 and reads the values of targets
dataset 2 to variables %n, %o and %p.
iV = .DSnn
This statement reads the values of targets 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 targets
dataset 11 to variables %x, %y and %z.
Macro chaining statement:

#GOTOMACRO = "macrofilename"
This statement 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.
8VHU
V0DQXDO

$SSHQGLFHV
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
This statement 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
This statement moves the read position of the input file back to the
beginning of the file.
#FILEOUT = V
This statement converts the (integer or real) variable V to a character
string and writes this string to the output file.
#FILEOUT = "character string"
This statement 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.

8VHU
V0DQXDO
$SSHQGLFHV
#FILEOUT = #FILEIN
This statement 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
This statement writes the current date and time (e.g. 12/27/01
13:28:57) to the output file.
#FILEOUT = #GETVAL
This statement 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
string and appends this string to the content of the String area of the
Macro Execution Window.
#PUTSTR = "character string"
This statement 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.
8VHU
V0DQXDO

$SSHQGLFHV
#PUTSTR = #FILEIN
This statement 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
string and appends this string to the content of the Value input field of
the Macro Execution Window.
#PUTVAL = "character string"
This statement 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
This statement 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
This statement 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.

8VHU
V0DQXDO
$SSHQGLFHV
#MSGBOX = "character string"

This statement displays a message box with the character
string.
The execution of the macro continues when the user has clicked the
OK button of the message box.
#MSGBOX = #FILEIN
This statement reads a character line from the input file and displays
a message box with the read line.
The execution of the macro continues when the user has clicked the
OK button of the message box.
#SHOWGETVAL = C
This statement 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
This statement 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.
Exit statement:
#EXIT
Stops the execution of the macro program.
Comment statement:
; Comment text
8VHU
V0DQXDO

$SSHQGLFHV
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.

8VHU
V0DQXDO
$SSHQGLFHV
Example
8VHU
V0DQXDO
; 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

$SSHQGLFHV

8VHU
V0DQXDO
$SSHQGLFHV
Appendix 5
Remote Operation
The remote operation is possible with Windows Xp, with Windows

2000 or with Windows NT.
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 (DRIDEB.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: ''VUYUH[H and the DriveDebug program '5,'(%(;( 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 DRIDEB.EXE program in the new directory (do
not forget to check the "Run in Separate Memory" check box in the
icon definition dialog box)
8VHU
V0DQXDO

$SSHQGLFHV
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
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.

8VHU
V0DQXDO
$SSHQGLFHV
Appendix 6
Visual Basic
Interface
Visual Basic programs (running under Windows XP, Windows 2000

and Windows NT) 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.
8VHU
V0DQXDO

$SSHQGLFHV

8VHU
V0DQXDO
3AFE 64289918 R0125 Rev N

EFFECTIVE: 31.05.20022000
$%%2\
Drives
P.O.Box 184
FIN-00381 HELSINKI
FINLAND
Telephone
Telefax
+ 358 10 22 11
+ 358 10 22 22681

DriveDebug User Manual

Загружено:

Сведения о документе

Авторское право

Доступные форматы

Поделиться этим документом

Поделиться или встроить документ

Параметры публикации

Этот документ был вам полезен?

Это неприемлемый материал?

Авторское право:

Доступные форматы

DriveDebug User Manual

Загружено:

Авторское право:

Доступные форматы

Drive:DUH

2002 ABB Oy. All rights reserved.

DriveDebug is a Windows based diagnostic tool program for devices

saving/restoring the current DriveDebug configuration to/from a

Other features related to DriveDebug:

Chapter 2 Installation of DriveDebug

Insert the DriveDebug CD-ROM into the CD drive of your PC.

If you have Windows 95/98 or Windows 3.x:

Follow the instructions that appear on the screen.

boards immediately after installing DriveDebug under Windows 2000

Installing the PCI

Please follow installation instructions of PCI / PCMCIA adapter.

Chapter 3 - Use of DriveDebug

You start the DriveDebug program by double clicking the DriveDebug

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

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

Target List Window

The background color of the Default Target is always black.

If there are no faults in the targets then the background color of

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

When you want to monitor a data item (or an array of memory

Application variable is added by menu command MonWin - Add

current value of this item

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

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

current value of this item

There are two step buttons in the Trend Window:

the filename extension because DriveDebug appends it automatically

The Control Panel is opened by menu command Target Open

The Parameter Window is opened by menu command Target

There are two parameter backup/restore modes:

other targets connected to the PC in addition to the Default Target)

You open a new Data Logger Window by menu command DLogWin

Menu command Target Data Logger Monitor searches all data

If a data logger has been triggered then DriveDebug:

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

You can create a chain of macros by using macro statement

Write the Macro

copies the selected macro text to the clipboard

Example: Write the following assignment statements into your new

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

Example: Insert the SPEED SCALING parameters (assume 50.01) of

The Macro Execution Window is displayed on the screen during the

You can save the current DriveDebug configuration (the definitions of

Menu command Help Contents displays the main index of the

Chapter 4 - File Menu

Using this command you can display the contents of a previously

Select Symbol File

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

Current Appl Var

Select Appl Var

The current DriveDebug configuration and/or the definitions of the

AC80 Window File

The File Operations commands show the relationship between the

When you exit DriveDebug, all configuration settings of all current

Chapter 5 - Edit Menu

This command copies the selected Macro Window text to the

This command copies the selected Macro Window text to the

Chapter 6 - Target Menu

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

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

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

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

Note: The communication is always disabled when DriveDebug is