Saving and Restoring Parameters
Saving and Restoring Parameters
Saving and Restoring Parameters
3AFE
00130808.DOC
Revision Page
AC DRIVES
1 / 18
ABB Industry Oy
Drive Products & Systems
Dept. Project Status Date
3AFE
00130808.DOC
Revision Page
AC DRIVES
2 / 18
4.3.6. 4.3.7. 4.3.8. 4.3.9. 4.3.10. 4.3.11. 4.3.12. 4.3.13. 4.3.14. 4.3.15. 4.3.16. 4.3.17. 4.4. 5. 6. 6.1. 6.2. 6.3.
ACS600 ......................................................................................................................................................... 14 ACS6000C .................................................................................................................................................... 14 ACS6000C-CC.............................................................................................................................................. 15 ACS6000SD .................................................................................................................................................. 15 ACS6000SD-FE ....................................................................................................................................... 16 ACW600 ................................................................................................................................................... 16 DCS600.................................................................................................................................................... 16 NCB.......................................................................................................................................................... 16 NTY .......................................................................................................................................................... 17 ACSPMM ................................................................................................................................................. 17 ACNPMM................................................................................................................................................. 17 DCS800.................................................................................................................................................... 17
OVERRIDING DEFAULTS ..................................................................................................................................... 17 EXTERNAL REFERENCES ......................................................................................................................... 18 OTHER FEATURES ...................................................................................................................................... 18 PERFORMANCE ................................................................................................................................................... 18 USABILITY, RECOVERY, SAFETY AND PROTECTION ............................................................................................ 18 PORTABILITY AND COMPATIBILITY ..................................................................................................................... 18
ABB Industry Oy
Drive Products & Systems
Dept. Project Status Date
3AFE
00130808.DOC
Revision Page
AC DRIVES
3 / 18
1. Preface
This document is an overall description about saving and restoring parameters in the 32-bit DriveWindow (version 2) for NT. This document is valid for version 2.0 Beta 7 and newer only.
1.1. Purpose
Saving and restoring parameters in DriveWindow 2 is needed to make commissioning, maintenance, and debugging of drives and drive systems fast and easy.
1.2. Product
DriveWindow 2 for NT is a 32-bit Windows program running under Windows NT 4.0 SP3 (or newer) operating system in a x86 PC.
Computer
Default
ABB Industry Oy
Drive Products & Systems
Dept. Project Status Date
3AFE
00130808.DOC
Revision Page
AC DRIVES
4 / 18
Device
In the context of computer technology, a device is a unit of hardware, outside or inside the case or housing for the essential computer (processor, memory, and data paths) that is capable of providing input to the essential computer or of receiving output or of both. The transmission of a file from one computer system to another, usually smaller computer system Equipment that converts electric to mechanical power. A GUI is a graphical (rather than purely textual) user interface to a computer. Hardware is the physical aspect of computers, telecommunications, and other information technology devices. The term arose as a way to distinguish the "box" and the electronic circuitry and components of a computer from the program you put in it to make it do things. 1) Using hypertext, a link is a selectable connection from one word, picture, or information object to another. 2) In telecommunications, a link is a physical (and, in some usages, a logical) connection between two points. In computers, in general, a separate unit of software or hardware. A series of points or nodes interconnected by communication paths. Networks can interconnect with other networks and contain subnetworks. A programming structure encapsulating both data and functionality that are defined and allocated as a single unit and for which the only public access is through the programming structure's interfaces. A way to transfer and share information between applications. OLE for Process Control. An emerging software technology standard (http://www.opcfoundation.org/) that connects Windows-based process control systems to hardware devices on the plant floor. This technology provides a common interface to different hardware devices, allowing process control applications to communicate with broad set of devices. An operating system (sometimes abbreviated as "OS") is the program that, after being initially loaded into the computer by a boot program, manages all the other programs in a computer. The other programs are called applications or application programs. The application programs make use of the operating system by making requests for services through a defined application program interface (API). In addition, users can interact directly with the operating system through a user interface such as a command language or a graphical user interface (GUI).
Link
Module Network
Object
OLE OPC
Operating System
ABB Industry Oy
Drive Products & Systems
Dept. Project Status Date
3AFE
00130808.DOC
Revision Page
AC DRIVES
5 / 18
Parameter
In information technology, a parameter (from Greek for, roughly, through measure) is an item of information - such as a name, a number, or a selected option - that is passed to a program by a user or another program. Parameters affect the operation of the program receiving them. A password is an unspaced sequence of characters used to determine that a computer user requesting access to a computer system is really that particular user. Personal Computer. When a program runs, a Windows NT process is created. A process is an object type which consists of an executable program, a set of virtual memory addresses, and one or more threads In computing, a program is a specific set of ordered operations for a computer to perform. In the modern computer that John von Neumann outlined in 1945, the program contains a one-at-a-time sequence of instructions that the computer follows. In networking, a formal set of rules governing the format, timing, sequencing, and error control of exchanged messages on a data network; may also include facilities for managing a communications link and/or contention resolution; a protocol may be oriented toward data transfer over an interface, between two logical units directly connected, or on an end-to-end basis between two end users over a large and complex network. In the Microsoft Windows operating systems, the Registry is a single place for keeping such information as what hardware is attached, what system options have been selected, how computer memory is set up, and what application programs are to be present when the operating system is started. To mark an item so that a subsequent action can be carried out on that item. You usually select an item by clicking it with a mouse or pressing a key. After selecting an item, you choose the action that you want to affect the item. In programming, a string is a contiguity sequence of symbols or values, such as a character string (a sequence of characters) or a binary digit string (a sequence of binary values). Software is a general term for the various kinds of programs used to operate computers and related devices. The transmission of a file from one computer system to another, usually larger computer system.
Password
PC Process
Program
Protocol
Registry
Select
String
Software Uploading
ABB Industry Oy
Drive Products & Systems
Dept. Project Status Date
3AFE
00130808.DOC
Revision Page
AC DRIVES
6 / 18
User Interface
In information technology, the user interface (UI) is everything designed into an information device with which a human being may interact -- including display screen, keyboard, mouse, light pen, the appearance of a desktop, illuminated characters, help messages, and how an application program or a Web site invites interaction and responds to it. A rectangular area on your screen in which you view an application or document. An operating system made by Microsoft. Rumors has it that NT stands for "New Technology". The fact is that NT was born from a project led by David Cutler, formelly DEC's researcher, hired by Microsoft in 1988 specially to devellop a new outstanding operating system. At DEC, Cutler had created several operating systems, including the very famous VMS (now called OpenVMS) from which NT has inherited some features such as process' priority levels and dynamic working set trimming. Some people say that the name Windows NT (WNT) was derived by taking the next letters of V, M and S, respectivelly. You can reach Cutler's unnoficial fan club at http://web.wt.net/~shannonh. The OpenVMS home page can be found at http://www.digital.com/openvms. I have used VMS and NT for several years, so I can tell you: they both are really fantastic! The very first commercial version of NT appeared in 1993, and was called Microsoft Windows NT 3.1. Following that we had the versions 3.5 (1994), 3.51 (1995) and 4.0 (1996). The next version of NT (5.0) will probably come in the first half of 1999, and you can expect a great deal of changes in this really new version. Check this information at http://www.microsoft.com/ntserver. (Source: http://www.netcettera.com.br/history.htm)
Window Windows NT
x86
A generic name for the series of Intel microprocessor families that began with the 80286 microprocessor.
2. General Description
This document describes, how to configure DriveWindow 2 so that it can save and restore proper parameters of a certain kind of drive. It also describes the default parameter restore configurations for different kind of drives. Parameter saving and restoring (downloading) are commands selectable from the user interface.
ABB Industry Oy
Drive Products & Systems
Dept. Project Status Date
3AFE
00130808.DOC
Revision Page
AC DRIVES
7 / 18
3. Parameter Handling
3.1. Saving
Parameters are saved into a file by users request.
All visible, i.e., parameters not currently protected by pass code, of the selected drive (or an open parameter file, if it is selected) are saved. In addition those pass code protected parameters, which are listed in restore configuration, are saved. Real names of the protected parameters or their groups are not saved, but the groups are named as Group n Backup and the parameters n.m: Parameter n.m Backup. The file has filename extension DWP. It is human readable ASCII file. You must not edit or otherwise change it by using other programs than DriveWindow 2. The format of the file content is not described here. Note that the parameters currently protected by pass code are not saved unless listed in restore configuration.
ABB Industry Oy
Drive Products & Systems
Dept. Project Status Date
3AFE
00130808.DOC
Revision Page
AC DRIVES
8 / 18
The opened file can then be browsed even off-line, and parameter values can be changed the same way as drive parameters are changed. The changes are lost, however, unless the open parameter file is saved. Note that closing (or deleting from desktop) of the parameter file never prompts saving of changes made.
3.3. Restoring
3.3.1. Starting and Checking
To restore parameters, the parameter file containing parameters to be restored has first to be opened and the drive selected. Restoring starts by users request.
ABB Industry Oy
Drive Products & Systems
Dept. Project Status Date
3AFE
00130808.DOC
Revision Page
AC DRIVES
9 / 18
DriveWindow 2 checks that all items with tags Properties.* and Application.Properties.* have the same value in the file and in the drive. In addition it checks the same way items listed as checking parameters in the restore configuration. Note that the kind of drive to be used in selecting the restore configuration is read from the drive, not from the opened parameter file. If checking does not pass, the user still has the option to continue (at her own risk).
User Parameters consist of parameters in groups 10...98 except those of string type. They also include parameters listed as user parameters in parameter restore configuration for the drive. This list can also contain string type of parameters. Id Run Result Parameters consist of parameters listed as id run parameters in parameter restore configuration for the drive. If the id run list is empty or not all parameters required by the list are present in the open parameter file, the ID run results selection is grayed and cannot be selected.
3.3.3. Downloading
Before downloading, a parameter lock, if specified in the restore configuration, is opened after saving its current status. The hourglass cursor is shown while the parameters are downloaded, which may take several minutes, especially if pauses are included in the restore configuration list. In DriveWindow 2 versions prior 2.12, the user parameter download order is: parameters in groups 1098 first, then parameters listed as user parameters in parameter restore configuration. In DriveWindow 2 version 2.12 and newer, the user parameter download order is: parameters listed as user parameters in parameter restore configuration first, then parameters in groups 1098. This ordering makes it possible to download some parameters, which would be locked otherwise. After downloading has been done, the parameter lock value is restored, if there was a parameter lock specified. If the downloading fails, a message is shown to the user.
ABB Industry Oy
Drive Products & Systems
Dept. Project Status Date
3AFE
00130808.DOC
Revision Page
AC DRIVES
10 / 18
Note that if there is another drive at node address 1 in the same communication channel, the drive cannot be restarted through DriveOPC. If this is the case, the user is informed about the condition. Restarting can then be done by hard reset after Network Disconnect or exiting DriveWindow 2. If Id Run Result Parameters were downloaded, we recommend restarting of the drive. Otherwise the decision has to be made by the user. Note that restarting the drive causes the DriveWindow 2 workspace reset because of internal Network Disconnect/Reconnect. So, monitoring is stopped and the monitor is cleared, for example. Note that if the node address changes when the parameters are restored, the behaviour of DriveWindow 2 is not specified. It may be that the restoration fails or the drive disappears from the tree when restarting the drive.
4. Restore Configuration
4.1. Configuration File
Restore configuration is read from DW2.INI file, which must be in the Windows (Winnt) directory. Instead of a file, it is also possible to configure the registry such a way that the information is taken from registry (consult Windows NT/2000 documentation).
ABB Industry Oy
Drive Products & Systems
Dept. Project Status Date
3AFE
00130808.DOC
Revision Page
AC DRIVES
11 / 18
4.1.3. Keys
The following keys within sections are recognized: Key LockParameter CheckGroupCount CheckGroupn UserGroupCount UserGroupn IdRunGroupCount IdRunGroupn Value Group.Index or empty n Parameterlist n Parameterlist or Pause n Parameterlist or Pause Remarks If empty, there is no parameter lock Number of CheckGroup keys. n = 1... CheckGroupCount Number of UserGroup keys. n = 1... UserGroupCount Number of IdRunGroup keys. n = 1... IdRunGroupCount
Group is the parameter group. Index is the index of parameter within a group n is a number 0...(in GroupCount values) or 1... (in Group keys). Pause is Pause:s, where s is the time in seconds paused when restoring the parameters ParameterList is Group:IndexList, which lists parameters belonging to Group. IndexList is a comma separated list, elements of which consist of either Index-Index or Index. The hyphen separated notation means a range of indexes. For example, 2-5 means 2,3,4,5.
Spaces surrounding colon, comma, and hyphen are ignored. All parameters must be readable and other than CheckGroup parameters also writeable. Note that there is no error checking when reading the restore lists, so editing the lists must be done with extra care and the changes should be tested carefully.
4.1.4. LockParameter
Unless empty, this is the (Boolean) parameter, which must contain FALSE (0) when restoring parameters.
4.1.5. CheckGroup
Contains parameters that are used in checking phase during restoration. In addition to the properties always checked, the values of these parameters should be the same both in the drive and the parameter file to be downloaded.
4.1.6. UserGroup
Contains additional parameters, which are restored when user has selected restoration of User Parameters. Parameters other than type string, which are in groups 10...98 and are not pass code protected, need not to be listed here, because they are automatically included.
ABB Industry Oy
Drive Products & Systems
Dept. Project Status Date
3AFE
00130808.DOC
Revision Page
AC DRIVES
12 / 18
4.1.7. IdRunGroup
Contains parameters, which are restored when user has selected restoration of Id Run Result Parameters.
4.2. Ordering
During restore, the Groupn values are handled in order 1...n. Their order in the file does not matter. During save, any parameter is put into the save file only once, even if it is not pass code protected and appears several times in restore lists.
4.3.2. ACF600
[ACF600] LockParameter=102:1 CheckGroupCount=1 CheckGroup1=112:1-2 UserGroupCount=1 UserGroup1=101:3 IdRunGroupCount=6 IdRunGroup1=24:15-19 IdRunGroup2=26:3-7 IdRunGroup3=Pause:2 IdRunGroup4=190:7 IdRunGroup5=191:1,4-16,18-20 IdRunGroup6=192:2-3
ABB Industry Oy
Drive Products & Systems
Dept. Project Status Date
3AFE
00130808.DOC
Revision Page
AC DRIVES
13 / 18
4.3.3. ACN600
[ACN600] LockParameter=102:1 CheckGroupCount=1 CheckGroup1=112:1-2 UserGroupCount=1 UserGroup1=101:3 IdRunGroupCount=4 IdRunGroup1=110:1-4,6-7 IdRunGroup2=190:7 IdRunGroup3=191:1,4-16,18-20 IdRunGroup4=192:2-16,10,1
4.3.4. ACP600
[ACP600] LockParameter=102:1 CheckGroupCount=1 CheckGroup1=112:1-2 UserGroupCount=1 UserGroup1=101:3 IdRunGroupCount=7 IdRunGroup1=110:1-4,6-7 IdRunGroup2=190:7 IdRunGroup3=179:2-14,16-17 IdRunGroup4=192:2-16,1 IdRunGroup5=Pause:30 IdRunGroup6=179:2-14,16-17 IdRunGroup7=192:2-16,1
4.3.5. ACS1000
[ACS1000] LockParameter=102:1 CheckGroupCount=1 CheckGroup1=112:1-2,5 UserGroupCount=1 UserGroup1=101:3 IdRunGroupCount=5 IdRunGroup1=110:1-4,6-7 IdRunGroup2=114:1-20 IdRunGroup3=115:1-20 IdRunGroup4=112:1-35 IdRunGroup5=190:1-39
ABB Industry Oy
Drive Products & Systems
Dept. Project Status Date
3AFE
00130808.DOC
Revision Page
AC DRIVES
14 / 18
4.3.6. ACS600
[ACS600] LockParameter=102:1 CheckGroupCount=1 CheckGroup1=112:1-2 UserGroupCount=1 UserGroup1=101:3 IdRunGroupCount=4 IdRunGroup1=110:1-4,6-7 IdRunGroup2=190:7 IdRunGroup3=191:1,4-16,18-20 IdRunGroup4=192:2-16,10,1
4.3.7. ACS6000C
[ACS6000C] LockParameter=102:1 CheckGroupCount=1 CheckGroup1=110:1-2 UserGroupCount=0 IdRunGroupCount=20 IdRunGroup1=101:2-3,1 IdRunGroup2=110:1,6 IdRunGroup3=120:1-2 IdRunGroup4=121:1,5 IdRunGroup5=150:1-5,7-10,13,11 IdRunGroup6=166:18,36 IdRunGroup7=165:23 IdRunGroup8=131:3 IdRunGroup9=135:6-7,2,4 IdRunGroup10=166:21 IdRunGroup11=136:1-2 IdRunGroup12=132:1-2,4 IdRunGroup13=151:1-20 IdRunGroup14=165:29 IdRunGroup15=133:41 IdRunGroup16=132:3 IdRunGroup17=131:8 IdRunGroup18=158:2 IdRunGroup19=120:13 IdRunGroup20=152:1
ABB Industry Oy
Drive Products & Systems
Dept. Project Status Date
3AFE
00130808.DOC
Revision Page
AC DRIVES
15 / 18
4.3.8. ACS6000C-CC
[ACS6000C-CC] LockParameter=102:1 CheckGroupCount=1 CheckGroup1=110:1-2 UserGroupCount=0 IdRunGroupCount=13 IdRunGroup1=101:2-3 IdRunGroup2=110:1-6 IdRunGroup3=121:1-6,14-18 IdRunGroup4=139:1-8,13-15 IdRunGroup5=142:8IdRunGroup6=154:3-5,14 IdRunGroup7=156:3-5,14 IdRunGroup8=158:7 IdRunGroup9=160:7 IdRunGroup10=168:3 IdRunGroup11=170:3 IdRunGroup12=182:16-23 IdRunGroup13=199:1
4.3.9. ACS6000SD
[ACS6000SD] LockParameter=102:1 CheckGroupCount=1 CheckGroup1=110:1-2 UserGroupCount=0 IdRunGroupCount=20 IdRunGroup1=101:2-3,1 IdRunGroup2=110:1,6 IdRunGroup3=120:1-2 IdRunGroup4=121:1,5 IdRunGroup5=150:1-5,7-10,13,11 IdRunGroup6=166:18,36 IdRunGroup7=165:23 IdRunGroup8=131:3 IdRunGroup9=135:6-7,2,4 IdRunGroup10=166:21 IdRunGroup11=136:1-2 IdRunGroup12=132:1-2,4 IdRunGroup13=151:1-20 IdRunGroup14=165:29 IdRunGroup15=133:41 IdRunGroup16=132:3 IdRunGroup17=131:8 IdRunGroup18=158:2 IdRunGroup19=120:13 IdRunGroup20=152:1
ABB Industry Oy
Drive Products & Systems
Dept. Project Status Date
3AFE
00130808.DOC
Revision Page
AC DRIVES
16 / 18
4.3.10. ACS6000SD-FE
[ACS6000SD-FE] LockParameter=102:1 CheckGroupCount=1 CheckGroup1=110:1-2 UserGroupCount=0 IdRunGroupCount=13 IdRunGroup1=101:2-3 IdRunGroup2=110:1-6 IdRunGroup3=121:1-6,14-18 IdRunGroup4=139:1-8,13-15 IdRunGroup5=142:8-9 IdRunGroup6=154:3-5,14 IdRunGroup7=156:3-5,14 IdRunGroup8=158:7 IdRunGroup9=160:7 IdRunGroup10=168:3 IdRunGroup11=170:3 IdRunGroup12=182:16-23 IdRunGroup13=199:1
4.3.11. ACW600
[ACW600] LockParameter=102:1 CheckGroupCount=1 CheckGroup1=112:1-2 UserGroupCount=1 UserGroup1=101:3 IdRunGroupCount=4 IdRunGroup1=110:1-4,6-7 IdRunGroup2=190:7 IdRunGroup3=191:1,4-16,18-20 IdRunGroup4=192:2-16,10,1
4.3.12. DCS600
[DCS600] LockParameter=102:1 CheckGroupCount=1 CheckGroup1=171:10-11 UserGroupCount=1 UserGroup1=101:3 IdRunGroupCount=0
4.3.13. NCB
[NCB] LockParameter= CheckGroupCount=0 UserGroupCount=0 IdRunGroupCount=0
ABB Industry Oy
Drive Products & Systems
Dept. Project Status Date
3AFE
00130808.DOC
Revision Page
AC DRIVES
17 / 18
4.3.14. NTY
[NTY] LockParameter= CheckGroupCount=0 UserGroupCount=0 IdRunGroupCount=0
4.3.15. ACSPMM
[ACSPMM] LockParameter=102:1 CheckGroupCount=1 CheckGroup1=112:1-2 UserGroupCount=1 UserGroup1=101:3 IdRunGroupCount=6 IdRunGroup1=110:1-4,6-7 IdRunGroup2=151:1-26 IdRunGroup3=190:7 IdRunGroup4=191:1,4-5 IdRunGroup5=192:1-16 IdRunGroup6=193:1,6-7,10-11,14-16
4.3.16. ACNPMM
[ACNPMM] LockParameter=102:1 CheckGroupCount=1 CheckGroup1=112:1-2 UserGroupCount=1 UserGroup1=101:3 IdRunGroupCount=6 IdRunGroup1=110:1-4,6-7 IdRunGroup2=151:1-26 IdRunGroup3=190:7 IdRunGroup4=191:1,4-5 IdRunGroup5=192:1-16 IdRunGroup6=193:1,6-7,10-11,14-16
4.3.17. DCS800
[DCS600] CheckGroupCount=0 UserGroupCount=1 UserGroup1=99:9 IdRunGroupCount=0
ABB Industry Oy
Drive Products & Systems
Dept. Project Status Date
3AFE
00130808.DOC
Revision Page
AC DRIVES
18 / 18
5. External References
In addition to a normal operating system installation, the DriveWindow 2 program does not require any other programs or modules to be present. All modules required are included in the DriveWindow 2 installation.
6. Other Features
6.1. Performance
Drive communication link speed limits performance of the parameter handling functions. When remotely connected, the network limits DriveWindow 2 response to user actions.