1. Manuals
  2. Brands
  3. ABB Manuals
  4. Server
  5. SPA OPC
  6. User manual

ABB SPA OPC Server User Manual

Hide thumbs
Table of Contents

Quick Links

SPA OPC Server
User's Manual
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.
Table of Contents
loading

Related Manuals for ABB SPA OPC Server

Summary of Contents for ABB SPA OPC Server

  • Page 1 SPA OPC Server User’s Manual 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.
  • Page 3 SPA OPC Server Version 1.0 User’s Manual...
  • Page 5 NOTICE The information in this document is subject to change without notice and should not be construed as a commitment by ABB Oy. ABB Oy assumes no responsibility for any errors that may appear in this document. In no event shall ABB Oy be liable for direct, indirect, special, incidental or...

  • Page 7: About This Book

    This user’s manual describes the stand-alone SPA OPC Server and the central concepts related to it. You will find instructions on how to install the SPA OPC Server and how to take it into use. The basic operation procedures are also discussed.

  • Page 8: Document Conventions

    A warning icon indicates the presence of a hazard which could result in personal injury. A caution icon indicates important information or warning related to the concept discussed in the text. It might indicate the presence of a hazard which could result in corruption of software or damage to equipment/property.
  • Page 9 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.

  • Page 10: Related Documentation

    SPA device Protection and/ or Control Product supporting the SPA protocol version 2.5 or earlier. Abbreviations The following is a list of abbreviations associated with the SPA OPC Server that you should be familiar with. Alarms and Events Data Access...

  • Page 11: Table Of Contents

    1.4 Fatal errors ........................14 1.4.1 Handling ....................... 14 Section 2 - Installation 2.1 System requirements ..................... 15 2.2 Installation of the SPA OPC Server ................16 Section 3 - Features 3.1 OPC Data Access Namespace ..................26 3.2 Attributes ........................28 3.2.1 Server attributes ....................
  • Page 12 4.3.5 Adding SPA Signal objects .................. 44 4.3.6 Deleting and copying 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 ..................

  • Page 13: Section 1 - Introduction

    Figure 1-1: The SPA OPC Server system overview The SPA OPC Server supports 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.

  • Page 14: Safety Information

    1.3 Backup All the project specific data is stored into the configuration file opcs_net.ini. Therefore it is usually enough to create a backup only for this file. Reinstalling the SPA OPC Server software will restore the rest of the required files.

  • Page 15: Section 2 - Installation

    SPA OPC Server. 2.1 System requirements The SPA OPC Server runs on the Windows 2000 and Windows XP Operating System. A PC capable of running one of these operating systems and applications is usually sufficient also for the SPA OPC Server.

  • Page 16: Installation Of The Spa Opc Server

    Section 2 Installation Installation of the SPA OPC Server 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.
  • Page 17 Installation of the SPA OPC Server Section 2 Installation 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.
  • Page 18 Section 2 Installation Installation of the SPA OPC Server 3. The Wise Installation Wizard dialog 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.
  • Page 19 Installation of the SPA OPC Server Section 2 Installation 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 Section 2 Installation Installation of the SPA OPC Server 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 Section 2 Installation 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 Section 2 Installation Installation of the SPA OPC Server 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 1MRS755221...
  • Page 23 Installation of the SPA OPC Server Section 2 Installation 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 1MRS755221...

  • Page 25: Section 3 - Features

    Section 3 Features Section 3 Features The purpose of this section is to describe the basic features of the SPA OPC Server. This chapter also describes concepts like OPC Data Access Namespace, Attributes and OPC Alarms and Events Area Space.

  • Page 26: Opc Data Access Namespace

    Section 3 Features OPC Data Access Namespace – Cyclically updated measurements – Direct and secure commands – Transparent SPA support for sending and receiving SPA 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.
  • Page 27 OPC Data Access Namespace Section 3 Features Figure 3-2: OPC Data Access Namespace 1MRS755221...

  • Page 28: Attributes

    The parent node can be the server, a line or device. 3.2 Attributes In addition to item tags for process data (indications and commands), the SPA OPC Server also provides some item tags for controlling the devices and retrieving status information from them. These item tags are called attributes.

  • Page 29: Server Attributes

    Attributes Section 3 Features 3.2.1 Server attributes Server attributes display information on the protocol stack. The end user does not necessarily need any of these attributes. Table 3-2: Server attributes Description Protocol stack version Version information of the SPA protocol stack software.
  • Page 30 Sends a string to the modem, e.g. AT command. Diagnostic counters Description Transmitted messages Incremented every time a message is transmitted to the SPA line by the SPA OPC Server. Failed transmissions Incremented every time a message transmission to the SPA line fails for some reason.

  • Page 31: Device Attributes

    SPA devices configured to the line. When the SPA line is taken into use (In use set to value 1), the SPA OPC Server tries to establish communication with the devices configured to the line. When the SPA...

  • Page 32: Opc Alarms And Events Area Space

    Codes on page 57 for status code values and explanation. In use Integer Controls whether the SPA OPC Server tries to communicate with the 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.

  • Page 33: System Message Events

    Section 3 Features The generated event type for a signal is always a condition event. The event categories used by the SPA OPC Server are listed in Table 3-5. They are described more precisely in sections 3.3.1 and 3.3.2. Table 3-5: Event categories and event types...

  • Page 35: Section 4 - Engineering

    This section 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.

  • Page 36: Overview Of The Engineering

    Figure 4-1: SPA OPC Server configuration tool Overview of the engineering Before you can start using the SPA OPC Server, you need to create and configure 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.
  • Page 37 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, choose Help > About.
  • Page 38 Tool folder. By selecting File > Open you can also find an example configuration 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.
  • Page 39 In the example tree you can see the SPA OPC Server object and its child objects like lines, devices, racks, modules and signals. Indentation is used to indicate the parent-child relationship between the objects.
  • Page 40 A signal presenting long integer value information. Analog Setpoint A signal for controlling analog setpoints/outputs. After you have added the required objects to the SPA OPC Server Configuration Tool, you need to configure them, see Configuring objects on page 46. 1MRS755221...
  • Page 41 Overview of the engineering Section 4 Engineering Figure 4-3: Example of an object tree 1MRS755221...
  • Page 42 The configuration that has been saved as active in the OPC Server refers to the opcs_net.ini file saved in the OPCS_SPA_1 folder, see Figure 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.

  • Page 43: Creating An Object Tree

    Section 4 Engineering 4.3 Creating an object tree The object tree is built in the SPA OPC Server Configuration Tool (see Figure 4-3). It is built by adding objects in a logical order to the SPA OPC Server Configuration Tool starting from the SPA OPC Server object.

  • Page 44: Adding Spa Device Or Spa Rack Objects

    Section 4 Engineering Creating an object tree 3. Rename the Line object. Note that the names of the lines have to be unique. 4.3.3 Adding SPA Device or SPA Rack objects To add a SPA Device or SPA Rack object 1.

  • Page 45: Deleting And Copying Objects

    Creating an object tree Section 4 Engineering • You can right-click the Device or Module object and select the Signal object you want to add, e.g. Add Double Indication. • You can choose the appropriate icon in the toolbar. • You can also select Edit >...

  • Page 46: Configuring Objects

    Section 4 Engineering Configuring objects 4.4 Configuring objects After the objects have been added, you need to configure the object properties. Nearly every object 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.

  • Page 47: Spa Opc Server Properties

    Configuring objects Section 4 Engineering 4.4.1 SPA OPC Server properties Table 4-2 lists the configurable SPA OPC Server properties, defaults, and descriptions. Table 4-2: SPA OPC Server properties Name Default Description Use Reversed False Specifies whether the ON and OFF...

  • Page 48: Spa Line Properties

    Section 4 Engineering Configuring objects 4.4.2 SPA Line properties Table 4-3 lists the default values for the SPA Line properties that you can define. Table 4-3: SPA Line properties Name Default values Description Basic attributes Communication Port COM1...COM32 The communication port of the SPA Line Default:COM1 Bit Rate 300 bits/s...

  • Page 49: Spa Device And Spa Module Properties

    Basic Communication The unique communication address of the Address 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 Defines the type of the connected device.
  • Page 50 Section 4 Engineering Configuring objects Channel SPA Channel Number for indication, range 0-999. Category I = Input data SPA Data Category for indication. O = Output data S = Setting V = Variable Default: I Data number SPA Data Number for indication, range 0-999.

  • Page 51: Analog Input

    Configuring objects Section 4 Engineering Category I = Input data SPA Data Category for indication. O = Output data S = Setting V = Variable Default: I Data number SPA Data Number for indication, range 0- 999. SPA event code SPA Off Event Code, range 0-999.
  • Page 52 Section 4 Engineering Configuring objects 4.4.4.4 Digital Input Table 4-8: Digital Input properties Name Default values Description Basic Channel SPA Channel Number for indication, range 0-999. Category I = Input data SPA Data Category for indication. O = Output data S = Setting V = Variable Default: I...
  • Page 53 Configuring objects Section 4 Engineering 4.4.4.6 Pulse Counter Table 4-10: Pulse Counter properties Name Default values Description Basic Channel SPA Channel Number for pulse counter, range 0-999. I = Input data SPA Data Category for pulse counter. Category O = Output data S = Setting V = Variable Default: I...

  • Page 54: Adding Event Definitions

    Section 4 Engineering Adding event definitions 4.5 Adding event definitions It is possible to define events for single and double indications. They are added under AE Event Definitions in the same way as the other objects, see Creating an object tree on page 43.
  • Page 55 Adding event definitions Section 4 Engineering Name Value or Value range/ Description Default 1. Sub Condition Value 1 Sub condition name of the event. 1. Acknowledge True Determines whether a user Request acknowledgement is required for the False event or not. Default: False Table 4-13: Event definition properties for double indications Name...
  • Page 56 Section 4 Engineering Adding event definitions Name Value or Value range/ Description Default 2. Severity Severity of the event, range 0-999. 2. Sub Condition Value 2 Sub condition name of the event. 2. Acknowledge True Determines whether a user Request acknowledgement is required for the False event or not.

  • Page 57: Appendix A Status Codes

    Appendix A Status Codes Status codes 13201 Data overflow error 13202 Received reply length exceeds the allowed maximum length 13212 Unexpected response 13223 Unexpected value type 13225 Only write allowed 13226 No acknowledge reply 13227 Data discrepancy detected between data and event poll 13228 No transparent SPA reply available 13229...

  • Page 59: Appendix B Dcom Configuration

    Appendix B DCOM configuration By default, the OPC Server is installed and used as a local server, i.e. both the server and the client run on the same computer. The server can also be run as a remote server on another computer than the client.
  • Page 60 To find the OPC Server in the tree, choose the SPA OPC DA Server Instance [1] object, see Figure 4-9. Figure 4-9: OPC Server location in the tree 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.
  • Page 61 Figure 4-10: Example of DCOM properties More information on DCOM is available in Microsoft Developer Network (MSDN). 1MRS755221...
  • Page 62 • Set default impersonation level to "Impersonate" Before starting a remote SPA OPC Server, be sure that the SPA OPC Server computer and the OPC Client computer can access each other in the network. The "Remote Procedure Call" service should be started on the SPA OPC Server computer.
  • Page 63 Local DCOM configuration Sometimes it is necessary to configure DCOM even when the server and client run on the same computer. This is the case when two clients that are running in different user accounts must both access the same server. For example, an alarm and event client running as a service and an interactive data access client.

  • Page 65: Index

    Opening an active configuration ....42 opcs_example.ini ...........38 Saving configuration data ......42 opcs_net.ini ............14 Configuring Installation of the SPA OPC Server ......16 Objects ............ 39, 46 Item tags ..............28 SPA Device properties ........49 SPA Line properties ........48 SPA Module properties .........
  • Page 66 SPA Device ..........10, 13, 28, 39 Deleting objects ..........45 SPA Line .............. 28, 39 Object tree ............. 37 SPA messages SPA OPC Server related objects ....39 Receiving ............26 ............... 10 Sending ............26 Alarms and Events ........25 Transparent SPA ...........
  • Page 68 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...

Table of Contents