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
Target’s 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 DriveDebug is a Windows based diagnostic tool program for devices

that use the DDCS communication protocol. These devices include
Information 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 target’s parameters (complete or version
update)
• backup and restore of the whole target software
• control of target’s 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 target’s 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 Insert the DriveDebug CD-ROM into the CD drive of your PC.
DriveDebug If you have Windows XP, Windows 2000 or Windows NT4.0:
Software
• 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 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
DriveDebug that.
Hardware
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 • Insert the DDCS card into a vacant PCMCIA slot of the PC.
DDCS PCMCIA • Connect optical cables between the PCMCIA card and the target
Card 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 Note: If you do not know how to install option boards into your PC,
DDCS ISA Board 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 Please follow installation instructions of PCI / PCMCIA adapter.
/ PCMCIA These installation instructions located in adapter readme.txt file.
adapter
Installation order is:
• Software,
• PCI / PCMCIA adapter,
• DriveAP software and DDCS PCMCIA card.

 8VHU V0DQXDO

 Chapter 3 - Use of DriveDebug

Starting the You start the DriveDebug program by double clicking the DriveDebug
icon.
DriveDebug
Program Note: During the startup the program tries to read the application
variable file and/or the symbol file (if defined during the previous
session). If it cannot find the file it displays an error message "Cannot
open file xxxxxx.yyy". You can ignore this error message and
continue but you cannot use any application variables and/or
symbolic addresses during this DriveDebug session.

Screen Layout When the program starts it displays the main Frame Window (usually
full screen) and user-defined child windows (if any) inside the Frame
Window. There are nine types of child windows:

• Target List Window displays the list of all connected targets and
their statuses.
• Monitor Window (one or more) for numerical monitoring and
recording of actual values of user-selected parameters, application
variables, dataset items and/or memory locations from one or
more targets
• Trend Window (one or more) for graphical trending of actual
values of user-selected parameters, application variables, dataset
items and/or memory locations (max 6 items in one Trend
Window) from one or more targets. Min sample time is from 1
msec (if 1 trend) to 6 msec (if 6 trends).
• Parameters Window for upload, compare, change, backup and
restore of the parameters of the current Default Target (the term
Default Target is described in the next section Targets).
• Fault Window for upload, display and clear of the faults of the
current Default Target.
• Data Logger Window (one or more) for control of target’s 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 user-
selected 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 window’s or item’s target.
A target is identified by its channel number (see Chapter 2, section
Installing DriveDebug Hardware) and node number (defined in the
target).

There are three target levels (listed below from the highest level to
the lowest):

• Default Target is the Window Target of all child windows without

user-specified (or system-specified) Window Target. This target is
defined by menu command Target - Change Default Target or by
double clicking on the desired target in the Target List Window (if
this window is visible).
• Window Target of a child window can be the Default Target (this is
the default case) or an user-specified target (defined by menu
command xxxWin - Change Window Target) or a system-
specified target.
• Item Target of an item in a Monitor and Trend Window can be
either the Window Target of item’s window (this is the default
case) or an user-specified target (defined by menu command
xxxWin - Change Item Target).

 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 target’s status bits (Ready / Running / ALARM

/ FAULT) is displayed in text format after target’s channel and node
numbers.

You can update the target list by menu command Target – Update
Target List Window (with Names). This command also reads the
target names.

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

You can select the Default Target from the target list by double
clicking on the desired target in the list.

Colors in the The background color of the Default Target is always black.
Target List
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 = current value of this item
item = parameter, application variable, dataset item
or memory location (symbol or absolute)
comment = optional user-specified comment (special
comments are described in Appendix 2)
address = 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 item’s 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 Application variables (i.e. pins of the blocks of target’s application

Variables 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 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.

Recording 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. 1…500
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

Note: Check the box 16 Data Bits with DPM memory locations of
AC80.

The default layout of a trend item line is as follows:

value item (address)

where: value = current value of this item
item = parameter, application variable, dataset item
or memory location (symbol or absolute)
address = 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 item’s target by clicking the Target button
(or by menu command TrendWin - Change Item Target).

You can change the numeric value display format of the selected
item by menu command TrendWin - Change Num Display Mode
(this command is not available with Real type parameters).
If display mode is Boolean then numeric value 0 is displayed as text
FALSE and any other value is displayed as text TRUE (the value
FALSE is displayed as graph value 0 and TRUE as graph value 1).

If you click on an item line of a Trend Window while holding down the
Alt key then DriveDebug displays the help text of this item (if the help
text exists).

After you have defined one or more items, select the item(s) you
want to display during trending by checking the desired check
box(es) in front of the item definition lines.

After you have checked an item then you can set the Y values of the
selected graph by clicking on the top, middle and/or bottom white Y
value text area. You can change these values at any time later on by
selecting first the desired item and then clicking on the desired Y
value text area (this also enables the vertical scrolling and scaling of
existing trend graphs when the trending has been stopped).

The displayed graph Y value texts are normally signed integers (or
reals), but if the numeric display format of the selected item is Fract
then the Y values are fracts as well.

You set the sampling interval (in milliseconds) by clicking the Interval
button (or by menu command TrendWin - Change Sample
Interval). The minimum value is the same as the number of selected
graphs (i.e. 1…6 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 Helper’s item
list and press the F5 key (or click Helper’s Set Value button). The
Helper List box lists the items that are in the Monitor Window with title
TrendWinHelper. You can put the desired items into this Monitor
Window before you start trending.

With the trending stopped, you can press the mouse button while the
cursor is on the graph area and the numeric values of the samples at
the cursor location are displayed in the list box at the top of the
window on the gray background (the cursor time is displayed above
the graph area). You can move the mouse while holding down the
mouse button. When you release the mouse button then the current
(real-time) values are again displayed in the list box.

You can save the sample values of the selected Trend Window to a
file (in bitmap or text format) by menu command File - Save Current
Window As (with the trending stopped). See sectionTrend Save later
in this chapter.

You can clear the trend graph area by menu command TrendWin -
Clear Graph Area (when the trending is stopped).

Trend Buffer The trend graph area of a Trend Window can horizontally display 500
sample batches (sample intervals). One sample batch contains the
sample values of the user-specified trending items (1…6 items) that
are collected during the time span of the user-specified sampling
interval.

8VHU V0DQXDO 

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 There are two step buttons in the Trend Window:
Torque Steps • 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 target’s fault
• By the RefValue button you can set target’s new reference value

Note: Positive reference = forward and negative reference = reverse.

By means of the Reference scroll bar, you can change the target’s
reference value. The reference is changed by pressing the control’s

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.

Target’s 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 There are two parameter backup/restore modes:

Restore of • Complete (the filename extension of the backup file is PAC)
Parameters 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 You open the Fault Window by menu command Target – Open Fault
Window. During the execution of this command the fault logger of
Window 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 You open a new Data Logger Window by menu command DLogWin
– New Data Logger Window.
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 window’s top left corner
(after the target’s 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 Menu command Target – Data Logger Monitor searches all data
Monitor 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 target’s 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 A new Macro Window is opened by menu command MacroWin -
into an Empty New Macro Window.
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 copies the selected macro text to the clipboard
Ctrl - V pastes the text in the clipboard to the insertion point
Ctrl - X cuts the selected macro text
Del 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 = 0,5
50.01 = 1234.5
70.07 = 2
#TARGET = 0,2
22.05 = 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 First, select the desired items (e.g. parameters) to a Monitor Window.
Monitor Window
Then, save the contents of this Monitor Window (it contains now the
Data into a
current values of the selected items) to a disk file (filename extension
Macro 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 The Macro Execution Window is displayed on the screen during the
execution of a macro. This window can be divided into three areas:
Window
• The top area (the String area) is used to display text strings (e.g.
help texts) to the user.
• The middle area (the Value area) contains the Value input field
and the Enter button (the Enter key can be used instead of this
button)
• The bottom area (the Variable area) contains the Variable input
field and the Set Variable button.

It is possible to create a simple user interface by user interface

statements. Here is an example:

• You can e.g. display help information to the user by macro

statement #PUTSTR = "character string" and read user’s
input by macro statement V = #GETVAL.
• You can write e.g. the default input value by macro statement
#PUTVAL = "character string" (before the V = #GETVAL
statement) and if the user accepts this default value (s)he can
continue by pressing only the Enter key.
• If the user wrote an invalid value then you can display an error
message e.g. by macro statement #MSGBOX = "character
string".

The Value input field and the Enter button can be removed by macro
statement #SHOWGETVAL = 0.

The V = #GETVAL statement above halts the execution of the macro

until the user presses the Enter key.
You can set values of macro variables (%c and %Rc) "on the fly" (i.e.
without halting the macro execution) by writing the value setting
command (e.g. %k=123) to the Variable input field and clicking the
Set Variable button.

Note that it is a good practice to read the value of this variable only in
one statement in the macro (e.g. by statement %p = %k) because it
is not possible to know where the execution of the macro is when the
user clicks the Set Variable button.

The Variable input field and the Set Variable button can be removed
by macro statement #SHOWSETVAR = 0.

 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 Using this command you can save the data of the selected window to
a file.
Window As 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 Using this command you can print the graphs of the selected Trend
Window.
Window
Display Trend Text Using this command you can display the contents of a previously
saved trend file (the trends must have been saved in the text format,
File not in the graph format).

Note: If DriveDebug displays error message "Parameter list has not

been uploaded" then you have to upload the parameter list before
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 Using this command you can display the contents of a previously
saved recorder file.
File When you have selected the recorder file then you can select the
recorder items (1…6 items) for display.

Note: If DriveDebug displays error message "Parameter list has not

been uploaded" then you have to upload the parameter list before
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 This command displays the name and date of the symbol file that is
currently in use.
File 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 This command displays the name and date of the application variable
file that is currently in use.
File This command is grayed out if DriveDebug has not found an
application variable file.

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

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

The File Operations commands show the relationship between the

AC80 Window File above mentioned long "virtual" file names of Save/Open and the
Operations short (normally invisible) "real" DOS filenames (8+3 characters,
Trend Window File generated automatically by DriveDebug). You can delete, rename
and/or copy these DOS files.
Operations
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 This command removes the selected Macro Window text from the
screen (or the next character of the window if no text selected).

8VHU V0DQXDO 

(GLW0HQX

 8VHU V0DQXDO

 Chapter 6 - Target Menu

Open Target List This command displays the list of all targets connected to the PC and
their statuses.
Window
Update Target List This command updates the target list and also reads the names of
the targets.
Window (with
Names) Note: This command is available only if you have opened the Target
List Window by menu command Target - Open Target List Window.

Change Default 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
Target 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 This command opens the Control Panel Window (see Chapter 3,
section Control Panel).
Panel
Open Parameter This command opens the Parameter Window (see Chapter 3, section
Parameter Window).
Window
Open Fault This command opens the Fault Window and uploads the items of the
fault logger of the Default Target.
Window
Data Logger This command displays the Data Logger Monitor Window (see
Chapter 3, section Data Logger Monitor).
Monitor
Backup This command backups the whole Default Target software to a
Backup file (the filename extension of the Backup file is TAR).

Note: Use the Backup button of the Parameter Window if you want
to backup only parameters.

Restore This command restores the contents of a Backup file to the Default
Target.

8VHU V0DQXDO 

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 This command enables the communication with the target(s).

Communication

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

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

Comm Statistics This command displays communication statistics (cumulative values

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

 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 Using this command you can restore a previously saved DriveDebug
configuration (see the Save Configuration command below).
Configuration
Save Configuration Using this command you can save the current DriveDebug
configuration (all definitions of all Monitor, Trend and Macro
Windows) to a file. The Frame Window title is used as the file name.

Note: You can delete configuration files using menu command File -
Configuration File Operations.

8VHU V0DQXDO 

&RQILJ0HQX

 8VHU V0DQXDO

 Chapter 8 - MonWin Menu

New Monitor Using this command you can create a new Monitor Window.
Window
Change Window Using this command you can change the window title of the selected
Monitor Window (max 80 characters).
Title 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 Using this command you can change the target of the selected
Monitor Window. If the Window Target is not specified as the Default
Target 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 Using this command you can add a previously saved Monitor Window
(see the Save Monitor Window command below) to the current
Window configuration.

Save Monitor 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.
Window
Note: You can delete window definition files using menu command
File - Monitor Window File Operations.

Add Symbol Using this command you can add a symbol (or an array of memory
locations starting from this symbol) after the selected line in the
active Monitor Window (or to the end of the list if no line is selected).
As you type the symbol name the symbol list scrolls automatically to
display the first 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.

8VHU V0DQXDO 

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).
The Apply (= Alt + A) button works as the OK button but the dialog
box does not disappear and you can immediately type a new
address.

Note: Check the box 16 Data Bits with DPM memory locations of
AC80.

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

If you want to add several parameters to the Monitor Window, first

select one parameter by clicking on it in the parameter list and then

• select the other parameters by clicking on them while holding

down the Ctrl key (if you want to select individual parameters) or
• click on the last parameter of the range while holding down the
Shift key (if you want to select a range of parameters)

Finally click OK or Apply (= Alt + A).

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

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

Search/Update This command scans all memory location items of the selected
Monitor Window. If the absolute address of an item is the same as
Symbols 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 Using this command you can change the display mode of the actual
value of the selected item in the active Monitor Window.
Mode If display mode is Boolean then numeric value 0 is displayed as text
FALSE and any other value is displayed as text TRUE.

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

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

Change Item 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
Target 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 This command (or Ctrl-F5) undoes the previous value setting.
Setting Note: It is not possible to undo if you have changed the active child
window after the value setting.

Start/Stop This command either displays the Value Recorder dialog box or stops
the recording (see Chapter 3, section Recording for details).
Recorder
Change Line Using this command you can:
Layout • specify the number of spaces (1...9) between the value text and
the item name text.

8VHU V0DQXDO 

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
Monitor and Trend Windows.

 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 Using this command you can change the window title of the selected
Trend Window (max 80 characters).
Title 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 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 Target then the channel and node numbers of the Window Target are
shown before the title of the window.

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

Save Trend 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.
Window
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.

Note: Check the box 16 Data Bits with DPM memory locations of an
AC80.

Abs Address Using this command you can replace the selected item in the
selected Trend Window with an absolute address.

Note: Check the box 16 Data Bits with DPM memory locations of an
AC80.

Parameter Using this command (or by clicking the Param button) you can
replace the selected item in the selected Trend Window with a
parameter.

8VHU V0DQXDO 

7UHQG:LQ0HQX

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

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

Display Helper List This command (or the F7 key) displays a dialog box that contains the
items of the Monitor Window with title TrendWinHelper.
You create this Monitor Window and put the desired items into this
Monitor Window before you start trending.

By this dialog box you can set values of the items in the dialog box
and/or copy items from the dialog box to Trend Window.

Change Num Using this command you can change the numeric display mode of
the actual value of the selected item in the selected Trend Window.
Display Mode If display mode is Boolean then numeric value 0 is displayed as text
FALSE and any other value is displayed as text TRUE (the value
FALSE is displayed as graph value 0 and TRUE as graph value 1).

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

Set Item Value Using this command (or by pressing F5) you can set the value of the
selected item in the selected Trend Window (the current value is
displayed in the value dialog box for editing).

Note: You can start typing value characters without selecting this
command (or pressing the F5 key) because the value dialog box
appears automatically when you have entered the first value
character.

Note: If you want to set (during trending) the value of an item that is
not in the Trend Window then you can display the Helper List box by
the F7 key (or by the List button), select an item from Helper’s item
list and press the F5 key (or click Helper’s Set Value button). The
Helper List box lists the items that are in the Monitor Window with title
TrendWinHelper. You can put the desired items into this Monitor
Window before you start trending.

Undo Item Value This command (or the pressing of the Ctrl-F5 keys) undoes the
previous value setting.
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 Using this command (or by clicking the Interval button) you can set
the sampling interval (in milliseconds). The minimum value is the
Interval same as the number of selected graphs (i.e. 1…6 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 This command (or the F4 key) starts (or stops) the trending. You can
change item definitions and selections, sample interval and Y values
Trending 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 You can select an item in the item list box using the up and down
keys or by clicking on an item name text.
Keyboard
Operations 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.

Vertical Scrolling Note: The increment in the following operations is half of current area
and Scaling 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 Note: Trending must be stopped and the trend buffer defined.
Scrolling and By holding down the Alt key and pressing the right or left key you
Scaling 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 This command creates a new (empty) Macro Window.

Open Macro 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.

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 is displyed on the screen during the

execution of the macro and you can create a simple user interface by
using this window.

It is possible to read from one file and to write to one file during the
execution of a macro by macro statements #FILENAMEIN =
"filename", #FILENAMEOUT = "filename", V = #FILEIN,
#FILEINRESET and #FILEOUT = ....

You can create a chain of macros by using macro statement

#GOTOMACRO = "macrofilename".

During the execution of some macro statements (e.g. wait

statements) DriveDebug can update numeric values of the items in
Monitor and Trend Windows.

You can stop the execution of the macro by pressing the Esc key.

8VHU V0DQXDO 

0DFUR:LQ0HQX

Execute Selected This command starts the execution of the selected macro statement
lines of the selected Macro Window.
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 is displyed on the screen during the

execution of the macro and you can create a simple user interface by
using this window.

It is possible to read from one file and to write to one file during the
execution of a macro by macro statements #FILENAMEIN =
"filename", #FILENAMEOUT = "filename", V = #FILEIN,
#FILEINRESET and #FILEOUT = ....

You can create a chain of macros by using macro statement

#GOTOMACRO = "macrofilename".

During the execution of some macro statements (e.g. wait

statements) DriveDebug can update numeric values of the items in
Monitor and Trend Windows.

You can stop the execution of the macro by pressing the Esc key.

 8VHU V0DQXDO

 Chapter 12 - DLogWin Menu

See also Chapter 3, section Data Logger Window.

New Data Logger This command creates a new (empty) Data Logger Window.
Window
Change Window Using this command you can change the window title of the selected
Data Logger Window (max 80 characters).
Title
Read Data Logger Using this command you can read the definitions (and triggering time
if triggered) of the data logger.
Info
Initialize Data Using this command you can define the data logger settings.
Logger
Using this command you can manually start, stop, trigger or reset the
Data Logger data logger.
Control
Upload Data Using this command you can upload the collected samples.
Logger Samples
Numeric Display of Using this command you can display the uploaded sample values in
numeric form.
Samples

8VHU V0DQXDO 

'/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 This command displays the DriveDebug information box.

8VHU V0DQXDO 

+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 Param Meaning and Values

Parameters T By this parameter DriveDebug is always the
topmost program on the screen.
Example: /T

D 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

L This parameter starts the data logger monitoring

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

N This parameter prevents the display of window

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

S 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

K 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 = definition string
Comment = optional text string
Note: No space characters are allowed before the "]" character!

The allowable definition string formats are as follows:

Format Effect
=nnn Item line text is red if item’s value is equal to nnn
==nnn Item line text is red if item’s value is equal to nnn
!=nnn Item line text is red if item’s value is not equal to nnn
>nnn Item line text is red if item’s value is greater than nnn
>=nnn Item line text is red if item’s value is greater or equal than nnn
<nnn Item line text is red if item’s value is lesser than nnn
<=nnn Item line text is red if item’s value is lesser or equal than nnn
&nnn Item line text is red if item’s value AND nnn is not zero

Value Type If used with a Real type parameter then the value string nnn is
Interpretation 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 target’s dataset nn, reads
the values of target’s next dataset and puts the read values to the
next three integer variables.
Example: Statement .DS1 = %k puts the values of variables %k,
%l and %m to target’s dataset 1 and reads the values of target’s
dataset 2 to variables %n, %o and %p.

iV = .DSnn

This statement reads the values of target’s dataset nn and puts the
read values to integer variable iV and to the next two integer
variables.
Example: Statement %x = .DS11 reads the values of target’s
dataset 11 to variables %x, %y and %z.

Macro chaining statement:

#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

This statement converts the (integer or real) variable V to a character

string and appends this string to the content of the String area of the
Macro Execution Window.

#PUTSTR = "character string"

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

This statement converts the (integer or real) variable V to a character

string and appends this string to the content of the Value input field of
the Macro Execution Window.

#PUTVAL = "character string"

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.
During the execution of this statement DriveDebug updates the
numeric values of the items in Monitor and Trend Windows.

 8VHU V0DQXDO

 $SSHQGLFHV

#MSGBOX = "character string"

This statement displays a message box with the character

string.
During the execution of this statement DriveDebug updates the
numeric values of the items in Monitor and Trend Windows.
The execution of the macro continues when the user has clicked the
OK button of the message box.

#MSGBOX = #FILEIN

This statement reads a character line from the input file and displays
a message box with the read line.
During the execution of this statement DriveDebug updates the
numeric values of the items in Monitor and Trend Windows.
The execution of the macro continues when the user has clicked the
OK button of the message box.

#SHOWGETVAL = C

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 X, Y and Z = Variable ID, Parameter ID, Application variable,
Macro Symbol name or Absolute address
Statements
Variable ID = %c (int var, where c is char a…z or A…Z)
%Rc (real var, where c is char a…z or A…Z)
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

; Triangle waveform generator.

Example ; 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

8VHU V0DQXDO 

$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 Install DriveDebug into the PC that is optically connected to the
Server Program drives (if not yet installed). This PC must be connected to a TCP/IP
network, too.
(DDsrvr.exe)
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 Install DriveDebug into a PC that connected to a TCP/IP network (if
DriveDebug not yet installed). No DriveDebug hardware card is needed.
Program to a
Create a new directory
Remote PC
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 double-

clicking the new icon

Some In the remote mode:

Differences • With fast network the execution time of DriveDebug operations is
between the about three times longer but with slower networks the execution
Local and time can be much longer
Remote Use • 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 Visual Basic programs (running under Windows XP, Windows 2000
and Windows NT) can use DriveDebug functions to:
Interface
• 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 + 358 10 22 11
Telefax + 358 10 22 22681