Siemens SIMATIC NET CP 5613 User manual

SIMATIC NET
DP Base Programming Interface
for CP 5613/CP 5614
Manual
Preface, Contents
Basic Steps in Creating a DP
Application 1
Overview of PROFIBUS DP 2
Overview of the DP Base
Interface 3
Description of the DP
Functions, Data, and Error
Codes 4
FAQ (Frequently Asked Ques-
tions) 5
Where to Get Help,
Index, Glossary
C79000-G8976-C108-02
Release 2 1999

Copyright Siemens AG, 1999, All rights reserved
The reproduction, transmission or use of this document or its
contents is not permitted without express written authority.
Offenders will be liable for dama
g
es. All ri
g
hts, includin
g
ri
g
hts
created by patent
g
rant or re
g
istration of a utility or desi
g
n, are
reserved.
Disclaimer
We have checked the contents of this manual for a
g
reement with
the hardware and software described. Since deviations cannot be
precluded entirely, we cannot
g
uarantee full a
g
reement. However,
the data in this manual are reviewed re
g
ularly and any necessar
y
corrections included in subsequent editions. Su
gg
estions for
improvement are welcome.
Siemens AG
Bereich Automatisierungs- und Antriebstechnik
Postfach 48 48, D-90327 Nürnberg
C79000-G8976-C108-02
© Siemens AG 1999
Technical data subject to change.
Siemens Aktiengesellschaft Printed in the Federal Republic of Germany
Safety Guidelines
This manual contains notices which you should observe to ensure your own personal safety, as well as to
protect the product and connected equipment. These notices are highlighted in the manual by a warning
triangle and are marked as follows according to the level of danger:
!Danger
indicates that death, severe personal injury or substantial property damage will result if proper precautions
are not taken.
!Warning
indicates that death, severe personal injury or substantial property damage can result if proper precautions
are not taken.
!Caution
indicates that minor personal injury or property damage can result if proper precautions are not taken.
Note
draws your attention to particularly important information on the product, handling the product, or to a
particular part of the documentation.
Qualified Personnel
Only qualified personnel should be allowed to install and work on this equipment . Qualified persons are
defined as persons who are authorized to commission, to ground, and to tag circuits, equipment, and
systems in accordance with established safety practices and standards.
Correct Usage
Note the following:
!Warning
This device and its components may only be used for the applications described in the catalog or the
technical description, and only in connection with devices or components from other manufacturers which
have been approved or recommended by Siemens.
This product can only function correctly and safely if it is transported, stored, set up, and installed correctly,
and operated and maintained as recommended.
Trademarks
SIMATIC®and SIMATIC NET®are registered trademarks of Siemens AG.
Third parties using for their own purposes any other names in this document which refer to trademarks
might infringe upon the rights of the trademark owners.

DP Base Programming Interface for CP 5613/CP 5614
C79000-G8976-C108-02 3
Preface
Purpose of the Manual
This manual supports you when creating user programs for the DP programming
interface of the CP 5613/CP 5614.
It is assumed that you are familiar with writing user programs in the "C"
programming language in Windows NT.
Validity of the Manual
This manual applies to the following software versions:
xCP 5613/CP 5614 (DP Base V1.0)
xCP 5613/CP 5614 (DP Base V1.1)
xCP 5613/CP 5614 (DP Base V1.2)
Guide to the Manual
To help you to find specific information quickly, the manual includes the following
parts:
xAt the front of the manual you will find a complete table of contents.
xAt the back of the manual, you will find a comprehensive index with which you
can find topics quickly.
xAfter the index, there is also a glossary in which important terminology used in
the manual is defined.

Preface
DP Base Programming Interface for CP 5613/CP 5614
4C79000-G8976-C108-02

DP Base Programming Interface for CP 5613/CP 5614
C79000-G8976-C108-02 5
Contents
1 Basic Steps in Creating a DP Application ......................................................................9
2 Overview of PROFIBUS DP ...........................................................................................13
2.1 Where Does PROFIBUS DP Fit In?.....................................................................14
2.2 The Master-Slave Concept of PROFIBUS DP......................................................16
2.3 Cyclic Polling by the Master.................................................................................18
2.4 Process Image of the DP Master .........................................................................19
2.5 Startup and Operational Phase of a DP System...................................................21
2.6 Modes of the DP Master......................................................................................23
2.7 Separation of the Slave Data from the User Program...........................................25
2.8 Reliability of DP...................................................................................................27
2.9 Control Frames to One or More Slaves................................................................28
2.10 Typical Sequences in DP.....................................................................................30
2.11 DP-V1 As an Extension of DP..............................................................................32
2.12 Slave Functionality of the CP 5614......................................................................34
3 Overview of the DP Base Interface ...............................................................................37
3.1 Functions and Data .............................................................................................38
3.2 The Importance of Configuration..........................................................................40
3.3 Consistent Access to the process image..............................................................42
3.4 Working with Hardware Events............................................................................43
3.5 Fast Logic ...........................................................................................................44
3.6 Overview of Triggering and Receiving Events......................................................45
3.7 Typical Sequences..............................................................................................47
3.7.1 Initializing and Exiting the Master Mode...............................................................47
3.7.2 Typical Sequences in Polling Master Operation ...................................................49
3.7.3 Typical Sequences for Polling DPC1 master operation.........................................51
3.7.4 Typical Sequences in Master Operation with Hardware Events............................53
3.7.5 Typical Sequences in DPC1 Operation with Semaphores ....................................56
3.8 Properties of the CP 5614 (Slave Functions, Transfer Software)..........................58
3.9 Typical Sequences for the CP 5614 Slave Module...............................................59
3.9.1 Initialization and Shutdown of the Slave Module in the "Simple" Mode .................59
3.9.2 Initialization and Shutdown of the Slave Module in the Dynamic" Mode................60
3.9.3 Typical Sequences with Semaphores on the Slave Module..................................63
3.10 Multiple Protocols, User Programs, CPUs............................................................65

Contents
DP Base Programming Interface for CP 5613/CP 5614
6C79000-G8976-C108-02
4 Description of the DP Functions, Data, and Error Codes ............................................67
4.1 List of Functions of the CP 5613 and CP 5614.....................................................68
4.1.1 Overview of the Functions ...................................................................................70
4.1.2 DP_start_cp ........................................................................................................72
4.1.3 DP_reset_cp........................................................................................................73
4.1.4 DP_open.............................................................................................................74
4.1.5 DP_get_pointer ...................................................................................................75
4.1.6 DP_release_pointer.............................................................................................77
4.1.7 DP_close.............................................................................................................78
4.1.8 DP_get_err_txt....................................................................................................80
4.1.9 DP_set_mode......................................................................................................81
4.1.10 DP_slv_state.......................................................................................................83
4.1.11 DP_read_slv_par.................................................................................................85
4.1.12 DP_global_ctrl.....................................................................................................87
4.1.13 DP_ds_read........................................................................................................89
4.1.14 DP_ds_write........................................................................................................92
4.1.15 DP_read_alarm...................................................................................................95
4.1.16 DP_alarm_ack.....................................................................................................98
4.1.17 DP_get_actual_cfg............................................................................................101
4.1.18 DP_enable_event..............................................................................................104
4.1.19 DP_disable_event .............................................................................................109
4.1.20 DP_get_result....................................................................................................110
4.1.21 DP_get_cref ......................................................................................................113
4.1.22 DP_init_sema_object.........................................................................................114
4.1.23 DP_delete_sema_object....................................................................................116
4.1.24 DP_fast_logic_on..............................................................................................117
4.1.25 DP_fast_logic_off ..............................................................................................121
4.1.26 DP_watchdog....................................................................................................122
4.2 Additional Functions of the CP 5614..................................................................125
4.2.1 Overview of the Slave Module Functions ...........................................................126
4.2.2 DPS_open.........................................................................................................128
4.2.3 DPS_close ........................................................................................................132
4.2.4 DPS_start..........................................................................................................133
4.2.5 DPS_stop..........................................................................................................134
4.2.6 DPS_get_baud_rate..........................................................................................135
4.2.7 DPS_get_gc_command.....................................................................................137
4.2.8 DPS_get_state..................................................................................................139
4.2.9 DPS_set_diag ...................................................................................................141
4.2.10 DPS_get_ind.....................................................................................................143
4.2.11 DPS_set_resp...................................................................................................148
4.2.12 DPS_calc_io_data_len ......................................................................................150
4.3 Access to the Process Image of the CP 5613/CP 5614......................................151
4.3.1 Reading the Input Data of a DP Slave................................................................152
4.3.2 Reading the Diagnostic Data of a DP Slave.......................................................154
4.3.3 Writing the Output Data of a DP Slave...............................................................156
4.3.4 Checking the Slaves for Changed Data .............................................................158
4.3.5 Querying the State of a DP Slave......................................................................160
4.3.6 Querying Information about the DP Master ........................................................162
4.3.7 Querying the Current Bus Parameters of the Master..........................................163
4.3.8 Querying Information about DP Slaves..............................................................165
4.3.9 Reading PROFIBUS Statistical Data..................................................................166
4.3.10 Querying the Fast Logic Status..........................................................................168
4.3.11 Reading and Triggering User Watchdog in the Dual-Port RAM...........................170

Contents
DP Base Programming Interface for CP 5613/CP 5614
C79000-G8976-C108-02 7
4.3.12 Activating/Deactivating the Generation of Hardware Events...............................172
4.3.13 Sending Data with the CP 5614 as DP Slave.....................................................174
4.3.14 Receiving Data with the CP 5614 as DP Slave ..................................................175
4.3.15 Sending Diagnostic Data with the CP 5614 as DP Slave....................................176
4.4 Error Codes.......................................................................................................177
4.4.1 Entries in the error_decode, error_code_1 and error_code_2 Structure
Elements...........................................................................................................181
4.5 Formats of the Slave Data.................................................................................185
4.6 Formats of the Slave Diagnostic Data................................................................186
4.6.1 Overview of the Entire Structure........................................................................187
4.6.2 Format of the Diagnostic Data Header...............................................................188
4.6.3 Format of the Device-Related Diagnostic Data (Standard DP Slave)..................192
4.6.4 Format of the Device-Related Diagnostic Data (Slaves with DP-V1
Extensions) .......................................................................................................193
4.6.5 Format of ID-Related Diagnostics......................................................................198
4.6.6 Format of Channel-Related Diagnostics.............................................................199
4.7 Format of the Slave Parameter Data..................................................................203
4.7.1 Structure of the General Slave Parameters........................................................204
4.7.2 Structure of the Parameter Assignment Data.....................................................207
4.7.3 Structure of the Configuration Data....................................................................212
5 FAQ (Frequently Asked Questions)............................................................................215
5.1 FAQs about the Range of Functions of the Product ...........................................216
5.2 FAQs about Structuring the User Program.........................................................218
5.3 FAQ Check List for Programmers......................................................................221
5.4 FAQs about Debugging and Starting Up Your Program......................................224
5.5 FAQs Miscellaneous Programming Questions...................................................225
6 Where to Get Help........................................................................................................229
6.1 Help with Technical Questions...........................................................................230
6.2 Contacts for Training with SIMATIC NET...........................................................233
7 Index.............................................................................................................................235
8 Glossary.......................................................................................................................239

Contents
DP Base Programming Interface for CP 5613/CP 5614
8C79000-G8976-C108-02

DP Base Programming Interface for CP 5613/CP 5614
C79000-G8976-C108-02 9
Basic Steps in Creating a DP Application 1
This chapter recommends a step-by-step procedure for creating a DP user
program based on the DP programming interface of the CP 5613 and CP 5614
known as "DP Base". The steps begin with the basics of PROFIBUS DP and are
completed when you test your application.
The DP Base programming interface allows direct access to the DP process image
in the dual-port RAM of the module. The DP Base programming interface is
therefore not compatible with the DP programming interface of the CP 5412 (A2),
the CP 5511, and the CP 5611.

Basic Steps in Creating a DP Application
DP Base Programming Interface for CP 5613/CP 5614
10 C79000-G8976-C108-02
Procedure
The steps outlined below represent the fastest and simplest way of achieving your
aims:
Step Description
1 Familiarize yourself with the basic principles of PROFIBUS DP. Read
the following chapter 2 (“Overview of PROFIBUS DP").
2Familiarize yourself with the basic characteristics of the DP Base
programming interface of the CP 5613 and CP 5614. Read the
following chapter 3 (“Overview of the DP Base Interface").
3 Check through the contents of the subfolder "prog" in your installation
folder so that you know what it contains and the purpose of the
components for the subsequent steps.
The subfolder contains the following:
The "readme.txt" file with the latest additional information and most
recent modifications.
The C header file "dp_5613.h" with the functions and data structures
of the DP Base interface and "5613_ret.h" with the return codes.
The import libraries "dp_base.lib" and "dps_base.lib" for linking to
your user program.
The sample programs and corresponding databases in the
"examples" subfolder.
4Now work through the source text of the sample program "ExamEasy"
and read through the functions and data accesses in Chapter 4
Description of the DP Functions, Data, and Error Codes
5 Adapt the "ExamEasy" sample program to suit your system
configuration by, for example,using additional or different slaves.
Compile and link the sample program and try it out. You may need to
extend the "ExamEasy" sample database (with COM PROFIBUS).
6Now work through the source text of the sample program "ExamComp",
modify the program and try it out with an extended sample database.
7 If you want to use the slave functions of the CP 5614, you should also
work through the "transfer" sample, modify it to your requirements and
try it out with an extended sample database.
8Please read the FAQs in Chapter 5, particularly the check list for
programmers and the information on structuring your user program.
Table continued on next page

Basic Steps in Creating a DP Application
DP Base Programming Interface for CP 5613/CP 5614
C79000-G8976-C108-02 11
Table continued from previous page
Step Description
9Now create your own DP user program. You can use the "ExamComp"
sample as a basis.
10 Test your application. Refer to the information and tips in the FAQ list in
Chapter 5 and the diagnostic tools described in the installation
instructions.

Basic Steps in Creating a DP Application
DP Base Programming Interface for CP 5613/CP 5614
12 C79000-G8976-C108-02

DP Base Programming Interface for CP 5613/CP 5614
C79000-G8976-C108-02 13
Overview of PROFIBUS DP 2
This chapter will familiarize you with the basic principles of PROFIBUS DP.

Overview of PROFIBUS DP
DP Base Programming Interface for CP 5613/CP 5614
14 C79000-G8976-C108-02
2.1 Where Does PROFIBUS DP Fit In?
PROFIBUS - The Worldwide Fieldbus Strategy
The trend towards reducing costs in automation engineering has meant that
programmable controllers (PLCs), PCs, drives, transducers and sensors are being
networked more and more. This has resulted in greater distribution of these field
devices using a fieldbus as the common communications medium for exchanging
information.
The demand for an open, heterogeneous fieldbus system representing a safe and
long-term investment for the user has been met by PROFIBUS. PROFIBUS is a
bus system for communication between programmable controllers or PCs and field
devices based on the European standard EN 50 170, Volume 2. This means that
both users and manufacturers can be certain about long-term investments and
guarantees "openness" for all applications conforming with the standard worldwide.
With more than 2 million network nodes in over 200,000 applications, PROFIBUS
is the most successful open fieldbus having proved itself in applications in
production automation, process automation, drive engineering, and building
automation.
The PROFIBUS users organization represents a widespread information forum for
PROFIBUS manufacturers and users. This is an organization involving more than
800 users, manufacturers and advisers from more than 20 countries worldwide. As
a result of this cooperation, more than 1600 products are now available for use in
PROFIBUS systems.
Siemens has supported PROFIBUS for many years as an optimized fieldbus
solution and reliable investment for the user and supplies both products and
complete systems. Apart from the programmable controllers (PLCs), devices such
as network components, PC communications processors, and field devices for
PROFIBUS are also included in the wide range of products.
The Role of the PC in PROFIBUS
Apart from the trend towards distribution, the standard PC is also becoming more
important as an automation tool particularly in control tasks and for plant
visualization thanks to its increased performance and widespread availability.

Overview of PROFIBUS DP
DP Base Programming Interface for CP 5613/CP 5614
C79000-G8976-C108-02 15
The Advantages of DP
PROFIBUS DP is intended for fast data exchange in the fieldbus area.
Distributed peripheral devices collect the input signals locally and transfer them via
the fieldbus to the central controller in the PG/PC. In the opposite direction, the
central controller sends the output data to the distributed peripheral devices.
The use of PROFIBUS DP means a considerable reduction in cabling compared to
previous direct wiring of components.

Overview of PROFIBUS DP
DP Base Programming Interface for CP 5613/CP 5614
16 C79000-G8976-C108-02
2.2 The Master-Slave Concept of PROFIBUS DP
Distributed I/Os
The distributed peripheral I/Os (abbreviated to DP in the remainder of this manual)
allow a large number of analog and digital input/output modules to be used in a
distributed structure in the immediate vicinity of the process.
Node Classes
PROFIBUS DP defines two classes of bus nodes. Slaves as peripheral devices are
passive nodes. Masters (class 1) are active nodes and control the slaves.
DP Master Class 1
Using the CP 5613 or CP 5614, the PC can adopt the role of DP master.
Depending on the application, this role can also be adopted by, for example,a
SIMATIC S7 programmable logic controller. In the remainder of the manual, the DP
master class 1 is simply referred to as DP master.
DP Master Class 2
When installing and configuring the DP system or controlling the plant during
operation, you can also use master class 2 devices.

Overview of PROFIBUS DP
DP Base Programming Interface for CP 5613/CP 5614
C79000-G8976-C108-02 17
DP Slave
A DP slave is a peripheral device from which the master reads in input information
and to which it sends output information. There are also devices that provide only
input or only output information.
Slaves are generally inexpensive since passive participation on the bus is simple to
implement.
Figure 1 illustrates the basic structure and the components of a PROFIBUS DP
system controlled by a computer with a PROFIBUS master installed
(CP 5613/CP 5614).
DP slaves
DP master with
PROFIBUS
PC adapter
CP 5613
PROFIBUS
Process
Figure 1 Basic Structure of a DP System.

Overview of PROFIBUS DP
DP Base Programming Interface for CP 5613/CP 5614
18 C79000-G8976-C108-02
2.3 Cyclic Polling by the Master
Polling
Communication between the DP master and the distributed nodes takes the form
of polling. Polling means that the DP master sends cyclic calls to its slaves during
the productive phase. A separate call frame is sent to each DP slave.
In one polling cycle, all the operational DP slaves are addressed. The next polling
cycle starts as soon as the last slave has been addressed. This ensures that the
data is up to date.
DP master
Input data
Output data
DP slaves
Figure 2 Schematic Representation of Polling
Output Data
The call frame contains the current output data that the DP slave will apply to its
output ports. The data belonging to this area are specified by the DP application. If
a DP slave does not have output ports, an "empty frame" is sent to it instead.
Input Data
The reception of a call frame must be confirmed by the DP slave by returning a
confirmation frame. The confirmation frame contains the current input data that are
applied to the input ports of the DP slave. If a DP slave does not have input ports,
an "empty frame" is returned instead.

Overview of PROFIBUS DP
DP Base Programming Interface for CP 5613/CP 5614
C79000-G8976-C108-02 19
2.4 Process Image of the DP Master
Automatic Updating of the Data
The CP 5613 or 5614 as the PROFIBUS DP master polls the data of the slaves
continuously and buffers this data on the PC. The DP application accesses this
data directly. This means that the DP application is not involved in polling the
slaves.
Figure 3 shows an overview of the data areas on the DP master.

Overview of PROFIBUS DP
DP Base Programming Interface for CP 5613/CP 5614
20 C79000-G8976-C108-02
Data Areas
There are three different data areas on the DP master for each configured DP
slave, as follows:
xInput data from the DP slave
xOutput data to the DP slave
xDiagnostic data from the DP slave
The data are buffered by the CP 5613 or CP 5614 in memory that can be accessed
by the AP application directly without requiring function calls.
Slave data
DP master
Slave n
Slave 2Slave 1
DP application
PROFIBUS
Output data Dia
g
. data
Input data
Figure 3 Data Areas of the DP Master