Application for Communication

Transcription

1 Application for Communication OPC Communication via the SEND/RECEIVE Protocol with a Visual Basic.NET OPC Client Demonstration

2 Warranty, Liability and Support OPC with SEND/RECEIVE Protocol, Entry-ID: Warranty, Liability and Support We accept no liability for information contained in this document. Any claims against us - based on whatever legal reason - resulting from the use of the examples, information, programs, engineering and performance data etc., described in this document shall be excluded. Such an exclusion shall not apply in the case of mandatory liability, e.g. under the German Product Liability Act ( Produkthaftungsgesetz ), in case of intent, gross negligence, or injury of life, body or health, guarantee for the quality of a product, fraudulent concealment of a deficiency or breach of a condition which goes to the root of the contract ( wesentliche Vertragspflichten ). However, claims arising from a breach of a condition which goes to the root of the contract shall be limited to the foreseeable damage which is intrinsic to the contract, unless caused by intent or gross negligence or based on mandatory liability for injury of life, body or health. The above provisions do not imply a change in the burden of proof to your detriment. The Application Examples are not binding and do not claim to be complete regarding the circuits shown, equipping and any eventuality. They do not represent customer-specific solutions. They are only intended to provide support for typical applications. You are responsible for ensuring that the described products are used correctly. These Application Examples do not relieve you of the responsibility in safely and professionally using, installing, operating and servicing equipment. By using this application example you accept that Siemens is not liable for any damages except for those specified in the above liability clause. We reserve the right to make changes to these Application Examples at any time without prior notice. If there are any deviations between the recommendations provided in this application example and other Siemens publications e.g. Catalogs the contents of the other documents have priority. Copyright 2005 Siemens A&D. It is not permissible to transfer or copy these Application Examples or excerpts of them without first having prior authorization from Siemens A&D in writing. For questions about this document please use the following address: mailto:csweb@ad.siemens.de V /26

3 Foreword OPC with SEND/RECEIVE Protocol, Entry-ID: Foreword Objectives of the application This example application discusses the application of the SEND/RECEIVE protocol with the SIMATIC NET OPC server. The OPC server communicates with the controller via the block and variable services of the SEND/RECEIVE protocol. It demonstrates how an OPC client, which is tailored to individual requirements, is programmed in the programming language Visual Basic.NET. The configuration of the PC station for using the SIMATIC NET OPC server with the SEND/RECEIVE protocol and Industrial Ethernet is also explained. This enables transferring structured data via the OPC interface. Main contents of this application The following main points are discussed in this application: Dealing with the communication services of the SEND/RECEIVE protocol with regards to program technology: Block services (AG_SEND / AG_RECEIVE) Variable services (FETCH / WRITE) for enabling exchange of larger data volumes between PC and mixed automation systems (i.e. SIMATIC S5 and SIMATICT S7). Configuring the SEND/RECEIVE protocol when using Industrial Ethernet Generating an OPC client with graphical user interface Demonstrating the handling of the Data Access interface of the OPC server via the Custom Interface, and the integrating process into.net- Framework using the OPC DA RC-Wrapper Displaying the procedure for implementing an additional acknowledgement mechanism (additional level 7 protocol). V /26

4 Foreword OPC with SEND/RECEIVE Protocol, Entry-ID: Structure of the document The documentation of this application is divided into the following main parts: Introduction Extension Demonstration Additionally, the STEP7 code and the Visual Basic.NET code are available. This third document, the Demonstration part, is aimed at persons who want to have a step-by-step instruction. Part Introduction Application Description and Function Principles Extension Function Principles in detail and Program Structure Demonstration Structure, Configuration and Operation of the Application Description Provides a general overview of the contents. You will learn about the components used (standard hardware and software components and the specially created software). Discusses the detailed function processes of the involved hardware and software components, the solution structures, and where sensible the concrete implementation of this application. This part is necessary if you want to learn about the interaction of the solution components, for example in order to use them as the basis for own development. This part leads you step by step through the structure, important configuration steps, commissioning and operation of the application. An additional component available is the S7 program code. Part S7 program code Visual Basic.NET Code Description The S7 program code includes the code and a user interface which may also be used for demonstration purposes. Contains the program files of the OPC client and the Visual Studio.NET project. Reference for Automation and Drives Service & Support This entry originates from the internet application portal of the A&D Service and Support. The following link takes you directly to the download page of this document. V /26

5 Foreword OPC with SEND/RECEIVE Protocol, Entry-ID: Table of Contents Table of Contents... 5 Introduction Document on Hand Installation of hardware and software Installation of the application software Configuration of the automation stations Setting the IP addresses Installation of the STEP 7 project Importing the XDB file to the Station Configuration Editor Configurations of the application Configuring the OPC server in HWConfig Configuring the connection with the OPC server in NetPro Check the settings Operating the Application Appendix and List of Further Literature Glossary Literature Bibliographic References Internet links V /26

6 Introduction Document on Hand OPC with SEND/RECEIVE Protocol, Entry-ID: Document on Hand Introduction This document is the setup and operating instruction for the application OPC Communication via SEND/RECEIVE Protocol with a Visual Basic.NET OPC-Client. The documents Introduction and Extension describe the basic setup of the application and the employed function components, as well as their interaction within this application. The document on hand only discusses setup and operation of the example application. V /26

7 Content This part leads you step by step through the structure, commissioning and operation of the application. 2 Here you will find further information on the hardware and software to be installed, and the steps necessary for commissioning the example. 2.1 Installation of hardware and software This chapter describes the hardware and software components to be installed. The description and manuals as well as delivery information contained in the delivery scope of the respective products, should be followed in any case. Installation of the hardware For details on the hardware components, please refer to Introduction document of this application. For the hardware setup, proceed in accordance with the table below: Table 2-1 No. Instructions Set up the S7station (power supply, CPU and CP). Integrate the CP 1613 into your PG / PC. Note Note At the next start of the computer the card is automatically recognized. The required software / drivers are not installed during the installation of STEP 7 and SIMATIC NET. They must be explicitly installed. Please connect the controller with the PC via hub. Note Instead of using a hub or a switch you can also use a cross cable for a direct connection. Note The setup guidelines for SIMATIC S7 must generally be followed. V /26

8 Installation of the standard software A description of the installation procedure for STEP 7 and SIMATIC NET is not part of this documentation. The installation takes place in the familiar Windows environment and is self-explanatory. 2.2 Installation of the application software The executable example program is provided to you in form of a setup.exe file. Note The.NET-Framework V1.1 required for this application is installed by the SIMATIC NET software V6.2 SP1. If this is not the case, respective information are available on the Microsoft page Table 2-2 For installing the operator user interface proceed as follows: 1 Extract the _OPC_SR_CODE_v10.zip file to a Uninstall by deleting the files. directory on your hard disk. V /26

9 2.3 Configuration of the automation stations For a smooth operation procedure the following sequence should be kept: Table 2-3 No. Instructions 1 Setting the IP addresses 2 Installation of the STEP 7 project 3 Importing the XDB file to the station manager The following chapters have been structured in this very sequence Setting the IP addresses The STEP 7 project for this example uses the following IP addresses and subnet masks. Should you make adjustments to the IP addresses, please ensure that the IP addresses fit with the set subnet masks. Table 2-4 Focus Module IP address Sub-network mask PG/PC CP Controller CP Configuration of the PG/PC network card In order to commission the example, the network card in the PG/PC must be configured as follows: Note For test purposes it is recommended to not install this example in an existing network, but to set up a separate test network. V /26

10 Table Open the Local Area Connection Properties dialog box via Start Control Panel Network <Connection name of network connection> Properties. 2 From the list This connection uses the following items: you select the entry Internet Protocol (TCP/IP) and click Properties 3 Change to Use the following IP address: and set the IP address (e.g ) as well as a subnet mask (e.g ). The field Default gateway can stay empty. Acknowledge this and the previous dialog with OK. The dialog Internet Protocol(TCP/IP)Properties opens. Configure the PG/PC interface In order to be able to load the S7 program and the configuration to the S7-300 station via Industrial Ethernet the PG/PC interface must be set accordingly. Please follow the instructions listed in the table: Table Start the SIMATIC manager. 2 Open the dialog Set PG/PI Interface with OK. Options Set PG/PC interface 3 From the list Interface Parameter Assignment Used you select the entry CP1613(RFC1006). 4 Quit the dialog box with "OK". V /26

11 Assign IP address Table 2-7 The S7-300 station can only be accessed with STEP 7 after an IP address has been assigned to the CP Please follow the instructions listed in the table: 1 In the SIMATIC Manager you open the dialog Assign Ethernet Address via the menu: Target system Assign Ethernet Address... 2 Start the search for stations at the Ethernet network with the Browse... button. 3 Select the S7-300 CP from the list and close the dialog with OK. The Browse Network dialog is displayed in which all accessible Ethernet stations are listed. 4 In the IP Address field you specify an IP address for the CP (e.g ). In the field Subnet mask you enter the same subnet mask as in the PG/PC (e.g ; see Configuration of the PG/PC network card ) Note Please ensure, that the IP addresses of PG/PC and CP correspond with each other. This is best achieved if the last digit of both IP addresses only differs by one. 5 Allocate the IP address set by you, to the CP by pressing Assign IP Configuration. 6 Quit the dialog box with "OK". 7 Switch the CP to RUN mode by pressing the mode switch. The S7 station can now be reached from the SIMATIC Manager via Ethernet. V /26

12 2.3.2 Installation of the STEP 7 project Retrieving the project After the connection from PC to CP has been implemented successfully, please proceed as follows: Table Open the SIMATIC Manager. 3 Extract the project via the menu File - > Retrieve 4 Select a directory into which the project files are to be retrieved and open the project. Use the browser to search the _OPC_SR_STEP7_v10.zip project and click OK to confirm. Adjust the hardware configuration in the STEP 7 project If using a hardware configuration which differs from that in this example (see Introduction document of this application), the example project on hand needs to be adjusted accordingly. Adjusting the network configuration in the STEP 7 project In order to adjust the STEP 7 example project to your setup, perform the following steps. Table Open the extracted STEP 7 project App04 in the SIMATIC Manager. 2 Start the network configuration tool NetPro via the button. The network configuration on the right will be displayed. 3 Adjust the IP address of the PG/PC SIMATIC PC-Station(1) : Double-click CP1613 in the PC station Change the IP address and the subnet mask to the values actually set on the PG/PC via the Properties button. Click OK to confirm the properties dialogs. IP address and subnet mask, see Configuration of the PG/PC network card. V /26

13 4 Adjust the IP addresses of the S7-300 station: Double-click CP in the SIMATIC 300(1) station Change the IP address and the subnet mask to the desired values by pressing Properties in the General tab. Click OK to confirm the properties dialogs. 5 Save and compile the configuration with the button. 6 Select the SIMATIC 300 station and load the Please ensure, that the same stations have been set in the both stations and that the IP addresses correspond. IP address and subnet mask, see Assign IP address. configuration data to the controller using the button. 7 Close NetPro. Load blocks into the S7-300 station Next, the blocks of the S7 program must be loaded to the S7-300 station. Follow the instructions of the table below. Table Select the block folder of the SIMATIC 300 station in the STEP 7 project App04. 2 Load the blocks to the controller via the button. 3 Switch the CPU DP to RUN mode by pressing the mode switch. The system data needs not be loaded. V /26

14 2.3.3 Importing the XDB file to the Station Configuration Editor Table 2-11 In order to use the OPC server on the PG/PC the configuration must be loaded from the STEP 7 project to the Station Configuration Editor of the PG/PC. Please follow the instructions below: 1 Open the Station Configuration Editor on the PG/PC via: Start Station Configuration Editor 2 Open the Import XDB-file dialog with the Import station... button. 3 Select the XDB-file pcst_1.xdb of the STEP 7 project App04. It is located at: <LW>\<Project directory>\ App04\XDBs\ 4 Open the Station Configuration Editor dialog with Open. 5 Start the import by pressing OK. After a successful import the Station Configuration Editor should display the configuration on the right. 6 Adjust the station name of the PG/PC via Station name. The station name equals the name of the PC station in the STEP 7 project. In this example: GS_03_02. 7 Close the Station Configuration Editor dialog box. Confirm the message with Yes. This XDB file contains the complete PG/PC configuration. Example for project directory: C:\Programs\Siemens\Step7\S7Proj\ App04\XDBs Even if a warning is displayed in the Station Configuration Editor dialog ( ), the import can be performed. The station name in the Station Configuration Editor is different to the computer name of the PG/PC (see Control Panel System). Note The application is now runnable! For operating the application you can continue with chapter 3 Operating the Application. The following explanation on configuration only becomes necessary if you wish to make adjustments or want to know which configurations were made prior to this application. V /26

15 2.4 Configurations of the application the configurations made in the course of this application. There are several options for configuring the OPC server. Here, generating an XDB file with STEP 7 is illustrated which can then be loaded to the station manager. Note You must first create the PG/PC interface according to chapter Configuring the OPC server in HWConfig Table Create a new station of the type SIMATIC PC Station in your STEP 7 project. 2 Open the created station by double-clicking Configuration 3 Add a SIMATIC NET OPC server to slot 1. Below, it is assumed that the partner station (SIMATIC S7-300 station) has already been configured. The hardware configuration opens. This application uses the SIMATIC NET OPC server V Add a CP 1613 to slot 2. This application uses a CP 1613 V6.0 SP5. After adding the CP, the Properties Ethernet Interface dialog opens. V /26

16 5 Set the parameters as in the screenshot on the right. Note: If no IE network has been configured yet, you generate a new one with New... and apply the standard parameters. 6 Save and compile the hardware configuration with. Close the hardware configuration Configuring the connection with the OPC server in NetPro Table Open NetPro with the button. 2 Select the OPC server. V /26

17 3 Generate a new connection with a right-click. 4 Select CPU 315-2DP as connection partner. Select ISO-on-TCP connection as the connection type. Acknowledge with OK. V /26

18 5 In the Options tab of the following dialog you determine the operating mode of the connection. Send/Recv, Fetch or Write can be selected. 6 In the OPC tab you have to set the send buffer for the Send/Receive connection. Note: It must correspond with the data length entered at the receive block in S7. 7 This enables you to configure all required connection. Note: Two SR connections and respectively one Fetch and one Write connection are required for this project. 8 Save and compile the configuration with. 9 Close NetPro. Note The created XDB file, automatically generated during compiling, can now be loaded to the station manager via import. Proceed analog to chapter V /26

19 2.4.3 Check the settings Table 2-14 The settings can be checked with the configuration dialog for the OPC server. The following settings should be considered: 1 Open the configuration console Set PC Station via the start menu: 2 Check the set access point. With: Start Simatic SIMATIC NET Set PC Station 3 Check the set IP address V /26

20 4 Check the set protocols. Note: Activating the SR protocol is sufficient for this application. 5 If one of the settings does not correspond with the displayed images, perform the preceding configuration again. Close the configuration dialog box. V /26

21 Operating the Application 3 Operating the Application Here you will find information on how to operated all function of this application. User interface The following figure shows the user interface of the example program. Figure 3-1 Description of the user interface In the following table, all interactive controls are described. No. corresponds to the respective number in Figure 3-1. Table 3-1 No. Description 1 Establishing the connection with the OPC server specified in Server name (SIMATIC NET OPC server). This corresponds to the ProgID of the server. 2 Values for / from the memory bit double-words 200, 204 and 208 on the controller. 3 Enables reading and writing the values using the variable services. Here you can either use Fetch or Write. When using Fetch the result data fetched from the controller are displayed at (2). When using Write the data to be entered by you at (2) are used and sent to the controller. 4 Enables entering data to be sent to the controller by means of block services. 5 Transfer of data from PC to S7 by means of block service using the data of (4). 6 Transfer of data from S7 to PC using a block service. Result in (7). 7 Data transfer result from (6). 8 Disconnection from the OPC server. V /26

22 Operating the Application Operating sequence: Starting and operating the visualization The following instructions specify the operating options for the example program in connection with the preceding table. Instructions 1 Start the Application04.exe file in the directory: [Installation directory]\application04\bin Note Installation directory: see 2.2 Installation of the application software 2 After starting the application the user interface appears as in Figure The only option you have is pressing Connect. All actions are performed which lead to establishing a connection with the OPC server. Furthermore, all required OPC items are created. Now you have the option of either using the variable services in Variables or the block services in Block. Using of either is not exclusive of the respective other. 5 In Variables you can enter enter values and send them to the controller with Write. or fetch the actual values from the controller using Fetch. 6 In Blocks you can either send PC->S7 values to the controller, or receive S7->PC values from the controller. 7 With Disconnect you can interrupt the connection to the OPC server any time. V /26

23 Operating the Application Variable table Figure 3-2 The variables are available in the included STEP 7 project "App04". V /26

24 Appendix and List of Further Literature Glossary 4 Glossary Appendix and List of Further Literature COM DCOM Component Object Model: Software model for communication between components based on a standardized interface; DCOM Distributed Object Model: Software model for communicating beyond computer boundaries based on COM. Eventhandler An Event handler processes occurring events or Windows messages. Exception An Exception is referred to as an exceptional situation. It can be generated either by the operating system (e.g. Division by zero) or by the user program. Exception handler An Exception handler processes occurring exceptional situations. Generally a secured error behavior and/or a message to the user. HRESULT Return data type of COM objects. IDL OPC Interface Definition Language: A Microsoft standard language for definition of function and parameter interfaces. OLE for process control. A standardization for process control created for the automation sector. Maintained by the OPC - Foundation. Several interfaces with different tasks exist. OPC client A program which uses the services of an OPC server by sending requests to the server via existing OPC interfaces. OPC DA OPC Data Access interface. The interface enables monitoring and changing of process values. V /26

25 Appendix and List of Further Literature Glossary OPC server A program which provides one of the OPC interfaces and responds to requests of an OPC client. Polling RCW Term referring to (mostly cyclical) polling of certain values or states. Runtime Callable Wrapper. A wrapper which encapsulates a Custom interface for the.net Framework. The RCW enables accessing older COM ports for the.net Framework. Sink interface Using the sink interface, messages between components can be sent. The sink interface is based on COM mechanisms. Windows message The standard Microsoft Windows operating systems exchange messages to notify of events, e.g. the paint event. Wrapper The term Wrapper normally refers to a class group which encapsulates other class groups for data conversion or easier handling. It can be considered an envelope enclosing the wrapped classes, covering them from the outside. V /26

26 Appendix and List of Further Literature Literature 5 Literature 5.1 Bibliographic References This list is by no means exhaustive and only gives a selection of appropriate sources. Table 5-1 Topic Title /1/ STEP 7 Automatisieren mit STEP 7 in AWL und SCL (Automating with STEP7 in STL and SCL) Hans Berger published by: Publicis MCD Verlag ISBN /2/ SIMATIC NET, Industrial communication /3/ SIMATIC NET, Advanced PC Configuration SIMATIC NET, Industrial communication with PG/PC Volume 1 Basics, System Manual (on SIMATIC NET CD) SIMATIC NET Commissioning PC Stations - Manual / Quick Start (on SIMATIC NET CD or in Product Support at entry-id: ). /4/ Setting up S7-300 S7-300, CPU 31xC and CPU 31x: Installation Operating Instructions (available in the Product Support; Entry ID: ). /5/ Power-PG manual SIMATIC Field PG P4, Manual (available in the Product Support; Entry ID: ). 5.2 Internet links This list is by no means exhaustive and only gives a selection of Topic \1\ Reference to this documentation \2\ Siemens A&D Customer Support Title V /26