drivedebug user manual

Drive:DUH 8VHUV�0DQXDO

Drive'HEXJ

Drive'HEXJ

8VHUV�0DQXDO

Drive:DUH

Code: 3AFE 64289918 R0125 Rev N

EFFECTIVE: 31.05.2002SUPERSEDES: 11.02.2002

2002 ABB Oy. All rights reserved.

8VHUV�0DQXDO ��Y

Table of Contents

7DEOH�RI�&RQWHQWV �� Y

&KDSWHU��*HQHUDO��General Information.................................................................................................................................1-1

&KDSWHU��±�,QVWDOODWLRQ�RI�'ULYH'HEXJ��Installing DriveDebug Software ...............................................................................................................2-1Installing DriveDebug Hardware ..............................................................................................................2-1

Installing the DDCS PCMCIA Card ...............................................................................................2-2Installing the DDCS ISA Board......................................................................................................2-2Installing the PCI / PCMCIA adapter .............................................................................................2-2

&KDSWHU��8VH�RI�'ULYH'HEXJ��Starting the DriveDebug Program ...........................................................................................................3-1Screen Layout..........................................................................................................................................3-1Targets ....................................................................................................................................................3-2Target List Window..................................................................................................................................3-3

Colors in the Target List ................................................................................................................3-3Monitoring ................................................................................................................................................3-3

Application Variables .....................................................................................................................3-5Pin Connections ............................................................................................................................3-6

Recording ................................................................................................................................................3-6Trending...................................................................................................................................................3-7

Trend Buffer ..................................................................................................................................3-9Speed and Torque Steps ............................................................................................................3-10Trend Save..................................................................................................................................3-10

Control Panel .........................................................................................................................................3-11Target’s Status ............................................................................................................................3-12

Parameter Window................................................................................................................................3-12Backup and Restore of Parameters ............................................................................................3-12

Fault Logger Window.............................................................................................................................3-13Data Logger Window.............................................................................................................................3-13

Data Logger Monitor....................................................................................................................3-14Macros...................................................................................................................................................3-15

Write the Macro into an Empty Macro Window...........................................................................3-16Convert a Saved Monitor Window Data into a Macro .................................................................3-17Macro Execution Window............................................................................................................3-18

Definition Files .......................................................................................................................................3-19Help .......................................................................................................................................................3-19Exit.........................................................................................................................................................3-19

&KDSWHU��)LOH�0HQX ��Save Current Window As ........................................................................................................................4-1Print Current Window ..............................................................................................................................4-1Display Trend Text File............................................................................................................................4-1Display Recorder File ..............................................................................................................................4-1Current Symbol File .................................................................................................................................4-2Select Symbol File ...................................................................................................................................4-2Current Appl Var File ...............................................................................................................................4-2Select Appl Var File .................................................................................................................................4-2

7DEOH�RI�&RQWHQWV

��YL 8VHUV�0DQXDO

Configuration File Operations..................................................................................................................4-2Monitor Window File Operations .............................................................................................................4-2AC80 Window File Operations ................................................................................................................4-2Trend Window File Operations................................................................................................................4-2Exit...........................................................................................................................................................4-2

&KDSWHU��(GLW�0HQX��Cut ...........................................................................................................................................................5-1Copy ........................................................................................................................................................5-1Paste........................................................................................................................................................5-1Delete ......................................................................................................................................................5-1

&KDSWHU��7DUJHW�0HQX��Open Target List Window........................................................................................................................6-1Update Target List Window (with Names)...............................................................................................6-1Change Default Target ............................................................................................................................6-1Open Control Panel .................................................................................................................................6-1Open Parameter Window ........................................................................................................................6-1Open Fault Window.................................................................................................................................6-1Data Logger Monitor ................................................................................................................................6-1Backup.....................................................................................................................................................6-1Restore ....................................................................................................................................................6-1Enable Communication ...........................................................................................................................6-2Disable Communication...........................................................................................................................6-2Comm Statistics.......................................................................................................................................6-2

&KDSWHU��&RQILJ�0HQX ��New Configuration ...................................................................................................................................7-1Change Title ............................................................................................................................................7-1Open Configuration..................................................................................................................................7-1Save Configuration ..................................................................................................................................7-1

&KDSWHU��0RQ:LQ�0HQX ��New Monitor Window...............................................................................................................................8-1Change Window Title ..............................................................................................................................8-1Change Window Target...........................................................................................................................8-1Enable Monitoring....................................................................................................................................8-1Disable Monitoring ...................................................................................................................................8-1Open Monitor Window.............................................................................................................................8-1Save Monitor Window..............................................................................................................................8-1Add Symbol .............................................................................................................................................8-1Add Abs Address.....................................................................................................................................8-2Add Parameter ........................................................................................................................................8-2Add Appl Variable ....................................................................................................................................8-2Add Dataset Item.....................................................................................................................................8-2Search/Update Symbols ..........................................................................................................................8-2Remove Item ...........................................................................................................................................8-3Change Display Mode .............................................................................................................................8-3Define Comment......................................................................................................................................8-3Define Pointer ..........................................................................................................................................8-3Change Item Target.................................................................................................................................8-3Set Item Value .........................................................................................................................................8-3Undo Item Value Setting..........................................................................................................................8-3Start/Stop Recorder .................................................................................................................................8-3Change Line Layout.................................................................................................................................8-3


8VHUV�0DQXDO ��YLL

&KDSWHU��±�$&��:LQ�0HQX ��New AC80 Window..................................................................................................................................9-1Change Window Title ..............................................................................................................................9-1Open AC80 Window................................................................................................................................9-1Save AC80 Window.................................................................................................................................9-1Add Symbol .............................................................................................................................................9-1Add Abs Address.....................................................................................................................................9-1Remove Item ...........................................................................................................................................9-1Change Display Mode .............................................................................................................................9-1Define Comment......................................................................................................................................9-1

&KDSWHU��7UHQG:LQ�0HQX��New Trend Window ...............................................................................................................................10-1Change Window Title ............................................................................................................................10-1Change Window Target.........................................................................................................................10-1Open Trend Window..............................................................................................................................10-1Save Trend Window ..............................................................................................................................10-1Symbol...................................................................................................................................................10-1Abs Address ..........................................................................................................................................10-1Parameter..............................................................................................................................................10-1Appl Variable .........................................................................................................................................10-2Dataset Item ..........................................................................................................................................10-2Display Helper List .................................................................................................................................10-2Change Num Display Mode...................................................................................................................10-2Change Item Target...............................................................................................................................10-2Set Item Value .......................................................................................................................................10-2Undo Item Value Setting........................................................................................................................10-2Change Sample Interval ........................................................................................................................10-3Change Buffer Size................................................................................................................................10-3Start/Stop Trending................................................................................................................................10-3Set Trig Condition ..................................................................................................................................10-3Clear Graph Area...................................................................................................................................10-3Define Steps ..........................................................................................................................................10-3Step .......................................................................................................................................................10-3Mouse and Keyboard Operations ..........................................................................................................10-3

Vertical Scrolling and Scaling ......................................................................................................10-3Horizontal Scrolling and Scaling..................................................................................................10-4

&KDSWHU��0DFUR:LQ�0HQX ��New Macro Window...............................................................................................................................11-1Open Macro...........................................................................................................................................11-1Save Macro............................................................................................................................................11-1Save Macro As ......................................................................................................................................11-1Execute Macro.......................................................................................................................................11-1Execute Selected Lines .........................................................................................................................11-2

&KDSWHU��'/RJ:LQ�0HQX��New Data Logger Window.....................................................................................................................12-1Change Window Title ............................................................................................................................12-1Read Data Logger Info ..........................................................................................................................12-1Initialize Data Logger .............................................................................................................................12-1Data Logger Control ..............................................................................................................................12-1Upload Data Logger Samples ...............................................................................................................12-1Numeric Display of Samples .................................................................................................................12-1

&KDSWHU��:LQGRZV�0HQX��


��YLLL 8VHUV�0DQXDO

Tile .........................................................................................................................................................13-1Cascade.................................................................................................................................................13-1Arrange Icons ........................................................................................................................................13-1Close All.................................................................................................................................................13-1

&KDSWHU��+HOS�0HQX��Contents ................................................................................................................................................14-1About 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-12Example ....................................................................................................................................15-13

$SSHQGL[��Remote Operation ...............................................................................................................................15-15

Installation of the Server Program (DDsrvr.exe) .......................................................................15-15Installation of the DriveDebug Program to a Remote PC..........................................................15-15Some Differences between the Local and Remote Use ...........................................................15-16

$SSHQGL[��Visual Basic Interface ..........................................................................................................................15-17

8VHUV�0DQXDO ��

Chapter 1 - General

DriveDebug is a Windows based diagnostic tool program for devicesthat use the DDCS communication protocol. These devices includee.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.xoperating environment on IBM-compatible PCs.

The following functions can be performed by using DriveDebug:

• display of the list of all connected targets with their statuses

• graphical trending of actual values of user-selected parameters,application variables, dataset items and/or memory locations (max6 items in one window) from one or more targets.Min sample time is from 1 msec (with 1 trend) to 6 msec (with 6trends).

• horizontal scrolling and scaling of the trend history (in addition tothe vertical scrolling and scaling of trends)

• numerical monitoring of actual values of user-selected parameters,application variables, dataset items and/or memory locations fromone or more targets in different formats

• numerical recording of actual values of user-selected parameters,appliaction variables, dataset items and/or memory locations (max500 items) from one or more targets

• setting of values of parameters, datasets and/or memory locationsof targets

• backup and restore of target’s parameters (complete or versionupdate)

• backup and restore of the whole target software

• control of target’s data logger operation and display of thecollected 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-writtensequence of macro statements.

• numerical monitoring of actual values of user-selected AC80memory locations in different formats (if used with AC80)

GeneralInformation

*HQHUDO

�� 8VHUV�0DQXDO

• saving/restoring the current DriveDebug configuration to/from adisk file

• saving/restoring the definitions of the selected window to/from diskfiles

• 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 Englishby separate text files (a file with Finnish texts is included)


Chapter 2 – Installation of DriveDebug

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

If you have Windows XP, Windows 2000 or Windows NT4.0:

• Note: You must have Administrator privileges to your PC.

• You PC may be configured such in way that when you insert theDriveDebug installation CD into your CD drive, installation startautomatically. 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 theDriveDebug 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 installingDriveDebug first time to your laptop PC (and you have not installedDriveWindow earlier) you will find PCMCIA drivers from CD-ROMdirectory DDCS Link Card Installation Disk.

After the installation you can add the required startup parameters (asdescribed in Appendix 1) if the default values of the startupparameters are not suitable.

If you are using DDCS PCMCIA card with windows XP, with Windows2000 or with Windows Nt 4.0 install software first and hardware afterthat.

DriveDebug can be used with DDCS PCMCIA(NDPA-02) cards orwith DDCS ISA(NISA-03) boards or with PCI / PCMCIA adapter andDDCS PCMCIA card. You cannot start using DDCS ISA(NISA-03)

InstallingDriveDebugSoftware

InstallingDriveDebugHardware

,QVWDOODWLRQ�RI�Drive'HEXJ


boards immediately after installing DriveDebug under Windows 2000and Windows XP. You have to tell Windows their presence first (AddHardware).

• Insert the DDCS card into a vacant PCMCIA slot of the PC.

• Connect optical cables between the PCMCIA card and the targetdevice(s) or between the PCMCIA card and the (first) branchingunit.

The target channel number of the optical connector pair is 0.

Note: If you do not know how to install option boards into your PC,consult a service technician.

• Unplug the power cord of the PC.

• Open the cover of the PC.

• Insert the DDCS board into a vacant ISA-bus slot of the PC.

• Close the cover of the PC.

• Connect optical cables between the DDCS board and the targetdevice(s) or between the DDCS board and the (first) branchingunit.

The target channel numbers of the two optical connector pairs are 0and 1.

Please follow installation instructions of PCI / PCMCIA adapter.These installation instructions located in adapter readme.txt file.

Installation order is:

• Software,• PCI / PCMCIA adapter,• DriveAP software and DDCS PCMCIA card.

Installing theDDCS PCMCIACard

Installing theDDCS ISA Board

Installing the PCI/ PCMCIAadapter


Chapter 3 - Use of DriveDebug

You start the DriveDebug program by double clicking the DriveDebugicon.

Note: During the startup the program tries to read the applicationvariable file and/or the symbol file (if defined during the previoussession). If it cannot find the file it displays an error message "Cannotopen file xxxxxx.yyy". You can ignore this error message andcontinue but you cannot use any application variables and/orsymbolic addresses during this DriveDebug session.

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

• Target List Window displays the list of all connected targets andtheir statuses.

• Monitor Window (one or more) for numerical monitoring andrecording of actual values of user-selected parameters, applicationvariables, dataset items and/or memory locations from one ormore targets

• Trend Window (one or more) for graphical trending of actualvalues of user-selected parameters, application variables, datasetitems and/or memory locations (max 6 items in one TrendWindow) from one or more targets. Min sample time is from 1msec (if 1 trend) to 6 msec (if 6 trends).

• Parameters Window for upload, compare, change, backup andrestore of the parameters of the current Default Target (the termDefault Target is described in the next section Targets).

• Fault Window for upload, display and clear of the faults of thecurrent Default Target.

• Data Logger Window (one or more) for control of target’s datalogger operation and display of the collected sample values ingraphical and numeric form

• Control Panel Window for local control and status display of theselected target

• Macro Window (one or more) for creation and execution ofmacros. A macro is an user-written sequence of macrostatements.

• AC80 Window for numerical monitoring of actual values of user-selected AC80 memory locations (if DriveDebug is connected toAC80, see Appendix 3).

Starting theDriveDebugProgram

Screen Layout

8VH�RI�Drive'HEXJ


Communication status information is shown at the end of the title lineof the Frame Window:

• Default Target = c,n (communication is working and thechannel 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 thecommunication)

Note: If there is no response from the Default Target then the wholeDriveDebug communication stops. Failure in one or more othertargets does not prevent the communication with the working targets(if the failed target comes back then DriveDebug automatically startsto communicate with it).

You can change the title of the Frame Window by menu commandConfig - Change Title and the title of the selected child window byxxxWin - Change Window Title.

Every child window of DriveDebug and every item in a Monitor orTrend Window is associated with a drive (or some other device, likeAC80). This device is called window’s or item’s target.A target is identified by its channel number (see Chapter 2, sectionInstalling DriveDebug Hardware) and node number (defined in thetarget).

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

• Default Target is the Window Target of all child windows withoutuser-specified (or system-specified) Window Target. This target isdefined by menu command Target - Change Default Target or bydouble clicking on the desired target in the Target List Window (ifthis window is visible).

• Window Target of a child window can be the Default Target (this isthe default case) or an user-specified target (defined by menucommand xxxWin - Change Window Target) or a system-specified target.

• Item Target of an item in a Monitor and Trend Window can beeither the Window Target of item’s window (this is the defaultcase) or an user-specified target (defined by menu commandxxxWin - Change Item Target).

Targets



You open the Target List Window by menu command Target – OpenTarget List Window . All targets connected to the PC are searchedduring the first execution of this command and the target list (channeland 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 nodenumbers.

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

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

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

The background color of the Default Target is always black.

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

• If there are no faults in the targets then the background color ofall targets is green.

• If a fault is detected in one or more of the connected targets thenthe background color of the faulty target(s) is red and thebackground color of all non-faulty targets is yellow.

The text color of the Default Target is determined by using the samecolor selection algorithm that is described above for backgroundcolors of the non-Default targets.

The text color of the other targets (if any) is always black.

When you want to monitor a data item (or an array of memorylocations), you first

• create a new Monitor Window by menu command MonWin - NewMonitor Window or

• select an existing Monitor Window and the item in this window (ifnot already selected)

and then add the item definition into the window (after the selecteditem, if any):

• Parameter is added by menu command MonWin - AddParameter

Target List Window

Colors in theTarget List

Monitoring



• Application variable is added by menu command MonWin - AddAppl Variable (see section Application Variables later in thischapter)

• Dataset item is added by menu command MonWin - Add DatasetItem.

• Symbol name is added by menu command MonWin - AddSymbol

• Absolute address is added by menu command MonWin - AddAbs Address

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

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 commandMonWin - Change Line Layout (this command changes the linelayout of all items of all Monitor and Trend Windows).

Note: If a parameter, application variable or symbol (defined duringsome previous DriveDebug session) is now unknown then its value isdisplayed as a string of question marks.

The Item Target of the new item is the Window Target of the selectedwindow. You can change item’s target by menu command MonWin -Change Item Target.

You can change the value display format of the selected item bymenu command MonWin - Change Display Mode (this command isnot available with Real type parameters).If display mode is Boolean then numeric value 0 is displayed as textFALSE and any other value is displayed as text TRUE.

You can add, change and/or remove optional line comments by menucommand MonWin - Define Comment (special comments aredescribed in Appendix 2).

You remove the selected item line by menu command MonWin -Remove Item.



If you click on an item line while holding down the Alt key thenDriveDebug 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 startingto write the new value directly or by menu command MonWin - SetItem Value) and undo the previous setting by pressing Ctrl-F5 (or bymenu command MonWin - Undo Item Value Setting).

You can save the data of the selected Monitor Window to a disk fileby menu command File - Save Current Window As.Later you can e.g. import this file into the document you are workingwith 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 aresaved/restored by the Save/Open commands in the MonWin menu.

You can select a Monitor Window by pressing (while holding downthe Alt key) the number key that corresponds to the parenthesizedwindow number of the desired window (see startup parameter N inAppendix 1).

Application variables (i.e. pins of the blocks of target’s applicationsoftware) are defined in an application variable file (the filenameextension of these files is X01).

You select the desired X01 file by menu command File – SelectAppl Var File . The name of this file is saved to configuration files andthe application variable file is automatically read when theconfiguration file is opened.

Menu command MonWin - Add Appl Variable (or TrendWin - ApplVariable ) 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-timevalues) of this block are displayed in the list on the right side of thewindow (if this list is too narrow you can make it wider by moving theright edge of the Application Variable Window to the right).

Note : Pins with time values (the size of these values is 48 bits) aredisplayed as two separate pins (low part and high part of the “real”pin).

You can change the display mode of the selected value by theDisplay Mode radio buttons.

ApplicationVariables



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) Windowby the OK (or Apply) button.

The Apply button works as the OK button but the ApplicationVariable Window does not disappear and you can immediately selectthe next item.

If you have not selected an application variable then all pins of theselected block are put to the Monitor Window by the OK button.

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 clickingon the pin in the window while holding down the Ctrl key.

You can record the numeric values of the items of a Monitor Windowto a file.

First, select the desired parameters, application variables, datasetitems and/or memory locations (max 500 items) to the desiredMonitor Window as described in section Monitoring above in thischapter.

Then, define the name of the recorder file, record interval and thenumber of lines in the recorder file by menu command MonWin –Start/Stop Recorder .

The minimum value of the record interval (in milliseconds) is thesame as the number of items in the Monitor Window (i.e. 1…500msec) 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 offree disk space. If the recorder file becomes full during recording thenthe 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 (= MonitorWindow) 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 commandMonWin – Start/Stop Recorder ).

You can display the contents of the recorder file e.g. by menucommand File - Display Recorder File .

Pin Connections

Recording



When you want to start the graphical trending of one or more dataitems, you first

• create a new Trend Window by menu command TrendWin - NewTrend Window or

• select an existing Trend Window (if not already selected)

There can be max 6 items defined in one Trend Window. Theseitems are listed in the box at the top of the window (initially all itemsare marked with question marks). You click on the item line whichyou want to replace with a new item and then make the itemdefinition as follows:

• Parameter is defined by clicking the Param button (or by menucommand TrendWin - Parameter)

• Application variable is defined by menu command TrendWin -Appl Variable (see section Application Variables above in thischapter)

• Dataset item is defined by menu command TrendWin - DatasetItem

• Symbol name is defined by menu command TrendWin - Symbol

• Absolute address is defined by menu command TrendWin - AbsAddress


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 commandMonWin - Change Line Layout (this command changes the linelayout of all items of all Monitor and Trend Windows).

Note: If a parameter, application variable or symbol (defined duringsome previous DriveDebug session) is now unknown then its value isdisplayed as a string of question marks.

Trending



The Item Target of the new item is the Window Target of the selectedwindow. 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 selecteditem 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 textFALSE and any other value is displayed as text TRUE (the valueFALSE 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 theAlt key then DriveDebug displays the help text of this item (if the helptext exists).

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

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

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

You set the sampling interval (in milliseconds) by clicking the Intervalbutton (or by menu command TrendWin - Change SampleInterval). The minimum value is the same as the number of selectedgraphs (i.e. 1…6 msec) and the maximum value is 60000 msec (= 1min).

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 mustdefine the size of the trend buffer before you start trending (seesection Trend Buffer later in this chapter).

If you want to make speed or torque steps during trending then youmust define the speed and torque steps before you start trending(see section Speed and Torque Steps later in this chapter).



You start (and stop) the trending by pressing the F4 key (or by menucommand TrendWin - Start/Stop Trending).You can change item definitions and selections, sample interval andY values during trending.

If you have defined a triggering condition and this condition is metduring trending then the trending stops automatically after the“Sample Count after Trig”.

Note: When trending has been started the Trend Window can updateonly 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 startingto write the new value directly or by menu command TrendWin - SetItem Value) and undo the previous setting by pressing Ctrl-F5 (or bymenu command TrendWin - Undo Item Value Setting).

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

With the trending stopped, you can press the mouse button while thecursor is on the graph area and the numeric values of the samples atthe cursor location are displayed in the list box at the top of thewindow on the gray background (the cursor time is displayed abovethe graph area). You can move the mouse while holding down themouse 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 afile (in bitmap or text format) by menu command File - Save CurrentWindow As (with the trending stopped). See sectionTrend Save laterin this chapter.

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

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

Trend Buffer



If you want to save and display more sample batches than the last500 collected ones then you have to set the trend buffer size bymenu command TrendWin - Change Buffer Size. The buffer sizedefines how many sample batches can be saved to the buffer. Themaximum allowable size of the buffer depends on the free PC diskspace.

Note: If you change the buffer size at a later time, and there aresamples in the buffer, then these samples are lost!

When you start trending, all sample batches are now always saved tothe buffer. If the buffer becomes full during trending then the oldestsample batch is replaced by the new one.

After you stop trending, you can scroll the collected sampleshorizontally to the right (or left) by the right (or left) arrow key whileholding down the Alt key (the size of the scroll move is the half of thetrend graph area width).

You can compress the trend graph horizontally to 1/10 from itsprevious width using the right arrow key while holding down theShift key. The compressing means that every 10th trend sample isdisplayed in the Trend Window.Using the left arrow key (while holding down the Shift key) you canexpand the compressed trend graph.

If you use the Ctrl key instead of the Shift key then thecompress/expand ratio is 2 instead of 10.

If you restart trending after the compress then the collected samplesare displayed on the screen according to the current compress ratiobut all collected samples are always saved to the trend buffer and it ispossible to see the undisplayed intermediate sample values whenyou stop trending and expand the trend.

There are two step buttons in the Trend Window:

• You make step definitions (speed or torque steps) using the Stepbutton (or menu command TrendWin – Define Steps )

• You make a defined speed or torque step by pressing the buttonat the right of the Step button or by menu command TrendWin -Step (alternatively Step1 and Step2)

You can save the sample values of the selected Trend Window to afile by menu command File - Save Current Window As (when thetrending is stopped).

The save format can be either graph (bitmap filename extension isBMP) or text (filename extension is TXT). It is not necessary to write

Speed andTorque Steps

Trend Save



the filename extension because DriveDebug appends it automaticallyto the filename you specify.

If you select the graph format then you can select Black-and-White orColor mode. In Black-and-White mode, the widths of the graph linesare different so it is possible to differentiate the graphs in a BWpicture.

If you select the text format and you have compressed the graph (seesection Trend Buffer above in this chapter), then there are two savemode alternatives:

• The Time-scaled values in the time range mode saves thecompressed samples of the graph area (this means that there aremax 500 sample lines in the output file).

• The All values in the time range mode saves all samples of thetrend buffer that are between the start and end time instances ofthe graph area (this mode enables e.g. the save of all samples ofthe 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 theDecimal symbol to dot ’.’ by the Control Panel program before youstart Excel.

The Control Panel is opened by menu command Target – OpenControl Panel . The buttons of the Control Panel are:

• The Loc/Rem button switches the current Default Target to LocalControl mode. The value of this Default Target is set to theWindow Target of the Control Panel (this means that the target ofthe Local Control do not change if you change the Default Targetwhile the Local Control is active). If you want to change the targetof the local mode then you must switch back to the remote modeby the Loc/Rem button, change the Default Target (if not alreadychanged) 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’sreference value. The reference is changed by pressing the control’s

Control Panel



left or right-hand button. The speed of change increases with the timethe button is held down. It is also possible to change the referencevalue by dragging the thumb with the mouse.

The status info of the target is displayed at the bottom of the ControlPanel.

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

The Parameter Window is opened by menu command Target –Open Parameter Window .

You can upload the parameter list of the Default Target with valuesby 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 bymenu command File - Save Current Window As .

Using the Compare button, you can compare the uploadedparameter list with the contents of a previously saved parameter listfile.

There are two parameter backup/restore modes:

• Complete (the filename extension of the backup file is PAC)backups/restores all parameters

• Version Update (the filename extension of the backup file is PAU)backups/restores the ID RUN results and the Motor data.

You can backup parameters of the Default Target to a Backup file bythe Backup button.

Note: It is not necessary to make the Upload operation beforeBackup.

You can restore the contents of a Backup file to the Default Target bythe Restore button.

Note: The target software is always restarted at the end of theRestore operation.

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

Note: If possible use a point-to-point connection between the PC andthe Default Target during Restore. If this is not possible (i.e. there are

Target’s Status

Parameter Window

Backup andRestore ofParameters



other targets connected to the PC in addition to the Default Target)then the node numbers of these other targets must be greater thanone (1).

You open the Fault Window by menu command Target – Open FaultWindow . During the execution of this command the fault logger ofthe 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.

You open a new Data Logger Window by menu command DLogWin– New Data Logger Window .The current value of the Default Target is set to the Window Target ofthe new window.If there are more than one data logger in the target then the datalogger 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 datalogger with menu command DLogWin – Read Data Logger Info .

You can define the data logger settings with menu commandDLogWin – Initialize Data Logger . This command displays a dialogbox with the following buttons:

• By means of the Remove button you can remove the selectedvariable from the Variables list.

• By means of the Param button you can add a new parameter tothe 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 newapplication variable to the Variables list (either to the start of thelist, 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 triggerparameter.

• By means of the A V button you can define the index of a newtrigger application variable.

By menu command DLogWin – Data Logger Control you canmanually 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

Fault LoggerWindow

Data LoggerWindow



triggered then the triggering time is at the origin of the X axis; elsethe X origin is at the right edge of the graph area.

The numeric values of the samples at the cursor location aredisplayed in the list box at the top of the window together with namesof the data logger channel variables (the cursor time is displayedabove the graph area).You can move the cursor either with the mouse while holding downthe mouse button, or with the right and left arrow keys.

You can vertically scroll and scale the sample graphs in the sameway as in a Trend Window (see section Trending above in thischapter).

You can display the uploaded sample values in numeric form usingmenu command DLogWin – Numeric Display of Samples .

You can save the sample values to a disk file using menu commandFile - Save Current Window As .The save format can be either graph (bitmap filename extension isBMP) or text (filename extension is TXT). It is not necessary to writethe filename extension because DriveDebug appends it automaticallyto the filename you type.If you select the graph format then you can select Black-and-White orColor mode. In Black-and-White mode the widths of the graph linesare different so it is possible to differentiate the graphs in a BWpicture.

Later you can e.g. import this saved file into the document you areworking 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.

Menu command Target – Data Logger Monitor searches all dataloggers of all targets connected to the PC and displays the DataLogger Monitor Window. Now you can define the name and directoryof the monitor log file (all sample files will be written to this directory,too).

When you click the Start button then DriveDebug continuously pollsfor the statuses of all data loggers of all connected targets.

Note : Data logger monitoring starts automatically by startupparameter /L when the DriveDebug program is started (see Appendix1).

After the start the text on the Cancel button is changed to Stop .

On the STATE line the current monitoring status is displayed.

Data LoggerMonitor



If a data logger has been triggered then DriveDebug:

• uploads the collected samples of this data logger to a file. Thename of this file is DLMxxxxx.TXT, where xxxxx is uniquesequence number that distinguishes the sample files from eachother. If the disk becomes full then the oldest DLM*.TXT file isreplaced by the new file.

• restarts the triggered data logger (if the triggering was caused by afault then DriveDebug waits until the target’s fault state has beenremoved before restarting the data logger).

• restarts the polling of the statuses of all data loggers.

A macro is an user-written sequence of macro statements in a MacroWindow. The syntax of macro statements is defined in theDriveDebug Macro Language (see Appendix 4).

By macros it is possible e.g. to set the values of parameters intarget(s) or to write a simple PC-based application program for thecontrol 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 belowfor details)

A previously saved macro file is opened by menu commandMacroWin - Open Macro.

Now you can modify the macro in the created (or opened) MacroWindow and/or you can start the execution of the macro by pressingthe F9 key (or by menu command MacroWin - Execute Macro). Theselected macro statement lines only are executed by menu commandMacroWin - Execute Selected Lines.

Note: If DriveDebug displays error message "Parameter list has notbeen uploaded" then you have to upload the parameter list beforeyou can start the execution of the macro (use menu commandMonWin – Add Parameter ).

The Macro Execution Window (see below for details) is displyed onthe screen during the execution of the macro and you can create asimple user interface by using this window.

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

Macros



You can create a chain of macros by using macro statement#GOTOMACRO = "macrofilename".

During the execution of some macro statements (e.g. waitstatements) DriveDebug can update numeric values of the items inMonitor 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 theMacro Window by menu command MacroWin - Save Macro (or to anew macro file by menu command MacroWin - Save Macro As).

A new Macro Window is opened by menu command MacroWin -New Macro Window.

You can add and edit text in a Macro Window in the same way asyou 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 - Cutand Edit - Delete instead of the above-mentioned keys.

Example: Write the following assignment statements into your newMacro Window:

50.01 = 1234.5 70.07 = 2 22.05 = 12

By pressing the F9 key the parameters listed in the macro are set totheir defined values in the current Default Target. By changing theDefault Target and pressing the F9 key again the same value settingscan be done for other targets too.

With a target statement you can define that the following statementswill use the target of the target statement instead of the DefaultTarget. This target specification is in effect until the next targetstatement (or to the end of the macro if no more target statementsexist).

Write the Macrointo an EmptyMacro Window



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 parameter22.05 in the target 0,2 then the macro example above must be editedinto 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 totheir defined values in the defined targets.

When you have finished the macro you should save it by menucommand MacroWin – Save Macro As . The filename extension of amacro file is always MAC.

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

Then, save the contents of this Monitor Window (it contains now thecurrent values of the selected items) to a disk file (filename extensionis TXT) by menu command File - Save Current Window As .

Finally, change (e.g. by the File Manager program) the filenameextension from TXT to MAC.

Example: Insert the SPEED SCALING parameters (assume 50.01) ofall 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 fileSCALING.TXT.

Rename SCALING.TXT to SCALING.MAC.

At a later time, the SPEED SCALING values saved above can besent back to the same targets in the following way:

• open the file SCALING.MAC (created above) with menu commandMacroWin – 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. Rememberto save the changed macro with menu command MacroWin – SaveMacro if you want to use the changed macro afterwards.

Convert a SavedMonitor WindowData into aMacro



The Macro Execution Window is displayed on the screen during theexecution of a macro. This window can be divided into three areas:

• The top area (the String area) is used to display text strings (e.g.help texts) to the user.

• The middle area (the Value area) contains the Value input fieldand the Enter button (the Enter key can be used instead of thisbutton)

• The bottom area (the Variable area) contains the Variable inputfield and the Set Variable button.

It is possible to create a simple user interface by user interfacestatements. Here is an example:

• You can e.g. display help information to the user by macrostatement #PUTSTR = "character string" and read user’sinput by macro statement V = #GETVAL.

• You can write e.g. the default input value by macro statement#PUTVAL = "character string" (before the V = #GETVALstatement) and if the user accepts this default value (s)he cancontinue by pressing only the Enter key.

• If the user wrote an invalid value then you can display an errormessage e.g. by macro statement #MSGBOX = "characterstring".

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

The V = #GETVAL statement above halts the execution of the macrountil 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 settingcommand (e.g. %k=123) to the Variable input field and clicking theSet Variable button.

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

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

Macro ExecutionWindow



You can save the current DriveDebug configuration (the definitions ofall current Monitor, Trend and Macro Windows) with menu commandConfig - Save Configuration. The Frame Window title is used as filename (the length of this title can be up to 80 characters).

A previously saved DriveDebug configuration can be restored bymenu command Config - Open Configuration.

You can save the definitions of the selected Monitor Window withmenu command MonWin - Save Monitor Window and thedefinitions of the selected Trend Window with menu commandTrendWin - Save Trend Window. The window title is used for thefile name (the length of this title can be up to 80 characters).

Note: The data of the selected window is saved with menu commandFile - Save Current Window As.

A previously saved Monitor Window can be added to the currentconfiguration with menu command MonWin - Open MonitorWindow and a Trend Window with menu command TrendWin -Open Trend Window.

Menu command Help – Contents displays the main index of theDriveDebug Help.

Another help method is context-sensitive help, i.e. you can press theF1 key in order to get information about the selected menucommand, child window etc.

When you exit DriveDebug (e.g. with menu command File - Exit ), allcurrent configuration settings of all current Monitor, Trend and MacroWindows are always saved into the AMCTOOL.ATC file in theDriveDebug directory (if this file already exists it is overwritten).

During the next startup the settings of this file are automaticallycopied to the initial configuration settings of the DriveDebug program.

Definition Files

Help

Exit


Chapter 4 - File Menu

Using this command you can save the data of the selected window toa file.You can later e.g. import this file into the document you are workingwith.

Note: The definitions of the selected window are saved/restoredusing the Save/Open commands in the MonWin, AC80Win andTrendWin menus.

Using this command you can print the graphs of the selected TrendWindow.

Using this command you can display the contents of a previouslysaved trend file (the trends must have been saved in the text format,not in the graph format).

Note: If DriveDebug displays error message "Parameter list has notbeen uploaded" then you have to upload the parameter list beforeyou can display the file (use menu command MonWin – AddParameter ).

If there are no drives connected to DriveDebug then the type (Real ornon-Real) of every parameter to be displayed is asked.

This command creates a new Trend Window based on theinformation in the saved trend text file.You can scroll and scale the trends in this new Trend Window (andeven start a new trending, if needed).

Using this command you can display the contents of a previouslysaved recorder file.When you have selected the recorder file then you can select therecorder items (1…6 items) for display.

Note: If DriveDebug displays error message "Parameter list has notbeen uploaded" then you have to upload the parameter list beforeyou can display the file (use menu command MonWin – AddParameter ).

If there are no drives connected to DriveDebug then the type (Real ornon-Real) of every parameter to be displayed is asked.

This command creates a new Trend Window based on theinformation in the saved recorder file.

Save CurrentWindow As

Print CurrentWindow Display Trend TextFile

Display RecorderFile

)LOH�0HQX


You can scroll and scale the trends in this new Trend Window (andeven start a new trending, if needed).

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

By this command you can select a new symbol file(*.CLD).This command is grayed out if the target is an AC80 because in thatcase the symbol file is selected automatically by DriveDebug.The name of the selected symbol file is saved to the configuration filewhen you save configuration using Config - Save Configuration.

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

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

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

The File Operations commands show the relationship between theabove mentioned long "virtual" file names of Save/Open and theshort (normally invisible) "real" DOS filenames (8+3 characters,generated automatically by DriveDebug). You can delete, renameand/or copy these DOS files.

When you exit DriveDebug, all configuration settings of all currentMonitor, Trend and Macro Windows are always saved into theAMCTOOL.ATC file in the DriveDebug directory (if this file alreadyexists it is overwritten).

During the next startup the settings of this file are automaticallycopied to the initial configuration settings of the DriveDebug program.

Current SymbolFile

Select Symbol File

Current Appl VarFile

Select Appl VarFile

Configuration FileOperationsMonitor WindowFile Operations

AC80 Window FileOperations Trend Window FileOperations

Exit


Chapter 5 - Edit Menu

This command copies the selected Macro Window text to theclipboard and removes the text from the screen.You can now paste it into another location of the macro you areworking with (or into another Macro Window).

This command copies the selected Macro Window text to theclipboard.You can now paste it into another location of the macro you areworking with (or into another Macro Window).

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

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

Cut

Copy

Paste

Delete

(GLW�0HQX



Chapter 6 - Target Menu

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

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

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

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

Note: If the Default Target goes down then the whole DriveDebugcommunication stops. Failure in one or more other targets does notprevent the communication with the working targets (if the failedtarget comes back then DriveDebug automatically starts tocommunicate with it).

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

This command opens the Parameter Window (see Chapter 3, sectionParameter Window).

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

This command displays the Data Logger Monitor Window (seeChapter 3, section Data Logger Monitor).

This command backups the whole Default Target software to aBackup file (the filename extension of the Backup file is TAR).

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

This command restores the contents of a Backup file to the DefaultTarget.

Open Target ListWindow Update Target ListWindow (withNames)

Change DefaultTarget

Open ControlPanel Open ParameterWindow Open FaultWindow Data LoggerMonitor Backup

Restore

7DUJHW�0HQX


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

Note: If possible use a point-to-point connection between the PC andthe Default Target during Restore. If this is not possible (i.e. there areother targets connected to the PC in addition to the Default Target)then the node numbers of these other targets must be greater thanone (1).

Note: If the Restore operation fails then you have to switch the powerof the Default Target off and on before you can continue.

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

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

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

This command displays communication statistics (cumulative valuessince the startup of the DriveDebug and since the opening of thisstatistics box).

EnableCommunication

DisableCommunication

Comm Statistics


Chapter 7 - Config Menu

Using this command, you can create a new configuration.

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

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

Using this command you can restore a previously saved DriveDebugconfiguration (see the Save Configuration command below).

Using this command you can save the current DriveDebugconfiguration (all definitions of all Monitor, Trend and MacroWindows) 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.

New Configuration

Change Title

OpenConfiguration Save Configuration

&RQILJ�0HQX



Chapter 8 - MonWin Menu

Using this command you can create a new Monitor Window.

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

Using this command you can change the target of the selectedMonitor Window. If the Window Target is not specified as the DefaultTarget, the channel and node numbers of the Window Target areshown in front of the title of the window.

This command enables the update of the item values of the selectedMonitor Window.

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

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

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

Note: You can delete window definition files using menu commandFile - Monitor Window File Operations.

Using this command you can add a symbol (or an array of memorylocations starting from this symbol) after the selected line in theactive 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 todisplay the first parameter name whose initial letters match thecharacters you have typed. In this way you can quickly find the nameof the desired symbol if the symbol list is long.The Apply (= Alt + A) button works as the OK button but the dialogbox does not disappear and you can immediately select a newsymbol.

New MonitorWindow

Change WindowTitle

Change WindowTarget

Enable Monitoring

Disable Monitoring

Open MonitorWindow

Save MonitorWindow

Add Symbol

0RQ:LQ�0HQX


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

Using this command you can add an absolute address (or an array ofaddresses starting from this address) after the selected line in theactive 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 dialogbox does not disappear and you can immediately type a newaddress.


Using this command you can add a parameter after the selected linein the active Monitor Window (or to the end of the list if no line isselected).The Apply (= Alt + A) button works as the OK button but the dialogbox does not disappear and you can immediately select a newparameter.

If you want to add several parameters to the Monitor Window, firstselect one parameter by clicking on it in the parameter list and then

• select the other parameters by clicking on them while holdingdown the Ctrl key (if you want to select individual parameters) or

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

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

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

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

This command scans all memory location items of the selectedMonitor Window. If the absolute address of an item is the same asthe absolute address of a symbol then the original item text isreplaced with the name of this symbol.

Example: If you add an array of absolute memory locations with theAdd Abs Address command then you can, using this command,

Add Abs Address

Add Parameter

Add Appl Variable

Add Dataset Item

Search/UpdateSymbols

0RQ:LQ�0HQX


automatically replace the absolute address items with the names ofthe symbols whose absolute addresses lie within this memorylocation array.

This command deletes the selected line from the active MonitorWindow.

Using this command you can change the display mode of the actualvalue of the selected item in the active Monitor Window.If display mode is Boolean then numeric value 0 is displayed as textFALSE and any other value is displayed as text TRUE.

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

Using this command you can define that the actual value of theselected 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. Theactual value of the item (i.e. the pointer value) is now displayed at theend of the line.

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 thechannel and node numbers of the Item Target are shown before thename of the item.

By this command (or by pressing F5) you can set the value of theselected item in the active Monitor Window (the current value isdisplayed in the value dialog box for editing).

Note: You can start typing value characters without selecting thiscommand (or pressing the F5 key) because the value dialog boxappears automatically when you have entered the first valuecharacter.

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

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

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

Using this command you can:

• specify the number of spaces (1...9) between the value text andthe item name text.

Remove Item

Change DisplayMode

Define Comment

Define Pointer

Change ItemTarget

Set Item Value

Undo Item ValueSetting

Start/StopRecorder Change LineLayout

0RQ:LQ�0HQX


• change the display mode of the item name texts of memorylocation arrays.Normally all array item texts (except the first one) are in thebase+offset format but you can prevent the display of the arraybase (on the other array lines except the first one).

• prevent the display of parenthesized address values at the end ofitem lines.

Note: This command changes the line layout of all items of allMonitor and Trend Windows.


Chapter 9 – AC80Win Menu

The operation of these menu commands is similar to the operation oftheir Monitor Window counterparts (see Chapter 8) but they operatewith the active AC80 Window (there can be no more than one AC80Window).

New AC80 Window

Change Window Title

Open AC80 Window

Save AC80 Window

Add Symbol

Add Abs Address

Remove Item

Change Display Mode

Define Comment

$&��:LQ�0HQX



Chapter 10 - TrendWin Menu

Using this command you can create a new Trend Window.

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

Using this command you can change the target of the selected TrendWindow. If the Window Target is not specified to be the DefaultTarget then the channel and node numbers of the Window Target areshown before the title of the window.

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

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

Note: You can delete window definition files by menu command File -Trend Window File Operations.

Using this command you can replace the selected item in theselected Trend Window with a symbol.When you are entering the symbol name, the symbol list scrollsautomatically to display the first parameter name whose initial lettersmatch the characters you have typed. In this way you can quickly findthe name of the desired symbol if the symbol list is long.


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


Using this command (or by clicking the Param button) you canreplace the selected item in the selected Trend Window with aparameter.

New Trend Window

Change WindowTitle

Change WindowTarget

Open TrendWindow

Save TrendWindow

Symbol

Abs Address

Parameter

7UHQG:LQ�0HQX


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

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

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

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

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

Using this command (or by clicking the Target button) you canchange the target of the selected item. If the Item Target is notspecified as the Window Target then the channel and node numbersof the Item Target are shown before the name of the item.

Using this command (or by pressing F5) you can set the value of theselected item in the selected Trend Window (the current value isdisplayed in the value dialog box for editing).

Note: You can start typing value characters without selecting thiscommand (or pressing the F5 key) because the value dialog boxappears automatically when you have entered the first valuecharacter.

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

This command (or the pressing of the Ctrl-F5 keys) undoes theprevious value setting.

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

Appl Variable

Dataset Item

Display Helper List

Change NumDisplay Mode

Change ItemTarget

Set Item Value

Undo Item ValueSetting

7UHQG:LQ�PHQX


Using this command (or by clicking the Interval button) you can setthe sampling interval (in milliseconds). The minimum value is thesame as the number of selected graphs (i.e. 1…6 msec) and themaximum value is 60000 msec (= 1 min).

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

This command (or the F4 key) starts (or stops) the trending. You canchange item definitions and selections, sample interval and Y valuesduring the trending.

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 metduring trending then the trending stops automatically after the“Sample Count after Trig”.

This command clears the trend graph area (trending must bestopped).

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

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

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

By clicking on the top graph Y value text you can set a newmaximum Y value.By clicking on the middle graph Y value text you can set a newoffset Y value.By clicking on the bottom graph Y value text you can set a newminimum Y value.

Note: The increment in the following operations is half of current areaheight.

By holding down the Alt key and pressing the up or down key youcan move the selected graph up or down.By holding down the Shift key and pressing the up or down key youcan change the value of the top graph Y value text.By holding down the Ctrl key and pressing the up or down key youcan change the value of the bottom graph Y value text.

Change SampleInterval

Change Buffer Size

Start/StopTrending

Set Trig Condition

Clear Graph Area

Define Steps

Step

Mouse andKeyboardOperations

Vertical Scrollingand Scaling

7UHQG:LQ�0HQX


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

By holding down the Alt key and pressing the right or left key youcan move the graphs to the right or to the left (the move length is halfof graph area width).By holding down the Shift key and pressing the right or left keyyou can compress or expand the graphs (compress/expand ratio is10).By holding down the Ctrl key and pressing the right or left keyyou can compress or expand the graphs (compress/expand ratio is2).

HorizontalScrolling andScaling


Chapter 11 - MacroWin Menu

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

This command creates a new (empty) Macro Window.

This command restores a previously saved macro. The name of theopened file is displayed as the title of the Macro Window.

Note: You can also open a previously saved Monitor Window datafile (see Chapter 3, section Macros).

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

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

This command (or the F9 key) starts the execution of the macro ofthe selected Macro Window.


The Macro Execution Window is displyed on the screen during theexecution of the macro and you can create a simple user interface byusing this window.





New Macro Window

Open Macro

Save Macro

Save Macro As

Execute Macro

0DFUR:LQ�0HQX


This command starts the execution of the selected macro statementlines of the selected Macro Window.


The Macro Execution Window is displyed on the screen during theexecution of the macro and you can create a simple user interface byusing this window.





Execute SelectedLines


Chapter 12 - DLogWin Menu

See also Chapter 3, section Data Logger Window.

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

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

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

Using this command you can define the data logger settings.

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

Using this command you can upload the collected samples.

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

New Data LoggerWindow

Change WindowTitle Read Data LoggerInfo Initialize DataLogger

Data LoggerControl

Upload DataLogger Samples Numeric Display ofSamples

'/RJ:LQ�0HQX



Chapter 13 - Windows Menu

This command tiles the child windows.

This command cascades the child windows.

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

This command closes all child windows.

Tile

Cascade

Arrange Icons

Close All

:LQGRZV�0HQX



Chapter 14 - Help Menu

This command displays the main index of the DriveDebug Help.

Note: Instead of this menu command you can press the F1 key inorder to get information about the selected menu command, childwindow etc.

This command displays the DriveDebug information box.

Contents

About DriveDebug

+HOS�0HQX



Chapter 15 - Appendices

Appendix 1

By adding or modifying the startup parameters, you can customizeyour copy of the DriveDebug program. The startup parameters areused in the properties definition of the DriveDebug icon.

You can set/change values of the startup parameters in the followingway:

• Stop DriveDebug (if it is running) and click (only once!) theDriveDebug 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 lineas 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 CommandLine as follows

path\DRIDEB.EXE /X /Y ...

• click the OK button

Startup parameters are listed on the following page.

Startup Parameters

$SSHQGLFHV


Param Meaning and Values

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

D This parameter displays (during the startup ofDriveDebug) a dialog box for the setting of DDCScommunication parameters (e.g. the light beamintensity for long optical cables).Example: /D

L This parameter starts the data logger monitoringafter the start of the DriveDebug program.Example: /L

N This parameter prevents the display of windownumbers in window titles (and the use of keycombination Alt + window number).Example: /N

S Normally DriveDebug uses (and displays) 24address bits of memory locations. If you only useshorter 16-bit memory addresses (as e.g. with anAC80) then this parameter prevents the display ofthe eight most significant (unused) address bits.Example: /S

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

Table of StartupParameters

$SSHQGLFHV


Appendix 2

A special comment is a comment that starts with an user-specifieddefinition string.DriveDebug reads and interprets the definition strings of specialcomments.

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

If used with a Real type parameter then the value string nnn isassumed to be a real value.

If the value string nnn includes the character "." then it is assumedto be a fraction.

If the value string nnn starts with the character "+" (or "-") then it isassumed to be a signed value.

If the value string nnn ends with the character "h" then it is assumedto be a hex value.

Otherwise the value string nnn is assumed to be an unsigned value.

Special Comments

Value TypeInterpretation

$SSHQGLFHV


Appendix 3

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 portmemory (DPM) between them.

DriveDebug is connected to the DDCS-protocol Tool Link (ch3) of theNCB and it can access the data of the main AC80 board via theDPM.

AC80 and NCB

$SSHQGLFHV


Appendix 4

Summary of statements:

X = CX = YX = Y oper CX = 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 = iViV = .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 = #FILEINV = #GETVAL#MSGBOX = "character string"#MSGBOX = #FILEIN#SHOWGETVAL = C#SHOWSETVAR = C

#EXIT

Macro Language

$SSHQGLFHV


Assignment statements:

X = CX = YX = Y oper CX = 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, ifany) will use this target.Statements before the first #TARGET statement (if any) use theDefault Target.

Wait statement:

#WAIT = CV ; wait time (1...60000 msec)

During the execution of a #WAIT statement DriveDebug updates thenumeric values of the items in Monitor and Trend Windows (updaterate is about one value in one millisecond of a #WAIT statement).

$SSHQGLFHV


Dataset statements:

.DSnn = iV

This statement puts the value of the integer variable iV and thevalues of the next two integer variables to target’s dataset nn, readsthe values of target’s next dataset and puts the read values to thenext 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’sdataset 2 to variables %n, %o and %p.

iV = .DSnn

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

Macro chaining statement:

#GOTOMACRO = "macrofilename"

This statement stops the execution of the current macro, closes thecurrent Macro Window, opens a new Macro Window with macromacrofilename and starts this new macro.

$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 inthe input file is 100 characters.The input and output files are opened automatically when theexecution of the macro is started and closed when the execution ofthe macro is stopped.If the output file already exists when the execution of the macro isstarted then it is overwritten by the new output file.If the #FILENAMEIN statement is missing then the default name ofthe input file is MACRO.IN.If the #FILENAMEOUT statement is missing then the default name ofthe output file is MACRO.OUT.

V = #FILEIN

This statement reads a character line from the input file, converts theread characters to a numeric value and puts this value to (integer orreal) variable V.The conversion stops at the first non-numeric character.

#FILEINRESET

This statement moves the read position of the input file back to thebeginning of the file.

#FILEOUT = V

This statement converts the (integer or real) variable V to a characterstring 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 tothe output file.

$SSHQGLFHV


#FILEOUT = #FILEIN

This statement reads a character line from the input file and writesthe read line to the output file.If the read line is empty then a CR/LF character pair is written to theoutput file.

#FILEOUT = #DATETIME

This statement writes the current date and time (e.g. 12/27/0113:28:57) to the output file.

#FILEOUT = #GETVAL

This statement waits until the user has clicked the Enter button of theMacro Execution Window and then this statement reads thecharacter string from the Value input field of the Macro ExecutionWindow and finally, writes the read string to the output file.If the read string is empty then a CR/LF character pair is written tothe output file.During the execution of this statement DriveDebug updates thenumeric values of the items in Monitor and Trend Windows.

#PUTSTR = V

This statement converts the (integer or real) variable V to a characterstring and appends this string to the content of the String area of theMacro Execution Window.

#PUTSTR = "character string"

This statement appends the character string to the content ofthe String area of the Macro Execution Window.Every vertical bar character (|) in the string (if any) explicitly starts anew line in the String area.If the string is empty (i.e. "") then the String area is cleared.

$SSHQGLFHV


#PUTSTR = #FILEIN

This statement reads a character line from the input file and appendsthe read line to the content of the String area of the Macro ExecutionWindow.Every vertical bar character (|) in the read line (if any) explicitly startsa 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 characterstring and appends this string to the content of the Value input field ofthe Macro Execution Window.

#PUTVAL = "character string"

This statement appends the character string to the content ofthe 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 appendsthe read line to the content of the Value input filed of the MacroExecution 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 theMacro Execution Window and then this statement reads thecharacter string from the Value input field of the Macro ExecutionWindow, converts the read characters to a numeric value and putsthis value to (integer or real) variable V.The conversion stops at the first non-numeric character.During the execution of this statement DriveDebug updates thenumeric values of the items in Monitor and Trend Windows.

$SSHQGLFHV


#MSGBOX = "character string"

This statement displays a message box with the characterstring.During the execution of this statement DriveDebug updates thenumeric values of the items in Monitor and Trend Windows.The execution of the macro continues when the user has clicked theOK button of the message box.

#MSGBOX = #FILEIN

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

#SHOWGETVAL = C

This statement hides the Value area components of the MacroExecution Window (if the value of the constant C is zero) or showsthese 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 MacroExecution Window (if the value of the constant C is zero) or showsthese 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

$SSHQGLFHV


X, Y and Z = Variable ID, Parameter ID, Application variable,Symbol name or Absolute address

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

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 followingstatements:

X = YX = Y oper Z#IF (X comp Y)#WHILE (X comp Y)

The case of characters P (in Parameter ID) and R (in Variable ID) isnot significant but the case of character c (in Variable ID) issignificant.

Spaces and tabs are insignificant.

Notes about theMacroStatements

$SSHQGLFHV


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

Example

$SSHQGLFHV


$SSHQGLFHV


Appendix 5

The remote operation is possible with Windows Xp, with Windows2000 or with Windows NT.

In the remote mode of DriveDebug there are actually two separateprograms that communicate with each other via a TCP/IP network:

• The DriveDebug program (DRIDEB.EXE) that runs in a remotePC. This is called a client program.

• The server program runs in the PC that is optically connected tothe drive(s). This program (DDsrvr.exe) is included with theDriveDebug 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 theserver and the client is too slow.

Install DriveDebug into the PC that is optically connected to thedrives (if not yet installed). This PC must be connected to a TCP/IPnetwork, too.

Start the DDsrvr.exe program in the DriveDebug directory (e.g. bydouble-clicking its name).The DriveDebug directory is specified during the installation ofDriveDebug and the default directory name isC:\ProgramFiles\DriveWare\DriveDebugx.x

Write down the IP address of this server PC (e.g. 121.111.1.1)

Note: ''VUYU�H[H and the DriveDebug program '5,'(%�(;( donot work at the same time in the same PC.

Install DriveDebug into a PC that connected to a TCP/IP network (ifnot yet installed). No DriveDebug hardware card is needed.

Create a new directory

Copy all files of the DriveDebug directory to this new directory

Create an icon for the DRIDEB.EXE program in the new directory (donot forget to check the "Run in Separate Memory" check box in theicon definition dialog box)

Remote Operation

Installation of theServer Program(DDsrvr.exe)

Installation of theDriveDebugProgram to aRemote PC

$SSHQGLFHV


Copy the Dwc_ddcp.dll file from the Remote DriveDebugdirectory (under the DriveDebug directory) to the new directory. Thisfile overwrites the existing file with the same name.

Start the Notepad program, write the IP address of the PC where theDDserver.exe is (e.g. 121.111.1.1) to the screen of the Notepadprogram and finally save this text line (= IP address) to fileSERV_IP.TXT (to the new directory)

Start the execution of DriveDebug in the remote PC by double-clicking the new icon

In the remote mode:

• With fast network the execution time of DriveDebug operations isabout three times longer but with slower networks the executiontime can be much longer

• The time scale in Trend Windows (and Recording in MonitorWindow) is not accurate and there is no warning if the sampleinterval is too short

• Local Control may work with fast network but not with slowernetworks

• Menu command Target - Restore does not work if the memory ofthe target drive is empty.Target restore operation should always do locally and by using apoint-to-point connection to the drive.

SomeDifferencesbetween theLocal andRemote Use

$SSHQGLFHV


Appendix 6

Visual Basic programs (running under Windows XP, Windows 2000and Windows NT) can use DriveDebug functions to:

• Upload parameter list

• Read/write parameter values

• Upload Data Logger samples and control Data Logger

• Upload fault list and clear Fault Logger

• Execute Local Control operations

• Transmit and receive datasets

• Use the digital and analogue inputs/outputs connected to PC

Visual Basic programs can be either local programs (i.e. they run in aPC 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 aTCP/IP network).

In addition to the stand-alone MS Visual Basic product, thesefunctions can be used (in the local mode only) with the Visual Basicfor Applications language that is integrated with MS Excel and otherMS Office products.

The details of the functionality mentioned above are described indocument DD_VB.PDF. This file is in the Visual BasicInterface directory (under the DriveDebug directory). TheDriveDebug directory is specified during the installation ofDriveDebug and the default directory name isC:\ProgramFiles\DriveWare\DriveDebugx.x.

Visual BasicInterface

$SSHQGLFHV


$%%�2\DrivesP.O.Box 184FIN-00381 HELSINKIFINLANDTelephone + 358 10 22 11Telefax + 358 10 22 22681

3AF

E 6

4289

918

R01

25 R

ev N

EF

FE

CT

IVE

: 31.

05.2

0022

000

drivedebug user manual

Documents

drivedebug software

drivedebug hardware

drivedebug program

ddcs pcmcia card

list window

target list

ddcs isa board

pci pcmcia adapter