background image

Industrial IT enabled products from ABB are the building blocks 
for greater productivity, featuring all the tools necessary for 
lifecycle product support in consistent electronic form.

SPA OPC Server

User’s Manual

Summary of Contents for SPA OPC

Page 1: ...trial IT enabled products from ABB are the building blocks for greater productivity featuring all the tools necessary for lifecycle product support in consistent electronic form SPA OPC Server User s Manual ...

Page 2: ......

Page 3: ...SPA OPC Server Version 1 0 User s Manual ...

Page 4: ......

Page 5: ...ocument This document and parts thereof must not be reproduced or copied without written permission from ABB Oy and the contents thereof must not be im parted to a third party nor used for any unauthorized purpose The software or hardware described in this document is furnished under a li cense and may be used copied or disclosed only in accordance with the terms of such license Copyright 2003 ABB...

Page 6: ......

Page 7: ... Section 2 Installation This section provides you with instructions on how to install the SPA OPC Server software and other required software and hardware components Section 3 Features This section gives an overview of the features of the SPA OPC Server Section 4 Engineering In this section you will find an overview of engineering You are given instructions on how to configure the SPA OPC Server r...

Page 8: ...ER key Lowercase letters are used for the name of a keyboard key that is not labeled on the keyboard For example the space bar comma key and so on Press CTRL C indicates that you must hold down the CTRL key while pressing the C key to copy a selected object in this case Press ESC E C indicates that you press and release each key in sequence to copy a selected object in this case The names of push ...

Page 9: ...ws in the procedure MIF349 Variables are shown using lowercase letters sequence name All the figures in this document have been taken using Windows XP Terminology The following is a list of terms associated with the SPA OPC Server that you should be familiar with The list contains terms that are unique to ABB or have a usage or definition that is different from the standard industry usage Term Des...

Page 10: ...otocol used in substation automation SPA device Protection and or Control Product supporting the SPA protocol version 2 5 or earlier AE Alarms and Events DA Data Access DCOM Distributed Component Object Model OPC Series of standards specifications aiming at open connectivity in industrial automation and the enterprise systems that support industry Category Title Document number Technical descripti...

Page 11: ...ccess Namespace 26 3 2 Attributes 28 3 2 1 Server attributes 29 3 2 2 Line attributes 29 3 2 3 Device attributes 31 3 3 OPC Alarms and Events Area Space 32 3 3 1 System message events 33 3 3 2 Discrete Indication events 33 Section 4 Engineering 4 1 About this section 35 4 2 Overview of the engineering 36 4 3 Creating an object tree 43 4 3 1 SPA OPC Server object 43 4 3 2 Adding SPA Line objects 43...

Page 12: ...g objects 45 4 4 Configuring objects 46 4 4 1 SPA OPC Server properties 47 4 4 2 SPA Line properties 48 4 4 3 SPA Device and SPA Module properties 49 4 4 4 SPA Signal properties 49 4 5 Adding event definitions 54 Appendix A Status Codes Appendix B DCOM configuration INDEX 65 ...

Page 13: ...s the OPC Data Access v 1 0 2 0 and OPC Alarm and Event interfaces It can be run on the same computer with an OPC Client see Figure 1 1 or on a separate communication server computer If the SPA OPC server is running on a separate computer the communication between the client and the server is based on Distributed Component Object Model DCOM see DCOM configuration on page 59 PC with Windows 2000 or...

Page 14: ...erver software The backup image will then contain both the system and application specific files 1 4 Fatal errors A fatal error is an error that causes a breakdown or a locked situation in the program 1 4 1 Handling In case of a fatal error 1 Write down the possible SPA OPC Server error messages 2 If necessary shut down the SPA OPC Server program in the WindowsTM1 Task Manager 3 The data kept in t...

Page 15: ...equirements can be seen below 20 MB free hard disk space if Microsoft NET Framework 1 1 which is required for running the SPA OPC Server Configuration Tool has been installed already 100 MB free hard disk space includes installation of Microsoft NET Framework 1 1 It is installed automatically if it is not found The following issues affect the performance of the system and should also be considered...

Page 16: ...221 2 2 Installation of the SPA OPC Server To install the SPA OPC Server 1 Start the installation program The Setup dialog box is displayed Click Next to continue the installation or choose Cancel if you do not want to install see Figure 2 1 Figure 2 1 Setup dialog box ...

Page 17: ...RS755221 17 2 The License Agreement dialog box appears on the screen Read the License Agreement and choose the I accept the license agreement radio button to accept the terms of it and click Next to continue see Figure 2 2 Figure 2 2 License Agreement dialog box ...

Page 18: ...ialog box appears on the screen The files for the SPA OPC Server are automatically installed in a certain folder Click Next to continue the installation If you want to install the files in a different folder choose Browse see Figure 2 3 license_agreement tif Figure 2 3 Wise Installation Wizard dialog box ...

Page 19: ...ver Section 2 Installation 1MRS755221 19 4 The application is now ready to start installing the SPA OPC Server Click Next to continue or Back to reenter the installation information see Figure 2 4 Figure 2 4 Starting the installation ...

Page 20: ...stallation of the SPA OPC Server 20 1MRS755221 5 You can now follow the progress of the installation You can also cancel the installation at this point by selecting Cancel see Figure 2 5 Figure 2 5 Progress of the installation ...

Page 21: ...ation 1MRS755221 21 6 The License Installation dialog box is now displayed The Install a Demo license for SPA OPC Server check box is selected automatically Click Install to install a Demo license see Figure 2 6 Figure 2 6 License Installation dialog box ...

Page 22: ...ection 2 Installation Installation of the SPA OPC Server 22 1MRS755221 7 The installation of the SPA OPC Server is now complete Click OK to exit see Figure 2 7 Figure 2 7 Installation complete dialog box ...

Page 23: ...ation of the SPA OPC Server Section 2 Installation 1MRS755221 23 8 The SPA OPC Server has been successfully installed Click Finish to exit the installation see Figure 2 8 Figure 2 8 Finishing the installation ...

Page 24: ......

Page 25: ... SPA communication The SPA protocol v 2 5 or earlier supports max eight lines per server and max 30 devices modules per line Supported SPA data types and functions Event based single and double indications initial values requested when the server starts up Figure 3 1 Software component structure of the SPA OPC Server OPC Data Access Server OPC Alarm and Event Server Common services Configuration H...

Page 26: ...PA messages directly from an OPC client Time synchronization Dial up support for SPA devices connected through public telephone network 3 1 OPC Data Access Namespace An example of the OPC Data Access Namespace is shown in Figure 3 2 Table 3 1 describes all the components shown in Figure 3 2 Indentation is used to indicate the parent child relationship between the nodes ...

Page 27: ...OPC Data Access Namespace Section 3 Features 1MRS755221 27 Figure 3 2 OPC Data Access Namespace ...

Page 28: ...r SPA Device An object representing a physical device You should not have more than 30 devices modules per line or more than 200 devices modules per server SPA Rack Collection of SPA Modules in one physical rack SPA Module A SPA Device placed in a relay rack for example SPACOM modules You should not have more than 30 modules devices per line or more than 200 modules devices per server SPA Signals ...

Page 29: ...iption Protocol stack version Version information of the SPA protocol stack software Dial up Description Mode Integer 0 direct connection default 1 dial up connection Dial String A phone number to dial writing the number string activates the dialing Writing an empty string closes the connection hang up Dial up connection status Integer 0 Idle 1 Connected 2 Busy 3 Not in dial up mode 4 Configuratio...

Page 30: ...y time an event message is received to the SPA OPC server from the SPA line Received data messages Incremented every time a data message is received to the SPA OPC server from the SPA line Received messages Incremented every time a message is received to the SPA OPC Server from the SPA line Parity errors Incremented every time a parity error is detected in a message received from the SPA line Over...

Page 31: ... to value 0 the SPA OPC Server suspends all communication on that line Diagnostic counters Description Process data messages received Incremented every time a message containing process data is received from the device Event messages received Incremented every time a message containing an event is received from the device Suspensions Incremented every time the communication with the SPA device is ...

Page 32: ... device When the SPA device is taken into use In use set to value 1 the SPA OPC Server tries to establish communication with the device When a SPA device is taken out of use In use set to value 0 the SPA OPC Server does not communicate with the device anymore Device connection status Boolean The communication connection status of the device If the device is communicating properly the value is true...

Page 33: ...The notifications may be device_started device_suspended etc The source of such an event is the node name of the device or line from which the notification originates The message is Operation failed status code number For information on status codes see Status Codes on page 57 System message events may also be generated to inform about internal problems in the SPA OPC Server e g communication queu...

Page 34: ......

Page 35: ... guides you to the engineering tasks that are required before you can start using the SPA OPC Server To start the SPA OPC Server configuration tool select Start Programs SPA OPC Server SPA OPC Server Configuration Tool The Figure 4 1 shows how the configuration tool looks like at this point 1MRS755221 ...

Page 36: ...an object tree in the SPA OPC Server configuration tool to define the system structure The possible objects are SPA OPC Server Line Device Rack Module and Signal see Table 4 1 The toolbar is placed on top of the screen The icons for the selectable objects in the toolbar are colored and the icons that cannot be selected remain grey Figure 4 1 SPA OPC Server configuration tool ...

Page 37: ...ng the configured signals appears at the bottom of the screen The Figure 4 2 shows an example view of the SPA OPC Server configuration tool including the following parts 1 Object tree 2 Toolbar 3 Property grid window displaying the object properties 4 Signal table To view the SPA OPC Server User s Manual as a pdf file choose Help Manual To view the version of the SPA OPC Server Configuration Tool ...

Page 38: ...onfiguration file opcs_example ini which is delivered with this installation package It is also possible to open several configurations at the same time and copy SPA OPC Server objects from an existing configuration file to another configuration file Note that when you open the configuration tool for the first time there is no existing active configuration This means that the OPCS_SPA_1 folder is ...

Page 39: ...gnals Indentation is used to indicate the parent child relationship between the objects Table 4 1 describes the objects shown in the example object tree Figure 4 3 Table 4 1 SPA OPC Server related objects SPA OPC Server An object representing the SPA OPC Server SPA Line An object representing a physical communication line serial port You can define up to 8 lines per OPC server SPA Device An object...

Page 40: ...l information that a device or module provides The signals and their icons are the following Double Indication A signal consisting of two bits double binary Bit values are presented as an integer value 00 0 01 1 10 2 and 11 3 Single Indication A signal presenting one bit information values 0 or 1 Analog Input A signal presenting floating point value information Digital Input A signal presenting in...

Page 41: ...Overview of the engineering Section 4 Engineering 1MRS755221 41 Figure 4 3 Example of an object tree ...

Page 42: ...re 4 4 and Figure 4 5 When the SPA OPC Server is launched it reads the configuration data and establishes communication with the SPA devices Selecting File Save as saves the configuration in the Tool folder see Figure 4 4 The files in the Tool folder can be named however and any number of files can be saved in there To open an active configuration choose File Open active configuration This action ...

Page 43: ...n a signal table which appears below the object tree Add the objects in the following order Note that the SPA OPC Server object exists already 1 SPA Line object 2 SPA Device or SPA Rack objects 3 SPA Module objects with relay object only 4 SPA Signal objects For all the possible signal types see Table 4 1 4 3 1 SPA OPC Server object To start creating the object tree 1 Select File New in the SPA OP...

Page 44: ...ting object 3 Rename the Device or Rack object Note that the names of the devices and racks within a line have to be unique 4 3 4 Adding SPA Module objects To add a SPA Module object 1 Select a Rack object 2 There are four ways to add a SPA Module object to the object tree You can right click the Rack object and select Add Module You can choose the appropriate icon in the toolbar You can select Ed...

Page 45: ...the Signal object Note that the names of the signals within a device or module have to be unique 4 3 6 Deleting and copying objects To delete objects from the object tree right click the object you want to delete and choose Delete or choose the appropriate icon in the toolbar You can also select the object and click Edit Delete To copy objects right click the object you want to copy and select Cop...

Page 46: ...ject has configurable properties In addition to the property grid window signal properties can be modified also in the signal table see Figure 4 6 The Figure 4 7 shows an example of the line object properties in the OPC Server configuration tool See SPA Line properties on page 48 for further information on the line object properties Figure 4 7 An example line configuration ...

Page 47: ...r properties Name Default Description Use Reversed Double Positions False Specifies whether the ON and OFF values are reversed in double position indications or not When this option is True OFF 2 and ON 1 Enable OPC version 2 0 Optimizations True Enables faster and less memory consuming connections for the OPC v2 clients NOTE The OPC v1 clients are not fully supported when this option is enabled ...

Page 48: ...0 bits s 9600 bits s 19200 bits s Default 9600 bits s Transmission rate used on the line Polling Delay 20 ms Defines the delay between polling telegrams in milliseconds range 0 500 Time Synchronization Mode Time synchronization used Time synchronization not used Default Time synchronization used Synchronization mode for the line Connection Type Dial up modem is connected Fixed channel dial up mode...

Page 49: ...ion address of the device used in the communication with SPA OPC Server The broadcast telegrams always use the address 900 and need not to be specified by this property range 0 899 Unit Type Alarm Unit Relay Unit Default Relay Unit Defines the type of the connected device Simulation Mode Simulation mode on Simulation mode off Default Simulation mode off Specifies whether the device is in simulatio...

Page 50: ... 0 999 SPA event code for value 0 0 Event code for intermediate 00 position event range 0 999 SPA event code for value 1 0 Event code for Off Open position event range 0 999 SPA event code for value 2 0 Event code for On Close position event range 0 999 SPA event code for value 3 0 Event code for invalid 11 position event range 0 999 OPC Event AE Event definition Default None Name of the event def...

Page 51: ...SPA event code for value 0 0 SPA Off Event Code range 0 999 SPA event code for value 1 0 SPA On Event Code range 0 999 OPC Event AE Event definition Default None Name of the event definition to be used with this object Name Default values Description Basic Channel 0 SPA Channel Number for indication range 0 999 Category I Input data O Output data S Setting V Variable Default I SPA Data Category fo...

Page 52: ... for indication range 0 999 Category I Input data O Output data S Setting V Variable Default I SPA Data Category for indication Data number 1 SPA Data Number for indication range 0 999 Name Default values Description Basic Channel 0 SPA Channel Number for command range 0 999 Category I Input data O Output data S Setting V Variable Default I SPA Data Category for command Data number 1 SPA Data Numb...

Page 53: ...mber for pulse counter range 0 999 Category I Input data O Output data S Setting V Variable Default I SPA Data Category for pulse counter Data number 1 SPA Data Number for pulse counter range 0 999 Name Default values Description Basic Channel 0 SPA Channel Number for command range 0 999 Category I Input data O Output data S Setting V Variable Default I SPA Data Category for command Data number 1 ...

Page 54: ...hare the same definition Continue creating other definitions in the same way 2 Attach the definition you created to a particular signal This is done under the signal object by giving the name of the AE Event Definition object e g breaker position as a value of an AE Event Definition property In the tables below you can view examples of both single and double indications Table 4 12 Event definition...

Page 55: ...everity of the event range 0 999 0 Sub Condition Value 0 Sub condition name of the event 0 Acknowledge Request True False Default False Determines whether a user acknowledgement is required for the event or not Event for value 1 1 Description Value changed to 1 Description text of the event 1 Severity 2 Severity of the event range 0 999 1 Sub Condition Value 1 Sub condition name of the event 1 Ack...

Page 56: ...nes whether a user acknowledgement is required for the event or not Event for value 3 3 Description Value changed to 3 Description text of the event 3 Severity 4 Severity of the event range 0 999 3 Sub Condition Value 3 Sub condition name of the event 3 Acknowledge Request True False Default False Determines whether a user acknowledgement is required for the event or not Name Value or Value range ...

Page 57: ...parent SPA reply available 13229 Out of buffers error 13251 Device suspended 13252 Device taken out of use 13253 Device taken into use 13254 Out of memory error 13255 Timeout while waiting response 13258 General interrogation finished 17201 Timeout while waiting CTS signal 17202 CTS signal inactivated during transmission 17203 Redundancy error in response 17204 Timeout while waiting response 17205...

Page 58: ......

Page 59: ... on the client computer unless the client uses the OPC Server Browser OPCENUM EXE provided by the OPC Foundation or unless the client can browse the registry on the server computer The registration is done automatically during the installation Therefore it may be easiest to install the server also on the client computer if the client requires local registry entries for the server DCOM uses securit...

Page 60: ...tree choose the SPA OPC DA Server Instance 1 object see Figure 4 9 Right click the SPA OPC DA Server Instance 1 object and choose properties to find the DCOM properties of the OPC Server see Figure 4 10 Figure 4 9 OPC Server location in the tree ...

Page 61: ...1MRS755221 61 More information on DCOM is available in Microsoft Developer Network MSDN Figure 4 10 Example of DCOM properties ...

Page 62: ...security for the OPC Server Set custom access to NETWORK SYSTEM Everyone Set custom launch permissions to INTERACTIVE SYSTEM NETWORK Everyone Set the identification for the OPC Server to Interactive User or configure it to run on a specific user account see Local DCOM configuration Client computer Default properties for the client computer are listed below Make sure that DCOM is enabled Set defaul...

Page 63: ...o run either as the Interactive User or in a specific user account This user If the server is configured to run in a specific user account its user interface will not be visible when it is activated by the COM runtime This is because it is not started in the interactive desktop The only place where it is visible is the Task Manager If the server is configured to run as the Interactive User it will...

Page 64: ......

Page 65: ...es 47 Connection Type 48 Creating Object tree 36 39 43 D DA 10 Data Access DA 9 10 Data types and functions 25 DCOM 10 Configuration 59 Device 9 28 39 Adding SPA Device objects 44 Device attributes 31 Dial up support 26 Digital Input 40 Discrete events 33 Distributed Component Object Model DCOM 10 13 Double Indication 40 E Error messages 14 Events 32 Condition event 33 Discrete 33 Event categories...

Page 66: ...Rack objects 44 Reinstalling the SPA OPC Server 14 S Saving Configuration data 39 42 Server Local 59 Remote 59 Server attributes 29 Shutting down 14 Signals 28 40 Adding SPA Signal objects 44 Signal changes 15 Signal table 37 Single and double indications 25 Single Indication 40 Software component structure 25 SPA data types and functions 25 SPA Device 10 13 28 39 SPA Line 28 39 SPA messages Recei...

Page 67: ......

Page 68: ...1MRS755221 EN 12 2003 ABB Oy Substation Automation P O Box 699 FIN 65101 VAASA Finland Tel 358 10 22 11 Fax 358 10 224 1094 www abb com substationautomation ...

Reviews: