ALSPA Control System Controcad V5.3 Configuration of Functions Reference Manual
ALSPA Control System Controcad V5.3 Configuration of Functions Reference Manual
10/03/2016
OPERATING & MAINTENANCE MANUAL
GE
Industrial Solutions
Automation & Controls
GE
Industrial Solutions
Automation & Controls
Table of contents
Section 1 Introduction
This document describes the complete functional tree structure (Fct tab) of Controcad
including the functions, the variables and their management in the grid of variables and the
editors of FBD and SFC diagrams.
It is made for the engineering and commissioning teams. It is part of the Operating &
Maintenance Manuals (OMM) and can be used by the maintenance team on site.
This document is applicable to Controcad version 5.3.
Hardware repair
Annual preventive maintenance
Telephone, e-mail, fax, remote maintenance, Web facilities
On site intervention
Software maintenance
Training session for commissioning engineers and customer users.
Contact: [email protected]
DANGER
Indicates a situation of imminent danger which, if it is not avoided, will lead to
death or serious injury. This indication is restricted to the most extreme
circumstances.
WARNING
Indicates a potentially dangerous situation, which if it is not avoided will lead to
death or serious injury.
CAUTION
Indicates a potentially dangerous situation which, if it is not avoided, may cause
minor or moderate injuries. This indication may also be used to warn against
unsafe practices.
ELECTRICAL WARNING
Indicates a potential electrical danger related to voltages, currents, temperature, or
other conditions that may cause an electric shock or burn.
Turn off and disconnect any electrical power supply before servicing.
These instructions do not purport to cover all details or variations in equipment, nor to provide for every possible contingency to be
met during installation, operation, and maintenance. The information is supplied for informational purposes only, and GE makes no
warranty as to the accuracy of the information included herein. Changes, modifications, and/or improvements to equipment and
specifications are made periodically and these changes may or may not be reflected herein. It is understood that GE may make
changes, modifications, or improvements to the equipment referenced herein or to the document itself at any time. This document
is intended for trained personnel familiar with the GE products referenced herein.
GE may have patents or pending patent applications covering subject matter in this document. The furnishing of this document
does not provide any license whatsoever to any of these patents.
GE Internal – This document contains information that belongs to the General Electric Company and is furnished to its customer
solely to assist that customer in the installation, testing, operation, and/or maintenance of the equipment described.
This document or the information it contains shall not be reproduced in whole or in part or disclosed to any third party without the
express written consent of GE.
GE provides the following document and the information included therein as is and without warranty of any kind, expressed or
implied, including but not limited to any implied statutory warranty of merchantability or fitness for particular purpose.
For further assistance or technical information, contact the nearest GE Sales or Service Office, or an authorized GE Sales
Representative.
ELECTRICAL WARNING
ELECTRICAL PROTECTION
The equipment presents dangers to the personnel and to the equipment itself.
These dangers are mainly electrical in nature, such as:
electric shock
transient increases and decreases in electrical power
electrostatic discharge
Working inside the equipment may have an impact on the physical integrity of the
person or the equipment itself.
During installation, the equipment must be powered down.
Shut down properly your equipment and power it off before hardware installation.
CAUTION
RADIO FREQUENCY INTERFERENCE
CAUTION
STATIC SENSITIVE DEVICES
The ALSPA control system equipment has been developed, manufactured and tested to
comply with the relevant standards.
All these standards are indicated in the following document
[STD&COD] - ALSPA Series 6 - Standards and Codes - refer to the documents list of
the project.
In order to achieve optimum operation of the equipment you must always keep in mind that
the standards should be complied with.
The above-mentioned document details the certification and the operating and
electromagnetic environment in which your equipment must be used.
1.6 Glossary
or S8000 unit together with the ALSPA HMI. This network is based on Ethernet
technology. It is also named S8000.
Field Bus or E8000 Network which connects the master controllers to the field controllers
based on Ethernet Powerlink technology. It is also named E8000.
Historian Function for long term history of the events and measurements of the
plant. This function comprises data servers and HMI viewers.
IMS Information Management System of ALSPA HMI. It provides statistics
computation and reports generation. This function includes data
servers, report generator and report viewers.
I/O Controller These controllers manage the inputs and outputs coming from the
Field Controller sensors and devices of the plant. It can be placed near the devices and
be remote from the main controller.
Master Controller or Main controller of the automation cell. It executes application software
Cell Controller with the data coming from the I/O controllers and controls the process
by sending orders.
MFC3000 / MFC1000 Master controllers of the ALSPA system.
OMM Operating & Maintenance Manual.
OS or CVS Operator stations which supports the operating HMI functions of
ALSPA HMI.
RTDS or CIS Real Time Data Server: this function of ALSPA HMI manages in real time
the process data coming from the plant. The RTDS function uses the
OPC function to exchange data with the OS and third party
applications.
The RTDS function communicates with the automation cell through the
process bus.
Notation for Signals used in ALSPA Control System.
cASig Controller analog signal
ihASig Internal HMI analog signal
ohASig Operator parameter HMI analog signal
phASig Program HMI analog signal
cBSig Controller boolean signal
ihBSig Internal HMI boolean signal
shBSig System HMI boolean signal
phBSig Program HMI boolean signal
dhBSig Controller default boolean signal
cMSig Controller multi-state signal
ihMSig Internal HMI multi-state signal
phMSig Program HMI multi-state signal
ccCmd Controller Command
2.1 Overview
Any element in the Function tree may own variables. A function or a diagram
declared as a proprietor may have a set of attached variables. This notion
expresses the fact that the function (or the diagram) and its variables are linked
functionally. Consequently the ID of the variables includes this affiliation and the
variables mirror the fate of their owner (duplicate, delete etc.). More precisely, the ID
of a variable is formed by the concatenation of the ID of the proprietor of the
variable and of the name of the variable.
To implement this mechanism, a short name is associated to the tree elements. Any element
that is a proprietor of variables must possess a short identifier.
Each element of the Function tree possesses an ID that provides a unique identity and that is
formed by the concatenation of the ID of its proprietor and its specific short identify. The ID of
an element appears between brackets to the right of the element in the tree.
The illustration below provides an example:
Function CEX is a proprietor of variables and has a short identifier CEX. For the project, it is for
example functionally interesting to display a reference to one of the root functions UNITE_10.
In this case, a short identify "10" is associated to the function. The reference to the root
function WATER_PLANT serves no purpose; it thus has no short identify.
The variable named VAR1 created at the level of the function CEX will have 10CEX-VAR1 as
process ID. This is the result of the concatenation of the ID of its owner ( 10CEX-) and of its own
name (VAR1).
The following chapters detail the elements in the tree, via the contextual menus that are
associated to them.
2.2 Project
- List Documents Used to display the list of all the project documents.
- Export EMF (all Exports all the diagrams in the form of images, in EMF
diagrams) format accessible by Word.
Functional Export Executes the functional export window (cf. 2.2.2,Exporting a
function).
Functional Import Executes the functional import window(cf. 2.2.3,Importing a
function).
Application Variables
Item Description
the functional tree (cf. 2.2.9,Common Parameters
Configuration Window).
Advanced Configuration
No confirmation is asked.
– List of the pit/source Used to display the isolated steps and transitions in the SFC
steps/transitions in the diagrams.
SFCs
Draw Out Used to detach the Function tree into a separate window,
which is used simultaneously to display another tree.
Configure Logical Devices For projects with CE1500 controllers configured on a
... IEC61850 network.
This item is used to build a functional IEC61850 architecture
(cf. 2.2.12,Configuring Logical Devices (IEC61850)).
The Functional Export option in the project contextual menu opens a window enabling the
export of one or more functions and their dependents, of one or more diagrams or of one or
more POUs:
In this export window, the user defines the directory containing the variables to be exported
and supplies the list of variables to be exported by a drag & drop between the Function tree
and this window.
Between two export operations, the user can back up the list of objects placed in the window
by clicking on Save collection option . The list can be restored on the next export by using the
Load collection option.
A report enables the user to monitor the progress of the export:
The Functional Import option in the contextual menu of a project opens a window enabling the
partial import of one or more functions and their dependents, of one or more diagrams or of
one or more POUs.
In this import window, the user selects the file gen_xml_report.xml located in the directory
containing the variables to be imported.
If the Import abort option of the Mandatory Variable part is checked, the variables required (vars
KCZ, KIT, CTRL or RES) are mandatory and the import will fail if these variables cannot be
found.
A report file is generated to enable the user to check the progress of the import:
Before importing a function A from a project XXXlog to a project YYYlog, check that
the libraries used by A have already been imported into YYYlog.
This function is used to clear all the variables created and non-consumed in a diagram, an
exchange array or a controller.
Selecting the Purge option associated to the contextual menu of a project in the function tree,
opens the following window:
Message Description
Address defined by user Variable whose address has been fixed by the user (for
example: variable defined in an external exchange
array).
Mapped on a board Variable assigned to a channel on a controller
Input/Output board.
Used in SFC transition(s) or Variable used in SFC diagram transition or action.
action(s)
Used in SFC delayed action(s) Variable used in a delayed action in an SFC diagram.
Used in SFC Boolean action(s) Variable used in a Boolean action in an SFC diagram.
Used in DI-OPC Variable used in a DI-OPC.
Used in gateway Variable assigned in a Gateway.
Used in authorization gateway Variable assigned in a Gateway authorization.
used in signal recopy Variable assigned to the copy signal.
Used in order recopy Variable assigned as a copy order.
Used in another project Variable used in another project (multi-project).
Description of the buttons:
The Initial Order button is used to put the variables in their initial order i.e in the order they
are listed in the variable grid.
The Select All button is used to select all the variables in the list for analysis. The user may
select only a part of the variables for analysis, but in this case each variable to be analysed
must be checked individually in the column Purge.
The Clear All button is used to deselect all variables of the list with the Purge box checked.
The user can deselect only a part of the variables but each variable that is not to be
analysed must be unchecked individually
The Analyse button starts an analysis of the variables listed to check whether they are used
or not. At the end of the analysis, the variables are defined as used ( Used box checked) or
that can be cleared (Purge box checked). When a variable is defined as used (Used), a
message detailing the use of the variable is shown in the State column (variable used in an
FBD diagram, consumed in an HMI DB object etc.).
The Purge button triggers the purge of the variables. Clicking on this button definitively
deletes from the project the variables that have the Purge box checked. This button is only
activated after the analysis is completed.
The Save as… button is used to save the result of the analysis of the variables in the list. This
button is only activated after the analysis is completed.
The Cancel button is used to abort the purge function and close the window.
The Help button is used to display the contextual help of the current window.
The Count zone
This is an information zone showing the number of used, unused and cleared variables. The
fields are calculated automatically in accordance with the actions performed.
A variable is said to be used in a Controcad project when it satisfies to at least one of the
following criteria:
The variable is not in the initial list produced by the filter specified by the user,
The variable is the parent of a used variable,
The variable is a dependent of a used non-modulate MV with at least one field used,
The variable is an exchange array,
The variable has a forced address (e.g. a variable mapped to an external table),
The variable is mapped on an input/output channel,
The variable is used in an SFC transition or action,
The variable specifies an SFC action timeout,
The variable is an SFC Boolean action,
The variable is mapped to an FB input or output in an FBD,
The variable names an FB,
The variable consumes an HMI object,
The variable is consumed by an HMI object,
The variable is used in a command authorization,
The variable is a DhBSig or a ShBSig.
If, when the MV processing extension is created, it consumes a variable W that is dependent
on this MV, W will never be detected as unused (even though it serves no purpose) as it is
consumed by this MV.
Example: In the case of a SEQ_FG_V model MV, none of the variables composing the MV will
be detected as unused even if the MV in its entirety is not used.
Any variable that does not participate in Historian processing is not detected as unused. The
same is true for a variable that belongs to a function of SYSTEM type.
To clear the unused variables from the project, execute the following actions:
Define which level of the tree is to be cleared by applying the appropriate search filter.
Decide whether or not to clear the HMI and I/O variables by checking the Without HMI
Variables and/or Without Input/Output Variables boxes, noting that certain criteria will not
show whether these variables are really used or not (variables in mimics, in Historian and
in PRISCA).
Apply the filter chosen by clicking on the Add button. The user can enter several filter values
by clicking successively on Add after each new choice. The result of applying each filter will
be shown in the lower part of the Purge window.
The filters applied in the "Variable Name Like" zone are cumulative. The list of variables
displayed in the lower part of the Purge window is added to as the different values in the
"Variable Name Like" filter are applied. All the variables present respond to the filters as
they are successively applied. The user can click Cancel at any time but the selection will be
lost as this action aborts the purge function.
Select the variables to be analyzed for clearance: either by clicking on Select All or by
individual selection. In the list of the variables displayed the user can check or uncheck the
Purge box of each variable in accordance with the choice "Conserve" or "Delete if
considered unused".
The user can also use the Clear All and Invert buttons to modify the list of variables to be
analysed.
Run the variable analysis by clicking on Analysis button: the analysis updates the list of the
variables in accordance with the criteria for the use of each variable. The user may then
choose to conclude the analysis by conserving the clearable variables, and therefore
uncheck their Purge boxes.
Alternately, the user can choose to save the result of the analysis in a file; the presentation
format of this file can be chosen from the options in the pull-down menu of the backup file
selection window: CSV, Excel, HTML, text etc.
If the user wishes to ensure that the purge will not destroy variables that may be required
at a later date, he can at this stage save the result of the analysis in a file, abort the
function by Cancel and consult the file. The purge can then be rerun later.
Clear variables by clicking on the Purge button: this starts a session in which each variable
with a checked Purge box will be deleted. A screen is displayed to prompt user
confirmation the clearance operation.
The List of POU option, accessible from the contextual menu associated to the project or from
the Configuration menu, opens the POU creation window.
The fields POU name, Label, Type, Period, Phase and Redundancy can be modified.
A program contains application code to be loaded into a controller. The program is defined by
associating the POUs that themselves are defined by linking the diagrams.
Note: A POU may be an FBD type POU (which contains only FBDs) or an SFC type POU (which must contain
all the SFC diagrams linked to the FBDs called by the actions of the SFC diagrams of the POU).
The following contextual menu is associated to each FBD POU in the Master window:
All the SFCs whose elapsed time variables (_T) are used to specify the POU SFC action time
(transmission phase D or L) belong to the POU.
All the SFCs used to specify the action time (transmission phase D or L) of the POU SFC
elapsed time variables (_T) belong to the POU.
If one of the tests fails, the LEA code is not generated, and a window shows the diagrams that
pose a problem.
LEA code displays the LEA code previously generated in read only mode.
The LEA code generated for an SFC POU translates the following cyclical behavior:
1. Read inputs.
2. Calculation of the clearability of the transitions.
3. Update of the situation (assessment of the activity of each step with integration of
forcing orders).
4. Transmission of Boolean actions.
5. Execution of FBD actions.
6. Transmission of the outputs.
Check SFC Consistency :(cf. 2.4.9,SFC diagram completeness)
Actions for associated POU: (cf. 2.4.10,Displaying the Boolean Actions and FBDs of an SFC POU)
Forcing order priority: displays the forcing orders of the POU and is used to modify priorities in
case of multiple forcing orders on a diagram.
A filter is used to display only the SFCs forced by several other SFCs (Only SFC forced with
multiple SFC).
The master window lists the forced SFCs of the POU with their access path/long name (and
short name).
The Detail window lists each of the forcing orders on the diagram selected in the master
window with the access path/long name (and short name) of the forcing diagram, the
transmission step of the forcing order, the transmission phase (N or P1) and the list of the
forced steps.
In the case of multiple forcing orders, priority orders are modified by dragging & dropping the
icon representing a hand associated to each forcing order. The order with the highest priority
is at the top of the list.
Filter... applies a filter to the POU list.
The following contextual menu is associated to the Detail window of the selected POU:
Clicking the Affectation option of the contextual menu associated to the List of POU window
opens the following window:
This window displays the workspace(s) to which the selected POU is assigned.
Description of the fields:
Type Name Description
POU Name Name of the POU.
Workspace Workspace to which the POU is assigned.
Controller Name of the controller to which the POU is
associated.
Program Name Name of the program to which the POU is
associated.
Exec. Num. Order number of execution of the POU in the
program.
Description of the buttons:
The Cancel button is used to close the window.
The Help button is used to display the contextual help of the current window.
ALSPA Control System - Controcad V5.3 Document N° Language: Revision: Page:
The search function is accessible at all levels of the functional tree via the Find option.
The search is performed from the current level for all the levels below.
This window shows a list of the elements containing the string being searched for. The
functions and diagrams are preceded by their usual icons.
Double click an element to select it and to open the diagram or the variable grid depending
on the case.
Clicking on the Edit Common Parameters option opens the following window:
Clicking on the Application Variables > Filter option opens the following window:
The screen is composed of a DB Filter tab which is used to apply a filter to all the variables in
the database. The screen is identical to variable grid filter window (cf. 3.12,Filtering a Grid of
Variables).
This function has been developed to allow displaying one or more variables whose ID
corresponds to a pattern input by the user.
This restricted view of variables allows the user to quickly access a variable in order to edit it
and also to reduce backup times of the grid.
This search and modification function is available:
At all levels of the functional tree using the shortcut Ctrl + M.
In the Project contextual menu using the Application Variables > Find & Modify item.
Clicking on the Find & Modify option opens the following window:
After confirming by Ok, the variables corresponding to the filter are displayed in the grid
variables.
The variables belonging to a MV are displayed along with all the variables which belong to the
complete structure of the MV. These MV are displayed unfolded.
The first row for the search term is highlighted in blue.
The number of variables to display should not exceed the authorized number of
variables in the grid.
The changes authorized on the variables are defined according to the type of the
variable and to the user level
Clicking the Configure Logical Devices ... option opens the following window:
This window is used to configure an IEC61850 functional architecture. It is part of the steps for
configuring the IEC61850 function on ALSPA CE1500 controllers.
Refer to [CCAD_CE61850] for more information about the configuration steps of the
IEC61850 function (in § 1.7 List of Referenced Documents).
The window is divided in four parts:
1. Left side: list of the declared IEDs (Intelligent Electronic Devices) and logical device
structure.
This tree structure consists of a root node representing the IEC61850 IED configuration
and the project IEDs.
2. Middle : functional structure tree.
This tree structure is used to declare the functional nodes of the project (substation,
bays...) and to create Logical Nodes.
3. Right side: properties panel.
The properties panel displays the properties of the selected node. These properties can
be edited.
4. Bottom: variable grid.
The variable grid displays the variables of the logical node selected in the functional
structure tree (data objects and data attributes mapped in Controcad variables).
For detailed information about the configuration of an IEC61850 functional
architecture, see [CCAD_CE61850] (in § 1.7 List of Referenced Documents).
2.3 Function
A function can be created from the Project or Function elements. The function is created in
the tree below the element from which the creation is requested.
Clicking on this option opens the following window:
When a function is deleted, all its descendents are destroyed (including variables).
Item Description
Owner Sub-levels Displays the variables whose owner is the selected function
or the functions under it.
Edit Linked Documents Is used to configure the link with a document; different types
of document may be configured (.doc, .mpg, .html URL etc.).
Display Linked Documents Is used to display linked documents.
Configure Logical Devices For projects with CE1500 controllers configured on a
... IEC61850 network.
This item is used to build a functional IEC61850 architecture
(cf. 2.2.12,Configuring Logical Devices (IEC61850)).
A function and its dependents or an FBD can be moved using the Cut command on the
element to be moved then the Paste command after placing the cursor on the destination
node of the element being moved.
When the element is pasted, the following window opens:
This window is used to select the type of merging to be executed when the elements cut are
present in both the source context and the destination context.
Description of the fields:
Type Name Description
Replace only master data Only the data explicitly exported and produced in
the functions/diagrams exported will be
replaced.
Replace all data All the existing data will be replaced by the
incoming data.
Description of the buttons:
The Ok button executes the movement/merging in compliance with the option chosen and
closes the window.
The Cancel button is used to cancel the movement/merging.
2.4 Diagram
The user can create 3 types of diagram: FBD, SFC and HLD.
A diagram is created from the function elements via the New option.
The diagram is created in the tree below the function from which the creation has been
requested.
The Cancel button is used to discard the changes and close the window.
The Help button displays contextual help for the window.
The following contextual menu is associated to the FBD element in the Function tree:
Item Description
Documentation Is used to manage the documentation of the diagram.
Functional Export… Executes the functional export window(cf. 2.2.2,Exporting a
function).
Functional Import… Executes the functional import window(cf. 2.2.3,Importing a
function)
Application Variables
Arrangement Current Level Displays the variables associated with the selected
diagram
Owner Current Level Displays the variables whose owner is the selected
diagram.
Assigned Variables Displays the variables used in the diagram.
FBD Local Variables Displays the local variables of the FBD.
Assigned Variables & FBD Displays the variables used in the diagram and the local
Local Variables variables of the FBD.
Open Diagram Opens the diagram in the diagram editor.
Find in List of POU Displays the window to create POU and indicates in blue
color the POU and the diagram in the POU. If diagram has
no associated POU, a message box is displayed.
Code Displays the code of the diagram (cf. 2.4.7,Code of an FBD).
Edit Linked Documents Is used to configure the link with a document; different
types of document may be configured (.doc, .mpg, .html
URL etc.).
Display Linked Documents Used to display linked documents.
FB Used Is used to display the type and number of functional blocks
used in a diagram (cf. 2.4.8,FBD Functional Block
Consumption).
Cross References Displays the variables belonging to the diagram and used
in other diagrams; displays the list of SFC diagrams calling
the diagram designated as an FBD action(cf. 2.4.11.1,FBD
Cross References).
Configure Logical Devices ... For projects with CE1500 controllers configured on a
IEC61850 network.
This item is used to build a functional IEC61850
architecture (cf. 2.2.12,Configuring Logical Devices
(IEC61850)).
The following contextual menu is associated to the SFC diagram element in the Function tree:
Item Description
a function).
Application Variables
Arrangement Current Level Displays the variables associated with the selected
diagram
Owner Current Level Displays the variables whose owner is the selected
diagram.
Assigned Variables Displays the variables used in the diagram.
Step Variables Displays a list of variables active in the SFC steps.
Open Diagram Opens the diagram in the diagram editor.
Find in List of POU Displays the window to create POU and indicates in blue
color the POU and the diagram in the POU. If diagram has
no associated POU, a message box is displayed.
Edit Linked Documents Is used to configure the link with a document; different
types of document may be configured (.doc, .mpg, .html
URL etc.).
Display Linked Documents Is used to display linked documents.
Check SFC Consistency Used to display incomplete or invalid SFC steps. (cf.
2.4.9,SFC diagram completeness)
Actions for associated POU Used to display all the Boolean actions and FBD actions of
the POU containing the SFC. (cf. 2.4.10,Displaying the
Boolean Actions and FBDs of an SFC POU)
Cross References Displays the variables belonging to the diagram and used
in other diagrams; displays the list of step variables of the
diagram used in other diagrams (cf. 2.4.11.2,SFC Cross
References).
Configure Logical Devices ... For projects with CE1500 controllers configured on a
IEC61850 network.
This item is used to build a functional IEC61850
architecture (cf. 2.2.12,Configuring Logical Devices
(IEC61850)).
The following contextual menu is associated to high level diagrams in the Function tree:
Item Description
The HLD editor is yellow while the FBD and SFC editors are
grey.
Edit Linked Documents Allows the user to configure the link with a document of
different types (.doc, .mpg, .html, URL, …).
Display Linked Documents Allows the user to view the linked documents.
Configure Logical Devices ... For projects with CE1500 controllers configured on a
IEC61850 network.
This item is used to build a functional IEC61850
architecture (cf. 2.2.12,Configuring Logical Devices
(IEC61850)).
The following rules must be observed to enable project (or part of a project)
imports/exports to manage associated file type documents fully.
Files to be associated to the controllers must be located on the server in the
following tree in the project directory (xxxlog):
//<server UNC name>/P320Share/Ccad/<xxxlog>/docuser/Lib
The association must be executed using the UNC name of the server.
Click the Properties option of a diagram contextual menu to open the window below:
The diagrams in the function tree can be duplicated via a copy/paste operation.
When the user copies and pastes a diagram, the following window opens:
The Code option opens a window in consult mode displaying the code of the FBD:
Each line of code is identified by a number that corresponds to the execution order number of
the component in the diagram. If a component does not produce any code, the line exists but
is empty. The Error column shows the number of errors on the line.
The Save as button is used to save these lines of code.
The Close button is used to close the window.
Note: The diagram code is produced by Controcad when the diagram is saved in the diagram editor. This
option is used to determine why the diagram code is not correct.
The FB Used option opens a window displaying (in read-only mode) the type and number of the
functional blocks consumed in the diagram selected.
The Check SFC Consistency option opens a window in read only mode showing any incomplete or
inconsistent steps and conditions of the SFC diagram.
Uncompleted conditions: lists all of the invalid conditions showing the type of condition (transition
or action condition) and the transition number or the transmission step of the associated
action.
The Actions for associated POU option opens a window in read only mode showing all the Boolean
actions and FBD actions of the POU containing the SFC diagram.
A filter can be used to display only the actions transmitted by more than one step ( Only actions
with multiple senders).
The master window lists each of the Boolean variables and the FBDs called in actions,
showing their full name and the type of action (Boolean or FBD).
The detail window lists the SFC diagrams transmitting the action selected in the master
window, showing the full name of the diagram (long and short), the transmission step number,
the phase and the operation of the action (and time for a phase L or D action – (cf.
5.4.4.2.1,Boolean or FBD Action)).
The FBD Cross References option opens a window in read only mode showing the variables that
belong to the diagram and used in other diagrams, as well as the list of SFC diagrams calling
the diagram designated as an FBD action.
The SFC Cross References option opens a window in read only mode showing the variables
belonging to the diagram and used in other diagrams, including step variables (activity and
elapsed time), as well a the list of forcing orders on the diagram.
The SFC variables used in other diagrams field lists the diagram variables used in other diagrams,
showing the full variable name, the long (and short) name of the diagram where it is
consumed, the diagram type (FBD or SFC) and the origin of the diagram (Function tree or
Hardware tree).
The Step variables used in other diagrams field lists the step variables of the diagram used in the
other diagrams, showing the step number, the variable type (activity X or time T), the long
(and short) name of the consumer diagram, the diagram type (FBD or SFC) and the origin of
the diagram (Function tree or Hardware tree).
An SFC diagram can only originate from the functions tree. An FBD can originate from either
the functional or hardware architecture. Normally this occurs when the FBD has been
modified since the last generation.
The Forcing orders emitted by field lists each the forced values on the diagram with the long (and
short) name of the forcing diagram and the forcing step in the forcing diagram.
In the Lib tab, select the Cross References item of the HLD contextual menu to open the Cross
References of the Component window.
The Functional Diagrams tab displays the diagrams used in the selected element of all the
diagrams of the functional tree.
The Workspace Diagrams tab displays the diagrams used in the selected element of the
hardware tree.
Description of the buttons:
The Ok button closes the window.
The Help button displays contextual help for the window.
2.5 Object
Click the New option of the contextual menu associated to a function to open the New/Properties
window.
When deleting an object, the object is deleted but not the elements which are
composed of it.
Select the Properties option or double-click an object to open the following window.
There are two kinds of variables in Controcad: simple variables and multiple variables. They come
from the Simple Variable Models (SVM) and Multiple Variable Models (MVM) respectively.
Single variables: these are independent variables.
Multiple variables: a multiple variable is a structure that is used to model a group of
functionally linked application variables (e.g. a logic state and its validant, a motor or a
valve). An MVM is defined hierarchically: it is composed of a root and of a set of fields that
may be single or multi-variable models.
The Application variables option in the contextual menu associated to a level of the functional
tree accesses a sub-menu used to open a variable grid.
Description of the options:
Item Description
Arrangement Current Opens a grid grouping the variables associated to the
Level selected function or diagram (available at all levels of owner).
Owner Current Level Opens a grid grouping the variables whose owner is the
selected function or diagram (available on all functions and
diagrams).
Assigned Variables Opens a grid grouping the variables used in the selected
diagram (available on all the diagrams).
FBD Local variables Opens a grid grouping the variables local to the selected FBD
(available on the FBD diagrams).
Assigned variables & FBD Opens a grid grouping local variables with variables used in
Local variables the selected FBD (available on the FBD diagrams).
Step Variables Opens a grid grouping the active step variables with the step
Item Description
duration variables of the selected SFC diagram (available on
SFC diagrams).
Owner Sub levels Opens a grid grouping the variables whose owner is a
descendent of the selected function or the function itself
(available on functions and on the project).
Several items in the hardware tree at controller or diagram level can be used to open a
variable grid. This grid presents the same characteristics but is not modifiable.
The variable grid presents the main characteristics of the variables in the form of an array.
Each of the columns can be resized and moved. Some fields in the grid are not modifiable and
appear in grey. A variable property window groups all the variable data together in a single
window (cf. 3.3,Variable Properties)
The window displays as shown below:
General display:
The main characteristics of all single variables and higher level multiple variable "headers" are
shown in boldface (Root MV, Kind, Model, Owner ID, variable name).
Multiple variables:
Multiple variables are presented in the form of a tree which is collapsed when the grid is
opened. Only the higher level headers of the multiple variables are visible. Click the
collapse/expand icon (column without header) to open or close the multiple variable.
The icon indicates that the multiple variable is expanded.
The icon indicates that the multiple variable is collapsed.
Multiple selection:
Several variables can be selected to undergo the same operation (e.g. delete).
For a non-consecutive multiple selection, the Ctrl key must be kept pressed and the desired
lines selected.
For a consecutive multiple selection, click the first variable in the list then depress the SHIFT
key and click the last.
Item Description
Refresh variable Updates the selected variable(s). Displays the data of the
variable(s) in the database and deletes the modifications of
any variables that have not been saved.
Delete Deletes the selected variable(s).
Assign to diagram Selects the variable to be placed in an FBD diagram. In the
diagram editor, the Assign menu option is used to assign a
variable to a component argument.
Cross References Displays the cross references of the selected variable.
From Functional Searches the functional tree and displays:
Architecture…
the diagrams and components consuming and/or producing
the variable,
the input/output boards and external exchange arrays to
which the variable is assigned (cf. 3.9.1,Cross References from
Functional Architecture).
From Current Searches the hardware tree and displays:
Workspace…
the diagrams and components consuming and/or producing
the variable,
the input/output boards and external exchange arrays to
which the variable is assigned (cf. 3.9.2,Cross References from
Current Workspace).
Exchanges… Used to obtain an overview of the utilization of the variable,
and its addresses in the controllers (cf. 3.10,Exchanges).
Manage MV
Link Used to attach a single or multiple variable to a multiple
variable (cf. 3.8.1,Attaching a Variable to a Multiple Variable).
Unlink This action is the opposite operation to attachment. It causes
the selected variable to be detached. Confirmation is
requested from the user.
AddMVMField Used to complete an incomplete multiple variable (cf.
3.8.2,Completing an MVM).
Hierarchy Displays the hierarchy of the multiple variable (cf.
3.8.3,Hierarchy).
Edit
– Find Opens the search window for variables in the grid (cf.
3.11,Finding and Replacing a Variable).
– Replace Opens the search and replace window for variables in the grid
(cf. 3.11,Finding and Replacing a Variable).
– Filter Opens the filter window for variables in the variable grid (cf.
3.12,Filtering a Grid of Variables).
– Collapse Grid Collapses all the multiple variables in the variable grid.
ALSPA Control System - Controcad V5.3 Document N° Language: Revision: Page:
Item Description
– Expand Grid Expands all the multiple variables in the variable grid.
– Export Grid Exports the grid in text format. Opens a Windows browser to
choose the export location.
The F11 key saves the grid in the file CcadLastPrint.txt
temporary directory P320/exe/ tmp/.
– Copy ID Copies the ID (Owner + variable name) of the variable in the
clipboard.
Array Initial Value Opens the configuration window of the initial values of the
selected variable array(s) (cf. 3.7,Initialising a table variable).
A variable is defined by its characteristic sets. A first set describes the general characteristics
of the variable. Other sets describe characteristics specific to the variable for the control room
HMI.
Each of these sets is represented in the variable properties window in the form of a tab.
Item Description
Go to next variable.
The General tab shows the general characteristics of the selected variable.
Example:
A tuning variable must have an initial value. Thus, the tuning parameters of the
multiple variable STI300 must be input before saving the grid.
Boolean section (section dedicated to Boolean variables)
Type Name Description Format
Msg State 1/0 Message associated to state 1. Closed list of 8
characters per
Message associated to state 0.
state message.
HMI Process. Defines the alarm processing of a Closed list
logic variable going up to the HMI
(degree, sense, horns and printouts).
Cmd Type Single or Double command (is input Single, Double
only if the variable is a Boolean
command sent by the control room
HMI).
Historian section
Type Name Description Format
Archiving Indicates if the value is sampled by YES , NO
the control room logging function.
Evt Log Indicates if the value is managed in YES , NO
the control room event log for Cmd,
SPt and cMSig variables.
It is configured by Controcad
according to the HMI Processing field for
boolean variables: Evt Log is YES if the
variable is configured as needing to
result in an alarm or recording in the
log (print option).
Validity Indicates whether the valid/invalid YES , NO
transitions of Bsig variables are
recorded as Historian events.
This characteristic applies to SVM,
MVM fields and variables.
ALSPA Control System - Controcad V5.3 Document N° Language: Revision: Page:
The reset value in the TRX when the variable is produced in the cell header (C80-75)
is the initialization value of the analog outputs (produced from C2K_AI_* models) or
of the MCA outputs (produced from C2K_*_AS112 models).
The Historian tab is used to configure a part of the ALSPA HMI variable logging parameters.
This tab is accessible only if one of the HMI DB of the variable has the Historian option and at
least one of the following properties: Boolean HMI Processing field has one of its last 3 digits
as 1; EVT LOG as YES; Archiving as Yes.
The Tmin, Tmax and Max Difference fields (for analog) are associated by default to
the Rate(s) field of the variable. This association is defined in the Configuration menu,
by the Historian Parameters item.
This tab is accessible for almost all the control room variables except for logic signals. It is
used to define the variables associated to the variable states or the variables used for
controls or authorization.
The description of this tab depends on the variable type.
The list of the variables that can be chosen in this tab is a subset of the variable grid
displayed.
The Associated Signals tab is used to describe the variable thresholds and the gradient of an
analog signal. The tab is accessible for variables whose models are ccASig_I, ccASig_I_nv,
ccASig_D, ccASig_D_nv, ccASig_R, ccASig_R_nv and *Ih_Asig (only gradient) in the Controcad
reference list.
Variable threshold:
Each time that the value of a variable violates a threshold (high or low), an alarm is tripped if a
degree of urgency is configured for this threshold. The value of the threshold is either fixed
(recorded in the variable characteristics), or variable. variable threshold can be defined either
by a Boolean signal (only for external signals ) or by the value of an analog variable.
Gradient:
Additionally, if the value of a variable varies very quickly, the variable defined by the Gradient
field is set to 1. The speed of variation beyond which the alarm is tripped is defined by the
Gradient field (value of the variation).
Memorization:
The ID provides a running total of the values of the variable (whose properties are displayed)
over time and to present the result in the control room HMI maintenance log. The field is used
to indicate the process ID of the analog variable that saves the total. Its model in the
Controcad reference list is Program_PhASig. During maintenance, the analog variable (whose
properties are displayed) is reset to zero, but the total continues in the Memorization variable.
The field is accessible for variables whose model is RunningTime_ihASig and PulseCount_ihASig in
the reference list.
It is forbidden to define analog and Boolean variable thresholds for the same
variable, even if the thresholds are different.
In the event of a variable threshold fault, the fixed threshold input in the properties
of the variable will be applied.
Description of the Associated Signals tab for analog signals and internal analog variables:
To have access to the “variable threshold” boxes, the physical thresholds values for
the variable must be defined and the Variable Threshold (4) option checked for all HMI
DBs of the variable.
To have access to the gradient box the Analog Signal gradient (6) option of all HMI DBs
of the variable must be checked.
This section describes the Associated Signal tab for internal setpoints (Internal_ihSPt) and external
setpoints (ccSPt_I and ccSPT_R).
This part describes the Associated Signals tab for the variables whose model, in the Controcad
reference list, is ccCmd_S, ccCmd_D and Internal_Ih_Cmd.
Note: A command is a Boolean pulse variable. It equals 0 when quiescent and 1 when activated, before
switching back to 0. To determine the conditions of transmission of the command, it is associated to
another variable which represents the execution of the command by a state change. This second
variable is a feedback signal known as control.
Authorization
Any command can be subordinated to a transmission authorization that takes the form of a
logic variable associated to the command: the command can then only be transmitted if the
value of the associated logic variable specified in the parameterization of the authorization.
Control
Variable used to check that the command has been received.
This tab is used to define calculations for the internal control room variables. The value of the
variable is the result of the calculation of this tab. The description of this tab depends on the
variable type and is thus done for each "family" of variables.
Internal logic variables
For this type of variable, the tab is used to describe the logic equation whose result gives the
variable. The tab is accessible for variables whose model is Internal_ihBSig in the Controcad
reference list.
External measure-
External measure-
Internal measure-
Internal measure-
Setpoint: internal
Variable: internal
Setpoint:external
ment threshold
ment threshold
Self reference
External logic
logic variable
Calculation
violation
violation
setpoint
setpoint
variable
ment
ment
Derived X X X X
(V01)
Polish X X X X X X X X X
Calculation
(V02)
Save (V03) X
Average X X X X X
(V04)
Current X X X X X
average
(V05)
Pulse X X X X
count (V06)
Running X X X X
time (V07)
Group X X X X X
average
(V08)
Root mean V08
square
(V09)
Internal multi-state variables: the tab is used to define which variables are used in the
calculation of the value of this type of variable.
The list of the variables that can be chosen in this tab is a subset of the variable grid
displayed.
The logical equation is expressed by means of the three fields (Operator, ID et Threshold). It is
defined in a maximum of 48 lines. The syntax is inverse Polish and must be of the style
Variable1 Variable2 Operator. It must end with the operator END.
This function is used to calculate the derived value of an analog variable in the control room.
To do this, define a variable from the model Derived_ihASig and associate this variable to an
analog variable. The derived value of the analog variable is saved in the variable Derived_ihASig.
This function is used to perform calculations in the control room. To do this, define a variable
produced from the model RevPolish_ihASig and an arithmetical expression based on the values
of control function variables or other calculated variables. The result of the arithmetical
expression is saved in the variable RevPolish_ihASig. The mathematical equation is expressed by
means of the five fields (Operator, Arg, Constant, ID and Threshold). It is defined in a maximum of 48
lines. The syntax is a reverse polish syntax.
+ Addition
- Subtraction
* Multiplication
DVZ Result if division by 0
/ Division
** Elevation to the power
ABS Absolute value
LOG Neperian logarithm
PY3 Degree 3 polynomial (a + bx + cx² +dx³)
SIN Sine
COS Cosine
TG Tangent
EXP Exponential
FY0 Echelon function
MINn Smallest value among n
MAXn Greatest value among n
SOMn Sum of n variables
Adatabase Direct interpolation of reference charts y=f(x,p)
Operator Description
This function is used to save the following data in the supervisory system:
The value: saves the value of an internal analog variable. The type of variable used is
Storage_ihASig.
Current average: shows the current average of an analog variable (internal and external).
This average is saved in a CurrentAvge_ihASig type variable.
Root mean square: shows the root mean square of the average of a variable group
(AvgeStdDev_ihAsig). This root mean square is saved in a StdDevStorage_ihASig type variable.
Description of the Compute tab for current averages, value backups and root mean squares:
This function is used to calculate the average of a variable in the control room. To do this,
define a variable produced from the model PeriodAvge_ihASig and associate it to the variable
whose average needs to be calculated. The update period for this average must also be
defined. The value of the average is saved in the variable PeriodAvge_ihASig.
Description of the Compute tab for the calculation of the average per period:
CAUTION
In General tab, for PeriodAvge_ihASig, Rate(s)is the Update period.
In Compute tab, for PeriodAvge_ihASig, Update Periodis the Sampling period.
This function is used to calculate in the control room the number of pulses of a Boolean
variable or the number of analog variable threshold violations. To do this, define a variable
produced from the PulseCount_ihASig model and define the associated variable whose
This function is used to determine in the supervisory system the time during which a logic
signal (internal or external) or an analog threshold violation signal (internal or external)
remains at 1. A variable produced from the RunningTime_ihASig model is defined and
associated to the variable for which the running time must be calculated and the threshold
(for analog) beyond which this time is counted.
Description of the Compute tab for running time calculation:
This function is used to calculate the average of the values of a set of up to 47 variables in the
control room. To do this, define a variable produced from the model AvgeStdDev_ihASig and
associate to it all the analog variables for which the average is to be calculated.
Description of the Compute tab for the calculation of average measurements:
This tab is used to define the variables used in the calculation of the value of the variable. The
calculation consists in applying the truth table of the multi-state variable, with the associated
variables or their thresholds (for analog variables)
Description of the Compute tab for internal multi-state variables:
The Messages tab contains the additional description of external multi-state variables. It is
accessible for variables that have the model, in the Controcad reference list, ccMsig (external
multi-state variables) or Internal_ihMsig (internal multi-state variables).
Internal multi-state variables
The tab is used to define the message associated to each value that the multi-state variable
can take. In operation, the value of the variable is produced in the controllers.
A variable is created either via the variable grid, or via the diagram editor. This paragraph
explains the first mechanism. (cf. 4.5.1, Argument Contextual Menu ) for the second.
There are two methods for creating a variable via the variable grid: from the New Application
Variable window and by duplication.
The window used to create a variable is accessed via the Create sub-option below the New
option in the contextual menu of the grid. Two presentations of the screen are proposed to
the user. The first figure presents a simplified version and the second figure presents an
advanced version of creation.
The total length of Owner plus Name fields must not exceed 20 characters.
The Guide button is used to open an extension to the creation window. This extension is a help
to the creation of variables (cf. 3.4.1.1,Variable Creation Guide)
After confirmation (without errors) of the input of these fields, the variable or variables are
created. The other characteristics of the variable or variables are input by Controcad in
accordance with the model.
In the case of creation of a multiple variable, the variables created are displayed in the grid
below the multiple variable. To access it, the user has close/open at his disposal (cf. 3.2.2,
Variable Grid Display).
If a control block model (Ctrl Model characteristic) has been associated in the
multiple variable model, a control block is created at the same time as the multiple
variable. Its name is that of the variable. Its Owner is the variable owner function if
the function is an Owner type. If this is not the case, the owner type function is
selected in the tree above the function. If no function of this type is found, the user
is informed and the control block is not created.
The variable creation guide is used to filter the list of the variable models for creation purpose.
The user chooses the criteria for creation of the variable and the guide selects the
corresponding models.
The Apply button confirms the choice and searches for models that meet the selected criteria.
The number of models found is displayed in the box to right of the button. All the models
found are located in the Model field of the main window.
The list of the different elements is filtered in accordance with the choices of the
user and the models available.
Duplicating a variable is a quick way of creating one or more variables with the same
characteristics as the variable to which the duplication is applied. There are two types of
duplication:
Single duplication:
To create a variable from an existing variable, the source variable must be selected and
the New Single Duplication item of the contextual menu of the variables grid must be
activated.
The new variable is created without a default name. The user must input the name of this
new variable in the variable grid (Variable name column). By default the cursor is located in
the corresponding box.
Multiple duplication:
To create several variables from an existing variable, the source variable must be selected
and the New > Duplication… item of the contextual menu of the variables grid must be
activated.
The window below opens:
The name and model of the source variable can be displayed in the window band.
The variable import and export functions are used to interface with external tools.
The import creates or updates the variables of a project, from external data stored in a file.
The export function retrieves the project variable data in a file.
These two functions act as data configuration assistants. They can be used to capitalize
configurations, to communicate with external tools and to constitute working documents etc.
The environment necessary to perform an import or an export of variables is that of a
Controcad session executed from a client or server station.
Global
The variable is imported or exported in its entirety, i.e. with its root and all its fields. In the case
of an import, the global mode can only be used to create new variables. It cannot be used to
update existing variables.
Unitary
A field of the variable is imported or exported. To designate the concerned field in the multiple
variable, the path (Path characteristic) of the field is referred to in the multiple variable
model. Take the example of a cBSig multiple variable model:
This model is composed of two fields. The first field modelizes the value of the supervision
signal and the second field modelizes its validant. If the user wishes to import only the value
of the variable, the Path characteristic is added to the import data with the value 1_Value.
In the case of an import, the model and name of the variable supplied in the import
data must be those of the multiple variable root and not those in the relevant fields.
It is possible to import more than one field of a multiple variable.
The following import file illustrates the different modes:
Files containing data to be imported or exported are files in text format. They are organized in
lines, with each line divided into fields separated by a tabulation.
Each line contains the data of a variable in the sense of the grid of variables of Controcad. A
line in the variable grid corresponds to a line in the file. Any field containing data to be
imported or exported data corresponds to a known characteristic of Controcad.
It is possible to define headers for the columns in order to label them.
The example below shows a simple variable and a multiple variable in an import or export file:
It is advisable to use the Excel tool to manage the import or export file. The data
can thus be displayed clearly in columns.
3.5.3 Models
Importing or exporting data requires the user to indicate the correspondence between the
external data and the data in Controcad. This correspondence is made by associating the
name of the data characteristic in Controcad with the column number in the import or export
file.
All the associations defined for a file are saved in a model called Column configuration model. This
mechanism prevents the user from having to redefine the associations on each import or
export.
The user can define several models that are identified by means of a name and a label. A
column configuration model is dedicated either to the import or the export. It is not possible,
for example, to use an import model to perform an export. On the other hand, the user can
import/export column configurations so as not to have to re-input them.
The user selects his models via the import HMI (cf. 3.5.5.5,Variable Import HMI) or export HMI
(cf. 3.5.6.1,Variable Export HMI). Clicking on the New configuration or ? buttons opens the window
shown below which is then used to create or modify a model.
The export of multiple variables in unit mode (cf. 3.5.1,Variable Processing) requires that the
user indicate for variable models concerned what are the fields to be exported.
The user defines his configuration models of fields via the export HMI by selecting “No” for the
option “Export Complete Multiple Variable” (cf. 3.5.6.1,Variable Export HMI).
Clicking on the New configuration or ? buttons opens a window used to create or modify an MVM
field configuration model.
The second section (MVM Name and Path) indicates which fields of the multiple variable
models must be exported for the variables produced from these models.
To define a new field configuration, the user proceeds as follows:
1. Click the Insert button to add a line.
2. Click in the left-hand section of the new line. The list of multiple variable models in the
project displays.
3. Select the model.
4. Click to the right of the new line. The list of fields in the selected model displays.
5. Select the field.
The Delete button deletes the field configuration selected.
It is possible to choose several fields for the same multiple variable model.
It is possible to reuse models defined by other users in other projects. windows used to define
the column configuration models and the field configuration models contain an Import button
and an Export button. These buttons are used to import and export models.
Exporting a model
The user can export a model in order to deliver it to another project. This export is done in a
text type file.
Clicking on the Export button opens a file selection window. The user chooses the location and
the name of the file. Clicking on the Save button in the selection window exports the model into
the file indicated.
Importing a model
The user can import a model from a model previously exported in a text type file.
Clicking on the Import button opens a file selection window. The user indicates the location and
the name of the file containing the model. Clicking on the Save button in the selection window
starts the import in the Controcad project. If a model of the same name already exists in the
project, a message informs the user. The user can choose whether or not to continue the
import. If Yes, the existing model in the project is replaced by the imported model.
The choices made by the user during an import or an export are saved. During the next
import or export requested by this same user, the HMI is input automatically with the choices
saved. The choices proposed can of course be modified by the user.
Memorization is maintained from session to session.
This is done by clicking on the Import option of the Variables menu of the main Controcad
window. The option is accessible from a variable grid, or from the functional or hardware
trees if the user has an adequate access level.
3.5.5.1 Principles
If the import concerns a variable already existing in the Controcad project, the variable is
modified with the import data.
If the import concerns a variable that does not exist in the Controcad project, the import
creates the variable with the import data. The characteristics of the variable that have not
been supplied in the import data inherit the values of the variable model. A characteristic is
not supplied either because it does not execute part of the import model or because it has no
value in the import data.
The user may need to delete the value of a characteristic of a variable existing in a Controcad
project. To perform this action via an import, set the character – (minus) in the associated
import data. The illustration below provides an example:
If the hyphen character (-) must be given as a value in a variable characteristic, set
two hyphens (--) in the associated import data.
Some characteristics in Controcad accept a closed list of values. For example the EVT LOG
characteristic can only take the value Yes or No; the UNITE characteristic can only take the
values defined in the Configuration menu of the project. For these characteristics, the import
checks that the value imported is valid (this check is not case-dependent).
With state messages, the first check run is case-dependent. If the search fails, it is
repeated irrespective of the case.
Clicking on the Import option in the Variables menu opens the main HMI window.
This window enables the user to parameterize and run the import.
It is organized into four sections.
A second section, Column Configuration, concerns the import models. The Column Model field is
used to select a column configuration model from those defined in the Controcad project.
The New Configuration button is used to define a new model. The ? button is used to modify
the model selected in the Column Model field. Clicking on these buttons opens the import
models window (cf. 3.5.3.1,Column Configuration Model)
The third section Parameters enables the user to choose the behavior of the import by
selecting the following parameters:
Continue on error
If this parameter is set to Yes, the import processes all the variables in the file. If not the
import stops as soon as it detects an error on a variable.
If the user has requested an import with confirmation of backup, the import log displays in a
new window. According to this detailed report, the user selects whether to save or not the
data imported without error in the Controcad project.
If the user has requested an import with interruption in the event of error and if an error is
detected, the report is also displayed.
The import log contains a detailed report of the import and a synthesis.
The report indicates the following elements for each variable described in the import file:
Variable Name: the name of the variable
Owner: the owner of the variable
Model: the label of the variable
Kind: the variable kind is either single (SVM) or multiple (MVM)
Action: the type of action performed on the variable is either a creation or a modification
Status: the success or not of the import, i.e.
OK: the variable is imported without error
INFORMATION: the variable is imported without error but there is a warning
ERROR: an error has been detected
Message: message explaining the error or the information
Line Number: number of the line in the import file corresponding to the variable in error
Column Name: name of the column in the import file concerned by the error detected
Column Number: number of the column in the import file concerned by the error detected
The second section of the log shows synthesized data on the import:
NUMBER OF VARIABLE IMPORTED: number of variables really imported, i.e. without error
NUMBER OF VARIABLE ON ERROR: number of variables in error
MODEL USED: name of the model used
DATE: date and time of the export
USER: Name of the user.
The table below shows the characteristics of importable variables. It also groups mandatory
characteristics by color depending on the type of import performed.
Name in the HMI import Label Mandatory
Annotation Comment No
Archiving Sampling in Historian No
Boolean HMI Processing Profile of alarm processing No
objects
Cell Name of the cell No
Cmd Type Type of the command No
Constant Marker No
Controller (External Exch. Name of the controller If import of variable with
Array) hosting the external external exchange
exchange
Controller (input/output) Name of the controller If import of I/O variable
executing the input output
Control Block Link Name of the link in the No
block
Display Filter Sampling No
Evt log Printout in Historian No
Exchange HMI Type of HMI exchange No
External Exch. Array ID of the variable array If import of variable with
Name executing the external external exchange
exchange
External Exchange Direction of the external If import of variable with
exchange external exchange
Filtering Filter coefficient No
H Limit Urgency Degree of urgency of the No
alarm linked to the
violation of the high
physical limit
High Limit High physical limit No
High Threshold Electrical value of the high No
threshold
High Urgency Degree of urgency of the No
alarm linked to the
violation of the high
physical limit
HMI DB Associated Number of the HMI DB No
The export is done, in a manner similar to the import, by clicking on the Export option from the
Variables menu of the main Controcad window. The option is accessible from a variable grid, or
from the functional or hardware trees. Clicking on the option opens the export window.
A simplified export is also available from a variable grid. This is accessible via the Export Grid
option in the contextual menu of the grid (cf. 3.5.6.2,Export ).
The first section, Export File, is used to indicate the location of the file containing the data to
be imported. The Browse button provides access to a window for selection of files from the
directories of the Controcad station.
A second section Column Configuration concerns the column configuration models. The Column
Model field is used to select a model from those defined in the Controcad project. The New
Configuration button is used to define a new model. The ? button is used to modify the model
selected in the Column Model field. Clicking on these buttons opens the window of export
models. (cf. 3.5.3.1,Column Configuration Model).
The third section Path Configuration for Multiple Variable is used to indicate the export mode of
multiple variables (cf. 3.5.1,Variable Processing). If the response is Yes to the question Export
Complete for Multiple Variable ?, the mode is global. Otherwise it is individual and in this case
the user must select or define the configuration model of MVM fields (cf. 3.5.3.2,MVM Field
Configuration Model ).
The fourth section Data Source, is used to indicate which variables are to be exported. Four
choices are possible:
Type Name Description
Current Variable Grid Exports the variables in the grid displayed.
Filter of Variable Grid Exports the project variables filtered by the selected
filter. The filters proposed are the DB Filters in the
variable grid. The New filter button is used to create a
filter.
Function Exports variables belonging to the selected function
and to its sub functions.
3.5.6.2 Export
The simplified export exports the selected variables of the current grid with all Controcad
characteristics of the grid in alphabetical order. All the multiple variables fields are exported
individually.
Click the Export Grid option in the contextual menu of the grid to open a file selection window.
The user indicates the location and the name of the export file. Click the Save button to run the
export.
Annotation Comment
Archiving Sampling in Historian
Basic Type Type
Boolean HMI Processing Profile of alarm processing objects
Cell Name of the cell
Cmd Type Type of the command
Constant Marker
Controller (External Exch. Array) Name of the controller hosting the external
exchange
Controller (input/output) Name of the controller executing the input output
Control Block Link Name of the link in the block
Display Filter Sampling
Evt log Printout in Historian
Exchange HMI Type of HMI exchange
External Exch. Array Name ID of the variable array executing the external
exchange
External Exchange Direction of the external exchange
Filtering Filter coefficient
H Limit Urgency Degree of urgency of the alarm linked to the
violation of the high physical limit
High Limit High physical limit
High Threshold Electrical value of the high threshold
High Urgency Degree of urgency of the alarm linked to the
violation of the high physical limit
HMID DB Associated Number of the HMI DB
Horn No Number of the alarm horn
Initial value Initial value
Input Output Direction of the I/O exchange
The Array Initial Value option of the variable grid contextual menu opens the window used to
define the initial values of an array variable. This mechanism is used to set the initial value or
the tuning value of each element in an array, depending on whether the array can be tuned
or not.
This window includes a Master window showing the list of all the arrays in the current variable
grid and a Detail window used to define the initial values of the components of the array
selected.
During an Add all, the fields previously created are neither deleted nor overwritten.
This is allows not null initial values to be input; Add all can then be run for the others.
If the array has an initial value in the grid, this value is used to initialize the cells of
the array when no initial value is specified.
This chapter presents the different actions available for the management of multiple
variables.
Variables attached manually to the MV are shown by a trombone placed before the
attached variable (the trombone appears in the Hierarchy screen (cf.
3.8.3,Hierarchy).
Select the Add MVM Field option in the Manage MV sub-menu in the contextual menu of the
variable grid to open a window used to complete an MVM from its initial definition. This
function enables an MVM with deleted variables (deleted variables are shown in boldface in
the window) to be rebuilt from the MVM created initially by adding the deleted variable.
Double click the missing variable shown in boldface in the window.
3.8.3 Hierarchy
Selection of the Hierarchy option from the Manage MV submenu of the contextual menu of the
variables grid opens a window which displays the hierarchy of the variable from the root, in
tree form, with the variable selected shown in inverse video. If the variable is simple and is not
attached to an MV, the user is warned by a message.
The window shown below displays the hierarchy of a multiple variable:
A trombone placed before a variable shows that the variable was attached to the
MV manually.
This chapter presents the options of the Cross References sub-menu accessed from the
contextual menu of the variable grid. These options are used to identify the consumption and
production of a variable in the functional and hardware trees.
Cross References from Functional Architecture tells the user about the current state of the use of a
variable, with the possibility of modification.
Cross References from Current Workspace tells the user about the generated state of the use of a
variable with the possibility of observing the variable in animation.
Selecting the Cross References From Functional Architecture option opens a window that displays in
the form of a tree in I/O boards and in external exchange tables, the uses of the variable in
diagrams of the function tree (there will be as many lines as uses of the variable on different
components). Double click a use to open the corresponding graphic diagram from the
functional tree. This diagram can then be modified as necessary.
If a variable has just been placed on a component, it will not appear in the diagram
reference screen if the diagram has not previously been saved.
The window shown below shows the cross references on the functional tree:
The user can save the cross reference of variable into different formats and specify the path
to store the file.
Selecting the Cross References From Current Workspace option opens a window that displays the
uses of the variable in input/output boards and/or in external exchange tables of diagrams
generated (diagrams of the hardware tree) of the current workspace.
The result is presented in the form of a tree (there will be as many lines as there are uses of
the variable). There is one node for each diagram and for each controller using the variable.
Double click the diagram to open it in the hardware tree with the possibility of running an
animation on the target.
The window shown below shows cross references in the current workspace:
3.10 Exchanges
Used to obtain an overview of the uses of the variable selected in the current user workspace.
Click the Exchange option in the contextual menu of the variable grid to open a window
showing variables exchanged through the controllers that produce or consume them in the
workspace.
The variable has a primary address and may also have one or more secondary addresses for
each controller. The primary address is the address from which the variable receives its value.
In the producing controller, the primary address may be the address in the reception table
originating from the control room HMI (for a control room HMI input) or the input memory
address (for a process input) or any other memory address (for a variable calculated by a
diagram). In a consuming controller, the primary address is always situated in the inter-
controller exchange table that has transferred the variable from the producing controller. Any
secondary addresses correspond to a utilization of the variable, which is different from that
corresponding to the primary address.
To illustrate this principle, imagine a variable that is a process input (in the cell controller) sent
to the control room HMI, to a Modbus device linked to the cell controller. This variable is
redundant and consumed in:
Another field controller in the same cell,
Another cell.
The primary address of the variable is that which corresponds to the assignment on the input
board (process input). The secondary addresses are as follows:
Supervision address in the array transmitted to the supervisory system,
Redundancy address in the redundancy array,
Field controller transmission address in the inter-controller exchange table,
Note: A supervision input (e.g. a OpenLoop_ccCmd_S command or a ccSpt_R setpoint) appears in the
exchanges as being produced in the unit controller of the cell managing the variable.
This chapter presents the search and replace windows for variables in the grid. These
windows are identical except for one field. The Find and Replace screen is a tool that enables
Controcad users to:
Search for all the occurrences of a value
Replace the value by another value
Replace all the occurrences of the value by another value
Clicking on the Find option from the contextual menu of the variable grid opens the Find
window.
The user is asked if all the multiple variables should be expanded before running the search. If
the variables remain collapsed the search will only execute on the visible variables.
Clicking on the Replace option of the contextual menu of the variable grid opens the Find and
Replace window.
The user is asked if all the multiple variables should be expanded before running the search. If
the variables remain closed the replacement is done only on visible variables.
Replacement window:
This chapter presents the variable grid filter window. This window enables several criteria to
be combined over several columns of the grid. It is accessible via the Filter option in the Edit
sub-menu accessed from the contextual menu of the variable grid.
This screen is a tool that enables Controcad users to:
Create filters.
Modify filters.
Save filters in the database.
Apply a filter on a screen.
Remove a filter previously applied.
The application of a filter in a grid prompts a change of color in the column headers
to notify the application of a filter. These column headers are shown in green.
The screen is composed of the tab Grid Filter which is used to apply a filter to a list of variables
displayed in the variable grid:
To remove a filter from a variable list, clear the input zone by clicking on the Clear
button then click the Apply button.
This chapter presents the tools used to print out the variable grid.
The printout can be configured via the Print option in the File menu. It is also possible to print
out the grid via the F12 key when this key is active.
The window below is used to configure the printout of the variable grid:
The Print Dialog screen is used to print the content of a grid. The user can select the columns
that he needs to print. The screen is divided in two parts:
The 1st part (to the left) called the selection zone, displays a list of the names of the
columns in the grid to be printed. The column names displayed are those of the columns
headers. Selection/Deselection of a name displays or masks the corresponding column in
the right hand section of the screen.
The 2nd part (to the right) called the printout zone, displays the variables in the columns
selected for printout. The user can redimension the width of the columns or change the
order of the columns. The name, the width and the order of the columns are saved in the
database.
The user can attribute a title to his printout via the Title field.
Description of the buttons:
Button Description
Preview Used to display a printout preview of the variables to be printed. It
prompts click the "Rulers" and "Orientation" buttons and of the
scale input zone.
Rulers Used to display in the printout preview the graduated horizontal
and vertical rules.
Orientation Used to select the orientation of the printout (portrait or landscape).
Print Prints the data in the columns selected.
Clear Used to open the printout screen. The result is:
All the names of columns are deselected in the selection zone.
All the columns are masked in the printout zone.
All Used to select all the columns in the variable grid.
OK Closes the printout screen and saves the names and order of the
selected columns in the database. When the printout screen is next
opened, the display shows the selected columns in the order saved.
4.1 Introduction
The FBD editor is a graphic control function diagram editor. When a diagram is edited, the
FBD editor is used to constitute a network of elementary operators (AND, ADD, GT Greater
than...) and Functional components (RS switchover RS, TON Timeout ON, TP timeout pulse
etc.) by retrieving these components from the Libraries tree, and connecting their arguments
by links and/or by associating these arguments to variables selected in the grid or to
constants. Diagrams created in this way are saved in the server database.
System Functional Block Library
This section describes the menus and icons of the FBD editor.
This menu presents display options: the options checked are active.
Item Description
FBD: Create Visible Displays internal variables during their creation. Is only active
Automatic Internal if the previous option is chosen.
Variables
Variables Browser Starts the variables browser (cf. 4.6,Browser ).
Components Browser Starts the components browser (cf. 4.3.7,Components
browser).
This menu presents format options. The options checked are active.
Note: The selected entities correspond to the diagram elements that can be aligned:
components
tickets
notes
It is not possible to select tickets and FBs and ask for their alignment.
Lefts Align the left sides of selected entities (with respect to the first
selected entity).
Rights Align the right sides of selected entities (with respect to the
first selected entity).
Tops Align the tops of selected entities (with respect to the first
selected entity).
Bottoms Align the bottoms of selected entities (with respect to the first
selected entity).
Make Equal
Horizontal Spacing Horizontal spacing is made equal (the position of items at the
extremity of the selection are taken as base for the
computation of the spacing)
Vertical Spacing Vertical Spacing is made equal (the position of items at the
extremity of the selection are taken as base for the
computation of the spacing)
Item Description
Display
This menu is used for diagram animations or simulations. See [CCAD_TOOLS] (in § 1.7 List of
Referenced Documents).
This menu is used to parameterize observations. See [CCAD_TOOLS] (in § 1.7 List of
Referenced Documents).
This menu is used for graphic animations. See [CCAD_TOOLS] (in § 1.7 List of Referenced
Documents).
There is only one option in the menu, About Diagram Editor, which opens a window providing the
version of the diagrams editor.
Icon Description
Select the diagram to be opened in the Function tree by a double click, or click the Open
diagram option in the Edit menu, or open the contextual menu associated to the diagram in the
tree.
A double click on a diagram that is already opened prompts the editor to display it
in the foreground.
The Save option in the File menu in the main window of the diagram editor or the disk icon
saves the diagram whose window is active in the project database. The active window is
shown by a blue frame.
Clicking on the Save all option in the File menu in the main Controcad window, saves all the
diagrams opened during the same session in a single action. This action also saves the
variable grid.
When a diagram opened in the editor has been modified since it was last saved, an
asterisk * is displayed in the title of the window after the name of the diagram.
To close a diagram use the standard Windows button (cross at top right of the current
diagram window) or the Close Diagram option in the main editor File menu. If the diagram has
been modified, Controcad proposes to save the new version of the diagram. The user can
then choose whether or not to save the diagram before closing it.
The contextual menu shown below is accessible from the diagram, with no elements selected.
Item Description
Insert New Diagram Ticket Inserts a ticket allowing the navigation between
diagrams. The ticket can be linked to other diagrams
thanks to the Add Diagram Link option in its contextual
menu.
Show Test Results Displays the test markings (cf. 4.9.1,Switching to T Mode)
Reset Test Signature Removes all test markings. This option is active only when
the test markings are displayed (cf. 4.9.1,Switching to T
Mode)
FBD: Show FB Comments Displays all non-hidden comments of diagram
components (cf. 4.4.4,Component Comment )
HLD: Show/Hide Sequence Displays/hides the number of each HLD in the editor.
Number
4.3.5.2 Strategy
Selected elements can be copied either by using the standard keyboard shortcut CTRL C, or by
clicking on the Copy option in the Edit menu of the editor or in the contextual menu of the
selection.
Selected elements are pasted either by using the keyboard shortcut CTRL V, or by clicking on
the Paste option in the Edit menu of the editor or in the contextual menu of the selection. The
selection is pasted into another diagram open in the same session.
Equally, select the elements to be copied, press the <CTRL> key while keeping the right-hand
mouse button pressed, and move the cursor to the required position before releasing the
button.
By default, the component is duplicated without copying the variables assigned to component
arguments. The Paste Strategy option in the contextual menu of the destination diagram of the
copy gives access to the sub-menu:
Components are positioned by means of the library tree or the components browser (cf.
4.3.7,Components browser).
To position a component in a diagram, select the component in the Libraries tree using the
Select component option in the contextual menu of the component or in the Controcad Libraries
menu. Then left-click the mouse button at the position in the diagram where the component is
to be placed. The components can also be placed via the Toolbar or by drag & drop using the
component browser (cf. 4.3.7,Components browser).
A symbol is displayed to indicate that the component cannot be positioned (on another
component, overlapping on more than one sheet, not enough space etc.).
Remember that the Libraries tree can be detached via the Draw out Treeview option in the menu
window of the main Controcad window or via the Draw Out option in the contextual menu of
the root of the tree. This mechanism enables the user to display the Libraries tree (to select
the models) and the Function tree (to access diagrams and variables) simultaneously.
Note: In overlap enable mode it is possible to overlap two components, When the mode is overlap disable it
is impossible to place one component on top of another.
Symbols Meaning
This section describes the functions proposed by the component browser. The component
browser facilitates the insertion of components in the diagrams.
The functions proposed by the browser are as follows:
search for components in a project,
insertion of a component in an FBD diagram by drag/drop,
displaying the internal variables of a component. If the component is of FBD type, it is
possible of assign its variables (by drag/drop) in the component diagram if the diagram is
issued.
4.3.7.2 Function
It is possible to display the internal variables of the selected component by double clicking on
the component from the component browser. Variables can be assigned (by drag/drop) to
their diagram components (FBD type) if they are in issued state. To return to the screen
showing the libraries tree, click the Back button.
To create a link, select the argument of the component to be connected by left clicking the
mouse button. The argument selected is displayed in inverse video. The link is then drawn by
means of the mouse (left button depressed). It is displayed as a broken grey line until the
outlet is connected, then as a broken white line when the link is connected. The link becomes
a solid line when the mouse button is released.
The width of the line depends on the type of variable: the line is thin for binary/boolean
variables and thick for numerical/analog variables.
If the link is impossible, the link is shown in red and a forbidden panel appears on the
destination argument. In this case it is not possible to establish the link. This is explained by
the fact that the argument type at the start of the link is incompatible with the destination
argument type on which the mouse is placed.
During the creation of the link, the path is generated automatically (a link is exclusively
constituted of horizontal and/or vertical straight lines) with any break points that are
necessary. The link is directed so as not to pass over inlet and outlet components, but ignores
intermediate components.
Once the link has been established, the user can modify its route by selecting and dragging
the link summits that need to be moved
To authorize or prohibit the connection, the FBD performs the following checks:
Verification of the compatibility of the argument types: the intersection of the lists of the
types of each of the arguments must not be empty. For example if one argument accepts
integers only, while the other accepts integers or words, the intersection of the two lists is
not empty and the check passes.
When the argument type is modulate (only for operators), the list of its possible types is
shortened, before the calculation of the intersection, in order to take account of links
already established with the other arguments of the component. For example, if an
argument accepts Integer, Boolean and Word types, and a variable of a given type, Integer
for example, is assigned to one of the arguments of the component, all the other
arguments will henceforth only accept variables of the same type (integer). In such cases,
for the argument to be connected to another argument, the latter must also accept
integers.
Verification that the size of the two arguments is identical. For example, an argument
which expects arrays of 10 integers can only be connected to an argument which expects
arrays of the same size.
Verification that the direction of the two arguments is compatible: normally this check
does not pass when the user seeks to connect a component output argument to an input
argument of another component whose value has been forced with a constant (an output
cannot be constant).
Note: In automatic internal variable creation mode, an automatic variable is created and assigned to both
components. (cf. 4.5.7,Variables )
To insert the cross, select the link, open its contextual menu by right-clicking the mouse
button and choose the Insert H/V C option. The cross is positioned at the location selected on
the link. The required link between a free branch of the cross and a component argument can
then be established.
Note: Positioning crosses in a diagram is also an indirect method of controlling the routing of the links.
A variable input ticket is a zone used to display the characteristics of a variable during its
utilization in the diagram (name, label, state or unit message, minimum/maximum ranges,
degree of alarm etc.). The ticket is displayed in the editor and is presented in the
documentation.
On the ground of the diagram screen, right-click the mouse to open a contextual menu. Select
the Insert new ticket option to place an empty variable input ticket in the diagram. By default,
the link is to the right. Right-click the ticket to open a contextual menu, and select the Toggle
Input / Output option to change the link direction.
This ticket is input by linking the ticket to the argument of a component associated to a
variable. The characteristics of the variable are shown in the ticket.
It is possible to customize the tickets display (cf. 4.3.12,Customizing the Diagrams Display).
Table showing the meaning of the symbols associated to the tickets:
Symbol Meaning
Internal variable.
Symbol Meaning
Note:
In addition to these symbols, if the variable is coming from any FBD, SFC diagram, etc, then
the following icons are shown on the right bottom corner of the ticket:
Symbol Meaning
They are categorized according to their size and the information they show on the variable:
Type Content Description
Large Cross reference
Information on
variable
variable.
Special Cross reference
The following contextual menu is associated to the ticket in the FBD editor.
Note: The selected entities correspond to the diagram elements that can be aligned:
components
tickets
notes
It is not possible to select tickets and FBs and ask for their alignment.
Note: The first selected construct, which is circled with a cyan border, is the base for alignment.
To customize the diagrams display, select Format > Set Font/Color and Display options menu option
in the FBD editor.
The Font/Color Selection and Display Options window opens.
Button Description
Ticket
Set Font for Is used to modify font, font style and font size of Text FB.
Text FB
Set Default Cancels the customization parameters and applies the default display
Color and Font parameters.
As the size of the ticket and the position of the lines inside the ticket are fixed, there
are only a few possibilities for the user to modify the text size in tickets.
Grid On/Off part
Type Name Description
Grid On Displays Grid.
Grid Off Hides Grid.
Select Magnetic Grid part
Type Name Description
Main Grid Aligns the components to the main grid that is to say to
the biggest squares.
The big squares are only visible when the grid is on.
Minor Grid Aligns the components to the minor grid that is to say the
little squares.
The little squares are only visible when the grid is on and
zoomed in.
Overlap Enable/Disable part
Type Name Description
Overlap Enable Enables overlapping of two components in the editor.
Overlap Disable Disables overlapping of two components in the editor.
The Save button is used to save the modifications.
The Cancel button is used to abort modifications and close the window.
Markers Description
When the application starts, the diagram editor loads all the component definitions into
memory. This offers the user a higher degree of tool reactivity during the positioning of
components.
It is possible to integrate modifications to the component definitions manually via the
diagram editor. All open diagrams must be saved and closed then select the File > Update
components definitions option from the editor’s main menu. The editor reloads everything that
has been modified since startup.
To delete then reload all the component definitions, save and close all the open diagrams
then select the File > Load all components definitions option in the main menu. The editor reloads all
the component definitions without distinguishing between those which have changed and
those which have not changed.
The first update method is generally sufficient and has the advantage of being faster than the
second. This method is normally used first.
The FBD editor keeps the variable information that it needs in memory. It loads this
information as required by the connections produced by the user in the diagrams. In order to
have the editor incorporate modifications or deletions concerning variables already used, an
update must be executed after saving the variable grid by selecting the File > Refresh variables
and SFC local data option in the main menu. During this action the editor updates its variable
information and the content of the tickets, and flags any connection problems by displaying
"DELETED !" in place of the names of variables which have been deleted in FBD and by
indicating incomplete SFCs by invalidating incorrect transitions or actions.
In the diagrams, it is required to display at the produced variables level, which one of these
variables are consumed by other diagrams. At the consumed variables level, it is necessary to
display where they are produced.
Cross references are located outside the vignettes of each variable (on the left for references
to variable producers and on the right for references to variable consumers).
These cross references are added before generating the intermediary file (emf files) used
when creating the diagram document. The diagram content is reduced to position the
references on their left and right.
A specific mode of the FBD editor allows the user to preview the productions of these
diagrams (”Print View” and ”Preview Mode”).
Due to size constraints, only the first n consumed variables are displayed in the
cross references.
The value of the n parameter is defined for each project. By default, it is set on 5.
If this value is equal to 0, no cross reference is generated and all the diagrams keep
their initial size.
If consumed variables cannot all be displayed, the cross reference list ends with 3
dots.
To print a diagram as it is shown in the editor, select the File > Print option in the main menu. A
dialog box is used to select the pages to be printed out.
By default, a diagram is printed with the validation display (test information), if any.
To print a diagram without the validation display:
Go in the Configuration menu of Controcad main window and click Project
Go in the Documentation tab
Clear the Show Validation Display checkbox and click OK.
The printer is configured automatically in landscape mode for FBD and in portrait mode for
SFC.
Blank pages in a diagram are not printed.
In printout mode links that are traced over several pages are cut and replaced by bookmarks
as shown below:
This chapter outlines the different actions that can be performed on a component present in
an FBD.
Item Description
Component Instance Used to name a component by means of a variable (cf.
Name 4.4.5,Naming a Component)
Remove Instance Name Deletes the name of the component.
Open Diagram Used to open the diagram associated to an FB diagram (cf.
4.3.6.2,Different Component Types )
Simulation Watch Opens a simulation Watch Window on the component selected.
Window See [CCAD_HARD] (in § 1.7 List of Referenced Documents).
Edit Comment Used to create or modify the comment associated to the
selected component (cf. 4.4.4,Component Comment ).
Shown Comment Used to display or hide the comment of a component. When
the option is checked, the comment is visible in comment
display mode (cf. 4.4.4,Component Comment ).
Tested Used to mark the selected component as tested. When the
option is checked the component is marked as tested. This
option is only active in test mode. (cf. 4.9.1,Switching to T Mode)
This action consists in assigning the variables which compose the multiple variable to the
arguments of a functional component. The assignment is done by following the rules
indicated during the definition of the functional component model (Arguments Group tab). As
with the assignment of a simple variable to an argument, two situations may occur:
The multiple variable already exists in the project:
To perform the association select the multiple variable in the grid via the Assign to diagram
option and assign it to the component using the relevant option in the contextual menu of the
component. This option is managed dynamically and takes one of the following values
according to the context of the association:
When no variable compatible with the argument groups designed for the diagram type is
selected, the option is inhibited and equals Assign variables group.
When the current variable is compatible with a single diagram type argument group, the
option takes the value Assign MV to <group name> (<MVM>) (group name being the name
of the argument group and MVM being the name of the MVM used for the group).
When the current variable is compatible with several argument groups of the component,
the Assign variables group option is valid. When this option is selected, it opens a sub-menu
which is used to choose the argument group to be assigned.
The multiple variable does not yet exist:
Select the Create variable group option to open the New variable window The fields for the
creation are input by default with the first association of the multiple variable model given in
the definition of the functional component model The user selects to validate the creation of
the variable as proposed or modifies certain fields as the choice of another MVM then
validates. The multiple variable is then created and its different single variables are assigned
to the arguments.
It is displayed with an input zone for the comment, a validation button (OK) and a
cancellation button (Cancel).
The Ctrl+Enter combination is used to add a line in the input zone.
The comment displays as follows:
The comment can be moved like any other element in the diagram.
Comment display mode:
The comment display mode is used to display all the comments of the diagram. This mode
can be activated/deactivated in three ways:
- Contextual menu of the diagram, if the Show FB comments option is checked, the
comments display mode is active (cf. 4.3.4,Diagram Contextual Menu)
- Icon of the toolbar (cf. 4.2.10,Icon Bar). the comment display mode is active.
- FBD: Show/Hide FB comments of the View menu in the diagram editor. If the option is
checked the comments display mode is active (cf. 4.2.3,View Menu).
The use of one of the three possibilities above affects the state of the other two.
The yellow triangle at the top right of the component indicates the presence of a
comment that may or may not be hidden. This marker is only present in comment
display mode.
Display/Hide an individual comment:
It is possible to define a hidden or displayed state individually for each component
comment. If the comment is displayed individually, it will only be displayed if the comment
display mode is active. If the comment is hidden individually it will remain so even in
comment display mode.
If the Show Comment option in the contextual menu of a component is checked, the
comment is displayed individually. To display it, click the comment display mode.
Printing comments:
To print the comments, go to comments display mode then execute normal printing (cf.
4.3.17,Printing a Diagram).
To rename a component:
1. Select a variable compatible with the model indicated during the definition of the
functional component model.
2. Click the Assign to diagram option in the contextual menu associated to the selected
variable.
3. In the diagram click the Component Instance Name option in the contextual menu
associated to the component to be named.
To cancel the component name, select the Remove instance name option in the contextual menu
associated to the named component.
This chapter outlines the actions that can be performed on component arguments.
Certain options may or may not be accessible depending on whether or not the argument is
associated to a variable.
Item Description
The Assign variable, Create variable and Paste assignment options are used to assign a variable to an
argument.
Three cases may occur:
The variable already exists in the project.
To assign a variable to a component argument:
- Select the variable in the variable grid.
- Click the Assign to Diagram option of the Variables menu of Controcad or the contextual
menu of the variable in the grid.
or
Click the icon located in the main toolbar of Controcad.
or
Use the keyboard shortcut <Ctrl A>.
- Select the argument to which the variable must be assigned.
- Click the Assign Variable option of the contextual menu associated to the argument.
or
- Double click directly on the argument.
To assign a constant to a component input argument, select the Assign constant option in the
contextual menu of the argument. This opens a dialogue box used to input the constant. The
value of the constant input must be compatible with the types supported by the argument.
The following input formats are supported:
Input format Examples
To complement a Boolean argument select the Toggle logical not option in its contextual menu.
To cancel the complementation repeat the operation a second time.
An operator can be configured to be extensible. In this case its last input argument can be
duplicated one or more times. The duplicated arguments inherit the same characteristics as
the argument that has been copied.
To duplicate the last component input argument once, use the Duplicate option in the
contextual menu of the argument.
To duplicate the argument more than once in a single action select the Duplicate option in the
contextual menu of the argument while depressing the key indicating the number of
duplications to be performed (the digits on the numerical keyboard are not operative for this
manipulation and only single digits can be defined, we can thus add only 9 arguments at a
time).
The arguments duplicated may be deleted by the Delete option in their contextual menus. Only
the last argument duplicated can be duplicated again. The Duplicate option in their contextual
menus of the other arguments is inhibited.
4.5.7 Variables
"Automatic internal variable" mode is a diagram edit mode. This mode is activated by the icon
of the toolbar (cf. 4.2.10,Icon Bar) or by the FBD option: Automatic Internal Variables Creation option in
the View menu of the diagram editor.
This function is used automatically to create variables while the link between two
components is being traced.
Internal automatic variables can be created only if the link is made between two
arguments of which at least one is a mandatory argument (cf. 4.3.6,Positioning
Components).
The name of these variables is not modifiable and is built as follows:
<Short_Name_function+Short_Name_diagram>_<Variable_type><Number_bits>_<number
from 0001 to 9999>
Example: A1_INT16_0001
If several variable types are possible for the linked arguments the following window opens:
By default, automatic variables are not displayed in the diagram. To display automatic
variables during creation click the FBD option: Create Visible Automatic Internal Variables of
the View menu.
Equally, automatic variables are not displayed by default in the grid. The grid can be opened
to visualize them (cf. 3.2.1,Variable Grid Characteristics).
4.6 Browser
This section describes the functions provided by the Variables browser. this browser is used to
facilitate the assignment of variables in an FBD diagram.
The functions proposed by the browser are as follows:
Search for functions in a project,
Search for variables in a project,
- Overall project search,
- Local function search,
- Search in cascade from a function.
Assignment of single variable (SVM) in an FBD diagram.
4.6.2 Function
The Variable Browser is used to find a function and/or a variable manually or dynamically in
to order to assign one or more variables to the components of an FBD diagram. In the same
way as the functional tree, the upper section of the browser shows the project functions and
diagrams. The lower section indicates in array form a list of the variables belonging to the
selected function or diagram.
The upper section of the variable browser is used to find a function or a diagram manually or
dynamically from the functional tree in order to display the variables associated to it in the
browser grid.
Search: the user searches for the required function or the diagram in the tree. The tree is
expanded by clicking on the target function.
Search: it is possible to run a dynamic search for a function. The user inputs the "Short
Name" of the function being sought in the upper search zone provided. The search is
executed as soon as the first character is input and is refined as the name is completed.
Note that * can be used as a universal wildcard character.
The lower section of the variable browser is used to display and find the project variables.
The procedure for finding a variable is as follows:
1. Select the function (or root) to which the variable is associated.
2. Input the name or a section of the name of the variable in the lower search zone (* can
be used as a universal wildcard character).
3. Choose the type of variable model sought (SVM or MVM).
4. Select "Local" if the search is to be run on only the selected function or "Cascade" if the
search is to be run on the selected function and on its daughter functions.
5. Click the Search for Var button.
Note: It is also possible to find a variable manually, without using the browser search tool.
Once the variable is found, it is possible to assign the components of a diagram by drag/drop.
Once selected, the scope is memorized and the assignment proceeds in the same way as that
of a single variable. Click once again on the variable in the variable browser grid then depress
the left button while moving the mouse cursor to the required location.
Note that the selected scope of the variable (complete array or element n) will remain the
same during future assignments until it is changed.
Each component possesses a number that is used to define the order of execution of the lines
of code produced by this component, relative to the lines of code produced by the other
components of the diagram.
The order of execution of the components is determined for a complete diagram, without
taking into consideration the sheets composing this diagram. The programming order of the
diagrams among themselves depends on the order in which they are called in the POU to
which they belong.
The order of execution is unique to each diagram and is executed according to a number 1
thru n assigned to each component.
The contextual menu accessible in the ground of the diagram contains the Evaluation Strategy
option used to define the calculation mode of the execution order of the diagram
components:
Initially, the components are numbered according to the distribution of variables among the
components. A component having as an input a variable that is output from another
component will take an execution order number higher than that of the second component.
Secondarily, the geographic position of the components also affects their numbers.
There are two numbering rules:
For a component or a group of independent components, the element furthest to the left
at the top will have the smallest number. The components are then numbered in columns,
ignoring page changes.
For each page independently, for a component or a group of independent components, the
element furthest to the left at the top will have the smallest number. The components are
then numbered in columns independently page by page. The pages are classed by line, i.e.
the pages at the top left have the smallest numbers.
During the positioning of the component, no number is assigned to the component. The user
must therefore assign a number manually.
After selecting User Defined mode, click the Evaluation Sequence option in the contextual menu of
the diagram. The cursor changes for indicate that it is being used to set the evaluation
number.
Click each component to be numbered. The components are numbered with the first free
number.
Click in Manual mode on an already numbered component to delete the number, and all the
higher operator numbers. Their order must then be redefined.
To deselect manual mode, choose another numbering mode in the contextual menu of the
diagram.
If a component does not possess a number, the diagram will be considered as invalid when it
is saved.
The loopback marker is present on the connector linking the last component executing in a
loop to the first component. This means that the result of the last component will be used by
the first component in the following cycle.
More than one loopback marker may exist in the same loop; this means that the
loop will execute over more than one cycle.
Each marker indicates a change of cycle.
The user can force a loopback on a component argument, and therefore choose the
components ending and starting the loop. The numbering of the components of the loop is
recalculated according to user choice, which becomes the most important numbering
criterion. The loopback marker changes position and is placed on the connector linked to the
forced argument.
The force feedback is accessible from the contextual menu of a component argument, using
the Force Feedback option (cf. 4.4.1,Contextual Menu of the Component). If this option is checked,
loopback is forced.
Forcing can be visualized as shown below:
Loops can be displayed and browsed. To enter loop display mode, click the Evaluation Loop
option in the contextual menu of the diagram during its activation, the mouse cursor changes
icons and takes the following form:
To display a loop.
When the option is activated, select a component in a loop. The loop(s) to which the
component belongs are shown in orange as shown below:
This chapter outlines the principle of test marking FBDs. Test marking is carried out on
connections, components and arguments. The date of the test and the name of the tester are
stored each time the diagram is saved. Test marking can only be performed on diagrams
opened from the functional tree.
To be able to display the elements tested and modify the test marks, switch the display to test
mode. For this the corresponding icon in the icon bar must be activated or the Test Mode option
of the View menu must be activated.
The figure below illustrates an example of a display of test markings on an FBD:
This window is used to enter the name of the tester. This name will be recorded with the
test date, after the diagram is saved.
If test mode is exited then entered again, the user will need to provide an ID again
before being able to modify the test marking.
The name of the last tester is proposed by default.
The table below lists the different test states possible for an FBD diagram:
States Description Icons of the trees
Not Tested No element tested.
Partially tested At least one element tested. (grey)
All Fb Tested All the components tested. (blue and grey)
Completely tested All the elements tested. (blue)
The icons of the trees are displayed beside the diagram in the hardware and functional trees.
To display the name of the last tester, the current test status and the date of the last test:
Either open the properties of an FBD
The test marks and the test status appear on the printout.
4.10.1 Overview
In FBD
In SFC Diagrams
This overview provides:
A panoramic view of the diagram divided into sheets,
A reduced or enlarged view of the portion of diagram visible in the active window by
resizing the small blue window showing the overview.
Navigation within the diagram, by moving a highlighted window (navigation can also be
performed via the diagram scrollbars).
Movement within the diagram editor via:
The right, left, up, down arrows: advance step-by-step or by half-page in combination with
the CTRL key
The page up, page down, next page, last page keys
The home, end keys: go to first/last sheet keys.
Zoom in/zoom out on the diagram, by modifying the size of the highlighted window.
This overview can be resized and may be masked or unmasked by means of the button in the
editor tool bar.
During creation, a diagram is defined by a default matrix of 2 x 2 sheets. This matrix can be
modified via the Size option in the View... menu of the diagram editor. The user is requested to
input the number of folios in X and in Y of the matrix, given that the total number of folios in a
matrix may not exceed 12.
Note: In FBD the sheet format is horizontal (the sheet format in SFC is vertical); the size is A4 or A3,
depending on the printer used.
There are several ways of reducing or enlarging the elements represented in a diagram.
Zoom in/zoom out on the diagram modifies the size of the active window
Input the coefficient corresponding to the required size.
Access this option via the main menu View > Zoom. More simply, the + and – keys in the
number pad can be used to zoom in or out relative to the center of the last diagram zone
clicked.
The F11 and F12 keys can be used to zoom on a laptop computer that has no number pad.
Hold down the CTRL key while rolling the scroll wheel.
It is also possible to move the diagram.
Use the scroll wheel to vertically move the diagram,
Hold down the SHIFT key while rolling the scroll wheel to horizontally move the diagram.
For all that relates to the diagram animations, see [CCAD_HARD] (in § 1.7 List of Referenced
Documents).
In the FBD editor, a feature permits to open a file from an input/output hardware variable of
the diagram.
The Show Loop Diagram item is available in the variables and tickets of variables menus:
5.1 Introduction
The SFC (Sequential Function Chart) diagram editor is a graphic editor that is used to describe
a sequential type control function sequence. It uses graphic representation to describe the
behavior of the outputs on the basis of the inputs and of the internal state of the system.
5.2.1 Opening
In the Function tree, open the SFC selected and click the Open Diagram option in the Edit menu
or use the contextual menu associated to the SFC in the tree or double click the SFC.
Double clicking on an SFC that is already open displays the diagram in the foreground.
5.2.2 Backup
The Save option in the File menu in the main menu of the SFC editor saves the active SFC in the
project database. Click the Save all option of the File menu in the main Controcad menu to save
all the opened SFCs in the editing session in a single operation. This action can also be used to
save the variable grid.
When an opened SFC in the editor has been modified since it was last saved, an
asterisk * is shown in the title of the window after the name of the diagram.
ALSPA Control System - Controcad V5.3 Document N° Language: Revision: Page:
5.2.3 Closing
To close an SFC, use the standard Windows pictogram or the Close Diagram option in the File
menu in the editor menu. If the diagram has been modified, Controcad proposes to save the
new version of the diagram. The user can then choose whether or not to save the diagram
before closing it.
One or more elements in a diagram can be selected to display a contextual menu (that of the
element(s) selected) in order to duplicate, move or delete the elements concerned.
To select a set of elements, click at the top left of the area concerned then drag the selection
rectangle to contain all the elements required.
A set of elements can also be selected by selecting elements one by one while depressing the
CTRL key.
The Select All option in the Edit menu of the editor can be used to select all the elements in a
diagram (or keyboard shortcut <CTRL A>).
To cancel a selection, click in an empty zone of the diagram window.
Selected elements can be copied either by using the standard keyboard shortcut CTRL C, or by
clicking on the Copy option in the Edit menu of the editor or in the contextual menu of the
selection.
Selected elements are pasted either by using the keyboard shortcut CTRL V, or by clicking on
the Paste option in the Edit menu of the editor or in the contextual menu of the selection. The
selection is pasted into another diagram open in the same session.
Selected elements can also be duplicated by pressing the CTRL key while depressing the left
mouse button, moving the mouse cursor to the required position on the screen then releasing
the button. That is to say drag & drop.
By default, elements are duplicated with the original conditions and actions.
The Paste With Actions option in the contextual menu of the destination diagram is used to
choose whether the steps are pasted with or without their actions (indicates that the option is
active).
Selected elements are deleted either by using the <DEL> key, or by using the keyboard
shortcut <CTRL X>, or by clicking on the Delete option in the Edit menu of the editor or in the
contextual menu of the selection.
The last actions performed in a diagram can be canceled either by using the keyboard
shortcut CTRL Z, or by clicking on the Undo option in the Edit menu of the editor.
Undo in an SFC diagram only applies to the graphic aspects; it cannot be used to return to the
modification of a step or transition condition number.
It is not possible to overlay elements or to place an element too close to the edge of a sheet
(shown as a dotted line). The editor will refuse to create an element rather than permit either
of these two situations. These restrictions also apply to Boolean actions not represented by a
"ghost" but created with each step.
The step-transition and transition-step alternation must always be respected; whatever the
sequence, it is impossible to link two steps or two transitions.
The Add Action option is used to add an action to the step. By default the action will be Boolean,
with transmission phase N and operation C (cf. 5.4.4.2.1,Boolean or FBD Action).
If there is not enough space to create the action, this option is not available and it is
displayed in grey.
(Boolean action)
The Add Forcing option is used to add an N type forcing order to the step (cf. 5.4.4.2.2,Forcing
Order).
(Forcing order)
Any number of actions (Boolean or FBD) or forcing orders or no can only be added
to a step.
Double click the icon of the title block of a forcing order to open the diagram of the directly
forced SFC.
Click the Properties option to display the dialogue box used to define the attributes of the step
(corresponds to a double-click on the step itself).
The Step number field is used to modify the number of the step, between 0 and 9999 (if the
number already exists in the SFC a warning message is displayed). When a step is created, by
default it takes the number that follows the highest step number in the diagram.
The Initial Step checkbox is used to define the step as an initial step (aindicates that the
function is active). The number of initial steps per diagram is not limited and may be null.
Each step is associated to a Boolean state variable (State variable), which is set to 1 when the
step is active, and to 0 otherwise. The ID tag of this variable identifies it absolutely in relation
to all the variables of the project and complies with the following profile.
<diagram ID>_S< step number>_X
The Time Managed checkbox is used to associate a time variable to the step ( indicates that
the function is active). Its name appears in the Time variable field. The time variable is a word
type variable. Time managed measures the duration of activity of the step.
The ID tag of this variable identifies it absolutely in relation to all the variables of the project
and complies with the following profile:
<diagram ID>_S< step number >_T
When the step is deactivated, this variable keeps its value and is only reset to 0
after a click on the step. This provides the possibility to modifying the time even
after deactivation of the step.
The values of these two step variables ('State variable' and 'Time variable') can be
utilized in other diagrams (in some conditions, as FBD inputs) but cannot be written.
These variables may be sent to one or more HMI devices.
These variables are redundant variables.
The Comment field is used to associate a comment to the step (the line feed is done by the
keyboard command <Ctrl+Enter>).
The Arrange Comment option relocates the comment of a step to its default position to the left of
the step.
The Hide Comment option if checked is used to hide the step comment.
If a step possesses several actions, it is possible to define the order in which they are
displayed. To redefine this order, click the Order actions option in the contextual menu of the
diagram (accessible by right clicking the mouse in the ground of the diagram). The cursor
changes form to indicate that it is being used to define the order of the actions . This
allows the position of an action to be changed. Click with the specific pointer on the action to
be moved, then on the action to be replaced. The Esc key is used to exit the mode.
The order defined in this manner is only visual; it has no effect on behavior.
The Properties option displays the dialogue box used to define the attributes of the transition.
The Transition number field is used to modify the number of a transition. Two transitions
cannot have the same number and this number cannot be greater than 9999.
The Comment field is used to associate a comment to the transition (the line feed is done by
the keyboard command <Ctrl+Enter>).
The Arrange comment option relocates a transition comment to its default position to the left of
the transition.
The Hide comment option if checked is used to hide the transition comment.
Click the Transition condition option to display a window used to define the expression of the
transition condition. Double-click the transition to open this window:
It is possible at any time to create the required variables in the variable grid by
keeping the properties window open (cf. 3.4,Creating a Variable). In this case, the
variables only appear in the window if they have been saved from the grid (double-
click the diagram to which they belong to display them in the list).
The Parse button is used to check that the expression input is valid. The OK button parses and
closes the window. An invalid expression confirmed will be bracketed by exclamation points
and will appear in red on the diagram, after the display of a warning:
The transition condition (such as the transmission of the action or of the forcing order) may be
subject to a condition defined in BEL (Boolean Expression Language).
The result of this expression is a Boolean that takes the value 0 if false and 1if true.
The Syntax help button is used to display the list of available operators and their syntax. BEL
supports the following operators:
AND, OR, NOT, Boolean expressions, noted. (AND), + (OR) and / (NOT). Examples: a+b./c, (a, b
and c Boolean variables ).
Rising and falling edges of Boolean expressions, denoted P1 (FM) and P0 (FD), Examples:
P1(a+b), (a and b Boolean variables).
Delay type excitation or limitation timeouts on Boolean expressions, denoted D (DELAY) and L
(LIMITED). Examples: D(T1, a+b), (a and b Boolean variables, word type T1 variable).
Comparisons of numerical operands, denoted >, >=, <, <=, = and !=.
Example: x > y where x and y are analog variables.
The AND takes priority over the OR and brackets are used to express the required priorities.
Expressions can be reduced to operands only, expressed in the form of variables or
immediate Boolean values (0 for false and 1 for true) or immediate numerical integer values.
The different types of variable utilizable are Boolean, Integer, Duration, Word, DoubleInteger,
LongWord, Real. It is possible to define table type variables and therefore for example to
modify type v[3] variables in the expressions.
! corresponds to the transport validant of the variable (equivalent to the “Transp_Val” FB). The
variable can be a binary or analog variable. Example: !V1.
Select one of the elements to be linked by left clicking the mouse (a dark gray outline
shows the selection), keep the button depressed and drag the selection so that it overlays
the fixed element to which the selected element must be linked. The broken lines of the
"ghost" of the element moved change to white. Release the mouse button: the element
moved is aligned and a link is automatically created between the two elements:
The link follows the mouse. It changes to a gray broken line until the input is connected, and
changes to a white broken line when the link is attached. The link becomes a solid line when
the mouse button is released.
If the link is impossible, it becomes red. In this case it is not possible to establish the link. To
enable or disable the connection, the SFC runs the following checks:
A link can only be created between two elements (no solitary link or with an element at
only one of its extremities).
The two elements must be compatible.
A link cannot run too close to the edge of the working document.
During the creation of the link, the path is generated automatically (a link is exclusively
constituted of horizontal and/or vertical straight lines) with any break points that are
necessary. The link is directed so as not to run over input and output elements.
When the link is established, the user can modify the route by selecting and dragging the
branches that need to be moved.
Vergents are created automatically by the editor if several upstream or downstream elements
are attributed to a source element.
Vergents may not be created directly. However if at least two links are connected to an
element, the branch will be created automatically.
Consequently, it is impossible to cut or copy a branch without its downstream or upstream
elements. Deleting a branch also deletes all the links connected.
If several links are connected to a single transition, they converge on a double horizontal bar;
several simultaneous links diverge in the same way when leaving a transition.
If several links arrive on a step, they converge on a single horizontal bar; several links diverge
in the same way when leaving the step.
A situation where several links leave a step is known as a sequence selection. Each link is
attributed a priority number. The transition priority for a given sequence selection is unique.
The transition with the highest priority is the one with the lowest number.
Since several selection sequences cannot be activated simultaneously the program uses
these priorities to choose which sequence to select when several transitions of the sequence
selection are simultaneously clearable.
During the creation of a sequence selection, the priorities are defined according to the order
of creation. To redefine these priorities, click the Priority setting option in the contextual menu
associated to the diagram. The cursor changes to indicate that it is being used to set the
evaluation number . Then click each intersection between the branch and the lead to be
numbered. Elements are numbered with the first free number. Clicking on a branch that is
already numbered deletes its number, as well as all the branch numbers greater than the
number deleted. Their order must then be redefined. The transition with the highest priority is
the one with the lowest number. To exit the mode after defining the priorities, press the Esc
key.
If a branch or the elements linked to it are moved, the Align branch option can be used to
recalculate the size and the position of the branch in order to obtain the most direct sequence
possible (also used to recalculate the element-branch link, or in the case of a loop). This
function is also accessible directly by double clicking on the branch.
To enhance the legibility of a diagram, it is possible to convert a link into a referral by clicking
on the Convert Link to Referral option. The referral is symbolized by an arrow showing the
direction of the sequence and is labeled by the transition numbers or the numbers of previous
or subsequent actions (in order of priority in the case of a sequence selection).
Conversely, the Convert referral to link option (accessible from the contextual menu of a referral)
is used to convert a referral into a link.
The Reroute Link function is used to recalculate the route of a link when one of the elements
connected has been moved. This function is accessed directly by double-clicking on the link.
If the two elements to be linked are too close to each other, a loop may be created.
In this case, move one of the two elements and use the Reroute Link function
He is therefore also possible to move the element and use the Align Branch function
(accessible by right clicking on the branch) or to double-click the branch.
Certain options are or are not accessible depending on whether an action or a forcing order is
selected.
When an action is added to a step (cf. 5.4.1.1,Adding a Boolean Action or a Forcing Order), the
action is a Boolean. The Change action type from Boolean to FBD (from FBD to Boolean)
option enables the type of an action to be changed from Boolean to FBD (and conversely).
(FBD action)
Each FBD action has a Boolean execution status. This execution status is
commanded like a Boolean action, and its state conditions the execution of the
diagram.
The FBD diagram called is opened directly by double-clicking on the icon of the title block.
The Properties option displays the action definition window (corresponds to double-clicking on
the action) or the forcing order.
The Phase section is used to select the transmission phase of the action. This phase may be:
P0 (falling edge): the action is transmitted on deactivation of the step
P1 (rising edge): the action is transmitted on activation of the step.
N (normal): the action is transmitted throughout the activity of the step.
L (limited): the action is limited in time. The period of this limitation must be indicated.
D (delayed): the transmission of the action is delayed in time. The period of the delay must
be indicated
For phases L and D, the period chosen may be a constant parameter or a word type variable.
In the case of a constant, enter the value (the integer must be between 1 and 99999 - a
warning message is displayed if this is not the case) in the ’Duration value (Constant)' field,
without indicating the unit. The time base is chosen at the level of the POU (cf. 2.2.5,Creating
POUs and associating diagrams).
The Operation section translates the operation executed on a Boolean variable (or an FBD
diagram). It may be:
R (reset): set to 0 saved.
S (set): set to 1 saved. The variable remains at 1 (or the FBD is executed) until a Reset (R) of
this variable (or FBD) is encountered.
C (continuous): set to 1 not saved.
To select a Boolean variable or a time variable (word), double click the diagram or the function
in the list that owns the variable sought. The list of the variables appears, The user can then
select the variable in the list. This variable will appear in the "action var" field for a Boolean
variable and the "duration var" field for a time variable.
ALSPA Control System - Controcad V5.3 Document N° Language: Revision: Page:
To find a variable, a diagram or a function easily in the different lists, enter the first
characters of its ID in the input field to position the cursor at the correct place in the
table.
In the case of an FBD action select the FBD diagram chosen in the list entitled FBD Action (see
below).
It is also possible to get variables directly in the variable grid. Right click the mouse button on
the variable chosen in the grid and select the command Assign to diagram, then left click the Grid
assigned variable button in the properties window.
It is possible at any time to create the required variables by keeping the properties
window open (cf. 3.4,Creating a Variable). In this case, the variables only appear in
the window if they have been saved from the grid (double-click the diagram to
which they belong to display them in the list).
Table type Booleans cannot be used as Boolean actions.
Only word type variables can be used as time variables.
It is also possible to associate a comment to a Boolean action (FBD).
If the action is not completely input, it will be shown outlined in red. The SFC is then
invalidated.
The transmission Phase of a forcing order may be one of the following types:
N (normal)/ permanent forcing order: the forced SFC remains in the forced situation
throughout the activity of the step transmitting the forcing order.
P1 (rising edge)/ setting: the forced SFC is set in the forced situation when the step is
activated; the forced SFC is then allowed to evolve, even if the step remains active.
The list of SFC type diagrams is used to select the SFC to be forced (SFC to force). The field
above it is used to find a diagram more easily: enter the first characters of its name to
position the cursor in the right place in the list.
When the SFC diagram is chosen, select the steps to be forced to 1 in the list (Steps to
activate): the selected steps are shown in inverse video in the list.
It is also possible to associate a comment to the forced step (carriage return is executed by
the keyboard command <Ctrl+Enter>).
To find a diagram in the list more easily enter the first characters of its name in the
input field; the cursor is positioned in the right place in the list.
If the forcing order is not completely input, it is shown outlined in red. The SFC is
then invalidated.
A forcing order is an internal order that modifies the situation of a diagram (i.e. the active
steps). This necessitates certain hierarchical rules between the SFC diagrams.
The diagram below shows a forcing order where the nodes are SFCs and where the arcs from
one node to another node correspond to at least one forcing order from the source SFC to the
target SFC.
Hierarchical consistency requires that no loops are produced in this forcing order diagram.
The presence of a loop is a criterion of impossibility for code generation.
To preclude an SFC from being subject to two or more possibly contradictory forcing orders at
the same time, it is impossible to have simultaneous forcing orders on the same SFC. An order
of priority for all the forcing orders on the same forced SFC must therefore be defined. These
orders can be transmitted from several actions of several steps of several SFCs. The order of
priority exists within each SFC and also among all the SFCs. It exists by default and can be
redefined by the user (cf. 2.2.5,Creating POUs and associating diagrams). Thus, if two forcing
orders on the same SFC have their associated steps activated, only the order with the highest
priority will be transmitted (the highest priority equals the lowest number).
The Action condition option displays the dialogue box used to define the action condition. This
window is identical to the of a transition condition definition window (cf. 5.4.2.3,Editing the
Transition Condition).
5.5.1 Overview
Click the Insert Text Annotation option accessible in the contextual menu associated to the
ground of the diagram to open an input window. It is then possible to input a text that can be
placed as required in the diagram.
The principle is the same as for an FBD diagram (cf. 4.10.2,Defining the Diagram Format).
An SFC diagram, accessible from the View menu of the editor or directly from the
corresponding buttons in the toolbar, can be displayed in one of 3 ways:
Normal Display Mode option displays all the actions and their attributes, the action conditions,
the transition conditions and all the comments.
Comments Only option displays only the comments. The specification SFC is obtained.
No Comment option hides all the comments. The programming SFC is obtained
5.6 Miscellaneous
Animation is activated and deactivated respectively by the Observation > Start Animation and
Debug > Stop Animation options in the main menu. See [CCAD_HARD] (in § 1.7 List of Referenced
Documents).
The user can check the integrity of the project’s diagrams thanks to the List of the pit/source
steps/transitions in the SFCs option of the Tools menu.
The List of the pit/source steps/transitions window lists the isolated elements (if any) in the SFC
diagrams of the project:
the steps with no downstream transition
Example:
The user can double click the steps or transitions listed in the window to open the
corresponding elements in the SFC diagram editor.
The grid is displayed with the Format > Set Font/Color and Display Options menu.
Grid on displays the rectilinear background grid of the editor. This grid is useful for aligning
elements.
Grid off hides the rectilinear background grid.