MatrikonOPC Server for Siemens PLCsUser's Manual MatrikonOPC Server for Siemens PLCs User's Manual This manual is a product of Matrikon Inc. Matrikon Inc. Suite 1800, 10405 Jasper Avenue Edmonton, AB T5J 3N4 Canada Phone: +1.780.448.1010 Fax: +1.780.448.9191 www.matrikonopc.com Document Revision History: Date 2008-05-12 2008-06-23 Document Version 0.1 1.0 Initial version Added Configuration Wizard information, added S7 OPC items description, changed Installation and Un-Installation sections to reflect new installer. Added diagrams of Siemens S7-300 PLC and Hilscher‟s Netlink-MPI adapter. Added S7 200 and S7 400 information. Added offline mode and security information. Installation section updated to include default password. Updated Overview Manual section to include appendices E and F. Replaced Appendix E – Security with updated version. Added Getting Data without Being Connected to a Device to OPC Data Items section. References to hardware licensing removed from Troubleshooting section. Reverted back to previous version of Appendix E to correspond with software version in use. Added new version of Appendix E. Added custom OPC properties information. Corrected Overview of Manual, Compliance, and Installed Files sections. Description Author SN SN, LB 2008-07-10 2008-07-27 2008-08-08 2008-10-02 1.1 1.2 1.3 1.4 LB SN SN LB 2008-10-06 2008-11-19 2008-12-02 1.5 1.6 1.7 LB SN TNM, SN, LB MatrikonOPC Server for Siemens PLCs v1.3.0 User’s Manual 2 2009-01-26 1.8 Added Server Status List object, and new entries in OPC Data Items section relating to support of interpreting internal memory DWORD as REAL. Updated Security appendix. Replaced Configuration window screenshot to show addition of View Tags and Security Settings icons on toolbar. Added View Tags and Security Settings descriptions to Tools Menu Commands table. Added standard Redundancy Group overview information to Creating and Configuring a Redundancy Group Object section. In the OPC Data Items section, added statistical and control items tables for Redundancy Group and Server Status List device links. Updated Security and Offline Mode appendixes. Updated Installation section. Updated SiemensPLC and Common folders in Installed Files section. Removed references to Advanced Options tab in the Options section. Updated Insert New Object Window Options table in the Server Configuration section. Limitations section updated. Updated local TSAP parameter description. Updated screenshots. Updated product version information. Updated to software version 1.2.0 (Beta version). Updated to v1.2.0 Driver. Updated Installed Files section. Updated Troubleshooting section. Updated to new framework and plug-in documentation standard. Removed all references to plug-in. Software version updated to 1.3.0 Updated to standard stand-alone server template. TNM, LB 2009-04-08 2009-04-26 2.0 3.0 LB RN 2010-01-13 2010-01-15 2010-01-22 2010-01-27 2010-04-06 2010-05-06 2010-05-25 2010-06-08 3.1 4.0 4.1 4.2 4.3 4.4 5.0 6.0 LB LB GW, LB ZB, LB LB GEAK GEAK LB MatrikonOPC Server for Siemens PLCs v1.3.0 User’s Manual 3 No part of this document may be reproduced. mechanical.0 DOCUMENT VERSION Version: 6. directly or indirectly.3. to any third party without the explicit written permission of Matrikon Inc. TRADEMARK INFORMATION The following are either trademarks or registered trademarks of their respective organizations: Matrikon and MatrikonOPC are trademarks or registered trademarks of Matrikon Inc. LICENSE AGREEMENT This document and the software described in this document are supplied under a license agreement and may only be used in accordance with the terms of that agreement.SOFTWARE VERSION Version: 1. Matrikon shall not be liable for any losses or damages of any kind caused or alleged to be caused directly or indirectly from this manual. stored in a retrieval system. translated. photocopying. merchantability and fitness for a particular purpose on those arising by law. Matrikon Inc. LIMITATIONS Matrikon has made its best effort to prepare this manual. or otherwise.3. without prior written permission of Matrikon Inc. CONFIDENTIAL The information contained herein is confidential and proprietary to Matrikon Inc. MatrikonOPC Server for Siemens PLCs v1.0 COPYRIGHT INFORMATION © Copyright 1997 . recording. It may not be disclosed or transferred. Matrikon makes no representation or warranties of any kind with regard to the completeness or accuracy of the contents herein and accepts no liability of any kind including without limitation warranties of merchantable quality. OTHER MatrikonOPC™ is a division of Matrikon™ Inc. electronic. course of dealing or otherwise. statute. or transmitted in any form or by any means. All rights reserved. Matrikon reserves the right to make any improvements and/or changes to product specifications at any time without notice. usage of trade. satisfactory quality.2010.0 User’s Manual 4 . .... 21 View Menu ...................................................................................................................... 21 Edit Menu ......................................................................................................................................................................................................................................................................................................................................................................... 70 Inserting Alias Groups .. 25 Interface Logging Options ........................................................................................................................................................ 18 Control Panel ................................................................................................................................................................................................................................................3........................................................................................................................... 11 Who Should Use This Manual ........................................................................ 17 Starting the MatrikonOPC Server for Siemens PLCs ............................ 74 Exporting Aliases ........................................................................................................... 13 References ......................................................................................................... 60 Changing Objects .................. 45 Creating and Configuring a Redundancy Group Object ........................................................................................................ 23 General Logging Options................................................................................ 22 Help Menu ................................... 23 Options Window ......................................................................................................................................................................................... 74 Configure Alias Events ................................................................................ 65 Alias Configuration ...................................................................................... 14 Getting Started.................................................. 70 Editing Aliases .Table of Contents Introduction ......................................................................................... 22 Tools Menu ................................................................................................................................................................................... 12 Overview of Manual ...................................................................................................................... 23 General Options... 78 Examples ......................................................................................... 19 File Menu ............. 65 Importing Symbols From SIMATIC STEP 7 Project ........................................................................................................................................................... 74 Configure Alias Scaling ............................................................................................................................... 16 System Requirements ....................................................................................................................................................................... 17 Tool Tray Menu .................................................................................... 18 Configuration Window .............. 48 Creating and Configuring an S7 ISO on TCP (RFC 1006) Connection ............................................................................................................... 42 Creating and Configuring a Siemens TCP/IP Channel .............................................................................................................................................................................................................. 40 Creating and Configuring a Server Status List Object ............................................................................................................................................................................................... 26 Advanced Options ........................................... 73 Removing Aliases.......................................................................................................................................................................................................................................................................................................................... 77 Expression Wizard ........................................................................................................................................................ 74 Importing Aliases......................................................................................... 70 Renaming Alias Groups.................................................................................................................................................................................................................... 70 Inserting New Aliases .......................................................................................................................................... 29 Configuration Wizard ....................................................................... 14 Document Terminology ........ 16 Hardware Requirements ...... 73 Removing Alias Groups ............. 78 Item Path Browser.......................................................................................................0 User’s Manual 5 ................................................. 16 Software Requirements ............... 52 Creating and Configuring a S7 NetLink Connection ...................... 65 Removing Objects ................................................................... 82 MatrikonOPC Server for Siemens PLCs v1................... 76 Configure Categories ....................................................................... 16 Configuration ................... 29 Creating Objects ........................ 27 Server Configuration ... ............................................................................... 112 Browsing and Item Properties ...................................................................................................................................................................................................................................................................................... 95 Enabling Write to $StopPLC and $RunPLC Control Items .......................................................... 114 Default Properties................ 112 Items .........................................................3...................................................................................................... 111 Installation ........................................................................... 121 Advanced Calculations ........................................................................................................................................................................................................................................................................................................... 120 Appendix B Aliases ......................................................... 85 S7 300/400 Tag Syntax ................................................................................................. 109 OPC Compliance .................................................. 121 Scaling Expressions ............................................................................................................ 128 DDE Write ........................................................................................................................................................................................................................................................... 83 Shutting Down the Server ...................................................................................................... 115 Server Identity................................................................................................................................................................................................................................................................................................................................................................................................................................................................................... 101 Questions and Answers ............................................................................................ 112 I/O Operations ............................... 127 Appendix D Microsoft Excel as a DDE Client .................................... 94 Connections Control Items .............................................. 98 Connections Communication Statistics... 99 Limitations .................................................................................................................................................................................................................................................................................................................................................................................... 98 Logging ... 90 Control Items............ 128 DDE Read .................... 124 Scaling Algorithms ................................................................................................... 85 Connection Items .................................................................................................................................................. 83 Clearing a Configuration ....................................................................... 119 Remote Program ID ................................ 84 OPC Data Items ........................................................................................................................................................................................... 83 Loading an Existing Configuration ................. 94 Siemens TCP/IP Channel Level Control Items ............................................................................................................. 111 Groups .............................. 98 Statistical Items .....0 User’s Manual 6 .... 109 Contacting Support ......................................................................................................................... 111 Common Interfaces .......... 119 Default Protocols ................................................................................................................................................................. 108 Licensing .................. 101 Problems and Solutions ...... 98 Siemens TCP/IP Channel Communication Statistics ........................................... 128 MatrikonOPC Server for Siemens PLCs v1....................................... 114 DCOM Configuration Utility .......................................................................... 97 Diagnostics ...................................................................................................................................................................................................................................................................................................................................... 85 S7 200 Tag Syntax ........ 100 Troubleshooting ................................. 122 CSV File Format ................................................................................ 112 Table of Appendices Appendix A Distributed COM (DCOM)................................................. 111 Data Access .. 126 Appendix C Standard Data Types ..................................... 95 Getting Data without Being Connected to a Device .....................Saving a Configuration ........................................................................................................................................................ 114 Security Permissions .......................................................................................................................................................................... ..................................................................General Logging Options Tab ...................................................................................................... 129 Appendix E Configuring Dynamic Data Exchange (DDE) .Control Panel ....................... 154 Appendix G Offline Mode ................................................................... 8 .............................................................. 14 ...................................................................Create New Siemens TCP/IP Channel Window ....................Hilscher's Netlink-MPI Adapter ..Tool Tray Menu..................................New Manually-Created Siemens TCP/IP Channel ........................................................................Net DDE ...NetLink Connections Screen ................................Configuring TCP Channel ............ 170 Appendix J Un-Installation................................................................................................................................................................. 130 Appendix F Security .....................................................................General Options Tab ........... 33 .................................................. 157 Operational Effects .................Create New S7 ISO on TCP Connection Window (General Tab) ................................... 32 ............................................. 30 .................................................................... 13 ........................ 21 ....................................... 20 ...................................................... 157 Offline Mode Item Values........................Open STEP 7 Project File .............................. 10 ...................................................New S7 300/400 ISO on TCP (RFC1006) Connection ......................Create New Server Status List Window ...............................................................S7 200 ISO on TCP (RFC1006) Connections Screen ................................ 22 .............................New Redundancy Group Object ........................................................... 4 .........................0 User’s Manual ............................................ 159 Appendix I Installed Files .............Tool Tray ....................New Server Status List Object .....MatrikonOPC Server for Siemens PLCs Connections ........................ 28 ........ 27 ....................................................ISO on TCP (RFC1006) Connections Screen ..... 2 ..................... 173 Table of Figures Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure 1 ............................................................................................................................................................. 25 .....3.......................... 29 .................... 19 .............................. 6 .............................New NetLink Connection Window ............................................................................. 23 ................................. 131 Introduction.................................Import Data Block Symbols Result .............................. 9 ...................TCP Channel Configuration Screen . 131 OPC Security Implementation .....Create New Redundancy Group Window .........................Insert New Object Window ................. 132 Security Details .....................Interface Logging Options Tab .........................................................................................Import Data Block Symbols from {Internal Project Name} Window ............................................ 24 .... 5 ................................... 26 ...................... 158 Appendix H Installation .....................New S7 200 ISO on TCP (RFC1006) Connection ........................ 3 ....... 11 ................................................................................................. 18 ..................................................................... 34 ...Create New S7 ISO on TCP Connection Window (Timing Tab) .................................................... 11 12 12 17 18 19 20 24 25 27 28 30 30 31 32 33 34 35 36 37 38 38 39 40 41 43 45 46 48 49 51 53 55 56 7 MatrikonOPC Server for Siemens PLCs v1............Configuration Window.................................................................. 16 ........Configuration Complete Screen ................Create New S7 ISO on TCP Connection Window (S7 Parameters Tab)...................................... 131 MatrikonOPC Tag Security Configuration Utility ............................................................................................ 12 ....................... 17 ......................Siemens S7-300 PLC (with Hilscher's Netlink-MPI Adapter) ........................................................................................................................................................................................................................................... 157 Offline Mode Toggling .............................................................................................................................. 157 Introduction............................................................. 7 ............................ 15 ....................................Advanced Options Tab ........................................ 31 .......Connections List Menu .. ........Select Step 7 Project File Window .......................................................Add User Window (NT).......... 58 Figure 36 ....Edit <Groupname> Window (Permissions Tab) ......................................... 80 Figure 55 ..............................................................................New Category Window .................... 59 Figure 38 ....................Create New S7 NetLink Connection Window (Optimization Tab) ...Create New S7 NetLink Connection Window ....... 63 Figure 41 .......................................... 103 Figure 62 ................................................. 140 Figure 76 ..............................................Add Group Window (Private) ................................................................................................................Add Permission Screen (Server Address Space) ............................. 62 Figure 40 ........................................................0 User’s Manual 8 ......Select STEP 7 MicroWIN Export File Window ............................Add User Permission Window..... 135 Figure 71 .......... 118 Figure 66 ..................Defined Users and Groups ................Registry Value Permissions Window ..............................................................Select Variable Window............. 134 Figure 70 ............................. 78 Figure 54 ..............Edit <Groupname> Window (General Tab) .......... 145 Figure 81 ...............Distributed COM Configuration Properties Window .......... 75 Figure 51 .New S7 NetLink Connection ....MatrikonOPC Tag Security Configuration Utility Main Screen . 76 Figure 52 .................DDE Share ............................................... 139 Figure 75 ..................... 67 Figure 45 ..........Add Users and Groups Window ........Program ID Branch .....................................................................................................................Timing Tab .................................................................................................................................................. 138 Figure 74 .............................. 69 Figure 47 ......................................................................................................Insert New Object Window ................Start Menu Navigation....MatrikonOPC Tag Security Configuration Utility Main Screen: Users & Groups . 102 Figure 61 .... 147 Figure 83 ........... 148 Figure 85 ............................ 133 Figure 68 .................... 150 MatrikonOPC Server for Siemens PLCs v1....Edit <Groupname> Window (Members Tab) ....... 118 Figure 65 ......................................................Operators Buttons ................................Edit <Username> Window (General Tab)...............................Select Function Window ...................... 140 Figure 77 ........................ 68 Figure 46 .................................................Import STEP 7 Project Symbols from [Project Internal Name] Window .....................Distributed COM Configuration Security Tab ....... 133 Figure 69 ...New S7 ISO on TCP Connection ...................................................................................................Add User Window (Private) ...........................Expression Wizard.Client Reference Warning Message ...................Registry Editor ........... 137 Figure 73 ..............Generate Events Options ............... 146 Figure 82 ................................ 129 Figure 67 .....................................Figure 35 ....................................................... 149 Figure 86 ..................Expression Engine Configuration ......................................................................................................................................................................................... 82 Figure 60 ...............User Defined Functions Editor ... 59 Figure 37 ..........................Enter New Name Window ......................................................................Create New S7 ISO on TCP Connection Window (Optimization Tab) . 66 Figure 44 .................................Add Permission Window: Browsing Server Address Space ........................3............................................................. 142 Figure 78 .................. 77 Figure 53 ...................................................................... 116 Figure 63 ...................Enter Server Password Window ..Edit <Username>: Example...... 143 Figure 79 ... 80 Figure 56 ................. 81 Figure 58 ......................Contents Table ........................................................................................................................Add Group Window (NT) ....................STEP 7 MicroWIN Project Window ...................................Reset Password Window .................................................................................Edit <Username> Window (Permissions Tab) ................................... 82 Figure 59 ................ 65 Figure 43 .... 71 Figure 49 ............ 147 Figure 84 ...........................................................Export Data Block Window ...................................... 117 Figure 64 ............................................................................................... 144 Figure 80 ...... 73 Figure 50 ................. 69 Figure 48 ........ 136 Figure 72 ............ 81 Figure 57 ..........................................Create New S7 NetLink Connection Window (General Tab) ...........................................Configure Scaling Window.......................................Edit Categories Window ...........Insert New Alias Window – Alias Type ........ 60 Figure 39 ............................................................. 64 Figure 42 ....................... ........................Create New Server Status List Window Components ...... Table 7 ..................................................................................................................General Options Tab Components ........................................... 89 .............................. Table 12 ........ Table 10 .....Ready to Uninstall Screen ....................... Table 2 ......................... 95 ......................................................................Ready to Install Screen ................Control Panel Commands ....................Uninstalling MatrikonOPC Server for Siemens PLCs Screen ...........................................View Menu Commands ......... Table 4 ..........Change Password Window ....... Table 16 .................................................................... 103 ................................................... 101 ....................................................Edit Menu Commands (Server Configuration) ...................................................New S7 300/400 ISO on TCP (RFC1006) Connection Window Fields ..............................3....................................... Table 22 ........................Create New S7 ISO on TCP Connection Window (Optimization Tab) Components .............................. 92 ...........................................................Edit Menu Commands (Alias Configuration)..........................Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure Figure 87 .....................................New NetLink Connection Window Fields ..........Redundancy Modes ..... 104 ................................. 96 ....... 91 ....................... 94 ...................................................... Table 11 ....Start Menu Screen ............License Agreement Screen .................................. 88 ................Advanced Options Tab Components .......................... Table 26 ........................................................Create New Redundancy Group Window Components ...........................Tool Tray Menu Commands .................................................... Table 8 ......Create New S7 ISO on TCP Connection Window (Timing Tab) Components ....... Table 19 ............................................. Table 9 .........................Create New S7 ISO on TCP Connection Window (General Tab) Components ...............................New S7 200 ISO on TCP (RFC1006) Connection Window Fields ...............InstallAware Wizard Verification Window ........................................................................ 98 ........................................... Table 17 .................................................Configuring TCP Channel Window Fields ........Enter Password Screen ..........Licensing Screen .. Table 3 .................................. Table 18 .......................MatrikonOPC Server Setup Complete Screen ....................................Add Existing User Window ............................Tools Menu Commands ............................................................................. 151 152 159 160 161 162 163 164 165 166 167 168 169 173 174 175 176 177 Table of Tables Table 1 .............................................................................................................Help Menu Commands .................................................. MatrikonOPC Server for Siemens PLCs v1......................................... Table 27 ............................ 93 ........ Table 23 ..................Setup Type Screen ...... Table 5 .................................................................................. Table 25 ........................... Table 13 ............................... Table 24 .....................Insert New Object Window Options .........................Create New S7 ISO on TCP Connection Window (S7 Parameters Tab) Components .......Connections List Menu Commands .............. 100 – Add or Remove Programs ............................................... 90 .............Pre-Requisites Screen .......................... 102 ......Terms and Definitions.................. Table 21 ..............Create New Siemens TCP/IP Channel Window .......................................................... Table 14 .........Welcome to MatrikonOPC Server for Siemens PLCs Maintenance Screen .................................0 User’s Manual 15 18 19 21 21 22 22 22 23 23 25 26 27 29 31 32 34 36 40 41 44 47 49 51 54 56 57 58 9 ..................................Interface Logging Options Tab Components ....Configuration Window Commands ..MatrikonOPC Server for Siemens PLCs Setup Complete Screen ...........................................................................................................................................................File Menu Commands ........................... Table 20 .....................................................................................Destination Folder Screen . Table 28 ................. 97 ............................. Table 15 ......... 99 ...........Installing MatrikonOPC Server Screen ............General Logging Options Tab Components . Table 6 . ......................................................Configure Scaling Window Options ....Standard Data Items ............... 78 Table 38 .................................Linear/Square Root Scaling ............................ 96 Table 50 ......................... 125 Table 63 ...........................................Select S7 Data Block Symbols from [Project Internal Name] Components ..................Standard Data Types ....................................................................................Additional File Import/Export Field Descriptions .......... 95 Table 47 .......................... 89 Table 42 ............................ 109 Table 55 ....................... 63 Table 31 ..................................................... 153 Table 69 ................Files Installed in "Common" Folder .......................Siemens TCP/IP Channel Statistical Items ............................... 85 Table 41 ................................................... 171 Table 74 . 126 Table 65 ..........................Additional File Import/Export Field Descriptions ............. 156 Table 71 ................................................................................................................................................................. 77 Table 37 ......Additional File Import/Export Field Descriptions ..........Example 2: Permissions ...Item ID Field Descriptions ....................................Connections Statistical Items ............................... 126 Table 64 ...............Insert New Alias Window – Alias Properties Options .................Array Elements Length ..................Calculation Functions for Alias Scaling .......................... 99 Table 53 ....................Offline Mode Item Values .......Expression Wizard Options ..........................................................................................................................................................MatrikonOPC Support Regional Contact Information ............................................... 122 Table 57 ..................After-Hours Support ..............Calculation Operators for Alias Scaling ....................................... 99 Table 54 ........... 153 Table 70 ..... 97 Table 52 .................. 73 Table 35 ................ 127 Table 66 ... 83 Table 40 ........... 171 Table 73 ............New Category Window Options .................................................Example 1 ............Create New S7 NetLink Connection Window (Timing Tab) Components .............. 89 Table 43 .........................Connections Control Items ...........................................................Offset Scaling....................... 96 Table 49 .....................Table 29 .................... 93 Table 45 ....................................................................................................................................Server Status List Device Link OPC Items ............... 94 Table 46 . 172 MatrikonOPC Server for Siemens PLCs v1.......................................................3.......................................................0 User’s Manual 10 ....... 125 Table 60 ..........................Expression Scaling ................ 96 Table 51 .............Default Tag Security ..Files Installed in "system32" Folder ............... 110 Table 56 .................. 72 Table 34 ........S7 300/400 Tag Syntax Description ..........................Example 2: Groups and Members............. 125 Table 62 .............................Calculation Scaling ..................S7 300 Date and Time Formats .............Generate Events Window Options ............................................................Redundancy Device Link OPC Items ......................................................... 152 Table 67 ....................................S7 200 Tag Syntax Description ...............................................................Example 2: Permissions .....Create New S7 NetLink Connection Window (Optimization Tab) Components 64 Table 32 ....... 61 Table 30 ......................... 90 Table 44 ...............................Files Installed in "SiemensPLC" Folder .............. 123 Table 58 ...................... 125 Table 61 .......................................................................................... 75 Table 36 ..........Insert New Alias Window – Alias Type Options .................................... 158 Table 72 ...............................Siemens TCP/IP Channel Control Items ............ 67 Table 33 ................................ 153 Table 68 ...............................Server Data Items ...................Additional File Import/Export Field Descriptions ......................................................................Expressions Constructs for Alias Scaling ........Scaling Algorithms.....................File Import/Export Field Descriptions ................................................................ 95 Table 48 ............ 124 Table 59 ..............Custom OPC Properties .............. 79 Table 39 – Item Path Browser Options ......................Create New S7 NetLink Connection Window (General Tab) Components .................................. we will refer to the Hilscher‟s NetLink-MPI adapter by just NetLink adapter. we will refer to S7 300 and S7 400 PLC models by just S7 300/400.3. which communicates with the PLC via the MPI port. Throughout this document. Figure 1 illustrates the possible connections to the S7 PLC with the MatrikonOPC Server for Siemens PLCs.Introduction The MatrikonOPC™ Server for Siemens PLCs provides real-time data access to Siemens S7 PLC via Ethernet. In the rest of this document. This diagram also shows an ISO over Ethernet connection (highlighted by an orange box) MatrikonOPC Server for Siemens PLCs v1. as described in RFC1006.MatrikonOPC Server for Siemens PLCs Connections Figure 2 shows an actual Hilscher‟s NetLink-MPI adapter. respectively CP 243-1. and Figure 3 shows a Siemens S7-300 PLC with the adapter (highlighted by a blue box) connected to it. No communication processor is needed in this case. Figure 1 . Hilscher’s NetLink-MPI adapter (Only for S7 300/400): Connects to the Hilscher‟s NetLink-MPI adapter through TCP/IP. CP 343-1 and CP 443-1 using the S7 protocol on Industrial Ethernet (ISO 8073 CLASS 0) and TCP/IP layers. The following connections are actually supported: ISO on TCP (RFC1006): Connects to the S7 200/300/400 communication processors.0 User’s Manual 11 . technical information about OPC data items is included.Siemens S7-300 PLC (with Hilscher's Netlink-MPI Adapter) Who Should Use This Manual This manual is intended for use by all users of the MatrikonOPC Server for Siemens PLCs. In addition.Hilscher's Netlink-MPI Adapter Figure 3 . along with sections on diagnostics and troubleshooting.Figure 2 .3. and how to perform common tasks. MatrikonOPC Server for Siemens PLCs v1.0 User’s Manual 12 . This manual explains how to install and configure the software. The User’s Manual has been designed as such so that you can click on references in the document to jump to that referenced point without having to scroll through several pages (in some cases). and result codes to get the most efficiency from the user‟s system. Configuration – shows how to start and configure the server. data qualities. MatrikonOPC Support contact information. and answers to frequently asked questions. This manual consists of several sections and is structured as follows: Introduction – this introductory chapter. Failure to do so may result in the software not functioning properly.Overview of Manual This document uses icons to highlight valuable information. This symbol denotes important information that must be acknowledged. pressing the CTRL key and clicking your mouse on the text “Figure 1” automatically takes you to the location of Figure 1 within the document.3. Remember these icons and what they mean. OPC Compliance – details supported interfaces with regard to installation. Troubleshooting – provides licensing. Limitations – provides information on specific performance and operational limitations of the software. Diagnostics – explains how to use logging. and menu commands. Appendices: o o o o o o o o o A . Getting Started – provides system requirements information. For example. any external sources. and describes each component in detail. tabs. or if applicable. and data access. BOLD Font displayed in this color and style indicates a hyperlink to the applicable/associated information within this document. if you were to see the sentence “Refer to Figure 1 for more information”. timestamps.0 User’s Manual 13 . panels. common interfaces. statistical items.DCOM B – Aliases C – Standard Data Types D – Microsoft Excel as a DDE Client E – Configuring Dynamic Data Exchange (DDE) F – Security G – Offline Mode H – Installation I – Installed Files MatrikonOPC Server for Siemens PLCs v1. including windows/screens. solutions for common problems that may be encountered. OPC Data Items – describes the server‟s items. as they will assist you throughout the manual. matrikonopc. Device that allows interaction between the user and 14 MatrikonOPC Server for Siemens PLCs v1. Provides access to process alarm and event data. Jones .com OPC Overview 1. Term/Abbreviation A&E COM CP DA DCOM DDE HDA HMI Description OPC Alarms and Events. Dynamic Data Exchange.opcfoundation.0 OPC Data Access Specification 2.com www. Communication Processor.00 International Standard ISO/IEC 8073 (Fourth edition) RFC1006 – ISO transport services on top of the TCP (version 3) Hilscher‟s NetIdent Protocol Manual Hilscher‟s NetLink-MPI Protocol Manual STEP 7 in 7 Steps – C. Distributed Component Object Model.org www.opcsupport. OPC Data Access. An extension of COM that allows communication between COM components over a network.00 OPC Historical Data Access Specification 1.2 OPC Alarms and Events Specification 1. Component Object Model. specifying how to build components that can be dynamically interchanged. Human Machine Interface. Provides access to real-time process data.o J – Un-Installation References This document references information found within the following documents/sites: www. Allows the transfer of data between two running applications. OPC Historical Data Access.0 User’s Manual . A method for organizing software.T.0 OPC Common Definitions and Interfaces 1.10 OPC Security 1. Provides access to historical process data.05a OPC Data Access Specification 3.3.Brilliant Training Document Terminology The following terms are used interchangeably throughout this document: screen and window tab and panel Table 1 provides a list of definitions for terms used throughout this document. Term/Abbreviation Matrikon MatrikonOPC OP OPC Matrikon Inc. Description machine.opcfoundation.3.Terms and Definitions MatrikonOPC Server for Siemens PLCs v1. A communication standard.org for more information. Matrikon‟s brand name for its OPC servers and clients.0 User’s Manual 15 . Operator Panel. Typically used in process control applications. Refer to www. Table 1 . Appendix I – Installed Files lists the files that are installed during this process.NET 2. Note: To install and configure a MatrikonOPC server. refer to the Contacting Support section for information about how to contact the MatrikonOPC Support team for assistance.Getting Started This chapter contains important information about installing the server and how to contact the MatrikonOPC Support team. Once the software is installed. Detailed step-by-step instructions in Appendix H .3. CP 343-1 or CP 443-1).Installation walks you through the installation process. These requirements must be met for the software to function properly. The Licensing section will refer you to the Licensing Procedures document that was installed along with the server and this User’s Manual. refer to the Licensing section for information on how to obtain the appropriate license. you must be set up as an administrative user account rather than a restricted user account.0 User’s Manual 16 . The System Requirements section shows how to avoid future problems by ensuring that the system meets the minimum software and hardware requirements.0 Framework (included with this install program) TCP/IP protocol enabled Note: It is recommended that the most current service packs are installed. If any problems are encountered during installation or licensing. or Microsoft Windows 2003 SP0 Microsoft . or Hilscher‟s NetLink-MPI adapter MatrikonOPC Server for Siemens PLCs v1. Software Requirements The server requires the following software: Microsoft Windows XP SP2. System Requirements The software has minimum Software and Hardware system requirements. Hardware Requirements The server requires the following hardware: Intel® Pentium® 4 Processor 512 MB RAM 40 GB 7200 RPM Hard Drive The server requires the following additional hardware to make use of the following functionality: PC standard Ethernet adapter S7 communication processor (CP 243-1. and choose MatrikonOPC SiemensPLC Server. MatrikonOPC Server for Siemens PLCs v1. including the windows. and the Options window.Tool Tray If the server is not installed as a Windows service. This section of the manual shows you how to start and configure the server and describes each component in detail. The updated parameters are sent as a group to the server when submitted. The Starting the MatrikonOPC Server for Siemens PLCs section of this manual shows you how to start the software. Figure 4 . choose the appropriate shortcut from the Start menu. the server starts and the Matrikon logo appears in the Tool Tray (Figure 4). panels. and menu commands. Starting the MatrikonOPC Server for Siemens PLCs To launch the MatrikonOPC Server for Siemens PLCs. nor does the logo appear in the Tool Tray. Click on the Windows Start button and select Programs -> MatrikonOPC -> SiemensPLC. If the server is installed as a Windows service. the main Configuration window is immediately displayed.0 User’s Manual 17 . and loading configuration settings. but you can customize the server‟s behaviour as required. The MatrikonOPC Server for Siemens PLCs is able to assign an IP address to the NetLink adapter therefore the Hilscher‟s SyCon configuration software is not required.Configuration The server‟s Graphical User Interface (GUI) allows users to view and alter configuration parameters at run time. Instead.3. users can also start it using the Service Control Manager applet (under the Windows Control Panel). Control Panel. 2. the Welcome screen appears briefly when the server starts up. and shutting down the server. The Server Configuration section describes in detail how to configure the server. located by default in the system tray. Instructions for configuring the MatrikonOPC Server for Siemens PLCs as a DDE service appear in Appendix D Microsoft Excel as a DDE Client. When the server is installed as a service. the server is installed as a Windows service. This server automatically discovers NetLink adapters connected to the same Ethernet network and creates corresponding device links. The next four sub-sections describe the Tool Tray Menu. in detail. the information is retrieved and displayed. Configuration window. If the server is not installed as a Windows service. clearing. To start the MatrikonOPC Server for Siemens PLCs: 1. When you view a configuration parameter. the splash screen does not appear. The Alias Configuration section explains how to create userdefined aliases in place of regular OPC items. By default. Minimal configuration of the MatrikonOPC Server for Siemens PLCs is required for the server to function properly. followed by four sub-sections that cover saving. Displays the server‟s Welcome screen.Tool Tray Menu Commands Control Panel Note: If the server is installed as a Windows service. users can choose to run it as an application by re-registering the OPC server executable using the /REGSERVER command-line switch. The Tool Tray Menu appears (Figure 5). Figure 5 . Access the About screen.Tool Tray Menu Table 2 describes the commands in the Tool Tray Menu. Command Show Control Panel Configure Shutdown About Description Displays the configuration control panel. and number of clients connected to the server. the Tool Tray and Tool Tray Menu are not available. Shuts down the server. system time. the Control Panel is not available. MatrikonOPC Server for Siemens PLCs v1. Right-click your mouse on the Matrikon logo 2. Table 2 .0 User’s Manual 18 . The Control Panel allows users to: Access the Configuration window. The Tool Tray Menu provides access to the Control Panel. the server will automatically start up when a client (such as MatrikonOPC Explorer) first tries to connect to it. It also contains the commands to shut down the server.Notes: If the server is not installed as a service. which includes information about the software. The Control Panel stays on top of every other window on the desktop to help monitor the status of the server. the Configuration window. .3. To view the Tool Tray Menu: 1. The Control Panel displays the server‟s status. and the About screen. Tool Tray Menu Note: If the server is installed as a Windows service. Execute the command to shut down the server. If the server is installed as a service. Displays the main Configuration window. Closing the main configuration window will shut down the configuration utility. From the Tool Tray Menu. Command Status Time Clients Configure Shutdown About Displays the current time. . If the server runs as a local executable. The Control Panel (Figure 6) appears.Control Panel Commands Description Displays the current status of the server. Displays the main Configuration window.Control Panel 5. MatrikonOPC Server for Siemens PLCs v1. Displaying the control panel or main configuration window for the server will “lock” it so that it will not shut down while configuration is being performed. even if no clients are connected. In this case. 3. If the server runs as an NT service. 4. select the Show Control Panel menu option. but will not interfere with the normal operation of the server. double-click your mouse on the title bar. Displays the server‟s Welcome screen. the Configuration window is then accessed via the Windows Start menu. Table 3 describes the commands in the Tool Tray Menu. The Tool Tray Menu appears. To “window shade” the Control Panel so that it displays only the client count.To view the Control Panel: 1. the Tool Tray Menu and Control Panel are not available.3. Right-click your mouse on the Matrikon logo 2. it will remain running so long as there are clients connected to it. Select an object to display its current configuration. The Configuration window displays a tree view of objects configured in the server. Displays the total number of OPC clients presently connected to the server. it will remain running even after the main configuration window is closed. Configuration Window Note: If the server is installed as a Windows service.0 User’s Manual 19 . Table 3 . Figure 6 . which appears on the right-hand side of the window. which includes information about the software. Shuts down the server. Configuration Window Table 4 describes the commands in the Configuration window.3. Select an object to display its current settings in the right-hand panel. Command Main Menu Main Toolbar Current Configuration Server Configuration Description Provides access to the File. Provides shortcut buttons for commands in the Main Menu. Edit. 2.To view the Configuration window: 1. View. select Configure. The Configuration window (Figure 7) appears. Figure 7 . Tools. Displays a tree of configuration objects currently defined in the server.0 User’s Manual 20 . and Help menus. Objects under this node affect how the server communicates with the data source. MatrikonOPC Server for Siemens PLCs v1. From the Tool Tray Menu or the Control Panel. the user is prompted for confirmation before continuing. Displays the total number of OPC clients presently connected to the server. If OPC clients are still connected to the server. Closes the current configuration and shuts down the server after signalling the shutdown event to all connected clients. Saves the current configuration to an XML file. Received. Displays the Save Configuration window to prompt for a new file name if the configuration is new and has not been saved before. and what they are used for. Clears the current configuration and loads a new one from an existing file. Hides the main Configuration window. Table 4 . Opens a link to the Matrikon web site. Displays the Import Aliases window to prompt for an existing file name.Configuration Window Commands The following sections describe the menus available from the Configuration window. Clears all aliases and imports new ones from a CSV file. Displays the Export Aliases window to prompt for a file name.0 User’s Manual 21 . Table 5 . The server shuts down after a short delay if no OPC clients are currently connected to the server. Exports all currently configured aliases to a CSV file. If OPC clients are still connected to the server. Displays the Open Configuration window to prompt for the file name. Resets statistics on the object presently selected in the configuration tree. Command New Description Clears the current configuration and starts a new one. Retried. Saves the current configuration to an XML file.File Menu Commands Open Save Save As Export Aliases Import Aliases Shutdown Server Close Edit Menu Table 6 describes the Edit menu commands that appear when the currently selected object appears under the Server Configuration node. Displays available statistics for the object presently selected in the tree: Sent. the user is prompted for confirmation before continuing. the user is prompted for confirmation before continuing. Overrun. Displays the current settings of the object presently selected in the tree. Displays the Save Configuration window to prompt for a new file name. Failed. File Menu Table 5 describes the File menu commands.Command Alias Configuration Object Settings Panel Statistics Panel Reset Statistics Matrikon Logo Clients Server Time Description Define aliases and alias groups under this node.3. Displays the current time. Timed Out. MatrikonOPC Server for Siemens PLCs v1. If OPC clients are still connected to the server. Description Delete Removes the currently selected object from the server configuration.View Menu Commands Tools Menu Table 9 describes the Tools menu commands. Command Statistics Reset Statistics Defaults Refresh Options Description Displays/hides general communication statistics for the currently selected object. Displays the Options window used to change general server options. Prompts the user for confirmation before continuing to see if the OPC clients have reference to items associated with the selected object or one of its children. Displays the Insert New Object window used to create a new configuration object under the currently selected configuration object. Rebuilds the tree display of the server configuration and fully expands all branches.0 User’s Manual 22 . Displays the Insert New Alias window used to create a new alias under the currently selected alias group. Displays the Server Defaults window used to configure the default settings for the various types of communication objects available in the server. Resets all statistics for the currently selected object to zero. Table 7 . Creates a new alias group under the currently selected alias group. Command Undo/Can’t Undo Rename Delete Alias Group Delete Alias Insert Alias Group Insert New Alias Not implemented. Removes the currently selected alias group and all subordinate groups and aliases.Edit Menu Commands (Alias Configuration) Description View Menu Table 8 describes the View menu commands.Edit Menu Commands (Server Configuration) Define New Table 7 describes the Edit menu commands that appear when the currently selected object appears under the Alias Configuration node. Does not remove such objects but simply disables them and sets them to “marked for deletion”.3. Renames the currently selected alias group. Table 6 . MatrikonOPC Server for Siemens PLCs v1. Removes the currently selected aliases. Table 8 .Command Undo/Can’t Undo Not implemented. Table 9 . Interface Logging. General Logging. from the View menu. This utility can be used to edit DCOM settings for specific COM servers to allow client applications on remote computers to connect to the server. which includes information about the software version.. Launches MatrikonOPC Explorer.3. and Advanced. The Options window appears. Command MatrikonOPC on the Web About Description Opens a link to the MatrikonOPC web site. For more information. The default password set during the installation of this server is MatrikonOPC. General Options The General tab allows users to edit general server options (i. refer to the MatrikonOPC Explorer User’s Manual. Displays the Welcome screen.0 User’s Manual 23 . MatrikonOPC Server for Siemens PLCs v1. 3. refer to Appendix F – Security. The MatrikonOPC Tag Security Configuration Utility screen is then displayed which allows you to configure security settings. select the Options menu item. 2. settings).e. select the General tab (Figure 8). On the Configuration window. which is a general-purpose OPC client included with all MatrikonOPC servers that may be used to test the capabilities of the software.Tools Menu Commands DCOM Configurator View Tags Security Settings Help Menu Table 10 describes the Help menu commands.Help Menu Commands Options Window The Options window is used to edit the server‟s options and contains four tabs: General. Launches the Enter server password window where you are asked to enter the security password set during the installation of the server. For more information.Command Description Launches the Microsoft Distributed COM Configuration Properties utility. Table 10 . To view the General options: 1. From the Options window. Automatically loads a configuration from the specified file when starting up. if selected. if selected. X) of backup copies of the configuration file when saving the configuration.e. Displays the full path of an existing file for load and save operations. Prevents OPC clients from adding items other than configured aliases. Selecting this option will cause clients to see only aliases when 24 MatrikonOPC Server for Siemens PLCs v1. Field Save current configuration on shutdown Backup: X copies Load configuration on setup Filename Launch configuration program on startup Restrict items to preconfigured aliases Description Automatically saves the current configuration to the specified file before shutting down. if selected. if selected. ) to display the Open window used to select an Automatically launches the configuration utility when starting up as a local executable (rather than a Windows service)..General Options Tab Table 11 describes the fields available on the General tab.0 User’s Manual .3. Click on the ellipsis button ( existing file name. Automatically keeps up to the specified number (i.Figure 8 . Field only Description browsing this server. Note: As is the case with any changes to General options, if this option is changed you will need to restart the server for the change to take effect. Table 11 - General Options Tab Components Note: The server loads these settings from the Windows registry upon start-up. Changes to the General options settings take effect when the server is restarted. General Logging Options The General Logging tab allows users to edit general logging options. To view the General Logging options: 1. On the Configuration window, from the View menu, select the Options menu item. 2. The Options window appears. 3. From the Options window, select the General Logging tab (Figure 9). Figure 9 - General Logging Options Tab Table 12 describes the fields available on the General Logging tab. MatrikonOPC Server for Siemens PLCs v1.3.0 User’s Manual 25 Field Description Enables/disables general activity logging at the specified detail level (High, Medium, Low, or None), if selected. Note: This option should not be selected unless users are debugging a problem as this will have a negative effect on performance of the OPC server. Always set this back to None when not in use. Purges the file buffer after each message is logged in the event of an unexpected server shut down. Overwrites the old log file each time the server starts up, if selected. Otherwise, rename the old log file with a (*.bak) suffix. Displays the full path for the general activity log file. Click on the ellipsis button ( ) to display the Open window used to select an existing file name. Enable activity logging Commit all log file writes Overwrite old log information General Activity Logging Filename The default path is C:\Program Files\Common Files\MatrikonOPC\Common\PSTCFGMatrikon.OPC.Siemens PLCs. 1.LOG. Match string for filtered log is displayed. Displays the full path for the filtered log file. Click on the ellipsis button ( display the Open window used to select an existing file name. Table 12 - General Logging Options Tab Components Filter String Filtering Filename ) to Note: General Logging options settings take effect immediately. Interface Logging Options The Interface Logging tab allows users to view and edit COM interface logging options. To view the Interface Logging options: 1. On the Configuration window, from the View menu, select the Options menu item. 2. The Options window appears. 3. From the Options window, select the Interface Logging tab (Figure 10). MatrikonOPC Server for Siemens PLCs v1.3.0 User’s Manual 26 Figure 10 - Interface Logging Options Tab Table 13 describes the fields available on the Interface Logging tab. Field Description Enables/disables interface logging at the specified detail level (High, Medium, Low, or None), if selected. Generates a separate log file for each client named PST###.TMP in the server installation directory. Note: This option should not be selected unless users are debugging a problem as this will have a negative effect on performance of the OPC server. Purges the file buffer after each message is logged in the event of an unexpected server shut down. Table 13 - Interface Logging Options Tab Components Enable logging Commit all log file writes Note: Interface Logging options settings take effect when the next OPC client connects to the server. Advanced Options The Advanced tab allows users to view and edit advanced server options. MatrikonOPC Server for Siemens PLCs v1.3.0 User’s Manual 27 Figure 11 . 2. This is the rate (in milliseconds) at which the Alias features subscribe 28 Time granularity Alias Subscription Rate MatrikonOPC Server for Siemens PLCs v1. The default value is 100 ms.To view the Advanced options: 1. OPC server group scan thread interval (milliseconds). Prevents OPC clients from requesting update rates that are impossible to achieve or that cause heavy CPU loads. On the Configuration window.Advanced Options Tab Table 14 describes the fields available on the Advanced options tab. select the Options menu item. Determines the maximum resolution for data change detection.3. 3. from the View menu. select the Advanced tab (Figure 11).0 User’s Manual . The Options window appears. Field OPC Group Update Rate (minimum) Description Minimum update rate (milliseconds) allowed for an OPC group. From the Options window. Time granularity should always be equal to or less than the minimum group update rate. Default = 1000. This section shows you how to create and edit objects. The DDE service name that should be used by clients to connect to this program. click on the Next button to proceed through the Wizard. This rate is used by the Alias Events features and by the Expression and Calculation engines when other tags are referenced in the expressions. The character to be used to indicate the start of a new item in the DDE data request. The Configuration Wizard can also be launched by clicking on the Windows Start button and selecting Programs -> MatrikonOPC -> SiemensPLC -> Siemens PLCs Configuration Wizard. Table 14 .3. MatrikonOPC Server for Siemens PLCs v1.0 User’s Manual 29 .Field Description to underlying data items. launched once the installation process is complete. by default. Unless the channel needs to be renamed or offline mode needs to be enabled. Figure 12 shows the TCP channel configuration screen. Configuration Wizard The Configuration Wizard is. You can customize the server‟s behaviour as required. using the Configuration window or the Configuration Wizard. Server Configuration The server requires minimal configuration for it to run properly.Advanced Options Tab Components Note: The server loads these settings from the Windows registry on start-up. It allows a step-by-step initial configuration of the MatrikonOPC Server for Siemens PLCs. Enable DDE Communication DDE Service Name DDE Item Delimiter Selecting this checkbox this will allow the server to accept Dynamic Data Exchange (DDE) connections. Changes to Advanced options settings take effect when the server is shut down and restarted. TCP Channel Configuration Screen Configuring the TCP Channel Using the Wizard Figure 13 shows the Configuring TCP Channel window which appears upon selecting the TCP channel and clicking the Configure button.Figure 12 . 30 Description MatrikonOPC Server for Siemens PLCs v1. Figure 13 .Configuring TCP Channel Table 15 describes the fields available in the Configuring TCP Channel window. Field Name TCP Channel name.3.0 User’s Manual . This allows configuring connections to S7 200 CP 243-1 modules.0 User’s Manual 31 .Configuring TCP Channel Window Fields Figure 14 shows the S7 200 ISO on TCP (RFC1006) Connections screen. click on the New button. Enable Offline Mode. select it and press the Delete key. Figure 14 .3. Table 15 . To modify an existing connection. To add a new connection. select it and click on the Configure button. Refer to Appendix F – Offline Mode in the MatrikonOPC Server User’s Manual for more information.S7 200 ISO on TCP (RFC1006) Connections Screen Creating a New S7 200 ISO on TCP Connection Using the Wizard Figure 15 shows the New S7 200 ISO on TCP (RFC1006) Connection window which appears upon clicking the New button. click on the Next button to continue the configuration. Once all the S7 200 ISO on TCP (RFC1006) Connections have been added. Description Check this option to enable offline mode for this TCP channel and all devices underneath. To delete an existing connection. MatrikonOPC Server for Siemens PLCs v1.Field Do not have access to PLC. click on the New button. Note: Importing data block symbols will override existing ones. This allows configuring connections to S7 300/400 CP 343-1 and CP 443-1 modules. select it and click on the MatrikonOPC Server for Siemens PLCs v1. Select to use a connection configured in STEP 7 MicroWIN.New S7 200 ISO on TCP (RFC1006) Connection Table 16 describes the fields available in the New S7 200 ISO on TCP (RFC1006) Connection window. Click on the Clear button to delete currently imported data block symbols. Field Name IP Address PG Connection Configured Connection Local TSAP Remote TSAP Description ISO on TCP (RFC1006) Connection name. The remote (client) TSAP configured in STEP 7 MicroWIN‟s Ethernet Wizard.Figure 15 . Click on the Import button to import data block symbols from a STEP 7 MicroWIN Export file.0 User’s Manual 32 . Select to use the PG (default) connection. The IP address assigned to the S7 communication processor (CP). The local (server) TSAP configured in STEP 7 MicroWIN‟s Ethernet Wizard.3. Import data block variables from STEP 7 MicroWIN Export File Table 16 .New S7 200 ISO on TCP (RFC1006) Connection Window Fields Figure 16 shows the S7 300/400 ISO on TCP (RFC1006) Connections screen. To add a new connection. To modify an existing connection. Up to eight connections can be configured with the STEP 7 MicroWIN‟s Ethernet Wizard. Only 1 PG connection is available. Figure 16 . To delete an existing connection.ISO on TCP (RFC1006) Connections Screen Creating a New S7 300/400 ISO on TCP Connection Using the Wizard Figure 17 shows the New S7 300/400 ISO on TCP (RFC1006) Connection window which appears upon clicking the New button. MatrikonOPC Server for Siemens PLCs v1.Configure button.0 User’s Manual 33 . Once all of the S7 300/400 ISO on TCP (RFC1006) Connections have been added.3. select it and press the Delete key. click on the Next button to continue the configuration. The connections list should already show the NetLink adapters MatrikonOPC Server for Siemens PLCs v1. The rack number of the CPU which the OPC server is reading data from. if S7 300 is selected.. This allows configuring connections to Hilscher’s NetLink-MPI adapters. Click on the Import button to import data block symbols from a STEP 7 project. Note: Importing data block symbols will override existing ones.Figure 17 . Select the PLC type to use multiple connections.0 User’s Manual 34 .New S7 300/400 ISO on TCP (RFC1006) Connection Table 17 describes the fields available in the New S7 300/400 ISO on TCP (RFC1006) Connection window. Click on the Clear button to delete currently imported data block symbols. the OPC server is connecting to (e. The S7 model which also defines the communication processor (CP). the CP model is CP 343). The IP address assigned to the S7 communication processor (CP). Field Name IP Address S7 Model Description ISO on TCP (RFC1006) Connection name. The number of simultaneous connections the S7 CP can handle is determined by the type of link selected. Refer to Importing Data Blocks from a STEP 7 Project Using the Wizard for more details.g. The slot number of the CPU which the OPC server is reading data from.New S7 300/400 ISO on TCP (RFC1006) Connection Window Fields Figure 18 shows the NetLink Connections screen.3. Link Type Rack Slot Import data block symbols from STEP 7 Project Table 17 . Figure 18 . click on the Next button to continue the configuration. To delete an existing connection. select it and press the Delete key. select it and click on the Configure button.NetLink Connections Screen Creating a New NetLink Connection Using the Wizard Figure 19 shows the New NetLink Connection window which appears upon clicking the New button. MatrikonOPC Server for Siemens PLCs v1. To add a new connection. To modify an existing connection.3.which were discovered on the local network when the TCP channel was created. click on the New button.0 User’s Manual 35 . Once all the NetLink Connections are added. Click on the Finish button to close the Configuration Wizard.0 User’s Manual 36 . Note: Importing data block symbols will override the existing ones. MatrikonOPC Server for Siemens PLCs v1. The IP address assigned to the NetLink-MPI adapter.New NetLink Connection Window Table 18 describes the fields available on the New ISO on TCP (RFC1006) Connection tab. Table 18 . Click on the Clear button to delete currently imported data block symbols.New NetLink Connection Window Fields Import data block symbols from STEP 7 Project Figure 20 shows the Configuration Complete screen.Figure 19 . Refer to Importing Data Blocks from a STEP 7 Project Using the Wizard for more details. Click on the Import button to import data block symbols from a STEP 7 project.3. Field Name IP Address Description ISO on TCP (RFC1006) Connection name. select the file and click on the Open button. MatrikonOPC Server for Siemens PLCs v1.0 User’s Manual 37 . Browse to the STEP 7 project file from which the data block symbols will be imported.Configuration Complete Screen Importing Data Block Symbols From a STEP 7 Project Using the Wizard Clicking on the Import button on either the New S7 300/400 ISO on TCP (RFC1006) Connection or New NetLink Connection window displays the Open STEP 7 Project File window shown in Figure 21.3.Figure 20 . the Import S7 Data Block Symbols from {Internal Project Name} window is displayed.Open STEP 7 Project File Once a STEP 7 project file is selected.0 User’s Manual 38 .Import Data Block Symbols from {Internal Project Name} Window Once the data block symbols are imported for the current connection. select it and click on the Import button. Figure 22 . browse to the S7 program from which the data block symbols will be imported. In the PLC Programs list.3. the New ISO on TCP (RFC1006) Connection or the New NetLink Connection window will show the result as shown MatrikonOPC Server for Siemens PLCs v1.Figure 21 . or Double-click the connection in the list. modify.in Figure 23.Import Data Block Symbols Result Modifying an Existing Connection Using the Wizard To modify an existing connection: 1.0 User’s Manual 39 . delete. MatrikonOPC Server for Siemens PLCs v1.3. Select the connection in the list and click on the Configure button. or Right-click the connection in the list and then select Delete from the displayed menu. Figure 23 . The menu can be used to add a new connection. Select the connection in the list and click on the Delete button. Once the connection is added. or Select the connection in the list and press the Delete key. or refresh the connections list. the data block symbols can be accessed as OPC items from any compliant OPC client through the OPC server browsing address space. Deleting an Existing Connection Using the Wizard To delete an existing connection: 1. or Right-click the connection in the list and then select Configure from the displayed menu. duplicate an existing one. Using the Connections List Menu The menu shown in Figure 24 is displayed by right-clicking on a connection. Figure 24 - Connections List Menu Table 19 describes the commands available in the Connections List Menu. Field New Configure Duplicate Refresh Delete Disable/Enable Description Creates a new connection. Modify the selected connection. Makes a copy of the selected connection. Refreshes the connections list. Deletes the selected connection. Disables or enables the selected connection. Table 19 - Connections List Menu Commands Creating Objects The Insert New Object and Create New windows are used to create Siemens PLCs device link objects. MatrikonOPC Server for Siemens PLCs v1.3.0 User’s Manual 40 Insert New Object Window The Insert New Object window (Figure 25) displays a different set of options depending on the type of object selected and the types of objects already configured under it. Figure 25 - Insert New Object Window Table 20 describes the types of objects that are available for insertion as a child in the Insert New Object window, depending on which object is currently selected. Selected Object Root Device Link (Server Configuration) Server Status List Siemens TCP/IP Channel Redundancy Group S7 ISO on TCP (RFC 1006) Connection S7 NetLink Connection To insert a new object: 1. On the Configuration window, select the Server Configuration node and either: Right-click your mouse and select Define New from the menu that appears, or Select the Define New menu option from the Edit menu, or Click on the icon. Insert New Object Window Options Server Status List Siemens TCP/IP Channel <None> Redundancy Group S7 ISO on TCP (RFC 1006) Connection S7 NetLink Connection <None> <None> <None> Table 20 - Insert New Object Window Options 2. The Insert New Object window (Figure 25) appears. 3. From the displayed list, select the type of object to be created. Note: Different objects may be available depending on which object is currently selected in the tree view. 4. Click on the OK button. 5. The Create New window appears. MatrikonOPC Server for Siemens PLCs v1.3.0 User’s Manual 41 To create a newly inserted object: 1. From the Create New window, enter a name for the object. This name is part of the item ID that globally identifies data items from under the object. You may also choose to enter a description of the object. 2. Edit the configuration components as desired. 3. Click on the OK button. The object is created. Note: For the object to be used for communication, it must be enabled. This can be done at any time. Create New Window The Create New window (Figure 26) displays the settings available for a new object. The following sub-sections contain information on the types of objects available and how to configure them. A device-specific window is displayed for each device link: Server Status List Siemens TCP/IP Channel Redundancy Group S7 ISO on TCP Connection S7 NetLink Connection Creating and Configuring a Server Status List Object Some OPC clients use the OPC call, GetServerStatus(), to monitor the state of an OPC server. MatrikonOPC‟s Server Status List object makes it possible to monitor an OPC server status in a customizable way. The Server Status List object contains a list of subscribed device links that can exist anywhere in the OPC server hierarchy. The status of the server is checked every configured status check period by examining the status of the subscribed device links. Device links can be added to the Server Status List in one of two ways: 1. Direct – the device link is added directly to the subscription list. 2. Parent – the device link‟s sub-ordinates are added to the subscription list. There are two options for the logic that will determine the server status. For the Server Status to be Running, the first option requires that there is at least one subscribed device link that is running. In this case, if all subscribed device links enter a failure condition (e.g., become disconnected), the Server Status will be Failed. The second option is stricter as it is required that all subscribed device links be running. In this case, if any subscribed device links enter a failure condition, the Server Status will be Failed. Multiple Server Status Lists can exist and there can be one or more device links contained within a Server Status List. There is no restriction on having a particular device link contained within more than one Server Status List. The Create New Server Status List window (Figure 26) displays the settings available for configuring a Server Status List object. MatrikonOPC Server for Siemens PLCs v1.3.0 User’s Manual 42 Selecting the first option.e. Allows you to enter a value to define how often (in milliseconds) to check connected device links to make sure they are still actively communicating with a device.. the checkbox is selected. This field is optional and takes any user-defined text (64-character maximum) for documentation purposes. Automatically converted to title case for display purposes. ‘Running’ if at least one link is 43 Enabled Description Status Check Period MatrikonOPC Server for Siemens PLCs v1. Default = 5000 ms. Component Name Description Allows you to enter the name of the device link. checkbox is cleared) communication for the object. checkbox is selected) or disable (i.3.Create New Server Status List Window Table 21 describes the components of the Create New Server Status List window. By default.0 User’s Manual . By default.Figure 26 .. this field is blank.e. Status Check Type Allows you to select the type of logic used to determine Server Status. Use this checkbox to enable (i. which becomes an element of the item ID for data items. it may be added to the Direct Device Link list.0 User’s Manual .Component Description connected. Allows you to enter the name of the device link that is going to be added to the list of Direct Device Links. Add. After entering a device link name into either the Direct Device Link Name field. Direct Device Link Name Parent Device Link Name Note: Only immediate subordinates are monitored. or Child may be added to the Parent Device Link list. Table 21 . or Click on the icon. For Grandchild to be monitored. Select this button to save any changes and close the window. If a parent device link named Parent has a subordinate Child that is the parent of another device link. you can make changes to it or delete it (see Delete for more information). Select the device link you want to remove from a particular list (either a Direct Device Link Name. select the Server Configuration node and either: Right-click your mouse and select Define New from the menu that appears. or Select the Define New menu option from the Edit menu. highlight the one you want to change. Add Note: Once you have added a device link. results in a Server Status of Running (rather than Failed) if there are one or more device links with a status of Running. Notice that the Add button now reads Update. The full path of the parent device link must be entered. ‘Running’ if all links are connected. The Subscriptions section contains the following fields and buttons which are described below: Direct Device Link Name. On the Configuration window. or the Parent Device Link Name field. To update a device link. or a Parent Device Link Name) and click on the Delete button. 44 MatrikonOPC Server for Siemens PLCs v1. The subordinates of these device links will have their state monitored directly. Select this button to close the window without saving any changes made. Selecting the second option. These device links have their state monitored directly. Parent Device Link Name. only the Child device link is monitored. use the Add button for that particular list to add the device link to the list.3. Grandchild. The full path of the device link must be entered.Create New Server Status List Window Components Delete OK Cancel To create a Server Status List object: 1. Allows you to enter the name of the device link that is going to be added to the list of Parent Device Links. results in a Server Status of Failed if there are one or more device links with a status of Failed. Delete. from the list. Subscriptions This section of the General tab displays those device links defined as part of the server status list. Make the necessary changes and click on the Update button. By highlighting the Server Configuration item and selecting the Define New option.2.New Server Status List Object Creating and Configuring a Siemens TCP/IP Channel A Siemens TCP/IP Channel object (i. 5. The Create New window appears (Figure 26). The object is created and appears as a child of the Server Configuration item as shown in Figure 27. 6. Edit the configuration components as desired. Note: An error message is displayed when a valid name is not entered. Figure 27 .0 User’s Manual 45 . For example. Refer to the procedure entitled To manually create a Siemens TCP/IP Channel. Click on the OK button.. 8. the new device link is not created. This can be done at any time. From the Create New window. Click on the OK button. The Description field is optional. A Siemens TCP/IP Channel object can be created manually. it must be enabled (i. A Siemens TCP/IP Channel object auto-discovers NetLink adapters available on the Ethernet network and creates corresponding device link for each one. MatrikonOPC Server for Siemens PLCs v1. Note: The item selected in the Insert New Object window determines which Create New window is displayed. 3. for more information. the Enabled checkbox is selected). 7. From the displayed list. enter a name for the object.e. select Server Status List. device link) allows device links configured underneath it to communicate on the Ethernet network using the TCP/IP protocol. If the entered name is a duplicate of an existing device link. when Server Status List is selected. you can create and configure a Siemens TCP/IP Channel. The Insert New Object window (Figure 25) appears. 4. then the Create New Server Status List window is displayed.3.. Note: For the object to be used for communication.e. this field is blank. Figure 28 . user-defined text (64-character maximum) for documentation purposes.Connection Upon connection. NetLink adapters available on the network are auto-discovered. Component Name Description Name of the object. 46 Enabled Inter Connect Delay MatrikonOPC Server for Siemens PLCs v1. By default. which becomes an element of the item ID for data items under the object.Create New Siemens TCP/IP Channel Window Table 22 describes the components of the Create New Siemens TCP/IP Channel window. Description Optional.3. Enable (select the checkbox) or disable (clear the checkbox) communication for the object. The Create New window (Figure 28) displays the settings available for a Siemens TCP/IP Channel. By default.0 User’s Manual . Allows you to enter a value that defines the amount of time (in milliseconds) between two connection attempts. Automatically converted to title case for display purposes. this checkbox is selected. On the Configuration window. when Siemens TCP/IP Channel is selected. Edit the configuration components as desired. 5. When this option is selected (i.e. or Select the Define New menu option from the Edit menu. enter a name for the device link. ) appears. then the Create New Siemens TCP/IP Channel window is displayed. Note: The item selected in the Insert New Object window will determine which Create New window is displayed.3..0 User’s Manual 47 icon.. Offline mode allows the MatrikonOPC Server for Siemens PLCs to be disconnected from the end device but still return data. The Insert New Object window (Figure 25 . Click on the OK button. or Click on the 3. Select this button to save any changes and close the window. the Enabled checkbox is selected). This can be done at any time. For example. Note: An error message is displayed when a valid name is not entered. select the Siemens TCP/IP Channel object type. 4. 6.Insert New Object Window . Note: For the object to be used for communication.e. From the displayed list. select the Server Configuration node and either: Right-click your mouse and select Define New from the menu that appears. From the Create New window.e. it must be enabled (i.Create New Siemens TCP/IP Channel Window Timeout Discover NetLink adapters Do not have access to PLC. 2. 9. Select this button to close the window without saving any changes made. 7. Refer to Appendix F – Offline Mode in the MatrikonOPC Server User’s Manual for more information about offline mode. Table 22 . OK Cancel To manually create a Siemens TCP/IP Channel: 1. MatrikonOPC Server for Siemens PLCs v1. Description Allows you to enter a value that defines the amount of time (in milliseconds) that the server will wait for NetLink adapters to reply to an auto-discovery request. Click on the OK button. check) this option to enable Offline Mode. checked) and the user presses the Apply button. Default = 3000. 8.Component Default = 1000.. the OPC server auto-discovers NetLink adapters connected to the same Ethernet network. The Create New window appears (Figure 28). The object is created and will appear as a child of the Server Configuration item as shown in Figure 29. Default = Checked Allows you to select (i. the new device link will not be created. Enable Offline Mode. If the entered name is a duplicate of an existing device link. The Description field is optional. and there can be one or more device links contained within a Redundancy Group. these actions are forwarded through to the active device link. standby or disabled states. redundant device links should have identical hierarchy layout and naming conventions below their level. The group tries to make one of the device links within itself. the Redundancy Group makes that particular device link active.. the device link that the Redundancy Group is reading/writing data from/to). the non-active device links are placed in communicating.New Manually-Created Siemens TCP/IP Channel Creating and Configuring a Redundancy Group Object The Redundancy Group contains a list of device links that can exist anywhere in the OPC server hierarchy. Multiple Redundancy Groups can exist. The success of a redundancy item addition depends on whether the Redundancy Group can add the mapped item to the active device link.e.g. if a device link that has a higher priority than the active device links becomes connected.. Each device link within a Redundancy Group will have an assigned priority. the Redundancy Group assigns a new active device link by iterating through its list until it can find a device link that is connected. Items within the Redundancy Group are added with the same item ID as those in its redundant device links with the name of the redundant device link being replaced with the name of the Redundancy Group..g. becomes disconnected). OPC reads and writes performed on the redundancy item are forwarded to the mapped item in the active device link.0 User’s Manual 48 . MatrikonOPC Server for Siemens PLCs v1.3. reading/writing) are performed on the Redundancy Group. A particular device link may only be a member of one redundancy group at a time. When deciding which device link to make active. the active device link (i. from highest to lowest. Therefore. adding items. When not in Cold redundancy mode. The Create New Redundancy Group window (Figure 30) displays the settings available for configuring a Redundancy Group object. the Redundancy Group goes through the list of its device links in order of priority. As operations (e. Depending on the selected redundancy mode (see Table 23). If the active device link enters a failure condition (e.Figure 29 . The Redundancy Group assigns one of the device links in the list as the active device link. Only the active device link is connected.Mode Classic Description All device links are connected. As failovers occur and cause multiple device links to become active.Redundancy Modes Hot Warm Cold Figure 30 . All device links are connected. When a failover occurs the items will be removed from the formerly active device link. but are not removed when a fail over occurs. Table 23 .0 User’s Manual 49 . When a failover occurs the items will be removed from the formerly active device link. Items are added only to the active device link. then all communication through that device link is disabled. All device links are connected. This means that all device links are actively collecting all the time.Create New Redundancy Group Window MatrikonOPC Server for Siemens PLCs v1. When items are added they are added to the active device link. the collection state becomes the same as Hot. When items are added they are added to the active device link.3. When items are added they are added to all device links in the redundancy group. Note: When a device link is a member of a Cold mode redundancy group and not the active device link. and the priorities of the device links. Automatically converted to title case for display purposes. Hot.e. Notice that the Add button now reads Update. Make the necessary changes and click on the Update button. Name Enabled Status Check Period Connection Period Subscriptions Device Link Name Priority Add Delete OK MatrikonOPC Server for Siemens PLCs v1. Delete. Use this checkbox to enable (i. Add. the checkbox is selected. To update a device link. select the device link you want to remove and click on the Delete button to delete it from the list. from the list. you can make changes to it or delete it (see Delete for more information). From the list of redundant device links that appears at the bottom of the General tab.Table 24 describes the components of the Create New Redundancy Group window. Default = 1000 ms.. from the drop-down list.. Allows you to enter a value to define how often (in milliseconds) to check connections that have failed (i. Allows you to enter a value to define how often (in milliseconds) to check connected device links to make sure they are still actively communicating with a device. By default. Default = 5000 ms. The full path of the device link must be entered.. Note: Once you have added a device link. Allows you to enter the name of the device link that is going to be added. Cold) of redundancy management that should be used by this group. checkbox is cleared) communication for the object.e. use the Add button to add the device link to the list of redundant device links that appears at the bottom of the General tab. After entering a Device Link Name and selecting a Priority. By default. checkbox is selected) or disable (i.0 User’s Manual 50 . this field is blank. Select this button to save any changes and close the window. Mode Allows you to select.e. The Subscriptions section contains the following fields and buttons which are described below: Device Link Name. Priority. This section of the General tab displays those device links defined as part of this particular redundant set.3. Allows you to select a priority (High. Component Description Allows you to enter the name of the device link. or Low) for the current device link from the drop-down list. Description This field is optional and takes any user-defined text (64-character maximum) for documentation purposes. the style (Classic. communication is down) to determine if connections have been restored. highlight the one you want to change. which becomes an element of the item ID for data items. Medium. Device links of higher priority are preferred to lower priority device links. Warm. New Redundancy Group Object MatrikonOPC Server for Siemens PLCs v1. The Insert New Object window (Figure 25) appears. 5. then the Create New Redundancy Group window is displayed. or Click on the icon. 7. On the Configuration window. Figure 31 . Click on the OK button. 2. select Redundancy Group.e. Table 24 . 3.Create New Redundancy Group Window Components To create a Redundancy Group object: 1. The Description field is optional. Edit the configuration components as desired. it must be enabled (i. 4. If the entered name is a duplicate of an existing device link. Click on the OK button. when Redundancy Group is selected. Note: The item selected in the Insert New Object window determines which Create New window is displayed. the Enabled checkbox is selected). 8. 6. select the Server Configuration node and either: Right-click your mouse and select Define New from the menu that appears.Component Cancel Description Select this button to close the window without saving any changes made. Note: An error message is displayed when a valid name is not entered. For example. This can be done at any time. or Select the Define New menu option from the Edit menu.3. enter a name for the object. From the displayed list.. the new device link is not created. Note: For the object to be used for communication. The Create New window appears (Figure 30).0 User’s Manual 51 . From the Create New window. The object is created and appears as a child of the Server Configuration item as shown in Figure 31. For more information.0 User’s Manual 52 .Creating and Configuring an S7 ISO on TCP (RFC 1006) Connection The S7 ISO on TCP Connection handles the configuration of S7 ISO on TCP protocol parameters as well as the flow of data between the server and the S7 communication processor (CP). refer to the step-by-step procedure entitled To manually create a S7 ISO on TCP Connection. The Create New window (Figure 32) displays the settings available for a S7 ISO on TCP Connection. The Create New S7 ISO on TCP Connection window consists of four tabs: General Timing S7 Parameters Optimization MatrikonOPC Server for Siemens PLCs v1. The only limit when creating a S7 ISO on TCP Connection is the number of connections available in each PLC‟s communication processor (CP).3. A S7 ISO on TCP Connection can be created manually by highlighting an existing Siemens TCP/IP Channel and selecting the Define New option. General Tab Figure 32 - Create New S7 ISO on TCP Connection Window (General Tab) Table 25 describes the components of the Create New S7 ISO on TCP Connection - General tab. Component Name Description User name assigned to the object, which becomes an element of the item ID for data items. Automatically converted to title case for display purposes. Note: This information stays consistent across all tabs. Enable (select the checkbox) or disable (clear the checkbox) communication for the object. By default, the checkbox is selected. Note: This information stays consistent across all tabs. Optional, user-defined text (64-character maximum) for documentation purposes. By default, this field is blank. Note: This information stays consistent across all tabs. Connection Status Displays the connection to the S7 communication processor (CP) status. 53 Enabled Description MatrikonOPC Server for Siemens PLCs v1.3.0 User’s Manual Component Description Allows you to select, from the drop-down list, the S7 model which also defines the communication processor (CP) to which the OPC server is connecting (e.g., if S7 300 is selected, the CP model is CP 343). Default = S7 200. Displays the IP address assigned to the S7 communication processor (CP). By default, this field is empty. Displays the TCP port number used to connect to the S7 communication processor (CP). Default = 102. Allows you to define the path to the SIMATIC Step 7 project from which the OPC server can import symbols. Refer to Importing Symbols From SIMATIC Step 7 Project. Select this button to save any changes and close the window. Note: This information stays consistent across all tabs. Select this button to close the window without saving any changes made. Note: This information stays consistent across all tabs. Model IP Address Port Number Import Symbols OK Cancel Table 25 - Create New S7 ISO on TCP Connection Window (General Tab) Components Note: When the S7 model changes while an OPC client is reading data, some OPC items may not be valid anymore even though using a correct syntax. For example, item C0 becomes invalid when the model changes from S7 200 to S7 300 since these models use different type identifiers for counters. In this case, the OPC client needs to disconnect and reconnect to the OPC server to recreate these items with the correct type identifiers. Following are the types which do not require an OPC client disconnection/reconnection: Discrete Inputs Discrete Outputs Internal Memory Timing Tab Table 26 describes the components of the Create New S7 ISO on TCP Connection - Timing tab (Figure 33). MatrikonOPC Server for Siemens PLCs v1.3.0 User’s Manual 54 Figure 33 - Create New S7 ISO on TCP Connection Window (Timing Tab) Component Description Allows you to enter a value (in milliseconds) to define the communication timeout. If the server sends a request and does not receive a response from the S7 CP within this time limit, it will retry sending the message. Default = 1000. Allows you to enter a value (in milliseconds) to define the delay between consecutive messages. Default = 10. Allows you to enter a value (in milliseconds) to define the delay between connection attempts to the S7 CP. Default = 1000. Allows you to enter a value (in milliseconds) to define the delay between consecutive read attempts. Default = 100. Allows you to enter a value defining the number of retries allowed. If the server sends a request to the S7 CP and does not receive a response in the time limit specified in the Timeout field, it will retry sending the message the 55 Timeout Inter Message Delay Inter Connect Delay Retry Delay Retries MatrikonOPC Server for Siemens PLCs v1.3.0 User’s Manual The three different link types supported are: 1. PLC (includes any device communicating with the CP and different than a PG/PC or OP): Number of simultaneous connections is typically 2 or greater (please refer to the S7 CPU Link Type MatrikonOPC Server for Siemens PLCs v1. If a response is not received within the allotted number of retries. the server assumes that communication to the S7 CP has been lost.0 User’s Manual 56 .Create New S7 ISO on TCP Connection Window (Timing Tab) Components S7 Parameters Tab Table 27 describes the components of the Create New S7 ISO on TCP Connection – S7 Parameters tab (Figure 34). To increase the data throughput. under the same Siemens TCP/IP Channel or under a separate one.Component Description number of times specified here in this field.3. OP (Operator panel): Typically limited to only one connection. multiple connections must be configured. This can be done by creating multiples S7 ISO on TCP connection objects with identical settings (except the object name). PG/PC (Programming device or PC): Typically limited to only one connection. Default = 3.Create New S7 ISO on TCP Connection Window (S7 Parameters Tab) Component Description The number of simultaneous connections the S7 CP can handle is determined by the type of link selected from the drop-down list. Table 26 . 3. Each S7 ISO on TCP connection allows only one connection to the S7 CP. 2. Figure 34 . Displays the local TSAP used to connect to the S7 PLC. PG Connection Configured Connection Remote TSAP Local TSAP Table 27 . Displays the remote TSAP used to connect to the S7 PLC.0 User’s Manual 57 . Note: Please ensure no other configuration or communication software is using this same connection. The slot number of the CPU from which the OPC server is reading data. MatrikonOPC Server for Siemens PLCs v1. Select this option to use the PG connection. The default option is set to PLC.Component Description documentation for the maximum number of connections supported). Rack Slot The rack number of the CPU from which the OPC server is reading data. the TSAP must be entered without the period: nnyy (Hexadecimal values). Only one PG connection is available.3. Up to eight connections can be added with the STEP 7 MicroWIN‟s Ethernet Wizard. Optimization Tab Table 27 describes the components of the Create New S7 ISO on TCP Connection Optimization tab (Figure 35). Select this option to use a connection which was configured in STEP 7 MicroWIN.yy (Hexadecimal values). In the OPC server configuration. since the PG/PC and/or OP links might be used by other automation software or devices.Create New S7 ISO on TCP Connection Window (S7 Parameters Tab) Components Note: The TSAP is displayed in the STEP 7 MicroWIN‟s Ethernet Wizard as: nn. Each connection can be used by only one client. which is the default connection used by STEP 7 MicroWIN. select an existing Siemens TCP/IP Channel item and either: Right-click your mouse and select Define New from the menu that appears. to 210 bytes. Default = 1.Figure 35 . or Click on the icon. this parameter is set.3. by default.Create New S7 ISO on TCP Connection Window (Optimization Tab) Components To manually create an S7 ISO on TCP Connection: 1. 2. For optimal performance. MatrikonOPC Server for Siemens PLCs v1. Allows you to enter a value defining the maximum gap (in bytes) between adjacent items in the same data area. The Insert New Object window (Figure 36) appears. or Select the Define New menu option from the Edit menu. but can be extended to 254 bytes. Maximum String Length Maximum Gap Table 28 .Create New S7 ISO on TCP Connection Window (Optimization Tab) Component Description Allows you to enter a value defining the maximum length (in bytes) used for data block strings.0 User’s Manual 58 . On the Configuration window. From the displayed list. then the Create New S7 ISO on TCP (RFC 1006) Connection window is displayed. This can be done at any time. 8. select the S7 ISO on TCP (RFC 1006) Connection object type. Click on the OK button. enter a name for the object. For example. If the entered name is a duplicate of an existing object.e.New S7 ISO on TCP Connection MatrikonOPC Server for Siemens PLCs v1.. The object is created and appears as a child of the Siemens TCP/IP Channel item as shown in Figure 37. 4. the new object will not be created.Figure 36 .Insert New Object Window 3. 6. Note: An error message is displayed when a valid name is not entered. the Enabled checkbox is selected). Note: The item selected in the Insert New Object window determines which Create New window is displayed. it must be enabled (i. The Description field is optional. Note: For the object to be used for communication. From the Create New window.0 User’s Manual 59 . 5. 7.3. Figure 37 . when S7 ISO on TCP (RFC 1006) Connection is selected. Click on the OK button. Edit the configuration components as desired. The Create New window appears (Figure 32). Figure 38 . The Create New S7 NetLink Connection window consists of three tabs: General Timing Optimization General Tab Table 25 describes the components of the Create New S7 NetLink Connection . The only limit when creating a S7 NetLink Connection is the number of NetLink adapters on the network. The Create New window (Figure 32) displays the settings available for a S7 NetLink Connection.0 User’s Manual 60 .3. A S7 NetLink Connection can be created manually by highlighting an existing Siemens TCP/IP Channel and selecting the Define New option.Create New S7 NetLink Connection Window (General Tab) MatrikonOPC Server for Siemens PLCs v1.Creating and Configuring a S7 NetLink Connection The S7 NetLink Connection handles the configuration of NetLink protocol parameters and the flow of data between the server and the NetLink adapter. For more information. refer to the step-by-step instructions entitled To manually create a S7 NetLink Connection.General tab (Figure 38). Automatically converted to title case for display purposes.. By default.. takes any user-defined text (64-character maximum) for documentation purposes. By default. this field is blank. Name Enabled Description Connection Status Network Adapter IP Address Port Number MPI Address Ethernet Address Serial Number Import Symbols OK Cancel Table 29 . Displays the NetLink adapter Ethernet address. Refer to Importing Symbols From SIMATIC Step 7 Project. By default. Note: This information stays consistent across all tabs. Note: This information stays consistent across all tabs.Component Description Name of the object.Create New S7 NetLink Connection Window (General Tab) Components Timing Tab Table 26 describes the components of the Create New S7 NetLink Connection . Defines the path to the SIMATIC Step 7 project from which the OPC server can import data block symbols. checkbox is cleared) communication for the object. Displays the NetLink adapter serial number. This field is optional. Displays the local network adapter used to communicate with the NetLink adapter. This field contains the TCP port number used to connect to the NetLink adapter. checkbox is selected) or disable (i.Timing tab (Figure 39).3. This field contains the IP address assigned to the NetLink adapter.e. which becomes an element of the item ID for data items under the object. this field is blank. This field contains the MPI ID used by the PLC to which the NetLink adapter is connected. Select this button to save any changes and close the window. Use this checkbox to enable (i. Note: This information stays consistent across all tabs. Note: This information stays consistent across all tabs. the checkbox is selected. Select this button to close the window without saving any changes made.0 User’s Manual 61 .e. MatrikonOPC Server for Siemens PLCs v1. Displays the status of the connection to the NetLink adapter. Note: This information stays consistent across all tabs. Allows you to enter a value that defines the number of retries allowed.0 User’s Manual . Default = 1000. Allows you to enter a value (in milliseconds) to define the delay between consecutive read attempts. it will retry sending the message. Allows you to enter a value (in milliseconds) to define the delay between connection attempts to the S7 CP. If the server sends a request to the S7 CP and does not receive a response in the time limit specified in the Timeout field.Figure 39 . If the server sends a request and does not receive a response from the S7 CP within this time limit. Default = 100. Default = 1000.3. it will retry sending the message 62 Timeout Inter Message Delay Inter Connect Delay Retry Delay Retries MatrikonOPC Server for Siemens PLCs v1.Timing Tab Component Description Allows you to enter a value (in milliseconds) to define the communication timeout. Allows you to enter a value (in milliseconds) to define the delay between consecutive messages. Default = 10.Create New S7 NetLink Connection Window . If a response is not received within the allotted number of retries.Component Description the number of times specified here in this field. For optimal performance. Figure 40 .0 User’s Manual 63 . Allows you to enter a value that defines the maximum gap (in bytes) between adjacent items in the same data area. Table 30 .Optimization tab (Figure 40). the server assumes that communication to the S7 CP has been lost.Create New S7 NetLink Connection Window (Optimization Tab) Component Maximum String Length Description Allows you to enter a value that defines the maximum length (in bytes) used for data block strings. Default = 3. Maximum Gap MatrikonOPC Server for Siemens PLCs v1. to 200 bytes.3. but can be extended to 254 bytes. this parameter is set.Create New S7 NetLink Connection Window (Timing Tab) Components Optimization Tab Table 26 describes the components of the Create New S7 NetLink Connection . by default. Click on the OK button. If the entered name is a duplicate of an existing object. This can be done at any time. it must be enabled (i. 4. Edit the configuration components as desired. Figure 41 . Description Table 31 . select an existing Siemens TCP/IP Channel item and either: Right-click your mouse and select Define New from the menu that appears. Note: For the object to be used for communication. 6. 5. 2. or Click on the icon.e. the new object will not be created. The Description field is optional.New S7 NetLink Connection MatrikonOPC Server for Siemens PLCs v1. the Enabled checkbox is selected). or Select the Define New menu option from the Edit menu. then the Create New S7 NetLink Connection window is displayed.. From the displayed list.Create New S7 NetLink Connection Window (Optimization Tab) Components To manually create an S7 NetLink Connection: 1. Note: The item selected in the Insert New Object window determines which Create New window is displayed. 7. 3. The object is created and appears as a child of the Siemens TCP/IP Channel item as shown in Figure 41.0 User’s Manual 64 . On the Configuration window.3. select the S7 NetLink Connection object type. Note: An error message is displayed when a valid name is not entered. when S7 NetLink Connection is selected. The Create New window appears (Figure 38). Click on the OK button. The Insert New Object window (Figure 36) appears.Component Default = 1. For example. enter a name for the object. From the Create New window. 8. Current configuration) panel. click on the Yes button.e.Client Reference Warning Message To remove an object: 1. select the Delete menu option (or click on the button). To leave the object unmodified.0 User’s Manual 65 . Note: Items marked for deletion are disabled and a red X appears over the icon on the right side of the window when the object is selected. 2. 3. Figure 42 . Select the connection which should be using the symbols. From the Edit menu. Removing Objects Note: Users can easily remove any object that they have created. To mark the object for later deletion.3. 2. or click on the Cancel button to discard them. 2. select the object to be removed. 3. but a warning message (Figure 42) will appear when users remove an object that has data items to which one or more OPC clients hold reference.Changing Objects To change an object’s configuration: 1... click on the No button. under Server Configuration. The Select Step 7 Project File window (Figure 43) appears. Click on the Apply button to accept the changes. 3. pane on the right). MatrikonOPC Server for Siemens PLCs v1. Once an object is created. a warning message (Figure 42) appears. Note: If one or more OPC clients hold references to data items somewhere under the selected object. select it in the tree view (i. In the Configuration window.e. In the configuration panel (i. Click on the browse button associated with the Import Symbols field. Importing Symbols From SIMATIC STEP 7 Project To import symbols from a SIMATIC STEP 7 project: 1. make the applicable changes. 5.Figure 43 . MatrikonOPC Server for Siemens PLCs v1.0 User’s Manual 66 . By default. The Import S7 Symbols from [Project Internal Name] window (Figure 44) appears. Select the project from which the OPC server should be importing the symbols.3. Click on the Open button. the window points to the SIMATIC STEP 7 directory. 6.Select Step 7 Project File Window 4. Import STEP 7 Project Symbols from [Project Internal Name] Window Table 32 describes the components of the Import STEP 7 Project Symbols from [Project Internal Name]. Click this button to import symbols from the selected PLC program. PLC programs available in stations configured in SIMATIC Step 7. Component Step 7 Project Path Internal Name PLC Programs Import Clear All Symbols Delete Description The SIMATIC Step 7 project directory path.Figure 44 .Select S7 Data Block Symbols from [Project Internal Name] Components To import data block variables from a STEP 7 MicroWIN project: 1.0 User’s Manual 67 . Select the connection which should be using the variable symbols. MatrikonOPC Server for Siemens PLCs v1. The SIMATIC Step 7 project internal name. Select the required symbol and then click this button to delete a symbol.3. Click this button to clear the Symbols list. List of imported symbols. Table 32 . Click on the Open button.Select STEP 7 MicroWIN Export File Window 4. Click on the browse button associated with the Import Symbols field. MatrikonOPC Server for Siemens PLCs v1. To export STEP 7 MicroWIN project data block variables to a file: 1. 5. Figure 45 . Launch STEP 7 MicroWIN and Open the project which contains the data block variables. 3. 2.2.0 User’s Manual 68 .3. Right click on Data Block and then select Export from the displayed menu. Select the export file from which the data block variables should be imported. The Select STEP 7 MicroWIN Export File window (Figure 45) appears. The Export Data Block window (Figure 47) appears.Export Data Block Window MatrikonOPC Server for Siemens PLCs v1.STEP 7 MicroWIN Project Window 3.0 User’s Manual 69 .Figure 46 .3. Figure 47 . MatrikonOPC Server for Siemens PLCs v1. for example: Com1. Enter a new name for the Alias Group.Unit1. choose Insert Alias Group or click on the 3. Inserting Alias Groups Note: Alias Groups are used to contain one or more configured aliases. The Alias Group is renamed. select Alias Configuration or a previously configured Alias Group. Browse to the location where the export file should be stored.41. From the Edit menu.123.4. On the Configuration window. This section of the manual describes how to create and edit aliases using the Configuration window. Servers can also be configured so that client applications have access to configured aliases only. button. choose Rename or click on the 3. Note: It is not necessary to define aliases before accessing server data items from an OPC client. Inserting New Aliases Use the Insert New Alias window (Figure 48) to insert a new alias into an Alias Group. Type a file name in the File name field. including this one. 5. 5. To insert an Alias Group: 1. 2. Click on the Save button. rather than every available item. On the Configuration window. To rename an Alias Group: 1. select an Alias Group.3. The Alias Group is renamed. 2. 4. provide the ability to create user-defined aliases that can be used in place of regular OPC items.4. A new Alias Group folder appears. This feature is particularly useful when the item path for a given server is very complex or difficult to remember. Renaming Alias Groups Note: Alias Groups can be renamed after they have been created. From the Edit menu.0 User’s Manual 70 . or insert a new alias on its own directly under the Alias Configuration node. Alias Configuration MatrikonOPC servers.Radio1. button. and press Enter. Click on the Settings button to display the Configure Scaling window used to configured the scaling algorithm used. Click on the Browse button to display the Item Path Browser window used to select an existing OPC item on the server. Basic Aliases can be configured to have scaling calculations applied to the value of the mapped item ID configured under Item Path. To enable the use of a scaling algorithm check the Apply scaling algorithm checkbox.0 User’s Manual . A basic alias is an alias that renames a data item in the server and optionally allows the configuration of simple scaling.Insert New Alias Window – Alias Type Table 33 describes the components of the Insert New Alias window. Component Name Basic Alias Description Allows you to enter a name for the alias (which must be unique within the alias group). This rate is configured in the Advanced Options window. Note: If Events are enabled. This Alias type is typically used when trying to simplify a servers address space. the alias creates a data subscription to the configured item at the Alias Subscription Rate.3. An Advanced Calculation Alias allows the user to configuration a data 71 Item Path Apply Scaling Algorithm Advanced Calculation Alias MatrikonOPC Server for Siemens PLCs v1.Figure 48 . Fully-qualified item ID for the OPC item to which the alias refers. Table 33 .3. this checkbox is cleared. the value of the OPC item to the specified type unless Default is selected. Allows you to enter a value defining the update rate (in milliseconds) to use with the Poll when inactive option. The canonical data type of the holding register. Save changes to the alias and close the window. it prevents OPC clients from writing values to the alias. Typically Holding Register Aliases are used as temporary data locations or for configuration testing during system deployment. Use the Insert Item button to display the Item Path Browser window used to select an existing OPC item on the server and insert a reference into the equation. Note: Not all data types support the configuration of an initial value. These registers can be read from and written to like any other data item. continues updating the value for the alias at the specified update rate even if there are no OPC clients currently accessing the 72 Data Type Update Rate Read only Poll when inactive MatrikonOPC Server for Siemens PLCs v1. When this checkbox is selected. If selected. Equation The equation to apply to calculate the data value of the alias. A Holding Register Alias is a data item that is not associated with any data items in the server. Note: This option is not available for Calculation aliases.Component Description point whose value is the result of a mathematical equation that can involve values from multiple data items in the server. If this value requires a different initial value it can be entered here. By default. clients will be sent data as this data type. a holding register will initially contain a value of 0 or the closest value to zero that applies to the data type. Discards changes to (abandon creation of) the alias and closes the window. All values written to this alias will be converted to this data type.Insert New Alias Window – Alias Type Options Holding Register Alias Data Type Initial Value Save Save & Create New Cancel Component Description Allows you to select. See Appendix B – Aliases – Advanced Calculations or click on the Help icon for information on how to write equations and the functions available. Save changes to the alias and begin configuring a new one. as they are read-only.0 User’s Manual . Also serves as the “canonical” data type for the alias. By default. This field may be disabled depending on the data type chosen for the holding register. By default. Default = (Default). from the drop-down list. Default = 0. Select Basic Alias.3. 2. Enter the item Path and ID for the item to which the alias refers. To remove an alias: 1. 8. This is virtually the same as the Insert New Alias window (Figure 48) with the exception that it appears after the alias has been created. From the Edit menu. 9. and then double-click or press Enter. Editing Aliases Note: Aliases can be edited after they have been created using the Edit Alias window. click on the Save button to save the alias. 1.Component alias. 2. Figure 49 . select one or more aliases that you want to remove. Make the changes as required. The Contents table for that Alias Group is displayed on the right side of the Configuration window (Figure 49). 5. To edit an alias: 1. If scaling is desired. Removing Aliases Note: Any alias that was created can be removed. listing the aliases it contains. select Alias Configuration or a previously configured Alias Group. choose Insert New Alias. Enter a name for the alias in the Name field. check the Apply scaling algorithm checkbox and click on the Settings button to Configure Scaling. Description Table 34 . 3. MatrikonOPC Server for Siemens PLCs v1. On the Configuration window.Contents Table 3. 7. The Edit Alias window appears. 4. select the alias you want to change. On the Configuration Window.0 User’s Manual 73 . The Insert New Alias window (Figure 48) appears. From the Insert New Alias window. On the Configuration window. 6. or click on the Browse button to navigate to the item.Insert New Alias Window – Alias Properties Options To insert a new alias: Note: It is recommended that you create a new alias under an Alias Group rather than directly under the Alias Configuration node. Click Save.3. Click Open. button. The old aliases are cleared and the new ones are imported. Enter a file name for the CSV export file. select the Import Aliases menu option or click on the 2. 3. On the Configuration window. select the Delete Alias Group menu option or click on the 3. From the Edit menu. To export all currently configured aliases: 1.2. button. Removing Alias Groups Note: Any Alias Group that was created can be removed. 5. 4. From the File menu. button. The Import Aliases window appears. Exporting Aliases Note: Use the Export Aliases window to export all currently configured aliases to a CSV file. choose the Delete Alias menu option. Importing Aliases Note: Use the Import Aliases window to clear all aliases and import new ones from a CSV file. The alias is removed. To remove an Alias Group: 1. Browse to the CSV file name. To import aliases from a CSV file: 1. 5. The CSV file format does not support event generation settings. The Alias Group is removed. All imported aliases will be configured to not generate events. 3. The aliases are exported. 3.0 User’s Manual 74 . The Export Aliases window appears. MatrikonOPC Server for Siemens PLCs v1. Below is a description of how to configure the scaling algorithms. Configure Alias Scaling An alias can be configured to apply a scaling algorithm to the data. 4. select the Export Aliases menu option or click on the 2. From the Edit menu. From the File menu. select the Alias Group you want to remove. 2. Selection Component Raw High Raw Low Scaled High Linear and Square Root Scaled Low Clamp High Clamp Low Gain/Offset Gain Offset Description Maximum expected raw value of the OPC item. refer to the Expression Wizard section in this manual. (No limits are assumed. Minimum expected raw value of the OPC item. Clamp the scaled value at the high limit to prevent it from going out of range. For more information. Click on the ellipsis button ( ) to display the Expression Wizard screen used to help build a formula.0 User’s Manual 75 . For more information. Click on the Input Expression Output ellipsis button ( ) to display the Expression Wizard screen used to help build a formula. Simple text equation to apply to outgoing values (writes).Configure Scaling Window Options MatrikonOPC Server for Siemens PLCs v1. Scaling factor. Clamp the scaled value at the low limit to prevent it from going out of range.Figure 50 . refer to the Expression Wizard section in this manual.Configure Scaling Window Table 35 describes the Scaling Options for the Configure Scaling window.) Scaling offset. Table 35 . Maximum desired scaled value for the alias (corresponds to Raw High). Minimum desired scaled value for the alias (corresponds to Raw Low). Simple text equation to apply to incoming values (reads).3. The OPC item values must be numeric for Linear. Square Root. and communications. rename the configuration file so that the server will not load it upon start-up. Configure Alias Events Note: Alias Events needs to be licensed separately. Access the Generate Events tab through the Insert New Aliases window (Figure 51). The server may be unable to load configuration files containing invalid scaling expressions.3. and Gain/Offset scaling to work. and by default. please contact your MatrikonOPC Account Manager. may be fatal to the server.Generate Events Options MatrikonOPC Server for Siemens PLCs v1. If this occurs.Notes: The data type for scaled values is double-precision real unless the alias data type is specified. and may fail to start up properly. Using invalid settings. Otherwise. Figure 51 . OPC clients. the scaled value will be -1 with a bad quality. To purchase a full Alias Events license. such as zero-zero for the high-low range in Linear scaling. Alternatively.0 User’s Manual 76 . The OPC item values must be non-negative for Square Root scaling to work. is delivered with only a 30-day demo. Use the Generate Events (Figure 51) window to configure whether or not aliases generate OPC A&E events when their value changes. edit the XML file to correct the invalid alias settings. Component Category ID Description Displays the ID number that appears in the event that is registered 77 MatrikonOPC Server for Siemens PLCs v1.3. refer to the Configure Categories section for more information. The allowable range is 1 through 1000. this field is the Alias Group name. Figure 52 . For more information. By default. Allows you to enter a value defining the severity of the alarm. Note: If items are referenced. or if there is no Alias Group then the Alias name.Table 36 describes the Events tab fields. refer to the Item Path Browser section in this manual. Component Source Description Allows you to enter the name of the source of the event. Allows you to enter a message that is to appear in the posted event. Allows you to select from the drop-down list. Click the Insert Item button to display the Item Path Browser screen used to add item paths to this field. Table 36 .0 User’s Manual . This rate is configured in the Advanced Options window. the alias creates a data subscription to the referenced items at the Alias Subscription Rate. the event category under which the event is to be registered. For more information. These references are replaced with the values of those items at the time the event was generated.Generate Events Window Options Category Severity Message Configure Categories The New Category window (Figure 52) is presented when you choose to add a new category to the server from the Generate Events window (Figure 51).New Category Window Table 37 describes the New Category window fields. This message can contain references to data item in the server. Select either the New Category or Edit Category option to configure the registered categories in the server. Component Description under this category. or outgoing values (i.e. but not edited. select the category to edit and click the Edit button.0. which again.e.. writes). Note: Some categories cannot be edited. Click on the View button. This numbered field is blank until the category is created.3. Expression Wizard The Expression form of scaling uses an Expression Wizard to build formulas.0 User’s Manual 78 . This causes the Edit Category window to appear which is virtually identical to the New Category window. Name Allows you to enter the name that is to be used to refer to the category. Any non-zero value shows up as a 1. These categories are marked as Read Only and can be viewed. if you wish to view existing category details. Once the category is created the server assigns a unique ID.1) MatrikonOPC Server for Siemens PLCs v1. Table 37 . The name and the description appear together as the category description in OPC clients that support retrieving category information.New Category Window Options Description The Edit Categories window is displayed when you choose to edit categories from the Generate Events window (Figure 51). From the Edit Categories window.Edit Categories Window When presented with the Edit Categories window. Allows you to enter a description of what the category represents in the system. Examples Example 1: The following turns any number into a Boolean value. The created formula is a simple text equation that is applied to either incoming values (i. is virtually identical to the New Category window. IF(INPUT = 0. reads). select the required category. Figure 53 . The View Category window is displayed.. OUTPUT Example 2: The following takes the text out of SAMPLE and converts it to ON. If OUTPUT is specified in the Output field. It reads Output Expression when creating an output or “write” expression. Output Expression. then the value is transferred to the end OPC item. Component Input/Output Expression Database field Function Variable Operators Clear Validate Description Displays the expression as it is created. Select this button to accept changes to (or the creation of) the expression. To create an Input or Output Expression: 1. create an Output Expression. String comparisons are case-sensitive. MatrikonOPC Server for Siemens PLCs v1. Select this button to validate the expression that appears in the Input/Output Expression field. If you are expecting to read a particular alias. create an Input Expression. and that one is for reads and the other for writes. IF(INPUT = ‘SAMPLE’. an error message is displayed. All other values show as OFF. This field reads Input Expression when creating an input or “read” expression. Table 38 . Select this button to clear the Input/Output Expression field. This field is free-form which allows you to manually enter or edit information. On the Configuration window. you can write SAMPLE or any other value to the alias to get the display to changed from OFF to ON. The differences being the expression field label: Input Expression. This button is reserved for future enhancements. Select the applicable button to add the corresponding operator or operators to the expression. If the expression is valid. select Alias Configuration or a previously configured Alias Group.’ON’.’OFF’) OUTPUT Table 38 describes the Expression Wizard fields. a message is displayed indicating there are no errors and also stating what the result is. Select this button to discard changes to (or abandon the creation of) the expression. If the expression is invalid. Select this button to display the Select function window which allows you to select the necessary function from those available.0 User’s Manual 79 . If you are expecting to write to a particular alias. Using this alias.3. Select this button to display the Select variable window which allows you to select the necessary variable from those available.Expression Wizard Options OK Cancel Notes: The Expression Wizard appears and functions the same for an input expression as it does for an output expression. Figure 55 . or Click on the Edit the selected alias item ( 4.3. Check the Apply scaling algorithm checkbox and then click the Settings button.Expression Engine Configuration 7. The Edit Alias window appears. Click on the Configure button adjacent to the Input field (or Output field). The Contents table for that alias group is displayed on the right side of the Configuration window. 5. Manually enter your new expression in the Input/Output Expression field and proceed to step 14. Or. or Double-click your mouse on an existing alias.Expression Wizard 9.0 User’s Manual 80 . MatrikonOPC Server for Siemens PLCs v1. listing the aliases it contains. 8. ) button. The Expression Wizard (Figure 55) is displayed. 6. Figure 54 . Either create a new alias (for instructions.2. Select the Expression Engine option (Figure 54). 3. refer to Inserting New Aliases). 0 User’s Manual 81 . click on the OK button to close the Select variable window and return to the Expression Wizard.Select Function Window 11. click on the Modify variables button to access the User Defined Functions Editor (Figure 58) which allows you to add. After selecting the required variable. Figure 56 . Figure 57 .Select Variable Window 12.3.Perform steps 9 through 13 using a combination of the Function. change. Click on the Variable button to go to the Select variable (Figure 57) window. or delete variables. which will be displayed in the Input/Output Expression field as you build it. If required. Click on the Function button to go to the Select function (Figure 56) window. After selecting the required function. click on the Continue button to close the Select function window and return to the Expression Wizard. from the Select variable window. MatrikonOPC Server for Siemens PLCs v1. Variable. 10. and Operators buttons to create your expression. Table 39 describes the Item Path Browser fields. From the Edit Alias window. 17. The Operators buttons (Figure 59) allow you to enter an operation descriptor based on the selected button.e. The Edit Alias window closes and you are returned to the Configuration window. depending on which expression you defined.3. Left-clicking a leaf enables the OK button.Operators Buttons 14. Displays the list of leaves belonging to a selected branch from the Branch Hierarchy.symbols can be used to display/hide the branches below the specified branch.0 User’s Manual . The +/. click on the Save button. 16. 15. Click on OK button on the Expression Wizard screen to close the wizard and display the expression in either the Input or Output field. Click on the Validate button to determine whether or not the expression is valid. Select this button to add the selected item from the Leaf List to the Input/Output component of the Insert New Alias form.. a confirmation message is displayed). click on the OK button to close the message window and return to the Expression Wizard screen. Item Path Browser The Basic Alias and Advanced Calculation Alias configuration uses the Item Path Browser to add item paths.Figure 58 . Figure 59 . Left-clicking a branch displays its leaves in the Leaf List component. Component Branch Hierarchy Description Displays the branch hierarchy of the OPC server when browsing actions are being performed. Select this button to exit the Item Path Browser without adding any 82 Leaf List OK Cancel MatrikonOPC Server for Siemens PLCs v1. 18.User Defined Functions Editor 13. If the expression is valid (i. If OPC clients are still connected to the server. From the File menu. From the File menu. The Save Configuration window appears. the connection between the server and the client needs to be broken. Click Save. To load an existing configuration file: 1. a warning message appears. Click OK. button. 4. 4. To save a configuration to an XML file: 1. Click Open. users can choose Save or click ).Component item paths. Enter a file name if saving the file for the first time. If OPC clients are still connected to the server. button. 3. Notes: At this stage. From the File menu. MatrikonOPC Server for Siemens PLCs v1. The configuration is saved. choose the New menu option or click on the 3. 2. 4. use the Save Configuration window to save the configuration to an XML file. Refresh Description Select this button to refresh the browsing hierarchy in the Branch Hierarchy component. 5. When the new configuration is completely loaded. To clear a configuration: 1. you can clear the current configuration and then load the saved configuration file. the changes will take effect in the OPC client. Loading an Existing Configuration Note: If you have previously saved a configuration. 3. 5. select the Save As menu option or click on the (alternatively. Browse for the configuration file that you want to load. button Clearing a Configuration Note: Starting a new configuration will clear the existing one. select the Open menu option or click on the 2. Table 39 – Item Path Browser Options Saving a Configuration Note: When the server configuration is complete. The Open Configuration window appears.0 User’s Manual 83 .3. 2. a warning message appears. The configuration is cleared. If OPC clients are still connected to the server. if the Configuration window is displayed. Click OK. Services can be shut down only from the Service Control Manager applet in the Windows Control Panel.6. Note: The shutdown command is not available for the server if it runs as a Windows service. choose Shutdown Server from the File menu or click on the button. The old configuration is cleared and the new configuration is loaded from the file.0 User’s Manual 84 . select Shutdown. a warning message appears. The server is shut down. To shut down the server: 1. the configuration utility locks the server so that it will not shut down. If the server is running as a local executable. MatrikonOPC Server for Siemens PLCs v1. 7. On either the Control Panel or the Tool Tray Menu. However. Shutting Down the Server Note: Ordinarily. 4. Click OK.3. 2. the server shuts down automatically shortly after the last OPC client disconnects from it. 3. OPC Data Items This section describes the OPC data items used in the MatrikonOPC Server for Siemens PLCs. Connection Items The S7 ISO on TCP (RFC1006) and S7 NetLink (only for S7 300/400) connections use the same item ID syntax as described in Table 40: [Siemens TCP/IP Channel Name]>[Connection Name]>[Tag Syntax] Field Siemens TCP/IP Channel Name Connection Name Tag Syntax Description Siemens TCP/IP Channel Name Connection Name Tag Syntax Table 40 - Item ID Field Descriptions In the following information, offsets and bit positions are zero-based and S7 300/400 refers to the S7 300 and S7 400 models. S7 300/400 Tag Syntax Table 41 shows the tag syntax for each S7 300/400 memory area or data block type. S7 Memory Area Memory Area Description Range and Syntax E0.0 : En.7 [Boolean] (*) n is the max discrete input offset. e.g.: E8.3 accesses bit 3 at offset 8. I0.0 : In.7 [Boolean] (*) n is the max discrete input offset. e.g.: I8.3 accesses bit 3 at offset 8. EB0 : EBn [Byte] n is the max discrete input byte offset. e.g.: EB8 accesses a byte at offset 8. IB0 : IBn [Byte] n is the max discrete input byte offset. e.g.: IB8 accesses a byte at offset 8. EW0 : EWn [Word] n is the max discrete input WORD offset. e.g.: EW8 accesses a WORD at offset 8. IW0 : IWn [Word] n is the max discrete input WORD offset. e.g.: IW8 accesses a WORD at offset 8. ED0 : EDn [DWord] n is the max discrete input DWORD offset. e.g.: ED8 accesses a DWORD at offset 8. ID0 : IDn [DWord] n is the max discrete input DWORD offset. e.g.: ID8 accesses a DWORD at offset 8. Q0.0 : Qn.7 [Boolean] (*) n is the max discrete output offset. e.g.: Q8.3 accesses bit 3 at offset 8. A0.0 : An.7 [Boolean] (*) n is the max discrete output offset. e.g.: A8.3 accesses bit 3 at offset 8. Description Access a single discrete input Access Right Read-Write Access a single discrete input Read-Write Access discrete inputs as a byte Read-Write Discrete Inputs Give access to the process image of the digital inputs (PII). The input module is mapped to the PII based on the address assigned during hardware configuration. Access discrete inputs as a byte Read-Write Access discrete inputs as a WORD Read-Write Access discrete inputs as a WORD Read-Write Access discrete inputs as a DWORD Read-Write Access discrete inputs as a DWORD Read-Write Discrete Outputs Give access to the process image of the digital outputs (PIQ). The output module is mapped to the PIQ based on the address assigned during hardware configuration. Access a single discrete output Read-Write Access a single discrete output Read-Write MatrikonOPC Server for Siemens PLCs v1.3.0 User’s Manual 85 Peripheral Inputs (Only when using S7 ISO on TCP connection) Allows reading input data directly from the inputs module. Peripheral Outputs (Only when using S7 ISO on TCP connection) Allows reading output data directly from the outputs module. QB0 : QBn [Byte] n is the max discrete output byte offset. e.g.: QB8 accesses a byte at offset 8. AB0 : ABn [Byte] n is the max discrete output byte offset. e.g.: AB8 accesses a byte at offset 8. QW0 : QWn [Word] n is the max discrete output WORD offset. e.g.: QW8 accesses a WORD at offset 8. AW0 : AWn [Word] n is the max discrete output WORD offset. e.g.: AW8 accesses a WORD at offset 8. QD0 : QDn [DWord] n is the max discrete output DWORD offset. e.g.: QD8 accesses a DWORD at offset 8. AD0 : ADn [DWord] n is the max discrete output DWORD offset. e.g.: AD8 accesses a DWORD at offset 8. PE0.0 : PEn.7 [Boolean] (*) n is the max peripheral input offset. e.g.: PE8.3 accesses bit 3 at offset 8. PI0.0 : PIn.7 [Boolean] (*) n is the max peripheral input offset. e.g.: PI8.3 accesses bit 3 at offset 8. PEB0 : PEBn [Byte] n is the max peripheral input byte offset. e.g.: PEB8 accesses a byte at offset 8. PIB0 : PIBn [Byte] n is the max peripheral input byte offset. e.g.: PIB8 accesses a byte at offset 8. PEW0 : PEWn [Word] n is the max peripheral input WORD offset. e.g.: PEW8 accesses a WORD at offset 8. PIW0 : PIWn [Word] n is the max peripheral input WORD offset. e.g.: PIW8 accesses a WORD at offset 8. PED0 : PEDn [DWord] n is the max peripheral input DWORD offset. e.g.: PED8 accesses a DWORD at offset 8. PID0 : PIDn [DWord] n is the max peripheral input DWORD offset. e.g.: PID8 accesses a DWORD at offset 8. PQ0.0 : PQn.7 [Boolean] (*) n is the max peripheral output offset. e.g.: PQ8.3 accesses bit 3 at offset 8. PA0.0 : PAn.7 [Boolean] (*) n is the max peripheral output offset. e.g.: PA8.3 accesses bit 3 at offset 8. PQB0 : PQBn [Byte] n is the max peripheral output byte offset. e.g.: PQB8 accesses a byte at offset 8. PAB0 : PABn [Byte] n is the max peripheral output byte offset. e.g.: PAB8 accesses a byte at offset 8. PQW0 : PQWn [Word] n is the max peripheral output WORD offset. e.g.: PQW8 accesses a WORD at offset 8. Access discrete outputs as a byte Read-Write Access discrete outputs as a byte Read-Write Access discrete outputs as a WORD Read-Write Access discrete outputs as a WORD Read-Write Access discrete outputs as a DWORD Read-Write Access discrete outputs as a DWORD Read-Write Access a peripheral input as a bit Read Access a peripheral input as a bit Read Access peripheral input as a byte Read Access peripheral input as a byte Read Access peripheral input as a WORD Read Access peripheral input as a WORD Read Access peripheral input as a DWORD Read Access peripheral input as a DWORD Read Access a peripheral output as a bit Read-Write Access a peripheral output as a bit Read-Write Access peripheral output as a byte Read-Write Access peripheral output as a byte Read-Write Access peripheral output as a WORD Read-Write MatrikonOPC Server for Siemens PLCs v1.3.0 User’s Manual 86 Internal Memory Internal storage memory, usually, used in intermediate binary or digital operation. PAW0 : PAWn [Word] n is the max peripheral output WORD offset. e.g.: PAW8 accesses a WORD at offset 8. PQD0 : PQDn [DWord] n is the max peripheral output DWORD offset. e.g.: PQD8 accesses a DWORD at offset 8. PAD0 : PADn [DWord] n is the max peripheral output DWORD offset. e.g.: PAD8 accesses a DWORD at offset 8. M0.0 : Mn.7 [Boolean] (*) n is the max internal memory offset. e.g.: M8.3 accesses bit 3 at offset 8. F0.0 : Fn.7 [Boolean] (*) n is the max internal memory offset. e.g.: F8.3 accesses bit 3 at offset 8. MB0 : MBn [Byte] n is the max internal memory byte offset. e.g.: MB8 accesses a byte at offset 8. FB0 : FBn [Byte] n is the max internal memory byte offset. e.g.: FB8 accesses a byte at offset 8. MW0 : MWn [Word] n is the max internal memory WORD offset. e.g.: MW8 accesses a WORD at offset 8. FW0 : FWn [Word] n is the max internal memory WORD offset. e.g.: FW8 accesses a WORD at offset 8. MD0 : MDn [DWord] n is the max internal memory DWORD offset. e.g.: MD8 accesses a DWORD at offset 8. FD0 : FDn [DWord] n is the max internal memory DWORD offset. e.g.: FD8 accesses a DWORD at offset 8. MR0 : MRn [Real] n is the max internal memory REAL offset. e.g.: MR8 accesses a REAL at offset 8. FR0 : FRn [Real] n is the max internal memory REAL offset. e.g.: FR8 accesses a REAL at offset 8. Access peripheral output as a WORD Read-Write Access peripheral output as a DWORD Read-Write Access peripheral output as a DWORD Read-Write Access internal memory bit Read-Write Access internal memory bit Read-Write Access internal memory byte Read-Write Access internal memory byte Read-Write Access internal memory WORD Read-Write Access internal memory WORD Read-Write Access internal memory DWORD Read-Write Access internal memory DWORD Read-Write Access internal memory REAL Read-Write Access internal memory REAL Read-Write Timer Values Counter Values Contains the S7 program software timers. Internally, stored in one WORD. The first 12 bits contains the timer preset value coded in BCD. The last 4 bits contains the time base used coded only on 2 bits. See “S5TIME” for further details. Contains counter instructions. Internally, stored in one WORD. The first 12 bits contains the counter value coded in BCD. The last 4 bits are not used. Data block variable with a value of TRUE or FALSE. Internally, stored in one bit. T0 : Tn [DWord] (*) n is the max timer offset. e.g.: T8 accesses timer at offset 8. Access timer value as DWORD Read Data Block Boolean C0 : Cn [Word] (*) n is the max counter offset. e.g.: C8 accesses counter at offset 8. Z0 : Zn [Word] (*) n is the max counter offset. e.g.: Z8 accesses counter at offset 8. DBn:BOOL:x.y [Boolean] (*) n is the data block number x is the Boolean offset y is the bit number : [Range 0 to 7] e.g.: DB1:BOOL:10.2 accesses bit # 2 at offset 10 from data block # 1. Access counter value as WORD Read-Write Access counter value as WORD Read-Write Access data block BOOL Read-Write MatrikonOPC Server for Siemens PLCs v1.3.0 User’s Manual 87 DBn:DATE:x [String] n is the data block number x is the DATE offset e.: DB1:BYTE:10 accesses a byte at offset 10 from data block # 1. Data Block INT Data block variable which represents a signed decimal integer.: DB1:DATE:10 accesses a DATE variable at offset 10 from data block # 1. internally stored in 4 bytes (DWORD). Refer to the section “S7 300 Date and time formats” to see how the value is represented by the OPC server.g.g. 1990 (IEC format). Data block variable which represents the time of day as total milliseconds. Access data block BYTE Read-Write Access data block WORD Read-Write Access data block DWORD Read-Write Access data block INT Read-Write Access data block DINT Read-Write Access data block REAL Read-Write Data Block DATE Access data block DATE Read-Write Data Block TIME DBn:TIME:x [String] n is the data block number x is the TIME offset e.0 User’s Manual 88 . Refer to the section “S7 300 Date and time formats” to see how the value is represented by the OPC server.: DB1:DWORD:10 accesses a DWORD at offset 10 from data block # 1. Data block variable which represents the number of days since January 01. stored in two bytes. Internally.g.: DB1:REAL:10 accesses a REAL at offset 10 from data block # 1.g. Access data block TIME OF DAY Read-Write Data Block CHAR Access data block CHAR Read-Write MatrikonOPC Server for Siemens PLCs v1. stored in one byte. DBn:DWORD:x [DWord] n is the data block number x is the DWord offset e. Data block variable which represents a floating-point number.g.g.: DB1:DINT:10 accesses a DINT at offset 10 from data block # 1 DBn:REAL:x [Real] n is the data block number x is the REAL offset e.: DB1:CHAR:10 accesses a CHAR variable at offset 10 from data block # 1. Refer to the section “Date and time formats” to see how the value is represented by the OPC server. DBn:INT:x [Short] n is the data block number x is the INT offset e. internally stored in the IEEE 32 bits format.3. DBn:DINT:x [Long] n is the data block number x is the DINT offset e.g.: DB1:TIME_OF_DAY:10 accesses a TIME_OF_DAY variable at offset 10 from data block # 1.: DB1:TIME:10 accesses a TIME variable at offset 10 from data block # 1.: DB1:INT:10 accesses a INT at offset 10 from data block # 1. DBn:CHAR:x [String] n is the data block number x is the CHAR offset e.g. Data Block DWORD Data block variable stored in four bytes (DWORD).: DB1:WORD:10 accesses a WORD at offset 10 from data block # 1. Data block variable which represents a single ASCII character. stored in four bytes. internally stored in two bytes (WORD).Data Block BYTE Data block variable stored in one BYTE. internally stored as a signed integer in 4 bytes. Data Block WORD Data block variable stored in two bytes (WORD). Data Block DINT Data block variable which represents a signed decimal integer.g. Data Block REAL DBn:BYTE:x [Byte] n is the data block number x is the Byte offset e. DBn:WORD:x [Word] n is the data block number x is the Word offset e.g. Data block variable which represents a delay in milliseconds (IEC format). Access data block TIME Read-Write Data Block TIME OF DAY DBn:TIME_OF_DAY:x [String] n is the data block number x is the TIME OF DAY offset e. added only while importing data block symbols from a STEP7 project) Data block which represents a structure with a certain number of elements which may be a combination of any data block type. Refer to the Importing Symbols From SIMATIC STEP 7 Project section for further details.0 User’s Manual 89 .Custom OPC Properties S7 300/400 Date and Time Formats The different representation used for data and time OPC items are shown in Table 43. DBn:S5TIME:x [String] n is the data block number x is the S5TIME offset e. This is particularly useful when an item corresponds to an imported symbol. Bits 12 and 13 are used to encode the time base. including other structures.01 sec. Internally. 1. Consequently.: DB1:STRING:10:210 accesses a STRING variable with length 210 (characters) at offset 10 from data block # 1.3.1 sec.0 sec and 10 sec. Data block variable represents the date and time. Table 42 .g.: DB1:DATE_AND_TIME:10 accesses a DATE_AND_TIME variable at offset 10 from data block # 1. Table 42 shows all possible custom OPC properties: Value Device Address Description Item‟s device address. S7 Data Block Type Data Block DATE (IEC date) Year-Month-Day Format Example 2008-6-22 MatrikonOPC Server for Siemens PLCs v1. stored in 8 bytes using BCD format. Access data block STRING Read-Write Data Block Structure (Cannot be entered manually.: DB1:S5TIME:10 accesses a S5TIME variable at offset 10 from data block # 1. Internally. allowed values for this variable in milliseconds are from 0 to 9990000 and need to be multiple of 10 milliseconds. allowing values (in binary) of 00.{Structure Name}. Access data block DATE AND TIME Read-Write Data Block STRING Data block variable which represents an ASCII string which can takes up to 254 bytes.g. The first 12 bits contains the timer preset value coded in BCD which allows a value from 000 to 999.{Elt Type}(*) n is the data block number Access an element in a data block structure Read-Write Table 41 .Data Block S5TIME Data Block DATE AND TIME Data block variable which represents a timer preset value. Refer to the section “Date and time formats” to see how the value is represented by the OPC server. 01.g. DBn. 10 and 11 which correspond respectively to 0. Access data block S5TIME Read-Write DBn:DATE_AND_TIME:x [String] n is the data block number x is the DATE AND TIME offset e. DBn:STRING:x:length [String] (*) n is the data block number x is the STRING offset length is the string maximum number of characters [Range 1 to 254] e.S7 300/400 Tag Syntax Description Custom OPC Properties The OPC server provides some custom OPC properties for the items. stored in two bytes (WORD). Refer to the section “Date and time formats” to see how the value is represented by the OPC server. 0. : I8. Access discrete inputs as a WORD Read-Write Access discrete inputs as a WORD Read-Write Access discrete inputs as a DWORD Read-Write Access discrete inputs as a DWORD Read-Write MatrikonOPC Server for Siemens PLCs v1. When writing 65300 milliseconds (multiple of 10 milliseconds) to a Data Block S5TIME. S7 Memory Area Memory Area Description Range and Syntax E0. e.123 0H0M1S.7 [Boolean] (*) n is the max discrete input offset.7 [Boolean] (*) n is the max discrete input offset.S7 300 Date and Time Formats Example -2D5H30M23S647MS 5:15:0.g. For example.Milliseconds Table 43 . Description Access a single discrete input Access Right Read-Write Access a single discrete input Read-Write Access discrete inputs as a byte Read-Write Access discrete inputs as a byte Read-Write Discrete Inputs Give access to the CPU image of the discrete inputs.0 : In.: IW8 accesses a WORD at offset 8. Since only the first 12 bits are used valid values are from 0 to 999. EB0 : EBn [Byte] n is the max discrete input byte offset.g.g. S7 300/400 Counters The value returned for S7 300/400 counters are automatically converted to a BCD value. ID0 : IDn [DWord] n is the max discrete input DWORD offset.Milliseconds HourHMinMSecS.3. IW0 : IWn [Word] n is the max discrete input WORD offset. e.300. Refer to S5TIME description for further details.0. the value to be written is 0:1:0.0 User’s Manual 90 . e. I0.g.: EB8 accesses a byte at offset 8.: E8. e.0 : En. e. Valid values are from 0 to 9990000.: ID8 accesses a DWORD at offset 8. when writing 1 minute to a Data Block TIME OF DAY.: ED8 accesses a DWORD at offset 8.g.g. S7 300/400 Timers The value returned for S7 300/400 timers are automatically converted to S5TIME format and displayed in milliseconds. the same format as the OPC items needs to be used.3 accesses bit 3 at offset 8.3 accesses bit 3 at offset 8.Milliseconds Year-Month-Day-Hour:Min:Sec.: EW8 accesses a WORD at offset 8. EW0 : EWn [Word] n is the max discrete input WORD offset. ED0 : EDn [DWord] n is the max discrete input DWORD offset.S7 Data Block Type Data Block TIME (IEC time) Data Block TIME OF DAY Data Block S5TIME Data Block DATE AND TIME Format (+/-)DayDHourHMinMSecSMillisecondsMS Hour:Min:Sec. e.10 08-12-31-20:00:00. S7 200 Tag Syntax Table 44 shows the tag syntax for each S7 200 memory area or data block type. the value to be written is 0H1M5S. e.999 Writing to S7 300/400 Date and Time OPC Items When writing to S7 300/400 OPC items which represent data block date and/or time variables. e.: IB8 accesses a byte at offset 8. IB0 : IBn [Byte] n is the max discrete input byte offset.g.g. 0 User’s Manual 91 .: FB8 accesses a byte at offset 8.: AW8 accesses a WORD at offset 8.g. e. FW0 : FWn [Word] n is the max internal memory WORD offset.g.3 accesses bit 3 at offset 8.: QD8 accesses a DWORD at offset 8. AIW0 : AIWn [Word] n is the max analog input WORD offset.: MW8 accesses a WORD at offset 8. e.g. QW0 : QWn [Word] n is the max discrete output WORD offset.3 accesses bit 3 at offset 8.g. e.: QB8 accesses a byte at offset 8. e.g. e.: Q8.: PAW8 accesses a WORD at offset 8.0 : Mn. e. e.7 [Boolean] (*) n is the max internal memory offset. e. AAW0 : AAWn [Word] n is the max analog output WORD offset.: AIW8 accesses a WORD at offset 8.: F8. e.g.g.g.: AEW8 accesses a WORD at offset 8.0 : Qn. e.: FW8 accesses a WORD at offset 8. AQW0 : AQWn [Word] n is the max analog output WORD offset.: A8.g.g.g. Internal Memory Internal storage memory. e.g. e. Q0.3 accesses bit 3 at offset 8.g.7 [Boolean] (*) n is the max discrete output offset. e. A0. F0.: MB8 accesses a byte at offset 8. e.g. QB0 : QBn [Byte] n is the max discrete output byte offset. AEW0 : AEWn [Word] n is the max analog input WORD offset. FB0 : FBn [Byte] n is the max internal memory byte offset. Access a single discrete output Read-Write Access a single discrete output Read-Write Access discrete outputs as a byte Read-Write Access discrete outputs as a byte Read-Write Access discrete outputs as a WORD Read-Write Access discrete outputs as a WORD Read-Write Access discrete outputs as a DWORD Read-Write Access discrete outputs as a DWORD Read-Write Access an analog input as a WORD Read Access an analog input as a WORD Read Access an analog output as a WORD Read-Write Access an analog output as a WORD Read-Write Access an internal memory bit Read-Write Access an internal memory bit Read-Write Access an internal memory byte Read-Write Access an internal memory byte Read-Write Access an internal memory WORD Read-Write Access an internal memory WORD Read-Write Access an internal memory DWORD Read-Write MatrikonOPC Server for Siemens PLCs v1. MD0 : MDn [DWord] n is the max internal memory DWORD offset.: M8. usually. M0.7 [Boolean] (*) n is the max discrete output offset.g.g. Analog Inputs Give read access to the CPU image of the analog inputs.g. e. MB0 : MBn [Byte] n is the max internal memory byte offset. AD0 : ADn [DWord] n is the max discrete output DWORD offset.3.0 : Fn. e.: QW8 accesses a WORD at offset 8. used in intermediate binary or digital operation. AB0 : ABn [Byte] n is the max discrete output byte offset.0 : An.g. MW0 : MWn [Word] n is the max internal memory WORD offset. Analog Outputs Give read access to the CPU image of the analog outputs. AW0 : AWn [Word] n is the max discrete output WORD offset.7 [Boolean] (*) n is the max internal memory offset. e.: PQW8 accesses a WORD at offset 8. e.3 accesses bit 3 at offset 8.g.: AD8 accesses a DWORD at offset 8.: MD8 accesses a DWORD at offset 8.Discrete Outputs Give access to the CPU image of the discrete outputs. QD0 : QDn [DWord] n is the max discrete output DWORD offset.: AB8 accesses a byte at offset 8. e. : VW8 accesses a WORD at offset 8. C0 : Cn [Word] (*) n is the max counter offset.g.: S8. e. Counter Values Give access to program counters. e.7 [Boolean] (*) n is the max special memory offset. SMW0 : SMWn [Word] n is the max special memory WORD offset. MR0 : MRn [Real] n is the max internal memory REAL offset. V0.g.: T8 accesses timer at offset 8. e. T0 : Tn [DWord] (*) n is the max timer offset.: SM8.Timer Values Give access to program timers.: C8 accesses counter at offset 8.g.: FR8 accesses a REAL at offset 8.g.3. e.g.3 accesses bit 3 at offset 8. e.g.g. e. e. e.0 : Vn. e.g.: V8.: VD8 accesses a DWORD at offset 8. Access a Sequence Control Relay byte Read-Write Access a Sequence Control Relay WORD Read-Write MatrikonOPC Server for Siemens PLCs v1.: SMB8 accesses a byte at offset 8.g.: SW8 accesses a WORD at offset 8.g.g. e.7 [Boolean] (*) n is the max data block variable offset. e.g. e. SB0 : SBn [Byte] n is the max special memory byte offset. SMD0 : SMDn [DWord] n is the max special memory DWORD offset.: Z8 accesses counter at offset 8. VD0 : VDn [DWord] n is the max data block variable DWORD offset. e. Z0 : Zn [Word] (*) n is the max counter offset. S0. FD0 : FDn [DWord] n is the max internal memory DWORD offset. Access an internal memory DWORD Read-Write Access an internal memory REAL Read-Write Access an internal memory REAL Read-Write Access a timer value as DWORD Read Access a counter value as WORD Read-Write Access a counter value as WORD Read-Write Access a data block bit Read-Write Access a data block byte Read-Write Access a data block WORD Read-Write Access a data block DWORD Read-Write Read-Write Access a special memory bit (Bytes from 0 to 29 included are read-only) Read-Write (Bytes from 0 to 29 included are read-only) Read-Write (Bytes from 0 to 29 included are read-only) Read-Write (Bytes from 0 to 29 included are read-only) Read-Write Access a special memory byte Special Memory Provides access to some system status and configuration information (Bytes from 0 to 29 included are read-only) Access a special memory WORD Access a special memory DWORD Access a Sequence Control Relay bit Sequence Control Relay Provides access to sequence control relay. SM0.0 : SMn.: SMD8 accesses a DWORD at offset 8.0 User’s Manual 92 .0 : Sn.g. e.7 [Boolean] (*) n is the max special memory offset.: VB8 accesses a byte at offset 8. FR0 : FRn [Real] n is the max internal memory REAL offset.g.3 accesses bit 3 at offset 8. e. SMB0 : SMBn [Byte] n is the max special memory byte offset.: MR8 accesses a REAL at offset 8. VB0 : VBn [Byte] n is the max data block variable byte offset. SW0 : SWn [Word] n is the max special memory WORD offset.g. Data block variables Give access to data block variables configured using STEP 7 MicroWIN.g. VW0 : VWn [Word] n is the max data block variable WORD offset.g. e.3 accesses bit 3 at offset 8.: SB8 accesses a byte at offset 8.: SMW8 accesses a WORD at offset 8. e.: FD8 accesses a DWORD at offset 8. SHORT and LONG Conversion To access a WORD as a signed 2-byte integer (SHORT). For example.0 User’s Manual 93 . Memory areas and data block types which do not support arrays are marked with an asterisk (*) in Table 41 and Table 44. so writing to MW0 will also modify the value in MW1. For example. For example. Words MW0. DWORD.High-Speed Counter Give access to high speed counters. Consequently.: HC8 accesses high speed counter at offset 8. Words MW0 and MW1 for example. Similarly. MW2 and MW4 do not overlap. MatrikonOPC Server for Siemens PLCs v1. For example. overlap at byte 1. Array Syntax The valid syntax for accessing a memory area or a data block variable as an array is: [Tag Syntax][Row][Col] Where Row is the number of rows and Col is the number of columns. to convert MW0 to its BCD representation the syntax is: MW0:BCD Please note that if the WORD or DWORD contains an invalid BCD digit (greater than 9). just replace the D in the syntax by L. e. The syntax which should be used when writing to an array item is specific to the OPC client used to access the item. E/Q and M/F. For example. each array element will be represented by an individual OPC item. when the number of rows is not specified. For example. typing MB0[5] is equivalent to MB0[1][5]. to access a two-dimensional Data Block INT array located in DB # 1 at address 282: DB1:INT:282[2][2] Row count of 1 is assumed.: SD8 accesses a DWORD at offset 8. just append the BCD suffix to the syntax. HC0 : HCn [DWord] (*) n is the max high speed counter offset. typing MB0[5][1] is not allowed. i.g.e. arrays are automatically resolved. just replace the W in the syntax by S. When importing data block symbols from STEP 7 project.g. to access an internal memory WORD at offset 16 as a SHORT the syntax is: MS16 To access a DWORD as a signed 4-byte integer (LONG). SD0 : SDn [DWord] n is the max special memory DWORD offset. to access an internal memory DWORD at offset 16 as a LONG the syntax is: ML16 BCD Conversion To interpret a WORD or DWORD as a BCD number. each address starts at a byte offset within the device.3. For example. Overlapping can be prevented by carefully selecting your offsets for these types. Short and Long types can also overlap. the digit will be truncated to 9 and the OPC item will have a bad quality. e. Access a Sequence Control Relay DWORD Read-Write Access a high speed counter as DWORD Read Table 44 .S7 200 Tag Syntax Description Note: For E/I. Column count of 1 with Row count different than 1 is not accepted. if a symbol called Zone1.Array Elements Length Control Items The MatrikonOPC Server for Siemens PLCs supplies control items to allow a connected OPC client to obtain status information by reading values and manipulating its operation by simply writing values.MD4.TMPARRAY_INT_292(2.MD8 and MD12. For example.TMPARRAY_INT_292(2. the element offsets depend on the element data types. the syntax is: MB{Element Offset} (offsets are zero based) Element Offset = {Array offset} + (Element Position -1) * {Element Length} Element Offset = 152 + (3-1) * 1 byte The syntax to use is then: MB154 Table 45 lists the length for each array element type: Element Type BOOL BYTE CHAR DATE INT S5TIME DINT DWORD REAL TIME TIME OF DAY DATE AND TIME Length 1 1 1 2 2 2 4 4 4 4 4 8 Table 45 .2) When accessing an array. Siemens TCP/IP Channel Level Control Items The OPC Server for Siemens PLCs supplies control items listed in Table 46. MW4 and MW6 and reading MD0[4] will return MD0. all needed is the array offset and the element data type in order to access the element.For example. For example. the following OPC items will be created: Zone1.1) Zone1.3.2) Zone1.TMPARRAY_INT_292(1. reading MW0[4] will return MW0. MW2.TMPARRAY_INT_292(1. To access a one-dimensional array element by address. Item ID $Connected Description Indicates whether the Siemens TCP/IP Channel is able to connect Default FALSE 94 MatrikonOPC Server for Siemens PLCs v1. to access the third element in an array of MB (bytes) which starts at offset 152.1) Zone1.0 User’s Manual .TMPARRAY_INT_292 has been imported for an array of INT which starts at offset 292 and has a dimension 2x2. The Registry Editor screen appears. Stop the OPC server. Set to TRUE when the PLC is in “Stop” mode and FALSE when in “Run” mode. or false to force a disconnection (automatic reconnection will be attempted as long as it is enabled). Enable/disable Network Device Link. or false to force a disconnection (automatic re-connection will be attempted as long as it is enabled). When the write is enabled.OPC. Default $Enabled $ResetStats Enable/disable Siemens TCP/IP Channel. 2. Write a Boolean true to force a connection. In the following key: HKEY_CLASSES_ROOT\Matrikon. From the Start menu. Start the OPC server. When the write is enabled. Close the Registry Editor. Click on the OK button. 4. MatrikonOPC Server for Siemens PLCs v1. Table 47 . as well as all of the underlying connections. 7.Siemens TCP/IP Channel Control Items FALSE FALSE Connections Control Items The OPC Server for Siemens PLCs supplies control items listed in Table 47.3.0 User’s Manual 95 . Writing any value to this item will trigger the OPC Communication statistics for the connection to be reinitialized.Item ID Description underlying devices to the Ethernet network. to be reinitialized.1. Set to TRUE when the PLC is in “Run” mode and FALSE when in “Stop” mode. Item ID $Connected $Enabled $ResetStats $StopPLC (Only used with ISO on TCP connection) Description Indicates whether the host has established a connection with the end-device. or press the Enter key on your keyboard. set the WriteRunStop value to 1.Connections Control Items Default FALSE FALSE FALSE FALSE $RunPLC (Only used with ISO on TCP connection) FALSE Enabling Write to $StopPLC and $RunPLC Control Items For security reasons. 5. writing TRUE to this control item will attempt to place the S7 PLC in the RUN mode.SiemensPLC. write to $StopPLC and $RunPLC is disabled by default. To enable write to these control items: 1. Write a Boolean true to force a connection. writing TRUE to this control item will attempt to place the S7 PLC in STOP mode. click on Run and then type regedit 3. 6. Writing any value to this item triggers the OPC Communication statistics for the Siemens TCP/IP Channel. Table 46 . refer to Appendix G . Typically True indicates that a connection of an end device has been established. For more information.Security. the server no longer applies tag security configuration changes while the server is running. Field #Enabled Description This is a Boolean OPC tag which indicates whether or not the Device Link to which it belongs is enabled. Adding this item allows an OPC client to monitor the offline mode for that location using read operations and provide the ability to toggle offline mode for that location using write operations. A numbered list of device links to which the Redundancy Group device link is subscribed.Redundancy Device Link OPC Items #Manual Device Link @Active Device Link @Redundancy Group Table 51 describes the statistical and control items available for the Server Status List device link.The MatrikonOPC Server Framework creates a number of standard data items which can be used for monitoring and controlling certain behaviour.Offline Mode. Table 50 . By adding this item to an OPC group and writing a value of False to this item.3. of the device links to which the Redundancy Group is subscribed. MatrikonOPC Server for Siemens PLCs v1. If the value is True or a value of True is written to this item then the Device Link is enabled. refer to Appendix F . This is a read-only string item which lists the name of every client currently connected to the OPC server. whether or not it is available. is forced to be active. The server would need to be stopped and restarted for the changes to take effect.Server Data Items #MonitorACLFile @Clients Table 50 describes the statistical and control items available for the Redundancy Group device link. Field Description This is a Boolean OPC tag that has a default value of True when the server starts which indicates that the tag security permissions are monitored and applied while the server is running. This is a Boolean OPC tag which indicates whether or not the Device Link is connected to its resources. Table 48 describes the standard items available for most device links. Table 48 .Standard Data Items #OfflineMode @Connected Table 49 describes the standard items available for at the root branch of the server browse tree. The current active device link. Clear the value of this control item in order to allow the OPC server to decide which of the subscribed device links should be active. which will be the highest-priority of the available device links on the Redundancy Group device link‟s subscription list. Field Description Write to this control item to indicate which device link. For more information. Table 49 . according to their configured priorities and availabilities.0 User’s Manual 96 . They are ordered from highest to lowest priority. This is useful if you wish to test an HMI or other OPC client without worrying about the connection to the device. as entered in the Server Status List device link‟s subscription list. or the quality of the data provided. or No Configuration (if the monitor list is empty).Field @Monitor List Description A numbered list of the device links being monitored by the Server Status List device link. which allows OPC clients to obtain changing good quality data without being connected to a device. refer to Appendix G .0 User’s Manual 97 . For more information.Offline Mode. The status options are: Running. Failed.Server Status List Device Link OPC Items @Server Status Getting Data without Being Connected to a Device The MatrikonOPC Server Framework supports “offline mode”. Indicates the customized status of the server based on the settings for the Server Status List device link. MatrikonOPC Server for Siemens PLCs v1. The full path of the device link is provided. Table 51 .3. MatrikonOPC Sniffer is a utility used to troubleshoot OPC client/server interoperability issues. the server logs all errors and other information of immediate importance to the user at the low detail level. Item ID #Sent Description Cumulative total of the number of messages sent by the server to all underlying connections.0 User’s Manual 98 . Logging All MatrikonOPC servers produce log files that record errors and debugging information. Contact MatrikonOPC support for further instructions on how to enable the higher log levels and console logging. It is useful for troubleshooting problems with configuration and device communication. It enhances the Interface Activity Logging by recording the client-side transactions. It is recommended that the log level be left at the default. For General logging. it is important to note that the default log level is set to low. It can also be used with other OPC servers. As such. MatrikonOPC Sniffer is a useful tool for logging OPC client/server communication.3. The log files can be extremely valuable for troubleshooting. all warnings and other information of moderate importance to the user at a medium detail level. the higher the log level. the log level can be considered very high and therefore should never be used during normal operation of the OPC server unless specifically working on problems related to interfacing. Siemens TCP/IP Channel Communication Statistics The OPC Server for Siemens PLCs supplies statistical items listed in Table 52. 0 Default MatrikonOPC Server for Siemens PLCs v1. For Interface logging. or use the following link to access the Matrikon Sniffer Download. However. General Activity Logging records information about the internal workings of the OPC server. the slower the performance of the server. More log levels are available for both types of logging which record more detailed information. The server also logs further information of concern to support personnel at the debug log level. as well as the ability to output log statements to a console window at run time. It is useful for troubleshooting compliance issues. unless troubleshooting needs to be performed. Note: The higher the log level. Interface Activity Logging records information about the client/server OPC communication. In general. and additional information concerning the normal functioning of the software at a high detail level.Diagnostics The server supplies diagnostic information to assist operators and support personnel with troubleshooting communication problems and software faults. the more information that is recorded. Contact the MatrikonOPC Sales department for further information about this product. The General Logging tab of the Options dialogue in the main configuration window contains settings to control server logging. Statistical Items The server supplies statistical information pertaining to communication in the form of real-time data items for the Network Device Link and each connection. server performance may decrease at higher log levels. The recommended operating level is Medium. Item ID #Received #Retried #Failure #Overrun #Timeout #Latency Description Cumulative total of the number of expected responses received by the server from all underlying connections. Total time (in milliseconds) taken to complete the last successful request/reply transaction. Cumulative total of the number of retry messages sent by the server to all underlying connections. Table 53 . Cumulative total of the timeout occurrences for all underlying connections. Cumulative total of the overrun occurrences for all underlying connections. Total time (in milliseconds) taken to complete the last successful request/reply transaction all underlying connections. Total number of messages sent again as a retry..0 User’s Manual 99 .3. Total number of times communication has failed (i.Siemens TCP/IP Channel Statistical Items Default 0 0 0 0 0 0 Connections Communication Statistics The OPC Server for Siemens PLCs supplies statistical items listed in Table 53. run out of retries). Total number of times that a scheduled poll has come due a second time before it has yet been sent and cleared from the “due” list. Item ID #Sent #Received #Retried #Failure #Overrun #Timeout #Latency Description Total number of messages sent. Cumulative total of the communication failures occurrences for all underlying connections. Total number of communication timeouts that have occurred.e.Connections Statistical Items Default 0 0 0 0 0 0 0 MatrikonOPC Server for Siemens PLCs v1. Table 52 . Total number of expected responses received. Limitations MatrikonOPC Server for Siemens PLCs has no known or expected limitations.0 User’s Manual 100 . Refer to the MatrikonOPC Server for Siemens PLCs Release Notes for known issues. MatrikonOPC Server for Siemens PLCs v1.3. Logged in as Administrator to run install Problem: Solution: Why do I need to be logged in as an Administrator to run the install? For MatrikonOPC software to install correctly. and place them in C:\WINDOWS\system32.0 User’s Manual 101 . you must be logged in as a user with access to the registry.exe. Server stops updating client with item values after two hours Problem: Solution: The server stops updating the client with item values after two hours. download these files. and remove the file called aprxdist. the install must be able to access the C:\WINDOWS\system32 directory to add. If it is. PSTCFG error Problem: Solution: After my OPC server died. or the software license has expired. Problems and Solutions “aprxdist” error on install Problem: Solution: What is this “aprxdist” error on install? For our installations to work correctly. Check that the correct HASP hardware key is securely fastened to the parallel port. the installation will not be able to register the software correctly. Click on the Check Licenses button to see the status of all MatrikonOPC product licenses.Troubleshooting This section is intended to assist you by providing licensing information and MatrikonOPC Support contact information. we will see this error on Windows 2003 SP1 system where this is not possible. and rerun the install. If you are not an Administrator on the system. Alternatively. use. Please check the following Problems/Solutions and Questions/Answers sections before contacting the MatrikonOPC Support team. You will need to kill the configuration and restart the server. Also addressed here are some of the most common problems encountered.exe and add the file opcenum. The server may be licensed with a hardware key and the hardware key may not be properly detected. To resolve the issue. and questions asked. MatrikonOPC Server for Siemens PLCs v1. when you attempt to access the Configuration screen to do anything to your configuration items (add. you will experience access violations. while using this OPC server. I tried to access the Configuration screen and now I am experiencing access violations and PSTCFG errors. Generally. and so on).3. If your OPC server process stops and you leave the PSTCFG running. try running the MatrikonOPC Licensing utility from the shortcut menu. change. delete. run the HINSTALL program that is located in the Program Files\Common Files\MatrikonOPC\Common directory. Click on the CLSID branch. under HKEY_CLASSES_ROOT.1).g.Simulation. 3. look for the required program ID (e. Figure 60 . Matrikon. This is standard behaviour for COM servers. The evaluation period for the license has expired.Registry Editor 4. enter REGEDIT. this behaviour can be overridden as shown in the following example: Note: Microsoft highly recommends that you back up the registry before editing it or making changes to it. 1.0 User’s Manual 102 . 2.Server stops updating client with item values after 30 days Problem: Solution: The server stops updating the client with item values after 30 days. Server shuts down after five minutes when no clients connected Problem: Solution: The server automatically shuts down after five minutes when there are no clients connected. However. From the Run command. 5. MatrikonOPC Server for Siemens PLCs v1..3. Please contact MatrikonOPC Support.OPC. The Registry Editor (Figure 60) is launched. In the Registry Editor. Expand the program ID branch. The server provides a global parameter for configuring an escape character.. so cannot configure item options Problem: Solution: The OPC client does not provide a means to configure access paths.0 User’s Manual 103 .. Create a string value called LockServer in the Options branch underneath the GUID (e. Under the HKEY_CLASSES_ROOT\CLSID branch. 11. Set the value of the LockServer entry to 1. Cannot configure client access paths. HKEY_CLASSES_ROOT\CLSID\{024C7FFC-9CC3-476f-867ABC3CAD79F4FE}\Options). Record the global universal ID (GUID). Create a new value using the context menu and choose New String Value from the menu.Program ID Branch 7. 9. 10. making it difficult to correctly specify the data acquisition options for the items. Note: To edit the value. search for the GUID retrieved in the previous step (e.3.g. HKEY_CLASSES_ROOT\CLSID\{024C7FFC-9CC3-476f-867ABC3CAD79F4FE}).6. 8.g. to allow users to append communication options to the end of an item ID which would MatrikonOPC Server for Siemens PLCs v1. Figure 61 . Shut down the server and restart it for the change to take effect. select the entry and select the Modify menu option from the Edit menu. Under the HKEY_CLASSES_ROOT\CLSID branch. select the entry and select the Modify menu option from the Edit menu. Click on the CLSID branch. HASP keys from the same vendor cannot be chained together. Configure the ItemIDEscapeCharacter Item ID in the OPC client with the access path appended to the end with the configured escape character (e. ITEMID|ACCESSPATH). in the Tool MatrikonOPC Server for Siemens PLCs v1.g. HKEY_CLASSES_ROOT\CLSID\{024C7FFC9CC3-476f-867A-BC3CAD79F4FE}\Options).g. 2. 10.0 User’s Manual 104 .accommodate clients that do not support access paths. but only first one is recognized Problem: Solution: There is more than one HASP hardware key from Matrikon attached to the parallel port. Note: To create a new value. such as “|” (pipe). Record the global universal ID (GUID). 9. but the software recognizes only the first one. 5. Create a string value called ItemIDEscapeCharacter in the Options branch underneath the GUID (e. use the context menu and select the New String Value menu option. HKEY_CLASSES_ROOT\CLSID\{024C7FFC-9CC3-476f-867ABC3CAD79F4FE}). enter REGEDIT. Send an email to the MatrikonOPC Support team to obtain a HASP key containing the combined codes of all installed MatrikonOPC servers. In the Registry Editor.. Note: To edit the value.g. look for the required program ID (e. More than one HASP attached to parallel port. search for the GUID retrieved in the previous step (e. Set the value of ItemIDEscapeCharacter to a single character.Simulation.3. Perform the following steps as shown (with example) below: Note: Microsoft highly recommends that you back up the registry before editing it or making changes to it..OPC. 1. Server cannot be configured. 6. 4. 11. Expand the program ID branch.. Shut down the server and restart it for the change to take effect. The Registry Editor is launched. Matrikon.g. 3. From the Run command. under HKEY_CLASSES_ROOT. 7.. no Matrikon logo in Tool Tray Problem: The server cannot be configured because there is no Matrikon logo Tray. 8.1). Check the object configuration (for more information.Solution: If the server is running as a service. MatrikonOPC Server for Siemens PLCs v1. Note: If the server configuration utility generates an “access denied” error on launch. Server does not show up as remote program in OPC client application Problem: Solution: The OPC server does not show up in a list of remotely available program IDs in my OPC client application. DCOM permissions are configured properly. Ensure OPCEnum is registered as a service. Also. Under the General tab. OPC client unable to create or read items under configured object (device) Problem: Solution: The OPC client is unable to create or read items under a configured object (device). and the OPCEnum service is running. choose Options from the View menu. ensure that the Load configuration on start-up checkbox is selected and that the correct file name appears in the edit box (see General Options). especially for older OPC clients that do not use the OPC server browser. Microsoft Internet Explorer 4. Server does not retain settings Problem: Solution: The server does not retain its previous settings and needs to be reconfigured each time it starts up. Server does not show up in the list of locally available program IDs in OPC client application Problem: Solution: The server does not show up in a list of locally available program IDs in the OPC client application. Ensure the Enabled checkbox is selected.0 User’s Manual 105 . Server cannot save configuration in XML format Problem: Solution: The OPC server cannot save the configuration in XML format. start the configuration utility by using the shortcut to the OPC server in the Windows Start menu (this shortcut starts the Configuration utility as well as the OPC server). To configure the server. the Matrikon logo does not appear in the Tool Tray.01 (or later) must be installed to use the XML format. Make sure that a user with local administrative rights installs the OPC server so that it can create the necessary entries in the registry. the DCOM permissions have not been configured properly. In the Configuration window. refer to Server Configuration). make sure the client is running as a user that has read access to the registry. Follow the steps found in Appendix A – Distributed COM (DCOM) to copy the program ID from the server machine to the client machine.3. Use the Start -> Run with command CMD to bring up a command window and type: Ping ipaddress ( e. Ensure that the access and launch permissions for the OPC server are set correctly on the server machine.0.g. Trouble communicating through a network Problem: Solution: Experiencing problems communicating to the product‟s device through a network. or consider running the server as a service. For more information..0. refer to Appendix A – Distributed COM (DCOM).1: bytes=32 time<10ms TTL=128 MatrikonOPC Server for Siemens PLCs v1. Solution: DA 2. It is recommended that you not set the value lower than 100.1 with 32 bytes of data: Reply from 127.0. DA 2. Ensure that the access and launch permissions for the OPC server are set correctly.1 Pinging 127. refer to Appendix A – Distributed COM (DCOM). About screen and Configuration window do not show up Problem: The About screen and Configuration window do not show up when a remotely connecting client or a client that runs as a service (such as the Aspen Technologies CIMIO OPC Manager) tries to launch the OPC server. C:\temp>ping 127.05 asynchronous I/O does not work Problem: Solution: After installing an older OPC server. using an up-to-date installation program or re-register them using the REGSVR32 command-line utility (refer to the OPC Compliance . The old installation program installed and registered its own (older) version of the OPC proxy/stub DLL. For more information. For more information.0. or the server does not start up.0. refer to Appendix A – Distributed COM (DCOM). Either set the identity for the OPC server to the interactive user. Make sure users can ping the device. Check the server‟s Time Granularity settings in the servers Advanced Options.0.Installation section in this manual).Access denied or time-out error when connecting to remove server via DCOM Problem: Solution: Access Denied error message appears. Server is using a large portion of CPU resources Problem: Solution: Server is using 99% of CPU resources. Reinstall the standard OPC proxy/stub DLLs. Server does not start up or client cannot connect Problem: Solution: A client tries to connect to the server and fails.3.05 asynchronous I/O no longer works.0 User’s Manual 106 . or time out occurs when trying to connect to a remote OPC server via DCOM.0.0.1: bytes=32 time<10ms TTL=128 Reply from 127. Ensure the granularity is not set to 0. Only one OP or PG/PC connection is typically available in S7 300/400. Make sure that all of the Alias Groups are set to have events enabled. the import fails.0.g. Cannot write to discrete inputs Problem: Solution: Cannot write to some discrete inputs. Average = 0ms) Where ipaddress is the IP address of the user‟s <System X> device. If the S7P file is currently open in Step 7. Cannot import symbols from S7P file Problem: Solution: When trying to import symbols from an S7P file. but a subscribed A&E client is not receiving events as expected. Events are not being generated Problem: Solution: Aliases have been configured to generate events. Cannot read a peripheral input/output Problem: Cannot read a peripheral input/output.0.1: bytes=32 time<10ms TTL=128 Reply from 127. For example. then IB4 and IB5 become read-only.0 User’s Manual . Make sure the type of connection is not taken by another software configuration. It is possible to disable event generation at the Alias Group level. if a signal module (e. use the STEP 7 MicroWIN Ethernet wizard to create more Ethernet connections. Received = 4. importing symbols will fail.0. write is not allowed to it. 107 MatrikonOPC Server for Siemens PLCs v1. You must shut down Step 7 to free up the S7P file for use by our server. Note: Refer to the DCOM Manual to further diagnose any DCOM issues.0. 6ES7 321-1BH02-0AA0) has been assigned an address range from 4 through 5. Lost = 0 (0% loss). Maximum = 0ms. Only one PG connection is available in S7 200.0. If it says “no response”.. Approximate round trip times in milli-seconds: Minimum = 0ms. When a discrete input is mapped to a physical signal (I/O) module. Verify that the IP address entered for the PLC is correct. use the recommended (PLC) type of connection.0.Reply from 127.3. Please refer to the SIMATIC STEP 7 project used to configure the PLC in order to retrieve addresses which have been assigned to signal modules. Cannot connect to PLC Problem: Solution: Cannot connect to S7 PLC.1: bytes=32 time<10ms TTL=128 Ping statistics for 127.1: Packets: Sent = 4. then there are likely network issues between user‟s computer and the product. which will leave a 1. In binary. if the bit in position 3 is a 1. users must use the AND operator. users will have to apply a mask to the value. or VB Script? Use the MatrikonOPC Automation Component to create a Visual Basic script that connects to a server. or another application with support for Visual Basic. 0 AND 1 = 0. Questions and Answers How do I remove the server as a service? Problem: Solution: How do I remove the server as a service? Re-register the OPC server executable using the /REGSERVER command-line switch. and receives data change updates. Does the server need to be started manually when installed as a service? Problem: Solution: Does the server need to be started manually when it is installed as a service? No. users would configure an alias to use the IF operator. since 1 AND 1 =1. To do this in an OPC server. Visual Basic.Solution: The exact physical address assigned to this module needs to be used when accessing a peripheral input/output. VBA. MatrikonOPC Server for Siemens PLCs v1. the first OPC client that tries to connect will start the OPC server. How can I access individual bits from an integer item? Problem: Solution: How can I access individual bits from an integer item? In order to do this. which will null all of the bits in the integer value except the one that users want to keep. where the user wishes to access the third bit in the integer. this is the number 4 (0100). 0110 1100 + 0000 0100 = 0000 0100 Data bit we want to access In decimal notation. With the example above. both the bits in that position are 1. which is a 0.0 User’s Manual 108 . Contact Support for examples of how to do this in Excel. creates groups and items. the IF statement would return a false value. 1. 0) Therefore.3. If the bit in position is 0. or an HTML document. they would have to apply a mask that is in binary which will only have the third bit present. the statement would appear as: IF (INPUT AND 4 = 4. the IF statement would be true and would return a 1. How can I get OPC data into other applications? Problem: Solution: How can I get OPC data into Microsoft Excel. For example. Microsoft Word. if the user wanted to isolate the third bit. if and only if. this would be expressed as 108 AND 4 = 4. To apply the mask. Email). Licensing Q&A and Troubleshooting.g. The MatrikonOPC Server for Siemens PLCs supports software licensing only.MatrikonOPC Support Regional Contact Information For after-hours support in all regions. or send an email (
[email protected]) is available 24 hours a day.opcsupport. please contact your MatrikonOPC Account Manager.com to find the answers to other commonly-asked MatrikonOPC Server for Siemens PLCs questions.3. is delivered with only a 30-day demo. seven days a week. Region North America UTC/GMT -7 hours (MST) Europe /Africa * UTC/GMT +1 hours (CET) Australia/Asia * UTC/GMT +10 hours (AEST) Office Hours 8:00 am-5:00 pm 9:00 am-5:00 pm 9:00 am-5:00 pm Contact Information +1-877-OPC-4-ALL +49-221-969-77-0 (Request OPC Support) +61-2-4908-2198 (Request OPC Support) * Toll-free regional numbers coming soon! Table 54 . There is no extra charge from MatrikonOPC for calling their after-hours support numbers. contact MatrikonOPC Support using the regional phone numbers provided in Table 54.. Information about the MatrikonOPC Licensing Utility that is used to license driver software. IMPORTANT TO NOTE: The following licensing information is described in detail within the Licensing Procedures document which accompanies the MatrikonOPC Server for Siemens PLCs software and User’s Manual: Software key licensing information. please use either of the following numbers. Note: Alias Events needs to be licensed separately.com).opcsupport. Contact MatrikonOPC Support using the information below. For Monday to Friday daytime support requests. Internet Connection. and by default.0 User’s Manual Contact Information +1-780-231-9480 109 . Licensing Most MatrikonOPC products require that some form of licensing criteria be met for it to function correctly. Web Page. To purchase a full Alias Events license. and the variety of ways in which licenses can be obtained (e. Contacting Support The MatrikonOPC Customer Services department (www.Search the MatrikonOPC Support Knowledge Base at www. Region All MatrikonOPC Server for Siemens PLCs v1. After-Hours Support MatrikonOPC Server for Siemens PLCs v1.3.Region Contact Information +1-780-264-6714 Table 55 .0 User’s Manual 110 . view the documents listed below (as well as other OPC Specifications) at http://www.00 Installation The server is by default installed as a local out-of-process COM server and enters its registration information in the Windows registry when instructed to do so with the /REGSERVER commandline option.00 OPC Historical Data Access Specification 1. Globally unique application ID (e. The server allows the client to set the client name for each connection.opcfoundation. 2424489F-0492-4b6b-A57C-7791E0EED2C0).05a OPC Data Access Specification 3. OPC Data Access Server 2. The server removes its registration information from the Windows registry when commanded to do so with the /UNREGSERVER command-line option.2 OPC Alarms and Events Specification 1. The server supports the shutdown event notification client-side interface. Full path of 32-bit local server executable.1.OPC.g.OPC.0 OPC Data Access Specification 2.org.0 OPC Common Definitions and Interfaces 1. Version-specific program ID is Matrikon. Common Interfaces The server supports the mandatory functionality specified in OPC Common Definitions and Interfaces.10 OPC Security 1. Version-independent program ID is Matrikon.0 User’s Manual 111 .00 implemented component categories. 19DDB075-33B1-4fbc-A4F0-85A55D81FFEB).OPC Compliance For more information on OPC.05a and 3. Data Access The server supports the mandatory functionality specified in the OPC Data Access Custom Interface Standard. OPC sub-key and vendor information string. MatrikonOPC supports the following interfaces: OPC Overview 1..g.3. MatrikonOPC Server for Siemens PLCs v1. The server supports the following locales for result code translation: US English (0x0409) System default (0x0800) User default (0x0400) Neutral (0x0000). The server installs itself as a Windows service and enters its registration information in the Windows registry when instructed to do so with the /SERVICE command-line option.SiemensPLC.SiemensPLC. Globally unique class ID number (e.. Browsing and Item Properties The server supports address space browsing. The server allows the client to manage item configuration. and validation of items in a group. and timestamp Canonical data type Access rights Scan rate I/O Operations The server supports synchronous I/O operations. removal. removal. Active state Requested data type Dead-band (percent of analog item high-low range) Sampling rate Buffer values (used only when sampling rate is enabled and is sampling faster than the group update rate). Read item values from device.3. The server allows the client to manage group state.0 User’s Manual 112 . Hierarchical address space Simulate flat address space Branch/leaf name filter (pattern matching) Item data type filter Item access rights filter The server supports the following mandatory item properties. and cloning of private groups. Write control values to items (on device). quality.Groups The server supports the addition. Read items without adding the item to an OPC group. Name Active state Update rate (100 millisecond resolution) Time bias Dead-band (percent of analog item high-low range) Items The server supports the addition. MatrikonOPC Server for Siemens PLCs v1. Read items value from device based on how old the cache items value is. Read active item values from cache. Value. Write control value. Data change or dead-band exceeded – data with timestamps. Write control values without adding the item to an OPC group. and/or timestamp to items (if the server supports such features). The server supports the data change event notification client-side interface as defined for DA 3. Data change or dead-band exceeded. Write control values to items (on device). Cancel outstanding operations.00. Write control value.05a. The server supports the data change event notification client-side interface as defined for DA 2. Refresh active items from cache. Asynchronous write operation complete.0. Read items values from device. Asynchronous read operation complete. The server supports asynchronous I/O operations as defined for DA 2. Asynchronous refresh operation complete.0 User’s Manual 113 . and/or timestamp (if the server supports such feature).05a. The server supports asynchronous I/O operations as defined for DA 1. Read items values from cache. quality.00. Asynchronous operation cancellation complete. Read items value from device based on how old the cache items value is.0. The server supports the data change event notification client-side interface as defined for DA 1. MatrikonOPC Server for Siemens PLCs v1. Cancel outstanding operations. Read items value from device. Keep-alive call-back indicating server is alive. Data change or dead-band exceeded – data without timestamps. quality. Refresh active items from cache. Enable/disable event notifications. Asynchronous write operation complete. Write control values to items (on device). The server supports asynchronous I/O operations as defined for DA 3.3. Appendix A Distributed COM (DCOM) DCOM is an object protocol that enables COM components (such as OPC clients and servers) to communicate directly with each other across a network. Answer. Information regarding Distributed COM and various links to related sites. Readers should be familiar with DCOM and with Windows 2000 security features and security administration.3. First of all. In general. server processes must be shut down and re-started for these changes to take effect. please refer to the MatrikonOPC Online Support page on DCOM Settings.com/com/default. each packet. specifications.microsoft. especially between different domains. it should be set to Connect. Note: DCOM settings are stored in the registry and loaded by COM (and OPC) servers at start-up. ensure that the Enable Distributed COM on this computer is selected in so that the machine is available to others via DCOM. DCOM Configuration Utility Start the DCOM configuration utility either from the server configuration utility or from the command-line (DCOMCNFG). Select the Enable COM Internet Services on this computer to allow DCOM access to the machine from the Internet (check with your administrator). Default Properties The Default Properties tab contains settings that affect all DCOM communication on the machine. The steps provided in this appendix apply to Windows NT operating systems only. then COM performs no authentication and ignores any access permission settings. Notes: The following steps are suggestions only. For information on how to configure DCOM settings for newer Windows operating systems. The former will affect all servers configured to use the default settings.0 User’s Manual 114 . A certain amount of configuration is required on the system where the OPC server is installed to allow remote clients to connect to it over the network. The Authentication Level specifies when COM should authenticate the identity of calling clients (each call. Therefore. indicating that COM should authenticate clients when they first connect to a server. the other settings do not need to be changed. and so on. Ask your Windows Network Administrator for more information about the settings that you should use.mspx. The main window for DCOMCNFG allows the user to either configure default settings for all COM servers or else to configure settings for a specific server chosen from the list. The latter will affect the selected server only. white papers. MatrikonOPC Server for Siemens PLCs v1. can be found at http://www. If it is set to None. Normally. yes to any message boxes that appear (allowing the utility to assign application ID entries to those servers that do not already have them). etc). Open the DCOM configuration utility. This setting is not generally required. The Distributed COM Configuration Properties window (Figure 62) appears. Select the Provide additional security for reference tracking to make even the reference counting on COM objects secure. be certain that the access and launch permissions are correct for the server. There are two ways for you to set these: 1. Setting Security Permissions To set the security permissions for an OPC Server: 1. Security Permissions The most important DCOM settings for an OPC server are the security permissions.3. Select the OPC server. 2. Change the specific settings for the server (recommended).0 User’s Manual 115 . 3. 2.The Impersonation Level specifies whether servers can ascertain the identity of calling clients and whether they can then perform operations on the client's behalf (as if the server is the client). Either way. Normally. allowing the server to identify the calling client to see if it is allowed access to a certain resource but not to actually access any of these resources as the client. it should be set to Identify. MatrikonOPC Server for Siemens PLCs v1. and then click Properties. Change the default settings (not recommended) and make sure that the OPC server will use these. Distributed COM Configuration Properties Window 4. 5.3. Click on the Security tab to set the security for the server. The Distributed COM Configuration Security tab (Figure 63) appears.0 User’s Manual 116 . MatrikonOPC Server for Siemens PLCs v1.Figure 62 . 8.Figure 63 . MatrikonOPC Server for Siemens PLCs v1. Include the names of users or user groups from trusted domains that you wish to be able to use the OPC server on this machine. To set the Access permissions.0 User’s Manual 117 . click Use custom access permissions and then click Edit. The Launch Permissions contain an Access Control List of principals that are allowed to start up a server process or service. The Registry Value Permissions window (Figure 64) appears. 6.Distributed COM Configuration Security Tab Notes: The Access Permissions contain an Access Control List of principals that are allowed to interact with objects supplied by a server. 7. Include the Everyone group to allow access to all users on a particular domain.3. The Add Users and Groups window (Figure 65) appears. MatrikonOPC Server for Siemens PLCs v1.Registry Value Permissions Window 9. Figure 65 . and then click Add.Figure 64 . If the user you wish to add does not appear then click Show Users. select the user.0 User’s Manual 118 .Add Users and Groups Window 11. To add users to the list click Add.3. 10. To add a user to the list. one would include the Connection-oriented TCP/IP protocol. It is usually simpler to install and configure servers as a user with local administrative rights. the better the chances of connecting to an OPC server on an unknown remote machine (such as at an OPC Interoperability Workshop). Server Identity The Identity tab for a selected COM (or OPC) server specifies the user account that should be used when COM starts up the process. the server can be set to run as a specified user. MatrikonOPC Server for Siemens PLCs v1. The more protocols that appear in the list. It is usually best to use the interactive user or a specified user. click OK to close the Add Users and Groups window.12. it may also take longer for DCOM to time out if a server machine is not present since it has to try each protocol in turn. However. You can then choose to Allow Access or Deny Access for each user. The order that protocols appear in the list indicates the priority in which they will be used (the topmost having the highest priority). The Configuration Permissions contain an Access Control List of principals that are allowed to modify the configuration information for a server. or a specified user. but instead of choosing Allow Access for a user you would choose Allow Launch. In other words. it indicates who is allowed to alter the registry entries for installed servers as well as who is able to access the registry for the purposes of installing new servers. the interactive user (the one currently logged onto the machine). add the local user on the OPC server to the DCOM permissions. Contact your IT personnel for more information about your network. It also adds a greater degree of security in terms of who is able to shut down the server process.0 User’s Manual 119 . Notes: The procedure to set the launch permissions is similar to the above. it is best to remove all unused protocols from the list and only include those that are necessary for your network. When you are done adding users. To connect to an OPC server from outside of the domain. create a local user account on both the server and the client machine with identical username and password. Servers that run as NT services should generally run as the local System account. For example. although this is usually done from the Service Control Manager applet rather than DCOMCNFG. on a TCP/IP network. The available settings are different for servers that run as local executables as opposed to those that run as NT services. Alternatively. Note: It is strongly recommended that OPC servers should be installed to run as NT services if they are going to be accessed by remote clients via DCOM. Then. This ensures that the server can always be accessed even if no one is presently logged on to the machine. and only one server process ever starts up. Access and Launch permissions are particularly important when installing a server to run as an NT service. 13. Servers that run as local executables have the option of running as the launching user (the calling client–this is the default). Default Protocols The Default Protocols tab specifies the communication protocols available to DCOM.3. remote clients might start up multiple separate server processes that are not accessible to others. Use the local account on the client machine to connect to the OPC server. Otherwise. For most situations. 6. run REGEDIT on the client machine and choose Import Registry File from the Registry menu. Enter a file name. 4.Device. Therefore. This must be done as a user who has write access to the local registry. and then click Save.0 User’s Manual 120 . selecting each file in turn. Merge the REG files into the registry of the client machine. 7. Expand the HKEY_CLASSES_ROOT key. use the following steps to copy a program ID to the client machine. 8. some older OPC clients need to have a program ID in the local registry in order to connect to a particular OPC server. Delete the REG files since they are no longer needed.3. Please check the client documentation for more information. For each program ID. Therefore. OPC client applications had to search the registry to generate a list of available OPC servers. the ID has the form Matrikon. run REGEDIT as a user that has access rights to the local registry. 9. Back up your registry. it is strongly recommended that these protocols be removed from the list of default protocols. 5. Be careful not to overwrite other export files that you are creating. Note: This method may not work for every OPC client. WARNING: Any changes made to the registry must be made with extreme caution! 1. Note: In the case of Matrikon OPC Servers. Find the program ID(s) for the desired OPC server(s). The simplest solution is to install the OPC server software on the client machine even if it is not used. MatrikonOPC Server for Siemens PLCs v1. Some servers may have both a version-specific as well as a version-independent program ID.OPC. Datagram-oriented protocols are not supported under Windows 2000 at all (although the DCOM configuration utility still allows you to configure them). Use REGEDIT to check that the program IDs have in fact. select the key and choose Export Registry File from the Registry menu. been copied. Remote Program ID Before the OPC Server Browser became available. 2. Copy the exported REG files to the client machine. 3. Note: This should simply be a matter of double clicking on the file from the desktop of the client machine. Alternatively. On the server machine. If you quickly type the first few letters then REGEDIT should jump to the location of that key. In this case both IDs should be copied to the client machine.Note: Evidence indicates that there are problems with the datagramoriented protocols (such as UDP/IP) that can cause memory leaks in DCOM. Alternatively. 123. „OK‟. Less or Equal To. Addition (or Append). Converts the numeric value x to text. Divides x by y. May also be used for binary math. copying length characters starting at start. Returns the data type of x as a text description („STRING‟. Unequal To.14 SQRT(16) = 4 DIV(42.#'. Constant Boolean true and false. „BOOLEAN‟. „Bad‟) = „OK‟ (5 > 6) = FALSE TYPEOF(„hello‟) = „STRING‟ = < > <> <= >= Not And Or TIME DATE INT(x) FRAC(x) SQRT(x) DIV(x. or the first letter upper case and the rest lower. Equal To.14) = 0. otherwise returns y.5’ INPUT * 3.14) = 3 FRAC(3. Returns the integer part of x. and Division. Current date as text. Construct „text’ + . Subtraction.* / Description Text value (single quotation marks). length) STR(3. Returns the fractional part of x. start. Returns a sub-string of the x. Returns the square root of x. The incoming value read from OPC. Greater Than.4567) = „123. x. „ERROR‟). y) TRUE FALSE TYPEOF(x) STR(x) UPPER(x) LOWER(x) PRETTY(x) COPY(x.14‟ UPPER(„alarm‟) = „ALARM‟ LOWER(„ALARM‟) = „alarm’ PRETTY(„ALARM‟) = „Alarm’ COPY(„FIDDLE‟. 7) = 6 IF(6 <= 12.Appendix B Aliases Scaling Expressions Alias scaling expressions may use any of the expression constructs listed in Table 56.1415 FORMATNUMERIC(mask. Logical Not. Multiplication.1415 OUTPUT / 3.0 User’s Manual 121 . Logical Or. Converts the text value x to all upper case or lower case letters. 4) = „IDDL’ FORMATNUMERIC('####. Returns x if expression evaluates to TRUE. y) IF(expr. 2. Greater or Equal To. Current time as text. The outgoing value written to OPC. x) INPUT OUTPUT MatrikonOPC Server for Siemens PLCs v1. Less Than. Examples „hello’ „Joe’s Alias’ (3 * 7 + 1) / 8 – 2 „hi’ + „there’ 3<4 (7 >= 3) And (1 <> 0) (12 And 5) = 4 ‘The time is’ + TIME „Today is‟ + DATE INT(3. Converts the numeric value x to text using the format mask. Logical And. „FLOAT. „INTEGER‟.14) = „3.3. the OPC server uses the Alias Subscription Rate to update the OPC item. Advanced alias calculations may use any of the operators listed in Table 57. And logical operator. 0 if false. Construct ! != % & * / ^ | + < <= Description Minus operator. Not equal logical operator. Returns 1 if true. Not logical operator. 0 if false. else returns 0.Construct „text‟ Description Text value (single quotation marks).Reg2] If the OPC item being referenced in a calculation is not found within the servers address space.0 User’s Manual 122 . The only limiting factor may be performance related. Or logical operator.Expressions Constructs for Alias Scaling Advanced Calculations Calculations may contain references to any OPC item in the server‟s syntax. Division operator. To reference another OPC item in the calculation. Returns 1 if true. the server attempts to add it. Lesser than logical operator. x-y -x !x x != y x%y x&y x*y x/y x^y x|y x+y x<y x <= y Examples MatrikonOPC Server for Siemens PLCs v1. Returns 1 if true. Returns 1 if true. Returns 1 if x is 0. Multiplication operator. Examples „hello‟ „Joe‟‟s Alias‟ Table 56 .Reg2 together.Rtu. If successful. The Alias Subscription Rate is configured in the Advanced Options panel. 0 if false. 0 if false. they may not contain references to other alias items. the correct expression would be: [Com1. Addition operator. 0 if false. Unary minus operator. There are no limits on how many items can be used in a calculation. find remainder of the division of x by y. Returns 1 if true.Rtu.3.Rtu. For example to add the items Com1. the alias quality reports Bad.Reg1] + [Com1. bad configuration. Lesser than or equal logical operator. In the event that the server cannot create a subscription to the OPC item.Reg1 and Com1.Rtu. wrap the items full item path in square brackets. Calculates x raised to the power of y. However. Modulo. v2.. Returns 1 if true. 0 if false.. Returns 1 if true. Returns 1 if true.v3. Greater than or equal logical operator. If the condition is true. Hyperbolic cosine. Natural logarithm.Calculation Operators for Alias Scaling Alias scaling calculations may use any of the functions listed in Table 58. Converts an hexadecimal number to a decimal number.. val2) isNaN(value) log(x) log10(x) max(v1. Returns smaller of a set of values. 0 if false.. Returns 1 if the number is a NaN value.v3.. Converts a binary number to a decimal number. Returns larger of two values. Returns the factorial of x: x*(x1)*(x-2)*.. Floor.v2. val1. Returns larger of three values. returns val1 else returns val2.v3. Cosine.v2.Construct == > >= Description Equal logical operator.) bin(binNumber) ceil(x) cos(x) cosh(x) fact(x) floor(x) hex(hexNumber) if(condition.) max(x.. Base-10 logarithm Returns larger of a set of values.0 User’s Manual 123 ..y. Arccosine Arcsine Arctangent Returns the average of a set of values. Ceiling.y) max(x..(x-x+1).3. Greater than logical operator...z) min(v1. 0 if false. Description abs(x) acos(x) asin(x) atan(x) avg(v1.) Examples MatrikonOPC Server for Siemens PLCs v1. Construct abs acos asin atan avg bin ceil cos cosh fact floor hex if isNaN log log10 max max max min Absolute value. x == y x>y x >= y Examples Table 57 . Lines beginning with a hash mark (#) are ignored (used for comments). Periods in the name indicate subfolders below the root (e. North. Field Alias Group Alias Name Item Path Data Type Read-only Description Name of the alias group folder where the alias belongs.3.. If aliases are exported to CSV and then re-imported.. Values containing commas or spaces are enclosed in double-quotation marks (“ ”). max) round(x) sin(x) sinh(x) sqrt(x) sum(v1. Name of the alias. 0 = only poll as requested by an OPC client (normal) 1 = poll continuously at the specified update rate 124 Poll Always MatrikonOPC Server for Siemens PLCs v1. Tangent. Round the fractional part of a number.v2. Returns the sum of a set of values. min(x.) tan(x) tanh(x) Table 58 . 0 = read-write 1 = read-only Specifies whether the alias is polled continuously or not.y) min(x. all event generation settings will be lost.FIC101.Construct min min rand rand round sin sinh sqrt sum tan tanh Description Returns smaller of two values.0 User’s Manual . Hyperbolic sine.v3..g.z) rand() Examples rand(min.FIC101 = alias group North under the Alias Configuration root and alias group FIC101 under that). Double-quotation marks occurring inside quoted values are escaped with an extra doublequotation mark. Decimal number indicating the data type for the alias.Calculation Functions for Alias Scaling CSV File Format Note: The CSV file format does not support Alias Event configuration settings.. Each line contains the fields listed in Table 59. Random value between 0 and 1. a period. North. The alias import/export file contains lines of comma-separated values. and the alias name (e. Specifies whether the alias is read-only or read-write. Fully qualified item ID for the OPC item to which the alias refers. Full alias path name composed of the alias group path. Hyperbolic tangent. Random value between min and max. Square root. Returns smaller of three values..y. Sine.g.CV for an alias named CV). Field Gain Offset Description Scaling factor (double-precision real).Additional File Import/Export Field Descriptions . the line contains the additional fields listed in Table 63. 0 = none 1 = linear 2 = square root 3 = gain/offset 4 = expression 5 = calculation Table 59 . MatrikonOPC Server for Siemens PLCs v1. The output formula should be the reciprocal of the input formula.File Import/Export Field Descriptions Scaling When the scaling field specifies linear (1) or square root (2) scaling. the line contains the additional fields listed in Table 60. Field High Raw Low Raw High Scaled Low Scaled Clamp options. Table 62 .0 User’s Manual 125 .Field Update Rate Description Update rate (milliseconds) to use with the Poll Always option. Simple formula applied to values written to the OPC item. Scaling type for the alias. Table 61 . Description Raw value range (double-precision real). Scaling offset (double-precision real). Field Input Expression Output Expression Description Simple formula applied to the value read from the OPC item.Offset Scaling When the scaling field specifies expression (4) scaling.Expression Scaling When the scaling field specifies calculation (5) scaling. Clamp Table 60 .Additional File Import/Export Field Descriptions . the line contains the additional fields listed in Table 61.Linear/Square Root Scaling When the scaling field specifies gain/offset (3) scaling. the line contains the additional fields listed in Table 62.3.Additional File Import/Export Field Descriptions . 0 = none 1 = clamp low value 2 = clamp high value 3 = clamp both high and low values Scaled value range (double-precision real). Field Input Calculation Description Calculation applied to the value read from the OPC item. a different algorithm (Table 64) is applied to values read from the OPC item.Calculation Scaling Scaling Algorithms For each type of scaling. Table 63 . A reverse algorithm is applied to any values written to the OPC item.Additional File Import/Export Field Descriptions . Scaling Linear Algorithm/Example x RawLow Scaled High RawHigh Scaled Low RawLow Scaled Low Reverse Algorithm/Example x Scaled Low RawHigh Scaled High RawLow Scaled Low RawLow Square Root Gain/ Offset Expression x RawLow Scaled High RawHigh Scaled Low RawLow Scaled Low x Scaled Low 2 RawHigh Scaled High RawLow Scaled Low 2 RawLow Gain x Offset x Offset Gain SQRT(INPUT) + 5 (OUTPUT – 5) * (OUTPUT – 5) Table 64 .Scaling Algorithms MatrikonOPC Server for Siemens PLCs v1.0 User’s Manual 126 .3. 0 User’s Manual 127 .Standard Data Types MatrikonOPC Server for Siemens PLCs v1. Table 65 . FALSE = 0) 1-byte signed integer 1-byte unsigned integer 2-byte unsigned integer 4-byte unsigned integer Array of 2-byte signed integers Array of 4-byte signed integer Array of 4-byte (single-precision) real Array of 8-byte (double-precision) real Array of currency values Array of dates Array of text values Array of error codes Array of Boolean values Array of 1-byte signed integers Array of 1-byte unsigned integers Array of 2-byte unsigned integers Array of 4-byte unsigned integers The Standard data types and their descriptions are listed in Table 65.Appendix C Hex 0000 0002 0003 0004 0005 0006 0007 0008 000A 000B 0011 0012 0013 0014 2002 2003 2004 2005 2006 2007 2008 200A 200B 2011 2012 2013 2014 0 2 3 4 5 6 7 8 10 11 16 17 18 19 8194 8195 8196 8197 8198 8199 8200 8202 8203 8208 8209 8210 8211 Dec Standard Data Types Data Type VT_EMPTY VT_I2 VT_I4 VT_R4 VT_R8 VT_CY VT_DATE VT_BSTR VT_ERROR VT_BOOL VT_I1 VT_UI1 VT_UI2 VT_UI4 VT_ARRAY | VT_I2 VT_ARRAY | VT_I4 VT_ARRAY | VT_R4 VT_ARRAY | VT_R8 VT_ARRAY | VT_CY VT_ARRAY | VT_DATE VT_ARRAY | VT_BSTR VT_ARRAY | VT_ERROR VT_ARRAY | VT_BOOL VT_ARRAY | VT_I1 VT_ARRAY | VT_UI1 VT_ARRAY | VT_UI2 VT_ARRAY | VT_UI4 Description Default/Empty (nothing) 2-byte signed integer 4-byte signed integer 4-byte (single-precision) real 8-byte (double-precision) real Currency Date Text (UNICODE) Error code Boolean (TRUE = -1.3. Using Visual Basic. enter two simultaneous single quotation characters: =matrikon_opc_simulation_1|’Power. For example.Real4") ' poke to the Item 1000\. When using Excel as the client. surround the specific field with single quotation characters („ „): =SERVICE|TOPIC!’NAME’ =SERVICE|’TOPIC’!’NAME’ =SERVICE|’TOPIC’!NAME To include single quotation characters in the name. Microsoft Excel). creating a read-only “hot link” to the DDE items.3. Excel can also be used to transmit (write) the data contained in a specific cell of a spreadsheet to a DDE server.0 User’s Manual 128 . to the appropriate DDE client (in this case. simply enter a DDE Item as a formula in some spreadsheet cell: =SERVICE|TOPIC! NAME Excel will initiate a DDE Advise loop. DDE Read To perform a DDE Read using Excel. use the Links menu option under the Edit menu. Windows) will forward any update sent by the DDE service. The DDE Management system (in this case. row 1 to an item in the OPC Simulation server: Sub WriteToDDE() ' open a DDE channel. or NAME contains any special characters. "Bucket Brigade. If a SERVICE. The DDE service is responsible for update rate/behaviour. DDE items can be bound to specific cells in a spreadsheet.Appendix D Microsoft Excel as a DDE Client Microsoft Excel can act as both DDE client and DDE server. TOPIC. the value of cell A1 DDEPoke channel. To disable a specific hotlink in Excel.Generator”s Value’!’1000\’ DDE Write To perform any DDE command other than requests (read) or advise (hot link). Field 1 = SERVICE. Worksheets("Sheet1"). to the topic and item within the service. the following function will poke (write) the contents of column 1. Special Characters in Excel Excel reserves the use of specific characters for use in any cell. Field 2 = TOPIC 'channel = DDEInitiate("matrikon_opc_simulation". "1000\". Most DDE commands are available by using the application object. or “hot link”.Range("A1") ' close the channel DDETerminate channel End Sub MatrikonOPC Server for Siemens PLCs v1. a Visual Basic (VB) function must be used. exe) as shown in Figure 66.DDE Share NetDDE must first be configured using the DDEShare application (DDEShare. the NetDDE Windows Service allows DDE communication between two computers. In the Windows Environment.Net DDE Since DDE commands are routed by the operating system. Figure 66 .0 User’s Manual 129 . it is not possible to establish a DDE session between two computers unless some transport mechanism is used. that is to be available through NetDDE must be assigned a unique name. This is usually supplied as a plug-in component of the operating system. MatrikonOPC Server for Siemens PLCs v1.3. or “NetDDE Share”. Each SERVICE and TOPIC pair. The delimiting characters must be provided when referencing an item in the server. consider the TOPIC to be the item ID. However. Read latest data from an active advice loop.Appendix E Configuring Dynamic Data Exchange (DDE) The server may act as a DDE service. Note that these options will not be available if the server does not support DDE. and the NAME to be a combination of the scan rate and access path. Read data from an item in the server. the scan rate and access path are optional. ITEM refers to an Item ID of a point within the server. and an advise loop is not created. Create and activate an advice loop on a single item in the server. Items within the server can be referenced using the following syntax: SERVICE_NAME |ITEM! SCANDETAILS SERVICE_NAME represents the name of the DDE service. including the location of. DDE service can be enabled or disabled using a checkbox (refer to Advanced Options for more information. MatrikonOPC Server for Siemens PLCs v1. One or more delimiting characters separate the scan rate and access path. If no scan rate is specified. only data contained in the server cache is available through DDE.0 User’s Manual 130 . SCANDETAILS is a combination of the desired scan rate of the item. Changes to the DDE options do not take effect until the server is restarted. this checkbox). a DDE client can request data from the server using the following DDE commands: XTYP_POKE XTYP_REQUEST XTYP_ADVREQ XTYP_ADVSTART XTYP_ADVSTOP Write data to an item in the server. and an access path. Stop and destroy an advice loop on a single item in the server.3. The second edit box can be used to change the delimiters. In this way. The first edit box specifies the service name used by this server. Note: DDE Name Syntax – DDE Names may be described in the following syntax: SERVICE|TOPIC|NAME In this case. at which point the NT credentials are used until the log on call is made again. Security Details – describes how permissions are applied. Using the IOPCSecurityPrivate interface for OPC Security. The OPC Framework will take the OPC item ID provided. The OPC Framework will attempt to impersonate the client that is connected to the server. Both the IOPCSecurityNT and IOPCSecurityPrivate interfaces are fully supported (there are no optional pieces). MatrikonOPC Server for Siemens PLCs v1. The credentials provided through the private interface override those provided from the NT interface. OPC Security Implementation Whether a user has access or not will depend on: 1. and other important details.Appendix F Introduction Security The OPC Framework has implemented the OPC Security Customer Interface version 1. 3. Appendix Structure This appendix is structured as follows: Introduction – this introductory section. the OPC client must implement and follow the OPC Security specification in terms of following the calls necessary to provide credentials. and is able to do so by setting permissions for a partial item ID or path. The OPC client may choose to log off. Location Some of the interface calls made from an OPC client to an OPC server require the client to provide an OPC item ID. The type of functionality in an OPC server that is controlled by OPC Security is vendor-determined. since no interface calls are necessary. A particular server installation may want to control access to a particular device or branch in the hierarchy. how security settings are stored. the OPC client must make a call to the OPC server to log on with a user name and password. OPC Security Implementation – description of user access dependencies. The OPC Security specification defines how user credentials are passed from client to server.3. In this scenario. the identity of the OPC client is the domain user that is running the OPC client and connecting to the OPC server.0 User’s Manual 131 . and use the name from those credentials for access control. This method does not require any implementation of OPC Security by the OPC client. Type – the type of functionality the user is trying to perform. 2. IOPCSecurityNT describes how NT authentication is used in OPC Security. Identity Using the IOPCSecurityNT interface for OPC Security. IOPCSecurityPrivate describes how proprietary user credentials are used in OPC Security. and determine whether access to that location is allowed or not.0 of the specification. MatrikonOPC Tag Security Configuration Utility – describes the utility that is used to configure security for MatrikonOPC servers. but very little else. Location – the OPC item ID or hierarchy path being accessed. Identity – the user behind the OPC client‟s actions. then the user must select the OPC server for which security will be configured. Adding items 3. Browsing 2. or Writing. but may depend on the state of the server with respect to previous calls. but the writing permissions might be restricted so that the user cannot interfere with the operation of the end device. security control has been added to each possible entry. Reading. The MatrikonOPC Tag Security Configuration Utility is a component of an OPC server installation. Note: In order for the MatrikonOPC Tag Security Configuration Utility to work properly. a tool that is installed with the server. A location that is being accessed by an OPC client may have different permissions for the different types of access. then it will configure security for the OPC server to which the shortcut belongs. the following: Who has permission Which tags/locations they have permissions for The type of permissions for those locations Security settings configured using this utility are read by the OPC Framework and populated in memory upon server start-up. reading values from the items. When browsing. or from a shortcut found in the Start Menu.exe The MatrikonOPC Tag Security Configuration Utility can be run either directly from its installed location. read control has been added to group subscriptions call-backs as well as synchronous reads and asynchronous reads – denying read control would disable reads for the possible types. MatrikonOPC Tag Security Configuration Utility The tag security settings for MatrikonOPC servers are configured and managed via the MatrikonOPC Tag Security Configuration Utility. Reading 4. added. There are multiple interfaces. followed by adding items. and read.Other interface calls do not provide an ID. If the utility is run from the installed location. This utility allows users to define. and functions within those interfaces. OPC Browsing (DA 2. the windows user running the utility must have Administrator rights to the computer. For example.3. that can be used to perform the types of functionality listed above. only a partial path leading to an OPC item may be known at any location in the browsing hierarchy. Writing Browsing is the least intrusive. per MatrikonOPC server. If the MatrikonOPC Tag Security Configuration Utility is run from the shortcut. and are monitored for changes. For example. In this case.0 User’s Manual 132 . and is installed in the following location: C:\Program Files\Common Files\MatrikonOPC\Common\ACLConfig. the full path up to that particular location is used for determining access rights. MatrikonOPC Server for Siemens PLCs v1. three of them make use of the full OPC item ID when an interface call is made from the client to the server: Adding Items. Type There are four types of interface functionality in the OPC Framework (specifically the OPC Outer Layer) that are controlled using OPC Security: 1. Thus. and finally writing to the items being the most intrusive.0) is an example of this. Note: Of the four functionality types listed above. one particular item may be browseable. Figure 68 . For servers that required a security password to be entered during their installation. The MatrikonOPC Tag Security Configuration Utility screen (Figure 69) appears.Start Menu Navigation After the MatrikonOPC Tag Security Configuration Utility is run: 1.3. MatrikonOPC Server for Siemens PLCs v1. 2. 4. 3. Note: The default password provided for you during installation (if you chose to use the default) is MatrikonOPC. This protects the security settings and prevents unauthorized individuals from accessing these settings.To run the MatrikonOPC Tag Security Configuration Utility from its shortcut: 1. Select Programs -> MatrikonOPC -> <OPC Server Name> ->Tag Security. A window appears asking for a password to be entered. Click on the Windows Start button. the Enter server password window (Figure 68) appears.0 User’s Manual 133 . Click on the OK button. Enter the password created during the installation of the OPC server. Figure 67 .Enter Server Password Window 2. In Figure 69 above. This user defines the permissions used for other NT users that are not configured. the Utility screen shows that the MatrikonOPC Server for Simulation and Testing tag security is being configured. there is always a user named Everyone in the Users & Groups list. and are identified by greyed-out icons.0 User’s Manual 134 . When the Help screen is hidden. By default. In the center of the Utility screen there are descriptions for each of the actions that can be performed.MatrikonOPC Tag Security Configuration Utility Main Screen The MatrikonOPC Tag Security Configuration Utility screen displays the name of the OPC server that is being configured for tag security. These actions are further described later in this appendix. MatrikonOPC Server for Siemens PLCs v1. Some actions may not be applicable.Layout Figure 69 . depending on the context in which they are used. The appearance of these descriptions can be toggled at any time by clicking on the Hide Help/Show Help link that exists in the bottom-right corner of the Utility screen.3. The left-hand side of the Utility screen shows a column of action icons that can be clicked upon. a list of users and groups that have been added appears (Figure 70). NT User To add an NT user: 1. For NT users. click on the Add User button. the IOPCSecurityPrivate interface is used. Clicking on the Cancel button or the X button on the top-right of the screen. the changes made do not take effect until either the OK or Apply button has been selected. Add User There are two types of users for which security can be configured: NT Users and Private Users. MatrikonOPC Server for Siemens PLCs v1. the IOPCSecurityNT interface is used. discards any changes made. From the MatrikonOPC Tag Security Configuration Utility main screen. Adding a user to the configuration will allow permissions to be defined for that user.Figure 70 . Clicking on the Apply button saves the changes and keeps the Utility screen open. and for Private users.0 User’s Manual 135 . Clicking on the OK button saves the changes and closes the Utility screen.3.MatrikonOPC Tag Security Configuration Utility Main Screen: Users & Groups Note: After any action is performed. The Add User window (Figure 71) appears. This will allow the addition of a user from a Windows NT Domain.3.2. Figure 71 . the local machine name appears in the From this Location field. The Edit <Username> window (Figure 77) appears. The NT User option button is selected by default.Add User Window (NT) 3. MatrikonOPC Server for Siemens PLCs v1. click on the Search button. and select a user from the displayed list of users. 4. To browse to a different location. By default. click on the OK button. click the Locations button. 5. To add the selected user. Follow the instructions in the Edit User section for adding permissions.0 User’s Manual 136 . The User field can be entered manually. To avoid manually entering a user. Clicking on the Check Name button performs validation on the entered user. 6. The user is then added to the list of users and/or groups currently defined (refer to Figure 72 for a sample list of defined users and groups). The user names are the same as the Windows NT domain names used on the network. The Add User window (Figure 71) appears. They are not created in any NT domains.3. which must implement the OPC Security Private interface for this section to be meaningful. MatrikonOPC Server for Siemens PLCs v1. To add a Private user: 1.Defined Users and Groups Private User Private users have names and passwords associated with them. 3. 2. custom to the OPC client application. From the MatrikonOPC Tag Security Configuration Utility main screen. click on the Add User button.0 User’s Manual 137 . Select the Private User option button (Figure 73).Figure 72 . Private users exist only in the OPC server. There are two types of groups for which security can be configured: NT Groups and Private Groups.Add User Window (Private) 4. Note: The user name cannot be added if there is already a configured User or Group with that same name. and each group defines a permission (Allow/Deny) for the type of access. From the MatrikonOPC Tag Security Configuration Utility main screen. Click OK to create the Private user. Note: A user can exist in multiple groups.0 User’s Manual 138 . then the group whose name alphabetically comes first is used. It will be added to the list of users and/or groups currently defined (refer to Figure 72 for a sample list of defined users and groups). 5.3. 7. However. NT Group To add an NT group: 1. In the Username field. but if two or more of the groups have the same configured path (refer to the Edit User section). A group must contain at least one user. click on the Add Group button. Groups are not necessary to use OPC Security. Add Group Groups are used to group users together so that they can share common permissions. enter a user name. they are convenient when you need to apply common permissions to multiple users. In the Password field. re-enter the new password. In the Password Confirmation field. MatrikonOPC Server for Siemens PLCs v1.Figure 73 . 6. enter a password. and any combination of users can be grouped together. Follow the instructions in the Edit Group section for adding permissions. click on the Search button. the local machine name appears in the From this Location field. By default. click on the Add Group button. From the MatrikonOPC Tag Security Configuration Utility main screen. This will allow the addition of an NT group from a Windows NT Domain. 4. The Add Group window (Figure 74) appears. Figure 74 .Add Group Window (NT) 3. 6. To avoid manually entering a group. 5. 2. The Group field can be entered manually. Clicking on the Check Group button performs validation on the entered group. To add the selected group.0 User’s Manual 139 . The group is then added to the list of users and/or groups currently defined (refer to Figure 72 for a sample list of defined users and groups). click the Locations button. click on the OK button. To browse to a different location.2. 3. The Edit <Groupname> window (Figure 84) appears (for NT Groups. there is only the Permissions tab). The group names are the same as the Windows NT domain group names used on the network. MatrikonOPC Server for Siemens PLCs v1. Private Group To add a Private Group: 1. and select a group from the displayed list of groups.3. Select the Private Group option button (Figure 75). The NT Group option button is selected by default. The Add Group window (Figure 74) appears. It will be added to the list of users and/or groups currently defined (refer to Figure 72 for a sample list of defined users and groups). 2. Figure 76 . select Duplicate. The group is private and will only exist in the OPC server. The group cannot be created if there is already a configured user or group with that same name. To create a new user or group via duplication: 1. right-click your mouse on the user or group you wish to duplicate.Add Group Window (Private) 4.Enter New Name Window MatrikonOPC Server for Siemens PLCs v1. Duplicate Another way to create a new user or group is to duplicate an existing one. From the MatrikonOPC Tag Security Configuration Utility main screen. Enter a name for the group to be created. The Enter New Name window (Figure 76) appears. 3. 5.0 User’s Manual 140 .3. The Edit <Groupname> window (Figure 84) appears. From the displayed menu.Figure 75 . Follow the instructions in the Edit Group section for adding permissions. Click on the OK button to create the group. 6. 3.e. the user Everyone is used for determining security permissions. they must be edited to configure their respective permissions. There must not already be a configured user or group with that same name. Click on the OK button. either: Double-click your mouse on the user you wish to edit. For every NT user not configured in the MatrikonOPC Tag Security Configuration Utility.e. and then select the Edit button. the user being edited is User1 so the window‟s title reads Edit User1. Note: Permissions can also be defined for the user Everyone. original) user or group.. From the MatrikonOPC Tag Security Configuration Utility main screen.0 User’s Manual 141 . OPC Item ID) or a path leading up to an item. Notes: In this example. The new user or group will then appear in the list. or Click your mouse on the required user. and will contain the same properties as the duplicated parent (i. which is defined as the default user. reading items. Permissions are defined for users and groups for a particular location in the server‟s address space hierarchy. Edit User To edit a user: 1. Enter a name for the new user or group to be created. The Edit <Username> window (Figure 77) appears.. Edit Once the desired users and/or groups are defined. MatrikonOPC Server for Siemens PLCs v1. A location can either be a tag (i. adding items. 2. and writing items can be configured. or Right-click your mouse on the required user and select Edit User from the displayed menu. Permissions for allowing/denying browsing.4. 5. There are two tabs on this window: Permissions and General. The General tab only appears for private users. The Configured Paths screen section lists the paths and/or OPC items for which permissions are defined. Selecting Unspecified directs the OPC Framework to look for the permission higher up in the hierarchy.Edit <Username> Window (Permissions Tab) Permissions On the Permissions tab. reading. Write. the Add Permission screen is displayed.Figure 77 . the permissions associated with this user relating to browsing.0 User’s Manual 142 . In the Server Address Space screen section. The Permissions screen section indicates those permissions with option buttons. Red folders indicate a null branch. which can be set to Allow. This means that the item names below this branch do not contain the branch name. To properly set permissions on the items below the branch. they have to be set on the items themselves. and writing for any specific paths or OPC items are configured. folders and items are shown as nodes are selected and expanded. MatrikonOPC Server for Siemens PLCs v1. all of which are outlined in black. From the Permissions tab. so permissions set on the branch will not reflect on Add. when the Add button is selected. Deny. or Unspecified.3. Figure 78 provides an example of a null branch and items below it. and Read permissions for the items below the branch. adding. Click on the Add button to begin configuring permissions for the current user. and Add permissions for the Saw-toothed Waves branch will affect the items below as Saw-toothed Waves is part of the item ID of the Int1 item (Saw-toothed Waves. the item ID of the Int1 item is actually Saw-toothed Waves. Write. Random. Saw-toothed Waves is a non-null branch.Int1 and not Simulation Items\Saw-toothed Waves. or a particular OPC item. 2. Setting permissions on the Simulation Items branch does not affect Read. MatrikonOPC Server for Siemens PLCs v1. if a defined group is denied writing privileges to an OPC item. and Add permissions for the Saw-toothed Waves branch of the Int1 item below that. and therefore the Saw-toothed Waves folder does not appear as a red folder like the Simulation Items folder does. This is because when adding the Int1 item.3. This window allows you to browse the OPC server address space to find either a path in the hierarchy.Int1. Write.0 User’s Manual 143 . For example. Simulation Items is a null branch (identified by the red folder). while a defined user (a member of that group) is allowed writing privilege to Random items (Random. The Add User Permission window (Figure 79) appears. Random. then the user permissions would take precedence for that OPC item (even though the permissions relating to the group are a better match for the OPC item. and Int1 is an item.Int1).Add Permission Screen (Server Address Space) When browsing. Note: User permissions override group permissions. To edit a user’s permissions: 1. using the example in the diagram above. Setting Read.Int4.<itemID>).Figure 78 .Int4). Add User Permission Window 3.0 User’s Manual 144 .e. MatrikonOPC Server for Siemens PLCs v1. and writing will not affect items below it. but rather are used for browsing organization. Expand on the server address space‟s root node and continue to browse to the desired path in the hierarchy. Note: Branches (i.3. folders) that are red in colour (see Figure 80) are not part of an item‟s path.. reading. For more information. or the desired OPC item.Figure 79 . refer to Permissions. Configuring permissions for adding. Adding privileges are denied. and Reading and Writing privileges are unspecified. Click on the OK button.Add Permission Window: Browsing Server Address Space 4. Note: In this example. MatrikonOPC Server for Siemens PLCs v1. as in the example depicted in Figure 81. Permissions can now be assigned.Figure 80 . User1 is allowed to browse the Random path of the OPC server‟s address space.0 User’s Manual 145 . The selected path or item will be listed in the Configured Paths screen section of the Edit User window. 5.3. MatrikonOPC Server for Siemens PLCs v1.Edit <Username>: Example On the General tab (Figure 82) of the Edit <Username> window. Click on the OK button. 2. the name and password of the user can be changed.3. To edit a user’s name: 1.Figure 81 .0 User’s Manual 146 . Enter a new name in the Name field. 3. 4.0 User’s Manual 147 . The Reset Password window (Figure 83) appears. Enter the new password in the Password field. Click on the Reset Password button.Edit <Username> Window (General Tab) To change the user’s password: 1.Figure 82 . Re-enter the password in the Password Confirmation field. 3. MatrikonOPC Server for Siemens PLCs v1. Click on the OK button. Figure 83 .Reset Password Window 2. For Private Groups.0 User’s Manual 148 . or Click your mouse on the required group and then select the Edit button. From the MatrikonOPC Tag Security Configuration Utility main screen. and writing for any specific paths or OPC items are configured. MatrikonOPC Server for Siemens PLCs v1. The Edit <Groupname> window (Figure 84) appears.Edit Group To edit a group: 1. Group and user permissions are configured in the same way. there are three tabs on this window: Permissions. Notes: In this example. and Members.Edit <Groupname> Window (Permissions Tab) On the Permissions tab. For NT Groups. Refer to the Edit User section regarding configuration on the Permissions tab. General. Figure 84 . the permissions associated with this group relating to browsing. or Right-click your mouse on the required group and select Edit Group from the displayed menu.3. 2. the group being edited is Group1 so the window‟s title reads Edit Group1. reading. adding. either: Double-click your mouse on the group you wish to edit. there is only the Permissions tab. 0 User’s Manual 149 . the users that are part of the current group are defined. MatrikonOPC Server for Siemens PLCs v1. By default. the name of the group can be changed. Figure 85 .3. Click on the OK button. Enter a new name in the Name field.Edit <Groupname> Window (General Tab) On the Members tab (Figure 86). User1 has been added to Group1. the Group Members screen section is empty.On the General tab (Figure 85) of the Edit <Groupname> window. To edit a group’s name: 1. In Figure 86. 2. Click on the Add button.Figure 86 .Edit <Groupname> Window (Members Tab) To add one or more members to the group: 1.3.0 User’s Manual 150 . The Add Existing User window (Figure 87) appears. MatrikonOPC Server for Siemens PLCs v1. The Members screen section lists all the defined users from which you may choose.Figure 87 . 3. Notes: If a user name and a group name (to which the user belongs) have permissions defined for the same location. Select one or more desired users to become members of the group. The root location (i. empty string) will always match. Select that user in the Group Members screen section. or is found but does not contain a defined permission. Click on the Remove button. either: Select the required user or group from the list and click on the Delete button (Figure 72). writing. Delete To delete a previously added user or group: 1.3. and is used if no partial location match is made. and adding. the user name will be used. the group that is alphabetically first will be used. and so on. The selected user or users appear in the Group Members screen section on the Members tab (Figure 86). From the MatrikonOPC Tag Security Configuration Utility main screen.. The exact location (full item ID for reading.0 User’s Manual 151 . To remove a user from the group: 1. then the closest match in location is looked at next.e. or the full path for browsing) is always looked for first when determining the permission for a particular user. or MatrikonOPC Server for Siemens PLCs v1. If a user belongs to two groups that have permissions defined for the same location. Click on the OK button. 2.Add Existing User Window 2. If the exact location is not found. Enter the old password for the current OPC server. right-click your mouse on the required user and select Delete User from the displayed menu Change Password To change the security password for the OPC server: 1. Default The default tag security configuration provided is quite simplistic as is shown in Table 66: User/Group Everyone \ Configured Paths Browse Allow Table 66 . Only the root level location is defined under the Configured Paths list. Note: Changes are applied in the Utility main window by clicking on either the OK or Apply button. MatrikonOPC Server for Siemens PLCs v1. 5.Change Password Window 3. The Change Password window (Figure 88) appears.For a group. 4.Default Tag Security Add Allow Read Allow Write Allow As no users or groups are defined. Enter and confirm the desired new password. click on the Change Password button (Figure 69). right-click your mouse on the required group and select Delete Group from the displayed menu.3. which gives full permissions to the entire OPC server. An administrator will want to change these default settings for the OPC server to provide more security on its tags. Figure 88 . Examples This section contains examples of tag security settings made via the MatrikonOPC Tag Security Configuration Utility. any NT user connecting to the OPC server will use the Everyone default user for permissions.0 User’s Manual 152 . or For a user. and the impact of these settings. 2. From the MatrikonOPC Security Configuration Utility main screen. Click on the OK button. simpson DOMAIN\the. with sample use-cases.Example 2: Groups and Members Adding a user name and not defining any permissions for that user name (or any group it belongs to). Allow Deny Allow Unspec.Int4 Allow Deny Allow Unspec. Deny Deny Allow Deny \ Deny Allow Allow Deny \ Configured Aliases Configured Paths Browse Allow Deny Add Deny Unspec.doe DOMAIN\fred.stone. Read Deny Unspec. Allow Deny Allow Unspec. This group may be denied write capability or restricted to certain areas in the server hierarchy. Unspec. Table 69 indicates which users are members of the defined groups. Write Deny Unspec. will completely restrict their access to information in the OPC server. more users can be added which belong to a more restricted group. User/Group Everyone Everyone DOMAIN\john. Table 68 . DOMAIN\sally.stone DOMAIN\sally.doe DOMAIN\fred. MatrikonOPC Server for Siemens PLCs v1. Example 2 Following is an example of a tag security configuration for the MatrikonOPC Server for Simulation and Testing. Table 68 lists all defined users and groups and their associated permissions.Example 1 Configured Paths Browse Deny Allow Add Deny Allow Read Deny Allow Write Deny Allow At this point.admin Table 69 .simpson DOMAIN\the.Example 1 Table 67 contains a possible tag security configuration enforces complete restricted access except for the NT user DOMAIN\Admin: User/Group Everyone DOMAIN\Admin \ \ Table 67 . Groups in this example are Private Groups.Example 2: Permissions User/Group Restricted Common Admin Tip 1 Configured Paths DOMAIN\john.3. permission indicates Unspecified.0 User’s Manual 153 .admin Supervisor Restricted (group) Common (group) Common (group) Admin (group) Admin (group) \ Triangle Waves \ Bucket Brigade. Security Details ACL File The permissions that the MatrikonOPC Tag Security Configuration Utility creates are stored in a file named ACL. The user is unable to perform any function at any level.name connects. is the full item ID Bucket Brigade. Case 4 User Supervisor connects through the private security interface and logs on.name will be able to browse the entire server except the Configured Aliases branch and all aliases under it. adding. if the ACL.admin connects.stone connects. Note: It is advised that this file is backed up and stored somewhere safe. No other locations have permissions defined.sec is encrypted with 256-bit AES using the password key that was provided during installation (or changed in the security utility). This user belongs to the Admin group. The only other location where permissions are defined for the default user is Configured Aliases – here browsing is denied and adding. This user does not belong to any group. Since the user cannot browse.e. Case 3 User DOMAIN\fred.. and writing permissions are not defined. since no permissions have been defined for this user name or the Restricted group to which it belongs.name will not be able to do any item addition. While the server is running. Case 2 User DOMAIN\no. and read items. In the event that this file is lost or deleted by accident. adding. or writing. writing) and must re-configure their security settings. This user is unable to write to that item. However. add. the root permissions for browsing.0 User’s Manual 154 . The only other location where the Admin group has permissions defined.3. This location has denied all permissions for the Common group. DOMAIN\no. which at the root level has all permissions allowed. ACL. browsing. Also.Int4. reading. Since item addition. Use the default user to define permissions for users that are not listed. and writing permissions were not defined for the default user for under Configured Aliases.Case 1 User DOMAIN\john. it will need to know the item syntax for any items it wishes to add and read. the default user can browse but no more. reading. Case 5 User DOMAIN\the. once tag security configuration has been completed. This name is not defined so the default user permissions are used. reading. the group Common can browse. DOMAIN\no.sec file missing. If the server is re-started with the ACL. no users will have permissions to do anything (i.sec that is located in the same directory as the MatrikonOPC server executable: C:\Program Files\Matrikon\OPC\< OPC Server Name >\. At the root level location.doe connects.sec file is moved or deleted from its location above. Tip 2 Use the root location to define permissions for locations that have not been defined. reading. This user belongs to the defined group Common. Thus. but its name has a root level permission which allows it to add and read items. At the root level. simply MatrikonOPC Server for Siemens PLCs v1. security functions as it did before the file was moved. but writing is denied. and reading the item apply as they are not defined at this level. The only other location which defines permissions for this group is Triangle Waves. it would use the permissions defined at the root level. 3. reading.sec becomes deleted and no backup was made. By adding this item to an OPC group and writing a value of False to this item. Run-Time Tag Security Configuration Tag security can be configured and updated while a MatrikonOPC server is running. When the OPC client calls Logoff(). a private name. Type Identity is the user name described in the previous section – either the NT domain name. Three pieces of information are always sent to this routine call: 1. or the default user Everyone. or write operation is performed by the OPC client. The following information details the procedure used in determining permission rights: MatrikonOPC Server for Siemens PLCs v1. The #MonitorACLFile is a boolean OPC tag that has a default value of True when the server starts which indicates that the tag security permissions are monitored and applied while the server is running. Security should be applied to the #MonitorACLFile tag so that unauthorized users are unable to control this ability described above. Each piece of information is checked in the order listed above. tag security will need to be re-configured. Client Connections and Private Log On When an OPC client connects to the server. If the user is found and the password provided is correct. item addition. Location is either the full item ID or a partial path in the server hierarchy. If not found. If this NT user was not added in the Users & Groups list (Figure 72). the OPC Framework will call a permission routine to determine if permission is allowed or denied. and then disabled again once they have been applied. The OPC Framework will immediately look for the private user in the Users & Groups list (Figure 72).0 User’s Manual 155 .transfer the stored backup (if one was made) to the directory stated above. the NT user becomes the name used for security permissions. read. identity includes any groups (private or NT) that the user belongs to. the OPC Framework impersonates the client and determines the name of the NT user that is running the client. If the OPC client chooses to use the IOPCSecurityPrivate interface. the server no longer applies tag security configuration changes while the server is running. The server would need to be stopped and restarted for the changes to take effect. Determining Permission Whenever a browsing. Identity 2. a malicious user that has access to the machine cannot delete the ACL file and thus remove all user permissions for OPC security. Location 3. or writing. This client name (consisting of the domain name and the user for that domain) is what the OPC Framework uses when checking permissions set in the MatrikonOPC Tag Security Configuration Utility. Type is the access type: browsing. then the user Everyone is used instead. This run-time security configuration can be controlled using the #MonitorACLFile OPC item (found in the root branch when browsing the server). In addition. Runtime tag security configuration can be re-enabled when changes to the tag security need to be made. it must call the Logon() function and provide a name and password. If ACL. By disabling the ability of run-time tag security configuration. item addition. the Logon() result is successful and the user name provided replaces the NT user that was obtained through impersonation. the Logon() result is failure and the NT user remains as the name used for security permissions. If a permission match was not yet found.String. The root location \ is considered a partial match for every full item ID. The NT domain name must be part of Group Members for private groups.e. 2.3.Int Allow Allow Allow Allow Deny Allow Allow Deny Allow Allow Deny Allow Configured Paths Browse Add Read Write Table 70 .doe wants to read the item Random. the one that has the most characters) that is successful in step 1a is the one whose permission is used. Look for a permission match with the NT domain name or private name.doe wants to read the item Random. Example The following is an example of a tag security configuration. look for a permission match using the default user Everyone. An NT domain name does not need to be defined in the Users & Groups list for a group it belongs to. The location Random. String is not a partial match (even if it is a sub-string) because it does not match the first seven characters. The permission routine would not be able to find an exact location match under the Configured Paths list. 2.doe DOMAIN\john. The location Random would be the closest match and the permission would be DENY. The best partial match (i.Example 2: Permissions The user DOMAIN\john. If a permission match was not yet found. Check whether the permission type (browse. The procedure used in finding a permission match for a particular identity is as follows: 1. However. or write) is specified (Figure 81). If the permission type is specified for the action being performed. it would loop through each partial match in the Configured Paths list looking for a defined permission. MatrikonOPC Server for Siemens PLCs v1. 3. User/Group Everyone DOMAIN\john. look for one using each group defined in the Users & Groups list that the NT domain name or private name belongs to. However. add. Check whether the exact location is found in the Configured Paths list for the identity.1..0 User’s Manual 156 . apply step 1a. read. it would loop through each partial match in the Configured Paths list looking for a defined permission. This represents starting from the root location and moving down the browsing hierarchy. the location Random is a partial match of the full item ID Random. This step occurs only if the NT domain name or private name has been defined in the Users & Groups list. For each partial match from step 2. If found: a.Real4.doe DOMAIN\john. The permission routine would not be able to find an exact location match under the Configured Paths list. The user DOMAIN\john. The first group that contains a permission match will be the one used. If a permission match was not found in step 1a. a match is found and the permission (either allow or deny) is used.doe \ Random Random. or in the Active Directory for NT groups. check whether a partial match of the location is found in the Configured Paths list for the identity. For example.Int would be the closest match and the permission would be ALLOW. to have a permission match. Table 70 lists all defined users and their associated permissions. However. A partial match is always a sub-string of the given location that starts with the same characters.Int4. it also toggles offline mode for all branches underneath it in hierarchy. if offline mode was enabled at the root in the hierarchy. Value between -2147483648 and 2147483647. every branch would have its offline mode enabled. Value between 0 and 255.e. Likewise. Upon server start-up.3. every branch has the #OfflineMode item set to False (i. Value between -8345. but still return data as if the date was coming from it.. Adding this item will allow an OPC client to monitor the offline mode for that location using read operations and provide the ability to toggle offline mode for that location using write operations. A configuration can be set up with to interact with any hardware. all OPC items at that location generate random values according to their data type (the Date data type is the one exception to this). When reading the item #OfflineMode. Offline Mode Item Values When offline mode is enabled at a particular location in the browsing hierarchy.512588035. is provided at each branch in a MatrikonOPC server browsing hierarchy. This is useful in two situations: 1. 2. Table 71 shows the value behaviour for each data type: Data Type Boolean (VT_BOOL) Character (VT_I1) 16-bit Integer (VT_I2) 32-bit Integer (VT_I4 and VT_INT) Byte (VT_UI1) Word (VT_UI2) Double Word (VT_UI4 and VT_UINT) Float (VT_R4) Double (VT_R8) Date (VT_DATE) True or False.0 User’s Manual 157 .5962 and 13388. When offline mode is toggled at a particular location in the hierarchy. offline mode is disabled). the value True represents enabled and the value False represents disabled. named #OfflineMode. Value between 0 and 65525. allowing any problems in the configuration to be worked out without having them affect the device.Appendix G Introduction Offline Mode Offline mode allows the MatrikonOPC Server Framework to be disconnected to the end device. Value between -128 and 127. Value between -32768 and 32767.5962. Behaviour MatrikonOPC Server for Siemens PLCs v1. writing a value of True to #OfflineMode enables offline mode and writing a value of False to #OfflineMode disables offline mode. Offline mode can be applied to the entire configuration of a MatrikonOPC server or to a portion of it. Value between 0 and 4294967295. Current system time. Offline Mode Toggling A Boolean control item. For example. Diagnosing problems becomes much simpler when an implementer can remove the device hardware from the architecture.512588035 and 8345. Value between -13388. When an object is disabled due to offline mode. there is no communication between the server and the end-device/application to which the location refers. To ensure there is no communication in the entire server. Table 71 . To ensure that there is no communication when offline mode is enabled. MatrikonOPC Server for Siemens PLCs v1.0 User’s Manual 158 .Data Type String (VT_BSTR) Simulated or Data.. When offline mode is disabled for that particular object.Offline Mode Item Values Behaviour Operational Effects When offline mode is enabled at a particular location in a server‟s hierarchy.e. the Enabled checkbox will be cleared (i.3. the MatrikonOPC Server Framework will re-enable it and the Enabled checkbox will be selected (i. checked) once again. offline mode should be enabled at the root level. Note: Some servers allow communication to multiple devices/applications. Enabling the object will have no effect while the object has offline mode enabled.e. unselected) in its panel within the configuration utility.. the MatrikonOPC Server Framework will disable the object associated with that branch. 0 User’s Manual 159 . If the MatrikonOPC InstallAware screen does not automatically appear. Once the system requirements have been met. go to step 5. the MatrikonOPC Analyzer tool is installed and used to detect the system settings that affect the use of this software. if required. Insert the MatrikonOPC Server for Siemens PLCs CD into the CD drive. To install the software: 1. No information is communicated back to Matrikon.InstallAware Wizard Verification Window 3. you are ready to install the software.exe file. Figure 89 . MatrikonOPC Server for Siemens PLCs v1. double-click the installation . then click on the Next button to install the listed pre-requisites. Either a Pre-Requisites screen (Figure 90) appears. If the Pre-Requisites screen appears. The MatrikonOPC Server – InstallAware Wizard verifies its contents (Figure 89). 4. If the Licensing Agreement screen is the displayed screen. 2.3. Information is stored on this system only for future use by MatrikonOPC Support to assist with troubleshooting.Appendix H Installation Note: As part of the installation process. or you are taken directly to the Licensing Agreement (Figure 91) screen. 0 User’s Manual 160 . or select the I accept the license agreement option button enabling you to proceed through the install. MatrikonOPC Server for Siemens PLCs v1.Figure 90 . you have the option of selecting the I reject the license agreement option. Note: From the License Agreement screen. cancel the install by clicking on the Cancel button. After all pre-requisites have been installed.Pre-Requisites Screen 5. the License Agreement screen (Figure 91) appears. Selecting the I reject the license agreement option button disables the Next button so your options are to return to the previous screen.3. 7. The Setup Type screen (Figure 92) appears.3. 8. Select the I accept the license agreement option button.License Agreement Screen 6. MatrikonOPC Server for Siemens PLCs v1.Figure 91 . using the scroll bar to view the entire message.0 User’s Manual 161 . Read the Software License Agreement. Click on the Next button. The Destination Folder screen (Figure 93) appears. MatrikonOPC Server for Siemens PLCs v1.Setup Type Screen 9. Select the type of setup to be performed.Figure 92 . Click on the Next button. Note: Matrikon recommends that you select the Complete Setup option.3. 10.0 User’s Manual 162 . Click on the Next button. or accept the default location displayed in the Folder path field.Destination Folder Screen 11. Select the folder in which to install the MatrikonOPC server.Figure 93 . 12. MatrikonOPC Server for Siemens PLCs v1.3. The Start Menu screen (Figure 94) appears.0 User’s Manual 163 . Start Menu Screen 13.Figure 94 . MatrikonOPC Server for Siemens PLCs v1. The Enter Password screen (Figure 95) appears. Select the Start Menu group and specify whether you want shortcuts created only for yourself. by selecting the applicable option button.3.0 User’s Manual 164 . or for all users. 14. Click on the Next button. MatrikonOPC Server for Siemens PLCs v1. refer to Appendix F – Security. Notes: The default password provided for you is MatrikonOPC. Select Programs -> MatrikonOPC -> <OPC Server Name> -> Tag Security. For more information.Figure 95 . Click on the Windows Start button.Enter Password Screen 15. A default password is supplied for you in the Password and Confirm Password fields. Click on the Next button to accept the default password. access the Tag Security shortcut from the Start menu. Note this password for future reference. The Licensing screen (Figure 96) appears.3. If you need to change the password at a later date. 16.0 User’s Manual 165 . Figure 96 .Licensing Screen 17.0 User’s Manual 166 . Select the applicable licensing option.3. MatrikonOPC Server for Siemens PLCs v1. The Ready to Install screen (Figure 97) appears. 18. Click on the Next button. Note: Prior to starting the installation.3.Figure 97 . and the product files are copied to the computer. MatrikonOPC Server for Siemens PLCs v1. installation begins. Click on the Next button. The Installing MatrikonOPC Server for Siemens PLCs screen (Figure 98) appears. Click on the Cancel button if you wish to stop or cancel the installation.0 User’s Manual 167 . you have the option of clicking on the Back button to change any of the installation information.Ready to Install Screen 19. Figure 98 .0 User’s Manual 168 . When the installation has finished. the MatrikonOPC Server for Siemens PLCs Setup Complete screen (Figure 99) appears stating that the MatrikonOPC server has been successfully installed. MatrikonOPC Server for Siemens PLCs v1.Installing MatrikonOPC Server Screen 20.3. MatrikonOPC Server for Siemens PLCs v1. Reference to the DCOM configuration can be found in the DCOM Manual. and shortcut icons are created in the Start menu.3. it is recommended that you verify the DCOM settings.0 User’s Manual 169 . the software components are registered.MatrikonOPC Server Setup Complete Screen 21. The necessary files have now been copied to the target computer. Click on the Finish button to complete the installation and exit the Wizard. you have the option of launching any or all of the following by selecting the necessary checkbox or checkboxes: Configuration panel Release Notes User’s Manual 22. Note: At this point. At this point. 23. This configuration varies for different operating systems.Figure 99 . dll CalcEngineWrapper.dll CalculationGraph.dll ProcessNetDataDelivery_u.dll CalcEngineResource. For information on files not specific to the server that are installed on the system. Release Notes for this product.ocx Description Access control list containing users and permissions configured for the server. MatrikonOPC Siemens PLCs executable.dll dbghelp.sec ACLSecure. Security information file used by the encryption utility.dll clipsdll.pdf OPCSiemensPLC.dll CalcEngine. This User’s Manual.txt PSTCFGMPILib.dll RmsApiProxy.dll icuin40.dll ScriptLibrary.dll icuuc40.Appendix I Installed Files The installation program copies all necessary files to the target computer and creates shortcut icons in the Start menu.exe Altova.pdf ProgID.exe OPCSrvSiemensPLCWizard.pdf MatrikonOPC Server for Siemens PLCs User Manual. listed in Table 72. Siemens PLC configuration wizard. ActiveX configuration panels.dll Scheduler. please refer the MatrikonOPC Server User’s Manual.dll lsapiw32.dll AltovaXML. The files specific to this server. are installed by default in the following location: C:\Program Files\Matrikon\OPC\SiemensPLC File Name ACL.dll NetPortalQueryServerPS.dll icudt40.dll CalcEngineServerPS. Licensing Procedures document.0 User’s Manual . Calculation Engine binary files.dll log4cxx.dll Licensing Procedures.dll Xerces-c_2_8.3.exe MatrikonOPC Server for Siemens PLCs Release Notes. 170 MatrikonOPC Server for Siemens PLCs v1. Command-line security utility used to encrypt/decrypt the ACL file. cfg ServerOpts.dll PXPComfigps. Security settings. MatrikonOPC Tag Security Configuration Utility that configures taglevel security in MatrikonOPC servers. Table 73 .exe Description ActiveX configuration panels.dll opchda10_auto. MatrikonOPC HDA Automation Component – enables developers to access OPC HDA data from client applications developed using Automation tools. ActiveX configuration panels.ini SS7DBSymImport. The initialization file for recording the server‟s initial settings. The proxy-stub file to allow OPC Clients to make remote connections to an OPC HDA server.doc opchda_ps. VBA.ocx PSTCFGTi5Lib. Developer documentation for the HDA Automation Component. and VB Script. VBA.File Name PSTCFGPPILib. Matrikon Product Configuration Utility. Table 72 . Siemens Step 7 Symbol Import utility.ocx PSTCFSiemensPLCLib.doc OPCDAAuto.0 User’s Manual .dll The files listed in Table 74 are installed in the WINDOWS\system32 folder: File Name EXPREVAL.exe PSTCFGBasicInnerLayerLib. ActiveX configuration panels.ocx PSTcfgps. MatrikonOPC OEM Badge Library. in the following location: C:\Program Files\Common Files\MatrikonOPC\Common File Name OPCAnalyzer Logs\ ACLConfig. Matrikon Product Configuration Marshalling Library. 171 MatrikonOPC Server for Siemens PLCs v1.exe EULA. MatrikonOPC Automation Component Interface Standard MatrikonOPC Automation Component – enables developers to access OPC data from client applications developed using Automation tools such as Visual Basic.DLL Description Expression Evaluation Library for Alias Equations.ocx security. Server ActiveX configuration panel.dll OPCAuto.dll Description Logs generated by MatrikonOPC Analyzer.pdf OEM_Matrikon_OPC.Files Installed in "SiemensPLC" Folder The files listed in Table 73 are installed by default. and VB Script.3.dll opcda20_auto. MatrikonOPC Automation Component – enables developers to access OPC data from client applications developed using Automation tools such as Visual Basic.Files Installed in "Common" Folder OPCHDAAuto. Matrikon Product Configuration Library.dll PSTCFG. License document. DLL OPCBC_PS.00 Proxy/Stub Library.DLL OPCCOMN_PS.DLL OPCENUM.Files Installed in "system32" Folder MatrikonOPC Server for Siemens PLCs v1.EXE OPCHDA_PS.dll OPCPROXY.DLL Description OPC Alarms and Events 1. OPC Data Access 2. OPC Data eXchange 1.DLL OPCSEC_PS. OPC Security 1.00 Proxy/Stub Library. OPC Historical Data Access 1.20 Proxy/Stub Library. OPC Server List Component.0a Interfaces and Marshalling Library. Table 74 . OPC Batch Custom 2.DLL ACTXPRXY.File Name OPC_AEPS.0 User’s Manual 172 .00 Proxy/Stub Library. ActiveX Interface Marshalling Library. OPC Common Interfaces and Marshalling Library.3.0 Interfaces Marshalling Library.0 and 1.DLL OPCDXPS. Click on the Remove button associated with the MatrikonOPC Server for Siemens PLCs program to initiate the un-install process. select Add or Remove Programs. using the Add or Remove Programs from the Microsoft Windows Control Panel is recommended. To un-install MatrikonOPC Server for Siemens PLCs: 1. Figure 100 – Add or Remove Programs 5.Appendix J Un-Installation To successfully un-install MatrikonOPC Server for Siemens PLCs. 2. The MatrikonOPC Server for Siemens PLCs – InstallAware Wizard appears. 3. Click on the Start button and highlight the Control Panel item. MatrikonOPC Server for Siemens PLCs v1.0 User’s Manual 173 . 4. Scroll through the list of currently installed programs and updates to find and select MatrikonOPC Server for Siemens PLCs. 6. and the Welcome to MatrikonOPC Server for Siemens PLCs Maintenance screen (Figure 101) is displayed. From the displayed menu. The Add or Remove Programs window (Figure 100) is displayed.3. Select the Remove option button to un-install MatrikonOPC Server for Siemens PLCs entirely. 8.0 User’s Manual 174 .Figure 101 .Welcome to MatrikonOPC Server for Siemens PLCs Maintenance Screen 7. The Ready to Uninstall screen (Figure 102) is displayed. Click on the Next button.3. MatrikonOPC Server for Siemens PLCs v1. The Uninstalling MatrikonOPC Server for Siemens PLCs screen (Figure 103) appears and the un-install takes place. MatrikonOPC Server for Siemens PLCs v1.Figure 102 .3.0 User’s Manual 175 . Click on the Next button.Ready to Uninstall Screen 9. 10. When the un-install has finished. the MatrikonOPC Server for Siemens PLCs Setup Complete screen (Figure 104) appears stating that MatrikonOPC Server for Siemens PLCs was successfully un-installed.Uninstalling MatrikonOPC Server for Siemens PLCs Screen 11.0 User’s Manual 176 . MatrikonOPC Server for Siemens PLCs v1.Figure 103 .3. 3. Click on the Finish button to complete the un-install and exit the Wizard. MatrikonOPC Server for Siemens PLCs v1. The program no longer appears listed in the Add or Remove Programs window. 13.Figure 104 .0 User’s Manual 177 .MatrikonOPC Server for Siemens PLCs Setup Complete Screen 12.