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