simatic sfc-visualization for s7

�

Contents

SFC Visualization 1

Configuration 2Operating and Monitoring theSFC Chart 3

Appendix

SFC API Functions AIndex

SIMATIC

SFC-Visualization for S7

Manual

Edition 11/2000A5E00082886-01

26.10.2000

Copyright © Siemens AG 2000 All rights reserved

The reproduction, transmission or use of this document or itscontents is not permitted without express written authority.Offenders will be liable for damages. All rights, including rightscreated by patent grant or registration of a utility model or design,are reserved.

Siemens AGBereich Automatisierungs- und AntriebstechnikGeschaeftsgebiet Industrie-AutomatisierungssystemePostfach 4848, D- 90327 Nuernberg

Disclaimer of Liability

We have checked the contents of this manual for agreement withthe hardware and software described. Since deviations cannot beprecluded entirely, we cannot guarantee full agreement. However,the data in this manual are reviewed regularly and any necessarycorrections included in subsequent editions. Suggestions forimprovement are welcomed.

©Siemens AG 2000Technical data subject to change.

Siemens Aktiengesellschaft A5E00082886

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:

!Dangerindicates that death, severe personal injury or substantial property damage will result if properprecautions are not taken.

! Warningindicates that death, severe personal injury or substantial property damage can result if properprecautions are not taken.

! Cautionindicates that minor personal injury or property damage can result if proper precautions are not taken.

Notedraws your attention to particularly important information on the product, handling the product, or to aparticular 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:

!WarningThis device and its components may only be used for the applications described in the catalog or the

technical descriptions, 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 installedcorrectly, and operated and maintained as recommended.

Trademarks

SIMATIC®, SIMATIC HMI® and SIMATIC NET® are registered trademarks of SIEMENS AG.

Some of other designations used in these documents are also registered trademarks; the owner’s rights may

be violated if they are used by third parties for their own purposes.

26.10.2000

SFC-Visualization for S7A5E00082886-01 iii

Contents

1 SFC Visualization

1.1 SFC Visualization.......................................................................................... 1-11.2 SFC Basic Settings ....................................................................................... 1-2

2 Configuration

2.1 Configurations for the SFC Visualization........................................................2-12.2 Configuring the "PCS7 SFC Control" Status Display...................................... 2-22.3 Configuring the "PCS7 SFC MultiChart Control" Status Display ..................... 2-42.4 Configuring an SFC Button............................................................................ 2-72.5 Configuring the SFC Browser Selection......................................................... 2-82.6 Using Functions for Own Scripts (SFC API Calls) .......................................... 2-82.7 The MultiClient .............................................................................................. 2-92.7.1 Further Information on the Multi-Client...........................................................2-9

3 Operating and Monitoring the SFC Chart

3.1 User Privileges.............................................................................................. 3-13.2 Operating and Monitoring the SFC Chart via the SFC Status Display ............ 3-13.3 PCS7 SFC Control ........................................................................................ 3-23.4 PCS7 SFC MultiChart Control ....................................................................... 3-33.5 Visualization via an SFC Selection Button in the Button Set or via

SFC Browser Selection in the Display ........................................................... 3-63.6 Display of the Detail Window......................................................................... 3-73.7 Operations in the Detail Window.................................................................... 3-83.8 Setting the Operating Mode........................................................................... 3-83.9 Setting the Operating State ........................................................................... 3-93.10 Setting the Step Control Mode..................................................................... 3-103.11 Setting the Runtime Options........................................................................ 3-113.12 Acknowledge Operator Requests and Step Errors ....................................... 3-123.13 Properties Dialog Boxes of Steps and Transitions........................................ 3-123.14 Properties Dialog Box of the Step................................................................ 3-133.15 Properties Dialog Box of the Transition........................................................ 3-153.16 Messages ................................................................................................... 3-16

A SFC API Functions

A.1 Script Example: Configuring an SFC Button ..................................................A-4

Index

26.10.2000

Contents

SFC-Visualization for S7iv A5E00082886-01

26.10.2000

SFC-Visualization for S7A5E00082886-01 1-1

1 SFC Visualization

1.1 SFC Visualization

With the optional package "SFC Visualization" you can carry out configuration forthe SFC visualization in WinCC, and in the WinCC Runtime System you canoperate and monitor the SFC charts.

What is SFC?

SFC (Sequential Function Chart) is a sequential control system that is used forprocess flow control.

A sequential control system is a control system that, subject to conditions, switchesfrom one state to the next.

What are the Features of the SFC Engineering System?

The engineering system allows you to create SFC charts, compile them, and loadthem into the PLC. It also allows you to test and commission them.

In order to be able to use the SFC charts in the runtime system, you must importthem into the runtime system from the engineering system, using the "PLC-OS-Engineering" software package (also individual charts). It imports the SFC chartstogether with their OS comments and the messages configured for the charts. Inaddition, mechanisms are stored with the messages. These permit direct access tothe SFC chart that a message relates to.

You may also:

• Configure the display of SFC charts

• Configure access privileges for the SFC

• Place objects in the WinCC display for calling the SFC chart.

Further information may be found in the manual "SFC Sequential Function Chart",in the "SIMATIC STEP 7 User Manual", and in the respective online help.

26.10.2000

SFC Visualization

SFC-Visualization for S71-2 A5E00082886-01

What does the Runtime System Offer for SFC?

The runtime system allows you to monitor and operate any number of SFC chartssimultaneously.

Note:

Configuration is not possible during runtime operation.

1.2 SFC Basic Settings

WinCC Explorer Settings

In the WinCC-Explorer you can configure general settings for the display of theSFC charts in the runtime system. These changes may relate to individual charts,or globally to all charts displayed.

Global Settings

The global settings for the display of the charts concern the chart topology, thecolors used, and the privilege levels. In the WinCC Explorer, open the"SFC Properties" dialog by first selecting "SFC" and then clicking the right-handmouse button to select the menu item "Open".

For the chart topology you may determine the size of the objects and the distancebetween them in the detail and overview windows.

You may choose colors to vary the display of states of steps, transitions, and theselected objects.

You may change the privilege levels for operations if you require levels other thanthe default levels ("Monitoring", "Process Operation" and "Advanced ProcessOperation"). These apply to all the SFC charts of the WinCC project concerned.

In order to give a user privileges for operations in the SFC visualization, thecorresponding global or area-specific privilege levels for the user must be set in theUser Administrator.

If no users have been configured, all operations are possible without restriction. Inthis case, the "Privilege levels" tab is not available.

26.10.2000

SFC Visualization


Chart-Specific Settings (on Server or Client only, not on MultiClient)

For each SFC chart, you individually set

• The chart’s update cycle as well as

• The standard display, meaning with which the chart is to be opened (overviewor detail window).

The available charts are displayed in the detail window of the WinCC Explorerwhen "SFC" is selected. The dialog box for the SFC chart selected is opened viathe right-hand mouse button and the "Properties" menu command.

If required, you can also delete the SFC charts no longer required in WinCC. Thesecharts continue to exist in the PLC database afterwards, meaning that they are alsoavailable again in WinCC after the next PLC-OC data transfer.

26.10.2000

SFC Visualization


26.10.2000


2 Configuration

2.1 Configurations for the SFC Visualization

Within a WinCC display you can place objects that open an SFC chart duringruntime operation. These objects may be "SFC Control"/"SFC MultiChart Control"objects, arbitrary graphics objects (for example, rectangles), or Windows objects(for example, buttons).

You can configure the following objects for opening the SFC chart:

• Configuring the PCS7 SFC Control

• Configuring the PCS7 SFC MultiChart Control

• SFC Button

• SFC Browser Selection

You can use functions of the SFC Visualization in order to create your own scripts.Please refer to:

• Using Functions for own Scripts.

26.10.2000

Configuration


2.2 Configuring the "PCS7 SFC Control" Status Display

The states of an SFC chart can be displayed in a graphics display by an SFCControl function which is assigned to this chart. This Control is also called thestatus screen (just like the SFC MultiChart Control). The status display must beplaced in a graphics display in WinCC Graphics Designer and configured asdescribed below.

1. Placing the PCS7 SFC Control in the Graphics Display

In the Graphics Designer open the desired graphics display and select the

entry in the "Smart Objects" toolbar. Open a frame in the graphicsdisplay for the object to be displayed. The selection list of all the installed"Controls" is then displayed automatically. Select "PCS7 SFC Control“.

ChartNameStep Contol Mode Chart Status

"Step Error"Display

"Operator Request"Display

Step Name

Runtime

Chart Display

Function Description

Step Control Mode In runtime mode the current step control mode is displayed here: "T" = Transition,"C" = Confirmation by operator, "T and C" = Transition and confirmation by operator,"T or C" = Transition or confirmation by operator, "T/T and C" = Step-specificconfirmation by operator.

Chart Name In runtime mode of WinCC the name of the assigned SFC chart is displayed here.

Chart Status In runtime mode of WinCC the current state of the chart is displayed here: ACTIVE,OFF, HELD, OFFLINE.

"Step Error"Display

In runtime mode of WinCC the step error (group display) is displayed here. "Thechart is opened by clicking on the display (E), and the affected chart section isshown." If no error stop currently exists, this field is empty.

"Operator Request"Display

In runtime mode of WinCC an operator request (group display) is displayed here."The chart is opened by clicking on the display (C), and the affected chart section isshown." If no operator request currently exists, this field is empty.

Step Name In runtime mode of WinCC the name of the current step is displayed here. If severalsteps are active (for example, in a parallel branch), the name of the first active stepis displayed, followed by the characters " ,... ".

Runtime In runtime mode of WinCC the current runtime of the current step is displayed here.If several steps are active (for example, in a parallel branch), the runtime of the firstactive step is displayed.

Chart Display In runtime mode of WinCC you can use this button to change the display mode ofthe displayed SFC chart. The "Overview" and "Section" display modes are available.

Configuration


2. Configuration

In order to carry out configuration open the properties dialog box by double-clicking on the SFC Control.In the "General" tab card specify whether the SFC chart is to be opened as an"Overview" or "Section" window. The corresponding button in the SFC Controlis labeled correspondingly.

Use the "Assign chart" command button to use a further dialog box in which allthe SFC charts of this OS are listed. Select the desired chart and then closethe dialog box by clicking on "OK".The current chart name is entered under "Connected Chart" and is alsodisplayed in the Control after the properties dialog box has been closed byclicking on "OK".

Options in the further tab cards: You can configure the display of the SFCControl individually. In the "Colors" tab card you can use the color toolbar tochange the existing colors for certain elements (for example, title bar, windowbackground, etc.) In the "Fonts" tab card you can specify the font, the typestyle and the font size.

Note:

Configuration by double-clicking on the Control is the most comfortable method.You can naturally also configure the status display by using the Dynamic Wizard-Script – as in previous versions.

Configuration


2.3 Configuring the "PCS7 SFC MultiChart Control" StatusDisplay

The "PCS7 SFC MultiChart Control" can be used to monitor and operate anynumber of charts. This Control is also called the status screen (just like the SFCControl). As in the "SFC Control" the "SFC MultiChart Control" is inserted into adisplay and the parameters configured during the configuration process.

1. Placing the PCS7 SFC MultiChart Control in the Graphics Display

In the Graphics Designer open the desired graphics display and select the

entry in the "Smart Objects" toolbar. Open a frame in the graphicsdisplay for the object to be displayed. The selection list of all the installed"Controls" is then displayed automatically. Select "PCS7 SFC MultiChartControl“. The Control is displayed in accordance with the size of the openedframe. If you do not open the frame completely, not all the columns are visible.In this case a horizontal scroll bar is inserted so that the contents can bescrolled into the visible area during runtime operation. The "#", "Control", "F"and "B" columns are always displayed.

Note:

In order to obtain a better overview the Control is displayed in two sections here.The figure below shows the left-hand and right-hand sections of the Control whilethe frame is opened completely.

Left-hand section

Line Number Chart Acknowledgement

Operating Mode

Enable Step

Sorting Commands

26.10.2000

Configuration



Line Number The configured sequence can be recognized on the basis of the line number.In runtime mode of WinCC the column is sorted in ascending or descending numericalorder whenever you click on the column header.

Chart The name including name-forming part of the technological hierarchy is displayed forevery SFC chart in this column (if it exists).In runtime mode of WinCC the symbol for the current chart state is displayed before thename.

If you click on it, the chart is opened in the overview mode.

If you click on the column header, sorting is carried out by the chart state. Order: OFF,ACTIVE, HELD, OFFLINE. If you click again, in the reverse order.

Acknowledgement

In runtime mode of WinCC the "Operator request" and "Step error" are displayed here.The fields are empty, if there are no displays.

When you click on the display the chart is opened and the corresponding chart sectionis displayed. If an operator request or an step error does not exist currently, therespective field is empty.

If you click on the column header, the entries are sorted. Order: Lines with displays,lines without displays. If you click again, in the reverse order.

OperatingMode

In runtime mode of WinCC the operating mode (manual or auto) of the SFC charts isdisplayed here. The operating mode can be changed by means of a combo box.

If you click on the column header, the entries are sorted. Order: Lines with "Auto"display, lines with "Manual" display. If you click again, in the reverse order.

Enable In runtime mode of WinCC this entry indicates whether an enable for changing over tothe "Auto" operating mode exists for the respective chart.

The option can be set or reset by clicking on it.

If you click on the column header, sorting is carried out. Order: Set option, unset option.If you click again, in the reverse order.

Step In runtime mode of WinCC the name of the current step is displayed here. If severalsteps are active (for example, in a parallel branch), the name of the first active step isdisplayed, followed by the characters " ,... ". The symbol of the stepping state isdisplayed before the step name.

When you click on it, the chart is opened in detail mode and the active step is displayedcentered in the chart.

If you click on the column header, sorting is carried out by the step state. Order:INACTIVE not processed, INACTIVE processed, ACTIVE, HELD, ERROR. If you clickagain, in the reverse order.

Sorting In runtime mode of WinCC you can move the selected line one line up or down byclicking on the one of the command buttons.

Commands In runtime mode of WinCC you can control a selected SFC chart by means ofcommands. The commands have the following function (from left to right): START orCONTINUE, CANCEL, HOLD, RESTART.

26.10.2000

Configuration


Right-hand section

Display

Comment Runtime Step Control Mode Transition


Comment In runtime mode of WinCC the comment of the state is displayed here.

If you click on the column header, sorting is carried out in alphabetic order.

Runtime In runtime mode of WinCC the current runtime of the step is displayed here.

If you click on the column header, sorting is carried out in numerical order.

Step ControlMode

In runtime mode the current step control mode is displayed here: "T" = Transition, "C" =Confirmation by operator, "T and C" = Transition and confirmation by operator, "T or C"= Transition or confirmation by operator, "T/T and C" = Step-specific confirmation byoperator.

The mode can be changed by means of a combo box.

If you click on the column header, sorting is carried out in alphabetic order.

Transition In runtime mode of WinCC the name of the current transition is displayed here. Ifseveral transitions are active (for example, in an alternative branch), the name of thefirst active transition is displayed, followed by the characters " ,... ". The symbol of theresult is displayed before the transition name (colored line).

When you click on it, the chart is opened in detail mode and the active transition in thechart is displayed centered.

If you click on the column header, sorting is carried by active and inactive transitions. Inthe case of active transitions, also by the result.

Display In runtime mode of WinCC you can visualize a selected SFC chart in the selected"Section" or "Overview" mode by using these command buttons .

2. Configuration

In order to carry out configuration open the properties dialog box by double-clicking on the SFC MultiChart Control.

In the "General" tab card you assign the desired SFC charts to the Control ordelete them from it.

26.10.2000

Configuration


Assigning Charts: The dialog box for selecting the SFC charts is opened by

using the command button. Select the desired chart and then close thedialog box by clicking on "OK". Repeat this procedure for every SFC chartwhich you want to include in the SFC MultiChart Control. A line is created forevery chart with those columns which provide information on the chart inruntime operation. Please also refer to PCS7 SFC MultiChart Control

Deleting Charts: Select a chart no longer required in the properties dialog box

and use the command button to delete it.

Sorting Charts: You can change the sequence at a later point for the selected

SFC charts. A selected chart can be moved up or down by using the command buttons.

Title: For the SFC MultiChart Control you can enter a title which identifies ituniquely in runtime operation.

Options in the further tab cards: You can configure the display of the SFCControl individually. In the "Colors" tab card you can use the color toolbar tochange the existing colors for certain elements (for example, title bar, windowbackground, etc.) In the "Fonts" tab card you can specify the font, the typestyle and the font size.

2.4 Configuring an SFC Button

You can also configure a graphics object to select an SFC chart. This object servesas a representative for the SFC chart. Unlike an SFC status display, however, itdoes not receive any information on the current status of the chart. Such an objectcould be, for example, a button.

The procedure is basically the same as for the configuration of the SFC Control:

• Select the "Button" object in the "Windows Objects" window and open a framein the graphics display by dragging the mouse.

• Enter the further settings (text input for labeling, font, operating privilege, etc.)in the subsequent configuration dialog box and close it by clicking on "OK".

• In the Dynamic Wizard double-click on the "Configure SFC button" entry.

• In the next dialog step, choose the mouse action that is to start the SFC chartwhich is then assigned in the following step.

• The "SFC Browser" is called up. In the browser select the SFC chart that is tobe assigned to the button.

• In the subsequent "Set Option" dialog box choose the display in which the SFCchart is to be opened ("Overview" or "Section").

• Click on "Finish" to complete the configuration.

26.10.2000

Configuration


2.5 Configuring the SFC Browser Selection

In order to select SFC charts you can place an object in the graphics display whichcalls up the SFC browser during runtime operation.

The procedure for configuring the SFC browser selection is the same as forconfiguring the SFC Button, except that there is no configuration step that calls upthe SFC browser for SFC chart selection.

2.6 Using Functions for Own Scripts (SFC API Calls)

You can use prepared scripts in the WinCC Graphics Designer in order to assigncertain actions to objects.

SFC Visualization offers a whole number of functions of which the most importantare contained in these prepared scripts.Example: The functions "SFCOpenSection" (for "Section") and"SFCOpenOverview" (for "Overview") are allocated to the selected action (forexample, "Left-hand mouse button") with the script "Configure SFC button"The example can be found under Script Example: Configuring an SFC Button.

However, the SFC Visualization functions can also be used in your own scripts. Todo so, the header file "sfccli.h" has to be read in (# include "sfccli.h").

The most import functions are described under SFC API Functions.

General Information on the Functions

• If a BOOL value is provided, TRUE = success and FALSE = error.

• Normally those functions which have "LPOHIO_ERRORSTRUCT IpdmError"as a parameter, can be called with "(void*)0". In this case the error is notevaluated. Also refer to Script Example: Configuring an SFC Button

• If you require a window handle, the window of the "parent" should be specifiedfor the window to be generated. However, since this is not easy to achieve inscripts, "NULL" is also allowed as the assignment. In this case, the desktop isused as the "parent" of the new window.

26.10.2000

Configuration


2.7 The MultiClient

2.7.1 Further Information on the Multi-Client

What is a Multi-Client Project?

Unlike a client that connects to exactly one server, a Multi-Client can access up tosix servers. A Multi-Client itself has no SFC charts of its own and does not have aprocess connection. A Multi-Client can monitor and operate the SFC charts that arepresent on the servers, but it cannot modify them.

The data from the server projects are announced to the Multi-Client via referencelists (packages). The Multi-Client can access the server data only after thepackages have been created and loaded.

Similarly, for the SFC Visualization, the actual data are not exported. Onlyreferences to the SFC charts are exported. This means that packages do not haveto be re-created or reloaded after a chart has been changed. Only when charts aredeleted, added, or renamed, a new package has to be created and loaded onto theMulti-Client.

Creating and Loading a Package

Prerequisites: Before a package is created on the WinCC server, the data have tobe put into the WinCC data storage by means of an PLC-OS transfer. This transferincludes the process variables, the messages, and the SFC charts.

You create a package for a server by selecting "Create..." in the context menu inthe "Server data" function of the WinCC-Explorer (not possible in the Multi-Client).The name of the package created is displayed in the detail window. It contains theproject name and the name of the server. The extension is ".pck".

In order to load a package into the Multi-Client, choose "Load..." in the contextmenu of the "Server data" function.

In the "Open" dialog box, enter the computer’s name, then choose the project fromthe combo box and within it the computer’s name, followed by the "Packages"folder. Then select the package file (.pck) and click on "Open". The server data willnow be copied into the "Packages" folder and are thus available to the Multi-Client.

26.10.2000

Configuration


Configuring the SFC Visualization

The WinCC Explorer of the Multi-Client allows configuration of the display andoperations, as described under "SFC Basic Settings".

The basic SFC settings that exist for the individual server projects are of norelevance to the Multi-Client. If no configuration is carried out, the default settingsfor the Multi-Client apply.

Just like the server project, the Multi-Client project permits the positioning ofobjects in graphics displays, where the objects are assigned to SFC charts whichthey open (also refer to "Objects for Opening of SFC Charts").

Note Regarding Configurations in Server Projects

• Configurations for the SFC visualization that were carried out in graphicsdisplays (for example, SFC selection buttons, SFC status display) will alsowork on the Multi-Client.

• A server project cannot be configured from a Multi-Client.

Permanent Operability for Multi-Clients

The SFC Visualization supports "permanent operability" for Multi-Clients. As soonas a default server has been configured at the Multi-Client, this is used as theserver, irrespective of whether the server is currently the MASTER or onSTANDBY. In case of a redundancy changeover the SFC Visualization reacts inaccordance with the behavior defined at the WinCC.

Clients and Multi-Clients

The SFC Visualization supports simultaneous operation of Clients and Multi-Clientsat a server or server couple, as long as there are no limitations in this respect bythe PCS 7 or the OS.

26.10.2000


3 Operating and Monitoring the SFC Chart

3.1 User Privileges

If no users have been configured, all operations are possible without restrictions.Otherwise, depending on the privilege levels configured for the SFC visualization,and on the user that has logged on,

• Buttons are activated and deactivated, and

• Operations are checked prior to execution.Depending on the outcome of the check, operations are either accepted orrejected.

3.2 Operating and Monitoring the SFC Chart via the SFCStatus Display

SFC Status Display

By selecting a graphical display that contains a status display configured for theSFC chart (or SFC charts) you can obtain an overview of the SFC chart’s status(PCS7 SFC Control). In the case of "PCS7 SFC MultiChart Control" you canmonitor several SFC charts and also change (operate) certain parameters.

• PCS7 SFC Control

• PCS7 SFC MultiChart Control

26.10.2000

Operating and Monitoring the SFC Chart


3.3 PCS7 SFC Control

The following current information is displayed:

Heading • Chart name of the corresponding SFC chart *)

1. line • Abbreviation for the step control mode ("T", "C", "T and C", "T or C","T/T and C")

• Chart state (ACTIVE, OFF, HOLD, OFFLINE)

• Group display for step error "F" (if it exists, otherwise empty)

• Group display for operator request "B" (if it exists, otherwise empty)

2. line • Step: Name of the first **) active step

3. line • Runtime: Current runtime of the first **) active step

*)

**)

If the text ## Initialization error ## is displayed instead of the chart name, thisSFC Control has a chart assigned to it which has been deleted in WinCC.If the chart still exists in the PLC project, you can transfer it back to the WinCCdatabase by means of a new PLC-OS transfer. Otherwise you have to assignanother SFC chart to the SFC Control.

In a parallel branch several steps can be active simultaneously.

You can change to the overview display of the SFC chart by clicking on the"Overview" button, as it was configured in this example (or change to the detaildisplay, if the "Section" key has been configured).

If "F" is displayed, the properties dialog box of the step is also opened.A mouse click opens the detail display of the chart and centers the active step withthe error acknowledge buttonIf "B" is displayed, the properties dialog box of the transition is also opened.A mouse click opens the detail display of the chart and centers the active transitionwith the acknowledge button of the operator request.

26.10.2000



3.4 PCS7 SFC MultiChart Control

The SFC MultiChart Control allows you to operate and monitor several chartssimultaneously.(In order to obtain a better overview the Control is displayed in two sections here).

Left-hand section

Columns Contents Function

# Line Number Display for sorting

Chart • Name of the SFC chart (includingnaming-forming part of the TH)

• Symbol for the operating mode

Double-clicking opens the overviewdisplay of the chart

F Group display for step errors (if it exists,otherwise empty fields)

A mouse click opens the detail display ofthe chart and centers the active step withthe error acknowledge button.

C Group display for operator request (if itexists, otherwise empty fields)

A mouse click opens the detail display ofthe chart and centers the activetransition with the acknowledge button ofthe operator request.

Operating mode "Auto" or "Manual" operating mode Allows a changeover of the operatingmode by means of a fold-down list box

FA – Enable forAuto

Radio button which enables thechangeover to "Auto"

Allows the enable to be set or reset

Step • Name of the first active step

• Symbol for the step state

A mouse click opens the detail display ofthe cart and centers the active step

26.10.2000



Right-hand section

Columns Contents Function

Comment Comment of the first *) active step Display

Runtime Runtime of the first *) active step Display

Step ControlMode

Abbreviation for the step controlmode ("T", "C", "T and C", "T or C","T/T and C")

Allows a changeover of the step controlmode by means of a fold-down list box

Transition • Name of the first **) activetransition

• Symbolic display of the result

A mouse click opens the detail display of thecart and centers the active transition

*) In a parallel branch several steps can also be active simultaneously**) In an alternative branch several transitions can also be active simultaneously.

26.10.2000



Command Buttons

• A selected line can be moved up or down by one line by clicking on the

command buttons.

• A selected SFC chart can be controlled by means of commands.

The command buttons (inactive here) have the followingfunction (from left to right): START or CONTINUE, CANCEL, HOLD,RESTART.

• You can open a selected SFC chart by using the "Section" or "Overview"command buttons in the selected display mode.

Information on the Display

• If a line which only contains the SFC name is displayed in gray in the SFCMultiChart Control, this is an SFC chart which no longer exists in the WinCCdatabase, meaning that it was deleted here and not transferred during the lastPLC-OS transfer.Remedy: If the chart still exists in the PLC project, you can transfer it back tothe WinCC database by means of a new PLC-OS transfer. Otherwise you haveto assign another SFC chart to the line in the SFC MultiChart Control.

• If you select one or more lines, the selection is reversed after approx. 30seconds.

• The "#", "Control", "F" and "B" columns are fixed, meaning that they alwaysremain visible during horizontal scrolling.

• When you click on a column header, the table lines are sorted in ascending ordescending order.

• A sorting which is changed during runtime operation is not persistent. Theconfigured display mode is restored when the display is re-selected.

26.10.2000



3.5 Visualization via an SFC Selection Button in the ButtonSet or via SFC Browser Selection in the Display

An SFC chart can also be visualized and interacted with in the runtime system asdescribed below.

An SFC chart is visualized and interacted with as follows:

1. Click on this button in the button set, or on an object configured in thedisplay that selects the SFC Browser.

The SFC Browser is displayed with a list of all SFC charts (also the servers ofthe imported packages in the case of Multi-Client).

You can select a chart from the list of SFC charts displayed and visualize it byclicking on the "OK" button.

2. Click on the name of the desired SFC chart.

Depending on the setting in the WinCC-Explorer, the SFC chart selected isdisplayed in the overview or in the detail window. In the following example thedisplay is in the form of an overview window. This always displays the entirechart. Exception: Very large charts are displayed on a maximum of half thescreen and have a scroll bar.

When the overview window is open, the current state of the SFC chart isdisplayed in color. The assignment of the colors to the respective states can beconfigured freely and is specified globally for all charts in the WinCC-Explorer.An info bar below the title bar shows the name of the currently active step. Thisbar is empty, if no step is active, for example, after the chart has beenexecuted.

3. You can obtain a detail view of the SFC chart by clicking in the overviewwindow on the desired position. The area surrounding the click position isdisplayed in the detail window. You can modify this area by resizing or scrollingthe detail window.

The SFC windows are displayed in the working area and are always on top.

26.10.2000



3.6 Display of the Detail Window

The title bar of the detail window has the following structure:

<Technological Hierarchy\\Chart Name> : <State of Chart> PLC State : <PLCState>.

The individual components of the title bar reflect the respective circumstances.

Chart Status

State Meaning

ACTIVE The chart is running.

OFF The chart is deactivated.

HELD The chart has been paused.

OFFLINE The chart is not updated.

PLC State

State Meaning

STOP The PLC is in the stopped state or theconnection to the PLC is faulty.

RUN The PLC is running, the connection to the PLCworks, the charts are updated.

26.10.2000



3.7 Operations in the Detail Window

The following operations are possible when the detail window is displayed:

• Setting Operating Mode

• Setting Operating State

• Setting Step Control Mode

• Setting Runtime Options

• Acknowledge Operator Requests and Step Errors

• Properties Dialog Boxes of Steps and Transitions

3.8 Setting the Operating Mode

The mode of operation determines how the execution of the SFC chart is to becontrolled.

SFC knows the following operating modes:

• Auto (process mode) - the execution is controlled automatically.

• Manual (interactive mode) - the execution is controlled by the operator.

The changeover from "Manual" to "Auto" can be carried out after having been

enabled by the enable button , or without this enabling.

Changing over from "Auto" to "Manual" is possible after an enable at the controllerunit, or, with an appropriate privilege level, without that enable (forced manualswitch).

Depending on the operator’s privilege and whether an enable has been issued, thechangeover will either be permitted or refused, and different messages will bedisplayed.

26.10.2000



3.9 Setting the Operating State

The commands in the interaction bar (or in the SFC MultiChart Control) allow youto set or modify the SFC chart’s operating state.

Button forcommand

Meaning

Start: The sequential control system’s operating state is changed from OFF toACTIVE. This means that processing of the SFC chart is started immediately. Thestart step automatically becomes active, its actions are executed and the results of thetransitions following the start step are evaluated.

Exception: If a step was marked as a target step , "Start" activates this target step and not the start step (this also applies when several target steps were selected).

Continue: The sequential control system’s operating state is changed from HELD toACTIVE. This means that the SFC chart continues to be executed, transition resultscontinue to be evaluated and actions continue to be carried out. and that transitionsare carried out in accordance with the set step control mode.

Exception: If a step has been marked as a target step , "Continue" continues the execution of the halted SFC chart at the target step, after properly completing thesteps that were interrupted. This means that the cyclic processing of these steps iscarried out at most one more time, and that the end processing overlaps with theinitialization of the target step (this also applies when several target steps wereselected).

Cancel: The sequential control system’s operating state is changed from HELD toOFF. The active steps are completed, followed by the end step. This allows you tobring the sequential control system into a well-defined state.

Remark: Selected target steps are ignored.

Hold: The sequential control system’s operating state is changed from ACTIVE toHELD. This means that the SFC chart is halted, that transition results are notevaluated and that actions are not carried out. An operation (command) is required forfurther execution.

Restart: The sequential control system’s operating state is changed from HELD toACTIVE. The active steps are executed, the start step is activated and its actions areexecuted.

Remark: Selected target steps are ignored.

26.10.2000



3.10 Setting the Step Control Mode

The step control mode determines the step switching behavior of the sequentialcontrol system. The step control mode modifies the behavior of transitions whoseconditions have been prepared or fulfilled.

If required, a button is displayed in all step control modes other than “T” if there is acurrent request for user intervention.

Changing the step control mode is possible in all states of operation.

In this combo box you can set the following step control modes:

Step ControlMode

Meaning

T Transition:The sequential control system runs under process control (i.e., automatically). If a transitioncondition is fulfilled, switching deactivates the predecessor steps and activates successorsteps.

C User interaction:The sequential control system runs exclusively under interaction with the operator. Transitionconditions do not have to be fulfilled. A request for user intervention is issued for allsuccessor transitions of each active step. Switching takes place after the operator hasintervened.

T and C Step control by transition and user interaction: The sequential control system runs process-controlled and under interaction with theoperator. If the transition condition to a successor of an active step is fulfilled, a request foruser intervention is issued. Switching requires user intervention.

T or C Step control by transition or user interaction: The control flow of the sequential control system is based on the process or on userinteraction. A request for user intervention is issued for every successor transition of an activestep. Switching takes place after the intervention. If the transition condition is met before theuser intervention, the switching happens automatically without intervention.

T / T and C Step specific confirmation by operator:The "Confirmation" label is set or reset step-specifically in the properties dialog box of thestep. The sequential control system runs:

Under process control at steps without the “Confirmation label”. Every fulfilled successor transition condition of an active step without user interventionswitches to the next one without confirmation (corresponds to step control mode “T”).

Under user control at steps with a “Confirmation label”. Every fulfilled successor transition condition of an active step with "confirmation" sets a userintervention request and switches to the next transition after confirmation (corresponds tostep control mode "B").

26.10.2000



Minimum Execution Time:

In the step control modes “C” and “T or C”, the minimum execution time for a stepcan be circumvented by operator intervention.

3.11 Setting the Runtime Options

The runtime options provide you with further ways of influencing the sequentialcontrol system's behavior. The individual options can be combined. In the runtimesystem, the following options for the execution can be set via the control bar (or inthe SFC MultiChart Control):

• Command output

• Cyclic operation

• Timeout watchdog

Execution option Meaning

Command output At Command output "on" the actions of active steps areexecuted.

At Command output "off" the actions of active steps are notexecuted.

Cyclic operation At Cyclic operation "on" the start step of the SFC chart isactivated again after the end step has been deactivated.

At Cyclic operation off the sequential control system is set to theOFF state after the end step of the SFC chart has beendeactivated, meaning that there are no active steps left, and noactions or transitions are processed anymore.

Timeout watchdog At Timeout watchdog on the active time of each step underprocessing is compared with its maximum execution time. If thetime is exceeded, a step error is reported back to WinCC. Inaddition, an acknowledge button for the step error is displayed inthe SFC chart.

At Timeout watchdog off no comparison takes place betweenthe active time and maximum execution time.

26.10.2000



3.12 Acknowledge Operator Requests and Step Errors

The (group acknowledgement) button allows you to acknowledge currentintervention requests and step errors collectively, without having to resort toindividual acknowledgements (acknowledgement at the buttons of the steps "F" orof the transitions "C").

Note:

In case of a step runtime error the step is returned to the state which it had beforethe error occurred (for example, active = "green") after the error has beenacknowledged.

3.13 Properties Dialog Boxes of Steps and Transitions

The Properties dialog box is the detailed display of a step or a transition in an SFCchart. This dialog box shows information specific to the selected object(step/transition).

The dialog boxes for steps and transitions can be displayed separately or in acombined display. In the combined display the dialog box for the step includes theproperties of the successor transition. In this case, the title bar also contains thename of the transition.

The combined display is shown when you click on the "Transition >>" button in theProperties dialog box for the step. Return to the step-only display by clicking on the"Step <<" button.

The information shown is identical in both display variations. The only difference isin the arrangement of the buttons.

Automatic Trace

By setting the Update option you can activate an automatic trace. It automaticallydisplays the current properties after each switching event, depending on the chart’sexecution. This means that the display of the properties follows the respectiveactive step or the respective active transition.

If the active step or the active transition are located outside the window displayduring the execution of the chart, the chart is automatically shifted so that the stepor transition under observation are within the window’s display area. The objectsthat are currently under observation are shown on the chart as selected.

The following description of the properties dialog boxes is based on the separatedisplay of step and transition.

• Properties Dialog Box of the Step

• Properties Dialog Box of the Transition

26.10.2000



3.14 Properties Dialog Box of the Step

Procedure

Activate the detail window for the SFC chart in which you want to display theProperties dialog box of a step.

Now click on the desired step in order to open the dialog box.

"General" Tab Card

The runtimes, the “Confirmation” option, the comments and the state of the stepare displayed (read-only).

The state of the step is displayed as text in the title bar, and by the appropriatesymbol in the dialog box.

State Meaning Symbol

INACTIVE,notprocessed

This step has not beenexecuted yet

None For target step +

INACTIVEhas beenprocessed

This step is no longer beingprocessed

(check mark) For target step +

ACTIVE The step is being processed. (arrow)

HELD The step has been paused.(arrow on line) For target step +

ERROR The step is in the error state(timeout).

(flash arrow) For target step +

"Initialization", "Execution", "Termination" Tab Cards

For each individual action of the step the configured assignments are displayed.

26.10.2000



Operations in the Properties Dialog Box of the Step

The following operations are possible within the dialog box:

• Close the dialog box with the "Close" button

• Acknowledge a step error with the "E" button

• Select the previous or next step with the "← / →" button

• Display the properties of the transition to successor with the "Transition >>"button

• Set / reset option: "Target step"

• Set / reset option: "Update"

The current step is marked as a target step by setting the option "Target step". Thismeans that

• The SFC chart, if it is OFF, will start execution at the target step rather than thestart step next time that "Start" is clicked.

• a halted SFC chart continues at the target step after "Continue" has beenclicked and after the interrupted steps have been completed properly.

The target step mark only applies to the next "Start" or "Continue" command, afterwhich it is reset.

26.10.2000



3.15 Properties Dialog Box of the Transition

Procedure

Activate the detail window for the SFC chart in which you want to display theProperties dialog box of a transition.

Now click on the desired transition in order to open the dialog box.

A window is displayed that contains the Boolean operators of the transition logicand the fields with the conditions. The window consists of two pages with a total of16 lines for conditions and a three-stage transition logic. On the first page, 2 x 5conditions are combined by the Boolean operators, and a further 2 x 3 conditionson the second page. Next to the last operator, there is an "arrow" button to togglebetween the two pages.

The results of logic operation of the Boolean operators are visualized as coloredconnecting lines of varying thickness. A wide green line indicates "fulfilled", a thinred line indicates "not fulfilled", and a thin black line indicates "inactive".

Transition State

State Meaning Color

INACTIVE The transition is not being processed. Gray

NOT FULFILLED The transition condition is not fulfilled. Dark red

FULFILLED The transition condition is fulfilled. Dark green

Operations in the Properties Dialog Box of the Transition

The following operations are possible within the dialog box:

• Close the dialog box with the "Close" button

• Acknowledge intervention request with the "C" button

• Select the previous or next transition with the "← / →" button

• Set option: "Update"

26.10.2000



3.16 Messages

General

During the execution of an SFC chart in the PLC messages are generated onintervention requests for transitions and in the case of step errors.

Generation of the Process Messages

The messages are generated generically by the PLC-OS-Engineering softwarepackage. In addition, mechanisms are stored with the messages. These permitdirect access to the SFC chart that a message relates to.

When an SFC standard display is integrated into a graphical display, the messagesof the SFC chart concerned are integrated into the hierarchy of the group display.

Process Messages in the Runtime System

The messages regarding intervention requests for transitions and step errors aredisplayed and archived by the WinCC reporting system.

From the message system it is possible to call up the detail window of the SFCchart for an SFC message (Loop In Alarm button), including the Properties dialogbox of the respective step and of the transition.

Process Messages in the Runtime System

When a process operation for an SFC chart is executed an operation message isgenerated and included in the operation list.

26.10.2000

SFC-Visualization for S7A5E00082886-01 A-1

A SFC API Functions

• BOOL SFCAbout(HWND projWnd, LPOHIO_ERRORSTRUCT lpdmError);

Opens the Info about SFC Visualization (version info).

Example: SFCAbout(NULL, (void*)0);

• BOOL SFCSetProperties(HWND projWnd, LPOHIO_ERRORSTRUCTlpdmError);

Opens the SFC Properties dialog box (read only)(dimensions, colors, privilege levels).

Example: SFCSetProperties(NULL, (void*)0);

• BOOL SFCSetChartProperties(HWND projWnd, LPCSTR chartName,LPOHIO_ERRORSTRUCT lpdmError);

Opens the Properties dialog box for a specific chart (read only)(comment, last change, updating cycle, standard view).

Parameters: chartName(in) Name of the chart, for example,"SFC1"

Example: SFCSetChartProperties(NULL, "SFC1", (void*)0);

• BOOL SFCOpenSection(LPCTSTR chartName, long left, long top, long width,long height, LPOHIO_ERRORSTRUCT lpdmError);

Opens the specified chart as a detail window.


left(in), top(in), width(in), height(in) Pixel coordinates ofthe rectangle in which the SFC windows may move

Example: SFCOpenSection("SFC1", left, top, width, height, (void*)0);

26.10.2000

SFC API Functions

SFC-Visualization for S7A-2 A5E00082886-01

• BOOL SFCOpenOverview(LPCTSTR chartName, long left, long top, longwidth, long height, LPOHIO_ERRORSTRUCT lpdmError);

Opens the specified chart as an overview window.



Example: SFCOpenOverview("SFC1", left, top, width, height, (void*)0);

• BOOL SFCRtBrowser(LPCSTR* pChartName, LPCSTR* pTagName, LONGleft, LONG top, LONG width, LONG height, BOOL alwaysOnTop);

Calls up the Runtime PackageBrowser and returns the selected chart, ifappropriate with the server prefix, for example, "OS1_KH1234D::SFC1"

Parameters: pChartName(out) Name of the chart, for example,"SFC1"

pTagName(out) TagName of the chart, for example,"SFC1" (used for the group display)


alwaysOnTop(in) 1, if the Browser is to always remainon top (recommended), otherwise 0

Example: SFCRtBrowser(&chartName, &tagname, left, top, width, height,1);

• BOOL SFCSaveWorkspace(LPCSTR pWsName);

Saves all the currently opened SFC windows user-specifically under theworkspace (screen combination) "pWsName_user.SSM".

Parameters: pWsName(in) Name of the workspace

Example: SFCSaveWorkspace("TestLayout1");

• BOOL SFCRestoreWorkspace(LPCSTR pWsName);

Restores all the SFC windows saved by using SFCSaveWorkSpace under theworkspace "pWsName_user.SSM".


Example: SFCRestoreWorkspace("TestLayout1");

26.10.2000

SFC API Functions


• BOOL SFCDeleteWorkspace(LPCSTR pWsName);

Deletes the specified workspace from the hard disk.


Example: SFCDeleteWorkspace("TestLayout1");

• BOOL SFCCloseAllWindows();

Closes all the open SFC windows.

Example: SFCCloseAllWindows();

26.10.2000

SFC API Functions


A.1 Script Example: Configuring an SFC Button

-------------------------------------------

#include "apdefap.h"

void OnLButtonDown(char* lpszPictureName, char* lpszObjectName, char*lpszPropertyName, UINT nFlags, int x, int y)

{

// WINCC:TAGNAME_SECTION_START

// syntax: #define TagNameInAction "DMTagName"

// next TagID : 2

#define TAG_1 "Plant_1/Unit_1/Function_1/SFC2"

// WINCC:TAGNAME_SECTION_END

#pragma code ("sfccli.dll")

#include "sfccli.h"

#pragma code ()

long left, top, width, height;

TCHAR szFullDmVarName[MAX_DM_VAR_NAME + 1 + 32];

{

TCHAR* pServerPrefix = NULL;

TCHAR* pTagPrefix = NULL;

TCHAR* pWindowPrefix = NULL;

GetServerTagPrefix(&pServerPrefix,&pTagPrefix,&pWindowPrefix);

26.10.2000

SFC API Functions


szFullDmVarName[0] = ’\0’;

if (pServerPrefix && pServerPrefix[0])

strcpy (szFullDmVarName, pServerPrefix);

else if (pTagPrefix && pTagPrefix[0])

strcpy (szFullDmVarName, pTagPrefix);

strcat(szFullDmVarName, TAG_1);

}

SSMGetWorkFieldCoordinates(SSMGetScreen(lpszPictureName), &left, &top,&width, &height);

// Overview

//SFCOpenOverview(szFullDmVarName, left, top, width, height, (void*)0);

// or Detail

SFCOpenSection(szFullDmVarName, left, top, width, height, (void*)0);

}

-------------------------------------------

26.10.2000

SFC API Functions


26.10.2000

SFC-Visualization for S7A5E00082886-01 Index-1

Index

AAcknowledge Operator Requests and

Step Errors .............................................3-12

CConfigurations for the SFC Visualization....... 2-1Configuring an SFC Button .......................... 2-7Configuring the "PCS7 SFC Control"

Status Display ......................................... 2-2Configuring the "PCS7 SFC MultiChart

Control" Status Display ............................ 2-4Configuring the SFC Browser Selection........ 2-8

DDisplay of the Detail Window........................ 3-7

FFurther Information on the Multi-Client.......... 2-9

MMessages...................................................3-16

OOperating and Monitoring the SFC Chart

via the SFC Status Display....................... 3-1Operations in the Detail Window .................. 3-8

PPCS7 SFC Control .......................................3-2PCS7 SFC MultiChart Control.......................3-3Properties Dialog Box of the Step ...............3-14Properties Dialog Box of the Transition .......3-15Properties Dialog Boxes of Steps and

Transitions .............................................3-12

SScript Example

Configuring an SFC Button ...................... A-4Setting the Operating Mode ..........................3-8Setting the Operating State...........................3-9Setting the Runtime Options .......................3-11Setting the Step Control Mode ....................3-10SFC API Functions...................................... A-1SFC Basic Settings ......................................1-2SFC Visualization.........................................1-1

UUser Privileges.............................................3-1Using Functions for Own Scripts

(SFC API Calls)........................................2-8

VVisualization via an SFC Selection Button

in the Button Set or via SFC BrowserSelection in the Display ............................3-6

26.10.2000

Index

SFC-Visualization for S7Index-2 A5E00082886-01

26.10.2000

SFC-Visualization for S7 1A5E00082886-01

Siemens AGA&D AS E 81Oestliche Rheinbrueckenstr. 50D-76181 Karlsruhe

Federal Republic of Germany

From:

Your Name:...............................................................................................................................

Your Title: .................................................................................................................................

Company Name:.........................................................................................................................

Street: .................................................................................................................................

City, Zip Code .....................................................................................................................

Country: ..............................................................................................................................

Phone: ................................................................................................................................

Please check any industry that applies to you:

❐ Automotive ❐ Pharmaceutical

❐ Chemical ❐ Plastic

❐ Electrical Machinery ❐ Pulp and Paper

❐ Food ❐ Textiles

❐ Instrument and Control ❐ Transportation

❐ Nonelectrical Machinery ❐ Other....................................................

❐ Petrochemical

26.10.2000

Remarks Form

2 SFC-Visualization for S7A5E00082886-01

Remarks FormYour comments and recommendations will help us to improve the quality and usefulness of ourpublications. Please take the first available opportunity to fill out this questionnaire and return itto Siemens.

Please give each of the following questions your own personal mark within the range from 1(very good) to 5 (poor).

1. Do the contents meet your requirements? o

2. Is the information you need easy to find? o

3. Is the text easy to understand? o

4. Does the level of technical detail meet your requirements? o

5. Please rate the quality of the graphics/tables: o

Additional comments:

..............................................................................................................................................

..............................................................................................................................................

..............................................................................................................................................

..............................................................................................................................................

..............................................................................................................................................

..............................................................................................................................................

..............................................................................................................................................

..............................................................................................................................................

..............................................................................................................................................

..............................................................................................................................................

..............................................................................................................................................

.............................................................................................................................................................................................

26.10.2000

Documents

simatic sfc-visualization for s7