metsoDNA CR
FbCAD Manual Secured Life Cycle Collection 2010 rev. 4 G2010_EN_04
ii
FbCAD Manual
Metso Automation Inc. reserves the right to make changes in information contained in this publication without prior notice, and the customer should in all cases consult Metso Automation Inc. to determine whether any such changes have been made. This publication may not be reproduced and is intended for the exclusive use of Metso Automation Inc.’s customer. The terms and conditions governing the sale of hardware products and the licensing and use of software products manufactured/delivered by Metso Automation Inc. consist solely of those set forth in the written contract between the Metso Automation Inc. and its customer. No statement contained in this publication, including statements regarding capacity, suitability for use, or performance of products, shall be considered a warranty for any purpose nor shall it be considered part of the contract or give rise to any liability of Metso Automation Inc. In no event will Metso Automation Inc. be liable for any damages, including but not limited to incidental, indirect, special, or consequential damages (including lost profits), arising out of or relating to this publication or the information contained in it, even if Metso Automation Inc. has been advised, knew, or should have known of the possibility of such damages. Software The content of the software described in the documentation (“Metso software”) is subject to the copyright of Metso Automation Inc. and/or its licensors. Metso software is subject to Metso Automation Inc.’s license agreement. Metso Automation Inc. prohibits the use of this software unless you have valid license agreement with Metso Automation Inc. By taking Metso software into use, you signify your acceptance of the said license agreement. Metso software may include certain open source or other software originated from third parties subject to the GNU General Public License (GPL), GNU Library/Lesser General Public License (LGPL) and other additional copyright licenses, disclaimers and notices. The exact terms of GPL, LGPL and certain other licenses are provided to you with Metso software. Please refer to the exact terms of the GPL, LGPL and other licenses regarding your rights under said licenses. Metso Automation Inc. will provide copies of certain open source software to you on a CD−ROM for a fee covering the costs of such distribution (media, shipping and handling) upon a written request to Metso Automation Inc.’s address below or email address
[email protected] (Subject: Source code requests). This offer is valid for a period of 3 years from the date of distribution of Metso software by Metso Automation Inc. In accordance with the provisions of the public licenses, all contributors (as defined in the public licenses), with respect to the open source software, hereby DISCLAIM (i) ALL WARRANTIES AND CONDITIONS, express and implied, including warranties or conditions of title and non−infringement, and implied warranties or conditions of MERCHANTABILITY and FITNESS FOR A PARTICULAR PURPOSE, and (ii) all liability for damages, including direct, indirect, special, incidental and consequential damages, such as lost profits. You hereby accept and agree to the foregoing disclaimers.
Metso Automation Inc., 1988 − 2010. All rights reserved. Printed in Finland.
ACAD®, AutoCAD®, Autodesk®, AutoLISP® and DXF® are registered trademarks of Autodesk Inc. Ethernet® is a registered trademark of Xerox Corporation. Microsoft®, Windows® and Windows Server® are registered trademarks of Microsoft Corporation in the United States and/or other countries.
Metso Automation Inc., P.O. Box 237, FIN−33101 Tampere, Finland Tel. +358 20 483 170, Telefax +358 20 483 171
Collection 2010 rev. 4
metsoDNA CR
iii
DOCUMENT HISTORY DATE
REVISION
COMMENT
2007−05−08
1
metsoDNA CR Collection 2007, FbCAD V.15.1 This document is based on the metsoDNA document FbCAD Engineering Tool V.14.1 rev. 10B (G0019110) − added the I/O menu to the menu bar − modified the Modules menu (part of commands are shifted to the I/O menu) − modified the names of the loading commands (File−Download Real and File−Download Virtual) − added the Eedit command to the menu bar (Edit−Edit−Eedit) and the screen menu − modified terms to correspond with metsoDNA CR
2008−05−26
2
metsoDNA CR Collection 2008, FbCAD V.16.1 − added the Erase Dot command to the menu bar (Edit−Erase Dot) and the screen menu − added the Edit prog2 command to the menu bar (Edit−Program−Edit prog2) and the screen menu − added new commands to the menu bar’s Draw menu and to the screen menu: Scalar autocolor wire, Reroute, Autowire, Dot ON/OFF and Table autocolor wire − replaced the Dot command with the Insert Dot command (Draw−>Insert Dot) − added the prog2 function block to the Fblock3 menu − added the History2 command to the menu bar (Modules−History2) and the screen menu added the tag functions pro2 and pr2sc (Modules−>Position...) − replaced the MIO command with the MIO M80 command (I/O−>MIO M80)
2009−05−19
3
metsoDNA CR Collection 2009, FbCAD V.17.1 − added the MIO M120 command to the menu bar (I/O−>MIO M120) and the screen menu − modified the function of the Eedit command (Edit−Edit−Eedit) − updated commands File−>Open and File−>Delete with sections related to protected engineering objects − updated the chapter Configuration of Tables − replaced pictures and attributes in Finnish with English ones because FbCAD is available only in English
2010−09−21
4
metsoDNA CR Collection 2010, FbCAD V.18.1 − added new position functions (Modules−>Position...) − added new history symbols (Modules−>History2) − updated the dialogs of position functions and history tags in the chapter Dialogs for Configuration Functions
Collection 2010 rev. 4
iv
FbCAD Manual
Collection 2010 rev. 4
metsoDNA CR
v
CONTENTS
1
GENERAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1
1.1
SOME CONCEPTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1
1.2
DIALOGS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4
1.2.1
Dialog components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4
1.2.2
Using the dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5
ENTERING COMMANDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5
1.3.1
Using the mouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5
1.3.2
Using the keyboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5
1.3.3
Repeating (echoing) the previous command . . . . . . . . . . . . . . . .
6
1.3.4
Using the menus and their differences . . . . . . . . . . . . . . . . . . . .
7
SELECTING OBJECTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7
2
SETTINGS FOR THE ENGINEERING ENVIRONMENT . . . . . . . . . . . . . . .
9
3
STARTING THE ENGINEERING TOOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10
3.1
STARTING FROM THE START MENU . . . . . . . . . . . . . . . . . . . . . . . .
10
3.2
STARTING WITH THE DNAEXPLORER . . . . . . . . . . . . . . . . . . . . . . .
10
4
BASICS OF FBCAD ENGINEERING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
11
5
FBCAD FUNCTION BLOCK DIAGRAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
14
5.1
DRAWING LAYERS AND PAGING . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15
5.2
MOUSE CURSOR COORDINATES . . . . . . . . . . . . . . . . . . . . . . . . . . . .
16
5.3
SCREEN MENU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
16
5.4
COMMAND LINE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
17
5.5
ADMINISTRATION PART OF THE FUNCTION BLOCK DIAGRAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
17
5.5.1
Entering data into customer field . . . . . . . . . . . . . . . . . . . . . . . .
18
5.6
CONNECTION AREA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
19
5.7
CONNECTION AREA FOR EXTERNAL INPUTS . . . . . . . . . . . . . . . .
19
5.8
CONNECTION AREA FOR EXTERNAL OUTPUTS . . . . . . . . . . . . .
19
5.9
CONTINUOUS CONTROL ADMINISTRATION PART . . . . . . . . . . .
19
5.10
EXTENSION PART OF THE CONTINUOUS CONTROL ADMINISTRATION PART . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
19
OTHER CONFIGURATION FUNCTIONS RELATED TO THE FUNCTION BLOCK DIAGRAM . . . . . . . . . . . . . . . . . . . . . . . . . .
19
1.3
1.4
5.11
Collection 2010 rev. 4
vi
FbCAD Manual
6
ICON MENU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
20
7
MENU BAR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
21
7.1
FILE − FILE MANAGING COMMANDS . . . . . . . . . . . . . . . . . . . . . . .
23
7.1.1
New − Creating a new function block diagram . . . . . . . . . . . . .
23
7.1.2
Open... − Opening the function block diagram . . . . . . . . . . . . .
24
7.1.3
Navigate... − Examining external connections . . . . . . . . . . . . . .
28
7.1.4
Download Real... − The modular loading of function block diagram’s configuration functions to real runtime environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
29
Download Virtual... − The modular loading of function block diagram’s configuration functions to virtual runtime environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30
7.1.6
Save As... − Saving the function block diagram . . . . . . . . . . . . .
31
7.1.7
Check... − Checking the function block diagram . . . . . . . . . . . .
33
7.1.8
Delete... − Deleting a function block diagram . . . . . . . . . . . . . . .
34
7.1.9
Print... − Printing the function block diagram . . . . . . . . . . . . . .
35
7.1.10 Print param − Printing the parameters . . . . . . . . . . . . . . . . . . .
37
7.1.11 Print links − Printing the synchronize links of parameters . . .
37
7.1.12 Print Setup... − Changing the printer settings . . . . . . . . . . . . . .
38
7.1.13 Test... − Accessing to the graphic testing tool . . . . . . . . . . . . . . .
38
7.1.14 Exit FbCAD − Exiting the engineering tool . . . . . . . . . . . . . . . .
39
EDIT − FUNCTION BLOCK DIAGRAM EDITING COMMANDS . .
40
7.2.1
Undo − Undo one or more previous commands . . . . . . . . . . . . .
40
7.2.2
Redo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
41
7.2.3
Values − Entering and editing the attributes of symbols . . . . . .
41
7.2.4
Design Members – Editing design member values . . . . . . . . . . .
43
7.2.5
Formulas – Access to Formulas submenu . . . . . . . . . . . . . . . . . .
44
7.2.6
Change − Changing values and properties . . . . . . . . . . . . . . . . .
44
7.2.7
Edit − Access to Edit submenu . . . . . . . . . . . . . . . . . . . . . . . . . . .
45
7.2.8
Copy − Access to Copy submenu . . . . . . . . . . . . . . . . . . . . . . . . .
45
7.2.9
Move − Moving objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
45
7.2.10 Paste from clipboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
45
7.2.11 Erase − Erasing objects from the function block diagram . . . .
46
7.2.12 Erase Dot − Erasing connection dots . . . . . . . . . . . . . . . . . . . . . .
46
7.2.13 Stretch − Moving objects with their connections . . . . . . . . . . . .
46
7.1.5
7.2
Collection 2010 rev. 4
metsoDNA CR
7.3
7.2.14 Polyedit − Editing connection lines . . . . . . . . . . . . . . . . . . . . . . .
47
7.2.15 Insert arrow − Inserting an arrowhead in a connection line . . .
52
7.2.16 Delete arrow − Deleting arrowheads from a connection line . .
52
7.2.17 Macro − Access to Macro submenu . . . . . . . . . . . . . . . . . . . . . . .
52
7.2.18 Program − Access to Program submenu . . . . . . . . . . . . . . . . . . .
52
7.2.19 Comment symbol − Access to Comment symbol submenu . . . .
53
7.2.20 Page − Access to Page submenu . . . . . . . . . . . . . . . . . . . . . . . . . .
53
7.2.21 Purge − Purging the picture database . . . . . . . . . . . . . . . . . . . . .
53
7.2.22 Show Object by Handle – Displaying an object related to an error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
53
7.2.23 Cross References − Access to Cross References submenu . . . . .
53
EDIT−>FORMULAS – FORMULA EDITING COMMANDS . . . . . . .
54
7.3.1
7.4
7.5
vii
Create/Edit Design Member definitions – Creating and editing design members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
54
7.3.2
Edit Formulas –Editing formulas . . . . . . . . . . . . . . . . . . . . . . . .
56
7.3.3
Attach/Edit Formula – Attaching and editing formulas . . . . . .
57
7.3.4
FWizard – Replacing an attribute value with a formula . . . . .
58
7.3.5
Initialize – Initializing formulas . . . . . . . . . . . . . . . . . . . . . . . . . .
58
7.3.6
Show Design Member Usage – Displaying the objects attached to a design member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
59
EDIT−>EDIT − SYMBOL’S EDITING COMMANDS . . . . . . . . . . . . . .
60
7.4.1
Gedit − Changing attributes globally . . . . . . . . . . . . . . . . . . . . .
60
7.4.2
Sedit − Changing attributes of selected blocks . . . . . . . . . . . . . .
60
7.4.3
Aedit − Changing single symbol attributes . . . . . . . . . . . . . . . . .
61
7.4.4
Fedit – Editing formulas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
62
7.4.5
Tedit – Editing several texts at the same time . . . . . . . . . . . . . .
62
7.4.6
Eedit – Editing attribute values in Excel . . . . . . . . . . . . . . . . . .
63
7.4.7
Renum − Renumbering function blocks . . . . . . . . . . . . . . . . . . .
64
7.4.8
ChBlk − Changing of symbols . . . . . . . . . . . . . . . . . . . . . . . . . . .
64
7.4.9
UpdBlk − Updating of symbols . . . . . . . . . . . . . . . . . . . . . . . . . . .
65
7.4.10 Edit text – Editing texts one at a time . . . . . . . . . . . . . . . . . . . . .
65
EDIT −> COPY − COPYING COMMANDS . . . . . . . . . . . . . . . . . . . . . .
66
7.5.1
Copy Symbol − Copying function block diagram parts . . . . . . .
66
7.5.2
Copy to clipboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
66
7.5.3
Copy Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
66
Collection 2010 rev. 4
viii
FbCAD Manual
7.6
7.7
EDIT −> MACRO − MACRO COMMANDS . . . . . . . . . . . . . . . . . . . . .
67
7.6.1
Make − Creating a macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
67
7.6.2
Insert − Inserting a macro in the function block diagram . . . .
68
7.6.3
Delete − Deleting a macro from the directory . . . . . . . . . . . . . .
69
EDIT −> PROGRAM − HANDLING COMMANDS OF PROGC AND PROG2 FUNCTION BLOCKS’ PROGRAMS . . . . . . . . . . . . . . . . . . . . 70 7.7.1
Attach program − copying the program written in list form to the progc or prog2 function block . . . . . . . . . . . . . . . . . . . . . .
70
Edit program − editing the list form program of the progc or prog2 function block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
71
Delete program − deleting the program written in list form from the progc or prog2 function block . . . . . . . . . . . . . . . . . . .
71
Edit prog2 − editing the symbol of the prog2 function block . .
71
EDIT −> COMMENT SYMBOL − COMMENT COMMANDS . . . . . .
72
7.8.1
Make − Creating symbol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
72
7.8.2
Insert − Inserting comment symbol . . . . . . . . . . . . . . . . . . . . . . .
72
7.8.3
Delete − Deleting the comment symbol . . . . . . . . . . . . . . . . . . . .
73
EDIT −> PAGE − PAGE HANDLING COMMANDS . . . . . . . . . . . . . .
74
7.9.1
Create − Creating new pages . . . . . . . . . . . . . . . . . . . . . . . . . . . .
74
7.9.2
Copy Item To − Copying objects to another page . . . . . . . . . . .
74
7.9.3
Move Item To − Moving objects to another page . . . . . . . . . . . .
75
7.9.4
Delete − Deleting a page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
75
7.9.5
Verify − Verifying the location of symbols . . . . . . . . . . . . . . . . .
75
7.9.6
Freeze − Freezing the pages not currently displayed . . . . . . . . .
75
EDIT −> CROSS REFERENCES − CROSS REFERENCE COMMANDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
76
7.10.1 Insert Anchor Up − Inserting an anchor (output upwards from a point) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
76
7.7.2 7.7.3 7.7.4 7.8
7.9
7.10
7.10.2 Insert Anchor Down − Inserting an anchor (output downwards from a point) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 7.10.3 Show Anchors − Showing anchors . . . . . . . . . . . . . . . . . . . . . . . .
77
7.10.4 Get References− Generating a cross reference list . . . . . . . . . . .
77
7.10.5 Make query − Making own query . . . . . . . . . . . . . . . . . . . . . . . .
79
7.10.6 List References− Printing the cross reference lists . . . . . . . . . . .
79
Collection 2010 rev. 4
metsoDNA CR
7.11
ix
VIEW − DISPLAY HANDLING COMMANDS . . . . . . . . . . . . . . . . . . .
80
7.11.1 Redraw − Redrawing the function block diagram . . . . . . . . . . .
80
7.11.2 Redraw All − Redrawing all windows . . . . . . . . . . . . . . . . . . . .
80
7.11.3 Regen − Redrawing the function block diagram . . . . . . . . . . . .
80
7.11.4 Zoom Window − Zooming the contents of a window . . . . . . . . .
81
7.11.5 Zoom Dynamic − Dynamic zooming . . . . . . . . . . . . . . . . . . . . . .
81
7.11.6 Zoom Previous − Redisplaying the previous view . . . . . . . . . . .
81
7.11.7 Zoom All − Zooming out to the whole function block diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
81
7.11.8 Zoom Extents − Zooming out to full function block diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
81
7.11.9 Pan − Scrolling the function block diagram . . . . . . . . . . . . . . . .
81
7.11.10 Previous Page – Selecting the previous page . . . . . . . . . . . . . . .
82
7.11.11 Select Page − Selecting the active page . . . . . . . . . . . . . . . . . . . .
82
7.11.12 Next Page – Selecting the next page . . . . . . . . . . . . . . . . . . . . . .
82
7.11.13 Show error list − Listing of error messages . . . . . . . . . . . . . . . .
82
7.11.14 Errors on/off − Showing/hiding the error messages . . . . . . . . . .
82
7.11.15 Comments on/off − Showing/hiding the comments layer . . . . .
82
7.11.16 Function Formulas on/off – displaying or hiding objects hidden using a function formula . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
7.12
7.11.17 Cross References on/off − ’Crossref’ drawing layer on/off . . . .
83
7.11.18 Text window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
83
DRAW − DRAWING COMMANDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
84
7.12.1 Scalar autocolor wire − Drawing the scalar connection lines by using the autocolor function . . . . . . . . . . . . . . . . . . . . . . . . . .
84
7.12.2 Scalar wires − Drawing the scalar connection lines . . . . . . . . . .
84
7.12.3 Reroute − rerouting of a connection line . . . . . . . . . . . . . . . . . . .
85
7.12.4 Autowire − Drawing a scalar connection line by using the automatic functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
85
7.12.5 Arrow ON/OFF − Arrowhead drawing control . . . . . . . . . . . . .
86
7.12.6 Dot ON/OFF − Connection dot drawing control . . . . . . . . . . . .
86
7.12.7 Insert Dot − Drawing a connection dot . . . . . . . . . . . . . . . . . . . .
87
7.12.8 specifier :spe_| | − Connection dot specifier to the left . . . . . . . .
89
7.12.9 specifier | |_:spe − Connection dot specifier to the right . . . . . .
90
7.12.10 Add reference... − adding a reference point . . . . . . . . . . . . . . . .
91
7.12.11 Show references – Displaying reference points . . . . . . . . . . . . . .
92
7.12.12 Table autocolor wire − Drawing the table type connection lines by using the autocolor function . . . . . . . . . . . . . . . . . . . . . . . . . . 92 7.12.13 Table wires − Drawing the table type connection lines . . . . . . .
92
7.12.14 Comments − Access to Comment symbol submenu . . . . . . . . .
92
Collection 2010 rev. 4
x
FbCAD Manual
7.13
7.14
DRAW −> COMMENTS − COMMENT SYMBOL DRAWING COMMANDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
93
7.13.1 DText − Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
93
7.13.2 Pline − Drawing a line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
93
7.13.3 Box − Drawing a box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
94
7.13.4 Circle − Drawing a circle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
94
7.13.5 Color − Changing the drawing color of comments . . . . . . . . . .
94
7.13.6 Line type − Changing the line type of comments . . . . . . . . . . . .
94
COMMON − GENERAL AUTOMATION LANGUAGE CONCEPTS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
95
7.14.1 Automation module... − function block diagram . . . . . . . . . . . .
95
7.14.2 Function module... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
97
7.14.3 Externals in continuous... − External continuous inputs . . . . . .
98
7.14.4 Externals out continuous... − External continuous outputs . . . .
98
7.14.5 Externals out conditional... − External conditional outputs . . .
99
7.14.6 External ports in... − External input ports . . . . . . . . . . . . . . . . .
99
7.14.7 External ports out... − External output ports . . . . . . . . . . . . . . . 100 7.14.8 Direct access left... − Direct access ports, connections on the left . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 7.14.9 Direct access right... − Direct access ports, connections on the right . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 7.14.10 Interface in... − Input interface ports . . . . . . . . . . . . . . . . . . . . . 101 7.14.11 Interface out... − Output interface ports . . . . . . . . . . . . . . . . . . . 101 7.14.12 Locals left... − Local data points, connections on the left . . . . . 102 7.14.13 Locals right... − Local data points, connections on the right . . 102 7.14.14 Constants left... − Constants, connection on the left . . . . . . . . . 103 7.14.15 Constants right... − Constants, connection on the right . . . . . . . 103 7.15
FBLOCKS1 − FUNCTION BLOCKS . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
7.16
FBLOCKS2 − FUNCTION BLOCKS . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
7.17
FBLOCKS3 − FUNCTION BLOCKS . . . . . . . . . . . . . . . . . . . . . . . . . . . 108 7.17.1 Things to be noted in defining function blocks . . . . . . . . . . . . . . 110
7.18
I/O − I/O FUNCTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 7.18.1 EIO − I/O functions of embedded I/O . . . . . . . . . . . . . . . . . . . . . 115 7.18.2 IEC − I/O functions of embedded programmable I/O . . . . . . . . 115 7.18.3 PROFIBUS − I/O functions of the PROFIBUS fieldbus interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Collection 2010 rev. 4
metsoDNA CR
xi
7.18.4 CIC − I/O functions of Damatic Classic . . . . . . . . . . . . . . . . . . . 116 7.18.5 OPC − Functions of the OPC client interface . . . . . . . . . . . . . . . 116 7.18.6 FF... − Functions of the Foundation Fieldbus interface . . . . . . . 116 7.18.7 MIO M80 − I/O functions of ACN I/O M80 series . . . . . . . . . . . 116 7.18.8 MIO M120 − I/O functions of ACN I/O M120 series . . . . . . . . . 117 7.19
MODULES − CONFIGURATION FUNCTIONS . . . . . . . . . . . . . . . . . . 118 7.19.1 Position... − Tag functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118 7.19.2 Operation... − Operation functions . . . . . . . . . . . . . . . . . . . . . . . 119 7.19.3 Event... − Event functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 7.19.4 History... − History functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 7.19.5 History2... − History functions . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 7.19.6 Trend... − Trend functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 7.19.7 Mimic... − Mimic panel controls . . . . . . . . . . . . . . . . . . . . . . . . . 122 7.19.8 Recipe − Recipe functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 7.19.9 PLU functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 7.19.10 MCP functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 7.19.11 DIS − I/O, tag, operation and event functions of Damatic Interface Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 7.19.12 LIS − Function blocks and I/O functions of Logic Interface Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 7.19.13 Simulation... Simulation functions . . . . . . . . . . . . . . . . . . . . . . . . 126
7.20
FBCADHELP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 7.20.1 Help FbCAD − Tool’s user guide . . . . . . . . . . . . . . . . . . . . . . . . . 127 7.20.2 Help Types − Type help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127 7.20.3 About FbCAD − Tool’s version data . . . . . . . . . . . . . . . . . . . . . . 127
8
SCREEN MENU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
9
DIALOGS FOR CONFIGURATION FUNCTIONS . . . . . . . . . . . . . . . . . . . . . 133 9.1
DIALOGS FOR TAG FUNTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133 9.1.1
Tag function for analog measurement (am) . . . . . . . . . . . . . . . . 133
9.1.2
Tag function for profiles (pro, pro2) . . . . . . . . . . . . . . . . . . . . . . 138
9.1.3
Tag function for profile scaling (prosca, pr2sc) . . . . . . . . . . . . . 141
9.1.4
Tag function for scanners (sc) . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
9.1.5
All tag functions (except those of profiles) . . . . . . . . . . . . . . . . . 144
Collection 2010 rev. 4
xii
FbCAD Manual
9.2
9.3
9.4
9.5
DIALOGS FOR OPERATION FUNCTIONS . . . . . . . . . . . . . . . . . . . . . 157 9.2.1
Operation function (amop) for analog measurement . . . . . . . . 157
9.2.2
All operation functions ’XXop’ and operation functions with direct access keys ’daop’ . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
DIALOGS FOR MIMIC PANEL CONTROLS . . . . . . . . . . . . . . . . . . . 160 9.3.1
Mimic panel control for binary signal . . . . . . . . . . . . . . . . . . . . . 160
9.3.2
All mimic panel controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
DIALOGS FOR EVENT FUNCTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . 163 9.4.1
Event function for analog measurement am . . . . . . . . . . . . . . . . 163
9.4.2
Event function for analog measurement am* . . . . . . . . . . . . . . . 166
9.4.3
All event functions (excluded am*, bm2*, grp*, mgv* mtr* and pid*) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
DIALOGS FOR HISTORY FUNCTIONS . . . . . . . . . . . . . . . . . . . . . . . . 177 9.5.1
Dialog for a ph3 history function (History) . . . . . . . . . . . . . . . . 177
9.5.2
Dialog for a Write group (History) . . . . . . . . . . . . . . . . . . . . . . . 180
9.5.3
Dialog for read groups (Read and Unsolicited read), History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
9.5.4
Dialogs for history tags (History) . . . . . . . . . . . . . . . . . . . . . . . . . 182
9.5.5
Dialog for a Write group (History2) . . . . . . . . . . . . . . . . . . . . . . 184
9.5.6
Dialog for read groups (Read and Unsolicited read), History2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
9.5.7
Dialogs for history tags (History2) . . . . . . . . . . . . . . . . . . . . . . . . 186
10 CONFIGURATION OF TABLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192 10.1
TABLE SYMBOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
10.2
”ANY” TYPE SYMBOL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
10.3
TABLE SYMBOL VS. ”ANY” TYPE SYMBOL . . . . . . . . . . . . . . . . . . 192
10.4
INITIAL VALUES OF TABLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
10.5
CONFIGURATION OF TABLE SYMBOL . . . . . . . . . . . . . . . . . . . . . . . 194
10.6
TABLE EDITOR DIALOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 10.6.1 Entering the data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197 10.6.2 Changing the values later in the table symbol dialog . . . . . . . . 197 10.6.3 Repeating the table creation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
Collection 2010 rev. 4
metsoDNA CR
10.7
xiii
HEADER FRAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198 10.7.1 Fault bits of the header (:fails) . . . . . . . . . . . . . . . . . . . . . . . . . . . 198 10.7.2 Mode of the table (:mode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198 10.7.3 Type of the elements of the table (:elemtype) . . . . . . . . . . . . . . . 198 10.7.4 Dimensions of the frame (:dim) . . . . . . . . . . . . . . . . . . . . . . . . . . 199 10.7.5 Size of the table (:size) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
10.8
ELEMENTS FRAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 10.8.1 Value of :elem(*) — e(*) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 10.8.2 Visibility of :elem(*) in the diagram . . . . . . . . . . . . . . . . . . . . . . 200 10.8.3 Editability and visibility of the other elements in the diagram — Editable elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201 10.8.4 Index of the first editable/visible element — e() first . . . . . . . . 201 10.8.5 Index of the last editable/visible element — e() last . . . . . . . . . . 201 10.8.6 Common fault bits and common value of the visible elements — fails/bin ja value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201 10.8.7 Length of elements in the diagram — Maximum length of an element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
10.9
11
EDITING TABLE VALUES IN EXCEL . . . . . . . . . . . . . . . . . . . . . . . . . 202
ERROR MESSAGES AND CORRECTING ERRORS . . . . . . . . . . . . . . . . . . . 203 11.1
GRAPHIC ERRORS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
11.2
SYNTAX ERRORS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
11.3
SEMANTIC ERRORS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
11.4
UNKNOWN DXF−ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
APPENDIX 1 FBCAD MENUS APPENDIX 2 QUICK GUIDE APPENDIX 3 FUNCTIONS ALLOWED IN FORMULAS
Collection 2010 rev. 4
xiv
FbCAD Manual
Collection 2010 rev. 4
General
1
1
GENERAL FbCAD (Function Block Computer Aided Design) is an engineering tool of Secured Life Cycle Activity. FbCAD tool is used in engineering server (EAS) or engineering workstation (EAC) and with part of its functions in an independent Windows based work station (stand alone workstation). FbCAD is used in designing function block diagrams, which are control loops related to controlling and monitoring a process controlled by metsoDNA CR. Function block diagrams consist of configuration functions which include e.g. Process Control Server’s (PCS) continuous controls, I/O functions and mimic panel controls as well as control room’s tag, operation and event functions, and history functions of information management activity. Function block diagrams together with their configuration functions are saved in the engineering database located in the engineering server (EAS) from which they can be viewed with FbCAD or printed. They can be also opened with DNAexplorer to be viewed or modified. A function block diagram created with FbCAD is simultaneously both an application loaded in the runtime environment and its graphical document. This ensures that the documentation of the application is even after modifications always up−to−date. FbCAD provides the engineer with an illustrative and efficient graphic working environment for designing metsoDNA CR applications. FbCAD is based on CAD software and it makes use of the advanced engineering features of CAD. This manual requires that the reader has basic knowledge of the Windows environment use and terminology. If this is not the case, it would be worth while to get acquainted with the Windows guide books. In addition, the reader is assumed to be familiar with metsoDNA CR related concepts. They can be studied by examining, for example, the following documents: Engineering Modelling, Automation Language and Process Control Server Function Blocks.
1.1
SOME CONCEPTS Following is a list of concepts frequently used in this document and CAD operating instructions: Graphic object A common name for CAD graphic objects (such as lines, arcs). Block CAD graphic object that is composed of several smaller graphic objects and that can be given various attributes. Attribute A text−type object connected to a CAD block that contains information of the block. Screen menu A menu on the right−hand side of the display from which you can for example pick commands and function blocks needed in engineering work. Menu bar A menu at the top of the display. You can select desired items from the menu by ’pulling down’ a menu option with the mouse (pull−down menus).
Rev. 2
2
FbCAD Manual
Icon menu Some options of the menu bar (such as function blocks) display an icon menu that allows you to pick a function on the basis of graphic information. Dialog A form that allows you to choose parameters in an interactive way. Dialogs are used, for example, in entering and modifying function block diagram’s configuration function and function block data. Function block diagram A control application created with FbCAD engineering tool. It consists of configuration functions. Configuration function A component of function block diagram, which consists of configuration elements and their internal connections. Configuration functions include, for example, continuous controls, I/O functions and event functions. Configuration functions are the largest entities in runtime environment. The various configuration functions of the design function are loaded in runtime environment for different application servers. Configuration element The smallest component of a configuration function. Configuration elements include function blocks, ports and data points. Continuous control A configuration function which is meant for implementing non−stop controls and actuator controls. Design function Design function is an engineering object which consists of configuration functions. Design fuctions include, for example, function block diagrams, sequence diagrams and graphic pictures. Engineering object Design and configuration functions are collectively called engineering objects. Function element Engineering objects and configuration elements are collectively called function elements. Workspace Each engineer has a personal working environment. In that environment you can manage all the phases of engineering in normal situations. You can gather function block diagrams in the workspace for later editing. When the engineering session is ended the function block diagrams left in the workspace are still there when a new session is started later. Repository Function block diagrams of a certain project are stored in the repository. The repository is common for all engineers. DNAexplorer The DNAexplorer is a database browser meant for managing the application. You can handle the function block diagrams located in the repository or workspaces in many different ways.
Rev. 2
General
3
Secured Life Cycle / Engineering Secured Life Cycle / Engineering includes a repository and workspaces of engineering data as well as the tools meant for engineering and editing the application. Engineering Server (EAS) An engineering server is a server of the Secured Life Cycle activity where the respository and workspaces are located. The engineering data is transferred to the runtime environment of metsoDNA CR from the engineering server. Engineering workstation (EAC) An engineering workstation is a network station of engineering server. The engineering workstation includes engineering tools but it does not include repository or workspaces. Cross Reference A feature of FbCAD and SeqCAD engineering tools. With this function a list of continuous controls is fetched from the repositories of engineering servers. All the listed continuous controls use direct access ports or interface ports which have been defined in the function block diagram. Anchor An anchor can be set to function block and sequence diagrams. This anchor (point) defines the location of the cross reference list in the function block diagram. Template A template is used to create the loops (engineering objects) to be implemented. This replaces the previously used term “type circuit”. Design Function Interface The design function interface is an engineering object that has only design parameters, i.e., design members and attributes, but no function to be executed. Value Formula The value displayed to the user is generated on the basis of a value formula. Function formula The truth value of the function formula in an engineering object is used to determine whether a certain part of the engineering object is enabled or disabled. Design member A design member is used as a variable in formulas. One example of a design member is $(TAG).
Rev. 2
4
1.2
FbCAD Manual
DIALOGS Most of the CAD tools’ shared functions utilize CAD−type dialogs in their user interface. By using these dialogs the user gives the information required by the application functions and chooses the related settings.
1.2.1
Dialog components The dialogs consist of certain basic components. The most common components are the following: Command buttons immediately initiate certain actions. For example, saving starts when you click the OK button related to the Save as dialog. Text field. You can type optional texts here. A list includes options. You can choose one at a time. The chosen option is highlighted on the list. A drop−down list box is otherwise similar to list but it normally shows only the option chosen at the time. The list opens when you click on the symbol right to the option, and then you can deal with it in the similar manner to a normal list. When you choose one option the list closes to its original state and shows the chosen option. Selection buttons usually come in groups, and only one can be on at a time. In other words, the options exclude each other the same way as in a list where you can choose only one option at a time. In certain situations, some of a dialog’s components can be in a state where their use is disabled. The purpose of this function is to help the user by allowing him to choose only meaningful settings and actions. You can notice the disabled component when the component in question (its text) is grey. For example, when you choose repository for the function block diagram location in the Save as dialog, the directory browse function cannot be used.
Figure 1
An example of a dialog
Rev. 2
General
1.2.2
5
Using the dialog The dialog components are active one at a time. This means that the typed information is always directed at that component (e.g. typing with letter keys come out as text in the text field). The dialog component can be activated either by mouse or by pressing simultaneously the keys ALT + the underlined letter in the component title. If the component is a button, the latter will activate the accompanying function. When the required information is chosen and given to the dialog components, you can start the function by clicking the mouse on the OK button. Pressing Cancel interrupts the function. In the Windows software, a help file corresponding to the dialog function appears on the display when Help button is pressed.
1.3
ENTERING COMMANDS
1.3.1
Using the mouse FbCAD engineering tool has been designed with a view to easy mouse operations. There are two menus for picking commands with the mouse: the menu bar and the screen menu. The mouse also offers the simplest way of moving and combining function block diagram components (e.g. configuration functions and function block symbols). The left mouse button is used, for example, for picking commands from menus and entering points in the function block diagram. The right button is used for drawing or ending a function. It can also be used for echoing the previous command and re−entering it. If a wheel mouse is used, a function block diagram can be zoomed by rolling the wheel and scrolled by keeping the wheel down and moving the mouse.
1.3.2
Using the keyboard The keyboard is mainly used for entering text and numerical data in dialogs. Some commands used in the engineering can also be entered from the keyboard, but the use of menus is usually more flexible. The engineer should avoid direct commands from the keyboard unless he is certain that the CAD tool supports these commands. One should especially avoid direct CAD editing commands which affect the picture itself. The Enter key corresponds to the right mouse button: it enters the data and echoes the previous command.
Rev. 2
6
1.3.3
FbCAD Manual
Repeating (echoing) the previous command Using the right mouse button or the Enter or Space key of the keyboard you can quickly repeat a command. This feature is very useful if the same symbol is used repeatedly in the function block diagram or if you need to enter several signals of the same type. Depending on the version number of AutoCAD, the right button of a mouse does not always by default repeat the previous command. For example, in AutoCAD 2002 the right mouse button can be defined to repeat the previous command as follows: 1
Enter the command ’preferences’ in the command line.
2
Select the Right−Click Customization button in the User Preferences tab.
3
In the appearing dialog, select the Repeat Last Command option in the Default Mode and Edit Mode frames and ENTER option in the Command Mode frame.
4
Close the Right−Click Customization dialog by clicking the Apply & Close button.
5
Exit the Options dialog by clicking the OK button.
In drawing functions the previous command can be entered directly with one echoing. The following example shows you how to use the function. In this example we draw several donuts for soldering lines very quickly. Before starting to connect the lines, draw all connection lines that need to be connected. Select Dot from the Draw menu using the left mouse button. Point the mouse at the crossing of the lines to be soldered and press the left mouse button. A donut will now appear at the crossing. Use the right mouse button to echo the Dot command. Point a new crossing, and solder the lines using the left mouse button. Repeat this procedure until you have connected all required signals. Symbols that are inserted as blocks (symbols picked from Commons, Fblocks and Modules menus) are echoed in a different way: they must be echoed twice before the symbol can be inserted in the function block diagram. Following is an example of inserting several function blocks of the same type: Select the desired function block from the Fblocks menu by the left mouse button and insert it in the function block diagram using the left mouse button. Fill in the dialog and enter the data by selecting OK. Using the right mouse button, echo the block insert command. The block to be inserted now defaults to the previous block. When you press the right mouse button again you accept the default. The symbol of the previous block appears on the mouse cursor, and you can place it in the function block diagram. After pasting the symbol with the left mouse button you get the dialog for entering the data required for the function block. After entering the data accept them by selecting OK. Repeat this until all required symbols have been inserted.
Rev. 2
General
1.3.4
7
Using the menus and their differences The menu bar and the screen menu contain virtually the same commands, therefore they can be picked from either menu. The menus however behave somewhat differently. The menu bar is located below the header of the window (Figure 2). You can scan the menu by moving the mouse; the current selection is highlighted. To select the highlighted item press the left button. The commands belonging to this item will now ’drop down’ below the item (pull−down menu). Header
Figure 2
Menu bar
Picking area for pull−down menus
Immediately after picking the command from the pull−down menu the menu disappears. When you select function blocks from the pull−down menu, an icon menu related to the item is displayed. The menu shows symbols depicting the available function blocks. To pick a function block from the icon menu point the box shown beside it and press the left mouse button. The screen menu on the right side of the display is always visible. Commands are selected in the same way as in the menu bar: by highlighting a selection with the mouse cursor. Pressing the left button selects the command and replaces the screen menu with the related submenu. The submenus, in turn, contain commands and new submenus that can be picked in the normal manner by the left button. The difference between the menu bar’s pull−down menus and the screen menu is that the screen menu (or its submenu) does not disappear after selection. The menu is changed only after selecting a command that causes a new submenu to appear. Selecting the FbCAD area on top of the menu column brings you back to the highest menu level. Thus the screen menu offers a fast and easy way for picking several commands of the same type. Another difference between the menus is that when you select function blocks from the screen menu, the variations will not be shown in an icon menu but listed by name.
1.4
SELECTING OBJECTS Some commands (such as Move, Move to page, Copy, Copy to page, Erase, Renum, i.e. commands that show the Select objects: prompt on the command line) may be performed on several objects at the same time. You do not need to select all objects individually by pointing the mouse at them, because there are useful additional options that can be entered via the keyboard, the most important being:
Rev. 2
8
FbCAD Manual
W (Window) This option selects all objects inside a specified rectangular area, a window. After typing W and pressing you will be asked for the first corner: First corner:
Use the left mouse button to specify the first corner of the window. After this you will be prompted to give the second corner: Other corner:
Using the left mouse button, specify the other corner. When you specified the first corner, the cursor turned to a dynamic rectangle, which makes selecting the other corner easier. Only currently displayed objects are selected, and if an object is displayed only partly, it will be included only if all its visible parts are inside the window. C (Crossing) This option is similar to Window, but all objects crossing the window border will be selected. Box If you specify ’box’ as the option for the ’Select objects:’ prompt, you will also be prompted to enter two diagonally opposed corners (as in Window or Crossing). If the second corner is located right from the first corner, the box option corresponds to the Window option. If the second corner is left from the first one, the box function corresponds to Crossing. NOTE! When selecting an object you point the mouse to an e.g. empty location (and no additional options are given from the keyboard), the Box option starts automatically and the user is asked for the other corner of window. L (Last) The Last option is used to select the last created object, which is shown on the display. Only one object can be selected using the l option, regardless of how many times you enter the option. P (Previous) Reactivates last selection. NOTE! If you have destroyed objects, they are also deleted from the previous selection list, so you can no longer reselect them. U (Undo) This option erases the last selection from the selection list. If you do several Undo’s in a row, you can undo several selections. R (Remove) Activates object remove mode. In other words, when you select an object and the Remove mode is on, the object will be removed from the selection list. In Remove mode the ’Select objects:’ prompt will turn to ’Remove objects:’. In remove mode you can remove several objects at a time using the other options (such as W). A (Add) Ends remove mode and puts you back to the object adding mode. Empty answer When you are satisfied with the selected group of objects, answer the ’Select/Remove objects:’ prompt with an Enter or space. The above options can be freely combined.
Rev. 2
Settings for the Engineering Environment
2
9
SETTINGS FOR THE ENGINEERING ENVIRONMENT The engineering environment includes several settings that affect the way the various CAD engineering tools behave. An example of these settings are the default engineering server (EAS) names and the default workspace names. To make it easier for the user to change these settings a special editor is included in the engineering environment. This editor is called the Settings Editor. The description of its use can be found in a separate metsoDNA CR document Settings Editor Manual.
Rev. 1
10
3
FbCAD Manual
STARTING THE ENGINEERING TOOL The engineering tool can be started either from the Start menu or with the DNAexplorer.
3.1
STARTING FROM THE START MENU Start the CAD engineering tool by clicking it in the Start menu. NOTE! If the user, when starting the engineering tool, for example changes the window size, the initialization may be uncompleted and the engineering tool will not function properly. It will be worthwhile to wait until the engineering tool version information appears on the command line and not to start working until then.
3.2
STARTING WITH THE DNAEXPLORER Please note that the DNAexplorer is not available when using an independent Windows based workstation.
Creating a new function block diagram It is possible to create a new function block diagram also in the DNAexplorer. Create a new function block diagram by selecting the Object−>Create−>Function Block Diagram command of the DNAexplorer. The command starts the FbCAD engineering tool.
Editing a function block diagram First select the function block diagram in the DNAexplorer and give the Open command either from the menu bar or from the menu which appears when the right mouse button is pressed. The command starts FbCAD. The FbCAD tool also opens by double−clicking the function block diagram in the DNAexplorer.
Rev. 1
Basics of FbCAD Engineering
4
11
BASICS OF FBCAD ENGINEERING FbCAD is based on a graphic user interface , which is used in creating a function block diagram from a closed or open control loop. The function block diagram consists of configuration functions which include e.g. Process Control Server’s (PCS) continuous controls, I/O functions and mimic panel controls as well as control room’s tag, operation and event functions, and history functions of information management activity. The following figure (Figure 3) presents a function block diagram and the configuration functions it consists of.
Rev. 2
12
FbCAD Manual
31
2
3
5 4
5
7
7
FUNCTION BLOCK DIAGRAM 3
Name: Type:
1 5 6
4
pr:LICA-369.F continuous control Name: Type:
pr:LICA-369.I standard io
Name: Type:
Name: od:A1:LICA-369 Type: operation
pr:LICA-369.O1 standard io Name: Type:
pr:LICA-369.O2 standard io
PCS's configuration functions Figure 3
2
Name: al:A1:LICA-369.F Type: event Name: ce:A1:LICA-369 Type: tag
Control room's configuration functions
Function block diagram and the configuration functions it consists of
Rev. 2
5 6
Basics of FbCAD Engineering
13
When creating a function block diagram you can make use of the advanced CAD editing commands and the versatile menu structures of FbCAD. Moreover, these configuration functions and function blocks are available in several variations, for example, with different numbers of inputs and parameters. The variations can be selected from a so−called icon menu after picking the desired configuration function or function block from the menu bar at the upper edge of the display. The variation icons shown in the menu resemble the component to be picked. Connection and parameter data for the function block diagram can be entered through an interactive dialog. Configuration functions, function blocks, ports etc of a function block diagram can be connected to each other with connection lines. For example, the output of the flow measurement’s I/O function can be connected to the measurement input of the controller function block with a connection line. As a result, when a function block diagram has been loaded in the runtime environment, the controller algorithm receives the flow measurement in question in its measurement input. When a function block diagram is completed, it is verified with the Check command. If the function block diagram or its configuration functions contain errors, they are displayed in both graphic and list form. The function block diagram with its configuration functions is saved in the engineering database located in the engineering server (EAS) from which it can be printed or reopened by using FbCAD or DNAexplorer. The contents of the engineering database can be reviewed, structured and managed with DNAexplorer, which can also be used to directly modify, for example, the values of a function block diagram’s function blocks and ports. The modified values can then be saved back in the database and can also be displayed in the function block diagrams. A function block diagram is loaded for process control from the engineering database to the runtime environment with the download commands of FbCAD or DNAexplorer. Only the configuration functions of the function block diagram are transferred to the runtime environment in loading. Each configuration function is directed to be run in an application server especially defined for it. For example, continuous control is always defined to be run in a PCS, operation function in an OPS and event function in an ALP. A function block diagram created with FbCAD is simultaneously both an application loaded in the runtime environment to control a process, and its graphical document. This ensures that the documentation of the application is even after modifications always up−to−date.
Rev. 2
14
5
FbCAD Manual
FbCAD FUNCTION BLOCK DIAGRAM After the FbCAD engineering tool has started, the function block diagram base shown in Figure 4 will appear on the monitor. The engineer’s work area consists of three areas and two administrative parts. For external inputs and input functions there is an area at the left edge of the function block diagram. Correspondingly, an area for external outputs and output functions is reserved on the right. The continuous control and its configuration elements and internal connections are shown in the middle of the function block diagram. All symbols: ports, data points, function blocks and connection lines can be located anywhere in the drawing area. There are two menus that contain almost the same commands but behave differently. The lower part of the display includes a command line on which you can enter commands from the keyboard and see the commands entered from the keyboard or through menus. In addition, the command line displays the FbCAD’s messages to the user. The bottom part of the drawing area contains the function block diagram’s administration part with information related with the current function block diagram.
3
10 9 11
7
1
6
4
2 Figure 4
8
5 FbCAD function block diagram base
Rev. 2
FbCAD Function Block Diagram
5.1
15
1
Active page
2
Mouse cursor coordinates
3
Screen menu
4
Command line
5
Administration part of function block diagram
6
Connection area for configuration elements and internal connections of continuous control
7
Connection area for external inputs
8
Connection area for external outputs
9
Administration part of continuous control
10
Other configuration functions related to the function block diagram
11
Mouse cursor
DRAWING LAYERS AND PAGING FbCAD engineering tool makes use of CAD’s facility to define several drawing layers in making the design of function block diagram more illustrative. In FbCAD engineering you can use two drawing layers: design layer and comments layer. When a function block diagram is loaded in the runtime environment to control the process, only the components located on the design layer will be loaded. All process controlling components must thus be located on the design layer. The COMMENTS layer is reserved for the engineer’s comments and pictures, etc. The data created on this layer will not be loaded to the runtime environment. On this layer you can write texts, draw lines, other graphic primitives. Function block diagrams for large connections can be created using the multi−page feature of the engineering tool. A multi−page function block diagram is a large picture base where each function block diagram page is assigned a separate area of coordinates. All information for this page must be inserted within this area. The function block diagram base is dynamic, which means that you can insert new pages which increase the size of the function block diagram base. Only the page of a function block diagram that you are currently editing is active, while others remain passive. The page area is indicated in the function block diagram by a frame whose border area contains the administration part of the function block diagram. The frames will always appear in the page that is activated. Function block diagram editing operations only apply to the active page. The pages are numbered according to layers (design layers) Layer 1, Layer 2 etc. A comment layer is superimposed on each page, in other words, Layer 1_COM, Layer 2_COM etc. For proper data management it is essential that the information on a function block diagram page is stored on the correct layer and coordinate area. There is a check command in the menu for verifying the correct location of the data.
Rev. 2
16
FbCAD Manual
The following figure (Figure 5) presents the structure of a four page function block diagram and the coordinate areas for the pages. The active page (page 1) is shaded. (0,903)
Page 2, layer 2
Page 3, layer 3
Page 1, layer 1
Page 4, layer 4
(0,480) (0,423)
(0,0)
(640,0) Figure 5
5.2
(1280,0)
The location of pages and page coordinates
MOUSE CURSOR COORDINATES The x and y coordinates of the mouse cursor in FbCAD set of coordinates are shown on the lower edge of the display.
5.3
SCREEN MENU On the right edge of the display you can see the FbCAD screen menu used for accessing some of the available commands. This menu is built on a hierarchic principle, so ’behind’ the screen menu there are submenus that bring you to new commands and new submenus.
Rev. 2
FbCAD Function Block Diagram
5.4
17
COMMAND LINE On the bottom of the display there is a command line that displays all commands entered to FbCAD. The command line allows you to enter commands from the keyboard and edit previous commands. It is also possible to use the Copy and Paste commands. The lines above the command line scroll up with the command line when new FbCAD commands are given. These lines also show FbCAD’s messages to the user. It is possible to scroll up and down the lines with the arrow buttons on the right side of the command line. It is possible to copy commands from these lines and paste them on the command line to be executed. These Copy and Paste commands can be selected by clicking the right mouse button on the command line. Pressing the function key F2 moves you from graphic window to text window and shows the ”command history” of the commands entered. Press F2 again to return to the graphic window. (Also with View − Text window command you can go to text window.) With the Copy and Paste commands it is possible to copy commands from the command history of the text window to the command line.
5.5
ADMINISTRATION PART OF THE FUNCTION BLOCK DIAGRAM On the bottom of the display (Figure 6) there is the function block diagram administration part. The data for the administration part are entered through a dialog (see Edit menu, option Values).
1
2
3
Figure 6
4
5
6
7
8
9
Function block diagram administration part
1
Area reserved for the logo
2
Date and time when created yy−mm−dd hh:mm (updated automatically)
3
Date and time when changed yy−mm−dd hh:mm (updated automatically)
4
Engineer who created the function block diagram (updated automatically)
5
Modifier who updated the connection/values (updated automatically)
6
Customer’s name
7
Four process area fields which correspond the first four process areas in the DNAexplorer’s process area hierarchy. These values are updated to the DNAexplorer when a function block diagram is stored in the workspace or in the repository. If the process area of the function block diagram is modified with the DNAexplorer, the data will be updated to these fields.
8
Loop’s tag identifier under which the function block diagram is stored in the workspace and in the repository
9
Name, a short description of the function block diagram (2 lines)
10
Page number
Rev. 2
10
18
FbCAD Manual
Besides these visible data the administration part of the function block diagram contains a field for function block diagram status, but this field is not shown in the function block diagram administration part. Possible states are:
5.5.1
incomplete complete tested
Entering data into customer field A special customer symbol, which is then automatically added to each function block diagram, may be created for customer’s name data. In a multi−page function block diagram the customer symbol is also transferred with the administration symbol of a page to the desired page. A customer symbol is a so−called reference symbol, i.e. it is a file which is referred to in a function block diagram. If a customer symbol is modified, the modification will be automatically visible in all those function block diagrams which refer to the symbol in question. The function block diagram base of a CAD engineering tool contains a reference to the customer symbol file customer.dwg which is usually located in the directory \dna\\EA\wds. The common customer symbol customer.dwg is shared with all the CAD tools of Secured Life Cycle Activity. After the CAD tools have been installed, the customer symbol file customer.dwg is empty, but it can be modified as follows: 1.
Start an FbCAD tool.
2.
Create a drawing with either tool commands or CAD commands. It may be worthwhile to place the drawing on the customer field of the administration part in a function block diagram.
3.
Make the drawing into a symbol by using the CAD command block and by answering the questions as follows: Enter a name for the symbol, e.g. mysymbol. Note: do not use the name ’customer ’: Block name (or ?):
Enter origin (0,0) as the insertion base point of the symbol: Select objects:
Specify the insertion point of the symbol: Select objects:
4.
Save the symbol as a file with the CAD command wblock with the same name as the symbol, e.g. mysymbol.
5.
Exit the CAD tool.
6.
Move the file you just saved to the directory \dna\EA\\wds\ and rename it customer.dwg.
7.
Start a CAD tool (e.g. FbCAD) and check that the customer symbol appearance is as desired.
If old function block diagrams are required to include a reference to the customer symbol, it can be automatically added by setting the variable Admin update to the On state in the WDS tab of Settings Editor. From now on each time one of the tools is started (or a new design function is opened), the administration part symbol is updated, and references to the logo and the customer symbol are added to the picture.
Rev. 2
FbCAD Function Block Diagram
5.6
19
CONNECTION AREA In the connection area you make the connections for function blocks, local data points and direct access ports. Symbols can be located at any point of the connection area.
5.7
CONNECTION AREA FOR EXTERNAL INPUTS In the connection area for external inputs you place input functions, input−interface ports and external input data points.
5.8
CONNECTION AREA FOR EXTERNAL OUTPUTS In the connection area for external outputs you place output functions, output−interface ports and external output data points.
5.9
CONTINUOUS CONTROL ADMINISTRATION PART The administration part of a continuous control (Figure 7) shows the following fields:
1 Figure 7
5.10
2
4
3
Administration part of a continuous control
1
Name, the continuous control identifier.
2
Package, the identifier of PCS in the runtime environment in which the continuous control will be loaded to be executed.
3
Execution, the interval in milliseconds at which the continuous control will be executed in PCS.
4
Order defines the execution order of the continuous control in the runtime environment in a continuous control group executed in a same PCS and execution interval.
EXTENSION PART OF THE CONTINUOUS CONTROL ADMINISTRATION PART The different pages of the multi−page function block diagram are indicated by the continuous control extension part text in the administration part.
Figure 8
5.11
Extension part of the continuous control adminisration part
OTHER CONFIGURATION FUNCTIONS RELATED TO THE FUNCTION BLOCK DIAGRAM Other configuration functions of the function block diagram are located at the top of the connection area.
Rev. 2
20
6
FbCAD Manual
ICON MENU An icon menu is opened on the display when some option which has three dots (...) after its header is picked from the menu bar’s pull−down menu, for example the selection points of the function blocks and configuration functions. The icon menu shows a ’reduced’ image or other illustrative piece of data of each available option. This makes it easy for you to pick the right symbol for the job. An icon menu option may also be a port to a new icon menu which will appear over the previous menu. The required symbol can be selected by pointing the icon or the symbol name in the selection list and acknowledging the selection by pressing the OK button. Another alternative is to double−click the required icon or symbol name with the left mouse button. You can then drag the symbol to a required location and place it with the left mouse button. If there are several pages of symbols, you can use the Next and Previous buttons in the icon menu to move between the pages of different icon menus. The menu also includes a Cancel button which enables you to quit the menu without selecting any symbol. An icon menu can only be called from a menu bar’s pull−down menu, not from the screen menu. If you select a screen menu command leading to a submenu, the symbols will be displayed by their names in the screen menu. The symbols can also be picked from the screen menu, using the names depicting the symbols.
Figure 9
Example of an icon menu
Rev. 1
Menu Bar
7
21
MENU BAR You can pick up an item from a menu bar on the top of the display by pointing it with the mouse cursor when the item will become highlighted and a pull−down menu will appear under the item. Part of the menu bar’s pull−down menu commands lead to direct action. The command headers start with a capital letter and the symbol titles are written with small letters. The three dots after a header indicate that if you select this header a new menu e.g. an icon menu or a selection dialog will open. You can select a menu bar’s pull−down menu command either by clicking the mouse on a required location or by using the underlined short cut button. These are usually letters or numbers.
Figure 10
Structure of the menu bar
The menu bar with all commands is presented in the appendix at the end of the document. The menu bar contains the following options: File The File option contains commands related to the output and storage of function block diagrams. Edit The Edit option contains function block diagram editing commands. View The View option contains commands related to display management. Draw The Draw option contains commands used for combining function elements and pages as well as for specifying data points.
Rev. 4
22
FbCAD Manual
Common The Common option contains general concepts of the automation language, such as function block diagrams and continuous controls, various data points etc. Fblocks1, Fblocks2 and Fblocks3 The Fblocks options contain Process Control Server (PCS) function blocks. When you select a function block the display will show an icon menu containing variations of the selected function block. I/O The I/O option contains PCS’s I/O functions used in the engineering. When you select I/O functions the display will show an icon menu with variations of the I/O function. Modules The Modules option contains configuration functions used in the engineering (such as PCS’s mimic panel functions, tag functions, history functions, trend functions as well as OPS’s operation functions and ALP’s event functions) and access to the recipe menu and simulation functions. Access is also provided to the PLU and MCP menus. There is another document telling about configuration of PLU and MCP. The Module option also contains configuration functions of DIS and LIS. When you select configuration functions the display will show an icon menu with variations of the configuration function. FbCADHelp The FbCADHelp option contains tool specific help for commands and types and an About command which displays the engineering tool version information.
Rev. 4
Menu Bar
7.1
23
File − FILE MANAGING COMMANDS The File menu contains file managing commands, such as saving and printing function block diagrams. Since most of the commands may easily be directed at elsewhere, instead of the user’s default workspace, it would be worth while to pay attention to procedures in order to avoid causing damage to other users.
Figure 11
7.1.1
Structure of the File pull−down menu
New − Creating a new function block diagram You can use the New command when you want to create a new function block diagram. This command closes the function block diagram currently being edited with the engineering tool. If you have changed this function block diagram since you opened it or last saved it, you will be asked if you wish to save the function block diagram before the New command is executed. The following dialog is displayed:
Figure 12
New command asks if you want to save the function block diagram
When you answer Yes, a Save As command dialog appears on the display. With this you can save the previous function block diagram to a place of your choice. If you answer No, the engineering tool creates a new function block diagram and updates the values of the Name of planner and Date of planning fields to the function block diagram administration part. If you choose Cancel in the Save As dialog, the New command is interrupted.
Rev. 4
24
7.1.2
FbCAD Manual
Open... − Opening the function block diagram You can use the Open command to open (retrieve) existing function block diagrams. You can retrieve function block diagrams from a directory, the engineering server (EAS) workspace, or the engineering server (EAS) repository. This command closes the function block diagram currently being edited with the engineering tool. Therefore, if the function block diagram has been changed since you opened it or last saved it, you will be asked if you wish to save the current function block diagram before opening a new one. The dialog is the same as for the New command. If you answer Yes to the question, the Save as dialog is displayed first. If you answer No to the question (or after saving), the following dialog is displayed:
Figure 13
Open command dialog
The purpose of the dialog information is the following: Server name
Name of the engineering server (EAS), when you get the function block diagram from the engineering server (EAS) workspace or repository. This information is not relevant when you get the function block diagram from a directory. Engineering object location
With this location the user chooses whether he wants to get the function block diagram from a specified Directory, specified Workspace or Repository. Open engineering object Identifier of the function block diagram to be opened. You don’t have to type the file extension DXF on a filename. If you want to list the function block diagrams, you can use a wildcard (*) in an identifier. Version saved on 2010−08−23 13:06:20 Comment text 1 Shows the date and time of the last save and the comment text of the function block diagram to be opened. Password Asks a password for an engineering object which has been defined in DNAexplorer as a protected one. If an engineering object is protected, a password is needed when its function block diagram is opened. The purpose of the protection is to restrict who can view and modify the content of the diagram.
Rev. 4
Menu Bar
25
Default old character set Information on the default character set from which the character set is converted to the engineering tool environment character set. This information is relevant only when dealt with old function block diagrams.
The default values of the engineering server (EAS), function block diagram directory and the workspace names are defined in the workspace setting information (see chapter 2 Settings for the Engineering Environment).
Open dialog The dialog components have the following interdependences:
When you choose one name from the engineering server list (Server name), the workspace names that are connected to the chosen server in the workspace settings are automatically updated to the workspace list (Workspace). If there is a default workspace name (Default Workspace) in the list of workspaces, it is the list default value. Otherwise, the default value workspace is the workspace name which is first in alphabetical order.
When you start and end the Browse command by clicking the dialog OK button the chosen directory will become the Open dialog function block diagram directory.
If you end the List command by clicking the dialog OK button, the currently chosen name will become the function block diagram identifier (Open engineering object).
If you end the Options command by clicking the dialog OK button, the currently chosen character set becomes the default old character set.
Choosing the function block diagram (List) The user can type the function block diagram identifier directly to the corresponding text field (Open engineering object) or use the List command (List). If he chooses the latter alternative, he can choose the identifier directly from the list of names. This command displays, according to the Engineering object location, either a list of all function block diagram directory DXF files, or a list of the function block diagrams of the chosen engineering server (EAS) workspace. You can choose an identifier on the list and click the dialog OK button; the chosen identifier is updated to the Open dialog text field (Open engineering object). Cancel interrupts the choosing from the list. NOTE! You can choose the function block diagram identifier from the list also by double clicking its name. NOTE! If the location of the function block diagram is the repository and the user does not enter any search criterion to the Open engineering object field before pressing the List button, it is possible that the search lasts several minutes. Therefore it is recommended to give at least a part of the function block diagram identifier and wildcards (*) as a search criterion before starting the search function.
Rev. 4
26
FbCAD Manual
Function block diagram versions (Version) It is possible to open an older version of the function block diagram by clicking the Version button after using the List command. It opens the Select version dialog from which you can select the desired version to be opened in the engineering tool.
Figure 14
Version button dialog
The dialog presents the date and time of the save as well as the comment text which is used to identify the desired version. The versions appear on the list in chronological order (the latest on the top). For further information, see chapter 7.1.6 Save as... − Saving the function block diagram.
Rev. 4
Menu Bar
27
Changing the function block diagram directory (Browse) Note that the Browse button is available only if the location of the function block diagram (Engineering object location) is directory. The dialog Browse button starts the directory browse function. The dialog looks the following:
Figure 15
Browse button dialog
The dialog shows the drives which are currently in use (including the computer’s own diskette drive and mounted NFS drives). The directories of a drive can be displayed or hidden by double−clicking the drive character or by clicking the ’+’ or ’−’ character displayed on the left side of the drive character. The same applies to subdirectories as well. The currently chosen drive and directory name shows on the top part of the Browse dialog. When you click the OK button this directory will be updated to the Open dialog. Clicking the Cancel button closes the Browse dialog without updating the directory name seen in the Open dialog. Changing the default character set (Options) When you click the Options button the tool shows a list of those character sets which can be used as a default old function block diagram character set. You can then choose one of these and acquit by clicking the OK button. Cancel interrupts the changing of character set function. When you have given the information to the Open dialogs you can start the actual function performance by clicking the OK button. Cancel button will interrupt the whole function.
Rev. 4
28
7.1.3
FbCAD Manual
Navigate... − Examining external connections The Navigate command can be used to clarify the connection chains between an external data point and various ports. It can also be used to open any design function displayed in the Navigate dialog for editing. Note that the Navigate command will only function in function block diagrams which have been identifier checked and saved in the repository. The Navigate command can be used in navigating through the following configuration elements:
direct access or interface port
function block port
external datapoint.
The Navigate command is selected first followed by the configuration element to be examined. This will open a dialog in which all the external connections of the selected configuration element are presented. The Navigate command can retrieve data from several engineering servers (EAS). The engineering servers from which the data is retrieved are defined in the WDS tab of the Settings Editor. The example figure below displays a list of connections because a function block port has been selected.
Figure 16
Navigate−dialog
The columns of the dialog present the following information on each configuration element connected to the selected configuration element: design function identifier, configuration function identifier, data point or port identifier, design function category and the engineering server (EAS) where the design function is located. To edit a design function, select it from the list and click the Start or Open button. The Start button starts the corresponding CAD tool (in this example FbCAD) and opens the function in a new window. The Open button, on the other hand, opens the function in an existing window replacing another diagram. Note that the Open button is not available if the design function to be opened represents a different category (e.g. sequence diagram) than the function already open. In this case the Start function has to be selected. If you wish to continue with the Navigate dialog after you have edited an design function, save the modified design function in some other data storage than the repository since saving changes the state of the design function to unchecked, and an externally unchecked design function can not be examined through the Navigate command.
Rev. 4
Menu Bar
7.1.4
29
Download Real... − The modular loading of function block diagram’s configuration functions to real runtime environment A function block diagram is loaded from the engineering database to the real runtime environment to control a process with the Download command which can be found in FbCAD or DNAexplorer. Only the configuration functions of the function block diagram are transferred to the runtime environment in loading. Each configuration function is directed to be run in an application server especially defined for it. For example, continuous control is always defined to be run in a PCS, operation function in an OPS and event function in an ALP. The Download Real command targets the repository of the engineering server (EAS) which has been used in the latest Open or Save as command. The latest Open or Save as command must specifically target a repository of the engineering server. If it has targeted a directory or workspace, a dialog, which displays a request for saving the function block diagram first, is opened instead. The Download Real command first checks the function block diagram (internal check, identifier check and IO address check) in the repository and then opens the same dialog that the Download command of the DNAexplorer uses.
Note that the function block diagram the command loads from the repository has the same identifier as the one opened in FbCAD. Consequently, the command does not automatically save an open function block diagram from the FbCAD to the repository, but it must be done manually after modifications. The command is thus similar to the Download command in DNAexplorer. For more information on this command and the dialog related to it, refer to metsoDNA CR document ’DNAexplorer Manual’. Even the feedback of the command will be created in the same log files as used with DNAexplorer’s Download command.
Rev. 4
30
7.1.5
FbCAD Manual
Download Virtual... − The modular loading of function block diagram’s configuration functions to virtual runtime environment A function block diagram is loaded from the engineering database to the virtual runtime environment with the Download command which can be found in FbCAD or DNAexplorer. Only the configuration functions of the function block diagram are transferred to the virtual runtime environment in loading. Each configuration function is directed to be run in a virtual application server especially defined for it. The Download Virtual command targets the repository or workspace of the engineering server (EAS) which has been used in the latest Open or Save as command. The latest Open or Save as command must specifically target a repository or workspace of the engineering server. If it has targeted a directory, a dialog, which displays a request for saving the function block diagram first, is opened instead. The Download Virtual command first checks the function block diagram (internal check and identifier check) in the repository or workspace and then opens the same dialog that the Download command of the DNAexplorer uses.
Note that the function block diagram the command loads from the repository or workspace has the same identifier as the one opened in FbCAD. Consequently, the command does not automatically save an open function block diagram from the FbCAD to the repository or workspace, but it must be done manually after modifications. The command is thus similar to the Download command in DNAexplorer. For more information on this command and the dialog related to it, refer to metsoDNA CR document ’DNAexplorer Manual’. Even the feedback of the command will be created in the same log files as used with DNAexplorer’s Download command.
Rev. 4
Menu Bar
7.1.6
31
Save As... − Saving the function block diagram The Save As command saves the function block diagram. The saving can be done either to the directory, engineering server (EAS) workspace or to engineering server repository.
Figure 17
Save As dialog
Besides the components in Open dialog, there are a few additional components in the Save As command. Their meaning is the following:
Check This option checks the function block diagram when saving. You can choose this option from only the following engineering tools: FbCAD, SeqCAD and GdCAD.
New version This check box toggles the version function of a single function block diagram. The default setting is defined in Settings Editor (for further information, see the Settings Editor Manual).
Comment Different versions of a function block diagram are differentiated between each other on the basis of a comment text which should be entered here. The text is saved in the database and it is displayed in the format: “Version saved on 2007−05−02 14:52:30 Comment text 1”
Format This option shows the default DXF file save format (DXF−15). DXF−15 format is used so that, for example, the Navigate command and the language support would work.
If the function block diagram is saved to a directory, the operating system’s limitations must be taken into account in its identifier. The only allowed function block diagram identifier extensions are ”.DXF” and “.FB”. The DXF extension you don’t have to type, because, when necessary, the engineering tool adds it automatically.
Rev. 4
32
FbCAD Manual
When you are saving the old function block diagram, the default values are those which were currently chosen when the function block diagram was opened. If the function block diagram has been saved to another location when editing it, this location will become the new default location for saving. If you want to save the function block diagram to the workspace or to the repository, you have to, in order to change the function block diagram identifier, edit before saving the administration part symbol or choose the Admin button in the Save As command dialog. When you save to the directory, the information typed to the text field Save engineering object is the filename.
Modifying the information of the function block diagram administration part If you click the dialog Admin button, a new dialog is opened. In this dialog you can modify the information of the function block diagram administration part in the same way as when editing the normal symbols attributes.
Figure 18
Admin dialog
The modified information won’t be updated to the function block diagram until the Save As dialog has been closed by clicking the OK button. During the saving, Name of modifier and Date of modification fields are automatically updated according to the values at the moment of save. However, the name of the modifier can be changed, if necessary, in the Admin dialog. You can use the Values command to choose the function block diagram administration part for editing at any time during the drawing.
Rev. 4
Menu Bar
33
Different versions of a function block diagram It is possible to save a maximum of five different versions of a function block diagram in the repository. A new version is saved by selecting the New version option and entering the comment text which is used to identify the version. If different versions are not wished to be saved, the New version option is unchecked. The default setting of the option is defined on the EAC tab of Settings Editor’s settings (for further information, see Settings Editor Manual). Note that if an older version of a function block diagram is wished to be loaded in the runtime environment, that version must first be opened and saved. If this is not done, FbCAD displays an error message and the function block diagram is not loaded. For further information, see also chapter 7.1.2 Open... − Opening the function block diagram.
7.1.7
Check... − Checking the function block diagram You can use the Check command to create configuration functions from the function block diagram and check their validity. The command dialog looks the following:
Figure 19
Check command dialog
If the function block diagram currently open was retrieved from some workspace to the engineering tool before checking, then the default values of engineering server (EAS) and workspace are the same as when getting the function block diagram. If the function block diagram was retrieved from the repository to the engineering tool before checking, the default workspace is the workspace defined in the Settings Editor, in the Default Workspace field of the Servers tab. If there were no errors in the checked function block diagram, the tool asks the following: ”Engineering object checking was successful. Do you want to save the engineering object?” If you answer Yes, the tool shows the Save As command dialog, with the difference that certain information cannot be changed. In this case, you can only save to the engineering server (EAS) where the checking was made or to a directory. In the first case, you are not allowed to change the function block diagram identifier or the workspace. The function block diagram administration part information and format cannot be changed in either case. If errors are found in the function block diagram, an error message will appear on a separate window. In FbCAD and SeqCAD the location of error is shown also in graphics.
Rev. 4
34
7.1.8
FbCAD Manual
Delete... − Deleting a function block diagram You can perform one of the following actions with this command:
delete a function block diagram in the directory
destroy the function block diagram in engineering server (EAS) workspace
destroy the function block diagram permanently from the repository
Figure 20
Delete command dialog
You choose the function in the Engineering object location area. When you have given the required information to the dialog, the function will start when you click the OK button. When deleting function block diagrams, it is possible to use wildcards (*). Enter the search criterion to the Delete engineering object field and click the List button. A list containing the alternatives which fulfill the search criterion is displayed. Choose the function block diagram to be deleted from this list. If an engineering object is a protected one, a password is asked before deleting its function block diagram.
Rev. 4
Menu Bar
7.1.9
35
Print... − Printing the function block diagram You can use the Print command to print some of the function block diagram pages, the whole function block diagram or several function block diagrams to a chosen printer. This command has the following dialog:
Figure 21
Print command dialog
The purpose of the Print dialog information is the following: Current printer Shows the default printer type and printing target. You can change these settings by choosing the Setup button. The Print Setup dialog is presented in the chapter 7.1.12 Print Setup... − Changing the printer settings.
Options Chooses the area to be printed. The following options are available:
Display the function block diagram (or part of it) on the display
All Pages of a multi−page function block diagram
Page the chosen page of a multi−page function block diagram (active page is default)
Range a certain range of pages
Group of modules prints all the function block diagrams from workspace or repository or all the design functions of selected directory to the default printer. It is also possible to print only the function block diagrams which fulfill the search criteria from workspace, repository or directory. All pages of the multi− page function block diagrams are printed.
The printing starts immediately when you click the OK button.
Rev. 4
36
FbCAD Manual
Group of modules
Figure 22
Group of modules option dialog
When printing several function block diagrams from directory, the type of design functions should be checked first, because this command gets and tries to print all the design funtions in the directory regardless of the type. Opening design function of wrong type, however, may cause interference of the engineering tool and interruption of printing. When printing several function block diagrams (Group of modules), after you have clicked the Print dialog OK button, the tool asks where the function block diagrams are to be printed from. For the possible answer there are the following alternatives: the name of the function block diagram’s location directory, the engineering server (EAS) name and repository or the engineering server (EAS) name and workspace name. In addition, certain function block diagrams can be defined to be printed by using a search criterion (also the wildcard * can be used). After clicking the List button a list of function block diagrams, which fulfill the search criteria and which are located in the workspace, repository or directory, is printed. When printing several function block diagrams (Group of modules) the user may also define a file which contains the identifiers of used function block diagrams. The name of the file is defined in the Search pattern field. If there is a slash (/) or a backslash (\) in the Search pattern field it is expected that the file name is entered to the field. The clicking of the ’List’ button shows the design function identifiers in the file. The file contains the identifiers of the used design functions so that only one design function identifier is on each line. The design function type can be defined with the identifier in the following way: 35LIC−100(fb) 35LIC−101(fb) GD:1.2.3(gd)
Only the function block diagrams are processed by FbCAD. Other identifiers are ignored. If the function block diagram defined in the file does not exist the execution of the group command is interrupted and the rest of the function block diagrams are not processed.
Rev. 4
Menu Bar
37
There are examples of file names in the following:
7.1.10
File name (inserted in ’Search pattern’ field)
Fetched file when using EAC or EAS (function block diagram directory of CAD is d:\dna\Data\EA\fbmod)
./list.txt
d:\dna\Data\EA\fbmod\list.txt
.\list.txt
d:\dna\Data\EA\fbmod\list.txt
/tmp/list.txt
d:\tmp\list.txt
c:\temp\list.txt
c:\temp\list.txt
Print param − Printing the parameters Prints displayed symbols’ parameters in dialog. User may choose the desired symbols or enter the Enter key to print parameters of all symbols. Print param command asks if you want the list on the printer or on the display: List to the printer y/n ?
If you list on the display you may pause scrolling by pressing Ctrl−S keys. When you press Ctrl−S keys again scrolling continues. If you answer yes (y), the parameters will print to the default engineering server’s (EAS) default printer (unlike other data which is printed to the printer defined and chosen for the printing of the function block diagrams).
7.1.11
Print links − Printing the synchronize links of parameters You can use Print links command to print parameter synchronize links and their comments which are entered using the function block dialogs of the function block diagram. User may choose the desired function blocks or enter the Enter key to print parameter synchronize links of all function blocks. Print links command asks if you want the list on the printer or on the display: List to the printer y/n ?
If you list on the display you may pause scrolling by pressing Ctrl−S keys. When you press Ctrl−S keys again scrolling continues. If you answer yes (y), the parameters will print to the default engineering server’s (EAS) default printer (unlike other data which is printed to the printer defined and chosen for the printing of the function block diagrams).
Rev. 4
38
7.1.12
FbCAD Manual
Print Setup... − Changing the printer settings You can use the Print Setup command to change the following settings connected to printing:
printer
paper size, source and orientation
You choose these settings from the drop−down list boxes in the dialog connected to the command. The dialog to be opened is a common Windows Print Setup dialog.
Figure 23
Print Setup... command dialog
The purpose of the dialog information is the following: Printer
Select the printer from the Name drop−down list box. The Properties button opens a dialog for advanced settings. Paper
Size Specifies the paper size to be printed on
Source Specifies the paper source for the printer
Orientation Specifies how the document is positioned on the page
If you want to select a printer that is connected to the network but which does not appear on the Name drop−down list, click the Network button. The print settings mentioned here apply to all Windows software. For this reason any changes in settings can be seen in all other CAD engineering tools immediately after closing the dialog.
7.1.13
Test... − Accessing to the graphic testing tool There is a separate document of User Instructions for Function Diagram Testing Tool (Function Test).
Rev. 4
Menu Bar
7.1.14
39
Exit FbCAD − Exiting the engineering tool You can use the Exit command to exit the engineering tool. If you have changed this function block diagram since you opened it or last saved it, you will be asked if you wish to save the function block diagram before the Exit command is executed. The dialog is the same as for the New command. If you answer Yes, the Save as dialog is displayed for saving the function block diagram. No exits the engineering tool and Cancel interrupts the Exit command. Another way to exit the engineering tool is to choose the Close command from the CAD window system menu. Also this command offers the possibility to save before exiting the tool. NOTE! It is recommended to exit CAD tool before closing the Windows. If you attempt to exit Windows before the CAD tool has been closed, the tool asks the save question only at the first time. If you answer Cancel at the first time, the exiting from Windows is interrupted as would be expected, but at the next time this question is not asked.
Rev. 4
40
7.2
FbCAD Manual
Edit − FUNCTION BLOCK DIAGRAM EDITING COMMANDS The commands in the Edit pull−down menu let you edit function blocks and other data of function block diagrams, and combine the parts of connections into entities (macros) that can be stored on the disk and retrieved again to the same or other function block diagram. In addition the menu contains some paging functions.
Figure 24
7.2.1
Structure of the Edit pull−down menu
Undo − Undo one or more previous commands You can undo one or more previous commands. There are some CAD commands that you cannot undo. Many of the engineering tool editing and adding commands include several CAD commands. Because of all these reasons the Undo command does not always function as you would expect; it may not undo the last command or it may undo several additions at a time. The Undo command Mark attribute adds a mark to the undo information. With Back attribute you can return to the mark. There may be several Marks. You can execute the Back attribute as many times as you like, you always return to the previous Mark. The Back attribute removes always the Mark. The Mark also breaks the Undo command. Group and End attributes make a group of commands to function as one command, from the point of view of the Undo command. The Group attribute defines the beginning of command group and the End attribute defines the end. When this definition is completed, the Undo command cancels the whole defined command group at one go. This function has been used in several CAD menu commands. CAD manual gives more accurate information about the different Undo command options, limitations and interactions.
Rev. 4
Menu Bar
7.2.2
41
Redo Redo command can undo the Undo commands effect. You have to give the command immediately after the Undo command.
7.2.3
Values − Entering and editing the attributes of symbols After entering the Values command select a symbol on the function block diagram (you should point a piece of text or some line belonging to a symbol) by pressing the left button. Now you will be shown a dialog containing attribute values and you can change the values or enter new values. For instance, to select the administration part of a continuous control for editing, select the Values command from the menu. Use the mouse to move the white block on top of some text or line of the symbol located at the upper left corner of the function block diagram, and press the left mouse button. Now the following window will appear on the display.
Figure 25
Dialog for entering attributes
You can change a value in a field by pointing the mouse at the field. The field turns black and you can enter the new value from the keyboard. When editing text you can also use the clipboard commands Cut (Ctrl−x), Copy (Ctrl−c) and Paste (Ctrl−v). You can select the next field by pressing the Enter or arrow key or by pointing the next field with a mouse. You can change the size of the dialog by dragging any of its edges or corners. If a value formula has been defined for the symbol attribute, you cannot enter the value in the Value field. You can display value formulas in the Formula field by clicking the Show Formulas button. You can hide value formulas by clicking the Hide Formulas button which has replaced the Show Formulas button in the dialog. If a function formula has been defined for the attribute, the formula is displayed in the Function formula field. By clicking the Typehelp button, you can display help text on the type that has been entered in the field to the right of the button. Finally accept all the changed attribute values by clicking the OK button at the bottom of the dialog. To cancel all changes use the Cancel button. A similar dialog is displayed every time when attributes are entered (for example entering the data for the function block). In this document these dialogs are substituted with tables presenting the information asked in the dialog.
Rev. 4
42
FbCAD Manual
In metsoDNA CR DNAexplorer there is a Synchronize command which can be used for updating information from runtime environment to function block diagrams. The parameter to be synchronized is marked by the character @. For example:
Figure 26
Synchronize link marks
If you want to add comment texts to the parameters to be synchronized, fill in the dialog as follows: first the value of the parameter then the mark of the link and last the comment text.
Figure 27
Synchronize link comment texts
It is possible to synchronize the initial values of tables in function block diagrams and sequence diagrams. An element of a table which should be synchronized can be marked with @ character in CAD (in the same way as with scalar values). The @ character can be added with Edit−Values command. When you want to create a new table and add a @ character after every initial value, a @ character can be entered to the Value field in the Table Editor dialog (Figure 28 Adding @ character when creating a new table).
Figure 28
Adding @ character when creating a new table
Rev. 4
Menu Bar
43
It is recommended that the Table Editor dialog is set to display failure values. (Check the visible checkbox next to the Editable elements field and editable check boxes next to fails/bin and value fields.)
7.2.4
Design Members – Editing design member values You can use the Design Members command to change the values of all design members used in the formulas in a function block diagram, regardless of whether you are on a different page from the design member symbol. The design member symbol is always located above the administration part on the first page of the function block diagram. Note that before using the Design Members command, you must create the design members with the Edit−>Formulas−>Create/Edit Design Member definitions command. When you select the Edit−>Design Members command, an editing dialog is displayed. See the example below.
Figure 29
Edit−>Design Members dialog
You can also display the same dialog by selecting the Edit−>Values command, but in this case you must be on the same page as the design member symbol and perform the Edit−>Values command on it. The dialog enables you to change the values of the design members used in formulas by entering the new value in the Value field, from which the value will be applied to the necessary objects in the function block diagram via the formulas. If a design member has a value formula, it is displayed in the Formula field. In this case, you cannot enter the value directly in the Value field. You can display the value formulas by clicking the Show Formulas button and hide them again by clicking the Hide Formulas button.
Rev. 4
44
7.2.5
FbCAD Manual
Formulas – Access to Formulas submenu By selecting the Formulas option from the Edit menu, you can go to the Formulas submenu. For more information on formula editing commands see Chapter 7.3 Edit −> Formulas – Formula Editing Commands.
7.2.6
Change − Changing values and properties The Change command allows you to change the properties of selected objects. It depends on the object type what changes can be made. The Change command can be used, for example, for changing the colour of a signal. To do this proceed as follows: Select the Change command from the Edit menu, and the command line will show: Select objects:
Select the signal(s) to be changed as usual (W, C and L options are also available). After selecting the signals, the change options will be displayed on the command line: Specify change point or [Properties]:
Select the properties to be changed by keying in ’P’ and . After this the command line will show some new options: Enter property to change [Color/Elev/LAyer/LType/ltScale/LWeight/ Thickness]?:
Select colour as the property to be changed by keying in ’C’ and . After this the tool will ask you for the new colour on the command line: If you have selected one object: New color :
the data inside the angle brackets contains the number and name of the old colour (if the colour has a name). If you have selected several objects: New color (varies):
Enter the new colour either by writing its number or its name. Press the right mouse button to end the command. NOTE! Names of signal colours are not necessarily the same as those used in CAD.
Rev. 4
Menu Bar
45
The following table shows the correspondences of signal types and colours to the colours and colour names used in CAD. signal type
signal colour
CAD colour name
CAD colour number
ana
green
green
3
anaev
dark green
dark green
124
bin
black
white
7
binev
brown
−
32
intl
blue
blue
5
intlev
orange
orange
30
ints
cyan
cyan
4
intsev
dark brown
dark brown
12
bo
magenta
magenta
6
fails
red
red
1
float
yellow
yellow
2
any
grey
−
8
For other features of the Change command see the CAD manual.
7.2.7
Edit − Access to Edit submenu By selecting Edit option from the Edit menu you can go to the Edit submenu. For more information on symbol edit commands see Chapter 7.4 Edit −> Edit− Symbol’s Editing Commands.
7.2.8
Copy − Access to Copy submenu By selecting Copy option from the Edit menu you can go to the Copy submenu. For more information on symbol copy commands see Chapter 7.5 Edit −> Copy − Copying Commands.
7.2.9
Move − Moving objects The Move command allows you to move function block diagram parts around. Select the objects to be moved in the usual manner (as in the Copy command). Set the base point for moving. Set another point where you want the object, in other words the base point to be moved to. Use the left button to paste the object. While picking the objects you can use options W(indow) and C(rossing), which should be specified on the command line after selecting the Move command. If the Ortho mode is on, parts can be moved only in horizontal or vertical direction.
7.2.10
Paste from clipboard You can use the Paste from clipboard to add a similar function block diagram part which is copied by the Copy to clipboard command, to the function block diagram. The command asks for the pasting point. The pasting point is shared by all the elements that are copied to the clipboard at the same time. After adding, the elements can be treated in a normal way. This command does not use the actual Windows clipboard.
Rev. 4
46
7.2.11
FbCAD Manual
Erase − Erasing objects from the function block diagram After giving this command point the mouse cursor at the object to be erased and click the left mouse button. To erase several objects pick them one at a time with the left mouse button. To end selections click the right mouse button. The objects will now be erased from the function block diagram. You can also use options W(indow) and C(rossing) for picking up the objects.
7.2.12
Erase Dot − Erasing connection dots The Erase Dot command erases a connection dot between two connection wires. When you select the command, the tool will ask you to show the connection dot (Show Dot).
After erasing the connection dot, only one unbroken connection wire will remain.
7.2.13
Stretch − Moving objects with their connections The Stretch command is similar to the Move command, with the exception that the connection lines to be moved turn to ”rubber bands”, so they stretch and move with the object. The limitation of this command is that the blocks cannot be stretched. The objects to be moved are selected by defining a window covering the area you want to move. When you select stretch the tool will ask you for the first corner of the window. First corner:,
After setting it with the left button you will be asked for the second corner: Other corner:,
Set the opposite corner with the left button. If you do not want to define several windows at the same time, press the right key to confirm the selections. If you want to define several windows, repeat the setting of corners as above. When the windows to be moved have been defined, you will be asked to give the base point for moving: Base point:
After setting it with the left button you will be asked to give the new base point, i.e. the point to which the area (its base point) will be moved. Set it as usual with the left mouse button. While you move the mouse around the display, the selected function block diagram objects will move with the mouse so that their connection lines will stretch with them.
Rev. 4
Menu Bar
7.2.14
47
Polyedit − Editing connection lines This command corresponds to the command Change, but it is used for editing connection lines. When you select the Polyedit command, the command line will show Select polyline:
This option lets you select the polyline object, i.e. connection line, to be changed. While selecting the object you can use the ’W’ and ’C’ and other options available for selecting objects. After you have selected the object, the tool will check if it is a polyline. If the object is not a polyline, the command line will display a message and you will be asked if you want to change the object to a polyline. Entity selected is not a polyline. Do you want it to turn into one?
If you answer ’Y’, the object will be converted into a polyline, which can then be edited in the usual manner using the Polyedit command. After selecting the polyline, the command line will show: Close/Join/Width/Edit vertex/Fit curve/Spline curve /Decurve/Undo/eXit :
You can select any of the listed functions. Particularly useful are: Join ’Join’ lets you join lines, arcs or other Polyline objects to either end of the selected Polyline. When you select the Join option the engineering tool will ask you: Select objects:
Here you can select the objects to be joined (including the polyline object). When you have selected the objects, the tool starts searching for a selected object whose end touches the polyline object, and joins this object to the polyline object. This procedure is repeated using the new polyline end, until the search fails. The object’s end must touch the polyline object precisely to be joined. If the line and the polyline form a T−joint, they will not be joined. The figure below shows an example illustrating the Join option: D
draw connection line B − D
connection line A
Rev. 4
connection line
B
C
48
FbCAD Manual
For instance, if you have drawn the connection lines A − B and C − D and want to join them, proceed as follows: Draw a connection line between points B and D. Select the Polyedit command and point the connection line between A and B. Select ’Join’ from the command line menu by keying in ’J’. Select all connection lines to be joined by keying in ’C’ and pointing a rectangle (picking window) at the symbols to be joined, and accepting the selection by the right mouse button. The number of segments joined to the polyline will be shown on the command line. Undo ’Undo’ allows you to cancel the effect of the last Polyedit operation. Using several Undos you can undo several Polyedit commands. eXit ’eXit’ lets you exit the Polyedit operations to the Command: prompt. Edit vertex ’Edit vertex’ can be used for editing one corner of the polyline. After a Polyedit command, if you select an object and then the Edit vertex (E) command from the polyline menu, the tool will mark the first corner of the polyline with an ’X’, after which a corner editing menu will be displayed: Next/Previous/Break/Insert/Move/Regen/Straighten /Tangent/Width/eXit :
Each feature can be given by just one letter. After a command is executed, the menu will reappear. In CAD, particularly useful options are: Next ’Next’ allows you to edit the next corner of the polyline, and moves the ’X’ character to the next corner.
corner to be edited Previous ’Previous’ brings you to the previous corner, and moves the ’X’ character to that corner.
corner to be edited
Rev. 4
Menu Bar
49
Break ’Break’ allows you to break the polyline. When you select the Break option, the current corner will be saved and a new menu will be displayed on the command line: Next/Previous/Go/eXit :
’Next’ and ’Previous’ allow you to move to the desired corner and then select ’Go’, which makes the polyline object into two polylines. All segments between the specified corners will be erased. If one of the corners is the end point of the polyline, you will get a shortened polyline object. NOTE! It is not possible to destroy the entire polyline by selecting both ends. If you change your mind about breaking the polyline, ’eXit’ allows you to interrupt the ’Break’ operation and return to the ’Edit vertex’ menu. Break Next
Next Next Go
Rev. 4
50
FbCAD Manual
Insert Using ’Insert’ you can insert a new corner in the polyline object. When you select the ’Insert’ option, the command line will show: Enter location of new vertex:
Specify the corner point to which the corner marked with 'X’ will be inserted. The figure below shows an example of inserting a corner in a connection line:
mouse cursor +
Next
+ mouse cursor
Next
+
mouse cursor
Go
Rev. 4
Menu Bar
51
Move ’Move’ allows you to move the corner of a polyline object to a new location. When you select the ’Move’ option, the command line will show: Enter new location:
Enter the new location for the corner, to which the corner marked with ’X’ is to be moved.
+
mouse cursor
Regen ’Regen’causes the polyline to be regenerated. This command is used together with the ’Width’ command. Straighten The ’Straighten’ option straightens the polyline between the specified corners. It stores the current corner, and the command line will show: Next/Previous/Go/eXit :
Options ’Next’ and ’Previous’ allow you to move to the desired corner and then select ’Go’ to destroy all polyline corners between the specified corners and replace them with a straight polyline. All segments between the specified corners will be erased. If you change your mind about changing the polyline, ’eXit’ allows you to interrupt the ’Straighten’ operation and return to the ’Edit vertex’ menu.
Next Next Next Next Go
Rev. 4
Next
52
FbCAD Manual
Width The ’Width’ option lets you change the width of the segment ends after the marked corner. After this selection, the command line will show: Enter starting width : Enter ending width :
Specify the values of the starting and ending points of the polyline. After entering the new data the polyline will not be automatically redrawn; use the ’Regen’ option to redraw it. The ’Width’ command can be used, for example, for changing arrowheads.
new starting width: 10 new ending width: 0 Regen
eXit ’eXit’ lets you exit the corner edit back to the Polyedit command menu. For more information of these commands see the CAD manual, PEDIT command.
7.2.15
Insert arrow − Inserting an arrowhead in a connection line Using the Insert arrow command you may insert an arrowhead in the connection line. After giving this command you will be asked to select the connection lines: Select objects:
The selected connection lines will be confirmed with the right−hand mouse button which marks the ends of connection lines with circles. The tool asks you to point at the end where you want the circle drawn Show arrow head point:
The above sequence is repeated until all selected connection lines have their arrowheads.
7.2.16
Delete arrow − Deleting arrowheads from a connection line Using the Delete arrow command you can delete arrowheads from the connection line. The connection lines are selected as above. The command deletes all arrowheads from selected connection lines.
7.2.17
Macro − Access to Macro submenu By selecting the Macro option from the Edit menu you can go to the Macro submenu. For more information on macro commands see Chapter 7.6 Edit −> Macro − Macro Commands.
7.2.18
Program − Access to Program submenu By selecting the Program option from the Edit menu you can go to the Program submenu. For more information on program commands see Chapter 7.7 Edit −> Program − Handling Commands of progc and prog2 Function Blocks’ Programs.
Rev. 4
Menu Bar
7.2.19
53
Comment symbol − Access to Comment symbol submenu By selecting the Comment symbol option from the Edit menu you can go to the Comment symbol submenu. For more information on comment symbol commands see Chapter 7.8 Edit −> Comment symbol − Comment Commands.
7.2.20
Page − Access to Page submenu By selecting the Page option from the Edit menu you can go to the Page submenu. For more information on page commands see Chapter 7.9 Edit −> Page − Page Handling Commands.
7.2.21
Purge − Purging the picture database The Purge option cleans unnecessary and erased graphic objects from the picture database. This command is necessary if the symbol has been changed and you want to insert a new symbol in the function block diagram. If you have not purged your file after erasing the symbol, CAD tool will get you the old symbol. Purge command is also useful after major revisions of the funtion block diagram. It erases unnecessary parts which may eat up a lot of space.
7.2.22
Show Object by Handle – Displaying an object related to an error You can use the Show Object by Handle command to help you in case of errors. The command shows the function block diagram object related to a handle. The handle is the code included in some error messages that indicates the erroneous object in the function block diagram. After selection of the command, the following is displayed on the command line: Give handle to highlight symbol:
Enter the handle included in the error message. The related object is indicated on the screen by dashed lines.
7.2.23
Cross References − Access to Cross References submenu By selecting the Cross References option from the Edit menu you can go to the Cross References submenu. For more information on cross reference commands see Chapter 7.10 Edit −> Cross References − Cross References Commands.
Rev. 4
54
7.3
FbCAD Manual
EDIT−>FORMULAS – FORMULA EDITING COMMANDS
Figure 30
7.3.1
Structure of the Edit−>Formulas submenu
Create/Edit Design Member definitions – Creating and editing design members All design members used in the formulas in a function block diagram must be specified using the dialog displayed with the Create/Edit Design Member definitions command.
Figure 31
Create/Edit Design Member definitions dialog
Rev. 4
Menu Bar
55
Enter the data for a new design member in the fields in the New attribute frame, and add them as a new line on the list in the dialog by clicking the Add button. The data items to be entered for a design member are:
Tag: The identifier of the design member, included in the formula.
Prompt: A description of the design member.
Value: The value of the design member. The value can be entered directly in this field or determined by a value formula. If the value is determined by a value formula, you cannot enter a new value in this field but need to use the Edit−>Design Members command.
Formula: The value formula that determines the value of the design member (in the Value field).
The easiest way to add new design member data to this dialog is by clicking the Find button, which retrieves all design members used in the formulas in the function block diagram and adds them to the list. Naturally, the formulas must be included in the symbols of the function block diagram before using the Find button. You can select a design member for editing by clicking one of its data items on the list. The dialog has the following buttons:
Highlight: Like the Edit−>Show Design Member Usage command, indicates the objects that use the selected design member.
Purge: Removes the design members not used in formulas from the list. You will be asked to confirm this decision before it is carried out.
Find: Retrieves the design members used in the function block diagram and adds the new ones to the end of the list in alphabetical order.
Up: Moves the selected design member up the list.
Down: Moves the selected design member down the list.
Delete: Removes the selected design member from the list.
When the Create/Edit Design Member definitions dialog is opened, a design member symbol with the standard text “Design Members:” appears above the administration part of the function block diagram to indicate that design members have been defined. For each line on the dialog list, an attribute is created to the design member symbol. But the only attribute shown in the symbol is $(TEMPLATE), i.e. the name of the used template.
Figure 32
The design member symbol above the administration part
The operators and functions allowed in formulas are presented in Appendix 3, “Functions Allowed in Formulas”.
Rev. 4
56
7.3.2
FbCAD Manual
Edit Formulas –Editing formulas You can use the Edit Formulas command to edit all the formulas in a function block diagram via one dialog.
Figure 33
Edit Formulas dialog
The first column in the dialog (Object Type) shows the type of the object attached to the formula, which is one of the following:
Attribute: only a value formula is possible. Block: only a function formula is possible. Text: either a value or a function formula is possible. Line: only a function formula is possible.
Other items that can be edited in the dialog:
Function Formula: The function formula whose truth value is used to determine whether a certain part of the engineering object is enabled or disabled. Prompt: A description of the design member. Value: The value of the design member. Value Formula: The value formula that determines the value of the design member (in the Value field).
If you want to remove the formula definition of an object, you can, for example, remove the formula from the Function Formula or Value Formula field in the Edit Formulas dialog. Save the change by clicking the OK button in the dialog. The formula line disappears from the Edit Formulas dialog. If you want to see the object to which a certain formula line is attached, choose the desired line and click the Highlight button. The object attached to the line is indicated by dashed lines in the diagram. Note that if an object is hidden by its function formula when Edit Formulas command is given, the object and its function formula will not be displayed in the Edit Formulas dialog. Before using the Edit Formulas command, select the View−>Function formula on/off command if you want to display also the hidden objects with their formulas in the dialog.
Rev. 4
Menu Bar
7.3.3
57
Attach/Edit Formula – Attaching and editing formulas You can use the Attach/Edit Formula command to attach a formula to selected objects. You can also use the command to edit a formula attached previously. After selection of the command, the following is displayed on the command line: Select objects:
Select the objects to which you want to attach the formula. The Edit Formula dialog is displayed. Enter the formula used to control the objects.
Figure 34
Edit Formula dialog
For example, if you enter the function formula $(IORACK)==PB in the Formula field, the objects attached to the formula are in use (and displayed in the function block diagram) when the value of the design member $(IORACK) is PB. If the value is something else, the objects are not displayed and the function is disabled. In case of a text type object, you can also use this command to attach a value formula to the object by unchecking the Function formula check box and entering the value formula in the Formula field. If you have selected an object of another type (attribute, block, line), the Function formula check box is grayed out and you can attach only a function formula. The operators and functions allowed in formulas are presented in Appendix 3, “Functions Allowed in Formulas”. An example of attaching a value formula to a text type object (comment text) If you want to display the value of the $(AFTFC) design member in a function block diagram in connection with the mtr function block, follow the instructions below:
Create a comment text to a desired location (under the mtr function block) with the Draw−>Comments−>Dtext command. It is not important what comment text is given unless it is not left out.
Give the Edit−>Formulas−>Attach/Edit Formula command and select the previously created comment text to be an object.
Uncheck the Function formula check box in the dialog.
Enter the desired value formula in the Formula field of the dialog.
Rev. 4
58
7.3.4
FbCAD Manual
Now, the value of the $(AFTFC) design member is displayed in the function block diagram as shown in the following figure:
FWizard – Replacing an attribute value with a formula You can use the FWizard command to find an attribute value and to replace it with the desired formula. This way, you can easily create a working template by changing a tested loop with a few FWizard commands. When you use the FWizard command, the following is displayed on the command line: Select objects:
Enter the objects in which the attribute value (character string) is to be searched for: either select individual objects with the mouse or enter All on the command line to search the entire function block diagram. Then enter the string to be found (and replaced): Find value:
Finish by entering the formula with which the string is to be replaced: Add formula:
When the command has been performed, the following message is displayed on the command line, with “x” indicating the number of formulas added: Added x formula(s).
Example: The DIRECT ACCESS PORT NAME attribute in the function block has the value pr:FIC−100, and you want to replace the value FIC−100 with the string $(TAG). You do this using the FWizard command, which finishes by telling you that one formula was added. This formula is of the format pr:$(TAG). In other words, the command searches for the attribute value, and if it is found, replaces it with a formula. If this command had been performed on the entire function block diagram, the following formulas would have been created:
7.3.5
pr:FIC−100.F −> pr:$(TAG).F pr:FIC−100.I −> pr:$(TAG).I pr:FIC−100.O −> pr:$(TAG).O pr:FIC−100 −> pr:$(TAG)
Initialize – Initializing formulas You can use the Initialize command to initialize all the formulas in a function block diagram in accordance with the design member values of the design member symbol. Note that synchronized values (denoted by “@”) are also initialized in accordance with the design member symbol. The command must be used when the function block diagram to be implemented has already been attached to the loop and when, for example, you change the $(MIN) or $(MAX) values in the design member symbol and want to change the synchronized initial values of the alarm limits, calculated on the basis of the changed values, to match the new values. Normally, when you change the value of a design member via the design member symbol, the synchronized values are not changed.
Rev. 4
Menu Bar
7.3.6
59
Show Design Member Usage – Displaying the objects attached to a design member You can use the Show Design Member Usage command to indicate the objects in the function block diagram that use the design member in question. The objects are indicated by dashed lines in the function block diagram. After selecting the command, you are prompted to enter the name of the design member: Give design member name:
For example, if you enter the design member $(MIN), this is usually used in the I/O symbol, the tag function symbol, and the history function symbol. Accordingly, these symbols will be indicated by dashed lines in the function block diagram after the command has been performed.
Rev. 4
60
7.4
FbCAD Manual
EDIT−>EDIT − SYMBOL’S EDITING COMMANDS Note that only the Fedit command affects the formulas of the function block diagram objects.
Figure 35
7.4.1
Structure of the Edit−Edit submenu
Gedit − Changing attributes globally The Gedit command is a very effective way of changing attributes in a function block diagram. When you select this command the tool will ask you to enter the attribute to be changed: Give string to change :
After it you will be asked for the new value: Give new string :
After getting these data CAD will automatically replace each old attribute with the new value. An example of using this command: When picking objects for the function block diagram from the menus, the tag identifier defaults to TAG_CODE, which you can quickly change into the correct tag identifier using the Gedit command. Pick all components belonging to the loop into the function block diagram; do not change the TAG_CODE in the dialog displayed when you pick the files. After selecting the components to the loop, give the Gedit command. You will then be prompted on the command line for the string to be changed. Type TAG_CODE and . (NOTE! The command is sensitive to upper and lower case characters, so TAG_CODE is not the same as tag_code.) Now enter a new identifier to replace the TAG_CODE string, such as LI−100 and . CAD will now automatically replace each TAG_CODE string in the function block diagram with the string LI−100.
7.4.2
Sedit − Changing attributes of selected blocks In other respects this command works in the same way as Gedit, but the tool first asks you to select the blocks whose attributes you want to change.
Rev. 4
Menu Bar
7.4.3
61
Aedit − Changing single symbol attributes The Aedit command lets you change the attributes of individual symbols in the function block diagram, using a sort of a line editor. For example, if the function block diagram contains an external output (see figure below)
select Aedit from the menu, then select an external output and accept the selections (by pressing or the right mouse button). The command line will show: 1. (1−3) EXT CONT OUTPUT NAME: ”pr:TAG_CODE:XX#”
You can move around the lines and edit the values. The cursor is now the number character (#). The numbers in parentheses on the first line indicate how many attributes the symbol has (this symbol has 3). The following commands are available for editing attributes: CTRL−V
Go to the symbol’s first attribute
CTRL−L
Go to the symbol’s last attribute
CTRL−P
Go to the previous attribute
CTRL−N
Go to the next attribute
CTRL−T
Quit. You can exit the editor also when you are in the first attribute and try to go to the previous attribute, or when you are at the last and try to go to the next attribute.
CTRL−F
One character forward
CTRL−B
One character backward
CTRL−E
Go to end of line
CTRL−A
Go to beginning of line
CTRL−R
Toggle replace/insert mode
CTRL−D
Deletes character at cursor
Backspace
Deletes character left of cursor
CTRL−O
Toggle plain text attribute echo ON/OFF. When it is off, the software will not request the attribute name in plain text, but shows its value directly. The toggle will be active only after selecting a new attribute or symbol (or reselecting the same symbol).
Rev. 4
62
7.4.4
FbCAD Manual
Fedit – Editing formulas In a function block diagram, you can use the Fedit command to edit formulas in the Formula column of different dialogs, either in all visible objects (symbol, text, connection line) at the same time (All) or in selected objects. If you want to edit formulas of the objects hidden by their function formulas, select the View−> Function formula on/off command before you start editing. Then also the hidden objects will be displayed and editable. The Fedit function performs the Find/Replace command on the objects. After selecting the command, you are prompted to enter the object to be changed: Select objects:
Enter All if you want to change the formulas of all objects at the same time, or select the desired objects with the mouse. Then enter the string to be found: Give formula string to change:
Finish by entering the new value for the string: Give new formula string:
The tool goes through all the objects selected and performs the Find/Replace function on their formulas. When the Fedit command has been performed, the following message is displayed on the command line, with “x” indicating the number of strings replaced: Replaced X string(s).
7.4.5
Tedit – Editing several texts at the same time You can use the Tedit command to edit texts in a function block diagram. Editable texts can be, for example, comment texts and connection dot specifiers but not attribute values. After selecting the command, you are prompted to enter the object to be changed: Select objects:
Enter All if you want to change the texts of all objects at the same time, or select the desired objects with the mouse. Then enter the string to be found: Give string to change:
Finish by entering the new value for the string: Give new string:
The tool goes through all the objects selected and performs the Find/Replace function on their texts. When the Tedit command has been performed, the following message is displayed on the command line, with “x” indicating the number of strings replaced: Replaced X string(s).
Rev. 4
Menu Bar
7.4.6
63
Eedit – Editing attribute values in Excel You can use the Eedit command to edit attribute values of all visible symbols or the selected symbols in Microsoft Excel. After selecting the command, you are prompted to enter the symbol to be changed: Select objects:
Enter All in the command line if you want to change the attribute values of all symbols at the same time, or select the desired symbols with the mouse. When all the symbols whose values you want to edit are selected, press the Enter key to continue. Edit the values in the appearing Excel table. In the following example, a table symbol has been selected:
Figure 36
Editing values in Excel table
Values in the Value and Formula columns can now be modified. When you have finished editing, the Excel table must be saved and closed. In the following FbCAD dialog, you can choose whether you want to copy the modified values from the Excel table back to the symbols:
Figure 37
Rev. 4
Read data from Excel
64
7.4.7
FbCAD Manual
Renum − Renumbering function blocks The Renum command automatically renumbers the function blocks belonging to the step. After selecting the command the tool will ask you to enter Begin value :
After this the tool will ask you to enter the increment. (If you specify 1, the function blocks will be numbered 1, 2, 3 etc. If you specify 2, the function blocks will be numbered 1, 3, 5 etc.) Step value :
Next the tool asks which function blocks you want to renumber: Select: renumber All, Page, New order (default action):
The All option renumbers function blocks of all function block diagram pages. The Page option renumbers function blocks of the active page only. After the New order option, the tool asks you to select the function blocks which you want to renumber. You should select them in the same order as you want them executed in the step. In selecting function blocks you can use the same methods as for selecting objects (Window, Crossing etc.).
7.4.8
ChBlk − Changing of symbols A symbol may be changed to another symbol by using the ChBlk command. Either one or several symbols can be changed at the same time. All the symbols that are to be updated have to be of the same type. NOTE! Do not use ChBlk command for table type symbols. The ChBlk command updates the values of the old symbol to the new symbol. If the value doesn’t exist in the new symbol it is not updated. The values that exist only in the new symbol have their default values. Symbols to be changed are usually selected by mouse.
Click the old symbol(s) by mouse. If you have selected only one symbol you are asked if you want to change that one or all the symbols of the same type: Do you want to change all blocks of the same type (y/n) :
If you have clicked several symbols only the selected symbols are changed.
Click the new symbol by mouse.
Alternatively, you can select the symbols to be changed by pressing the key and entering the symbol name from the keyboard (for example AM_IN) on the command line. In the function block diagram, all symbols of the same type are changed at the same time.
Rev. 4
Menu Bar
7.4.9
65
UpdBlk − Updating of symbols A symbol may be updated to its newer version by using the UpdBlk command. UpdBlk always updates all the symbols of the same type in the function block diagram. NOTE! Do not use the UpdBlk command for table type symbols. The UpdBlk command updates the values of the old symbols to the new symbols. If the value doesn’t exist in the new symbol it will not be updated. The values that exist only in the new symbol have their default values. The UpdBlk command always requests selection by mouse, but selection may also be given by name.
Click the symbol you want to update by mouse or press and give the symbol name from the keyboard (for example AM_IN).
Enter an asterisk (*) on the command line if you want to update all the symbols of a function block diagram at the same time.
7.4.10
Edit text – Editing texts one at a time You can use the Edit text command to edit a text in a function block diagram. After selecting the command, you are prompted to select the text to be changed: Select an annotation object or [Undo]:
Select the desired text with the mouse and the following dialog will be displayed:
Edit the text and accept the change by clicking the OK button. If you prefer not to change the text, click the Cancel button. Next, the tool asks for the another text to be edited. Follow the instruction above or press the Enter key to stop editing the texts.
Rev. 4
66
7.5
FbCAD Manual
EDIT −> COPY − COPYING COMMANDS
Figure 38
7.5.1
Structure of the Edit−Copy submenu
Copy Symbol − Copying function block diagram parts The Copy Symbol command allows you to copy parts of the function block diagram. Point the mouse cursor at the object to be copied and select it with the left button. If you want to copy several objects at one time, select all objects with the left button and finally confirm the selections with the right button. You should notice that if the ’Ortho’ feature is on (the word Ortho on the status line) you can copy objects in horizontal and vertical direction, not diagonally. While picking the objects you can use the options W(indow) and C(rossing); write them on the command line after selecting the Copy command. If the selected objects are copied only once (to one place), use the left mouse button to specify the base point (grabbing point), used for locating the object when copying. Then point the place where you want to paste the object and fix it there by the left mouse button or . If you want to copy the object to several places, proceed as follows: Select the objects to be copied as usual with the left button and end the selections with the right button. After this type the character ”m” followed by (or right button). Set the base point with the left button, point the place where you want the copy to be inserted and paste the copy with the left button. Now select another point and paste the copy to it, until all copies have been placed. End copying by clicking the right mouse button or by pressing the Enter key.
7.5.2
Copy to clipboard You can use the clipboard commands to copy function block diagram parts to another similar function block diagram. The command is useful when you don’t want to make the function block diagram part a permanently saved macro or symbol. The command asks you to select the elements to be copied. You can select the elements one by one or by window etc. If the function block diagram has more than one pages, you cannot use the selecting method ”ALL”. Therefore the paginating engineering tools show a warning dialog before the selecting. After the selection confirmation pasting point is asked for, and after this the elements are copied to the clipboard. Every time the Copy to clipboard command is performed, the previously copied elements are destroyed. The elements are not destroyed in the function block diagram during copying. Please do not use this command with tables. The command does not use the actual Windows clipboard, so the copied information will not be available in other Windows software.
7.5.3
Copy Image You can use the Copy Image command to copy figures or parts of figures to the Windows clipboard. The software’s own Paste command can add the figure from the clipboard to some other Windows software. You cannot add a figure copied by this command to the CAD based engineering tool.
Rev. 4
Menu Bar
7.6
67
EDIT −> MACRO − MACRO COMMANDS The menu contains commands that allow you to pick parts of the displayed function block diagram, give them a name and store them in the macro directory. You can list the contents of the macro directory, call macros from it to the same function block diagram or to other function block diagrams. You can also delete macros that are no longer needed. The structure of the MACRO menu is as follows:
Figure 39
7.6.1
Structure of the Edit−Macro submenu
Make − Creating a macro Using the Make command you may combine displayed parts of the function block diagram into an entity and store it in the macro directory on the disk. When you select the Make command, you will be asked: Enter name for macro: ,
answer by giving the name under which you want the macro to be stored, and press . The tool refuses to make a macro at this point, if a macro by the same name exists. After naming the macro you will see the following message on the command line: Select objects: ,
indicating that you can pick the objects to be included in the macro using the mouse. Pick the objects using the additional options for object selection (W or C) or the rectangular mouse cursor so that any text or line belonging to the object will be inside the rectangle. Then press the left mouse button to select the object. If the selection was successful, the command line will show: 1 selected, 1 found,
if no objects could be found inside the rectangle, the command line will show: 1 selected, 0 found.
After picking all objects, press the right mouse button to accept the selections. After this the command line will show: Insertion point for macro: ,
waiting for you to specify the point in the macro that will stick to the mouse cursor when the macro is retrieved.
Rev. 4
68
7.6.2
FbCAD Manual
Insert − Inserting a macro in the function block diagram Using the Insert command you can add the macro in the macro directory to the function block diagram. When you pick the command from the menu and the macro is in the directory, a selection dialog will appear. You can select the required macro from the selection dialog list. The last selected macro appears highlighted.
Figure 40
Macro selection dialog
The macro will stick to the mouse cursor at the point that was defined as the insertion point for the macro. You can now move the macro around the screen with the mouse and paste it using the left mouse button. If there are no macros in the directory, you will see the following notice instead of the selection dialog:
Figure 41
Dialog, if macros didn’t exist
Rev. 4
Menu Bar
7.6.3
69
Delete − Deleting a macro from the directory Using the Delete command you can delete macros in the directory. You can select the macro you want to destroy from the selection dialog, or you can cancel the command.
Figure 42
Macro selection dialog
If there are no macros in the directory, you will see the following notice instead of the selection dialog:
Figure 43
Rev. 4
Dialog, if macros didn’t exist
70
7.7
FbCAD Manual
EDIT −> PROGRAM − HANDLING COMMANDS OF PROGC AND PROG2 FUNCTION BLOCKS’ PROGRAMS Using the Edit−Program command you can handle the programs of progc and prog2 function blocks which are written in list form (Java). With these commands it is possible to copy the program written in list form to the progc or prog2 function block, edit it or delete it from the function block. Additional information of progc and prog2 function blocks and their programming can be found in documents ’Progc Function Block Manual’ and ’Prog2 Function Block Manual’. The structure of the Program menu is as follows:
Figure 44
7.7.1
Structure of the Edit−Program submenu
Attach program − copying the program written in list form to the progc or prog2 function block This command copies the program written in list form to the progc or prog2 function block. Progc and prog2 function blocks are freely programmable blocks which are written in list form. After the command the program which will be copied is chosen from the following dialog:
Rev. 4
Menu Bar
71
If you try to copy another program written in list form to the progc or prog2 function block, FbCAD does not allow it but gives the following dialog:
7.7.2
Edit program − editing the list form program of the progc or prog2 function block With this command you can edit the list form program which is copied to the progc or prog2 function block. The program is fetched to the default text editor. Note that when saving the program, no changes are allowed in the name of the modified file.
7.7.3
Delete program − deleting the program written in list form from the progc or prog2 function block This command deletes the program of progc or prog2 function block.
7.7.4
Edit prog2 − editing the symbol of the prog2 function block With this command you can edit the members and parameters of the prog2 function block symbol. Additional information on this subject can be found in document ’Prog2 Function Block Manual’.
Rev. 4
72
7.8
FbCAD Manual
EDIT −> COMMENT SYMBOL − COMMENT COMMANDS The comments menu contains texts, boxes and other similar components for the comments layer. The structure of the comments menu is as follows:
Figure 45
7.8.1
Structure of the Edit−Comment symbol submenu
Make − Creating symbol The command lets you compose function block diagram components (lines, texts, etc.) into a symbol, which is stored on the disk under a name under which it can be later retrieved. After selecting this command you will see the following question: Enter name for symbol:
Type a name for the symbol. At this point the tool refuses to make a symbol that has the same name as an existing one. After this you will be asked to select the components to be included in the symbol. Accept the selections by pressing or the right mouse button. The tool will then ask you to enter an insertion point for the symbol.
7.8.2
Insert − Inserting comment symbol The Insert command lets you retrieve a symbol stored on the disk into the function block diagram. After the command the symbol can be selected with selection dialog.
Figure 46
Selection dialog
Rev. 4
Menu Bar
73
If there are no symbols in the directory, you will see the following notice instead of the selection dialog:
Figure 47
7.8.3
Dialog, if symbols didn’t exist
Delete − Deleting the comment symbol The Delete command lets you delete a symbol stored on the disk. After selecting the command you can select symbol with selection dialog.
Figure 48
Selection dialog
If there are no symbols in the directory, you will see the following notice instead of the selection dialog:
Figure 49
Rev. 4
Dialog, if symbols didn’t exist
74
7.9
FbCAD Manual
EDIT −> PAGE − PAGE HANDLING COMMANDS You’ll find the page handling commands in the Edit−Page menu. Copying and moving items from one page to another is allowed only with these commands. You are not allowed to use the other Edit menu commands although several pages were open on the display at one time. Use View−Select Page commad to select page.
Figure 50
7.9.1
Structure of the Edit−Page submenu
Create − Creating new pages The Create command is used for creating new pages in the function block diagram. You may create new pages anywhere, not only after the existing pages. One function block diagram may include more than one continuous control and its administration part. While the function block diagram still contains only one page, the tool will ask you the number of pages: Engineering object consists of 1 pages. How many new pages? (max 51) Give 0 if you want to change pagesize. After page ? (0−1)
After this you will be asked about the size of the pages to be created Page size − select: 1. Normal pages 2. Mid pages 3. Big pages
Suppose you created 4 normal size pages and want to create some new pages. Select the Create command to get the following question Engineering object consists of 4 pages. How many new pages? (max. 48) After page ? (0−4)
Now the created pages are of the same size as the old ones and the administration part tells that the page is an extension part of the function block diagram. Page size (one−page function block diagram) may be altered by giving zero (0) as the number of pages to be created. Then the tool asks for page size as explained above.
7.9.2
Copy Item To − Copying objects to another page Command allows you to copy a part of the function block diagram (active page) to another page (to passive page). You will be asked about the part to be copied and the page to which it is to be copied: Number of page where objects will be copied? (1−n)
(n is the number of pages in the document) The new page will remain active. Otherwise this function is similar to the Copy command.
Rev. 4
Menu Bar
7.9.3
75
Move Item To − Moving objects to another page Command allows you to move a part of the function block diagram (active page) to another page (to passive page). You will be asked about the page to be moved and the page to which it is to be moved. Number of page where objects will be moved? (1−n)
(n is the number of pages in the document). The new page will remain active. Otherwise this function is similar to the Move command.
7.9.4
Delete − Deleting a page Using the Delete command you can delete any page of a multi−page function block diagram. You will be asked to confirm the deletion. When you have given the Delete command, the display will show the page to be deleted, and the command line will show: Which page do you want to delete ? (1−n) Page n is the page to be deleted. Do you really want to delete it ? (y/n)
7.9.5
Verify − Verifying the location of symbols The Verify command allows you to check if all symbols on the function block diagram pages are in the right coordinate areas. This is necessary because each page is assigned separate layers (design and comments layer) and coordinate areas, within which the symbols and graphic objects of that page must be located. If the symbols are in the right areas, the command line will display the following message: No errors detected.
If objects are found from the wrong areas, you will be told the wrong pages and the coordinates of the wrong objects in them. This data allows you to locate errors and correct the function block diagram. Following is an example of an error listing: Error in page 2 − point 135,665 Error in page 2 − point 455,640 Error in page 2 − point 215,315
The page number shows the page containing the error, and the coordinates indicate the location of the mislocated object. The error listing will be shown in text window; pressing F2 will bring you back to the graphic window.
7.9.6
Freeze − Freezing the pages not currently displayed The Freeze command lets you ’freeze’ all pages in the function block diagram except the one that is currently displayed. The tool will not regenerate the frozen pages, for example, when zooming the function block diagram, which will speed up commands requiring a regeneration. When you activate a frozen page using the Select Page command, the page will ’melt’ automatically while other pages remain as they were.
Rev. 4
76
7.10
FbCAD Manual
EDIT −> CROSS REFERENCES − CROSS REFERENCE COMMANDS Cross reference commands make it possible to create a list of other engineering objects which use the specified port (direct access port or interface port) in the function block diagram. In a function block diagram, a cross reference list is added at a point defined by an anchor, which is connected to the port. User can define this anchor to the function block diagram himself or let the tool place the anchor and the list. The query is made from the repositories of the engineering servers (EAS). These engineering servers (EAS) are defined in Settings Editor. The best benefit of these commands is achieved if the location of anchors can be defined when the function block diagram is being created. Old function block diagrams may not have enough space for the lists and then the lists are output on top of other existing elements. The structure of the Cross references menu is as follows:
Figure 51
7.10.1
Structure of Edit−Cross references submenu
Insert Anchor Up − Inserting an anchor (output upwards from a point) An anchor is set to a function block diagram with the Insert Anchor Up command. When a cross reference list is generated later, the list will be output upwards from the location of the anchor. When the Insert Anchor Up command is chosen, the tool asks to choose the symbol, which contains the port. It may be a separate direct access or interface port or a function block with a direct access port: Select symbol:
Next you will be asked the anchor insertion point: Insertion point:
An anchor can be defined at any point in a function block diagram. The name of a port is shown below the anchor.
Figure 52
An example of an anchor connected to a port
An anchor, or a symbol containing a port, can be moved afterwards from one point to another with the Move command. If the symbol is removed, the anchor is useless and it is deleted when a cross reference list is generated next time. Each port can have only one anchor.
Rev. 4
Menu Bar
7.10.2
77
Insert Anchor Down − Inserting an anchor (output downwards from a point) The Insert Anchor Down command is like the Insert Anchor Up command except that the cross reference list is output downwards from the defined point when the list is generated.
7.10.3
Show Anchors − Showing anchors Sometimes it is necessary to know which anchor is connected to a certain port. When the Show Anchor command is given a red line is drawn between the anchor and the port showing that those two belong together. The lines will disappear when the function block diagram is updated next time (View−Redraw).
7.10.4
Get References− Generating a cross reference list This command generates a cross reference list, this is, a name list of engineering objects which use a certain port is fetched from the repository or workspace. First you will be asked: Get reference to: 1:Anchor. 2:Selected ports. 3:All ports.
Option 1 generates cross reference lists for ports containing anchors. Option 2 generates lists for selected ports and option 3 generates lists for all ports. The query is made from the default engineering server (EAS) but a query from several engineering servers (EAS) is also possible. The default server and other possible servers are defined in the Settings Editor.
Locating the list to the function block diagram After a successfull generation the cross reference list is added to the function block diagram starting from the point where the anchor is defined. If no anchor is defined the tool starts searching for empty space and then places an anchor and the list there. The searching order is as follows: 1.
Above the port
2.
Above the port on left side
3.
Below the port
4.
Below the port on left side
5.
On the left or right side of a page depending on which side is closer to the port.
6.
On the other side of the page (right or left)
If there is no empty space the tool places the list above the port. When the tool locates the list it also defines an anchor to that point. So next time the anchor exists and the cross reference list is output into the same point. Note that after generating it is possible to move the list and the symbol containing port freely with the Move command.
Rev. 4
78
FbCAD Manual
Contents of cross reference list A cross reference list contains the possible specifier or the name of the member and also the engineering object identifier which uses the port. If a port is used only in an independent configuration function (there is no design function), the identifier of the configuration function is in parenthesis. If several engineering servers (EAS) are used, there is an engineering server name in parenthesis after the engineering object identifier. Cross reference lists are presented in alphabetical order as the following example shows:
Figure 53
An example of a cross reference list generated to the function block diagram
If the list does not contain specifier, the engineering object uses the whole port. Often the port is used also e.g. in event and operation functions but usually they are not of interest. The default is that there is no engineering object identifier in the cross reference list if the prefix of the configuration function identifier is ’al:’, ’od:’, ’mw:’ or ’gd:’. This list of prefixes can be changed with the help of Exclude prefix list definition in Settings Editor.
Updating cross reference lists to the function block diagrams It is recommended to locate the anchors of the cross reference lists when creating the function block diagram. However, the generation of the cross reference lists is better to execute only after all the function block diagrams are ready. It is recommended to use the SCRIPTALL command with which the same operation can be made to a whole group of function block diagrams. Additional information of the SCRIPTALL command can be found in the metsoDNA CR Maintenance Manual. There are two ready−made functions in the FbCAD and the SeqCAD with the help of which the generation of cross reference lists will succeed when using the SCRIPTALL command. These functions are the following: (fb−get−refs−to−ports) Function generates the cross reference list to all the ports of a function block diagram. The list is added to the anchor of each port. If no anchor is defined the tool starts searching for empty space and then places an anchor and the list there (see chapter 7.10.4 Locating the list to the function block diagram). (fb−get−refs−to−anchors) Function generates a cross reference list to the function block diagram for all the ports which have an anchor defined. The following is an example of a script which is executed when using the SCRIPTALL command: (load “getext”) (fb−get−refs−to−anchors “referr.txt”)
In the above example a list of engineering objects is created into the file referr.txt. These are the engineering objects which caused error messages while generating the cross reference lists.
Rev. 4
Menu Bar
79
The generation and updating of the cross reference lists can be set to be executed automatically each time a function block diagram is opened by setting the Update variable to state 1 or 3 on the WDS tab of Settings Editor. The fuctions of the states are: 1 = Cross references are updated above or below the anchors of the function block diagram. 3 = In addition to updating cross references, anchors are added to each port of the function block diagram.
7.10.5
Make query − Making own query If you want to make a cross reference query, but you do not want to add a list to the function block diagram, the query can be made with the Make query command. First you will be asked: Enter external query:
A port name is inserted (e.g. ’pr:06K0001J1’ or ’pr:06K0001J1.F:out1’ ).
7.10.6
List References− Printing the cross reference lists All ports and cross reference lists can be listed with the List References command. The list can be printed as well.
Rev. 4
80
7.11
FbCAD Manual
View − DISPLAY HANDLING COMMANDS Items in the View menu are used for display handling, such as zooming. With these items you can also determine which page and drawing layers of the function block diagram are visible on the display.
Figure 54
7.11.1
The structure of View pull−down menu
Redraw − Redrawing the function block diagram Redraw command draws the displayed function block diagram again. The command is useful for cleaning up any ’remains’ left by CAD from the display.
7.11.2
Redraw All − Redrawing all windows Redraw command affects to the window being used. If all windows need to be redrawn use Redraw All command.
7.11.3
Regen − Redrawing the function block diagram Regen command clears the display and redraws the displayed function block diagram. This command is useful if you have been doing a lot of editing, and there are too much ’remains’ in the function block diagram.
Rev. 4
Menu Bar
7.11.4
81
Zoom Window − Zooming the contents of a window The Zoom Window command lets you pick an area to be magnified. After selecting this command you will see the following question on the command line: First corner:
Point the mouse at the desired spot in the function block diagram, and select the first corner with the left button. After that you will be asked for the other corner: Other corner:
Move the mouse cursor to the other point and select this opposite corner with the left button. The display will now be cleared and the area zoomed over the whole display. If a wheel mouse is used, the function block diagram can be zoomed also by rolling the wheel.
7.11.5
Zoom Dynamic − Dynamic zooming Zoom Dynamic command gives you a ’snapshot’ of the whole drawing area and lets you select an area of desired size for a closer examination. To adjust the size of the area click the left button and start moving the mouse. Click the left mouse button again to accept the size and press the right button to zoom in the area inside the white frame. Red corners on the display show the borders of the drawing. If you go beyond these borders, the function block diagram will be generated anew.
7.11.6
Zoom Previous − Redisplaying the previous view This item allows you to view the previous view. metsoDNA CR always memorizes a few views, so by repeating this command you can, for instance, revoke the view before the three last zooming operations. Do not use this command for page selecting.
7.11.7
Zoom All − Zooming out to the whole function block diagram The Zoom All command brings the whole function block diagram to the display. If it is a multi−page function block diagram, you will see all pages in the same picture. However, you are not advised to edit the function block diagram in this mode, because the pages are situated on different layers under CAD. If you make changes, they may go to the wrong page.
7.11.8
Zoom Extents − Zooming out to full function block diagram The Zoom Extents command brings all objects in the function block diagram to the display as large as possible.
7.11.9
Pan − Scrolling the function block diagram With the Pan command you can scroll the function block diagram. To scroll the function block diagram select Pan in the menu with the left mouse button. The arrow cursor changes to a hand cursor to show that the Pan command is selected. Press the left mouse button down and move the mouse to the desired direction to move the function block diagram to the same direction. When the mouse button is released the scrolling ends. The Pan function stays active until it is ended with Enter or Esc key. If a wheel mouse is used, the function block diagram can be scrolled also by keeping the wheel down and moving the mouse.
Rev. 4
82
FbCAD Manual
7.11.10 Previous Page – Selecting the previous page In multi−page function block diagrams, you can use the Previous Page command to move to the previous page, i.e., activate it.
7.11.11 Select Page − Selecting the active page The Select Page command lets you move to the desired page and activate it. You will be asked for the page: Page number? (1−n)
(n is the number of pages in the document).
7.11.12 Next Page – Selecting the next page In multi−page function block diagrams, you can use the Next Page command to move to the next page, i.e., activate it.
7.11.13 Show error list − Listing of error messages Using the Show error list command you get a listing of error messages.
7.11.14 Errors on/off − Showing/hiding the error messages Enables or disables the graphic indication of errors in the function block diagram. When you start CAD the error mode defaults to Errors on, which means that after a check graphic errors will be shown on their respective drawing layers. The function block layer is displayed at the same time. It allows you easily to locate errors in the function block diagram. If you do not want graphic error indication after a check, the Check command must be preceded by an Errors on/off command to disable graphic error indication (by setting the variable to OFF). Later on you can switch the variable back ON using the same Errors on/off command. As a result, the errors will be displayed in the function block diagram after the check. The command status is indicated by the mark.
7.11.15 Comments on/off − Showing/hiding the comments layer Use the Comments on/off to view the comments layer at the same time with the design layer. Operations will still affect the design layer only. This command toggles between two function block diagram modes. In other words, you can select it again to hide the comments layer. The command status is indicated by the mark.
7.11.16 Function Formulas on/off – displaying or hiding objects hidden using a function formula You can use this function to display or hide all the objects that have been hidden using a function formula. The command status is indicated by the mark.
Rev. 4
Menu Bar
83
7.11.17 Cross References on/off − ’Crossref’ drawing layer on/off With Cross References on/off command CROSSREF drawing layer is toggled on or off. Cross reference lists are on that drawing layer. Occasionally the lists must be generated to a very full function block diagram and then lists may be located on top of already existing elements. By using the Cross References on/off command it is possible to hide the cross reference lists. By selecting the same command again the lists are displayed again. The command status is indicated by the mark.
7.11.18 Text window This command brings the text window to the display. Text window is an extended version of the command line. The text window shows messages and you can give commands as well as edit them. It is possible to copy commands from the command history of the text window and paste them on the command line to be executed. These Copy and Paste commands can be selected by clicking the right mouse button on the command line. The text window can be brought to the display also with the F2 key.
Rev. 4
84
7.12
FbCAD Manual
Draw − DRAWING COMMANDS The Draw menu contains commands for connecting function blocks and data points and commands for drawing comment symbols.
Figure 55
7.12.1
Structure of the Draw pull−down menu
Scalar autocolor wire − Drawing the scalar connection lines by using the autocolor function Using the Scalar autocolor wire command you can draw a connection line which is colored according to the start point. If the start point is, for example, an output of type ana or a connection line of type ana, the color of the connection line will be green.
7.12.2
Scalar wires − Drawing the scalar connection lines To select a command place the mouse cursor on the desired wire command on a Scalar wires submenu and press the left mouse button. After this use the left mouse button to specify points through which you want the line to go. After the last point press the right mouse button. The tool ends the connection line with an arrowhead if the arrowhead draw has been activated (see command Arrow ON/OFF). The arrowhead will be inserted to the last defined point of the connection line. You can also add an arrowhead or remove it from the connection line afterwards (see Edit menu commands Insert arrow and Delete arrow). The Scalar wire command allows you to make a connection of the desired colour (type) by drawing a connection line between the points to be connected. The colour coding has been designed to help the user avoid making connections between signals of different type (for example, between analog and binary types). The colour does not affect the generated connection, but only illustrates it. The principle governing the drawing of connection lines is that a line only connects the connection dots at the beginning and end of the line. Consequently, connection lines may cross without being connected. Another important thing about connection lines is that only one line should be connected to each symbol’s (e.g. function block, port, local data point) connection dot.
Rev. 4
Menu Bar
85
The colour coding of signal types is as follows:
7.12.3
ana, analog signal anaev, analog signal with a time stamp bin, binary input binev, binary input with a time stamp float, floating point number intl, long integer intlev, long integer with a time stamp ints, short integer intsev, short integer with a time stamp bo, binary output fails, fault bit data general type
= green colour = dark green colour = black colour = brown colour = yellow colour = blue colour = orange colour = light blue colour = dark brown colour = violet colour = red colour = grey colour
Reroute − rerouting of a connection line Use the Reroute command to change the route of a connection line so that it does not go through the elements added in the function block diagram. For example, in the following figure there is a disb function block added on the route of a connection line.
By selecting the Reroute command and pointing at the connection line, the route of the connection line is rerouted so that the route does not go through the disb function block.
With this command you can also select several connection lines to be rerouted at the same time.
7.12.4
Autowire − Drawing a scalar connection line by using the automatic functions The Autowire command is used for drawing a connection line so that its route does not go through the elements added in the function block diagram. After selecting the command, specify the start and end points of the connection line and the connection line will be drawn automatically. The color of the connection line is automatically determined by the start point. If the start point is, for example, an output of type ana, the color of the connection line will be green. The Autowire command is applicable only for scalar types, not for table types.
Rev. 4
86
7.12.5
FbCAD Manual
Arrow ON/OFF − Arrowhead drawing control This command lets you enable/disable arrowheads. The status is indicated by the
7.12.6
symbol.
Dot ON/OFF − Connection dot drawing control This command lets you enable/disable connection dots. The status is indicated by the
symbol.
If the connection dot drawing control is On while drawing connection lines, a connection dot is inserted automatically to the start and/or end points of the connection line if the start and/or end point starts from or ends to another connection line. The following figure shows an initial situation of the example:
With the Scalar autocolor wire or Scalar wires −> ana command, draw a connection line whose start point (1) is on the connection line between the two function blocks and the end point (2) is the reference point A.
As a result, a new connection line and a connection dot will be created.
Rev. 4
Menu Bar
7.12.7
87
Insert Dot − Drawing a connection dot Signals can be connected using a connection dot. Select the command from the menu, and then select the point where the lines cross (T−joint, crossing or a point for extracting a part signal by means of a specifier). When you press the left button, the lines will be ”cut” at the point and ”soldered” with a soldering dot or donut. Setting the connection dot The following Figure (Figure 56) shows examples of using a connection dot: T-joint: Local data point P1
connection dot Crossing:
Extracting a part signal by a specifier: bo-type connection line Figure 56
connection dot bin-type connection line
Ways of connecting signals
Two intersected connection lines can be ’soldered’ together by adding a connection dot at the crossing. Correspondingly, a T−joint can be connected by placing a connection dot at the joint. Joining or ’soldering’ two connection lines together is accomplished with the command dot. Only connection lines can be joined with a connection dot − no connection dots are needed with function blocks, ports and data points.
Rev. 4
88
FbCAD Manual
Here is an example of a logical use for a connection dot (Figure 57 An example of signal connections): To connect the function block 2vlv member dpos to the 1pid member con, and then connect one line from the newly made connection line to the 1pid member pos. Draw a soldering dot on the T−joint of the lines to connect the members of dpos, con and pos. If the connection lines cross but there is no connection dot at their intersection, there is no connection between the signals. (In this example the connection line from the 1pid member conb to 2vlv member idpos and the connection line from the 1pid member con to 2vlv member dpos are not connected, although the connection line starting from the 1pid member pos crosses the connection lines.)
connection dot
no connection between signals
Figure 57
An example of signal connections
If the connection dot representing the connection does not appear, use a select command (i.e. type Select in the command line and press ), after which you can select connection lines coming to the crossing (crossing/T−joint) by the mouse cursor. If the connection lines have already been defined as separate, the connection cannot be made, but some lines must be removed and redrawn to make the connection possible. If you do not succeed to select existing connection dot by clicking with a mouse, zoom the dot symbol and try again.
Rev. 4
Menu Bar
7.12.8
89
specifier :spe_| | − Connection dot specifier to the left Using the Specifier :spe_I I command you can specify the connection to a member. Use this command as follows: Select the command and point the mouse at the spot you want to specify. Now you can enter the specifier text. Specifying means that you extract a part of the connected data (signal/type) such as fails bits. This is useful when you do not need the whole signal but part of it. The menu option causes the CAD TEXT command to set the end point of the text 3 units up and 3 units left of the specified point. Example (Figure 58): if you have connected the 1ccoa function block signal out to the 2fbor function block’s fainp1, then 1ccoa member out is of the type ana (analog) and 2fbor’s fainp1 is of the type fails (fault bits). This connection requires fault bit data, which is the ana member f. So you must assign the connected port fainp1 the specifier :f. Here is what you do: you select the item Specifier :spe_I I (specifier to the left), set the connection dot for 2fbor member fainp1 and enter the specifier text :f.
signal is type ana
signal is type fails Figure 58
Rev. 4
An example of specifying a connection
90
FbCAD Manual
The following Figure (Figure 59) shows an example of a more complicated signal specifier. This example illustrates how to specify a signal connected to an interface port and how to specify a certain member of an array.
Figure 59
An example of using a signal specifier
You cannot specify an interface port (in1, in2) directly; instead you will have to specify the signal at the input of the function block connected to the interface port (1ccofl:in and 5ccofl:in). In order to specify a member of an array: Draw connection lines from the array outputs (1ccofl:out and 5ccofl:out) to an array type input (10tfunf:xtbl) through a local data point (P1). The local data point is set to given array dimension and initialized to the desired number of array members. At an output for writing to an array member (1ccofl:out and 5ccofl:out) specify the member (1, 2), to which the output should write.
7.12.9
specifier | |_:spe − Connection dot specifier to the right The Specifier I I_:spe_ command is similar in operation with Specifier :spe_I I, but the specifier text will be placed on the right. This menu command uses the CAD TEXT command to place the end of text 3 units up and 3 units right from the defined point. If the specifying does not seem to be successful, the function block diagram may be too crowded, and the specifier may join the opposite connected object. In this case you will get an error message, for example that there is a missing bv member for a bin type. Now the function block diagram must be corrected by moving the object to be connected further from other objects or at a different height, so that the specifier will have no chance to join the wrong object.
Rev. 4
Menu Bar
91
7.12.10 Add reference... − adding a reference point A reference point is used to enable signals that belong to the same function block diagram but are located on different pages to be connected.
page 1 Figure 60
page 2
An example of reference points at different pages
Reference points work in the same way as a direct connection made with a connection line. One function block diagram may contain several reference points of the same name, in other words, you can branch signals using reference points, provided that the signal type does not change. There are six types of reference points to choose from in the icon menu that is displayed. These differ from each other in the shape of the symbol (circular/rectangular) and the location of the connection point (above, below, on the left−hand side, or on the right−hand side of the symbol). You must assign each reference point a unique name (such as ABC). Only reference points with the same name are connected. You can also assign a reference point a two− line comment, which is displayed next to the reference point but does not affect its operation.
page 4
page 1
page 6 Figure 61
Rev. 4
An example of signal branching
92
FbCAD Manual
A reference point is useful, for example, for branching an external input signal in a function block diagram as shown in the next figure. Here the reference point will be connected to the connection line with a connection dot (DOT).
Figure 62
An example of a reference point in a connection line
Reference points can also be used within one page, for instance, for very large and complicated function block connections. When a reference point is added, the command displays on the command line a list of references used in the function block diagram and draws reference−specific colored lines between the existing reference points. With the help of the reference list, you can easily add new references and use previously defined references. When you have entered a reference point, lines are drawn between the reference points with the same name as the reference point you added. The lines displayed are not permanent and will disappear − for example, if the zoom command is used.
7.12.11 Show references – Displaying reference points This function draws lines between reference points. After selecting the command, you are prompted to enter the reference point to be displayed: Select reference or press return to give the name:
Select a reference point. The command draws lines between the reference points with the same name as the reference point you selected. If you do not select a reference point but instead press Enter, the following is displayed on the command line: Give the name of the reference or press return to select all:
If you enter a reference point name, the command draws lines between the reference points with the same name. If you do not select a reference point but instead press Enter, the command displays a list of the references used in the function block diagram and draws lines between the reference points, using a different color for each reference.
7.12.12 Table autocolor wire − Drawing the table type connection lines by using the autocolor function Using the Table autocolor wire command you can draw a table type connection line which is colored according to the start point. If the start point is, for example, an output of type ana_9 or a table connection line type ana, the color of the connection line will be green.
7.12.13 Table wires − Drawing the table type connection lines This command is similar to the Scalar wires command (see chapter 7.12.2 Scalar wires), but it is used for table type symbols.
7.12.14 Comments − Access to Comment symbol submenu By selecting the Comments option you can go to the Comments submenu. For more information on comments drawing commands see Chapter 7.13 Draw−Comments.
Rev. 4
Menu Bar
7.13
93
Draw −> Comments − COMMENT SYMBOL DRAWING COMMANDS The Comments menu contains texts, boxes and other similar components for the comments layer. The color and the line type of the comments are selectable. The structure of the comments menu is as follows:
Figure 63
7.13.1
The structure of the Draw − Comments submenu
DText − Text This option lets you create one line or multi−line comment text. After selecting the command the tool will ask you the following question: Start point or Align/Center/Fit/Middle/Right/Style:
If you select the starting point for the text by pointing the mouse at it, the tool will ask you to enter the text height (default 4), rotation (0° ) and the text itself. If you select the Align option, the tool will ask you to enter two points between which the text will be aligned. If you select Center, the tool will ask you to enter the center and size and rotation for the text. The horizontal line of the cross−hairs marks the bottom of the text. The Fit option is similar to Align, except that in addition to the width you will be asked about the text height. Middle is similar to Center, but the horizontal line of the cross−hairs marks the middle of the text. The Right option will align the text at its end point (specified by mouse). The Style option lets you change the text style (see the CAD manual). Accept the entered text with an key (or with the right mouse button). The Dtext command is dynamic, in other words, the text will be echoed in the function block diagram while you write it.
7.13.2
Pline − Drawing a line The Pline option lets you draw a line or break−line. After selecting the command the tool will ask you to enter the starting point, which should be specified using the mouse. After this the display will show: Current line−width is 0 Arc/Close/Halfwidth/Length/Undo/Width/:
Now you can enter the end point or change the properties of the line. This command is the same as the CAD pline command (see the CAD manual).
Rev. 4
94
7.13.3
FbCAD Manual
Box − Drawing a box The Box option lets you draw a box by specifying its two diametrically opposite corners. When you select this command, the command line will show: First corner:
Use the left mouse button to enter the first corner. After this you will be asked about the second corner: Second corner:
Enter the second corner in the same way as you entered the first corner.
7.13.4
Circle − Drawing a circle The Circle option lets you draw a circle. The tool will ask you to enter the center and radius (or diameter) of the circle. You can also create a circle by specifying three points (3P), by two points (2P) or using the tangent−tangent−radius (TTR) principle.
7.13.5
Color − Changing the drawing color of comments The Color option lets you change the drawing color of comments. After selecting the command, you can choose the color in the Select Color dialog.
7.13.6
Line type − Changing the line type of comments The Line type option lets you select the line type with which the lines, boxes etc. are drawn on the comments layer.
Rev. 4
Menu Bar
7.14
95
Common − GENERAL AUTOMATION LANGUAGE CONCEPTS The Common menu contains the general automation language concepts: function block diagram, continuous control, external data point, direct access port, interface port, local data point and constant.
Figure 64
7.14.1
Structure of the Common pull−down menu
Automation module... − function block diagram The Automation module... command inserts a function block diagram. There are three function block diagram versions available: admin_normal, admin_mid and admin_big, which can be selected from an icon menu. The normal function block diagram is quite sufficient for normal connections, but if you design very large control loops, you can select a big function block diagram, which is four times as big as the normal function block diagram. Mid function block diagram is about two times as big as the normal function block diagram (Figure 65 Available function block diagram sizes). If you want a big or medium− sized function block diagram, the easiest way to create it is as follows: After starting the CAD tool, use the Page−Create command and give zero (0) as the number of pages. At this point the tool asks the size of the desired function block diagram.
Rev. 4
96
FbCAD Manual
ADMIN_BIG
ADMIN_MID
ADMIN_NORMAL
Figure 65
Available function block diagram sizes
The following data can be entered for the administration part of the function block diagram using a dialog: LOOP TAG
TAG_CODE
LOOP NAME (FIELD 1) LOOP NAME (FIELD 2) LOOP STATUS
complete
NAME OF PLANNER
−
DATE OF PLANNING
YY−MM−DD HH:MM
NAME OF MODIFIER
−
DATE OF MODIFICATION
YY−MM−DD HH:MM
PROCESS AREA 1 PROCESS AREA 2 PROCESS AREA 3 PROCESS AREA 4 The data that you write on the fields will be stored in the administration part of the function block diagram. All data except the loop status will be visible in the function block diagram.
Rev. 4
Menu Bar
7.14.2
97
Function module... The Function module... command inserts a continuous control or its extension part in the function block diagram. Generally, one function block diagram contains one continuous control and its possible extension parts. An exception to this rule is the usage of PLU−I/O function, in which case a function block diagram includes not only the normal continuous control but also the actual PLU−I/O function and possible extension parts of both configuration functions. Four versions of both continuous controls and their extension parts are available: fadmin_normal, fadmin_mid, fadmin_big and fadmin_long are the continuous control alternatives and extension_normal, extension_mid, extension_big and extension_long the corresponding extensions. The alternatives differ in size. The normal or mid continuous control frame is quite sufficient for normal connections. The long continuous control frame is used mainly for recipe configuration. The big continuous control frame is used for designing very large function block diagrams. A long continuous control frame is double the height of a normal frame and big is double the width of a long frame (Figure 66 Available continuous control frame sizes). Mid continuous control frame is about two times as big as the normal frame.
FADMIN_LONG
FADMIN_BIG
FADMIN_MID
ADMIN_NORMAL NORMAL FADMIN_NORMAL NORMAL
Figure 66
Available continuous control frame sizes
The following data can be entered for the administration part of the continuous control using a dialog: FUNCTION MODULE NAME
pr:TAG_CODE.F
PACKAGE IDENTIFIER
AP01
EXECUTION INTERVAL
1000
EXECUTION ORDER
20
The data that you write on the fields will be stored in the administration part of the continuous control. All data except the continuous control execution order will be visible in the administration part. When adding the extension, the dialog only asks for the identifier of the continuous control.
Rev. 4
98
7.14.3
FbCAD Manual
Externals in continuous... − External continuous inputs The External in continuous option shows you an icon menu from which you can select an external input data point for a desired signal type (ana, anaev, bin, binev, intl, intlev, ints, intsev, bo, fails, float, other configurable type or table) for continuous communication. When you have selected the desired symbol, the symbol’s insertion point is also its connection dot i.e. the point from which the connection line will be drawn, for instance, to the input of a function block. (See further information of table type from chapter 10 Configuration of Tables.) When you have inserted the symbol, you will be asked about the name, comment text, initial value of the input and the transfer interval. The name and comment text will be displayed in the symbol, but the initial value and transfer interval will not be visible. If the field is left empty or there is the default value of the field, the transfer interval is the same as the execution interval of the continuous control. However, if a limit value HKEY_LOCAL_MACHINE\SOFTWARE\Metso Automation\EA\\Environment\TRANSLIMIT is defined in the Windows registry and it is defined to be bigger than execution interval of the continuous control, the value of TRANSLIMIT is used as the transfer interval. A continuous external input data point is marked with the following symbol:
Figure 67
7.14.4
External continuous input
Externals out continuous... − External continuous outputs The Externals out continuous... gives you an icon menu from which you can select an external output data point for a desired signal type (ana, anaev, bin, binev, intl, intlev, ints, intsev, bo, fails, float, other configurable type or table) for continuous communication. (See further information of table type from chapter 10 Configuration of Tables.) When you have inserted the symbol, you will be asked about the name, comment text, initial value of the output and transfer interval. The name and comment text will be displayed in the symbol, but the initial value and transfer interval will not be visible. If the field is left empty or there is the default value of the field, the transfer interval is the same as the execution interval of the continuous control. However, if a limit value HKEY_LOCAL_MACHINE\SOFTWARE\Metso Automation\EA\\Environment\TRANSLIMIT is defined in the Windows registry and it is defined to be bigger than execution interval of the continuous control, the value of TRANSLIMIT is used as the transfer interval. A continuous external output data point is marked with the following symbol:
Figure 68
External continuous output
Rev. 4
Menu Bar
7.14.5
99
Externals out conditional... − External conditional outputs The Externals out conditional... gives you an icon menu from which you can select an external output data point for a desired signal type (ana, anaev, bin, binev, intl, intlev, ints, intsev, bo, fails, float, time or table) for conditional communication. A conditional output can only be used together with the ccoX and ccoX2 function blocks. (See further information of table type from chapter 10 Configuration of Tables.) When you have inserted the symbol, you will be asked about the name, comment text and initial value of the output. The name and comment text will be displayed in the symbol, but the initial value will not be visible. A conditional external output data point is marked with the following symbol:
Figure 69
7.14.6
External conditional output
External ports in... − External input ports The External ports in... option gives you an icon menu from which you can select an external input port for a desired signal type (ana, anaev, bin, binev, intl, intlev, ints, intsev, bo, fails, float, other configurable type or table). This port is a combination of an external continuous input and an input interface port. (See further information of table type from chapter 10 Configuration of Tables.) After you have inserted the symbol, you will be asked for the name, comment text and initial value of the interface port and as well as the name, comment text and transfer interval of the external continuous input. All data except the transfer interval will be displayed in the symbol. The external input port functions as a separate external input and an input interface port which are connected to each other. The name field of the external continuous input can be left empty i.e. the external data point will not be formed and the external port functions as a regular interface port. An external input port is marked with the following symbol:
Figure 70
Rev. 4
External input port
100 FbCAD Manual
7.14.7
External ports out... − External output ports The External ports out... option gives you an icon menu from which you can select an external output port for a desired signal type (ana, anaev, bin, binev, intl, intlev, ints, intsev, bo, fails, float, other configurable type or table). This port is a combination of an external continuous output and an ouput interface port. (See further information of table type from chapter 10 Configuration of Tables.) After you have inserted the symbol, you will be asked for the name, comment text and initial value of the interface port and as well as the name, comment text and transfer interval of the external continuous output. All data except the transfer interval will be displayed in the symbol. The external output port functions as a separate external output and an output interface port which are connected to each other. The name field of the external continuous output can be left empty i.e. the external data point will not be formed and the external port functions as a regular interface port. An external output port is marked with the following symbol:
Figure 71
7.14.8
External output port
Direct access left... − Direct access ports, connections on the left Direct access left... gives you an icon menu from which you can select a direct access port for a desired signal type (ana, anaev, bin, binev, intl, intlev, ints, intsev, bo, fails, other configurable type or table). Left indicates that the connection dot is at the left side of the symbol. (See further information of table type from chapter 10 Configuration of Tables.) When you have inserted the symbol, you will be asked about the name, comment text and initial value of the direct access port. The name and comment text will be displayed in the symbol, but the initial value will not be visible. A direct access port with connection on the left is marked with the following symbol:
Figure 72
7.14.9
Direct access port, connection on the left
Direct access right... − Direct access ports, connections on the right Direct access right... corresponds to direct access left..., only the connections are on the left side of the symbol. A direct access port with connections on the right is marked with the following symbol:
Figure 73
Direct access port, connection on the right
Rev. 4
Menu Bar 101
7.14.10 Interface in... − Input interface ports Interface in... gives you an icon menu from which you can select input interface ports for desired signal types (ana, anaev, bin, binev, intl, intlev, ints, intsev, bo, fails, modstat, other configurable type or table). (See further information of table type from chapter 10 Configuration of Tables.) When you have inserted the symbol, you will be asked about the name, comment text and initial value of the interface port. All data will be visible in the symbol. One function block diagram cannot contain several interface ports of the same name, therefore it is necessary to use reference points if the data of the port are needed in several places. An Input side interface port is marked with the following symbol:
Figure 74
Input interface port
Interface ports also contain definitions of the data structures for the administration of the sequence and subsequence:
seqadmin, type seqmng, sequence administration data structure
subadmin, type lseqmng, subsequence administration data structure
MODSTAT−interface port Each function block diagram must contain one interface port of type ktstat. This port controls the execution of the function blocks of the PCS continuous control and continuous control’s data communications to other continuous controls of the same control task. It is possible to add an interface port of ktstat type in the function block diagram with the desired initial values using the MODSTAT interface port. In case a port has not been added in the function block diagram, the port will be added automatically.
The update class of the continuous control at the duplicated Process Control Server It is possible to specify an update class for the continuous control at the duplicated Process Control Server using the MODSTAT interface port. There are three update classes: A, B and C. Using the update class, the user defines how often the continuous control data is updated between the main and reserve machine.
7.14.11 Interface out... − Output interface ports Interface out... corresponds to interface in... except that it is located at the output side. An output interface port is marked with the following symbol:
Figure 75
Rev. 4
Output interface port
102 FbCAD Manual
7.14.12 Locals left... − Local data points, connections on the left Locals left... gives you an icon menu from which you can select a local data point for a desired signal type (ana, anaev, bin, binev, intl, intlev, ints, intsev, bo, fails, float, other configurable type or table) with connections on the left. (See further information of table type from chapter 10 Configuration of Tables.) CONNECTING A LOCAL DATA POINT A local data point is marked with a round symbol with connection on its left or right side. The connection lines connect the data point to other objects to be connected. You draw the connection line directly from the local data point to the input or output of a function block or to another line. For the line−to−line connection you need a connection dot, which you select from the Draw menu (DOT). Then you point the exact location where the connection lines meet and place the connection dot here. When you have inserted the symbol, you will be asked for the name, dimension, initial value and comment text of the local data point. The name and initial value will be displayed in the symbol. The icon menu also contains the Any−type data point. Its type is user−definable and it accepts a long initial value extending to several lines (e.g. in connection with the ’tfunc’ function block). When the function block diagram is checked, these lines will be combined into one initial line. A local data point with connections on the left is marked with the following symbol:
Figure 76
Local data point, connection on the left
7.14.13 Locals right... − Local data points, connections on the right Locals right... corresponds to locals left..., only the connection is on the left side of the symbol. A local data point with connections on the right is marked with the following symbol:
Figure 77
Local data point, connection on the right
Rev. 4
Menu Bar 103
7.14.14 Constants left... − Constants, connection on the left Constants left... gives you an icon menu from which you can select a constant for a desired signal type (ana, anaev, bin, binev, intl, intlev, ints, intsev, bo, fails, float or other configurable type). Connection to the function block is on the left. When you have inserted the symbol, you will be asked for the initial value of the local data point. This value will also be displayed in the symbol. A constant with connections on the left is marked with the following symbol (example: ana− type signal):
Figure 78
Constant, connection on the left
7.14.15 Constants right... − Constants, connection on the right Constants right... corresponds to constants left... but with connection to function block on the right side of the symbol. A constant with connections on the right is marked with the following symbol (example: ana− type signal):
Figure 79
Constant, connection on the right
THINGS TO BE NOTED IN CONNECTING DATA POINTS: You cannot make a connection between two data points: in other words connections local−local, external−external or local−external data point are not possible. Constants used for initializing data points (or function blocks) are not enclosed in parentheses.
Rev. 4
104 FbCAD Manual
7.15
Fblocks1 − FUNCTION BLOCKS From the Fblocks1 pull−down menu you can pick different kinds of function blocks and their variations.
Figure 80
The structure of the Fblocks1 pull−down menu
am...
Analog measurement function block
am2...
Analog measurement function block 2
ahs...
Analog history function block
ahs2... Analog history function block 2
bhs...
bhs2... Binary history function block 2
bm2... Binary measurement function block
cnt...
Counter function block
grp...
Group control function block
mca...
Motor actuator control function block
mgv...
Magnetic valve control function block
mgv2... Magnetic valve control function block 2
mgve... Time−stamped magnetic valve control function block
mtr...
mtr2... Motor control function block 2
mtr2e... Time−stamped motor control function block 1
mtre... Time−stamped motor control function block
pid...
qcnt... Quantity function block
vlv...
Binary history function block
Motor control function block
Controller function block Valve positioner function block
Rev. 4
Menu Bar 105
When you select a function block type from Fblocks1, Fblocks2 and Fblocks3 pull−down menus, you will get an icon menu containing the available versions of the function block. Different versions have different numbers of inputs and outputs to be connected. To pick the desired function block type you pick the icon presenting it. By contrast, if you select the function block from the FbCAD screen menu item Fblocks, you will not get an icon menu but a text menu containing descriptive names for the function blocks. The following figure presents the variations of am function blocks as they are shown in the icon menu and the respective descriptive variation names as shown in the am submenu of the screen menu item Fblocks1.
Figure 81
am function block variations
The following things should be noted when entering function blocks: When you pick a function block from a Fblocks menu, you must specify the block’s execution order in relation to other function blocks in the loop. On the basis of the specified execution order a number corresponding to the order is automatically generated before the function block’s name. For example, if you pick an am function block and set its execution order to 2, the generated function block name will be 2am. Constant values for function block parameters and initial values need not be inserted in parentheses. The configuration constants of previously entered function blocks can be changed through the Values item in the Edit menu. When you have inserted a function block, you will be asked for its data in a dialog. The data to be specified in the field depend on the function block. They include the execution order of the function block, the name of the direct access port, and those function block parameters that are not connected in the function block diagram.
Rev. 4
106 FbCAD Manual
7.16
Fblocks2 − FUNCTION BLOCKS Fblocks2−pull−down menu is similar in operation to the Fblocks1 pull-down menu. It only contains different function blocks.
Figure 82
Fblocks2 pull−down menu options
Menu includes following function blocks:
ccoX left
Conditional copy function blocks, inputs on the left
ccoX2 left
Time−stamped conditional copy function blocks, inputs on the left
disX left...
Double input switches, inputs on the left
dosX left...
Double output switches, inputs on the left
tisX left...
Input table switches, inputs on the left
tosX left...
Output table switches, inputs on the left
btoicnv ...
BCD/binary number −> integer conversion
cng...
Conditional jump function block
eqg...
Conditional jump function block with equality comparison
label...
Jump destination function block
dvsX...
Double input value selector
itobcnv...
integer −> BCD/binary number conversion
itotime...
integer −> time conversion
Rev. 4
Menu Bar 107
not...
No operation function block
pls...
Pulse function block
timetoi...
time −> integer conversion
timefun...
Time calculation function block
tsel...
Time selection function block
tm...
Time measurement function block
ramp...
Ramp function blocks
ccoX right
Conditional copy function blocks, inputs on the right
ccoX2 right
Time−stamped conditional copy function blocks, inputs on the right
disX right...
Double input switches, inputs on the right
dosX right...
Double output switches, inputs on the right
tisX right...
Input table switches, inputs on the right
tosX right...
Output table switches, inputs on the right
When you select ccoX left or ccoX right, the following submenu is displayed, containing the various copy function blocks sorted by their size and available functions:
Figure 83
Structure of the ccoX left and ccoX right submenus
A corresponding submenu is also displayed when you select ccoX2 left or ccoX2 right.
Figure 84
Rev. 4
Structure of the ccoX2 left and ccoX2 right submenus
108 FbCAD Manual
7.17
Fblocks3 − FUNCTION BLOCKS The Fblocks3 pull−down menu is similar in operation to the Fblocks1 and Fblocks2 pull− down menus. It only contains different function blocks.
Figure 85
The structure of the Fblocks3 pull−down menu
Menu includes following function blocks:
calc left ...
Calculation function block, inputs on the left
cmp left...
Comparison function block, inputs on the left
logic left...
Logic function block, inputs on the left
logice left...
Time−stamped logic function block, inputs on the left
and/or left...
Logic function block, inputs on the left
conv left...
Type conversion function blocks, inputs on the left
askfb...
Fault bit testing function block
cfab...
Conversion function block
cwsqrt...
Cover and square root
delay...
Analog delay
fbor...
Fault bit setting function block
hys...
Hysteresis function block
lela...
Lead−lag function block
Rev. 4
Menu Bar 109
lim...
Limiter function block
nop...
No operation function block
prog
Freely programmable function block which is written in list form (Java)
stfl...
Steam flow function block
tasX...
Testing and setting function block
tfunc...
Table function function block
sumta...
Conditional calculation function block for summary information of an analog profile
calc right...
Calculation function block, inputs on the right
cmp right...
Comparison function block, inputs on the right
logic right...
Logic function block, inputs on the right
logice right...
Time−stamped logic function block, inputs on the right
and/or right...
Logic function block, inputs on the right
conv right...
Type conversion function blocks, inputs on the right
Fuzzy
Fuzzy control function blocks
When you select any of the options calc, cmp, logic, logice, and/or left/right or conv left/ right, the display will show an icon menu, where available function block variations are represented also by descriptive names. When you select a function block from the icon menu or screen menu’s submenu, you will get a regular dialog for entering function block data. Besides the execution order the dialog will ask you to enter lines of formulas for determining the operations to be carried out by the function block. In the following table the syntax of the data to be entered for a 2in−1out ana type calc left function block is presented. The two last function blocks of the conv items make an exception from predefined function blocks, see 7.17.1 Things to be noted in defining function blocks. EXECUTION ORDER
1
1.FORMULA LINE (16char)
o=2*a*b;
2.FORMULA LINE (16char) When you select the option prog, the display will show an icon menu, where available function block variations are represented by descriptive names. When you select a function block from the icon menu or screen menu’s submenu, you will get a ’Java Prog2’ dialog for setting initial data for the function block symbol. When the option Fuzzy is selected the display will show a submenu, where available fuzzy control’s function blocks can be selected. A separate license must be acquired before fuzzy function blocks can be used in metsoDNA CR. Submenu includes the following function blocks:
Figure 86
Rev. 4
Fuz
The structure of Fuzzy submenu Fuzzification function block
110 FbCAD Manual
7.17.1
Fuz Short
Fuzzification function block (short)
Fuzinf
Inference function block
Fuzinf Short
Inference function block (short)
Defuz
Defuzzification function block
Defuz Short
Defuzzification function block (short)
Things to be noted in defining function blocks Configuring calculation and comparison function blocks There are several different symbols of the calculation and comparison function blocks in the tool. However, if a desired symbol is not found among predefined symbols, it can be created by clicking the menu bar command Fblocks3−>calc/cmp left/right and the item xxx−xxx from the appearing icon menu. The following data is required: 1.
Reading default values Select a cmp/calc to get the default values or press return:
If you want to create a new symbol that differs only a little from an existing calculation or comparison symbol, select first the existing symbol. The function will read the default values from the selected symbol. If you do not want the default values to be read, press the Enter key. 2.
The number of inputs Give the number of inputs [1]:
3.
Names of inputs Give name of the 1 input: [a]:
Do not use blank characters in the name. All capital letters used in the name will be converted to lower case letters. 4.
Input types Give the type of input a: (a=ana, I=intl, s=ints) [ana]:
Note that the first character is enough for an input. 5.
Number of outputs Give the number of outputs: [1]
6.
Names of outputs Give name of the 1 output: [o1]:
Do not use blank characters in the name. All capital letters used in the name will be converted to lower case letters. 7.
Output types (only in the case of calc calculation function block) Give the type of output o1: (a=ana, l=intl, s=ints) [ana]:
Note that the first character is enough for an input. Output type of the cmp comparison function block is always bin. 8.
Number of formula rows Give the number of rows: [1]
Rev. 4
Menu Bar 111
9.
Location of the formula rows Do you want the rows to Up or Down (u=up, d=down) [down]:
Note that the first character is enough for an input: u=up, d=down. If Up is chosen the formulas are located in the upper part of a symbol, e.g.
If Down is chosen the formulas are located in the lower part of a symbol, e.g.
10.
Symbol width If the formula rows are located in the upper part of the symbol, the total width of the symbol is asked: Give the width of the symbol [70]:
If the formula rows are located in the lower part of the symbol, the widths for upper and lower parts of the symbol are asked separately: Give the upper width of the symbol [70]: Give the lower width of the symbol [70]:
The width is entered in CAD units. The names of the inputs and outputs must be unambiguous. Input and output cannot have the same name. If the formula is complicated, it can be divided into sections. An example is presented below.
Rev. 4
112 FbCAD Manual
Connection of calculation/logic/comparison function blocks It is not possible to initialize these function blocks by connecting a constant; instead you can use a local data point with an initial value, or an interface or direct access port, if it is desirable to check or change the values using debugger. A constant can of course be used in a formula, such as o=2*a*b.
Configuring type conversion function blocks There are no predefined symbols for all possible variations of the type conversion function blocks (tcnvbas and tcnv2) in FbCAD, so you can create a symbol only after defining the inputs and outputs of the function block. Create the function block as follows: 1.
Select the symbol from the Fblocks3−conv left/right menu (tcnvbas xxx−xxx low, tcnvbas xxx−xxx high, or tcnv2 xxx−xxx). In the dialog that is displayed, select the input and output type for the function block. Both function blocks (tcnvbas and tcnv2) have a dialog of their own:
Figure 87
Input and output types available for the tcnvbas function block
Rev. 4
Menu Bar 113
Figure 88 2.
Input and output types available for the tcnv2 function block
After selecting the types, click the OK button. The function block symbol is attached to the mouse cursor, with which you can move the symbol to the desired location. You will be prompted to enter the insertion point on the command line: Insertion point for the symbol:
Use the mouse to move the symbol and fix it using the left mouse button. After this you will get a dialog for entering the execution order. Some of the most common variations of the type conversion function block have been predefined and they can be found in the icon menus of the command Fblocks3−conv left/right. The execution order of the function block must be given to these blocks in the same way as described above
Rev. 4
114 FbCAD Manual
7.18
I/O − I/O FUNCTIONS From the I/O pull−down menu you can select I/O functions and their variations. As in the Fblocks menus, selecting an item from the menu brings you to an icon menu that allows you to pick the desired version.
Figure 89
The structure of the Modules pull−down menu
Through the following Modules pull−down menu items you can select I/O functions of different types of I/O units. Selecting an item from the pull−down menu opens an icon menu, from which you can select the desired version of the I/O function.
AIU1
I/O functions for AIU 1 unit
AIU4
I/O functions for AIU 4 unit
AIU8
I/O functions for AIU 8 unit
AOU1
I/O functions for AOU 1 unit
AOU4
I/O functions for AOU 4 unit
FIU1
I/O functions for FIU 1 unit
TCU4
I/O functions for TCU 4 unit
TIU6
I/O functions for TIU 6 unit
ACU
I/O functions for ACU unit
BIU4
I/O functions for BIU 4 unit
BIU8
I/O functions for BIU 8 unit
BIU8N
I/O functions for BIU 8N unit
BIC12
I/O functions for BIC12 unit
Rev. 4
Menu Bar 115
7.18.1
BOU8
I/O functions for BOU 8 unit
EXI
I/O functions for EXI units
MCIO
I/O functions for motor controller
HART
I/O functions for HART units
EIO − I/O functions of embedded I/O From the EIO submenu you can select I/O functions which are used in connection with embedded field I/O. The structure of the EIO menu is as follows:
Figure 90
7.18.2
Structure of the EIO submenu
IEC − I/O functions of embedded programmable I/O From the IEC submenu you can select I/O functions which are used in connection with embedded programmable I/O. The structure of the IEC menu is as follows:
Figure 91
7.18.3
Structure of the IEC submenu
PROFIBUS − I/O functions of the PROFIBUS fieldbus interface From the PROFIBUS submenu you can select I/O functions of the PROFIBUS fieldbus interface. The structure of the PROFIBUS menu is as follows:
Figure 92
Rev. 4
Structure of the PROFIBUS submenu
116 FbCAD Manual
7.18.4
CIC − I/O functions of Damatic Classic From the CIC submenu you can select I/O functions used in connection with Damatic Classic. The structure of the CIC menu is as follows:
Figure 93
7.18.5
Structure of the CIC submenu
OPC − Functions of the OPC client interface From the OPC submenu you can select functions used in connection with OPC interface. The structure of the OPC menu is as follows:
Figure 94
7.18.6
Structure of the OPC submenu
FF... − Functions of the Foundation Fieldbus interface From the FF submenu you can select functions used in connection with FF interface. The structure of the FF menu is as follows:
Figure 95
FF dialog
For further information on FF functions, see a document called “Foundation Fieldbus Application Engineering Guide”.
7.18.7
MIO M80 − I/O functions of ACN I/O M80 series From the MIO M80 submenu you can select I/O functions which are used in connection with ACN I/O M80 series. The structure of the MIO M80 menu is as follows:
Figure 96
Structure of the MIO M80 submenu
Rev. 4
Menu Bar 117
7.18.8
MIO M120 − I/O functions of ACN I/O M120 series From the MIO M120 submenu you can select I/O functions which are used in connection with ACN I/O M120 series. The structure of the MIO M120 menu is as follows:
Figure 97
Rev. 4
Structure of the MIO M120 submenu
118 FbCAD Manual
7.19
Modules − CONFIGURATION FUNCTIONS From the Modules pull−down menu you can select configuration functions (tag, operation, event, history and trend functions and mimic panel controls) and their variations; it also provides access to the recipe, PLU, MCP, DIS and LIS menus and to the simulation functions. As in the Fblocks menus, selecting an item from the menu brings you to an icon menu that allows you to pick the desired version.
Figure 98
7.19.1
The structure of the Modules pull−down menu
Position... − Tag functions The Position... option is used for creating the tag functions for the function block diagram. Below is an illustration of the symbol.
Figure 99
Tag function symbol
Tag function symbols are available for function block types am, am2, bin, binl, bm2 cnt, grp, mca, mgv, mgv2, mtr, pid, pro, pro2, prsc, pr2sc and sc. Also data types ana, intl and ints have their own tag function symbols. There are also binary tag functions bin8 and bin8l which are only for messages, and am live, am2 live, mtr live and pid live tag functions in which there is a possibility to configure that the current live value of the alarming signal (e.g. measurement) is displayed in the event browser on the event lines of the limit events. The tag function symbol itself is always the same, but the function block identifier at the bottom varies and in the “live” tag function symbols there is a symbol of an event browser on the upper right corner. Data for the tag functions are requested in dialogs. See chapter 9.1 Dialogs for Tag Functions.
Rev. 4
Menu Bar 119
7.19.2
Operation... − Operation functions The Operation... option produces an icon menu, which allows you to select between two different operation function types:
normal operation function operation function with direct access keys
Normal operation function
Figure 100
Operation function symbol (normal)
Operation function symbols are available for am, am2, bin, bm2, cnt, grp, mca, mgv, mgv2, mtr, pid and sc function blocks. The operation function symbol itself is always the same, but the function block identifier at the bottom varies.
Operation function with direct access keys
Figure 101
Operation function symbol (direct access keys)
Operation function symbols are available for am, am2, bin, bm2, cnt, grp, mca, mgv, mgv2, mtr and pid function blocks. The operation function symbol itself is always the same, but the function block identifier at the bottom varies. Data for operation functions are entered in dialogs. See chapter 9.2 Dialogs of operation functions.
7.19.3
Event... − Event functions The Event... option lets you select an event function symbol, which is illustrated below.
Figure 102
Event function symbol (am)
Event function symbols are available for am, bin, bm2, cnt, grp, mca, mgv, mtr and pid function blocks. In addition, there is an event function bin8, which is for messages only. The event function symbol itself is always the same, but the function block identifier at the bottom varies. There are also the event function symbols am*, bm2*, grp*, mgv*, mtr*, and pid* for the am, bm2, grp, mgv, mtr, and pid function blocks. An example of these is shown below:
Figure 103
Rev. 4
Event function symbol (am*)
120 FbCAD Manual
With these event function symbols (denoted by “*”), you can determine the following data separately for each event point:
type of the event point (alarm, message, neither)
alarm priority
alarm acknowledgement request
alarm free grouping
message acknowledgement request
message free grouping
For the other event function symbols, the above data are common for all event points except the type of the event point, which is determined separately for each event point. Data for the event functions are requested in dialogs. For more details, see chapter 9.4 Dialogs for Event Functions.
7.19.4
History... − History functions Different history symbols can be added using the History... option. These symbols are used for defining the history collection to the history database. With the following symbol you can configure a ph3 history function.
Figure 104
ph3 history function symbol
A write group can be defined to the history database with the following symbol:
Figure 105
Write group symbol
A read group can be defined to the history database with the following symbols. The difference between these two symbols are that a ’Read’ group must always be started up separately whereas ’Unsolicited Read’ group starts up automatically when the database is started.
Figure 106
Read and Unsolicited Read group symbols
Rev. 4
Menu Bar 121
History tags can be defined with the following symbols. There are three different history tag symbols for different types of data. The analog symbol is for analog data, the discrete symbol for binary and integer data and the text symbol for character data.
Figure 107
Symbols for history tags (Analog, Discrete and Text)
History function data can be entered using a dialog. See chapter 9.5 Dialogs for history functions.
7.19.5
History2... − History functions Different history symbols can be added using the History2... option. These symbols are used for defining the history collection to the history database and for defining tags to the Tag Knowledge Service. User rights and the use of the Audit Trail service for history tags can be defined with these symbols. Loading is taken care by HistConfLoader. A write group can be defined to the history database with the following symbol. Long tag names are allowed.
Figure 108
Write group symbol
A read group can be defined to the history database with the following symbols. The difference between these two symbols are that a ’Read’ group must always be started up separately whereas ’Unsolicited Read’ group starts up automatically when the database is started. Long tag names are allowed.
Figure 109
Rev. 4
Read and Unsolicited Read group symbols
122 FbCAD Manual
With the following symbols you can define history tags to the history database and to the Tag Knowledge Service. There are four different history tag symbols for different types of data. The Analog Scalar symbol is for analog scalar type data, the Analog Array symbol is for analog table type data, the Discrete Scalar symbol for binary and integer type scalar data, the Discrete Array symbol for table type binary and integer data and the Text symbol for character data.
Figure 110
Symbols for history tags (Analog Scalar, Analog Array, Discrete Scalar, Discrete Array and Text)
History function data can be entered using a dialog. See chapter 9.5 Dialogs for history functions.
7.19.6
Trend... − Trend functions For further information on trend functions, see a document called Engineering Trends.
7.19.7
Mimic... − Mimic panel controls Mimic panel control symbols are available for bin, mgv and mtr function blocks. The mimic panel control symbol is always the same, but the function block identifier on the bottom varies. The mimic panel control symbol is illustrated below:
Mimic panel control data are entered in dialogs. See chapter 9.3 Dialogs for mimic panel controls.
7.19.8
Recipe − Recipe functions The Recipe option leads you to a menu used for designing recipes.
Figure 111
Structure of the Recipe submenu
Rev. 4
Menu Bar 123
EXT O/I variation... − External outputs/inputs External output/input symbols are now narrower to allow more symbols to fit in the function block diagram.
ext I conditional... − External conditional inputs The symbol of an external conditional input is as follows:
ext I/O... +− − External inputs/outputs The symbol of an external input/output is as follows:
ext O/I... −+ − External outputs/inputs The symbol of an external output/input is as follows:
ldX load − Loading function blocks for loading function The symbol of a loading function block for loading function is as follows:
ldX abs − Absolute value loading function block ldX abs function block symbol is as follows:
ldX prop − Loading function block for relative values ldX prop function block symbol is as follows:
Data for the function blocks and other menu symbols are entered in the usual manner through dialogs.
Rev. 4
124 FbCAD Manual
7.19.9
PLU functions
Figure 112
Structure of the PLU submenu
The PLU submenu is presented in detail in a document called Configuration of PLU.
7.19.10 MCP functions
Figure 113
Structure of the MCP submenu
The MCP submenu is presented in detail in a document called Configuration of MCP.
Rev. 4
Menu Bar 125
7.19.11 DIS − I/O, tag, operation and event functions of Damatic Interface Server
Figure 114
Structure of the DIS submenu
I/O... The functions of I/O submenu are presented in detail in a document called Damatic Interface.
Position... The Position... option lets you select a tag function symbol for Damatic binary interface.
Figure 115
Tag function symbol
Additional information is available in a document called Damatic Interface.
Operation... The Operation... option lets you select an operation function symbol with direct access key.
Figure 116
Operation function symbol
Operation function symbols for Damatic interfaces are available for pid−, dspa−, dspm−, dspv−, dspg−, dspc−, dspb−, mcu− and vcu function blocks. The operation function symbol itself is always the same, but the function block identifier on the bottom varies. Data for operation functions are entered in dialogs. See chapter 9.2 Dialogs for operation functions.
Event... The Event... option lets you select an event function symbol, which is illustrated below.
Figure 117
Event function symbol
Event function symbols for Damatic interfaces are available for pid−, dspa−, dspm−, dspv−, dspg−, dspb−, dseq−, mcu− and vcu function blocks. The event function symbol itself is always the same, but the function block identifier on the bottom varies. Event function data are entered in dialogs. See chapter 9.4 Dialogs for Event Functions.
Rev. 4
126 FbCAD Manual
7.19.12 LIS − Function blocks and I/O functions of Logic Interface Server The LIS option lets you select the function blocks of Logic Interface Servers. When you select an option from LIS submenu you will get an icon menu containing the available function blocks.
Figure 118
Structure of LIS submenu
PROTOCOL... icon menu contains the general function blocks of Logic Interface Server (LIS). TGETX and TPUTX menus contain table management function blocks of Logic Interface Server (LIS). RCSX and RCGX menus contain function blocks of the Computer Interface Server (CIS). IO... icon menu contains the I/O functions of the Logic Interface Server (LIS). HARTMSG... icon menu contains the hartmsg function block. Explanations of these function blocks and I/O functions are presented in detail in documents called PLC Interface and Process Computer Interface − CNP Protocol.
7.19.13 Simulation... Simulation functions For further information on simulation functions, see a document called Simulating Loops.
Rev. 4
Menu Bar 127
7.20
FbCADHelp FbCADHelp menu contains the tool’s help and version information.
Figure 119
7.20.1
The structure of FbCADHelp menu
Help FbCAD − Tool’s user guide Gives FbCAD manual. This however, requires right definitions in the workspace settings (see chapter 2 Settings for the Engineering Environment).
7.20.2
Help Types − Type help Gives help on types used in FbCAD. After you have picked the help from the menu the following text is printed on the command line: Enter type name:
Give the required type name and press . The help is shown in its own window by a viewing program defined in the workspace settings (see chapter 2 Settings for the Engineering Environment).
7.20.3
About FbCAD − Tool’s version data About command brings the tool’s version information on the display.
Rev. 4
128 FbCAD Manual
8
SCREEN MENU The Screen Menu appears on the right edge of the screen when the engineering tool has started. This menu is visible throughout the engineering session. Most commands in the screen menu are the equivalents of the commands in menu bar’s pull−down menus, but the menus behave differently. When you select a command from the screen menu, the submenu related to the command is displayed. Unlike the pull−down menus, which will disappear immediately after selecting the item, this menu will remain on the display, so you can quickly pick several commands of the same type. Thus the screen menu is very useful when you need a command or several commands belonging to the same menu repeatedly. Another difference between the menus is that the items Common, Fblocks1, Fblocks2, Fblocks3 or Modules, when selected from the screen menu, will not display an icon menu but a text menu containing the names of the available variations of the selected function block or configuration function. In pull−down menus you would have icons instead of names. The screen menu and its menus always have the text FbCAD on the topmost line. Selecting it will bring you back to the highest screen menu level. Select items as in pull−down menus: 1
Highlight an item by pointing it with the mouse.
2
Press the left button to select the highlighted item.
3
After selecting it you will get a related submenu with commands and new menus.
Rev. 2
Screen Menu 129
Screen menu structure:
Figure 120
FbCAD screen menu
Following is a brief description of each command in the menu. For further information on using the commands, see chapter 7 Menu Bar. FbCAD This item is always displayed on the topmost line of a screen or submenu. Selecting it brings you back to the screen menu. File... The File item contains file handling commands, such as exiting FbCAD, printing function block diagrams, etc. Edit... The Edit item contains general function block diagram editing commands. View... Items in the View menu are used for display handling, such as zooming. With these items you can also determine which page and drawing layers of the function block diagram are visible on the display.
Rev. 2
130 FbCAD Manual
Draw... The Draw item contains commands for connecting function blocks and data points. Common... The Common item contains common automation language concepts, such as function block diagram, continuous controls, external− and local data points, constants and ports. Fblocks1... The Fblocks1 item contains Process Control Server function blocks and their variations. Fblocks2... As Fblocks1, but contains different function blocks. Fblocks3... As Fblocks1 and Fblocks2, but contains the rest of function blocks. I/O... The I/O item contains I/O functions and their variations. Modules... The Modules item contains configuration functions (tag, operation, event, history and trend functions and mimic panel controls) and their variations; it also provides access to the recipe, PLU, MCP, DIS and LIS menus and to the simulation functions. FbCADHelp... The FbCADHelp item gives help on commands and types. It also shows the version information of the tool. Values Values command enables entering and editing the attribute values for function block diagram symbols. For more details, see the menu bar item Edit−Values. Design Members Design Members command enables you to change the values of the design members used in formulas. Formulas... Formulas item contains editing commands related to the value and function formulas of the function block diagram. Previous page Previous page command you can use to move to the previous page in a multi−page function block diagram. Select page The Select Page command lets you move to the desired page. On the command line, you will be asked for the page where you want to move. Next page Next page command you can use to move to the next page in a multi−page function block diagram.
Rev. 2
Screen Menu 131
Gedit The Gedit command allows you to select an attribute value (e.g. loop’s tag identifier) and change it throughout the function block diagram with one command. Sedit Using the Sedit command you can change the attributes (such as loop tag identifier) of selected blocks with only one command. Aedit Aedit allows you to change the attributes of single symbols in the function block diagram. The attributes are changed using a command that resembles a line editor. Fedit In a function block diagram, Fedit allows you to edit the formulas in the Formula column of different dialogs, either in all objects at the same time or in selected objects. Tedit Tedit allows you to edit the texts in a function block diagram either in all objects at the same time or in selected objects. Editable texts can be, for example, comment texts and connection dot specifiers. Eedit Eedit allows you to edit the attribute values of symbols in Microsoft Excel. Renum The Renum command lets you renumber the function blocks to set their execution order. ChBlk The ChBlk command can be used to replace a symbol so that the entered old values are maintained. UpdBlk The UpdBlk command can be used to update symbol to its newer version. Edit text Edit text command allows you to modify the selected text in a function block diagram. Tools... The Tools item contains Object Snap modes which help you to align items drawn in the funtion block diagram. These modes are valid as long as points are being selected. Object Snap modes help you to locate function blocks and to make connections. The selected Object Snap mode stays on until another mode is chosen or None item is selected. When Osnap modes are used, a pickbox is shown at the intersection point of the mouse cursor.
Rev. 2
132 FbCAD Manual
Following is the structure of the Tools menu.
Figure 121
Structure of the Tools menu
CENter
Center of arc or circle
ENDpoint
End point of line or arc
INTersec
Selects the intersection of two object lines or arcs
MIDpoint
Middle point of line or arc
NEArest
Nearest point of an object
NODe
Point snapping
PERpend
Perpendicular snap
QUAdrant
Nearest quadrant of an arc or line
TANgent
Tangential snap
None
Snap off
For more details on these commands see the CAD manuals.
Rev. 2
Dialogs for Configuration Functions 133
9
DIALOGS FOR CONFIGURATION FUNCTIONS
9.1
DIALOGS FOR TAG FUNTIONS
9.1.1
Tag function for analog measurement (am) The following table presents the attributes of the tag function for analog measurements which are asked in the dialog: TAG MODULE NAME I
TAG_CODE
CONTROL ROOM IDENTIFIER
A1
NAME TEXT 1(14char) NAME TEXT 2(14char) NAME TEXT 3(20char) TAG_CODE 1(14char)
TAG_CODE
TAG_CODE 2(14char) TAG_CODE 3(14char) INFO DISP HIERARCHY CODE OPERATING MODULE NAME
TAG_CODE
MEASUREMENT MINIM VALUE
0
MEASUREMENT MAXIM VALUE
100
NUMBER OF DECIMALS(0−5)
0
UNIT OF MEAS VAL.(8char)
%
OPERABILITY OF TAG
1
OPERABILITY OF MEAS.
0
HIERARCHY CODE OF DISPL
0
HH(0= ,1=ALM,2=MSG)
0
H (0= ,1=ALM,2=MSG)
1
L (0= ,1=ALM,2=MSG)
1
LL(0= ,1=ALM,2=MSG)
0
F (0= ,1=ALM,2=MSG)
1
HH OPERATOR TRACKING
0
H OPERATOR TRACKING
0
L OPERATOR TRACKING
0
LL OPERATOR TRACKING
0
OUT OPERATOR TRACKING
0
MASK OPERATOR TRACKING
0
OPERATING AREA (1−64)
1
Rev. 4
134 FbCAD Manual
TAG MODULE NAME The TAG MODULE NAME and CONTROL ROOM IDENTIFIER fields are used to generate the identifiers for tag functions. If, for instance, you type LI−100 in the name field and A1 for the control room identifier, the identifier ce:A1:LI−100 is generated for tag functions. CONTROL ROOM IDENTIFIER The CONTROL ROOM IDENTIFIER field determines the destination operation package(s) to which the tag functions will be placed. See also previous item. NAME TEXT 1 (14 char) The generally used name text comprises 14 characters. A tag may be assigned several name texts for different pictures. It is used mainly in trend, recorder and group pictures. NAME TEXT 2 (14 char) An abbreviated name of a max. of 14 characters. NAME TEXT 3 (20 char) Long descriptive name with a max. length of 20 characters. Generally used in alarm and loop pictures. TAG_CODE 1 (14 char) A general tag identifier with a max. length of 14 characters. A tag may be assigned several tag texts for different pictures. For example, if the beginning of the tag (department identifier) is evident on the basis of the selected picture type, it is possible to use the shorter tag code 2 in a display function block instead of referring to the whole tag (tag identifier). TAG_CODE 2 (14 char) Abbreviated tag identifier with a max. length of 14 characters. TAG_CODE 3 (14 char) Long tag identifier with a max. length of 14 characters. INFO DISP HIERARCHY CODE Hierarchy identifier of an event−related info display (in an event picture the indicated picture can be accessed through the I character). OPERATING MODULE NAME Tag identifier of the operation function to be picked for an loop picture. Its max. length is 32 characters. One must not enter the whole hierarchy identifier, but only the tag identifier. For example, if the operation function identifier is od:A1:LI−100, you should type LI−100 in this field. If you do not want the loop picture, leave the field blank. MEASUREMENT MINIM VALUE The lower limit or the measurement area is given as a whole number or a decimal fraction. Output has a max. of seven characters including decimal point and sign. The number of decimal places is indicated separately.
Rev. 4
Dialogs for Configuration Functions 135
MEASUREMENT MAXIM VALUE The upper limit of the measurement area is given as a whole number or a decimal fraction. Output displays a max. of seven characters including the decimal point and sign. The number of decimal places is indicated separately. NUMBER OF DECIMALS(0−5) Accuracy of measurement area is given as number of decimal places (0−5). UNIT OF MEAS VAL.(8 char) The unit of measured value comprises a max. of eight characters. OPERABILITY OF TAG Operability data for entire tag. 0 = non−operable 1 = operable OPERABILITY OF MEAS. Operability data for measured value. 0 = non−operable 1 = operable HIERARCHY CODE OF DISPL When using DNAuse, the display function identifier (e.g. gd:A1:DISPERGER) of the event−related picture is entered in the this field. In case of DNAops, you need to enter the hierarchy identifier (e.g. 3.3.2) of the event−related picture. The picture is opened on the display by browsing the event line with the browse buttons, or by using the “related picture” function on the corresponding line on the event list. Note that if the picture hierarchy is changed, in DNAuse the display function identifier will always refer to the correct picture while in DNAops the hierarchy identifier must be manually updated in the dialog. HH(0= ,1=ALM,2=MSG) The upper limit event type. 0 = no event is generated 1 = event generates an alarm 2 = event generates a message In addition, an interface port, based on the data, is created in the event function. It includes alarm/message texts for the event function. 0 = no interface port is created 1 = the event generates an alarm 2 = the event generates a message Note that this attribute must be filled out in conformity with the corresponding attribute of the event function. H (0= ,1=ALM,2=MSG) As HH, but for the upper limit event. Note that this area must be filled out in conformity with the corresponding area of the event function.
Rev. 4
136 FbCAD Manual
L (0= ,1=ALM,2=MSG) As HH, but for the lower limit event. Note that this area must be filled out in conformity with the corresponding area of the event function. LL(0= ,1=ALM,2=MSG) As HH, but for the lower lower limit event. Note that this area must be filled out in conformity with the corresponding area of the event function. F (0= ,1=ALM,2=MSG) As HH, but for the fault alarm event. Note that this area must be filled out in conformity with the corresponding area of the event function. HH OPERATOR TRACKING The higher high limit operator tracking. 0 = operator tracking is off 1 = operator tracking is on If operator tracking has been set on an operation event is generated when the operator changes the higher high limit. Operation event message appears in the event list. H OPERATOR TRACKING As HH OPERATOR TRACKING, but for the high limit.g measurement (type ’ampos’). L OPERATOR TRACKING As HH OPERATOR TRACKING, but for the low limit. LL OPERATOR TRACKING As HH OPERATOR TRACKING, but for the lower low limit. OUT OPERATOR TRACKING As HH OPERATOR TRACKING, but for the output value. MASK OPERATOR TRACKING Event masking tracking. 0 = operator tracking is off 1 = operator tracking is on If operator tracking has been set on an operation event is generated when the operator masks an event. Operation event message appears in the selected event list. OPERATING AREA (1−64) One of the 64 possible alternatives can be chosen for the event area of an event.
Rev. 4
Dialogs for Configuration Functions 137
IN GRAPHIC PICTURE 1
Name text or tag identifier
2
Measuring range
3
Unit
4
Lower low, low, high, and higher high alarm limits
2 1
3
IN LOOP PICTURE
2 1 3
4
Figure 122
Rev. 4
Items affected by the tag data
138 FbCAD Manual
9.1.2
Tag function for profiles (pro, pro2) The following table presents the attributes of the tag functions for profile which are asked in the dialog. The ten first attributes of the dialog are similar to the ones in the tag function for analog measurement. TAG MODULE NAME I
TAG_CODE
CONTROL ROOM IDENTIFIER
A1
NAME TEXT 1(14char) NAME TEXT 2(14char) NAME TEXT 3(20char) TAG_CODE 1(14char)
TAG_CODE
TAG_CODE 2(14char) TAG_CODE 3(14char) INFO DISP HIERARCHY CODE OPERATING MODULE NAME
TAG_CODE
MONITOR WINDOW OPERABILITY OF TAG
0
HIERARCHY CODE OF DISPL
0
NUMBER OF DECIMALS(0−5)
0
LOW LIMIT
−999900000
HIGH LIMIT
999900000
RATE OF CHANGE
999900000
BENDLIMIT
999900000
LIMITS (0=%,1=ABS)
0
STATE 0 TEXT(max 6) ........VALUE
0
........OPERABILITY
0
STATE 1 TEXT(max 6) ........VALUE
0
........OPERABILITY
0
STATE 2 TEXT(max 6) ........VALUE
0
........OPERABILITY
0
STATE 3 TEXT(max 6) ........VALUE
0
........OPERABILITY
0
STATE 4 TEXT(max 6) ........VALUE
0
........OPERABILITY
0
OPERATOR TRACKING
0
OPERATING AREA (1−64)
1
Rev. 4
Dialogs for Configuration Functions 139
MONITOR WINDOW Name of the window function. OPERABILITY OF TAG Operability data on entire tag. 0 = cannot be operated 1 = can be operated HIERARCHY CODE OF DISPL When using DNAuse, the display function identifier (e.g. gd:A1:DISPERGER) of the event−related picture is entered in the this field. In case of DNAops, you need to enter the hierarchy identifier (e.g. 3.3.2) of the event−related picture. The picture is opened on the display by browsing the event line with the browse buttons, or by using the “related picture” function on the corresponding line on the event list. Note that if the picture hierarchy is changed, in DNAuse the display function identifier will always refer to the correct picture while in DNAops the hierarchy identifier must be manually updated in the dialog. NUMBER OF DECIMALS(0−5) Accuracy of measurement or current area. Indicated as decimal places (0−5). LOW LIMIT The low limit of the data given by operator. HIGH LIMIT The high limit of the data given by operator. RATE OF CHANGE The rate of change of the data given by operator. BENDLIMIT Limits the changing of the data compared with adjoining data. LIMITS (0=%,1=ABS) The way of counting the quality limits 0 = span is percentage of reference value 1 = span is absolute value
STATE 0 TEXT(max 6) Text of the state. ........VALUE Value of the state. ........OPERABILITY Operability of the state. 0 = disabled 1 = enabled
Rev. 4
140 FbCAD Manual
OPERATOR TRACKING The profile alarm limit operator tracking. 0 = operator tracking is off 1 = operator tracking is on If operator tracking has been set on an operation event is generated when the operator changes the profile alarm limit. Operation event appears in the event lis. OPERATING AREA (1−64) One of the 64 possible alternatives can be chosen for the event area of an event.
Rev. 4
Dialogs for Configuration Functions 141
9.1.3
Tag function for profile scaling (prosca, pr2sc) The following table presents the attributes of the tag functions for profile scaling which are asked in the dialog: TAG MODULE NAME
TAG_CODE
CONTROL ROOM IDENTIFIER
A1
SCALE PRECISION
1
FIRST VALUE OF X−AXIS
0
LAST VALUE OF X−AXIS
100
X−AXIS SCALE UNIT
10
OFFSET FROM FIRST VALUE
10
NBR OF ACT.IN SCALING
0
TAG MODULE NAME The TAG MODULE NAME and CONTROL ROOM IDENTIFIER fields are used to generate the identifiers for tag functions. If, for instance, you type LI−100 in the name field and A1 for the control room identifier, the identifier ce:A1:LI−100 is generated for tag functions. CONTROL ROOM IDENTIFIER The CONTROL ROOM IDENTIFIER field determines the destination operation package(s) to which the tag functions will be placed. See also previous item. SCALE PRECISION The precision of the scale. FIRST VALUE OF X−AXIS The first value of the x−axis. LAST VALUE OF X−AXIS The last value of the x−axis. X−AXIS SCALE UNIT The unit of the x−axis scale. OFFSET FROM FIRST VALUE The offset from the first value. NBR.OF ACT.IN SCALING Number of actuators in actuator scaling. UPDATE DIRECTION Update direction of the profile (0=from left to right, 1=from right to left). This attribute is used only in pr2sc tag functions.
Rev. 4
142 FbCAD Manual
9.1.4
Tag function for scanners (sc) The following table presents the attributes of the tag function for scanners which are asked in the dialog. The ten first attributes of the dialog are similar to the ones in the tag function for analog measurement. TAG MODULE NAME
TAG_CODE
CONTROL ROOM IDENTIFIER
A1
NAME TEXT 1(14char) NAME TEXT 2(14char) NAME TEXT 3(20char) TAG_CODE 1(14char)
TAG_CODE
TAG_CODE 2(14char) TAG_CODE 3(14char) INFO DISP HIERARCHY CODE OPERATING MODULE NAME MONITOR WINDOW OPERABILITY OF TAG
1
HIERARCHY CODE OF DISPL
0
MEASUREMENT MINIM VALUE
0
MEASUREMENT MAXIM VALUE
30
UNIT OF MEAS VAL(13char) TAG_CODE 2 (14 char) Abbreviated tag identifier with a max. length of 14 characters. TAG_CODE 3 (14 char) Long tag identifier with a max. length of 14 characters. INFO DISP HIERARCHY CODE Hierarchy identifier of an event−related info display (in an event picture the indicated picture can be accessed through the I character). OPERATING MODULE NAME Tag identifier of the operation function to be picked for an loop picture. Its max. length is 32 characters. One must not enter the whole hierarchy identifier, but only the tag idenytifier. For example, if the operation function identifier is od:A1:LI−100, you should type LI−100 in this field. If you do not want the loop picture, leave the field blank. MONITOR WINDOW Name of the window function. OPERABILITY OF TAG Operability data on entire tag. 0 = cannot be operated 1 = can be operated
Rev. 4
Dialogs for Configuration Functions 143
HIERARCHY CODE OF DISPL When using DNAuse, the display function identifier (e.g. gd:A1:DISPERGER) of the event−related picture is entered in the this field. In case of DNAops, you need to enter the hierarchy identifier (e.g. 3.3.2) of the event−related picture. The picture is opened on the display by browsing the event line with the browse buttons, or by using the “related picture” function on the corresponding line on the event list. Note that if the picture hierarchy is changed, in DNAuse the display function identifier will always refer to the correct picture while in DNAops the hierarchy identifier must be manually updated in the dialog. MEASUREMENT MAXIM VALUE The upper limit of the measurement range is given as a whole number or a decimal. Output consists of a max. of seven characters including decimal point and sign. Accuracy is entered separately. MEASUREMENT MINIM VALUE The lower limit of the measurement range is given as a whole number or a decimal. Output consists of a max. of seven characters including decimal point and sign. Accuracy is entered separately. UNIT OF MEAS VAL.(13char) The unit of measurement comprises a max. of 13 characters.
Rev. 4
144 FbCAD Manual
9.1.5
All tag functions (except those of profiles) All data requested by various tag functions are presented in alphabetical order below: If the tag function type is indicated as ’XXpos’, it means that in connection with a pid function block ”’XXpos’ member ’optm’ refers to ’pidpos’ member ’optm’ and correspondingly in the case of a mtr function block ’mtrpos’ member ’optm’. Alarm 0=No 1=Alm Definition of an alarm related with function block’s member NNN. 0 = alarm will not be generated for NNN 1 = alarm will be generated for NNN If alarm is generated, a salmo−type interface port having the member’s name NNN and containing the alarm−related data will be created in tag function. If alarm is not generated, the interface port will not be created. Tag data member NNNdsp (for type TTTpos, where TTT is the function block’s name, e.g. mcapos) will also be created in the tag function from this field. NNNdsp determines whether an alarm related with the function block’s member NNN is maskable from loop picture or not. Always when an alarm is generated for a member it is also maskable, i.e., the member’s masking key is displayed in loop picture. If alarm is not generated, the masking key will not be displayed. NOTE! The alarm must also be defined to event function consistently with this. Alarm distribution group Not in use. ALM/MSG TEXT (15char) Event line text. Defines text displayed on event line. ALM (0= ,1=ALM,2=MSG) Type of event. 0 = no event is generated 1 = event generates an alarm 2 = event generates a message In addition, an interface port corresponding to said data is created in the event function. 0 = no interface port is generated 1 = a ’salmo’ type interface port 2 = a ’smsgo’ type interface port APPLIC. 1 NAME(8char) Name of application data 1; max. nine characters. APPLIC. 2 NAME(8char) Name of application data 2; max. nine characters. APPLIC. 1 SYMB(2char) Symbol for application data 1; max. 2 characters. APPLIC. 2 SYMB(2char) Symbol for application data 2; max. 2 characters.
Rev. 4
Dialogs for Configuration Functions 145
COH (0= ,1=ALM,2=MSG) As FM (0= ,1=ALM, 2=MSG), but control message upper limit event type. COH OPERATOR TRACKING The control message high alarm limit operator tracking. 0 = operator tracking is off 1 = operator tracking is on If operator tracking has been set on an operation event is generated when the operator changes the control message high alarm limit. Operation event appears in the event list. It includes information for the operation event message. COL (0= ,1=ALM,2=MSG) As FM (0= ,1=ALM, 2=MSG), but control message upper limit event type. COL OPERATOR TRACKING As COH OPERATOR TRACKING, but for the control message low alarm limit. CON OPERATOR TRACKING As COH OPERATOR TRACKING, but for the control message. CONTROL ROOM IDENTIFIER The CONTROL ROOM IDENTIFIER field determines the destination operation package(s) to which the tag functions will be placed. COUNTER UNIT (8char) Counter unit. A max. of eight characters. COUNT OPERATOR TRACKING As COH OPERATOR TRACKING, but for the counter value. CURH (0= ,1=ALM,2=MSG) As FON (0= ,1=ALM,2=MSG), but the overload current lower upper limit event type. CURHH (0= ,1=ALM,2=MSG) As FON (0= ,1=ALM,2=MSG), but the overload current upper upper limit event type. CURRENT UNIT (1char) Current unit; one character. DIST (0= ,1=ALM,2=MSG) Event type for a fault alarm Event type. 0 = not an event 1 = generate an alarm 2 = event generates a message In addition, an interface port corresponding to the data in question is generated in the event function. 0 = no interface port is generated 1 = a salmo−type interface port 2 = a smsgo−type interface port
Rev. 4
146 FbCAD Manual
E1 (0= ,1=ALM,2=MSG) As FON (0= ,1=ALM,2=MSG), but event type for external input 1. E2 (0= ,1=ALM,2=MSG) As FON (0= ,1=ALM,2=MSG), but event type for external input 2. E3 (0= ,1=ALM,2=MSG) As FON (0= ,1=ALM,2=MSG), but event type for external input 3. E4, E5 and E6 In the same fashion as E1, E2 and E3. EH (0= ,1=ALM,2=MSG) As FM (0= ,1=ALM,2=MSG), but event type for differential value higher limit. EH OPERATOR TRACKING As COH OPERATOR TRACKING, but for the differential value high alarm limit. EL (0= ,1=ALM,2=MSG) As FM (0= ,1=ALM,2=MSG), but event type for differential value lower limit. EL OPERATOR TRACKING As COH OPERATOR TRACKING, but for the differential value low alarm limit. EveMaskOpTrac 0=No 1=Yes The same as MASK OPERATOR TRACKING, but this is specified individually for the function block’s different events (members). EventFallEdgeText 15char This field specifies the text, displayed on event line, for an event’s (actually a message’s) falling edge. This text is required if message is generated from falling edge. The text is stored in member fall3 of tag function’s message−type (smsgo) interface port NNN. NNN in the interface port’s name is the function block’s member for which the event is generated. EventRiseEdgeText 15char This field specifies the text, displayed on event line, for an event’s (alarm’s or message’s) rising edge. This text is required if alarm or message is generated from rising edge. The text is stored in member text3 of alarm−type (salmo) interface port NNN and in member rise3 of message−type (smsgo) interface port NNN of the tag function. NNN in the interface ports’ names is the function block’s member for which the event is generated. EVNT JOIN DISP HIER CODE The same as HIERARCHY CODE OF DISPL. EXT INPUT 1 NAME(9char) Name of external input 1; max. 9 characters. EXT INPUT 2 NAME(9char) As EXT. INPUT 1 NAME (9 char), but for external input 2.
Rev. 4
Dialogs for Configuration Functions 147
EXT INPUT 3 NAME(9char) As EXT. INPUT 1 NAME (9 char), but for external input 3. There are six pieces of external input data similar to the above. EXT INPUT 1 SYMB(2char) Symbol of external input 1; max. two characters. EXT INPUT 2 SYMB(2char) As EXT. INPUT 1 SYMB, but for external input 2. EXT INPUT 3 SYMB(2char) As EXT. INPUT 1 SYMB, but for external input 3. There are six pieces of external input data similar to the above. EXT INPUT 1 TEXT(15char) Event line text for external input 1 event. Determines which text is output to event line. EXT INPUT 2 TEXT(15char) As EXT. INPUT 1 TEXT (15 char), but for external input 2. EXT INPUT 3 TEXT(15char) As EXT. INPUT 1 TEXT (15 char), but for external input 3. There are six pieces of external input data similar to the above. F (0= ,1=ALM,2=MSG) As HH,but for fault alarm event Note that this area is to be identical with the corresponding area of the event function. FC (0= ,1=ALM,2=MSG) As FM (0= ,1=ALM,2=MSG), but event type for forced control. FM (0= ,1=ALM,2=MSG) Event type for forced manual control. Event type. 0 = not an event 1 = generate an event 2 = generate a message In addition, an interface port whose type corresponds to the specified data will be created in tag function. 0 = no interface port 1 = salmo−type interface port 2 = smsgo−type interface port FOFF (0= ,1=ALM,2=MSG) As FON (0= ,1=ALM,2=MSG), but event type for forced control off.
Rev. 4
148 FbCAD Manual
FON (0= ,1=ALM,2=MSG) Event type for forced control on. Event type. 0 = not an event 1 = generate an alarm 2 = generate a message In addition, an interface port whose type corresponds to the specified data will be created in tag function. 0 = no interface port 1 = salmo−type interface port 2 = smsgo−type interface port H (0= ,1=ALM,2=MSG) As HH, but type for higher limit event. Note that this area is to be identical with the corresponding area of the event function. H OPERATOR TRACKING As COH OPERATOR TRACKING, but for the high limit. HH(0= ,1=ALM,2=MSG) Event type for the higher upper limit. 0 = not an event 1 = generate an alarm 2 = generate a message In addition, an interface port corresponding to the data in question is generated in the event function that include alarm/message texts for the event function. 0 = no interface port 1 = salmo−type interface port 2 = smsgo−type interface port Note that this area is to be identical with the corresponding area of the event function. HH OPERATOR TRACKING As COH OPERATOR TRACKING, but for the higher high limit. HHTD OPERATOR TRACKING Operator tracking of higher high limit’s event delay 0 = operator tracking is off 1 = operator tracking is on If operator tracking has been set on an operation event is generated when the operator changes the higher high limit’s event delay. Operation event appears in the event list.
Rev. 4
Dialogs for Configuration Functions 149
HIERARCHY CODE OF DISPL When using DNAuse, the display function identifier (e.g. gd:A1:DISPERGER) of the event−related picture is entered in the this field. In case of DNAops, you need to enter the hierarchy identifier (e.g. 3.3.2) of the event−related picture. The picture is opened on the display by browsing the event line with the browse buttons, or by using the “related picture” function on the corresponding line on the event list. Note that if the picture hierarchy is changed, in DNAuse the display function identifier will always refer to the correct picture while in DNAops the hierarchy identifier must be manually updated in the dialog. HTD OPERATOR TRACKING As HHTD OPERATOR TRACKING, but for the high limit. INFO DISP HIERARCHY CODE Hierarchy identifier of an event−related info display (in a event picture the picture indicated here can be accessed through the I character). INTR (0= ,1=ALM,2=MSG) Event type for interrupt alarm. Event type. 0 = not an event 1 = generate an alarm 2 = generate a message In addition, an interface port whose type corresponds to the specified data will be created in tag function. 0 = no interface port 1 = salmo−type interface port 2 = smsgo−type interface port ISP OPERATOR TRACKING As COH OPERATOR TRACKING, but for the setpoint selection index (local, remote or computer). KFF OPERATOR TRACKING As COH OPERATOR TRACKING, but for the feedforward channel gain. KP OPERATOR TRACKING As COH OPERATOR TRACKING, but for the P term gain. L (0= ,1=ALM,2=MSG) As HH, but for the lower limit event. Note that this area is to be identical with the corresponding area of the event function. L OPERATOR TRACKING As COH OPERATOR TRACKING, but for the lower limit. Live data (0=Off, 1=0n) Determines whether the current live value of the alarming signal (e.g. measurement) is displayed in the event browser lines of all limit events of the tag (e.g. the higher limit event of the measurement), or not. 0 = Not displayed 1 = Displayed
Rev. 4
150 FbCAD Manual
LL(0= ,1=ALM,2=MSG) As HH, but for the lower lower limit event. Note that this area is to be identical with the corresponding area of the event function. LL OPERATOR TRACKING As COH OPERATOR TRACKING, but for the lower low limit. LLTD OPERATOR TRACKING As HHTD OPERATOR TRACKING, but for the lower low limit. LTD OPERATOR TRACKING As HHTD OPERATOR TRACKING, but for the lower limit. MA OPERATOR TRACKING As COH OPERATOR TRACKING, but for the manual/auto selection. MASK OPERATOR TRACKING Event masking tracking. 0 = operator tracking is off 1 = operator tracking is on If operator tracking has been set on an operation event is generated when the operator masks an event. Operation event message appears in the selected event list. MAX VALUE OF CONTR SCALE Upper limit of control signal area. MEAS SCAL DESIM NUMB 0−5 The same as NO OF DEC. IN MEAS.(0−5). MEASUREMENT MAXIM VALUE The upper limit of the measurement range is given as a whole number or a decimal. Output consists of a max. of seven characters including decimal point and sign. Accuracy is entered separately. MEASUREMENT MINIM VALUE The lower limit of the measurement range is given as a whole number or a decimal. Output consists of a max. of seven characters including decimal point and sign. Accuracy is entered separately. MEASUREM SCALE MAX VALUE The same as MEASUREMENT MAXIM VALUE. MEASUREM SCALE MIN VALUE The same as MEASUREMENT MINIM VALUE. MEASURE VALUE UNIT 5char The same as UNIT OF MEAS VAL.(8char). MEH (0= ,1=ALM,2=MSG) As FM (0= ,1=ALM,2=MSG), but event type for the higher limit. MEH OPERATOR TRACKING As COH OPERATOR TRACKING, but for the measured value high alarm limit.
Rev. 4
Dialogs for Configuration Functions 151
MEHH(0= ,1=ALM,2=MSG) As FM (0= ,1=ALM,2=MSG), but event type for the higher upper limit. MEHH OPERATOR TRACKING As COH OPERATOR TRACKING, but for the measured value higher high alarm limit. MEL (0= ,1=ALM,2=MSG) As FM (0= ,1=ALM,2=MSG), but event type for the lower limit. MEL OPERATOR TRACKING As COH OPERATOR TRACKING, but for the measured value low alarm limit. MELL(0= ,1=ALM,2=MSG) As FM (0= ,1=ALM,2=MSG), but event type for the lower lower limit. MELL OPERATOR TRACKING As COH OPERATOR TRACKING, but for the measured value lower low alarm limit. Message 0=No 1=Msg Definition of a message related with function block’s member NNN. 0 = message will not be generated for NNN 1 = message will be generated for NNN NOTE! The message must also be defined to event function consistently with this. MSG TEXT FALLING EDGE Message line text for falling edge Determine the text that should be output to the event line as the signal has a falling edge. MIN VALUE OF CONTR SCALE Lower limit of control signal area. M OPERATOR TRACKING As COH OPERATOR TRACKING, but for the manual control. Name 9 char The same as EXT INPUT 1 NAME(9 char), but for external input 1−6. NAME TEXT 1 (14 char) The generally used name text with a max. length of 14 characters. Different name texts can be assigned to the tag for different pictures. They are normally used for trend, plotter and group pictures. NAME TEXT 2 (14 char) An abbreviated name with a max. length of 14 characters. NAME TEXT 3 (20 char) A long, explanatory name with a max. length of 20 characters. Generally used on alarm and loop pictures.
Rev. 4
152 FbCAD Manual
NNNN ==================== Title field, where nothing will be entered. NNNN defines the function block’s member specified in the fields after the title. NO OF DEC. OF CONTR(0−5) No. of decimal places of control message area is 0−5. NO OF DEC. IN MEAS.(0−5) The measurement range consists of 0−5 decimal place. NUMBER OF DECIMALS(0−5) Accuracy of measurement or current area. Indicated as decimal places (0−5). OPERABILITY OF KFF−PARAM Operability data on KFF parameter. 1 = not operable 2 = operable OPERABILITY OF KP−PARAM Operability data on KP parameter. 1 = not operable 2 = operable OPERABILITY OF MEAS. Operability data on measurement value. 0 = not operable 1 = operable OPERABILITY OF TAG Operability data on entire tag. 0 = cannot be operated 1 = can be operated OPERABILITY OF TD−PARAM Operability data on TD parameter. 0 = not operable 1 = operable OPERABILITY OF TDF−PARAM Operability data on TDF parameter. 0 = not operable 1 = operable OPERABILITY OF TI−PARAM Operability data on TI parameter. 0 = not operable 1 = operable OPERATING AREA (1−64) One of the 64 possible alternatives can be chosen for the event area of an event.
Rev. 4
Dialogs for Configuration Functions 153
OPERATING MODULE NAME Tag identifier of the operation function to be called into an loop picture; max. length 32 characters. You must not enter the entire hierarchy identifier but only the tag identifier. For example, if the operation function identifier is od:A1:HS−111, you should type HS−111. If you do not want the loop picture, leave the field blank. OPERATOR TRACK AREA 1−64 The same as OPERATING AREA (1−64). OPERATOR TRACKING As COH OPERATOR TRACKING, but for the binary direct access port or profile. OperTracking 0=No 1=Yes The same as COH OPERATOR TRACKING, but for different members of the function block. OUT OPERATOR TRACKING As COH OPERATOR TRACKING, but for the output value. PCS prefix In this field you enter the prefix, without colon (e.g. pr, li, ci,...), of the Process Control/Interface Server connection’s tag identifier. Related tag name(s) Not in use. SETPOINT1 OPERABILITY Operability data on set point 1. 0 = not operable 1 = operable SETPOINT2 OPERABILITY Operability data on set point 2. 0 = not operable 1 = operable SETPOINT3 OPERABILITY Operability data on set point 3. 0 = not operable 1 = operable SMASK OPERATOR TRACKING As COH OPERATOR TRACKING, but for the limit switch mask. SP1 OPERATOR TRACKING As COH OPERATOR TRACKING, but for the setpoint 1 (local). SP2 OPERATOR TRACKING As COH OPERATOR TRACKING, but for the setpoint 2 (remote).
Rev. 4
154 FbCAD Manual
SP3 OPERATOR TRACKING As COH OPERATOR TRACKING, but for the setpoint 3 (computer). ..STATE 0 TEXT(max 10) Indicates the operation event message text for state 0 in the tag function of binary signal (type ’binpos’). ..STATE 1 TEXT(max 10) Indicates the operation event message text for state 1 in the tag function of binary signal (type ’binpos’). Symbol 2 char The same as EXT INPUT 1 SYMB(2 char), but for external input 1−6. TAG_CODE 1 (14 char) A general tag identifier; max. length 14 characters. A tag can be assigned several tag texts for different pictures. For example, when the beginning of the tag (department identifier) is evident on the basis of the selected picture type, it is possible to use the shorter tag identifier 2 instead of referring to the whole tag (tag identifier 1) in a display funtion block. TAG_CODE 2 (14 char) An abbreviated tag identifier; max. length 14 characters. TAG_CODE 3 (14 char) A long tag identifier; max. length 14 characters. TAG MODULE NAME The TAG MODULE NAME and CONTROL ROOM IDENTIFIER fields are used to generate identifiers for tag functions. If, for example, you type HS−111 in the name field and enter A1 for the control room code, the tag functions are named ce:A1:HS−111. TD OPERATOR TRACKING As COH OPERATOR TRACKING, but for the derivative action time constant. TDF OPERATOR TRACKING As COH OPERATOR TRACKING, but for the derivative action low−pass filter time constant. TI OPERATOR TRACKING As COH OPERATOR TRACKING, but for the integral action time constant. UNIT OF CONTROL (8char) Control signal unit, max. eight characters. UNIT OF MEAS VAL.(8char) The unit of measurement comprises a max. of eight characters. In mca’s loop picture, the measured value’s unit should not be more than 5 characters long if we want it displayed tidily.
Rev. 4
Dialogs for Configuration Functions 155
WD (0= ,1=ALM,2=MSG) In the case of ’mtr’ and ’mgv’ function blocks as FON (0= ,1=ALM,2=MSG), but event type for watchdog failure. In the case of ’pid’ function block as FM (0= ,1=ALM,2=MSG), but event type for control failure.
1
Name text or tag identifier
2
External input 1
3
External input 2
4
External input 3
5
External input 4
6
External input 5
7
External input 6
IN GRAPHIC PICTURE
1
IN LOOP PICTURE 1 2 3 4 5 6 7
Figure 123
Rev. 4
Items affected by the tag data
156 FbCAD Manual
IN GRAPHIC PICTURE
1
Name text and tag identifier
2
Measured value and setpoint scale
3
Measured value and setpoint unit
4
Output signal unit
5
Output signal’s low and high alarm limits (message)
6
Measured value’s lower low, low, high, and higher high alarm limits (message)
1 3 4
IN LOOP PICTURE 1 2
3
6 4
5 Figure 124
Items affected by controller’s tag data
Rev. 4
Dialogs for Configuration Functions 157
9.2
DIALOGS FOR OPERATION FUNCTIONS
9.2.1
Operation function (amop) for analog measurement The following table presents the attributes of the operation function for analog measurement which are asked in the dialog: OPERATING MODULE NAME
TAG_CODE
CONTROL ROOM IDENTIFIER
A1
TAG CODE OF TAG MODULE
TAG_CODE
DIRECTORY IDENTIFIER
pr
TAG CODE OF PR.ST.DATA
TAG_CODE
TAG CODE OF ALARM DATA
TAG_CODE
SELECTION OF TEXT 1(0−6)
3
SELECTION OF TEXT 2(0−6)
4
NUMBER OF DECIMALS(0−5)
0
OPERATING MODULE NAME The operation function identifiers are generated on the basis of the OPERATING MODULE NAME and the CONTROL ROOM IDENTIFIER. If, for instance, you type LI−100 in the name field and A1 for the control room identifier, the generated operation function identifier will be od:A1:LI−100. CONTROL ROOM IDENTIFIER The CONTROL ROOM IDENTIFIER determines the destination operation package(s) where the operation functions will be placed. See also previous item. TAG CODE OF TAG MODULE The tag identifier of the tag function related to the operation function, e.g. LI−100, is entered into the TAG CODE OF TAG MODULE field. DIRECTORY IDENTIFIER In the DIRECTORY IDENTIFIER field you enter the prefix, without colon (e.g. pr, li, ci,...), of the Process Control/Interface Server connection’s tag identifier. TAG CODE OF PR.ST.DATA The tag identifier of the operation function−related tag of the Process Control Server, e.g. LI−100, is entered into the TAG_CODE field of the TAG CODE OF PR.ST. DATA. TAG CODE OF ALARM DATA The tag identifier of the operation function−related tag of the Alarm Processor, e.g. LI−100, is entered into the TAG_CODE field of the TAG CODE OF ALARM DATA. SELECTION OF TEXT 1(0−6) Not in use. SELECTION OF TEXT 2(0−6) Not in use. NUMBER OF DECIMALS(0−5) Not in use.
Rev. 4
158 FbCAD Manual
9.2.2
All operation functions ’XXop’ and operation functions with direct access keys ’daop’ All the data requested in various operation functions’ dialogs are presented alphabetically below: If the operation function type is designated as ’XXop’, then in the case of the pid function block ”’XXop’, member ’alm’” refers to member ’alm’ of ’pidop’ and correspondingly in the case of the mtr function block refers to member ’alm’ of ’mtrop’. ALL SCANNERS OFF SHEET Identifier which runs all scanners off sheet, e.g. PK1−OFFALL COMPLEMENT.OF STATE DATA Complementation of the state data from the Process Control Server to the display: 0 = no complementation 1 = to be complemented CONTROL ROOM IDENTIFIER The CONTROL ROOM IDENTIFIER determines the destination operation package(s) where the operation functions will be placed. See also OPERATING MODULE NAME item. DIRECTORY IDENTIFIER In the DIRECTORY IDENTIFIER field you enter the prefix, without colon (e.g. pr, li, ci,...), of the Process Control/Interface Server connection’s tag identifier. DIRECT ACC KEY AREA(1−3) Not in use. KEY 1 NAME OF MODULE First tag identifier in the Related Loops dialog. You first fill in LI−100 which is expanded into od:A1:LI−100. There are a total of 19 tag identifiers. KEY 1 TEXT (10/20) Text corresponding the first tag on the selection list of the Related Loops dialog. There are a total of 19 texts. MAX LENGTH OF STATE TEXT Width of the state change key. MEAS SETTING SPEED msek Setpoint speed defines the interval between setpoint steps when running the setpoint with arrow keys from loop picture. MEASUREMENT ON DISPLAY This field defines whether the measured value and its unit will be displayed or not. 0 = measured value and unit will not be displayed 1 = measured value and unit will be displayed
Rev. 4
Dialogs for Configuration Functions 159
MEASUREM SETTING STEP % Setpoint step defines the steps by which the setpoint will increase or decrease when run with arrow keys from loop picture. NUMBER OF DECIMALS(0−5) Not in use. NO OF DEC. IN MEAS.(0−5) Not in use. NO OF DEC.OF OUTPUT(0−5) Not in use. OPERATING MODULE NAME The OPERATING MODULE NAME and CONTROL ROOM IDENTIFIER fields are used to generate identifiers for the operation functions. If, for instance, HS−111 is entered in the name field and A1 as the control room identifier, the operation function identifier becomes od:A1:HS−111. SELECTION OF TEXT 1(0−6) Not in use. SELECTION OF TEXT 2(0−6) Not in use. STATE 0 TEXT(max 10) State 0 text. Displayed according to connected PCS data. STATE 1 TEXT(max 10) State 1 text. Displayed according to connected PCS data. TAG CODE OF ALARM DATA The tag identifier, e.g. HS−111, of the tag of the Alarm Processor related to the operation function is entered in the TAG CODE OF ALARM DATA field. TAG CODE OF PR.ST.DATA The tag identifier of the tag function related to the operation function, e.g. HS−111, is entered into the TAG_CODE OF PR.ST. DATA field. TAG CODE OF TAG MODULE The tag identifier of the tag function related to the operation function, e.g. HS−111, is entered into the TAG CODE OF TAG MODULE field.
Rev. 4
160 FbCAD Manual
9.3
DIALOGS FOR MIMIC PANEL CONTROLS
9.3.1
Mimic panel control for binary signal The following table presents the attributes of the mimic panel control for binary signal which are asked in the dialog: MIMIC MODULE NAME
TAG_CODE
PACKAGE IDENTIFIER
AP0
EXECUTION INTERVAL
1000
PCS DATA
TAG_CODE:SPEC
PIC NUMBER (0−15)
0
CARD PLACE (5−20)
5
CHANNEL NUMBER (0−7)
0
FBC CARD PLACE (2−5)
2
TEST BUTTON
A1_TEST
MIMIC MODULE NAME The MIMIC MODULE NAME fields are used to generate identifiers for mimic panel controls. For instance, if LIC−100 is entered in the name field, the mimic panel control identifier becomes il:A1:LIC−106.F. PACKAGE IDENTIFIER Mimic panel control destination package or group of packages. EXECUTION INTERVAL Execution interval of application. PCS DATA Specifier is a binary signal which will be found with TAG_CODE given (direct access port). PIC NUMBER (0−15) Process interface controller’s number. CARD PLACE (5−20) I/O unit’s place in the rack. CHANNEL NUMBER (0−7) Channel number used. FBC CARD PLACE (2−5) Target FBC card’s place. TEST BUTTON Interface port A1_TEST will be generated for mimic panel test.
Rev. 4
Dialogs for Configuration Functions 161
9.3.2
All mimic panel controls All the data requested in various mimic panel controls’ dialogs are presented alphabetically below: CARD PLACE (5−20) I/O unit’s place in the rack. CHANNEL NUMBER (0−7) Channel number used. EXECUTION INTERVAL Execution interval of application. fault CARD PLACE (5−20) Motor’s fault status. I/O unit’s place in the rack. fault CHANNEL NMBR (0−7) Motor’s fault status. Channel number used. fault PIC NUMBER (0−15) Motor’s fault status. Process interface controller’s number. FBC CARD PLACE (2−5) Target FBC card’s place. MIMIC MODULE NAME The MIMIC MODULE NAME fields are used to generate identifiers for mimic panel controls. For instance, if LIC−100 is entered in the name field, the mimic panel control identifier becomes il:A1:HV−331.F. on CARD PLACE (5−20) Motor’s running status. I/O unit’s place in the rack. on CHANNEL NUMBER (0−7) Motor’s running status. Channel number used. on PIC NUMBER (0−15) Motor’s running status. Process interface controller’s number. open CARD PLACE (5−20) Valve’s open status. I/O units’s place in the rack. open CHANNEL NMBR(0−7) Valve’s open status. Channel number used. open PIC NUMBER (0−15) Valve’s open status. Process interface controller’s number. PACKAGE IDENTIFIER Mimic panel control destination package or group of packages.
Rev. 4
162 FbCAD Manual
PCS DATA Specifier is a binary signal which will be found with TAG_CODE given (direct access port). PIC NUMBER (0−15) Process interface controller’s number. TEST BUTTON Interface port A1_TEST will be generated for mimic panel test.
Rev. 4
Dialogs for Configuration Functions 163
9.4
DIALOGS FOR EVENT FUNCTIONS
9.4.1
Event function for analog measurement am The following table presents the attributes of the event function for analog measurement am* which are asked in the dialog: EVENT MODULE NAME
TAG_CODE
CONTROL ROOM IDENTIFIER
A1
DIRECTORY IDENTIFIER
pr
ALARM AREA (1−64)
1
MESSAGE AREA (1−64)
1
HH(0= ,1=ALM,2=MSG)
0
H (0= ,1=ALM,2=MSG)
1
L (0= ,1=ALM,2=MSG)
1
LL(0= ,1=ALM,2=MSG)
0
F (0= ,1=ALM,2=MSG)
1
1=0−>1, 2=1−>0 ALARM
1
−ACKN.REQ.(0=OFF,1=ON)
1
−ALARM PRIORITY
2
−USER (1−8)
1
−FREE GROUPING (10x16)
1
1=0−>1, 2=1−>0 MESSAGE
1
−ACKN.REQ.(0=OFF,1=ON)
1
−USER (1−8)
1
−FREE GROUPING (10x16)
1
EVENT MODULE NAME The EVENT MODULE NAME and CONTROL ROOM IDENTIFIER fields are used to generate identifiers for event functions. For instance, if LI−100 is entered in the name field and A1 as the control room identifier, the event function identifier becomes al:A1:LI−100. CONTROL ROOM IDENTIFIER Event functions are placed at alarm packages on the basis of the CONTROL ROOM IDENTIFIER field. See also prev. item. DIRECTORY IDENTIFIER In the DIRECTORY IDENTIFIER field you enter the prefix, without colon (e.g. pr, li, ci,...), of the Process Control/Interface Server connection’s tag identifier. ALARM AREA (1−64) One of the 64 possible alternatives can be chosen for the event area of an event. Thus each alarm can be assigned certain properties. More data is available in the Events handling document. MESSAGE AREA (1−64) One of the 64 possible alternatives can be chosen for the event area of an event. Thus each message can be assigned certain properties. More data are available in the Events handling document.
Rev. 4
164 FbCAD Manual
HH(0= ,1=ALM,2=MSG) The high high limit event type. The character of the event may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message Note that this area should be filled out in conformity with the corresponding tag function. H (0= ,1=ALM,2=MSG) High limit event type. See prev. item. Note that this area should be filled out in conformity with the corresponding tag function. L (0= ,1=ALM,2=MSG) Low limit event type. See item HH. Note that this area should be filled out in conformity with the corresponding tag function. LL(0= ,1=ALM,2=MSG) Low low limit event type. See item HH. Note that this area should be filled out in conformity with the corresponding tag function. F (0= ,1=ALM,2=MSG) Input signal disturbance type. See item HH. Note that this area should be filled out in conformity with the corresponding tag function. 1=0−>1, 2=1−>0 ALARM The field determines the type of change that activates an alarm: 1 = rising edge (0 −> 1) 2 = falling edge (1 −> 0) Note that in analog function blocks’ event functions the alarm is always activated by the rising edge (0 −> 1). −ACKN.REQ.(0=OFF,1=ON) This field determines whether the alarm requires the user’s acknowledgement: 0 = user’s acknowledgement not required 1 = user’s acknowledgement required In case acknowledgement is not required, the alarm colour does not blink and the monitor header does not respond to the alarm. −ALARM PRIORITY Alarm priority. The priorities 3 − 1000 can be used in metsoDNA CR collection 2006 or later, and the priorities 1 and 2 in collection 2005 or earlier. 801−1000 = high (critical), displayed in the alarm list with 5 symbols 601−800 = medium high (urgent), displayed in the alarm list with 4 symbols 401−600 = medium, displayed in the alarm list with 3 symbols 201−400 = medium low, displayed in the alarm list with 2 symbols 3−200 = low, displayed in the alarm list with one symbol 2 = urgent (collection 2005 or earlier), converted to collection 2006 priority 700 and displayed in the alarm list with 4 symbols 1 = critical (collection 2005 or earlier), converted to collection 2006 priority 900 and displayed in the alarm list with 5 symbols
Rev. 4
Dialogs for Configuration Functions 165
−USER (1−8) User of the alarm: 1 = process event (P) 2 = system event (SYS) 3 = user 3 events 4 . . 8 = user 8 events −FREE GROUPING (10x16) Ten freely definable grouping criteria, each consisting of 16 groups. (See Grouping chapter in Events handling document.) The field can be fed with numbers 1−16 into ten different groups, e.g. 1,1,1,1,1,2,2,3,5,1. 1=0−>1, 2=1−>0 MESSAGE The field determines the type of change that activates a message: 1 = rising edge (0 −> 1) 2 = falling edge (1 −> 0) −ACKN.REQ.(0=OFF,1=ON) The field determines whether the alarm requires the user’s acknowledgement before it ends: 1 = no acknowledgement required 2 = acknowledgement required −USER (1−8) User of the message: 1 = process event (P) 2 = system event (SYS) 3 = user 3 events 4 . . 8 = user 8 events −FREE GROUPING (10x16) Ten freely definable grouping criteria, each consisting of 16 groups. (See chapter on Grouping in Events handling document.) The field can be fed with numbers 1−16 into ten different groups, e.g. 1,1,1,1,1,2,2,3,5,1.
Rev. 4
166 FbCAD Manual
9.4.2
Event function for analog measurement am* The following table presents the attributes of the event function for analog measurement am* which are asked in the dialog: EVENT MODULE NAME
TAG_CODE
CONTROL ROOM IDENTIFIER
A1
DIRECTORY IDENTIFIER
pr
ALARM AREA (1−64)
1
ALARMS ACTIVE EDGE (1=0−>1, 2=1−>0)
1
ALARMS USER (1−8)
1
MESSAGE AREA (1−64)
1
MESSAGES ACTIVE EDGE (1=0−>1, 2=1−>0)
1
MESSAGES USER (1−8)
1
HH ==================== 0= , 1=ALARM, 2=MESSAGE
0
ALARM PRIORITY
2
ALARM ACKNOWLEDGEMENT REQUEST (0=NO, 1=YES)
1
ALARM FREE GROUPING (10X16)
1
MESSAGE ACKNOWLEDGEMENT REQUEST (0=NO, 1=YES)
1
MESSAGE FREE GROUPING (10X16)
1
H ==================== 0= , 1=ALARM, 2=MESSAGE
1
ALARM PRIORITY
2
ALARM ACKNOWLEDGEMENT REQUEST (0=NO, 1=YES)
1
ALARM FREE GROUPING (10X16)
1
MESSAGE ACKNOWLEDGEMENT REQUEST (0=NO, 1=YES)
1
MESSAGE FREE GROUPING (10X16)
1
L ==================== 0= , 1=ALARM, 2=MESSAGE
1
ALARM PRIORITY
2
ALARM ACKNOWLEDGEMENT REQUEST (0=NO, 1=YES)
1
ALARM FREE GROUPING (10X16)
1
MESSAGE ACKNOWLEDGEMENT REQUEST (0=NO, 1=YES)
1
MESSAGE FREE GROUPING (10X16)
1
LL ==================== 0= , 1=ALARM, 2=MESSAGE
0
ALARM PRIORITY
2
ALARM ACKNOWLEDGEMENT REQUEST (0=NO, 1=YES)
1
ALARM FREE GROUPING (10X16)
1
MESSAGE ACKNOWLEDGEMENT REQUEST (0=NO, 1=YES)
1
MESSAGE FREE GROUPING (10X16)
1
Rev. 4
Dialogs for Configuration Functions 167
F ==================== 0= , 1=ALARM, 2=MESSAGE
1
ALARM PRIORITY
2
ALARM ACKNOWLEDGEMENT REQUEST (0=NO, 1=YES)
1
ALARM FREE GROUPING (10X16)
1
MESSAGE ACKNOWLEDGEMENT REQUEST (0=NO, 1=YES)
1
MESSAGE FREE GROUPING (10X16)
1
EVENT MODULE NAME The EVENT MODULE NAME and CONTROL ROOM IDENTIFIER fields are used to generate identifiers for event functions. For instance, if LI−100 is entered in the name field and A1 as the control room identifier, the event function identifier becomes al:A1:LI−100. CONTROL ROOM IDENTIFIER Event functions are placed at alarm packages on the basis of the CONTROL ROOM IDENTIFIER field. See also the previous item. DIRECTORY IDENTIFIER In the DIRECTORY IDENTIFIER field you enter the prefix, without colon (e.g. pr, li, ci,...), of the Process Control/Interface Server connection’s tag identifier. ALARM AREA (1−64) One of the 64 possible alternatives can be chosen for the event area of an event. Thus each alarm can be assigned certain properties. The alarm area figures are converted into the first two members of the salm function block member gr for all event points of the event function related to the tag. More data is available in the Events Handling document. ALARMS ACTIVE EDGE (1=0−>1, 2=1−>0) The field determines the type of change that activates an alarm: 1 = rising edge (0 −> 1) 2 = falling edge (1 −> 0) Note that in the event functions of the analog function blocks the alarm is always activated on the rising edge (0−>1) This field is converted into the first member of the salm function block member evc for all event points of the event function. ALARMS USER (1−8) User of the alarm: 1 = process event (P) 2 = system event (SYS) 3 = user 3 events 4 . . 8 = user 8 events MESSAGE AREA (1−64) One of the 64 possible alternatives can be chosen for the event area of an event. Thus each message can be assigned certain properties. More data is available in the Events Handling document.
Rev. 4
168 FbCAD Manual
MESSAGES ACTIVE EDGE (1=0−>1, 2=1−>0) The field determines the type of change that activates a message: 1 = rising edge (0 −> 1) 2 = falling edge (1 −> 0) MESSAGES USER (1−8) User of the message: 1 = process event (P) 2 = system event (SYS) 3 = user 3 events 4 . . 8 = user 8 events The following fields are repeated in the dialog separately for each event point. (For example, with analog measurement am* the event points are HH, H, L, LL and F.) 0= , 1=ALARM, 2=MESSAGE The type of event (e.g. high high limit event). The character may be determined for each event. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message Note that this attribute should be filled out in conformity with the corresponding attribute of the tag function. ALARM PRIORITY Alarm priority. The priorities 3 − 1000 can be used in metsoDNA CR collection 2006 or later, and the priorities 1 and 2 in collection 2005 or earlier. 801−1000 = high (critical), displayed in the alarm list with 5 symbols 601−800 = medium high (urgent), displayed in the alarm list with 4 symbols 401−600 = medium, displayed in the alarm list with 3 symbols 201−400 = medium low, displayed in the alarm list with 2 symbols 3−200 = low, displayed in the alarm list with one symbol 2 = urgent (collection 2005 or earlier), converted to collection 2006 priority 700 and displayed in the alarm list with 4 symbols 1 = critical (collection 2005 or earlier), converted to collection 2006 priority 900 and displayed in the alarm list with 5 symbols ALARM ACKNOWLEDGEMENT REQUEST (0=NO, 1=YES) This field determines whether the alarm requires the user’s acknowledgement: 0 = user’s acknowledgement not required 1 = user’s acknowledgement required In case acknowledgement is not required, the alarm colour does not blink and the monitor header does not respond to the alarm. ALARM FREE GROUPING (10X16) Ten freely definable grouping criteria, each consisting of 16 groups. (See chapter Grouping in Events Handling document.) In the field, you can enter the numbers 1−16 into ten different groups, e.g. 1,1,1,1,1,2,2,3,5,1.
Rev. 4
Dialogs for Configuration Functions 169
MESSAGE ACKNOWLEDGEMENT REQUEST (0=NO, 1=YES) This field determines whether the message requires the user’s acknowledgement: 0 = user’s acknowledgement not required 1 = user’s acknowledgement required
MESSAGE FREE GROUPING (10X16) Ten freely definable grouping criteria, each consisting of 16 groups. (See chapter Grouping in Events Handling document.) In the field, you can enter the numbers 1−16 into ten different groups, e.g. 1,1,1,1,1,2,2,3,5,1.
Rev. 4
170 FbCAD Manual
9.4.3
All event functions (excluded am*, bm2*, grp*, mgv* mtr* and pid*) All the data requested in various event functions’ dialogs are presented alphabetically below: 1=0−>1, 2=1−>0 ALARM The field determines the type of change that activates an alarm: 1 = rising edge (0 −> 1) 2 = falling edge (1 −> 0) Note that in analog function blocks’ event functions the alarm is always activated by the rising edge (0 −> 1). 1=0−>1, 2=1−>0 MESSAGE The field determines the type of change that activates a message: 1 = rising edge (0 −> 1) 2 = falling edge (1 −> 0) −ACKN.REQ.(0=OFF,1=ON) This field defines whether an event (alarm or message) has to be acknowledged before it goes off: 1 = no acknowledgement required 2 = acknowledgement required In case acknowledgement is not required, the alarm colour does not blink and the monitor header does not respond to the alarm. ALARM ACK REQ 0=No 1=Yes The same as −ACKN.REQ.(0=OFF,1=ON). ALARM AREA (1−64) One of the 64 possible alternatives can be chosen for the event area of an event. Thus each alarm can be assigned certain properties. More data is available in the Events handling document. ALARM FREE GROUPIN 10x16 The same as −FREE GROUPING (10x16). −ALARM PRIORITY Alarm priority. The priorities 3 − 1000 can be used in metsoDNA CR collection 2006 or later, and the priorities 1 and 2 in collection 2005 or earlier. 801−1000 = high (critical), displayed in the alarm list with 5 symbols 601−800 = medium high (urgent), displayed in the alarm list with 4 symbols 401−600 = medium, displayed in the alarm list with 3 symbols 201−400 = medium low, displayed in the alarm list with 2 symbols 3−200 = low, displayed in the alarm list with one symbol 2 = urgent (collection 2005 or earlier), converted to collection 2006 priority 700 and displayed in the alarm list with 4 symbols 1 = critical (collection 2005 or earlier), converted to collection 2006 priority 900 and displayed in the alarm list with 5 symbols ALARM USER 1−8 The same as −USER (1−8). ALM(0= ,1=ALM,2=MSG) The event type. The character of the event may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message
Rev. 4
Dialogs for Configuration Functions 171
AlmPri 1=Critic 2=Norm The same as −ALARM PRIORITY. AlmRiseEdge 0=No 1=Alm Definition of alarm relating to rising edge of function block’s member NNN. 0 = alarm not generated from NNN’s rising edge 1 = alarm generated from NNN’s rising edge Alarm can only be generated from signal’s rising edge. Besides alarm, a message may be generated from rising or falling edge or both. If alarm is generated, an salm−type function block will be created in the event function. The function block contains the alarm−related data and connects with signal NNN that generates the alarm. If alarm is not generated, the function block will not be created. NOTE! The alarm must also be defined to tag function consistently with this. Alarm text will also be defined to the tag function. COH (0= ,1=ALM,2=MSG) Control message low limit event type. The character of each event may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message COL (0= ,1=ALM,2=MSG) Control message low limit event type. The character of each event may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message CONTROL ROOM IDENTIFIER Event functions are placed at alarm packages on the basis of the CONTROL ROOM IDENTIFIER field. See also prev. item. CURH (0= ,1=ALM,2=MSG) Current alarm high limit event type. The character of each event may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message CURHH(0= ,1=ALM,2=MSG) Current alarm high high limit event type. The character of each event may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message DIRECTORY IDENTIFIER In the DIRECTORY IDENTIFIER field you enter the prefix, without colon (e.g. pr, li, ci,...), of the Process Control/Interface Server connection’s tag identifier.
Rev. 4
172 FbCAD Manual
DIST (0= ,1=ALM,2=MSG) Event type for a disturbance alarm. The character or each event may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message E1 (0= ,1=ALM,2=MSG) Event type for external input 1. The character of each event type may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message E2 (0= ,1=ALM,2=MSG) Event type for external input 2. The character of each event type may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message E3 (0= ,1=ALM,2=MSG) Event type for external input 3. The character of each event type may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message E4 (0= ,1=ALM,2=MSG) Event type for external input 4. The character of each event type may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message E5 (0= ,1=ALM,2=MSG) Event type for external input 5. The character of each event type may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message E6 (0= ,1=ALM,2=MSG) Event type for external input 6. The character of each event type may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message EH (0= ,1=ALM,2=MSG) Event type for differential value high limit. The character of each event may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message EL (0= ,1=ALM,2=MSG) Event type for differential value low limit. The character of each event may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message
Rev. 4
Dialogs for Configuration Functions 173
EVENT MODULE NAME The EVENT MODULE NAME and CONTROL ROOM IDENTIFIER fields are used to generate identifiers for event functions. For instance, if LI−100 is entered in the name field and A1 as the control room identifier, the event function identifier becomes al:A1:LI−100. F (0= ,1=ALM,2=MSG) Input signal type. Cf. HH(0= ,1=ALM,2=MSG). Note that this area should be filled out in conformity with the corresponding tag function area. FC (0= ,1=ALM,2=MSG) Event type for forced control. The character of each event may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message FM (0= ,1=ALM,2=MSG) Event type for forced manual control. The character of each event may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message FOFF (0= ,1=ALM,2=MSG) Event type of a forced off. The character or each event may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message FON (0= ,1=ALM,2=MSG) Event type for a forced on. The character of each event may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message −FREE GROUPING (10x16) Ten freely definable grouping criteria, each consisting of 16 groups. (See chapter on Grouping in Events handling document.) The field can be fed with numbers 1−16 into ten different groups, e.g. 1,1,1,1,1,2,2,3,5,1. H (0= ,1=ALM,2=MSG) Event type for high limit. Cf. HH(0= ,1=ALM,2=MSG). Note that this area should be filled out in conformity with the corresponding tag function area. HAF (0= , 1=ALM, 2=MSG) Event type for high limit. Cf. HH(0= ,1=ALM,2=MSG). Note that this area should be filled out in conformity with the corresponding tag function area.
Rev. 4
174 FbCAD Manual
HH(0= ,1=ALM,2=MSG) The high high limit event type. The character of the event may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message Note that this area should be filled out in conformity with the corresponding tag function. INTR (0= ,1=ALM,2=MSG) Event type for interrupt alarm. The character of each event may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message L (0= ,1=ALM,2=MSG) Event type for low limit. Cf. HH(0= ,1=ALM,2=MSG). Note that this area should be filled out in conformity with the corresponding tag function. LAF (0= , 1=ALM, 2=MSG) Event type for low limit. Cf. HH(0= ,1=ALM,2=MSG). Note that this area should be filled out in conformity with the corresponding tag function. LL(0= ,1=ALM,2=MSG) Event type for low low limit. Cf. HH(0= ,1=ALM,2=MSG). Note that this area must be filled out in conformity with the corresponding area of the event function. MEH (0= ,1=ALM,2=MSG) Event type for high limit. The character of each event may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message MEHH(0= ,1=ALM,2=MSG) Event type for the high high limit. The character of each event may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message MEL (0= ,1=ALM,2=MSG) Event type for low limit. The character of each event may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message MELL(0= ,1=ALM,2=MSG) Event type for the low low limit. The character of each event may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message
Rev. 4
Dialogs for Configuration Functions 175
MESSAGE AREA (1−64) One of the 64 possible alternatives can be chosen for the event area of an event. Thus each message can be assigned certain properties. More data is available in the Events handling document. MESSAGE USER 1−8 The same as −USER (1−8). MESSG ACK REQ 0=No 1=Yes The same as −ACKN.REQ.(0=OFF,1=ON). MESSG FREE GROUPIN 10x16 The same as −FREE GROUPING (10x16). MsgFallEdge 0=No 1=Msg Definition of message relating to falling edge of function block’s member NNN. 0 = message not generated from NNN’s falling edge 1 = message generated from NNN’s falling edge A message may also be generated from rising edge or both. In addition, an alarm can be generated from signal’s rising edge. If message is generated from falling edge, an smsg−type function block will be created in the event function. The function block contains the message−related data and connects with signal NNN that generates the message. If message is not generated, the function block will not be created. NOTE! The message must also be defined to tag function consistently with this. Message text will also be defined to the tag function. MsgRiseEdge 0=No 1=Msg Definition of message relating to rising edge of function block’s member NNN. 0 = message not generated from NNN’s rising edge 1 = message generated from NNN’s rising edge A message may also be generated from falling edge or both. In addition, an alarm can be generated from signal’s rising edge. If message is generated from rising edge, an smsg−type function block will be created in the event function. The function block contains the message−related data and connects with signal NNN that generates the message. If message is not generated, the function block will not be created. NOTE! The message must also be defined to tag function consistently with this. Message text will also be defined to the tag function. NNNN ==================== Title field, where nothing will be entered. NNNN defines the function block’s member specified in the fields after the title. PCS DATA The tag identifier of the event function−related tag of the Process Control Server, e.g. HS−111, is entered into the PCS DATA field.
Rev. 4
176 FbCAD Manual
−USER (1−8) Event’s (alarm or message) user: 1 = process event (P) 2 = system event (SYS) 3 = user 3 events 4 . . 8 = user 8 events WD (0= ,1=ALM,2=MSG) Event type for watchdog failure. The character of each event may be determined. 0 = neither alarm nor message is generated 1 = generate an alarm 2 = generate a message
Rev. 4
Dialogs for Configuration Functions 177
9.5
DIALOGS FOR HISTORY FUNCTIONS
9.5.1
Dialog for a ph3 history function (History) The following table presents the attributes of the ph3 history function which are asked in the dialog. ph3 is one of the ’history’ history functions. HISTORY MODULE NAME
TAG_CODE
TYPE (ana,bin,intl,ints)
ana
SPECIFIER HISTORY COLLECTION
1
swct SAMPLE CONTROL
ave
PACKAGE IDENTIFIER EXECUTION INTERVAL
10000
EXECUTION ORDER
20
PCS DATA
pr:TAG_CODE
sd SAMPLING INTERVAL
10s
td STORING INTERVAL
1m
timecnd SAMPLING START TIME
99999999
swti SELECT OF TIME HANDLING
0
HISTORY BUFFER SIZE
7
REAL TIME HISTORY BUFFER SIZE
8
EVENT TIME HISTORY BUFFER SIZE
8
disksave DISK STORAGE
0
HISTORY MODULE NAME The final identifier of the ph3 history function consists of several fields. The information for one field is entered here. TYPE (ana, bin, intl, ints) The type for data to be gathered. The field allows for entering one of the following types:
ana, bin, intl, ints am, am2 pid mtr, mtr2, mtre mca
The value of the field is also visible in the symbol. SPECIFIER The specifier for the data to be gathered. The value of the field is visible also in the symbol. HISTORY COLLECTION Indicates whether or not the history symbol is active. 0 = A history function will not be generated from the history symbol. 1 = A history function will be generated from the history symbol.
Rev. 4
178 FbCAD Manual
swct SAMPLE CONTROL The method for processing the samples will be entered in the SAMPLE CONTROL field. The processing methods for samples are the following when the data type is ana, intl or ints: ave = Mean value (normal). The mean value of the samples measured since the previous storing will be stored in the history buffer ’avebuf’. tave = Mean value (time weighted). The mean value of the samples measured since the previous storing will be stored in the history buffer ’avebuf’. cnt = The number of values. The number of the samples measured since the previous storing will be stored in the history buffer ’nbuf’. hmin = The minimum value. The smallest value of the samples measured since the previous storing will be stored in the history buffer ’minbuf’. hmiax = The maximum value. The greatest value of the samples measured since the previous storing will be stored in the history buffer ’maxbuf’. fst = The first value. The first value of the samples measured since the previous storing will be stored in the history buffer ’firstbuf’. lst = The last value. The last value of the samples measured since the previous storing will be stored in the history buffer ’lastbuf’. std = Standard deviation. The standard deviation of the samples measured since the previous storing will be stored in the history buffer ’stdevbuf’. var = Variance. The variance of the samples measured since the previous storing will be stored in the history buffer ’varbuf’. The methods for processing samples are the following when the data type is bin: fbt = Run time. The run time after the previous storing will be stored in the history buffer ’ftimebuf’. The run time stored will be the duration of status 1 (in seconds) during the storing interval. bst = The number of start−ups. The number of 0−>1 status changes detected since the previous storing will be stored in the history buffer ’startbuf’. Only a connected history buffer can be used for storing. PACKAGE IDENTIFIER The location package of the history function. EXECUTION INTERVAL The execution interval of the application. EXECUTION ORDER The execution order for the history function at the Process Control Server. PCS DATA The PCS DATA field is used for entering the tag identifier of the tag at the Process Control Server pertaining to the history function, e.g. LI−100. An external input is generated using this field for logging in, e.g. pr:LI−100:av.
Rev. 4
Dialogs for Configuration Functions 179
sd SAMPLING INTERVAL The SAMPLING INTERVAL field is used for entering the time interval between two consecutive samples. The time interval can be given in one of the following units: s = Seconds m = Minutes h = Hours d = Days For instance, 0.5m equals 30 seconds. td STORING INTERVAL The STORING INTERVAL field is used for entering the time interval between two consecutive storings. The unit for the time interval can be the same as that of the previous field sd SAMPLING INTERVAL. timecnd SAMPLING START TIME The field SAMPLING START TIME is used for calculating the exact time for starting sampling. This calculation is based on the value entered in the field and the clock time of system initialisation. For instance, the value 99990000 will start the function block at the next even hour following the initialisation. swti SELECT OF TIME HANDLING One of the following options will be entered in the field SELECT OF TIME HANDLING: 0 1 2 3
= relative clock time = absolute clock time = synchronised relative = synchronised absolute
HISTORY BUFFER SIZE The size of the history buffer will be entered in this field. The values will be transferred from the history buffer to the history database. The size value entered is the power of number two. For instance, the value 8 means 28 (= 256). The buffer type will be generated automatically but the type and size of the history buffer can be entered together when required. For instance when gathering analog history, the buffer size and type can be hbfa_x (x =2, 3, 4, 5, 6, 7, 8, 9, a, b, c). This field can be left blank if no history buffer will be used. REAL TIME HISTORY BUFFER SIZE This field is used for entering the size for the real time history buffer. The real time history buffer is used for displaying live history data for control room use. The entered size value is the power of number two. For instance, the value 8 means 28 (=256). This field can be left blank if no real time history buffer will be used. EVENT TIME HISTORY BUFFER SIZE This field is used for entering the size for the event time history buffer. The entered size value is the power of number two. For instance, the value 8 means 28 (=256). This field can be left blank if no event time history buffer will be used.
Rev. 4
180 FbCAD Manual
disksave DISK STORAGE The value of this field must always be 0 (zero). Reading of the database data is done with the help of IA’s (Infomation Management Activity) history. The following fields construct the history function identifier: ph3:::: where swct is sample control and td storing interval. The history function identifier can contain up to 46 characters.
9.5.2
Dialog for a Write group (History) The following table presents the attributes of the write group which are asked in the dialog. Write is one of the ’history’ history functions. NAME DATABASE LOADING
ON
DESCRIPTION DATABASE
Historian
HISTORY COLLECTION
ON
MAIN TASK
TSK_M_PCSIF1
DEVICE UNIT
1
MAIN GROUP PRIORITY
5
TIMEOUT
10
NAME An unambiguous name for a collection group in the database with a max. length of 24 characters. DATABASE LOADING Whether the collection group data is transferred to the database in loading (when using the download command) or not. ON = data is transferred in loading OFF = data is not transferred in loading DESCRIPTION A description of the purpose and the use of the collection group. Max. length of 32 characters. DATABASE Identifies the database in which collection group data will be loaded. In fact this is a name of the ODBC driver configured in the engineering server (EAS). Usually there is only one database whose default name is Historian. HISTORY COLLECTION Whether the collection group gathers data or not. ON = group gathers data OFF = group does not gather data
Rev. 4
Dialogs for Configuration Functions 181
MAIN TASK The name of the database interface software. Default is TSK_M_PCSIF1. DEVICE UNIT Internal database constant. Leave the default value (1). MAIN GROUP A group name which consists of defined collection groups. PRIORITY The priority of a collection group. Available values are 1−9 (1 is the highest priority). TIMEOUT Timeout for read or write functions of the collection message. If the timeout value is exceeded the message is ignored.
9.5.3
Dialog for read groups (Read and Unsolicited read), History The following table presents the attributes of the Read and Unsolicited read groups which are asked in the dialog. Ten first attributes of the dialog are the same as in the dialog for write group. Read and Unsolicited read are ’history’ history functions. NAME DATABASE LOADING
ON
DESCRIPTION DATABASE
Historian
HISTORY COLLECTION
ON
MAIN TASK
TSK_M_PCSIF1
DEVICE UNIT
1
MAIN GROUP PRIORITY
5
TIMEOUT
10
FREQUENCY
60
FREQUENCY The collection cycle of a collection group in seconds.
Rev. 4
182 FbCAD Manual
9.5.4
Dialogs for history tags (History) The following table presents the attributes of the different types of history tags which are asked in the dialog. These history tags are ’history’ history functions. Not all attributes are asked in the dialogs of different types of tags. This is an example of a dialog of analog type history tag: NAME DATABASE LOADING
OFF
COLLECTION VARIABLE DESCRIPTION DATABASE
Historian
HISTORY COLLECTION
ON
DEPARTMENT PROCESS AREA COLLECTION GROUP UNIT FORMAT
F10.3
SIGNIFICANCE
0.0
TIME LIMIT
0
MINIMUM LOWER LOW LIMIT LOW LIMIT HIGH LIMIT HIGHER HIGH LIMIT MAXIMUM REPOSITORY
TSK_DHIS
ARCHIVING
ON
NAME An unambiguous name for a history tag in the database with a max. length of 24 characters. DATABASE LOADING Whether the history tag data is transferred to the database in loading (when using the download command) or not .
ON = data is transferred in loading OFF = data is not transferred in loading
COLLECTION VARIABLE The identifier of data retrieved from the metsoDNA CR runtime environment (e.g. pr:LI−−100:av) DESCRIPTION A description of the purpose and the use of the history tag. Max. length of 32 characters.
Rev. 4
Dialogs for Configuration Functions 183
DATABASE Identifies the database in where history tag data will be loaded. In fact this is a name of the ODBC driver configured in the engineering server (EAS). Usually there is only one database whose default name is Historian. HISTORY COLLECTION Whether the history tag data is gathered or not. ON = data is gathered OFF = data is not gathered DEPARTMENT The name of the department to which the history tag belongs. PROCESS AREA The name of the process area to which the history tag belongs. COLLECTION GROUP The name of the collection group to which the history tag belongs. UNIT The unit of history tag. FORMAT A presentation format for database data. For example, the format for analog data is F10.3 and the format for binary or integer data is I11. SIGNIFICANCE A numerical value for a limit within which changes may occur without causing the information to be saved in the databse. See also attribute Time Limit. TIME LIMIT The maximum period of time after which a value is stored to a database. After this time period the value is stored to the database regardless of whether it has changed or not compared to the previously stored value. MINIMUM The minimum value of history tag. LOWER LOW LIMIT The value of lower low alarm limit. LOW LIMIT The value of low alarm limit. HIGH LIMIT The value of high alarm limit. HIGHER HIGH LIMIT The value of higher high limit. MAXIMUM The maximum value of history tag.
Rev. 4
184 FbCAD Manual
REPOSITORY The name of the history disk database where the data is stored. ARCHIVING Whether the data is stored in the history disk database or not. ON = data is stored to the history disk database OFF = data is not stored to the history disk database
9.5.5
Dialog for a Write group (History2) The following table presents the attributes of the write group which are asked in the dialog. Write is one of the ’history2’ history functions. NAME DATABASE LOADING
ON
DESCRIPTION DATA SOURCE
$DNAhistorian
HISTORY COLLECTION
ON
MAIN TASK
TSK_M_PCSIF1
DEVICE UNIT
1
MAIN GROUP PRIORITY
5
TIMEOUT
10
LONG NAMES
ON
NAME An unambiguous name for a collection group in the database with a max. length of 24 characters. DATABASE LOADING Whether the collection group data is transferred to the database in loading (when using the download command) or not. ON = data is transferred in loading OFF = data is not transferred in loading DESCRIPTION A description of the purpose and the use of the collection group. Max. length of 32 characters. DATA SOURCE Identifies the database in which collection group data will be loaded. This is the name of the DNAdata server. Usually there is only one database whose default name is $DNAhistorian. HISTORY COLLECTION Whether the collection group gathers data or not. ON = group gathers data OFF = group does not gather data
Rev. 4
Dialogs for Configuration Functions 185
MAIN TASK The name of the database interface software. Default is TSK_M_PCSIF1. DEVICE UNIT Internal database constant. Leave the default value (1). MAIN GROUP A group name which consists of defined collection groups. PRIORITY The priority of a collection group. Available values are 1−9 (1 is the highest priority). TIMEOUT Timeout for read or write functions of the collection message. If the timeout value is exceeded the message is ignored. LONG NAMES Used for configuring collection groups. If long names are in use, the length of the collection tag is 255 characters and the maximum number of tags per a collection group is less than 200. If long names are not in use, the length of the collection tag is 80 characters and the maximum number of tags per a collection group is 250. The HistConfLoader application will create a right type of collection group on the basis of the field value. Collection tags and the collection group are configured in the HistConfLoader configuration file.
9.5.6
Dialog for read groups (Read and Unsolicited read), History2 The following table presents the attributes of the Read and Unsolicited read groups which are asked in the dialog. Ten first attributes of the dialog are the same as in the dialog for write group. Read and Unsolicited read are ’history2’ history functions. NAME DATABASE LOADING
ON
DESCRIPTION DATA SOURCE
$DNAhistorian
HISTORY COLLECTION
ON
MAIN TASK
TSK_M_PCSIF1
DEVICE UNIT
1
MAIN GROUP PRIORITY
5
TIMEOUT
10
FREQUENCY
60
LONG NAMES
ON
FREQUENCY The collection cycle of a collection group in seconds.
Rev. 4
186 FbCAD Manual
9.5.7
Dialogs for history tags (History2) The following table presents the attributes of the different types of history tags which are asked in the dialog. These history tags are ’history2’ history functions. Not all attributes are asked in the dialogs of different types of tags. This is an example of a dialog of analog table type history tag: NAME LONG TAG NAME PREFIX
pr
MAIN TAG DATABASE LOADING
OFF
COLLECTION VARIABLE VARIABLE TYPE
ana
TIME ARRAY TIME OF EVENT (0=NO, 1=YES)
1
PORT DESCRIPTION DATA SOURCE
$DNAhistorian
HISTORY COLLECTION
ON
DEPARTMENT PROCESS AREA COLLECTION GROUP UNIT FORMAT
F10.3
INTERPOLATION MODE
Interpolated
MINIMUM LOWER LOW LIMIT LOW LIMIT HIGH LIMIT HIGHER HIGH LIMIT MAXIMUM REPOSITORY
TSK_DHIS
ARCHIVING
ON
DATA COMPRESSION========== SIGNIFICANCE
0
TIME LIMIT
0
COMPRESSION TYPE
Interpolated
RIGHTS========== READ GRANT
*
READ DENY WRITE GRANT
*
WRITE DENY
Rev. 4
Dialogs for Configuration Functions 187
OPERATE GRANT
*
OPERATE DENY
Operator
AUDIT TRAIL========== AUDIT TRAIL MODE NAME An unambiguous name for a history tag in each DNAhistorian database with a max. length of 24 characters. Each history tag must have a name. LONG NAME Tag Knowledge Service contains s mechanism to store long history tag names. This name is used as a primarily name in the Tag Knowledge Service. Only if the tag resolving mechanism does not find the tag with a long name, it tries to find the tag with its short name. The long history tag name must be unambiguous in each Tag Knowledge Service. If the field is left empty, HistConfLoader enters here the same name that was given to the Name field. The maximum length of the name is 255 characters. PREFIX In the Prefix field, enter the prefix of the tag idenifier without a colon (e.g. pr, li, ci or lb). The field is used in DNAuse history data queries. If all three fields Prefix, Main Tag and Port are left empty at the same time, HistConfLoader generates here a value based on the value of Collection Variable field. MAIN TAG A link to the function block diagram. This information is stored to the Tag Knowledge Service. DNAhistorian tags and aliases are connected to the main tag to enable queries based on the main tag information. Main tag can be for example 25LIC−100. The field is used in DNAuse history data queries. If all three fields Prefix, Main Tag and Port are left empty at the same time, HistConfLoader generates here a value based on the value of Collection Variable field. DATABASE LOADING Whether the history tag data is transferred to the database in loading (when using the download command) or not .
ON = data is transferred in loading OFF = data is not transferred in loading
COLLECTION VARIABLE The identifier with its prefix for data retrieved from the metsoDNA CR runtime environment (e.g. pr:25LIC−100:me). The maximum length of the field is 255 characters and it depends on the configuration of the collection group. If table type data is gathered, enter here the name of the table. In case of an ahs2 table, the value of the Time of Event field must be 1. If a history tag is a calculated tag in a database or manually entered laboratory value, the Collection Variable field will be empty.
Rev. 4
188 FbCAD Manual
VARIABLE TYPE In the Variable type field, enter the type of the history tag. TIME ARRAY The name of the time array when data is gathered from the table of type ahs2. If the field is left empty, the time stamp for the collected history values will be determined according to the value of the interval field which is defined in the header section of the table that has been given in the Collection Variable field. TIME OF EVENT (0=NO, 1=YES) Field defines whether the time array is used or not .
0 = time array is not used; the table defined in the Collection Variable field is read 1 = time array is used when the table defined in the Collection Variable field is of type ahs2
PORT Tag port is used for defining a specifier to be added to the main tag without colon (25LIC−100:me). The value of the Port field will be used together with the Main Tag and Prefix fields in the Tag Knowledge Service. If all three fields Prefix, Main Tag and Port are left empty at the same time, HistConfLoader generates here a value based on the value of Collection Variable field. The field is used for identifying the tag in DNAuse history data queries. E.g. if data is gathered with different collection cycles from the same point (for example pr:25LIC−100:me), the port can be used for separating the tags from each other (port=me and port=me−10s). The maximum length of the field is 255 characters. DESCRIPTION A description of the purpose and the use of the history tag. Max. length of 32 characters. DATA SOURCE Identifies the database in where history tag data will be loaded. Default value for Data Source is $DNAhistorian which is the default name of the DNAdata defined for HistConfLoader. HistConfLoader handles the value ’Historian’ as if it was the value ’$DNAhistorian’. NOTE! In some cases the data source can be called ’Service host’ because DNAdata uses that term. The configuration mechanism is common for both DNAdata and Tag Knowledge Service. HISTORY COLLECTION Whether the history tag data is gathered or not. ON = data is gathered OFF = data is not gathered DEPARTMENT The name of the department to which the history tag belongs.
Rev. 4
Dialogs for Configuration Functions 189
PROCESS AREA The name of the process area to which the history tag belongs. COLLECTION GROUP The name of the collection group to which the history tag belongs. UNIT The unit of history tag. FORMAT A presentation format for database data. For example, the format for analog data is F10.3 and the format for binary or integer data is I11. INTERPOLATION MODE The interpolation mode is used to handle stepwise changing data, e.g. laboratory values. If the value is ’Stepped’, data queries return stepped data which can be shown in stepped mode. The value ’Stepped’ should be used for laboratory values. If the value is ’Interpolated’, data can be shown continuously in the user interface. MINIMUM The minimum value of history tag. LOWER LOW LIMIT The value of lower low alarm limit. LOW LIMIT The value of low alarm limit. HIGH LIMIT The value of high alarm limit. HIGHER HIGH LIMIT The value of higher high limit. MAXIMUM The maximum value of history tag. REPOSITORY The name of the history disk database where the data is stored. ARCHIVING Whether the data is stored to the history disk database or not. ON = data is stored to the history disk database OFF = data is not stored to the history disk database SIGNIFICANCE A numerical value for a limit within which changes may occur without causing the information to be saved in the database. See also attribute Time Limit.
Rev. 4
190 FbCAD Manual
TIME LIMIT The maximum period of time after which a value is stored to a database. After this time period the value is stored to the database regardless of whether it has changed or not compared to the previously stored value. COMPRESSION TYPE There are three data compression types in use in DNAhistorian database: Modified Boxcar−Backslpope −algorithm, Stepped compressio and Text compression. Modified Boxcar−Backslpope −algorithm is used when the value of Compression Type field is ’Interpolated’. Stepped compression is enabled by entering the value ’Stepped’ in the Compression Type field (IP_STEPPED). In this case, whenever a new incoming value exceeds the deviation limit or the maximum time interval, the system records the new valu with the new time stamp. Text compression is enabled by entering the value ’Text’ in the Compression Type field (IP_COMPRESSION). This is possible only for text type tags. In this case, the system will not record new incoming text data if the current value is the same as the incoming data. However, if the new incoming text data is the same as the current value but the time span between those two values has exceeded the value specified in Time Limit field, the recording of the new text data will be made. READ GRANT Lists user roles which have the right to see the tag and read its data. The listed roles are separated with a comma. Default value is an asterisk (*). The maximum length of the field is 255 characters. READ DENY Lists user roles which do not have the right to see the tag or read its data. The listed roles are separated with a comma. As a default, the field is empty. The maximum length of the field is 255 characters. WRITE GRANT Lists user roles which have the right to write data to the tag. The listed roles are separated with a comma. Default value is an asterisk (*). The maximum length of the field is 255 characters. WRITE DENY Lists user roles which do not have the right to write data to the tag. The listed roles are separated with a comma. As a default, the field is empty. The maximum length of the field is 255 characters. OPERATE GRANT Lists user roles which have the right to remove tags from the history collection by using, for example, DNAuse but in that case, the tag must have been added also with DNAuse. The listed roles are separated with a comma. Default value is an asterisk (*). The maximum length of the field is 255 characters. OPERATE DENY Lists user roles which do not have the right to remove tags from the history collection by using DNAuse. The listed roles are separated with a comma. Default value is ’Operator’ which means that DNAuse operators cannot remove tags. The maximum length of the field is 255 characters.
Rev. 4
Dialogs for Configuration Functions 191
AUDIT TRAIL MODE Whether the Audit Trail storing is used or not for the specific tag. Audit Trail is used for storing log information on the operations which have been done to the tag during the given period of time and who has done them. As a default, the field is empty. If Audit Trail is in use, the user adds a list of operations from which the log information will be gathered. The listed operations are separated with a comma. The following operations are available: View, Read, Write, Delete, Operation and All. The maximum length of the field is 255 characters.
Rev. 4
192 FbCAD Manual
10
CONFIGURATION OF TABLES Table type is a structured type of metsoDNA CR including a header part and an element part. Element part is at maximum a 3−dimensional table. The maximum size of the table and the type of the elements is fixed by the table type. The basics of the table types are explained in the type helps of the type named ”table” in CAD tool and in PCS Function Blocks documents. Table types can be configured using
table symbols,
”any” type symbols or
function block members.
Symbols of table type can be managed with Update Tool. For more details see document Update Tool. NOTE! Do not use ChBlk or UpdBlk command for table type symbols.
10.1
TABLE SYMBOL Table symbol is a common name for a table type data points and ports used in function block and sequence diagrams. The table symbol, like all other corresponding scalar symbols, includes both the dialog and the graphic symbol for the function block and sequence diagrams. As an aid for configuring table symbols there is a Table Editor dialog.
10.2
”ANY” TYPE SYMBOL ”Any” type symbol is a generic symbol for a data point and port. It has in the dialog an editable parameter, which defines the type of the symbol. Usually it will be used, when a fixed type symbol for the type you need, doesn’t exist. ”Any” type symbol can be used to configure both scalar and table types.
10.3
TABLE SYMBOL VS. ”ANY” TYPE SYMBOL When several tables are connected together to the same connection network, only one table symbol (port or data point) can exist in that network. The other tables connected to the network must be configured using ”any” type symbols or they must be function block members. The table symbol checks many limits existing in configurations of tables and gives warnings. ”Any” type symbol doesn’t check anything. As an aid for configuring table symbols there is a Table Edit dialog. In ”any” type symbol you must feed all the values of the table (both header and element part) in one string. With the ”any” type symbol you can give initial values only to about 10−20 elements. In table symbol, there is no limit for the number of initial values.
Rev. 2
Configuration of Tables 193
10.4
INITIAL VALUES OF TABLES When several tables are connected together to the same connection network and configuration initial values for the network are needed, they must be given into the table symbol, if any existing in the network. Then all ”any” type symbols and function block members must be configured without initial values. This is because table symbol includes always initial values at least for header part of the table and in the same network can be only one symbol that includes initial values. If there exists initial values in more than one symbol (table symbol, ”any” type symbol or function block member) in a connection network, it results ”double initial value” error in the checking or compilation stage of the function block diagram. In one connection network, there can only exist one data point. If there exists a data point in a connection network and initial values are needed for the network, they must be given in the data point. When more than one tables are connected together to the same connection network, the values of a table will take place in the following order, the least significant one mentioned first: 1.
default value of the type of the data point (only one data point allowed in one connection network),
2.
default values of the types of the members of the function blocks in the order the function blocks are represented in the automation language (when configured with CAD, the order is the same as the execution order of the function blocks),
3.
default values of the types of the direct access ports in the order the ports are represented in the automation language (when configured with CAD, the order is random),
4.
default values of the types of the interface ports in the order the ports are represented in the automation language (when configured withCAD, the order is random),
5.
default values of the members of the function blocks in the order the function blocks are represented in the automation language (when configured with CAD, the order is the same as the execution order of the function blocks) and
6.
configuration initial value of the table (only one value allowed in one connection network).
Rev. 2
194 FbCAD Manual
10.5
CONFIGURATION OF TABLE SYMBOL The configuration of the table symbol differs from the configuration of the other signal types. The main difference is the Table Editor dialog used to ”preconfigure” the type of the elements of the table and the layout of the symbol before invoking a regular dialog. The configuring sequence of the table symbol is the following: 1.
To create a new table symbol in the function block or sequence diagram, select from the menu bar or screen menu for instance COMMON and EXTERNALS IN continuous. Then from the opening icon menu select a signal type Table instead of ana, bin etc. This invokes a Table Editor dialog. With the fields of the dialog you can define the type of the elements of the table and the layout of the table symbol, i.e. the layout of the dialog and the layout of the graphic symbol in the diagram. In the Table Editor dialog, you can also give almost all the initial configuration values of the table.
Figure 125 2.
Table Editor dialog of the table symbol
From the Table Editor dialog, you can get back to the diagram with the Cancel button without creating a new table symbol.
Rev. 2
Configuration of Tables 195
3.
From the Table Editor dialog, you get to the diagram with the OK button. There the insertion point of the symbol and the insertion point of the initial values will be prompted. After that a table symbol with a dialog and a graphic symbol for the diagram will be created according to the data you entered in the Table Editor dialog.
4.
After inserting the symbol, the dialog of the table symbol appears. In the dialog, you can change all the data of the table except the layout of the symbol and the type of the elements of the table. From the dialog, you cannot get back to the Table Editor dialog of the symbol.
The following table presents the attributes of the table symbol dialog: EXT CONT INPUT NAME
pr:TAG_CODE.F:out1
COMMENT TEXT Transfer interval (10−25500ms)
Module execution inteval
header=============== :fails fails
48
:mode =array[ring]
array
:elemtype = ana
****************
:dim =d1(,d2(,d3)) d>0
1
:size=s1(,s2(,s3)) s=0−d
1
:base=b1(,b2((,b3)) b=1−d
1
:dataid intl
48,0
:time binev
48,0,0,0,0,0,5,1,1,136,14
:interval ana
48,0.0
elem=================== :e(*) ana
5.
Rev. 2
When you exit the dialog with the OK button, the table symbol is ready, and you get back to the diagram from where you started. In the diagram, you can now see the new inserted table symbol. After that you can handle the table symbol like any other symbol. For instance, the values of the table can be edited in the dialog and the symbol can be moved to a new location in the diagram.
196 FbCAD Manual
External continuous output
Local data point
Figure 126
Direct access port
Output interface port
Table symbols in the function block diagram
6.
To change a table symbol existing in the function block diagram, select from the menu bar or screen menu Edit −> Values, and point the table symbol you want to change. Then the dialog of the table symbol appears. Now you can change all the values of the table, except the layout of the symbol and the type of the elements.
7.
With the Cancel button, you can cancel the changes you made in the dialog and get back to the diagram.
8.
With the OK button, you accept the changes you have made in the dialog and get back to the diagram. There the changes you made can be seen in the table symbol.
Rev. 2
Configuration of Tables 197
10.6
TABLE EDITOR DIALOG The Table Editor dialog is a tool for creating new table symbols into the function block or sequence diagram and for entering the initial configuration values of the tables. The Table Editor dialog is divided to header part (Header frame) and element part (Element frame).
10.6.1
Entering the data Data can be entered into fields of the Table Editor dialog either direct from the keyboard or by choosing the desired data from the drop−down list box or from the dialog which is opened. If the value you entered is outside of the valid range of the field, the value of the field stays unchanged.
OK button With the OK button, you accept the data in the Table Editor dialog and exit it. Then a new table symbol will be created according to the data in the Table Editor dialog, and the insertion points of the symbol and the initial values will be prompted. After that the dialog of the table symbol appears. In the dialog, you can enter the values that could not be entered in the Table Editor dialog. From the table symbol, dialog you cannot get back to the Table Editor dialog. If you, after exiting the Table Editor dialog, want to change data that cannot be changed in the table symbol dialog (e.g. the type of the elements), you must first delete the table symbol from the diagram and then create a new one with the desired data. To exit the table symbol dialog and get back to the diagram, click the OK button. From the diagram you can get back to the dialog by selecting Edit −> Values from the menu.
Cancel button With the Cancel button, you cancel the Table Editor dialog and get back to the diagram without creating a table symbol. After exiting from the Table Editor dialog to the table symbol dialog with the OK button, the creation of the table symbol cannot be cancelled anymore.
10.6.2
Changing the values later in the table symbol dialog Most of the values given in the Table Editor dialog can be changed later in the table symbol dialog. However, the values affecting the type of the elements, the structure of the dialog or the visibility of the table in the diagram cannot be changed in the table symbol dialog.
10.6.3
Repeating the table creation The previous table creation can be repeated by a double click of the right mouse button or hitting Enter on the keyboard twice. This opens a Table Editor dialog for a table which is of the same automation object type (interface port, external data point, ...) as the previous table.
Rev. 2
198 FbCAD Manual
10.7
HEADER FRAME Header frame includes fields for defining the layout of the dialog of the table symbol. Most of the values given in Header frame can later be changed in the dialog of the table symbol.
10.7.1
Fault bits of the header (:fails) This field defines the fault bits of the header. Choose the desired fault bits in the following dialog which can be opened by clicking the button next to the :fails field:
The fault bits must be given as a sum of the codes of the desired fault bits. The following table presents the codes of the fault bits. The sum can also be entered to the field directly from the keyboard. 0 = no fault
16 = inv
2 = ext
32 = old
4 = ovf
64 = der
8 = dis
128 = sex
The value of this field will also be copied to the corresponding field (:fails) of the table symbol dialog, and also to the :dataid, :time and :interval fields of the dialog. In the table symbol dialog, the fault bits of all mentioned fields can later be changed independently from each other.
10.7.2
Mode of the table (:mode) This field defines the mode of the table. Valid values for this field will be presented in the drop−down list box. Some of those values may not be supported by the function blocks of this version of metsoDNA CR. The value of this field will be copied to the corresponding field (:mode) of the table symbol dialog. In the dialog, :mode can later be changed.
10.7.3
Type of the elements of the table (:elemtype) This field defines the type of the elements of the table. Valid values for the field will be presented in the drop−down list box. Some combinations of the type of the elements (:header:elemtype) and the dimensions of the table (:header:dim) may not be supported by this version of metsoDNA CR. Check if there exists a table type in the type library of the runtime environment’s destination server for the combination you want. The value of this field will be copied to the corresponding field (:elemtype) of the table symbol dialog. In the dialog, :elemtype cannot be changed.
Rev. 2
Configuration of Tables 199
10.7.4
Dimensions of the frame (:dim) This field defines the dimensions of the frame and the maximum size of the table. Valid values for this field are those, for which there exists a table type in the type library of the runtime environment’s destination server. Valid values for the field will be presented in the drop−down list box. Some combinations of the dimensions (:header:dim) and the type of the elements of the table (:header:elemtype) may not be supported by this version of metsoDNA CR. Check if the type library of the runtime environment’s destination server contains a table type for the combination you want. The value of this field will also be copied to the :size field of this dialog (Table Editor). After that :size can be changed independently from :dim. The value of this field will be copied to the corresponding field (:dim) of the table symbol dialog. In the dialog, :dim can later be changed.
10.7.5
Size of the table (:size) This field defines the size of the table, and its value is originally specified (when the table is first created) according to the :dim field of the Table Editor dialog. Size of the table means the number of the elements reserved for the table in the frame (beginning at :base) in the directions of the different dimensions. The first element of the table in the frame is :elem(:base) and the last one is :elem(:base−1+:size). Always when a new table is created, the value of the :base field is 1 as a default and it cannot be changed in the Table Editor dialog. Possible change to it must be done in the table symbol dialog. The value for this field must be entered into the command line. Valid values are
0 =< :size =< :dim−1
(when :mode = list) and
0 =< :size =< :dim
(for all the other modes).
At the configuration time :size has got tighter limits than at the function block diagram execution time. This is because at the configuration time all tables with different :mode’s will be handled as ’array type’ tables to make the initial value feeding easier. Thus at the configuration time tables cannot be handled as rings. Only at the function block diagram execution time the ’ring mode’ tables (others than array and stack) will be released to rotate around the frame. The value of this field will be copied to the corresponding field (:size) of the table symbol dialog. In the dialog, both :size and :base can later be changed. Depending on the values of :dim, :size and :base some unused elements may be left in the frame. If any, they are elements :elem(1) −> :elem(:base−1) and :elem(:base−1+:size) −> :elem(:dim). For all the unused elements an initial value with inv (16) fault bit will be given at the checking stage of the function block diagram. The result will be seen only in the continuous control’s automation language module formed in the checking stage. Inv fault bit makes the unused elements invisible in DNAuse user interface. To reduce the handling time and the amount of memory required by the big tables it is suggested to keep :size = :dim, if possible. See 10.8.1 (10) Value of :elem(*) for more details.
Rev. 2
200 FbCAD Manual
10.8
ELEMENTS FRAME Elements frame includes fields for entering the initial values for table symbol dialog fields and fields for defining visibility and length of the initial values of the table elements in function block and sequence diagrams. Some of the values in the Elements frame can later be changed in the dialog of the table symbols.
10.8.1
Value of :elem(*) — e(*) This field defines the value of :elem(*). The value is entered in the e(*) field. The value of this field will be copied to the corresponding field of the table symbol dialog. There it can be changed. From the dialog the value of e(*) field will be copied to all the elements of the table (:base −> :base−1+:size), for which no other value has been given in the dialog. The copying will take place just at the checking stage of the function block diagram. The result will be seen in the continuous control’s automation language module formed in the checking stage.
Reducing the required handling time and memory Big tables require a lot of handling time and memory from engineering server (EAS) at the configuration time. Required time and memory will be reduced, if the last element of the frame, which requires other initial value than the default value of the type of the element, is as near to the beginning of the frame as possible. Other initial values than the default values of the types of the elements, are critical because they must be explicitely represented in table symbols in function block diagram. Thus they require extra handling time and memory from engineering server (EAS). The following rules for the dialog can be used to minimize the handling time and memory required by the big tables from engineering server (EAS). The rules are in the priority order the most effective mentioned first:
10.8.2
1.
:base−1 + :size = :dim, i.e. there are no unused elements at the end of the frame (:base+:size −> :dim). If there were, they would require fault bit ”inv” in their initial values. This would be different from the default value of the type of the element.
2.
No value is given to :elem(*), i.e. the default value of the type of the element can be used for all the elements of the table (:base −> :base−1+:size), that have not been assigned individual values.
3.
Individual initial values are given only to the elements with indexes near :base. Those values must be explicitely represented in the function block diagram.
4.
:base is near 1,1,1, i.e. at the beginning of the frame there are not too many unused elements (1,1,1 −> :base). If there were, they would require fault bit ”inv” in their initial values. This would be different from the default value of the type of the element.
Visibility of :elem(*) in the diagram Visible check box next to the e(*) field defines if :elem(*), which is always visible in the table symbol dialog, will be visible in the diagram, too. In the table symbol dialog or in the diagram, you cannot change the visibility of :elem(*) anymore.
Rev. 2
Configuration of Tables 201
10.8.3
Editability and visibility of the other elements in the diagram — Editable elements Editable elements field defines which other table elements than :elem(*) can be modified in the table symbol dialog. Valid values are None (not any elements), Range (elements from the range which is restricted by e() first and e() last fields) and All (all elements). In addition, the field defines if the elements (other than :elem(*)) of the table, that are visible in the table symbol dialog, will be visible in the diagram, too. This selection is made by using visible check box. In the table symbol dialog or in the diagram, you cannot change the visibility of other elements.
10.8.4
Index of the first editable/visible element — e() first This field defines the index of the first element in the range of editable and/or visible elements in the table symbol dialog. The index of the first element in the range is entered in the field. In the Table Editor dialog, you can give a common value to all the visible elements of the table symbol dialog. For more details, see chapter 10.8.6 “Common fault bits and common value of the visible elements — fails/bin ja value”. In the table symbol dialog, the values of the visible elements can be changed independently from each other. Also :elem(*) field has an effect to the values of the visible elements. For more details, see chapter 10.8.1 “Value of :elem(*) — e(*)”. In the dialog, you cannot change the range of editable or visible elements.
10.8.5
Index of the last editable/visible element — e() last This field defines the index of the last element in the range of editable and/or visible elements in the table symbol dialog. The index of the last element in the range is entered in the field. For more details, see chapter 10.8.4 “Index of the first editable/visible element — e() first“.
10.8.6
Common fault bits and common value of the visible elements — fails/bin ja value fails/bin and value fields define the common fault bits and a common value for all visible elements (first − last) of the table. The fault bits and the value itself will be given separately in different fields. The common value (without fault bits) must be typed in the value field. Choose the desired fault bits in the dialog which can be opened by clicking the button next to the :fails/bin field: The fault bits must be given as a sum of the codes of the desired fault bits. The following table presents the codes of the fault bits. The sum can also be entered to the field directly from the keyboard. 0 = no fault
16 = inv
2 = ext
32 = old
4 = ovf
64 = der
8 = dis
128 = sex
The fault bits and the value itself will be copied to all the visible elements in the table symbol dialog.
Rev. 2
202 FbCAD Manual
Editable−valintaruudut fails/bin− ja value−kenttien vieressä määrittelevät, ovatko taulukon näkyviksi määritetyt alkiot näkyvissä ja muokattavissa taulukkosymbolin dialogissa. Jos ovat, niin vikabitit ja arvo kopioidaan taulukkosymbolin dialogiin kaikkiin näkyviin alkioihin. In the table symbol dialog, the fault bits and the value of each visible element can later be changed independently from the other elements. To reduce the handling time and the amount of memory required by the big tables it is suggested not to give any common value for the visible elements, if possible. See 10.8.1 (10) Value of :elem(*) for more details.
10.8.7
Length of elements in the diagram — Maximum length of an element This field defines the number of the characters that will be reserved for the initial values of the elements in the table symbol in the diagram. The desired number of the characters is entered in the field. The valid values for this field are 1−100. In the table symbol dialog or in the diagram, you cannot change the length of the elements. For character tables this field has no meaning, but its value will be replaced with the value of the last dimension of the frame.
10.9
EDITING TABLE VALUES IN EXCEL It is also possible to use Microsoft Excel to edit table symbol attribute values. Start editing the values by selecting the Eedit command from the screen menu or menu bar’s Edit−>Edit menu. For further information on using the Eedit command, see chapter 7.4.6 “Eedit − Editing attribute values in Excel”.
Rev. 2
Error Messages and Correcting Errors 203
11
ERROR MESSAGES AND CORRECTING ERRORS You will get error messages when using the check command. Most messages are in text form; part of them are graphic. The errors found by the CHECK command in the function block diagram can be divided into three types:
graphic errors
syntax errors
semantic errors
In case of graphic errors you will besides the error type also be shown the location of the error in the function block diagram in graphic mode. In syntax and semantic errors the location in the function block diagram is not shown, instead the location of error is indicated by the identifier of the automation language module and by the line and step where the error exists.
Rev. 2
204 FbCAD Manual
11.1
GRAPHIC ERRORS A graphic error is reported if the function block diagram contains some ’inaccuracy’, for instance, in the connection of symbols. When you check a function block diagram containing the connection shown in the following Figure (Figure 127) with the CHECK command, you will get error messages indicating that there are two function blocks in the continuous control with the same execution order and a symbol which is not connected. The errors are shown to you in graphic form; the error text will be displayed in blue colour and the insertion point of the faulty symbol is marked with a red circle. The error message is of the following form:
Function blocks with same execution order 1am ja 1calc
Symbol not connected
Figure 127
Graphic error in symbol connection and function block numbering
In text mode a corresponding error message is displayed, but the location of the error is shown by coordinates: Symbol not connected x,y , where x,y is the pair of coordinates of the error in FbCAD’s set of coordinates. With these coordinates it is rather easy to locate the error in the function block diagram.
11.2
SYNTAX ERRORS If the created function block diagram contains a definition that is contradictory to the syntax of the automation language, the check routine will give you a message indicating a syntax error. Example: If you enter invalid characters in the formula line of the function block calc, you will get an error message. For example, if you enter the following formula: o=a*/b, you will get a syntax error because there is a disagreement between the two operators.
Rev. 2
Error Messages and Correcting Errors 205
11.3
SEMANTIC ERRORS If the created function block diagram contains a definition that is contrary to the semantic rules of the automation language, you will get an error message indicating a semantic error. Examples of semantic errors are:
the name of an item does not meet the conditions governing names in the automation language
you try to connect signals of different type
a name is introduced repeatedly
you try to initialize a type with an initial value of the wrong type
Example: You are designing the continuous control pr:FIC−200. This continuous control contains an external input pr:FIC−100, which is of the type ana. You initialize the external input with the value 1.2,10. (No sensibility checks are made when entering the data.) When you check the function block diagram, you will get the following error message indicating the wrong initial value type: SENSIBILITY ERROR IN MODULE: pr:FIC−200 Configuration module line: 84 external: pr:FIC−100 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− pr:FIC−100 TYPE ana = ( 1.2#ERROR#, 1 ) TRANSFER 192,2,0,0; pr:FIC−101 TYPE ana TRANSFER 192,2,0,0; −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− The initial value must be of the type fails, not float.
From this message you can easily see the configuration function and the point in the configuration function where the error exists. To correct this error you must redefine the initial value by replacing it with a value suitable for the ana−type.
11.4
UNKNOWN DXF−ID If the CHECK command error messages include the message UNKNOWN DXF−ID you must give a PURGE command and try to check the function block diagram again. If you are still getting these messages, you must remove graphic objects until no messages of this type are received, or you must exit the FbCAD tool with the QUIT command. If you use the SAVE AS command, it will save a faulty function block diagram that cannot be scanned. This error is so bad that even CAD may have difficulties in retrieving the function block diagram, so do not save the function block diagram with errors, but try to clear the errors.
Rev. 2
206 FbCAD Manual
Rev. 2
Appendix 1
1
FbCAD MENUS File
Edit
View
Draw
Common
Fblocks1 Fblocks2
Fblocks3
I/O
Modules
FbCADHelp
Rev. 4
2
FbCAD Menus
Rev. 4
Appendix 2
1
QUICK GUIDE Desired function
FbCAD
Draw a box . . . . . . . . . . . . . . . . . . . . . . . . Draw - Comments - Box Draw a circle . . . . . . . . . . . . . . . . . . . . . . . Draw - Comments - Circle
Arrowhead
Draw a line . . . . . . . . . . . . . . . . . . . . . . . . . Draw - Comments - Pline
Delete an arrowhead (comment) . . . . . . Edit - Insert arrow
Edit a comment . . . . . . . . . . . . . . . . . . . . . Edit - Values, Edit - Polyedit
Insert an arrowhead (comment) . . . . . . . Edit - Delete arrow
Insert an arrowhead . . . . . . . . . . . . . . . . . Edit - Insert arrow
Attributes
Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Draw - Comments - Dtext Redraw a function block diagram . . . . . . View - Regen
Change attributes . . . . . . . . . . . . . . . . . . . Edit - Values Enter attributes . . . . . . . . . . . . . . . . . . . . . Edit - Values
Cancel the last command
. . . . . . . . . . . . . Edit - Undo
Change object's properties
Connection dot
. . . . . . . . . . . . . . . . . . . . . . . . . Draw - Insert Dot
Connection line Draw scalar type conn. line . . . . . . . . . . . Draw - Scalar wires/Scalar
. . . . . . . . . . . Edit - Change
autocolor wire
Check
Draw table type conn. line . . . . . . . . . . . . Draw - Table wires/Table autocolor wire
Function block diagram . . . . . . . . . . . . . . File - Check
Edit (comment) . . . . . . . . . . . . . . . . . . . . . Edit - Polyedit
Location of objects . . . . . . . . . . . . . . . . . Edit - Page - Verify
Clean the picture database . . . . . . . . . . . . Edit - Purge
Constants Connection on the left . . . . . . . . . . . . . . . Common - Constants left...
Comments layer
Connection on the right . . . . . . . . . . . . . . Common - Constants right... Comment symbol commands . . . . . . . . . Edit - Comment symbol Change comment drawing color . . . . . . Edit - Comments - Color
Continuous control Icon menu . . . . . . . . . . . . . . . . . . . . . . . . . Common - Function module...
Change comment line type . . . . . . . . . . . Edit - Comments - Line type Change comment properties . . . . . . . . . Edit - Change
Copy
Comments on/off . . . . . . . . . . . . . . . . . . . View - Comments on/off
Comment . . . . . . . . . . . . . . . . . . . . . . . . . . Edit - Copy
Copy a comment . . . . . . . . . . . . . . . . . . . Edit - Copy
Object to another page . . . . . . . . . . . . . . Edit - Page - Copy Item To
Delete an arrowhead . . . . . . . . . . . . . . . . Edit - Delete arrow
Part of function block diagram . . . . . . . . Edit - Copy
Rev. 2
2
Quick Guide
Data point
Event functions
Local data point, connection on the left . . . . . . . . . . . . . . . . . . . . . . . . . Common - Locals left...
. . . . . . . . . . . . . . . . . . . . . . . . . Modules - Event...
Exit FbCAD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . File - Exit FbCAD Function block diagram
Local data point, connection on the right . . . . . . . . . . . . . . . . . . . . . . . . Common - Locals right...
Checking, saving and exiting . . . . . . . . . File - Check...
Specifier to the left . . . . . . . . . . . . . . . . . . Draw - specifier :spe_||
Icon menu . . . . . . . . . . . . . . . . . . . . . . . . . Common- Automation module...
Specifier to the right . . . . . . . . . . . . . . . . . Draw - specifier ||_:spe
Formulas
Display management
Create design member . . . . . . . . . . . . . . Edit - Formulas - Create/Edit Design Member definitions
Dynamic zooming (comment) . . . . . . . . . View - Zoom Dynamic
Edit design member values . . . . . . . . . . . Edit- Design Members
Redraw the function block
Edit formulas . . . . . . . . . . . . . . . . . . . . . . . Edit- Formulas - Edit Formulas
diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . View - Redraw View - Regen
Attach a formula to an object . . . . . . . . . Edit- Formulas - Attach/Edit Formula
Zoom the contents of a window . . . . . . . View - Zoom Window
Replace a value of an attribute with a formula . . . . . . . . . . . . . . . . . . . . . . Edit- Formulas - FWizard
Zoom the previous view (comment) . . . . View - Zoom Previous Zoom the whole function block diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . View - Zoom all,
Initialize formulas . . . . . . . . . . . . . . . . . . . Edit- Formulas - Initialize
View - Zoom Extents
Display the objects attached to a certain design member . . . . . . . . . . . . Edit- Formulas - Show Design
Erase
Member Usage Block or part of diagram . . . . . . . . . . . . . Edit - Erase
Display/Hide objects hidden
Comment . . . . . . . . . . . . . . . . . . . . . . . . . . Edit - Erase
using a function formula . . . . . . . . . . . . . View- Function Formulas on/off
Connection Dot . . . . . . . . . . . . . . . . . . . . . Edit - Erase Dot Function block diagram from repository . . . . . . . . . . . . . . . . . . . . . File - Delete...
Error messages
. . . . . . . . . . . . . . . . . . . . . . . . Fblocks1, Fblocks2, Fblocks3
Get Function block diagram from repository . . . . . . . . . . . . . . . . . . . . . File - Open... Repository
List error messages . . . . . . . . . . . . . . . . . View - Show error list
Function block diagram
Show/hide error messages . . . . . . . . . . . View - Errors on/off
from workspace . . . . . . . . . . . . . . . . . . . . File - Open... Workspace
Display an object related to an error . . . Edit - Show Object by Handle
Rev. 2
Function blocks
Graphic testing tool
. . . . . . . . . . . . . . . . . . . . File - Test...
Appendix 2
History functions
Measurements to PCS . . . . . . . . . . . . . . . Modules - MCP - IO measure...
. . . . . . . . . . . . . . . . . . . . . . . Modules - History.../History2...
MCP counter function block . . . . . . . . . . Modules - MCP - ipcnt...
Inputs
MCP delay function block . . . . . . . . . . . . Modules - MCP - ipdel... External continuous inputs . . . . . . . . . . . Common - Externals in
MCP pulse function block . . . . . . . . . . . . Modules - MCP - ippls...
continuous...
MCP symbol . . . . . . . . . . . . . . . . . . . . . . . Modules - MCP - MCP
List
module... State and fault data symbols . . . . . . . . . . Modules - MCP - fault IO...
Function block diagrams
Symbols of extension interfaces . . . . . . . Modules - MCP - exten IO...
in workspace . . . . . . . . . . . . . . . . . . . . . . . File - Open... List
Mimic panel controls
Loading
. . . . . . . . . . . . . . . . . . Modules - Mimic...
Move
Loading to the real runtime environment . . . . . . . . . . . . . . . . . . . . . . . File - Download Real... Loading to the virtual runtime environment . . . . . . . . . . . . . . . . . . . . . . . File - Download Virtual...
Comment . . . . . . . . . . . . . . . . . . . . . . . . . . Edit - Move Object to another page . . . . . . . . . . . . . . Edit - Page - Move Item To Objects with their connections . . . . . . . . Edit - Stretch
Macros
Part of function block diagram . . . . . . . . Edit - Move Create a macro . . . . . . . . . . . . . . . . . . . . . Edit - Macro - Make Delete a macro from the directory . . . . . Edit - Macro - Delete Insert a macro in the function
Zoomed area (comment) . . . . . . . . . . . . . View - Pan
Navigate Examining external connections . . . . . . . File - Navigate
block dialog . . . . . . . . . . . . . . . . . . . . . . . . Edit - Macro - Insert
Numbering MCP Renumbering of function blocks . . . . . . . Edit - Edit - Renum Access to MCP menu . . . . . . . . . . . . . . . . Modules - MCP
Operation functions
. . . . . . . . . . . . . . . . . . . . Modules - Operation...
Controls from PCS . . . . . . . . . . . . . . . . . . Modules - MCP - IO control... Field controls and measurements . . . . . Modules - MCP - field IO... Logic operations . . . . . . . . . . . . . . . . . . . Modules - MCP - logic right... Modules - MCP - logic left... Modules - MCP - and/or right... Modules - MCP - and/or left...
3
Outputs External conditional outputs . . . . . . . . . . Common - Externals out conditional... External continuous outputs . . . . . . . . . . Common - Externals out continuous...
Rev. 2
4
Quick Guide
Page
Ports Direct access port, connections on the left . . . . . . . . . . . . . . . . . . . . . . . . . . Common - Direct access left...
Change the size of a page . . . . . . . . . . . Edit - Page - Create - 0 Create . . . . . . . . . . . . . . . . . . . . . . . . . . . . Edit - Page - Create
Direct access port, connections
Delete a page . . . . . . . . . . . . . . . . . . . . . . Edit - Page - Delete
on the right . . . . . . . . . . . . . . . . . . . . . . . . Common - Direct access right...
Select a page . . . . . . . . . . . . . . . . . . . . . . View - Select Page
External input ports . . . . . . . . . . . . . . . . . Common - External ports in... External output ports . . . . . . . . . . . . . . . . Common - External ports out...
Previous page . . . . . . . . . . . . . . . . . . . . . . View - Previous Page
Input interface port . . . . . . . . . . . . . . . . . . Common - Interfaces in... Next page . . . . . . . . . . . . . . . . . . . . . . . . . View - Next Page
Parameters
Output interface port . . . . . . . . . . . . . . . . Common - Interfaces out...
Print
Change parameters . . . . . . . . . . . . . . . . . Edit - Values
Function block diagram with a printer . . . . . . . . . . . . . . . . . . . . . . . File - Print...
PLU
Function block diagram of many Access to PLU menu . . . . . . . . . . . . . . . . Modules - PLU
pages with a printer . . . . . . . . . . . . . . . . . File - Print... Symbol parameters . . . . . . . . . . . . . . . . . File - Print param
Controls from PCS . . . . . . . . . . . . . . . . . . Modules - PLU - IO control... Field controls and measurements . . . . . Modules - PLU - field IO... Logic operations . . . . . . . . . . . . . . . . . . . . Modules - PLU - logic right... Modules - PLU - logic left... Modules - PLU - and/or right... Modules - PLU - and/or left... Measurements to PCS . . . . . . . . . . . . . . . Modules - PLU - IO measure...
Update links . . . . . . . . . . . . . . . . . . . . . . . File - Print links
Recipes Absolute value loading function block . . Modules - RECIPE - ldx abs... Access to Recipe menu . . . . . . . . . . . . . . Modules - RECIPE External conditional inputs . . . . . . . . . . . Modules - RECIPE - ext I conditional... External inputs/outputs . . . . . . . . . . . . . . Modules - RECIPE ext I/O... +-
PLU counter function block . . . . . . . . . . . Modules - PLU - ipcnt... PLU delay function block . . . . . . . . . . . . . Modules - PLU - ipdel... PLU pulse function block . . . . . . . . . . . . . Modules - PLU - ippls... PLU symbol . . . . . . . . . . . . . . . . . . . . . . . . Modules - PLU - PLU module... State and fault data symbols . . . . . . . . . . Modules - PLU - fault IO...
External outputs/inputs . . . . . . . . . . . . . . Modules - RECIPE ext O/I... -+ External outputs/inputs (narrow) . . . . . . Modules - RECIPE - ext O/I variation... Loading function block for loading function . . . . . . . . . . . . . . . . . . . . . . . . . . . Modules - RECIPE - ldx load...
Symbols of extension interfaces . . . . . . . Modules - PLU - exten IO... Symbols of extension interfaces . . . . . . . Modules - PLU - exten IO...
Rev. 2
Loading function blocks for relative values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Modules - RECIPE - ldx prop...
Appendix 2
Reference points
5
Symbol Change symbol . . . . . . . . . . . . . . . . . . . . Edit - Edit - ChBlk
Add a reference point . . . . . . . . . . . . . . . Draw - Add reference...
Create symbol . . . . . . . . . . . . . . . . . . . . . Edit - Comment symbol - Make Delete comment symbol . . . . . . . . . . . . . Edit - Comment symbol -
Display reference points . . . . . . . . . . . . . Draw - Show references
Delete Insert comment symbol into the function block diagram . . . . . . . Edit - Comment symbol - Insert
Save
Table connection line
. . . . . . . . . . . . . . . . . . Draw - Table wires/Table autocolor wire
Function block diagram . . . . . . . . . . . . . . File - Save As...
Tag functions
. . . . . . . . . . . . . . . . . . . . . . . . . . . Modules - Position...
Function block diagram from workspace to repository . . . . . . . . . . . . . File - Save As...
Trend functions
. . . . . . . . . . . . . . . . . . . . . . . . . Modules - Trend...
Update links Scalar connection line
. . . . . . . . . . . . . . . . . Draw - Scalar wires/Scalar autocolor wire
Edit update links . . . . . . . . . . . . . . . . . . . . Edit - Edit Link Comments Print update links . . . . . . . . . . . . . . . . . . . File - Print links
Rev. 2
6
Quick Guide
Rev. 2
Appendix 3
1
FUNCTIONS ALLOWED IN FORMULAS FUNCTIONS ALLOWED IN VALUE FORMULAS Enter the formulas in compliance with the standard C language syntax. Calculations may be done with mixed real and integer numbers. In front of aritmethic formulas a prefix ’eval:’ must be added. Text can not be handled in an eval formula. Entering a ready−made prefix is done with a prefix formula. Formula syntax pr:$(TAG).I eval:$(ME_MAX)−0.05*($(ME_MAX)−$(ME_MIN))
Operators * / % + − AND, and OR, or XOR, xor NOT < > = != ==
Prefix formulas Prefix formula makes it easier to handle external data points and enter values. Prefix formula is created by adding the prefix “prefix:”. prefix:pr:$(EXT1)
The following table presents the functionality of the prefix formula with the help of examples: Formula
$(EXT1)
Result
prefix:pr:$(EXT1)
FIC−100
pr:FIC−100
prefix:pr:$(EXT1)
#li:FIC−100
li:FIC−100
prefix:pr:$(EXT1)
#
prefix:pr:$(EXT1)
pr:
prefix:pr:$(EXT1):ins
FIC−100
pr:FIC−100:ins
prefix:pr:$(EXT1):ins
#li:FIC−100
li:FIC−100:ins
prefix:pr:$(EXT1):ins
#
:ins
prefix:pr:$(EXT1):ins
pr::ins
Rev. 1
2
Functions Allowed in Formulas
Value reference formulas (parent/child) A value reference formula is used to read the referenced value from the parent loop. When the value changes, it does not need to be re−entered to the child loop because it will be automatically updated from the referenced parent loop. Formula syntax #(PARENT_NAME:\$(PARENT_PARAM_NAME))
For example #($(TAG):\$(EXE)) #($(TAG):\$(NAME20))
Select formula A Select formula can be used to choose one of the values in the list to be the value of the formula. The chosen value depends on the value of the design member which is presented in the formula. The Select formula is created by adding the prefix “select:”. select: $(variable);val1=res1;val2=res2;val3=res3;…
Example: The result of the following formula is 256 when the value of the $(MULTI) design member is two, as shown in the following figure. select: $(MULTI);0=1;1=128;−1=None;2=256;3=;
Predefined constants pi, PI exp1, EXP1
pi Neper number
Predefined functions A function can take an expression as its argument. For example: sqrt (1 + sqrt (in1) * pi) > 100
Trigonometric functions sin(x) sine, argument in radians cos(x) cosine, argument in radians tan(x) tangent, argument in radians asin(x) returns arcus sine between −PI/2 to PI/2 acos(x) returns arcus cosine between 0 to PI atan(x) returns arcus tanget between −PI/2 to PI/2
Other functions exp(x) returns exponent ln(x), x>0 returns natural logarithm log(x), x>0 returns radix 10 logarithm sqrt(x), x>0 returns square root abs(x) returns absolute value rand() returns pseudo random number between 0 to 32767
Rev. 1
Appendix 3
FUNCTIONS ALLOWED IN FUNCTION FORMULAS In function formulas, text can be handled. Formula syntax $(COUNTER)==ON
Operators < > = != ==
Operator precedence () not() * / % + − < >= == != xor and or
Rev. 1
3
4
Functions Allowed in Formulas
Rev. 1
