exercises ft904 sm rev2.2

7/29/2019 Exercises FT904 SM Rev2.2

1/86

1 FAST/TOOLS R9.04 training

FAST/TOOLS R9.04Exercises

2010 by Yokogawa. No part of this document may be reproduced or transmitted in any formor by any means, electronic or mechanical, including photocopying, recording or by anyinformation storage or retrieval system without written permission from Yokogawa TrainingCenter Europe.


2/86


Rev. Who Date Description1.0 TCE February 2009 First release.1.1 TCE June 2009 Small corrections.2.0 TCE June 2010 Release R9.032.1 TCE October 2010 Small corrections.2.2 TCE June 2011 Release R9.04


3/86


4/86


11.1 Local parameter..........................................................................................................4611.2 Functions....................................................................................................................48

12 Layers ............................................................................................................................4912.1 Zooming......................................................................................................................4912.2 Toggle layers ..............................................................................................................50

13 Layouts...........................................................................................................................5213.1 Layouts file .................................................................................................................52

14 Localization ....................................................................................................................5314.1 Add language..............................................................................................................5314.2 User definition.............................................................................................................54

15 Symbols part 1 ...............................................................................................................5515.1 Valve...........................................................................................................................5515.2 Popup.........................................................................................................................5715.3 Add to symbol.............................................................................................................6015.4 Tag name ...................................................................................................................62

16 Symbols part 2 ...............................................................................................................6416.1 New symbol ................................................................................................................6416.2 Modify display.............................................................................................................6516.3 Popup.........................................................................................................................6716.4 Add to symbol.............................................................................................................6816.5 Exclusive control .........................................................................................................69

Appendix A: Adding equipment .................................................................................................73Appendix B: Adding an OPC-DA station....................................................................................77Appendix C: Using signal make structure in PROCESS/FAST. ...............................................79Appendix D: Recording and playback functionality....................................................................84


5/86


Foreword

In this document youll find training exercises that have been carefully put together to give an

overview of all the functionality of FAST/TOOLS. It will teach you how to use the graphic editorand engineering environment to build and extend applications.

FAST/TOOLS has undergone tremendous changes in the last couple of years. After leaving theold operator interface going from version 8.4 to R9.01 now the next step to R9.03 has beentaking by updating the engineering environment. The fantastic new engineering environment(Engineering Module) now is also completely web based and can be accessed from anywherein the network. To R9.04 playback functionality, X-Y Plot and Alarm to email functionality havebeen added.With small exercises the working of FAST TOOLS will be explained.


6/86


1 Installing FAST/TOOLS

Before we can work with the application well need to install it. In this training FAST/TOOLS willbe installed as a single stand-alone system on Windows. In this exercise we will be looking atthe FAST/TOOLS program group and explore some of its applications.

1.1 Auto run

Start the application FT.exe in the root folder of the installation DVD manually if the auto-runfeature is disabled. The FAST/TOOLS Installer dialog will appear.

Install the following:

Acrobat reader (needed for the documentation) FAST/TOOLS documentation

FAST/TOOLS

1.2 Stand alone FAST/TOOLS system

After selecting the installation language, the installation of FAST/TOOLS will start. First theresthe license information which is followed by the first option: the destination location:

Use the default installation path on the C-drive. This has benefits when exchangingconfigurations between colleagues as well see later on.


7/86


The next step is to choose what parts of FAST/TOOLS will be installed.

Choose the option Custom and click next. In the following dialog choose the followingcomponents: Server

Front-end HMI

Equipment Plugins

Then click next to install a stand-alone system configuration. In case of prompted install/repairOPC software, acknowledge this.


8/86


1.3 Licensing

An unlicensed FAST/TOOLS system will run for 1 hour before shutting down. This allows you toplay with the application and see its potential.

The FAST/TOOLS Licensing wizard is used to activate a license.

In the next dialog choose I want to use the FAST/TOOLS license file and click Next.


9/86


Navigate to the license file and select next.

Note: It is recommendable to copy the *.lic file to the tls directory to keep it together with the tls.Licensing is done based on a node name and node number; the whole configuration is tied tothis number and name. It is important to realize that it is not possible to change the nodenumber of a system. The configuration will be deleted when doing so. There are ways to extractthe configuration from a system and then insert it into a new system with another node numberbut it is good practice to order the required licenses right away when starting a project.

1.4 Message-log

FAST/TOOLS has a very extensive error tracing mechanism. Messages are logged by the socalled UMH process. To view real-time messages start the Message-log from the programgroup.

This monitor is one of the first places to look when something goes wrong. The information it

gives is important to note when requesting support.


10/86


1.5 Performance Monitor

After FAST/TOOLS is successfully licensed we can start the application. After startingFAST/TOOLS start the Performance Monitor and explore its possibilities.

The Generaltab shows license information; it relates to the imported license file.Very important is the Freecommon space, High common used and Free event handlesinformation. It shows how much memory is available and used. The High common usedvalueshould never reach 100 %.

A report with all information about the installation can be generated when the button Report ispressed. Generate a report and inspect the information in it.

The Toolstab shows which tools are running.

It gives a quick indication about the status of FAST/TOOLS and shows if something is wrong.


11/86


The Processes tab is also very important as it shows information about each FAST/TOOLSprocess.

Inspect the Processes tab and refer to the online help (by pressing the Help button) and seewhat each column is for.

The Nodes tab shows information about connected FAST/TOOLS systems. In a stand-alone

system this page is empty.

The Versiontab shows information about the most important components of FAST/TOOLS. Thisinformation can be very helpful in case of a version related issues.

The Diagnostictab is used to specify the level of system monitoring. The state of aFAST/TOOLS system can be monitored continuously and the gathered information can bestored for later reporting and analysis. This tab is used to define the level of informationgathering. The report button generates a zipped file with collected information and projectconfiguration information. This file can then be passed to a certified FAST/TOOLS engineer foranalysis.


12/86


1.6 Setup File Editor

Some settings of FAST/TOOLS are configured in so called setup-files. These files can bemodified using the setup file editor, also found in the FAST/TOOLS program group.

Inspect some of the setup files and look at the help to find out what they are used for.

Most setup files will never be modified in a project, only some of the files are of interest for smallprojects. The actual files are located in the sup folder:


13/86


1.7 Documentation

The FAST/TOOLS DVD has extensive documentation about FAST/TOOLS. Yokogawa used tosupply hard-copy versions of all manuals; stacked together this would make a pile of papermore then 2 meters high! Navigate to the FAST/TOOLS DVD, choose FT install FAST/TOOLS

documentation.

Especially the language manuals of PROCESS/FAST and REPORT/FAST are very important touse when working with classes or reports.

It is very important to read the Release Notes for each release because they show vitalinformation about new features, changes and known issues and bugs.

Inspect the documentation.

Project storageBefore starting with engineering, it will be recommendable to make a copy of the clean tls.The tls is the folder in with the total project will be stored inclusive license file.For Windows XP this folder is located at:C:\Program Files\Yokogawa\FAST TOOLS\tlsFor Windows 7 this folder is splint up in two folders located at:C:\Program Files\Yokogawa\FAST TOOLS\tls and at: C:\users\public\yokogawa\tlsTo work with different projects FAST/TOOLS always runs the folder that is\are named tls.


14/86


2 I/O Processing

This exercise focuses on the I/O processing branch of the Engineering Module.

2.1 Installation and unit

First well insert the installation STATION1


15/86


Then add the unit COMPRESSOR

2.2 Adding items

The table below shows the items that need to be added.

Name Description Type ProcessArea

Alarming Alarm state

SOV-001-PV Status valve SOV-001 Boolean Bool0 = CLOSE & redBool1 = OPEN & chartreuse green

Alarm 2Normal

SOV-001-MV Open/close SOV-001 Boolean 1 Bool0 = CLOSE & redBool1 = OPEN & chartreuse green

Alarm 2Normal

SOV-002-PV Status valve SOV-002 Boolean Bool0 = CLOSE & redBool1 = OPEN & chartreuse green

Alarm 2Normal

SOV-002-MV Open/close SOV-002 Boolean 1 Bool0 = CLOSE & redBool1 = OPEN & chartreuse green

Alarm 2Normal

P-1002-PV Status Pump 1002 Boolean Bool0 = STOPPED & redBool1 = RUNNING & chartreusegreen

Alarm 2Normal

P-1002-MV Start/stop Pump 1002 Boolean 2 Bool0 = STOP & redBool1 = START & chartreuse green

Alarm 2Normal

PT-001 Pressure indicator Real Copy alarm limits example 3 pagesfurther.

n/a

PT-002 Pressure indicator Real Copy alarm limits example 3 pagesfurther.

n/a


16/86


Example of a valve status item:

Alarming tab settings:

Note: Custom colors can also be added to a named color list. You could add project specificcolors, making it very easy to change them when needed throughout the project.


17/86


Example of a pressure indicator item:

Here the limits tab settings:

Copy the limits from the example above for the pressure indicator items.


18/86


2.3 Modify values

Using the HMI you can modify the value and status of an item and see what happens. Rightclick on the item to get the context menu that allows you to open the Update value dialog asshown below.

Open the dialog for PT-001 and fill out the following table status for each value; this can be

done by overwriting the value manually.

Value Status

5

15

50

85

95


19/86


2.4 Blocked

Try to change the value of an item when it is blocked. First block the item, right click on the itemand choose the block dialog.

Look at the item value and see how it behaves when you try to change it.

Can you change the value?

Verify the value by using the item value list.

The item value list can be reached by clicking with the right mouse button on the item (or items)and selecting List item values. The values shown in the list are the actual real time value(s).From the dialog it seems that the new value is used but as you can see from the item value list itis not.


20/86


2.5 Deadband

Enter a deadband of 1 for the pressure transmitter item to avoid too much repetitive alarmmessages.

How does the alarming function now? Draw the deadband into the graph below.

Pressure


21/86


3 Authorization

In this exercise well create some users and play with them.

3.1 Users

Add under Authorization group the group ALL with credentials to modify every dataset.

This list determines what a user is allowed to do in the engineering environment and in the

operator interface.

Add the following users:

User Description Process Areas Play back optionsTOOLS FAST/TOOLS engineer 1,2 All on

USER The operator 1 All on

SUPER Operator supervisor 2 All on


22/86


The operator interface properties will be modified later on, leave them empty for now.Note: dont forget to set a password! A password can always be modified later on.

3.2 Process areas

The items created in an earlier exercise where assigned to process areas. Test how the processarea influences what a user is allowed to do. Log on as a user and try to modify the MV items.Fill the table below and write down for each user if it is possible to modify the value.

Note: You will have to enable authorization in the Engineering Module. Go to the Setup FileEditor, edit description Web-HMI Engineering Module and set the Login method to MANUAL.Save the changes and restart the Engineering Module.

Item Tools User SuperSOV-001-MV

SOV-002-MV

P-1002-MV

Note: Using process areas we can easily assign privileges to users. When designing a newproject it is very important to think about how these privileges of the process areas need to begrouped to meet the customers requirements.


23/86


4 Alarming

4.1 Item status tableIn this exercise we will take a look at Alarming. The Item status table holds the system widedefinitions for the various item states. Item states can be added and modified. Inspect thedefault table, especially the states HIGH, HIGH HIGH, LOW and LOW LOW.

4.2 Acknowledgement

The acknowledgement matrix allows the engineer to specify how a change of item status ishandled in respect of alarm acknowledgement (automatic or manual by the operator). Add theacknowledgment type manual. Open up the Alarming branch and then insert anAcknowledgment type by right clicking on the branch.

The acknowledgement matrix is triggered every time the status of the item changes (forinstance from H to HH). If the box are ticked the new alarm state is automatically acknowledged,if not ticked manual acknowledgement from the operator is needed.The functioning of the acknowledgement matrix can be explained as follows. In theacknowledgement matrix start always at section (1) Current alarm state and pick the currentsituation at section (2). After an item status change pick the new situation by moving in a

horizontal direction to the new situation in section (3). If that box is ticked on the new alarm stateis automatically acknowledged, else manual acknowledgement is required. After manual,automatic or no acknowledgment youre back at (1), choose the new alarm status at (2).

For example, if the current alarm state is Alarm 1 Ack, and the new alarm state is No alarm,then the new alarm state will be automatically acknowledged. If however the current Alarm stateAlarm 1 and Nack, then a change to No alarm will require an acknowledgement of the Operator.


24/86


Assign all alarm item tags at once with the manually acknowledgement matrix; you can select allitems and change this property at once (selecting items and use right mouse button to get thecontext menu, see screen shot).

Start the Operator Interface and open the current alarm overview. Generate an alarm on one ofthe pressure indicators and see how the alarm is shown. A new alarm will have anunacknowledged state and after acknowledging the alarm it will go to an acknowledged state.

What happens when you go from Normal to High?A new alarm is generated, acknowledge this alarm.What happens when you go from High to HighHigh? An alarm is generated again.What happens when you go from HighHigh to Normal without acknowledging?

4.3 Alarm text

Change the Alarm Text for the status HIGH HIGH to VERY HOT in the Alarming item definitionof PT-001. This overrules the system wide definition in the Item Status table.

Generate a HH alarm and see what happens. The alarm text that is configured in the itemdefinition will overrule the system wide definition.


25/86


4.4 Delayed alarm

Specify a delay time of 5 seconds for the pressure indicator PT-001 and generate an alarm andwait. Open de operator interface and see whats happened?

Now go from a normal value to a value that would generate an alarm and back again within 5

seconds. What happens?

4.5 Repeat time

Specify a repeat time of 10 seconds for the pressure indicator PT-002 and generate an alarm.What happens after 10 seconds? (Update the value in the engineering module by right click onthe PT-002 item, update value). Go to the operator interface, click on the button go to historicalalarm list and see whats happens.

4.6 Semi-automatic

Add an acknowledgement type that allows for semi-automatic acknowledgement when goingfrom an acknowledged Alarm 3 to an Alarm 2 and from an acknowledged Alarm 2 to an Alarm 1.

Now assign one of the pressure indicators to this acknowledgement type and see how it reactsdifferently when going from one alarm state to the other.


26/86


4.7 ASA (Alarm Selection Areas)

Create a filter that will show priority 1 alarms only in the alarm banner.

To filter on priority 1 alarms only, youll need to create a so called ASA filter. Add an ASA calledPRIO_1_ONLY. Type the command prio = 1 in the code area and press the Compile button.

The compile button will appear after saving and opening the filter.

After starting the Operator Interface, open the display current alarm list.

In the drop down field you can select: ASA, PRIO_1_ONLY.

Note: in FAST/TOOLS it is also possible to assign ASAs to individual users.


27/86


5 Processing

In this exercise well take a look at the PROCESS/FAST language.

5.1 ClassIn the engineering module under processing\classes, individual classes can be added.To animate some control we will add a simple class. Copy the code from the class below:

{+---------------------------------------------------

|

| Name : CONTROL

|

| Version : 0.1

|

| Author : Tools

|

| Description : Class to simulate valve response

|

+---------------------------------------------------}

CLASS control;

PROLOG

ATTRIBUTE a_status STRING;ATTRIBUTE a_control STRING;

PROMPT a_status QUERY "Status item";

PROMPT a_control QUERY "Control item";

SIGNAL s_status := a_status;

SIGNAL s_control := a_control TRIGGER VALUE;

BODY

TIMER t_runtime TRIGGER;

METHOD start_timer;

ENTRYCONDITION TRGSIG(s_control);

t_runtime := 5;ENDMETHOD start_timer;

METHOD do_action;

ENTRYCONDITION TRGTIM(t_runtime);

s_status := s_control;

ENDMETHOD do_action;

ENDCLASS control;


28/86


Press the ok button to insert it. Open the class again, this time the compile button will be visiblein the right top corner of the screen. Press the compile button and check the generate listingtick box for debugging. In case of errors in the code, the tab listing will show error details.

The class functions as follows: the status signal s_control is defined as trigger signal. Every time

its value changes it triggers the class body. The method start_timer is programmed to run onthis trigger.It sets a timer to 5 seconds, which is used to trigger the method do_action. This method copiesthe value of s_control to s_status.In a real life situation changing the value of the control signal MV, which corresponds toupdating the value of the connected item, would result in an action at the attached controller andwill be reflected in the status change of for instance a valve.

5.2 Objects

For each of our control elements an object instance of the control class must be added.

* Note: in the object name a minus sign is not allowed, use an underscore instead.** If you add an installation & unit under items the same installation & units are generated underobjects and vice versa.

Add the following three object instances of the class control:

Object Status item Control itemSTATION1.COMPRESSOR.SOV_001 STATION1.COMPRESSOR.SOV-001-PV STATION1.COMPRESSOR.SOV-001-MV

STATION1.COMPRESSOR.SOV_002 STATION1.COMPRESSOR.SOV-002-PV STATION1.COMPRESSOR.SOV-002-MV

STATION1.COMPRESSOR.P_1002 STATION1.COMPRESSOR.P-1002-PV STATION1.COMPRESSOR.P-1002-MV

Now use the Engineering Module to modify the MV signal and see how the PV changes.


29/86


5.3 Simplify the declaration for objects.

Simplify the Status item and Control item declaration for objects.Modify the CONTROL class in such a way that it uses the INSTALLATION and UNIT of theobject and just prompts for the last part of the item name. Hint:

s_control := INSTALLATION || . || UNIT || . || a_control TRIGGER VALUE

The idea behind this is that you dont have to fill in complete item names.Note that youll need to re-insert the objects after making a change like this in the class,because the interface to the outside world of the class has been modified. PROCESS/FAST cannot automatically convert the old to the new situation.Note: If you have made changes to the class, you always have to compile it. If objects arealready attached then you also have to reset the class after the modification. Resetting the classautomatically resets all linked objects to that class. It is also possible to reset only one object,from the object context menu. Resetting ensures that modifications made to the class takeeffect in the derived objects.

Delete the objects and insert the objects in the table below.Object PV item MV itemSTATION1.COMPRESSOR.SOV_001 SOV-001-PV SOV-001-MV

STATION1.COMPRESSOR.SOV_002 SOV-002-PV SOV-002-MV

STATION1.COMPRESSOR.P_1002 P-1002-PV P-1002-MV

Test all objects to see if they work by changing the value of the MV item.If you didnt succeed in changing the class; heres the code:

CLASS control;

PROLOG

ATTRIBUTE a_status STRING;ATTRIBUTE a_control STRING;

PROMPT a_status QUERY "PV item (status)";PROMPT a_control QUERY "MV item (control)";

SIGNAL s_status := INSTALLATION || "." || UNIT || "." || a_status;SIGNAL s_control := INSTALLATION || "." || UNIT || "." || a_control TRIGGER VALUE;

BODY


METHOD start_timer;ENTRYCONDITION TRGSIG(s_control);

t_runtime := 5;ENDMETHOD start_timer;

METHOD do_action;ENTRYCONDITION TRGTIM(t_runtime);

s_status := s_control;ENDMETHOD do_action;

ENDCLASS control;


30/86


After this, you should be able to add the attribute values like this

Note: It is possible to create items from PROCESS/FAST. This is only possible when templateitems have been defined, to which PROCESS/FAST references.See the example below, or for a more detailed explanation see appendix C.


31/86


{+---------------------------------------------------------------------------

|

| Name : CONTROL

|

| Version : 0.1

|

| Author : Tools|

| Description : Class to simulate valve response + creates items in prolog

|

+---------------------------------------------------------------------------}

CLASS control;

PROLOG

ATTRIBUTE a_status STRING;

ATTRIBUTE a_control STRING;

ATTRIBUTE a_io_address STRING;

ATTRIBUTE a_station STRING;

PROMPT a_status QUERY "PV item (status)";

PROMPT a_control QUERY "MV item (control)";

PROMPT a_io_address QUERY "IO Address";PROMPT a_station QUERY "Station name";

{create pv item and point based on template item and point, and insert item in

'EVENT_BOOL' history group}

SIGNAL s_status STRING := FROM

"SYSTEM.TEMPLATES.BOOLEAN;TEMPLATE_STATION:TEMPLATE_POINT" MAKE

"NAME" EQUAL INSTALLATION || "." || UNIT || "." || a_status

"IO_ADDRESS" EQUAL a_io_address || ".pv"

"STATION" EQUAL a_station

"item'DESCRIPTION" EQUAL a_status || "item"

"HIS_GROUP1" EQUAL "EVENT_BOOL";

{create mv item and point based on template item and point, and insert item in

'EVENT_BOOL' history group}

SIGNAL s_control string := FROM"SYSTEM.TEMPLATES.BOOLEAN;TEMPLATE_STATION:TEMPLATE_POINT" MAKE

"NAME" EQUAL INSTALLATION || "." || UNIT || "." || a_control

"IO_ADDRESS" EQUAL a_io_address || ".MV"

"STATION" EQUAL a_station

"item'DESCRIPTION" EQUAL a_status || "item"

"HIS_GROUP1" EQUAL "EVENT_BOOL"

TRIGGER VALUE;

BODY

{Class to simulate valve response}


METHOD start_timer;

ENTRYCONDITION TRGSIG(s_control);t_runtime := 5;

ENDMETHOD start_timer;

METHOD do_action;

ENTRYCONDITION TRGTIM(t_runtime);

s_status := s_control;


ENDCLASS control;


32/86


When an object is added, the items are automatically inserted based on what is defined in theassociated class. As is visible from this example, properties for the created item can bespecified too, and it is even possible to directly insert items in existing history groups. Thismethod is used often in projects.

5.4 Simulation class

Now create a class that generates some random behavior for the two pressure indicators. Referto the PROCESS/FAST language manual to see how this can be achieved.

Hint: use the built-in function RANDOM and also prompt for an offset and multiplication factor ofthe random number.

After the class is created also insert two instances of the class for the two pressure items.


33/86


6 Historisation

In this exercise well look at how to store historical data.

6.1 History group

Add a history group named SCAN_1_SEC that will be used to store samples at a one secondscan rate.


34/86


6.2 Add items

After inserting the history group we can assign items to the history group. Open theSCAN_1_SEC group to see the Items branch. Add items by clicking on the branch and selectingAdd item. Add both the digital as well as the analogue items created before. (Press F5 forrefresh).

After inserting the items force a Roll-over (right click on the group and select from the contextmenu). Wait a few minutes then open the Operator Interface and use the default trend to seethe result.


35/86


7 Quickload

In this exercise well look at the quickload utility. Quickload is a very powerful way of exporting,importing and modifying configuration data of FAST/TOOLS. The Quickload utility will be startedfrom the command prompt (start windows -> run -> type: cmd ).

7.1 Basic dump functionality

The quickload functionality run from the command prompt is called by the command dssqld.For help use the dssqld , for exampledssqld hTo export a datasetdssqld e -d The location where the generated dump file will be stored is equal to the location where thecommand prompt is running from.

Example, (try)dssqld e my_items d item_df(This command will generate a data dump file containing all items, with the file name:my_items.qli)Inspect the file my_items.qli and see how the data is dumped.

The -d option followed by a dataset name allows you to dump a specific dataset.dssqld e install.qli d install_df

Change the generated qli-file, by adding new station and import it into FT.dssqld i install.qli

Modify file, with the option blocked and visible via OPC (changing the 0 into 1)dssqld m install.qliCheck in the engineering module if the station is blocked and visible for OPC.

It is also possible to delete records by using the r switch.


36/86


7.2 Export specific fields

Using an export file you can describe what to export from which dataset. To dump just nameand description and low limit for instance the file content will be something like this:

(Example export file)

@FIELDS

NAME, DESCRIPTION, LOW_LIMIT

@SELECT

@ITEM_DF

Create an export file that exports only the item name, description and limits of the items (4x).Save the export file as: my_limits_exp.qli (also in the command directory).To run the export file use the following command:dssqld e my_limits my_limits_exp.qli

Inspect the file my_limits and modify the limits.

Now use the modify option of dssqld to change the limits in FAST/TOOLS. The -m flag allowsyou to modify fields.dssqld m my_limits

Inspect the limits in the HMI to check the intended changes.


37/86


8 Reporting

This exercise handles the reporting functionality of FAST/TOOLS.

8.1 Item valuesCreate a simple report that shows the current values of all items.

SELECT name, item_value FROM item_val;

Check Ad-hoc generation

Generate a report and check the result.


38/86


Now modify it so that it writes the data in a comma separated format to a file on the harddrive.

Hint: look for the keywords SPOOL and EXPORT in the REPORT/FAST language manual.

8.2 Item historyCreate a report that gathers historical data for an item. Use variables to get start and end timeand a variable to ask for the item to retrieve. Start by making a report that gets the historicaldata for a fixed item at a fixed interval and build from that.

SELECT sample_time, item_value

FROM item_history

WHERE item_name = STATION1.COMPRESSOR.PT-001;

Hint: look for @P0 in the REPORT/FAST manual.


39/86


9 Graphic editor - basic components

Open from the FAST/TOOLS start menu the Edit Module.In this exercise well start drawing, some basic components like rectangles and circles.

9.1 New display

Start the editor and create a new display called MAIN, if it already exists use the existing one.The size of the display will be set to 1000 x 600 pixels, the grid size is set to 4 by 4.

Positioned right under on the screen

9.2 Pump

Next well be drawing a pump in our newly defined display. Our pump is build from fourelements: two rectangles, a circle and a triangle. Use the polygon to draw the triangle.

Arrange the four elements and combine them into one using the unite option. To unite theelements select them, (by using the SHIFT key) right click and choose the unite option from theshaping menu option.


40/86


After uniting the shapes can connected to the fill paint property of the pump to status colorof thepump status item to animate the color. To do so, select the pump and connect the item to the fillpaint in its property sheet.

Now start the operator interface, log-in using the User credentials and open the display bytyping the name in the display name bar. The fill color of the pump will change when modifyingthe item value of P-1002-PV from the Engineering Module.

Pump running Pump stopped

This demonstrates how easy it is to use the status color for animation. It is veryimportant torealize that not all changes to an item definition are immediately populated. To explain brieflyhow the mechanism works: when you open a display the system subscribes to value and statuschanges for each item used in that display. It does not subscribe to changes in the definition,changing the color definition is such a change. After youve changed the status color for acertain situation this means that the info serverneeds to be restarted. In most cases this meansyoull restart FAST/TOOLS.


41/86


9.3 Text

The status of the pump will be shown using a text component.Add a text component above the pump and connect the value, to the status mnemonic of thepump status item.

The result is shown below.


42/86


9.4 Numbers

The next graphical element well look at is the number component.

Drag and drop a number-field (9) in the Edit Module work field, before pressing enter put some

numbers into it to maintain the visibility of the number field.Connect the value property to the item value attribute of the PT-001 pressure indicator item.The format that is specified in the item definition will be used in the display. Connect the Formatproperty to the item value format attribute of the PT-001 pressure indicator item.

Add a rectangle and place it behind the number component.

Connect the rectangle fill color to the status color of the item.

By connecting the acknowledgment status of the item to the blinking property of the backgroundwere able to indicate the attribute Acknowledged


43/86


Acknowledgement needs to be inverted using a threshold table.

Open the display, modify the value from the item in the operator interface and see how the colorchanges when the status changes. The default colors from the item status table are used for thedifferent alarm statuses.

Now change the behavior a little by setting a blinking color. (Blinking paint property)

Notice the difference in appearance: the border also disappears when a blinking paint is not set.With the blinking color is set it will blink between this paint and the fill color (blinking paintproperty).


44/86


10 Complex components

In the next paragraph, the complex components will be explained.

10.1 Buttons

To animate the pump from the graphic add two push buttons.

Add two buttons to the display from the previous exercise (Main) and connect them to the pumpcontrol item. The Start button will set the control item to 1, the Stop will set the item to 0.

To have the button set a value, add an action that sets the item to 1(start) or 0(stop). Click on

the button, then add an action in the Actions sheet.

The details of the action are shown in the Action sheet.


45/86


Open the display again, the buttons will allow you to animate the pump now.

Clicking the start button will set MV to 1, this triggers the class to set the status to 1, whatresults in a color change into green.

10.2 Slider

Add a slider and connect its value to the item used by the indicator. The range of the slider is 0to 100, set the slider to track drags for following the slider value.

Open the display again in the operator interface and move the slider.


46/86


11 Parameters

In this exercise were going to look at the use of parameters.

11.1 Local parameter

Create a local parameter named Level of the Type Number.

Draw a rectangle; connect its fill amount to the parameter Level.Modify the fill direction to upwards and put the transformation on linear.

Then add a slider and connect the value property to the level parameter.The range of the slider is set from 0 to 1. Then reopen the display again to test the result.


47/86


This means animations can be done without use of any items.

Note that parameters that are used get marked in the used column. Right click on theparameter and select Usage to reveal where parameters are used.

Click on one of the usage results to highlight the component in the display where theparameter is actually used.


48/86


11.2 Functions

In this exercise well focus on the function component. Add a function by drag and drop the f(x)sign from the toolbarinto the edit module work sheet. Set the function to the type Stepper andconnect its result to the Level parameter. Make it step from 0 to 1 in 5 seconds and 1 to 0 in 10seconds. (number input properties).

Now re-open the display and watch the level go up and down by it self. Animations like this canbe enabled/disabled easily because all functions have an enable property that can be controlledusing a Boolean value.

The trigger input of the functions is used to reset the function.


49/86


12 Layers

In this exercise we will focus on layers and what you can do with it.

12.1 Zooming

We will add some text which will be visible starting from a certain zoom level.Add a layer to the display called Info. Rename the existing layer to Display

Select this new layer and add some text using a small font to the pump.

Then change the visibility group of the Info layer to detail.

The text will now disappear and only appear again when you zoom in ( zoom in a lot).Note: In the visibility group sheet you can see details of the visibility group and what the zoompercentages are.


50/86


12.2 Toggle layers

Add a layer called Background, then right click on the entry and using the context menu sendthe layer to the back.

The layer will now be the first in the list indicating that it is the bottom layer.

Now draw a rectangle and choose a pattern as fill color.

Notice that as you draw the rectangle it is now automatically placed behind the othercomponents.

Add a toggle button in the layer called Display(!) that will be used to switch the visibility of thelayer on and off. Add a local parameter called ToggleBackground and connect it to the valueproperty of the button.


51/86


Connect the parameter also to visibility to the layer.

Now reopen the display to test it.

Instead of using a pattern you could of course also use for instance a technical drawing of thefacility. The layers functionality opens up many possibilities.


52/86


13 Layouts

This exercise is a small excursion into xml land. Well look at the layouts file and change someproperties.

13.1 Layouts file

Navigate to the layouts file, it is located in the install path of FAST/TOOLS in the followingfolder:

(Win7, Server2008) %tls_root_path%\Users\Public\Yokogawa\tls\wap\cfg\operatorInterfaces\DEPLOY\layouts.xml(For Win_XP) \program files\yokogawa\FAST TOOLS\tls\wap\cfg\operatorInterfaces\DEPLOY\layouts\Layouts.xml

Open the layouts file with an xml editor e.g. notepad++ and search for the popup layout.

Check that the value of the keyword closingAllowed is set to true, this will enable you to closethe popup using the close button of the windows frame.Also change maximumOpen to 2 alllowing only two popup of this type to be open at all times.

The result will be used in one of the upcoming exercises.


53/86


14 Localization

In this exercise we will look at localization and add some translations to the configuration.

14.1 Add language

The configuration of localization is accessed thru the tools menu in the Edit Module.

Create a new language by selecting one from the Add locale combo box and then click on theAdd button next to it.

Note that the translations are case sensitive!

If your native language is English you can either add another language that you speak or usethe Dutch example. After adding the locale a column will appear with the abbreviation for thatlanguage. Now add translations for the words in the following table in your language. Note thatChinese and Japanese character sets are supported.

English Dutch

Start AanStop Uit

RUN LOOPT

STOP GESTOPTOPEN OPEN

CLOSE DICHT


54/86


Enter the English word in the Add Text field and then click the Add button next to it.

To add the translation in the second column (nl), double click in the right column.After entering the translations it should look something like the previous screenshot.

14.2 User definition

Next we need to change the language for our user in the Engineering Module. Set theabbreviation of the language you added in the appropriate field Locale (in the example this is nlfor Dutch).

Now restart the operator interface and log on as user and see the result.

The translation of all menu options is configured in the Layouts file (last part of the file).

The localization feature makes it very easy to have a multi lingual operator interface where eachoperator can have its own preferred language.


55/86


15 Symbols part 1

In this section we will look at dynamic symbols and create a valve that is connected to ourcontrol class. Also a popup will be added to the valve to control it.

15.1 Valve

In this exercise we will create a valve that is animated using the status change of the valve.

Add a new symbol named ShutdownValve and select the class CONTROL to establishconnection with it.

Then set the grid size to 4 by 4 pixels.

Now draw a Shutdown Valve using a polygon and connect its Fill Paint to the status signalsstatus color. It is good practice to align the symbol always in the center-cross of the symbol

display.

Notice that the tab items are disabled and Signals are available now that the control class isassigned to the symbol.


56/86


Then connect the item value to the rotation of the valve and use a linear transformation to rotatethe valve.

The result of this transformation will be that the valve is rotated 90 degrees vertical when it is

closed and horizontal when it is open.

Letting the valve blink in case of an unacknowledged alarm can be achieved by connecting theAcknowledged property to the Blinking property of the valve. The value needs to be invertedusing a threshold because the valve should blink when Acknowledged is False.

Now go back to the (main) display and insert the symbol twice and connect to each one anObject (SOV_001 and SOV_002).


57/86


Note: The Object is connected to the Valueof the property, not the Connected to entry point.

Open the display and animate the status from the Engineering Module.

One open and one closed valve

15.2 Popup

To control the valves well add a popup. Create in the Edit Module a new display namedShutdownValve with size 200 x 120 and change the grid size to 4 by 4.


58/86


Add an external parameter ControlObject of the type PROCESS/FAST Object with class nameCONTROL.

This allows for connection to all the signals in the object directly, there is no need to passindividual parameters.

Now add two push buttons (Open and Close) and add an action to them to set the value ofsignal s_control. Open will set the value to 1, close will set it to 0.


59/86


Note that the connection dialog shows signal names from the ControlObject parameter.

Add a status text to show the current status.


60/86


Connect the title of the popup display to the tag name of the status signal in the object. Click onthe canvas to get to the properties of the display.

The display title will now dynamically change depending on what valve is selected.Before you can try to open this control popup, a link with the valve symbol needs to be made.

15.3 Add to symbol

To combine the popup with the valve symbol well need to add a touch surface to the valvesymbol.

Open the valve symbol and draw a rectangle on top of the valve. Adjust the transparency of theFill Paint Property to 1 to make it invisible.

Valve with 100% transparent area


61/86


Add an Open display action to the generated invisible layer.

Note that after selecting the display ShutdownValve to open a list of parameters to pass willappear with the external parameter. Select the Ref checkbox and then reference to theparameter attachedObject that is predefined in the symbol. This parameter automatically getsits dynamic information from the object linked to the symbol that is calling the popup. All signalsof the class are now available in the popup.

After these types of changes the main display needs to be validated again.During validation the system checks and updates the dynamic links to the FAST/TOOLSdatabase (e.g. items, objects, etc.) To validate the display go to the menu Tools and selectValidate display. Run the display to see the result. Also on each save of a display, the displayis automatically validated.Note that only two popups can be opened at once, as this property has been set to 2 in theLayouts file (Chapter 13).


62/86


Valve with opened control popup

15.4 Tag name

Now we will add a tag name to a symbol, for instance to show this information to an operator.

The visibility function (also named de-clutter) makes the tags visible or invisible on the display.

Add a text in the ShutdownValve symbol and connect the tag of the status signal to it.

Add an additional global parameter called Information (type Boolean) that will be used tohide/show the tag info.


63/86


Connect the parameter to the visibility of the text component.

In the main display we will add a Toggle button that toggles the parameter Information.This Information parameter must be created both in the ShutdownValve symbol as well as in the(Main) display.

Note: Global parameters must be created on each display and symbol individually where theyare used.

Save the display again and reopen it to see the result.

The tag name can now be shown and hidden by pushing the Information button.


64/86


16 Symbols part 2

In this exercise we will create a dynamic symbol without using PROCESS/FAST. This powerfulfeature of FAST/TOOLS allows you to build even better typicals. The pump that we made beforewill be transformed into a symbol with control popup.

16.1 New symbol

Create a new symbol called MyPump (leave the PROCESS/FAST Class field empty). Dontforget to set the grid size to 4 again. First well add two parameters, accessible externally, of thetype Itemcalled PV and MV (measured value). Note that they should be of item type Any.

Now copy the pump from the display we made and paste it into MyPump symbol, after that

delete the connections with the pump status item. Click on the symbol, from the symbolproperties select the connected items and click on the trash basket to delete the connections.


65/86


The fill paint will be connected to the Item parameter PV.Connect the Status color attribute of the parameter PV to the Fill Paint.

16.2 Modify display

Go back to the main display; Replace the pump symbol with the newly created symbol. It willhave Custom properties PV and MV.

Click on the value column of the PV and MV properties to connect them to the pump items.This will make the pump dynamic again.


66/86


Now reopen the display again to test the correct functioning.


67/86


16.3 Popup

To demonstrate how generic we can solve problems we will now create a popup to control thepump.

Add a display called ControlPopup with size 120 x 200. Place two (push) buttons on it forStart/Stop function. We will label them On and Off and change the label dynamically usingexternal parameters.

Add the following parameters.

Name Description Type Access Allowed item type

PV Process variable Item Externally Any

MV Output Item Externally Any

LabelOn Label for On button Text Externally -LabelOff Label for Off button Text Externally -

Then connect the MV parameter to the On and Off buttons like we did in the popup for the

valve. On action it should set the value to 1 (On button) or 0 (Off button).


68/86


Then well connect the button labels to the parameters LabelOn and LabelOff.

Add a text component and connect it to the status text of the PV parameter.

16.4 Add to symbol

Like with the valve were opening the popup using a transparent touch surface to the symbol.Add a touch surface to the pump symbol and add action to open the popup ControlPopup.

The Parameters to pass need to be linked, note that we can now enter whatever text we likefor the On and Off button. For a valve this would be Open/Close, for a controller it could beAuto/Manual.


69/86


After re-validation of the display you should be able to activate the popup.

16.5 Exclusive control

To give an operator exclusive control over a device we can use the locking mechanism. To dothis we need to set the locking-bit when opening the popup and reset it when close it.

Add actions to the open event and close event that will set the locking of the MV and reset thelocking. Also add an event that will close the popup when the locking bit turns zero. A timer onthe locking-bit will automatically reset it after a predefined period. (Default 60sec)

Click on the canvas to add the actions to the ControlPopup display. The entry action sets thevalue of the attribute Lockedto 1.


70/86


Add a second Action for the exit action as follows:Event: On exit, update item/parameter, Applies to: MV/, into parameter: MV, Attribute: locked,Value or parameter: 0, Function: none.

The attributes of an item parameter can not be used for a display action; this means well need

to copy the locked value to a local parameter. Create (in the ControlPopup display) a localparameter of the type Boolean named LockedBit.

Connect the value of the parameter LockedBit to the Locked attribute of parameter MV andmake sure the direction is correct: the MV should write into the LockedBit value.

Now add an Event to close the display when LockedBit is zero. (in ControlPopup screen).


71/86


Go to the pump symbolTo indicate the locking and disable its selection by other users we will need to add a transparentsurface on top of the selection area.

Add a layer called selected to the symbol and draw a rectangle in it to cover the pump. Theedge should get a green color (Stroke paint); the fill should be transparent (change thetransparency of the fill color not the overall transparency).

The tooltip text of the rectangle can be connected to the locked user attribute of MV to showwho is controlling the pump.


72/86


Connect the visibility of the rectangle to the locked attribute of parameter MV.Now revalidate the display again and reopen it to test the added functionality. Also try whathappens if you leave the popup open. It should close after approximately one minute (defaulttimeout).


73/86


Appendix A: Adding equipment

Setting up a connection to (new) field equipment e.g. Stardom, ProSafeRS from FAST/TOOLSis done under I/O Processing in the Engineering Module.This appendix will explain how to add a Stardom station inclusive I/O points. The procedure issimilar for other equipment.

Note: Only a subset of Equipment drivers are installed during the standard installation. Duringinstallation (under custom) it is possible to specify which equipment drivers must be installed.

Choose the type of Station you want to add, in this example a STARDOM Station.First define a line. The equipment process name will propose a default name, it is ok to use this.


74/86


Note: For each line a separate equipment process and setup file is created.Line specific settings will be configured from the Setup file, like queues size, update interval, up-down logging etc. If a second line is created the equipment process name must be unique.

Next add a station, under Line choose the line just created

The IP address can either be specified in the line or station definition. The station IP addressoverrules the line IP address.


75/86


76/86


For STARDOM equipment the list of available I/O points can be found in the ADLST file, locatedin the Logic Designer project folder. An example is found below, an example of an I/O addressis: Main.TT106.AOFS. or Main.sine.

Once a point has been added it can be linked to an item, via the Equipment tab of an item.

Remark: If you make a change in the equipment tab of the item definition or in the pointdefinition itself, on both sides it will be updated (e.g. I/O Address).


77/86


Appendix B: Adding an OPC-DA station.

This appendix will show how to add an OPC-DA station. As example a connection to MatrikonOPC simulation software is taken.

Add a line under OPC DA Client

Add a station, select the newly added line and configure the correct OPC node (in this case thepc where you working on)

Add a group, set the deadband to 0 (this value is in percentage and can reduce the networkload). The specific group will be updated when the value change is larger than the specifieddeadband.


78/86


Add a point

Connect an analog OPC tag to it. To see the incoming value, connect this point to aFAST/TOOLS item.

The Matrikon software will automatically run on the background, at the Matrikon side noconfiguration is required.


79/86


Appendix C: Using signal make structure in PROCESS/FAST.

In PROCESS/FAST it is possible to program a class such that it creates items & pointsautomatically when an object is inserted based on template items and template points. Thisappendix explains what configuration is required.

{+------------------------------------------------------------------------------------------------------| | Name : CONTROL|| Version : 0.1|| Author : Tools|| Description : Class to simulate valve response + creates items in prolog| +-----------------------------------------------------------------------------------------------------}

CLASS control;PROLOG

ATTRIBUTE a_status STRING; {Attributes are external variables to a class, and will assigned by an object}ATTRIBUTE a_control STRING;ATTRIBUTE a_io_address STRING;ATTRIBUTE a_station STRING;

PROMPT a_status QUERY "PV item (status)";PROMPT a_control QUERY "MV item (control)";PROMPT a_io_address QUERY "IO Address";PROMPT a_station QUERY "Station name";

{create pv item and point based on template item and point, and insert item in 'EVENT_BOOL' history group}SIGNAL s_status STRING := FROM "SYSTEM.TEMPLATES.BOOLEAN;TEMPLATE_STATION:TEMPLATE_POINT" MAKE

"NAME" EQUAL INSTALLATION || "." || UNIT || "." || a_status"IO_ADDRESS" EQUAL a_io_address || ".pv""STATION" EQUAL a_station"item'DESCRIPTION" EQUAL a_status || "item""HIS_GROUP1" EQUAL "EVENT_BOOL";

{create mv item and point based on template item and point, and insert item in 'EVENT_BOOL' history group}

SIGNAL s_control string := FROM "SYSTEM.TEMPLATES.BOOLEAN;TEMPLATE_STATION:TEMPLATE_POINT" MAKE"NAME" EQUAL INSTALLATION || "." || UNIT || "." || a_control"IO_ADDRESS" EQUAL a_io_address || ".MV""STATION" EQUAL a_station"item'DESCRIPTION" EQUAL a_status || "item""HIS_GROUP1" EQUAL "EVENT_BOOL"TRIGGER VALUE;

BODY

{Class to simulate valve response}TIMER t_runtime TRIGGER;

METHOD start_timer;ENTRYCONDITION TRGSIG(s_control);t_runtime := 5;

ENDMETHOD start_timer;

METHOD do_action;ENTRYCONDITION TRGTIM(t_runtime);s_status := s_control;



80/86


After updating the class according the example above, the following points must be in place.Add under Equipment, Stardom-FCX a template line, add template station, and template point,according to the specified names used in the class.


81/86


Add a template item that matches the used name in the class:

Connect the template item to the template point.

Configure the template item for example alarming properties. These properties are inherited bythe items created from the class.


82/86


Add a Historisation group with corresponding name used in the class.

The class can only create items and points, it cannot create a line and a station. In order to addpoints to a station this means the line and the station must be defined before the object isadded.


83/86


Once this is done, add an object to test the class.

After the object is added the following will be generated:The items SOV-004-PV and SOV-004-MV including alarm settings are added under the(installation) station1, (unit) compressor.Also the items SOV-004-PV and SOV-004-MV are added under historisation item storagegroups.Under the STARDOM station the points will be added.


84/86


Appendix D: Recording and playback functionality.

With Playback functionality all Operator actions can be recorded. In case of an escalation orincident the recorded actions of the operator can played back, actions like alarmacknowledgements, mouse movements and mouse clicks etc.

Playback functionality (both recording and playback) can be accessed from the menu in theEngineering Module, Graphical Editor and the Operator interface.

However it is also possible to add this functionality in a display, from the display it is thenpossible to start and stop recording and to playback what has been recorded.This appendix gives an example why this can be useful: the time line of the playback player willbe linked to the alarm time in an alarm banner. This makes it possible to click on an alarm, andview in the Playback player what actions have been taken around this alarm time.Similar functionality can also be added to a trend (linking trend time axis).

To create this functionality the following needs to be done.Make a new Display called playback, and insert the playback indicator component.

Insert the following parameters

These parameters will be used later on to connect for instance the time that an alarm occurswith the corresponding recorded moment.

Name Description Type Access

Playtime Current playback time Number Locally

Recording Recording activation Boolean LocallyViewer Playback activation Boolean Locally


85/86


Select the playback symbol and connect the parameters Playtime, Recording and Viewer to theplayback component.

Insert a toggle button, and connect the value to the recording parameter. This will start / stop therecording.

Insert an alarm overview.


86/86

Connect the Playtime parameter to Selected Alarm Time.

Finally check if the playback functionality works as expected.

Record some events, which include alarms. Then start the Playback player, while having thePlayback display open.Try the synchronization by clicking on an alarm event and see if the viewer time lines up.

Tip: Put the operator interface and the playback viewer next to each other on the screen.

exercises ft904 sm rev2.2

Documents