Analyzing Diagnostic Data

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.1
 Introduction

Diagnostic interrupt (OB 82)

Read out diagnostic data with SFC 59

Read out system status lists with SFC 51

Diagnostics-capable module CPU

Own message "Wrong weight", actual value: ... Diagnostic

SFC 52
buffer

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.2
 Interesting Facts about System Functions

The system functions (SFCs and SFBs) are stored

in the CPU‘s operating system

System Software Reference Manual for S7-300/400

System Functions and Standard Functions

Extensive Online help available in the STEP 7 software

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.3
 Call of System Functions

Call in STL Call in FBD

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.4
 Analyzing an Error Message

 The scan of the BR-bit (binary result) returns RLO=0 for

processing with fault and RLO=1 for fault-free processing.
 Scan of BR for STL with A BR
 Scan in LAD/FBD using the output parameter ENO

 Most of the system functions return an error code with the

following configuration in the output parameter RET_VAL (INT):
 RET_VAL=W#16#8 X Y Z

Error class, error‘s individual number (SFC specific)

or event number (general)
X>0: general error, X= no. of faulty parameter
X=0: SFC specific error occurred
"8" signals: error occurred

 Example:
 W#16#8081 is an SFC specific error code.
 W#16#823A is a general error code; the error was caused by parameter
no. 2.

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.5
 Writing User Messages in the Diagnostic Buffer

CPU Station

e.g. PG, OP
Send buffer

SEND =
TRUE
1 2

SFC 52
Sending

Diagnostic buffer

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.6
 SFC 52 System Function

Parameter Declaration Data type Memory area Description

SEND INPUT BOOL I, Q, M, D, L, Const. Enabling the sending of the user-defined diagnostic
message to all logged on stations (PG/OP)
EVENTN INPUT WORD I, Q, M, D, L, Const. Event ID. This message number defines the text
that is entered in the diagnostic buffer, or is sent
to a display device.
INFO1 INPUT ANY I, Q, M, D, L Additional information 1 (1 word) as wildcard
in the message text
INFO2 INPUT ANY I, Q, M, D, L Additional information 2 (1 double word) as
wildcard in the message text
RET_VAL OUTPUT INT I, Q, M, D, L Error information

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.7
 Assignment of Parameters of the ANY Data type

P#M100.0 Int 1 MW100

or
P#M102.0 Real 1 MD102

Length ANY data type

Data type
Byte and
Bit address
ID
Pointer

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.8
 Calling the SFC 52 Block

Network 2: User message when limit value exceeded

CMP>R

MD 120 IN1 M 90.1 SFC 52

P
5.000000e+003 IN2 EN

M 0.1 SEND

W#16#A901 EVENTN RET_VAL #error_sfc52

#dummy INFO 1

MD 120 INFO 2 ENO

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.9
 Structure of the EVENTN Parameter of the SFC 52 Block

EVENTN 15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0

Event class Identification Event number

1..9 are standard texts for the different events

Event class (see the Standard and System Functions manual)
A..B free texts, that are specified using Message Configuration
C..F reserved for expansions in the future

Specifies if it is an incoming or an outgoing event, or, an internal

or an external event, for example:
Identification Bit 8="1" --> Text for incoming message
Bit 8="0" --> Text for outgoing message
Bit 10="1" --> internal error
Bit 11="1" --> external error

Continuous message number from 1 to 255 within an

Event number
event class

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.10
 Configuring Your Own Message Texts

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.11
 Exercise: Analyzing an Error Message using RET_VAL

Network X: Analyzing RET_VAL, ENO

SFC 52
M 90.1
P
I 0.6 EN

M 0.1 SEND

W#16#901 EVENTN RET_VAL MW 200

MW 208 INFO 1
Q 9.2 (Q 5.2)

MW 210 INFO 2 ENO =

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.12
 Exercise: Writing User Messages in the Diagnostic Buffer

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.13
 SFC 51 System Function

Parameter Declaration Data type Memory area Description

REQ INPUT BOOL I, Q, M, D, L, Const. REQ=1: triggers processing

SZL_ID INPUT WORD I, Q, M, D, L, Const. SZL-ID of the sublist or of the sublist excerpt
INDEX INPUT WORD I, Q, M, D, L, Const. Type or number of an object in a sublist
RET_VAL OUTPUT INT I, Q, M, D, L If an error occurs while the SFC is being processed,
then the RET_VAL parameter contains an error
code.
BUSY OUTPUT BOOL I, Q, M, D, L TRUE: Read function not yet completed
SZL_HEADER OUTPUT STRUCT D, L see page after next
DR OUTPUT ANY I, Q, M, L, D Target range for the SZL sublist that is read or
the SZL sublist excerpt that is read.

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.14
 Excerpt of SZL Sublists for S7-300

SZL_ID Sublist Index Record contents

0111H CPU identification 0001H CPU type and version

0014H Operating system areas - Size of PIQ, PII, M, T, C ...

Number and size of OBs,
0015H Block types -
DBs, SDBs, FCs, FBs
0019H Status of all module LEDs - Status of LEDs

0232H CPU protection level 0004H Position of the key switch

0692H Status of racks - OK status

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.15
 Structure of the Parameter SZL_Header

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.16
 Structure of the Data Record Status LEDs (SZL_ID 0019H)
Name Length Meaning
LED identifier
W#16#0001: SF
W#16#0004: RUN
Index 1 Word
W#16#0005: STOP
W#16#0006: FRCE
W#16#0008: BATF
led_on 1 Byte 0= LED off, 1= LED on
0= LED doesn‘t blinkt, 1= LED blinks with 2 Hz, 2= LED blinks
led_blink 1 Byte
with 0.5 Hz

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.17
 User-defined Data Type (UDT)
UDT block as template Global DB (example)

index index
Led_on Led_on Data record
1
Led_blink Led_blink

index
Led_on Data record
2
Led_blink

index
Array with
Led_on Data record 4 elements
3 of the UDT type
Led_blink

index
Led_on Data record
4
Led_blink

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.18
 Inputting a UDT Block

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.19
 Example: Array of UDTs

Declaration view

Data view

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.20
 Exercise: Reading Out the SZL Sublist “Status of LEDs“

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.21
 Reading Out Diagnostic Data with the System Function SFC 59

Parameter Declaration Data type Memory area Description

REQ INPUT BOOL I, Q, M, D, L, Const. REQ = 1: Request for reading

IOID INPUT BYTE I, Q, M, D, L, Const. Identifier of address area:
B#16#54 = Peripheral input (PI)
B#16#55 = Peripheral output (PQ)
If it is a mixed module the area identifier of the
lower address is to be specified. If the address is
the same B#16#54
LADDR INPUT WORD I, Q, M, D, L, Const. Logical address of the module
RECNUM INPUT BYTE I, Q, M, D, L, Const. Data record number (permitted values: 0 to 240)
RET_VAL OUTPUT INT I, Q, M, D, L Error number as return value
BUSY OUTPUT BOOL I, Q, M, D, L BUSY = 1: The reading function is not yet completed.
RECORD OUTPUT ANY I, Q, M, D, L Target area for the data record that is read

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.22
 Diagnostic Data of the Signal Modules
Data rec. No. Contents Size

Module-specific
0 4 bytes
diagnostic data

for S7-300: 16 bytes

Channel-specific
1 for S7-400:7-220 bytes
diagnostic data

2-127 User data each <= 240 bytes

128 to 240 Diagnostic data each <= 240 bytes

Address Structure of data record 1

0 Module diagnostic byte 1 Configuration - Parameter-
0
assignment error
1 Common-mode error

3 Module diagnostic byte 4 2 P-short circuit

4 Channel type (70H=DI, 71H=AI, 72H=DO, 73H=AO) 3 M-short circuit
5 Number of diagnostic bits per channel
4 Wire break
6 Number of channels
7 Channel error bits 5 Reference channel error
8 Channel-spec. diagnostic byte, channel 0 6 Exceeding measuring range (lower)
7 Exceeding measuring range (upper)

15 Channel-spec. diagnostic byte, channel 7

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.23
 Exercise: Reading Out Data Record 1 of an Analog Module

Step What to Do Result

Check whether the diagnostic interrupt

1 is enabled on the analog module.

At the end of OB 82 insert a new network.

2

Using the SFC 59, read out the data record

3 1 of the analog module and save this in
DB 59 as of data byte 0.

Test the program by setting a voltage You can analyze additional diagnostic
4 > 13V at an analog channel. Interpret data.
the data record by reading out the DB 59.

SIMATIC S7 Date: 18.08.2018 SITRAIN Training for

Automation and Drives
Siemens AG 2000. All rights reserved. File: PRSERV_04E.24