Siemens S7 5.3 FCs for Configured Connections

Programming FCs (Functions) and FBs for S7 Ethernet CPs

148 SIMATIC NET NCM S7 for Industrial Ethernet

C79000-G8976-C129–06

5.3 FCs for Configured Connections

Overview

The following functions (FCs) are available for transferring data over configured

connections:

FC Can be used with 1) Meaning

S7 – 300 S7 – 400

AG_SEND (FC5) x x for sending data

AG_RECV (FC6) x x for receiving data

AG_LSEND (FC50) xfor sending data

AG_LRECV (FC60) xfor receiving data

1) Notes on the FCs in FCs for an S7-300 and S7-400

SS7-300:

With older versions of the Ethernet CPs, the data length per job is restricted to

<=240 bytes (applies up to block version V3.0 of AG_SEND / AG_RECV); with

later versions, longer data records (up to 8092 bytes) can be transferred with

FCs AG_LSEND or AG_LRECV.

With the latest versions of the Ethernet CPs, only FCs AG_SEND and

AG_RECV are used; due to a new and more efficient internal protocol, the data

up to 8092 bytes can be transferred.

SS7-400:

With FCs AG_SEND / AG_RECV the data length per job is restricted to <=240

bytes.

Longer data records (up to 8092 bytes) can be transferred with FCs

AG_LSEND or AG_LRECV.

Please check the manual /3/ of the S7-CP you are using for the data areas

supported. You will find an overview of the versions of the FCs/FBs in the

documentation and block history.

Application

The following diagram illustrates the use of the FCs described here for

bi-directional data transfer on one configured connection.

Contents

Main ! Page Page This Manual on SIMATIC NET NCM S7 for Industrial Ethernet S Audience Scope of this Manual Symbols used in this Manual This Manual on SIMATIC NET NCM S7 for Industrial Ethernet You will find additional information in the following sources: S S S S S S Quick Start CD: Samples covering all aspects of communication Additional Information on SIMATIC S7 and STEP 7 S S S S S S Access to Online Help of STEP 7 and NCM S7 Conventions Contents Page Page Communication via Ethernet CPs in S7 Stations 1.1 Industrial Ethernet Definition All-Round Communication in the Industrial Sector Network Access Communication via Ethernet CPs in S7 Stations 1.2 SIMATIC S7 Communication with S7 Ethernet CPs Types of Communication S S S S S Page Possibilities for Communication between Device Types Configuration and Diagnostics 1.3 PG/OP Communication via Industrial Ethernet Communication via Ethernet CPs in S7 Stations 20 1.3.1 PG Communication with STEP 7 over Industrial Ethernet Requirements for PG Communication Networking the PG / Engineering Station 1.3.2 OP Operation: Connecting Operator Interface Devices via Industrial Ethernet Requirements 1.4 S7 Communication on Industrial Ethernet Nodes Page Configuring S7 Connections Interface in the User Program of the S7 Station Notes on S7 communication between PC/PG station and S7 station S7 communication via routers (one-ended client and server functionality) 1.5 S5-compatible Communication (SEND/RECEIVE Interface1) ISO Transport Connection IP (Internet Protocol) SEND/RECEIVE interface Stations 1.6 FETCH/WRITE Services (Server) Connection Types Coordinating Access Using the User Program SIMATIC S5 1.7 Networking Stations with STEP 7 Configuring Networking in a Multiproject Tools Variants 1.7.1 Network/Project Variant: One Subnet One Project 1.7.2 Network/Project Variant: SIMATIC S5 and Non-SIMATIC Devices on the Subnet 1.7.3 Network/Project Variant: Two or More Subnets One Project 1.7.4 Network/Project Variant: One Subnet More Than One (Sub)Project Possibilities for stations outside the current project Merging projects in the multiproject: 1.7.5 Network/Project Variant: Several Subnets in Several (Sub) Projects Page 1.7.6 Network/Project Variant: Connections between Subnets (TCP/IP) Page Installing and Starting the Ethernet CP with STEP 7 2.1 General Information About the NCM S7 for Industrial Ethernet Option Installation Functions Operation 2.2 Procedure 2.2.1 Creating an Industrial Ethernet Subnet Aims Properties of Merged Subnets (Multiproject) Page 2.2.2 Entering an Ethernet CP in the Hardware Configuration Subnet Attachment Page Setting Addresses in the Configuration and Addressing for the First Time 2.2.3 Displaying the Network Attachments of a Station Graphic Overview in NetPro Overview in Table Form 2.2.4 Setting Further CP Properties Options Tab S Installing and Starting the Ethernet CP with STEP 7 56 S S S S Installing and Starting the Ethernet CP with STEP 7 S Time-of-Day Synchronization Tab Page 2.2.5 Substitute Objects in the STEP 7 Project Attaching Non-S7 Stations to the Subnet Page 2.2.6 Configuring Communication Services Setting Up Connections 2.3 Assigning Addresses for the First Time (Applies to Latest CPs) Meaning of the Address Assignment MAC Address and IP Address Assigning the Address Options and Recommendations Requirements 2.3.1 Addressing by Selecting the Target System in the SIMATIC Manager Follow the steps below to assign the IP address the first time: Page Alternative Procedure 2.3.2 Addressing using the Properties Dialog in HW Config or NetPro Follow the steps below to assign the IP address the first time: 2.4 Downloading the Configuration Data to the Target System Principle Type of Interface Deactivating the MAC Address in the Configuration Saving the Configuration Data in Non-Volatile Memory Downloading the Configured Connections Relocating the CP in the Hardware Configuration Page SEND/RECEIVE Interface in the User Program 3.1 How the SEND/RECEIVE Interface Works on the CPU Functions (FCs) 3.2 Programming the SEND/RECEIVE Interface Principle of Job and Data Transfer Purpose of the FCs Programming Connections Calling FCs in the CPU Program Page 3.3 Data Exchange S7 CPU <> Ethernet CP FC Calls Faster than the Transmission Time FC Calls Slower than the Transmission Time Page 3.4 Additional Information 3.4.1 Programming Data Transfer on TCP Connections Purpose of TCP Connections Special Features 3.4.2 Recommendations for Use with a High Communications Load Known Problems Remedy Page Configuring Communication Connections 4.1 Procedure Steps 4.2 Possible Connection Configurations Page 4.3 Connections Characteristics of a Connection Tasks of the Ethernet CP Requirements for Configuring Connections 4.3.1 Creating a New Connection Principle New Connection Page Page Handling Connections in a Multiproject Connections to Non-S7 Stations using Substitute Objects 4.3.2 Connections to Partners in Other Projects Unspecified Connections Page 96 4.3.3 Further Functions Toolbar In the toolbar of the connection configuration dialog the following functions are available: S S S S Print Function in the Overview Tab 4.3.4 Connections Without Assignment Display (Example) 4.4 Configuring ISO Transport Connections Page Page 4.4.2 Specifying ISO Transport Addresses Address Parameters TSAP Format Local and Remote TSAPs Default TSAPs Addresses Tab Unspecified ISO transport connection 4.4.3 Specifying ISO Transport Dynamic Properties Dynamics Tab Page 4.4.4 ISO Transport with the FETCH/WRITE Mode Page 4.4.5 Checking ISO Transport Connection Properties 4.5 Configuring ISO-on-TCP Connections Properties Page Page 4.5.2 Specifying ISO-on-TCP Addresses Address parameter TSAP Format Local and Remote TSAPs Default TSAPs Addresses Tab Unspecified ISO-on-TCP Connection 4.5.3 ISO-on-TCP with the FETCH/WRITE Mode Page 4.5.4 Checking ISO-on-TCP Connection Properties 4.6 Configuring TCP Connection Properties Page S S 4.6.2 Specifying TCP Addresses Address Parameters and Connection Types Addresses Tab Specified TCP Connection Ports Addresses Tab Unspecified TCP Connection 4.6.3 TCP with the FETCH/WRITE Mode Page 4.6.4 Checking TCP Connection Properties 4.7 Configuring UDP Connection Properties 4.7.1 Specifying the Local Connection Endpoint General Tab Page 4.7.2 Specifying UDP Addresses Address Parameters and Connection Types Addresses Tab Specified UDP Connections Ports Addresses Tab Unspecified UDP Connection 4.7.3 UDP with Broadcast and Multicast When to Use Multicast instead of Broadcast ? Why Does an S7-CP Prevent Reception on Broadcast Connections? Addresses Tab Connection to all Broadcast Nodes Addresses Tab Connection to all Multicast Nodes 4.7.4 Checking the Properties of a UDP Connection 4.7.5 Free UDP Connection Program-Controlled Addressing 4.8 Routing to Distribute Load Routing to Distribute Load - Programming FCs (Functions) and FBs for S7 Ethernet CPs 142 5.1 General Notes on FCs / FBs Block Library Which Block Version Should I Use? FCs and Module Replacement (Spares) S 5.2 Setting Parameters for FC Calls Calling Communication Blocks for an S7-300 5.2.1 Parameters for CP and Connection Assignment (input parameters) Setting Block Parameters Automatically Response to Incorrect Addresses 5.2.2 Parameters for Specifying a CPU Data Area (input parameters) Specifying the Data Area on the CPU 5.2.3 Status Information (output parameters) Evaluating Status Codes Status Codes during CP Startup 5.3 FCs for Configured Connections Specifying the Data Area on the CPU Working without the Job Header Working with the Job Header 5.3.1 FC5 AG_SEND / FC50 AG_LSEND Page Page Page 156 Parameter RemarksPossible Values TypeDeclara- tion S For further information, see /1/ S DONE ERROR STATUS Meaning 158 DONE MeaningSTATUSERROR Example of AG_SEND Page 5.3.2 FC6 AG_RECV / FC60 AG_LRECV Page Page 164 Values Remarks S 166 NDR MeaningSTATUSERROR 5.4 FCs for Access Coordination with FETCH/WRITE Caution when Configuring Page 5.4.1 FC7 AG_LOCK Page 5.4.2 FC8 AG_UNLOCK Page 5.5 Numeric Data / Resource Requirements of the FCs Page NCM S7 Diagnostics 6.1 Overview Diagnostic Options in STEP 7 What You Should Already Know Where to Find Further Information 6.2 Functions of NCM S7 Diagnostics Functions General diagnostic and statistical functions Mode-Dependent Functions 6.2.1 Installing and Starting NCM S7 Diagnostics Installation S Structure Operation 180 6.2.2 General Menu Commands Menu Meaning S S S S 6.3 Starting Diagnostics Establishing a Connection to the Ethernet CP Initial Situation Starting Diagnostics from the NCM Program Group Internetworking Starting Diagnostics from the Properties Dialog of the CP Other Startup Options 6.4 How to Use Diagnostics 186 6.5 Call-Specific Diagnostic Functions The following table shows the diagnostic options that exist in the available functions. S 6.6 Checklist for Typical Problems in a System 6.6.1 Checklist for General CP Functions Problem Possible Cause Identifying the Cause and Remedy 190 6.6.2 Communication Connections Checklist - Problem Possible Cause Identifying the Cause and Remedy Page 7.1 Application 7.2 Loading Firmware Starting the Download 1st Step 2nd Step 3rd Step Page Page A References /2/ Page Page /19/ /20/ /21/ Order Numbers Page B.1 General Section Page Page Page B.2 Industrial Ethernet Base address Ind. Ethernet station ISOonTCP Page TCP/IP UDP B.3 PROFInet Page Page C a) Structure of WRITE Frames a) Structure of FETCH Frames Linking to Other Systems with FETCH/WRITE 214 Parameter Values Linking to Other Systems with FETCH/WRITE PI/PQ C T Page D Document History New in Release 05 / STEP 7 V5.1 SP3 New in Release 04 / up to STEP 7 V5.1 SP2 Page A B C D E J M N O P A&D Technical Support Worldwide, available 24 hours a day: Service & Support on the Internet