37
RA Add-On for WinCC v1.1 User Manual Allottware CC Reg No: 2004/028046/23 P.O. Box 12611, Vorna Valley, 1686, South Africa Tel: +27 82 809 3262 Fax: +27 11 315 1464 Email: [email protected] Web: www.allottware.co.za Managing Members: Reuben Allott

RA Add-On for WinCC v1.1

Embed Size (px)

Citation preview

Page 1: RA Add-On for WinCC v1.1

RA Add-On for WinCC v1.1

User Manual

Allottware CC

Reg No: 2004/028046/23

P.O. Box 12611, Vorna Valley, 1686, South Africa

Tel: +27 82 809 3262 Fax: +27 11 315 1464

Email: [email protected] Web: www.allottware.co.za

Managing Members: Reuben Allott

Page 2: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 2 of 37 RA Add-On for WinCC

CONTENTS

1 INTRODUCTION....................................................................................................................................... 3

1.1 RA V1.1 OVERVIEW............................................................................................................................. 3 1.2 SYSTEM REQUIREMENTS ...................................................................................................................... 3 1.3 ADDITIONAL HELP ............................................................................................................................... 3

2 GETTING STARTED ................................................................................................................................ 4

2.1 INSTALLATION...................................................................................................................................... 4 2.2 PROJECT CREATION.............................................................................................................................. 5 2.3 STANDARD PROJECT CONFIGURATIONS ............................................................................................... 6 2.4 RA NAVIGATION BUILDER................................................................................................................... 8 2.5 PROJECT ACTIVATION ........................................................................................................................ 10 2.6 WEB NAVIGATOR ............................................................................................................................... 11

3 RA NAVIGATION BUILDER ................................................................................................................ 15

3.1 OVERVIEW ......................................................................................................................................... 15 3.2 TEMPLATE SELECTION ....................................................................................................................... 15 3.3 NAVIGATION CONFIGURATION ........................................................................................................... 16 3.4 BRANDING.......................................................................................................................................... 19 3.5 BUILDING ........................................................................................................................................... 19

4 RUNTIME FUNCTIONALITY............................................................................................................... 20

4.1 DEFAULT TEMPLATE .......................................................................................................................... 20 4.2 MAIN TOOL BUTTONS ........................................................................................................................ 20 4.3 DEFAULT MENUS ............................................................................................................................... 21 4.4 NAVIGATOR ....................................................................................................................................... 22 4.5 HELP PAGE......................................................................................................................................... 23 4.6 LOOP-IN-ALARM ................................................................................................................................ 24 4.7 AUDIBLE ALARMS (HORN)................................................................................................................. 25 4.8 RA WINCC TAG DEBUGGER ............................................................................................................. 26 4.9 SPLIT-SCREEN CONFIGURATIONS ....................................................................................................... 27 4.10 HIERARCHICAL ALARM NAVIGATION ................................................................................................ 28

5 RA FACEPLATE BUILDER................................................................................................................... 29

6 RA RECIPE MANAGER......................................................................................................................... 30

7 INCLUDED SCRIPT LIBRARY ............................................................................................................ 31

8 WIZARDS ................................................................................................................................................. 32

8.1 RA WIZARDS ..................................................................................................................................... 32 8.2 HOW TO LOAD THE WIZARDS............................................................................................................. 33 8.3 HOW TO USE THE WIZARDS ............................................................................................................... 34 8.4 EXAMPLE USAGE ............................................................................................................................... 35

9 CREATING YOUR OWN TEMPLATES .............................................................................................. 36

10 RA DEMO PROJECT.............................................................................................................................. 37

Page 3: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 3 of 37 RA Add-On for WinCC

1 INTRODUCTION

1.1 RA v1.1 Overview

Allottware RA v1.1 is an attractive alternative to the Basic Process Control navigation system

that ships with SIMATIC WinCC v6.0.

The system builds menus and faceplates from a set of template files. You can edit the

standard template files or create your own templates altogether. The system supports split-

screen configurations and can be published correctly using the Web Navigator or Data

Monitor systems (unlike Basic Process Control).

RA v1.1 is aimed primarily at small to medium sized systems implemented as an integrated

Step7/WinCC project. The Faceplate Builder is designed to work with structured tags

generated automatically by the Step7 OS compilation of Function Blocks and instance Data

Blocks (if you are using Siemens PLC and Siemens HMI, then this is how your project

should already be structured).

You can also use the RA Faceplate Builder in a stand-alone WinCC system as long as you

use tag structures that mimic the structures created by Step7 function blocks. This is

described later.

NOTE: The RA Template builder generates a project using completely standard WinCC

graphics and scripts. You can copy the project to another computer that does not have RA

installed on it and the project will still work correctly, although you won’t be able to edit the

navigation menus.

1.2 System Requirements

The following software versions were used in testing. Other versions may or may not work

correctly:

Product Version (Revision Level)

Windows XP Professional 5.1.2600 Service Pack 2 Build 2600

MS Internet Explorer V6 + SP2

MS Internet Information Services IIS 5.1

Step7 Professional V 5.3 + SP1 (K5.3.1.0)

WinCC V6.0 + SP2 + Hotfix 3 (V6.0.2.3)

Web Navigator Server V6.0 + SP1 + Hotfix 2 (V6.0.1.2)

Web Navigator Client V6.0 + SP1 (V6.0.1.0)

1.3 Additional Help

You can find the latest online help at the official RA web site:

http://www.allottware.co.za/ra

Page 4: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 4 of 37 RA Add-On for WinCC

2 GETTING STARTED

2.1 Installation

This getting started guide shows how to integrate a brand new WinCC project into an existing

Step7 project, apply the RA Template and publish it using the WinCC Web Navigator option.

It assumes that you already have Step7, WinCC, Web Navigator Server and corresponding

authorizations installed. Before installing Web Navigator you must have IIS installed. Please

refer to the Web Navigator/IIS documentation for this. When you install WinCC you must

select the Basic Process Control option.

RA v1.1 Add-On for WinCC is installed from the RA setup CD or from the setup.exe file

found in the RAv1.1.zip file downloaded from www.allottware.co.za. This is a standard

Windows installation:

You can accept the default installation path and just click next until the wizard has completed

the installation.

Page 5: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 5 of 37 RA Add-On for WinCC

2.2 Project Creation

Open your Step7 project and

insert an OS server from the

“Insert New Object” context

menu.

Rename the OS to something

suitable, without characters such

as parentheses (brackets), and

then compile it. If you are

unfamiliar with compiling the

OS you can ignore this step.

Page 6: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 6 of 37 RA Add-On for WinCC

2.3 Standard Project Configurations

Right-click on your OS and select “Open Object” to open your OS project with WinCC. If

you have correctly installed the RA v1.1 Add-On then you should see it in the tree just above

Web Navigator:

Before using the RA Template Builder you must apply a few project settings.

2.3.1 Project Properties

When you create an OS project in Step7 it

defaults to a multi-user project. This can

cause license errors if you are building a

single-user system and do not have a Server

authorization for WinCC.

Right-click on the very first node in the tree

(the name you gave to your OS) and change

the project to a single-user system.

Page 7: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 7 of 37 RA Add-On for WinCC

2.3.2 OS Project Editor

The RA Template works with the standard alarm configurations generated by the Basic

Process Control editor. We don’t use the Basic Process Control navigation system though.

Open the Basic Process Control

editor from the context menu. If

you do not see the OS-

ProjectEditor add-on then you must

install the Basic Process Control

add-on from the WinCC install CD.

You do not need to make any

changes in the editor. Simply click

the OK button and it will generate

the standard alarm system

configuration. The Basic Process

Control pictures will also be

applied, but these will be

overwritten when the RA Template

is applied.

Page 8: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 8 of 37 RA Add-On for WinCC

2.4 RA Navigation Builder

Right-click on “Navigation System” to open the

RA Template builder

The first time you open it the selection will be

blank.

Select the template you want for your project

from the drop-down list.

The navigation menus will be populated with

some default picture selections.

We explain later how to add new pictures into

the navigation menus, but for now you can

build the project with the default pictures.

Page 9: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 9 of 37 RA Add-On for WinCC

On the “Branding” page you can select your

own image files to be incorporated into the

project, or you can leave the default images in

place.

On the “Build” page, select the option to delete

the Basic Process Control picture files. This

will delete all the files starting with “@” from

the GraCS folder. If you do not do this the

project will be activated with the BPC screen

template.

Click on “Build” to generate your project.

Page 10: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 10 of 37 RA Add-On for WinCC

2.5 Project Activation

Activate the project from the File menu or with the

“Play” button.

The first time you run the project you will have to

define the start picture.

Select the “raMain.pdl” file.

If you want a split-screen configuration, select one

of the “raSplit_XxX” pictures.

The WinCC project should now be activated with

the RA Template.

Page 11: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 11 of 37 RA Add-On for WinCC

2.6 Web Navigator

Follow these steps to publish the project using the Web Navigator add-on:

1. Configure the Web Server

2. Publish the Pictures

3. Configure Users

4. Logon using MS Internet Explorer

NOTE:

If you have problems with the configuration make sure you have all the latest versions and

service packs of WinCC, Web Navigator, Windows and Internet Explorer. See section “1.2

System Requirements” for a list of tested software versions.

2.6.1 Configure the Web Server

Open the Web Configurator from the context

menu.

Accept all the defaults to create a new Web.

You must have IIS installed.

Page 12: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 12 of 37 RA Add-On for WinCC

2.6.2 Publish the Pictures

Next open the Web Publishing Wizard.

Select all of the pictures.

Select all of the functions.

Select all of the bitmap image files.

Click “Finish” to create all the Web pictures.

Page 13: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 13 of 37 RA Add-On for WinCC

2.6.3 Configure Users

Before you can use the Web Navigator client you must create users that have Web Navigator

access enabled for them, and select a start page for that use.

This is configured in the standard WinCC User Administrator application.

Open the WinCC User

Administrator.

Create any users and

password you require.

Select the Web Navigator

option and select the

“raMain.pd_” start picture

and the correct language.

You will not be able to select the start page before you have published your pictures (see the

previous section).

Page 14: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 14 of 37 RA Add-On for WinCC

2.6.4 Logon using MS Internet Explorer

We will now access the WinCC Runtime via the Web Navigator system using Microsoft

Internet Explorer. Make sure the WinCC Runtime is activated on the WinCC machine.

Open an Internet Explorer window and type in the address “http://<COMPUTERNAME>/”,

where <COMPUTERNAME> is the computer name of the WinCC machine.

If you are using Internet Explorer on the same computer as WinCC you can use the address

“http://localhost/”. If the WinCC computer name is “WinCC_1” then type in

“http://wincc_1/”.

You will be prompted to login.

Enter one of the usernames you configured in

the previous step.

The first time you logon you will be prompted to

download and install the Web Navigator client

software. Follow the onscreen instructions to run

the client installation.

Once the client software has installed you will

be able to view the project (the WinCC Runtime

must also

Page 15: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 15 of 37 RA Add-On for WinCC

3 RA NAVIGATION BUILDER

3.1 Overview

The main goal of the Navigation Builder is to apply the selected screen template to your

project and build the navigation menus for the pictures in your plant.

A library of scripts and pictures is also added to your project. Most of these scripts are used

by the navigation system to display pictures and faceplates.

You can also create your own templates that can be applied to new projects. This is useful for

OEM or System Integrators that implement many projects with their own branding and

special functionalities (you can download new templates from the RA website at

www.allottware.co.za/ra).

3.2 Template Selection

The first configuration is to select the main template to apply. Select the template from the

drop-down list.

Page 16: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 16 of 37 RA Add-On for WinCC

3.3 Navigation Configuration

3.3.1 Overview

In the navigation tree you build your menu

hierarchy by adding containers and sub-

containers. All operations are performed from

the right-click context menu.

All your pictures are displayed at the bottom.

Drag and drop the pictures onto the containers

in the tree to add them to your menus.

You can also use drag and drop to move

containers around in the tree. When you build

the template your menu structure will be

compiled according to this tree.

3.3.2 Context Menu

The functions of the context menu are as follows:

Menu Item Description Add Container Add a new container to the tree (on the same level as the selected one)

Add Sub-Container Add a new container to the tree (as a child on the selected container)

Add Back Button Add a “Back” button. In runtime this is a menu button that will return to the parent menu.

Edit Container Edit the selected container

Delete Container Delete the selected container

Cut Cut the selected container from the tree for pasting

Paste Paste the cut container before the selected node

Paste Into Paste the cut container as a child of the selected node

Apply Access to All Apply the selected access level to the selected container and all of its children

Picture Name Display the picture name in the tree

Descriptions Display the picture names & titles in the tree

Titles Only Display only the picture titles in the tree

Save Menu Save the selected menu to a file

Load Menu Load a previously saved menu file into the selected menu

Page 17: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 17 of 37 RA Add-On for WinCC

3.3.3 Editing Containers

There are four type of menu buttons you can create:

1. Standard Buttons either open a submenu or picture or are

simply descriptive labels

2. “Back” buttons are buttons that return to the previous or

parent menu

3. Copied objects are any graphic object copied from another

picture

4. Script buttons are menu buttons that perform some C-Script

action

Every menu button has a caption and an authorization. The caption is

simply the text to be displayed on the menu button.

The authorization is the standard WinCC user authorization that is

required to click on the button. Click on the ellipses button (…) to open

the WinCC user authorization selection dialog.

3.3.3.1 Label/Button

If you select a picture on a standard button then that picture will be

opened when the menu button is clicked. If you specify a picture title it

will be displayed in the main picture title bar. If you do not specify a

picture title, the picture name will be used.

If you select no picture then the menu item appears simply as a text

label.

Select this option to include this picture in the automatic slide show

(see the section on the Navigator window for more details).

Menu items can be linked to alarm status tags that are linked to alarm

groups configured in the WinCC Alarm Logging editor.

Please refer to the alarm logging help for more information on the

implementation of these status tags.

You can create a hierarchical alarm navigation system using these

status tags.

In runtime an indicator will light up on the left-hand side of the menu

button when an alarm has been triggered in the alarm group.

Page 18: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 18 of 37 RA Add-On for WinCC

3.3.4 Back Button

A back button has no setting other than the caption text. In runtime the button will replace the

current menu with the parent menu (return to previous menu).

3.3.5 Copied Object

When you select a copied object the builder does not

create a menu button. Instead it copies the graphic

object you have specified into your menu picture.

You can specify whether to place the object where the

button would be placed (inline) or provide your own X

and Y coordinates.

This can be used for example to insert a logo image on

the menu.

3.3.6 C-Script

If you select C-Script you can enter a C-Script

function to be executed in the Mouse Action

event of the button.

The “Compile” button will compile the script and

inform you of any compilation errors in the

script.

You can paste any valid C-Script code from

WinCC pictures in here.

Page 19: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 19 of 37 RA Add-On for WinCC

3.4 Branding

On the “Branding” page you can select your

own image files to be incorporated into the

project, or you can leave the default images in

place.

This allows you to brand the template

differently for different projects without having

to create entirely separate templates just for

different company logos.

Click on “Replace” to select a new image file.

Click on “Original” to revert to the original

image.

3.5 Building

On the “Build” page, select the option to delete

the Basic Process Control picture files. This

will delete all the files starting with “@” from

the GraCS folder. If you do not do this, the

project will be activated with the BPC screen

template.

If you select “Create non-existent mimics” then

any picture names found in the navigation tree

that do not exist will be created for you.

Click on “Build” to generate your project.

Page 20: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 20 of 37 RA Add-On for WinCC

4 RUNTIME FUNCTIONALITY

4.1 Default Template

The default template is described here. It is possible that you have a different template that

was created by someone else.

4.2 Main Tool Buttons

Open the main mimic menu

Log on

Open the alarms menu

Silence horn (if configured)

Open the trends/reports menu

Open system help page

Open the system menu

Display previous page in the page history (back button)

Click on the logo to open the project welcome picture. Right-click to open the Global Script Diagnostics window.

Main Menu Select pictures and sub-menus

from here.

Mimic Area Pictures are

displayed in this main area

Picture Title The name of the currently displayed

picture is shown here

User Name The user name

currently logged on

Navigation buttons and Current time

Alarms The latest active or

unacknowledged alarms

Click here to open the main alarm window

Menu Selection The four main menus are selected here: Mimics, Alarms,

Reports and System

Page 21: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 21 of 37 RA Add-On for WinCC

4.3 Default Menus

When you apply the template to your project for the first time the following default mimics

are added to your menu system.

4.3.1 Mimics

Mimic Description Project Overview This is a blank mimic to be used as your main starting page

Help This is an HTML-based help system for your project

Legend This shows and explains the main symbols and colours used in your project

Test This is a blank page to be used for testing purposes

4.3.2 Alarms

Alarm Page Description Incoming All currently unacknowledged alarms

Current All currently active alarms

Alarms High/Low Alarms & Warnings

Process Process control alarms

Operations Operator actions (manual device control, set point change, user logon)

System Control system alarms & messages (PLC & OS equipment & communications)

4.3.3 Trends & Reports

Report Page Description Main Trends Opens a trend page that the user cannot edit in runtime

User Trends Opens a trend page that the user can edit in runtime

Floating Trends Opens a floating trend window that can be edited in runtime

4.3.4 System

Function Description Global Script Diag This opens the Global Script diagnostics window, used primarily for debugging scripts

Tag Debugger This opens the WinCC Tag Debugger application, which is described later in the document

Shut Down This shuts down the WinCC runtime

Restart PC This shuts down the WinCC runtime and reboots the computer

Project Editor This opens the WinCC Explorer program

Graphics Editor This opens the WinCC Graphics Editor, with the currently displayed picture

C-Script Editor This opens the WinCC C-Script Editor

VB-Script Editor This opens the WinCC VB-Script Editor

User Admin This opens the WinCC User Administrator

Windows Explorer This opens a Windows Explorer window

Task Manager This opens the Windows Task Manager

Calculator This opens the Calculator program

Fix Popups It is possible to disable faceplates if there are scripts in your project which attempt to open non-existent faceplates. This button fixes that scenario.

Page 22: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 22 of 37 RA Add-On for WinCC

4.4 Navigator

If you click on the main picture title bar in runtime you will

get a drop-down list of all the pictures in the project. Simply

select the picture to open it in the main window.

Currently the builder does not correctly compile one of the

functions, so if you add pictures to the project you must

manually compile the function before this navigator drop-

down will list all the pictures correctly.

Open the C-Script function “raNavigator” from the WinCC

Explorer.

Compile the function by clicking on the “Compile” button

Save the function by clicking on the “Save” button.

These three buttons control the automatic slide-show function.

From left to right:

Play – this starts the slide show

Stop – this stops the slide show

Close – this closes the navigator window

The pictures that are included in the automatic slide show are

specified in the properties dialog of the RA Navigation

Builder.

When the slide show is started, the picture is automatically

changed every 10 seconds.

Page 23: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 23 of 37 RA Add-On for WinCC

4.5 Help Page

Click the Help button to display the system help file:

The default help file is blank. The intention is for you to replace it with your own help file for

your project.

The help file is stored in the following location:

<Your WinCC Project Folder> \ RA \ Help \ Index.html

This is a standard HTML text file. You can edit this file or replace it with your own file.

Page 24: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 24 of 37 RA Add-On for WinCC

4.6 Loop-in-Alarm

4.6.1 Runtime

Loop-in-Alarm is a standard WinCC alarm logging function that allows you to open a picture

or faceplate for the selected alarm. Select the alarm in the alarm-logging list and click on the

loop-in-alarm button on the alarm control toolbar:

Loop-in-Alarm tool button

4.6.2 Configuration

In the alarm-logging editor select the message you want

to add this functionality to and open the properties dialog.

Enter the device name (tag name) as the parameter and

select the function “raLoopInAlarm”. This function is part

of the RA Script library and will open the faceplate for

the supplied tag name.

You must create the faceplate with the RA Faceplate

Builder for this function to work correctly.

The faceplate for the device

that triggered the alarm is

opened up when the alarm is selected in the alarm list

and the loop-in-alarm button is pressed.

Page 25: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 25 of 37 RA Add-On for WinCC

4.7 Audible Alarms (Horn)

WinCC V6.0 makes it very simple to configure audible alarms. When a certain alarm is

triggered the system will write a tag to the PLC to sound a physical horn, or the PC will play

a sound file through the computer speaker.

Some functionality has been included in the template project already to make this even

simpler.

First, you must decide which alarm classes or groups (as configured in the WinCC Alarm

Logging editor) will trigger an audible alarm.

Next open the WinCC Horn Editor:

Select the alarm message class that is to trigger an

audible alarm, and select the tag “RA-HORN” (this tag

is created by the template builder and is already linked

to the template pictures).

Select the “RA-HORN” tag again, and select the sound

file to play when an alarm is triggered (*.wav – the

template builder copies several example files into the

project for you).

In runtime when an alarm is triggered (of the class you selected in the Horn

editor) the selected sound file will be played until the tag “RA-HORN” is

switched off.

The “Horn” button flashes red. Click this button to turn off the “RA-HORN”

tag and thus silence the sound file.

NOTE:

If you want to trigger a tag in the PLC for a horn connected to the PLC, then substitute the

tag “RA-HORN” with your own PLC tag. You will have to edit the template picture shown

above to be able to switch off the tag from WinCC.

Page 26: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 26 of 37 RA Add-On for WinCC

4.8 RA WinCC Tag Debugger

The WinCC Tag Debugger is a simple utility for reading and writing runtime tag values in

various formats. It is intended for testing purposes.

Open the Tag Debugger from the “Tag Debugger” menu

in the default System menu.

Click on the ellipses (…) button to select the tag you

want to inspect. The regular WinCC tag selection dialog

is opened.

Once you select a tag its value will be displayed

dynamically in the bottom section.

If you select an analog value you can edit it in Decimal,

Octal or Hexadecimal.

Use the Binary Structure to toggle individual bits on and

off.

You can also edit text tags.

Page 27: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 27 of 37 RA Add-On for WinCC

4.9 Split-Screen Configurations

It is possible to use the template in split-screen configurations. You need to configure your

video system with a desktop stretched across multiple monitors.

The most common configuration is to have two screens side by side. The default template

size is 1024x768 pixels, for which we normally use the picture “raMain.pdl” as the main

picture. With two screens it is 2048x768, and we simply open two copies of “raMain.pdl”

side by side. Do to this you need another picture file that displays the “raMain.pdl” picture

twice on one picture.

There are a few pre-configured pictures in the default template that do this already. Simply

select the one you want as the start picture for the project.

Picture Usage raMain Standard single-screen configuration

raSplit_1x2 Two screens, one next to the other

raSplit_2x1 Two screens, one above the other

raSplit_2x2 Four screens, two rows by two columns

Open the computer properties in the WinCC

Explorer and select one of the start pictures listed

above.

Page 28: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 28 of 37 RA Add-On for WinCC

4.10 Hierarchical Alarm Navigation

The Navigation Builder can be used

to create a hierarchical alarm

navigation menu.

This makes it easy to navigate

through the menu to the plant area

affected by current alarm activity:

drill down following the flashing

icons on the menu buttons until you

get to the relevant picture.

First you must configure the User

Defined alarm group messages to

match your plant and mimic

hierarchy.

Connect an internal status tag to

each alarm group as shown on the

left.

In the navigation builder enable the

“Menu item is linked to Alarm

Group Status tag” option and select

the same status tag in this dialog for

the menu button.

This is demonstrated in the RA Demo Project.

Page 29: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 29 of 37 RA Add-On for WinCC

5 RA FACEPLATE BUILDER

The RA Faceplate Builder simplifies the process of creating device-specific faceplates. Each

faceplate is associated with an FB in Step7 and the corresponding tag structure created in

WinCC by the OS Compilation of the Step7 data.

The Faceplate Builder is explained in more detail in the accompanying document “RA

Faceplate Builder v1.1”.

You can get the latest revision of this document from www.allottware.co.za.

Page 30: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 30 of 37 RA Add-On for WinCC

6 RA RECIPE MANAGER

The RA Recipe Manager is a simple recipe system include with RA v1.1. It is explained in

more detail in the accompanying document “RA Recipe Manager v1.1”.

You can get the latest revision of this document from www.allottware.co.za.

Page 31: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 31 of 37 RA Add-On for WinCC

7 INCLUDED SCRIPT LIBRARY

There are many scripts included in the template project. Many of these scripts are used by the

template navigation and faceplate systems, and should not be edited or used directly in your

project.

There are several useful string manipulation functions and system functions that deal with the

registry, tag values and the operating system.

Please read the header blocks in the actual scripts for more detailed information.

The main functions you will use are:

Function Description

ProjectStartup This is a blank function created by the template builder. Insert code in here that is to be executed at project startup. This function will

execute once only, and does not execute on WebNavigator clients.

raOpenPicture This opens a picture in the main window. You must use this function to ensure compatibility with split-screen configurations and Web

Navigator.

raOpenPictureWithTagPrefix Open a picture. Apply a tag prefix to the entire picture.

raPopup Open a picture in a poup window.

raPopupDevice Open a device faceplate. The faceplates are created with the RA

Faceplate Builder.

raLoopInAlarm Open a device faceplate from the alarm list (see Loop-in-Alarm section)

Page 32: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 32 of 37 RA Add-On for WinCC

8 WIZARDS

Several Dynamic Wizards are available for the RA WinCC Template. These make certain

configurations in the graphics editor easier. When using the RA WinCC Template

framework, certain operations, like displaying a mimic or opening a popup faceplate, must be

done using the functions provided by the template. This ensures that the project remains fully

compatible with split-screen and Web Navigator configurations, as well as maintains

functionality such as the paging history.

Using Dynamic Wizards means that you do not need to know what functions or scripting to

use to perform these operations.

8.1 RA Wizards

The following wizards are included with the RA WinCC Template:

• Open Picture - Use this to open a new mimic in the main mimic window. You can select

the .PDL filename to diplay, and optionally supply a title to display as the mimic caption

(if no title is specified, the mimic filename is used).

• Open Picture (Tag Prefix) – Use this to open a new mimic in the main window with a

tag prefix assigned to the entire mimic.

• Open Popup - Use this to open a new popup window. You can select the .PDL filename

to open in the popup window, and optionally supply a title and tag prefix to apply to the

windwo).

• Open Popup (Device) - Use this to open a new popup window for a structured-tag

device. The structured tag must be selected, which must conform to the PCS7-style

naming conventions (this includes text tags that indicate what .PDL file to use).

Page 33: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 33 of 37 RA Add-On for WinCC

8.2 How to Load the Wizards

I haven't yet figured out how to automatically load the RA Wizards for you yet, so you'll have

to load them manually before you can use them.

First, you must copy the Dynamic Wizard files from the RA CD, in the following location:

< CDROM >\RA\RA\runimage\templates\@Default\WScripts\Wscripts.enu

Paste these files into the WinCC wizard folder:

< SYSTEM >\Program Files\Siemens\WinCC\WScripts\Wscripts.enu

Next, install the optional "Dynamic Wizard Editor" from the WinCC CD, and open it:

Click on the compile button as shown above, and the RA Wizards will become available.

Page 34: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 34 of 37 RA Add-On for WinCC

8.3 How to Use the Wizards

The Wizards are accessed from the WinCC Graphics Editor. If the Dynamic Wizard window

is not visible, enable it from the "View"-> "Toolbars" menu option:

You will then see the Dynamic Wizard toolbar:

You must have a picture opened. Select an object, such as a button, and then double-click on

the Dynamic Wizard you wish to run. You will be prompted to fill in certain parameters, such

as tag names or picture names, and then the Wizard will fill in any scripting or dynamics

required.

Page 35: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 35 of 37 RA Add-On for WinCC

8.4 Example Usage

Make sure the Dynamic Wizard toolbox is open and select a button in the WinCC Graphics

Editor. The following example shows how to use the wizard to open a device faceplate.

Select the “Open Popup (Device)” wizard.

Double-click to run the wizard.

Select the action on which to open the faceplate. Here

we select “Mouse click” which will respond when the

user clicks the button with any mouse button.

Now click on the button (…) to select the tag from the

WinCC tag selection dialog.

Click Next when you have selected a tag.

The wizard displays the tag name for confirmation.

Click Finish to generate the script required to open the

device faceplate for the selected tag.

Page 36: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 36 of 37 RA Add-On for WinCC

9 CREATING YOUR OWN TEMPLATES

This will be addressed in the next release.

Page 37: RA Add-On for WinCC v1.1

User Manual RA Add-On for WinCC v1.1

Rev: 2, 6 Feb 2005 Page 37 of 37 RA Add-On for WinCC

10 RA DEMO PROJECT

The RA Demo Project is an example implementation of the RA Template project using the

Navigation & Faceplate builder in an integrated Step7/WinCC environment.

The project includes examples of: Step7/WinCC integration, function blocks with

corresponding faceplates, process and system diagnostics, AS-triggered alarming and many

WinCC scripting examples.

More detailed help on the RA Demo Project will be included in the next release.

Please visit www.allottware.co.za for the latest information.

Demo project with faceplates, trending & alarming all published to the web