Professional Documents
Culture Documents
ALSPA Control System Controcad V5.3 Configuration of Data Models Reference Manual
ALSPA Control System Controcad V5.3 Configuration of Data Models Reference Manual
ALSPA Control System Controcad V5.3 Configuration of Data Models Reference Manual
Controcad V5.3
Reference Manual
SH/SH
REFERENCE LG REV ENTITY FORMAT NUM SH
END
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the
information contained therein. Reproduction, use or disclosure to third parties without express
authority is strictly forbidden.
TABLE OF CONTENTS
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
This manual describes the elements of the Library tree structure (Lib tab of
Controcad).
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 manual 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: helpdesk.control-systems@power.alstom.com
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
DANGER
WARNING
CAUTION
ELECTRICAL WARNING
Refers to a document.
Refers to a Medium.
This document is based on information available at the time of its publication. While efforts have been
made to be accurate, the information contained herein does not purport to cover all details or variations
in hardware or software, nor to provide for every possible contingency in connection with installation,
operation, or maintenance.
Features may be described herein which are not present in all systems. Alstom assumes no obligation
of notice to holders of this document with respect to changes subsequently made.
In this publication, no mention is made of rights with respect to trademarks or trade names that may
attach to certain words or signs. The absence of such mention, however, in no way implies there is no
protection.
Partial reproduction of this document is authorized, but limited to internal use, for information only and
for no commercial purpose. However, such authorization is granted only on the express condition that
any partial copy of the document bears a mention of its property, including the copyright statement.
ALSTOM, the ALSTOM logo and any alternative version thereof are trademarks and service marks of
ALSTOM. The other names mentioned, registered or not, are the property of their respective
companies.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
ELECTRICAL WARNING
ELECTRICAL PROTECTION
CAUTION
CAUTION
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.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
1.6 Glossary
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
The following contextual menu is associated to the Project element in the Libraries
tree:
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
When the result of the search is successful, a window opens to display a list of the
library elements found which contain the string.
When the search is unsuccessful, a dialogue box opens to show that no data was
found. This dialogue box is closed by clicking on the OK button.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Click the Library Export... option to open the FEFS library export screen. The user
can then choose a list of the libraries to be exported, the directory in which the data
will be placed and whether or not the data should be archived.
Click the Library Import... option to open the FEFS library export screen. The user can
then choose a list of the libraries to be exported, the directory in which the data will
be placed and whether or not the data should be archived. These are imported into
the tree below the Project element.
Clicking the Issue Library Elements option opens the following window:
This window displays all the elements of the project that are in an issued state and
that can be used to issue the elements chosen by the user.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
The button is used to select all the Object Models in the window.
The button is used to select all the Functional Blocks in the window.
The button is used to select all the Multiple Variable Models in the window.
The button is used to select all the Simple Variable Models in the window.
The None button is used to deselect all the elements in the window.
The Invert button is used to invert the state of selection of all the elements.
The Issue button is used to issue the elements selected.
The Exit button is used to close the window.
The Help button is used to obtain contextual help for this screen.
Clicking the Extract Library Elements option opens the following window:
This window displays all the elements of the project, or of the library selected, that
can be extracted.
Description of the fields:
Type Name Description
Library Path of the library owning the element.
Type Icon representing the type of the element.
Component Name of the element.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
The button is used to select all the Object Models in the window.
The button is used to select all the Functional Blocks in the window.
The button is used to select all the Multiple Variable Models in the window.
The button is used to select all the Simple Variable Models in the window.
The None button is used to deselect all the elements in the window.
The Invert button is used to invert the state of selection of all the elements.
The Extract button is used to extract the elements selected.
The Exit button is used to close the window.
The Help button is used to obtain contextual help for this screen.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Clicking on the IEC61850 Logical Node Types Configure ... option opens the following
window:
This window is used for IEC61850 data modelling which is the first step in the
configuration of the IEC61850 function on ALSPA CE1500 controllers.
The user can create and configure the IEC61850 data types which will then be
mapped into Controcad MVM, SVM and SVM attributes.
For more information about IEC61850 data modelling, see
[CCAD_CE61850] in 1.7 List of Referenced Documents.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Click the New option from the contextual menu associated to the Project element to
open the following window:
Click the New option from the contextual menu associated to the Library elements to
open the following window:
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
The following contextual menu is associated to the Library element in the Libraries
tree:
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
The Properties window of a library is similar to the New library window (cf. 4.1,Creating
a Library).
If the user is logged on as Administrator, an additional field is shown:
Protection: This field indicates whether or not the library is protected, (Yes) or
(No).
If a library is protected:
The System name is shown in bold characters in the tree.
The New, Delete and Paste options in the contextual menu are no longer available,
The elements of the library cannot be modified.
Note : Library protection extends across the entire library tree. For example, if the library is
protected at the project root level, all the elements, FBs, MVs and libraries located below
this level will be protected. Deprotection also extends in the same manner.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
5.1 Description
5.2.1 Description
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Click the New option associated to the contextual menu of a library to open the
following window:
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Cut Cuts the element. The icon of the element cut appears in gray
(for example: becomes ).
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Variable Models > Displays the internal variables associated to the element in
Internal Variables the variable grid (cf. 5.5.5,Internal Variables).
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Edit Linked Used to configure links with a document; the document type
Documents may vary (.doc, .mpg, .html, URL etc.).
The following rules must be observed to enable project (or part project)
imports/exports to manage associated file type documents fully.
Files to be associated to library elements must be located on the server in
the following tree in the project directory (xxxlog):
\\< UNC name server>\P320Share\Ccad\<xxxlog>\docuser\Lib
The association must be executed using the UNC name of the server.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Select the Properties option or double click the issued element to open the following
window:
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
The Arguments tab (inputs, outputs) defines the arguments of the functional block:
Type Name Description
Nb. Order number of the argument in the code that will be
generated for the functional block.
Name Name of the argument. The name will be used in the code
generated for the functional block.
Display Display name of the argument when the functional block is
Name positioned in a diagram. If this field is not input, NAME is
used.
Basic Types Defines the basic models of the argument (Boolean, double,
duration, integer, long, real, word etc.). The field is input via
the List of Types… option in the associated contextual menu
(cf. 5.2.10,Selection Window of the Argument Type). The List
of Types… option is made available when the mouse is
positioned on the relevant element in the Basic Type column.
The user chooses the basic models authorized for the
argument, which means that when the functional block is
placed in a diagram, only those variables with these basic
models can be assigned to the argument.
Length Sets the size of the table for a argument accepting table
variables.
Label Label of the argument.
Sense Indicates if the argument is an input or an output of the
Functional Block.
Side Defines the location of the argument in the graphic
representation of the functional block (Top, Bottom, Left or
Right).
Graphic Defines the graphic position of the argument relative to the
position SIDE chosen.
Default Sets a default value for the argument when it is not
value associated to a variable, a link or a literal value in a diagram.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
This tab is used to input the functional block model code. The programming
language used is Controcad LEA language. In the code, internal variables are
identified in the functional block model by their names (Name field in the variable
grid).
The code can be imported from a file and saved in a file (Load from file and Store to
file buttons). These files are .txt files.
When the user clicks on the Apply or OK buttons the code is checked syntactically
relative to LEA language and semantically relative to the arguments of the model.
Errors detected are displayed in a window that also shows the number of the code
lines concerned.
If the Functional Block is described diagrammatically (FBD type), the code zone is
locked and cannot be modified.
Note : If Author of Functional Block is 'SYSTEM', then code zone cannot be modified.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
This tab is used to associate MVMs to the functional block model and assign each of
the fields of these MVMs to the arguments.
Description of the fields:
Type Name Description
Name of Argument Name of the argument group
Group
MVM defining the Name of the MVM associated to the argument
Argument Group group.
Argument Name Name of the component argument.
MVM Field Path Name of the MVM field associated to the
argument. The fields proposed in the list are the
fields that are compatible with the argument type.
A contextual menu is available in the tab window to:
create, delete, copy and paste a new argument group in the “List of arguments
groups” section.
create, delete, copy and paste a new field used to associate a component
argument to an MVM field in the “Mapping between component arguments and
MVM field” section.
Description of the buttons:
The OK button confirms the user's choice and closes the window.
The Cancel button is used to abort the input and quit the function.
The Apply button confirms the user's choice without closing the window.
The Help button displays contextual help for the current window.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Select the Cross References option from the contextual menu associated to a
Functional Block to open the following window:
The Functional Diagrams tab displays the consumption of the selected element in all
the functional tree diagrams.
The Workspace Diagrams tab displays the consumption of the selected element in the
diagrams used in the last code generation.
Description of the buttons:
The OK button closes the window.
The Help button is used to obtain contextual help for this screen.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
This screen is used to identify errors in the raw code of the element.
Description of the fields:
Type Name Description
Line Number of the line of code
Error Indicates the number of errors in the line of code
Code Line of code
Description of the buttons:
The Save as… button is used to save the screen in the form of a file (several
formats are proposed: text, Excel, html, etc).
The Close button closes the window.
The Help button is used to obtain contextual help for this screen.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
FBs are transformed into BFs (Basic Functions) in order to reduce the size of the
code generated when a large FB is accessed several times within a single program.
This transformation is applicable to all types of FB (LEA or FBD).
The functionality of BFs is inferior to that of FBs, so certain FBs cannot be translated
into BFs. The following functionalities are missing:
#IF instruction using the variable $TARGET_TARGET,
#IF instruction testing the connection of an argument,
#EVAL instruction,
Transport validant test,
Utilization of library variables.
Select the Create BF from FB option from the contextual menu associated to an FB to
transform an FB into a BF.
To make the transformation of a FB into a BF possible, the input/output argument of
a FB has to be of one type.
If the FB is of FBD type, it will become an LEA type after transformation: graphic
data, although now inaccessible, is not deleted in order to permit backtracking.
If the FB is of LEA type a line of code containing the call to the BF is inserted and
the old FB code is placed as a comment, also to permit backtracking.
After the transformation of the FB into a BF, the BF must be saved in an .fbl file:
the inputs of the BF then correspond to the inputs of the FB,
the outputs of the BF then correspond to the outputs of the FB and to all the
internal variables of the FB.
It is not possible to modify or delete in the BF editor, BFs produced from an FB
transformation. These BFs are identifiable by having names starting with
CCAD_BF_.
The transformed FB becomes a BF type in the Properties window of the component.
Select the Cancel BF creation option from the contextual menu associated to an FB
transformed into a BF to backtrack and to restore the FB as it was before the
transformation.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
5.3.1 Description
The High Functional Blocks (HFB) used in diagrams do not generate code. They are
represented by a picture or by a text configurable when the component is placed in
a diagram.
They can be put in libraries containing other types of library elements such as MVM,
SVM, FB.
They are described literally and have a specific icon according to their type which
identifies them in the Libraries tree:
Icon Type
In the tree, a green LED appears to the left of icons with valid models. A red signal
light appears beside icons with invalid models.
The High Functional Blocks have no code, no internal variables and no
association between arguments and MVM.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
To create a High Functional Block, click the New option of the contextual menu of a
library.
The New/Properties window opens.
Select High Functional Block in the drop-down menu of the Element of Library field to
create a HFB:
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Item Description
Properties Opens the properties window of the high functional block.
If the element is in the extracted state, the high functional
block definition can be modified.
Delete Deletes the high functional block, if it is not in use.
This option is not available if the element is extracted or
hidden.
Cut Cuts the high functional block. The icon of the cut element
is greyed out.
Paste Pastes the element that has been cut previously.
Find Available only at the project level.
Issue Allows the user to change the state of the high functional
block from extracted to current.
The modifications carried out on an extracted element are
taken into account when selecting the Issue option.
Extract Allows to change the state of the high functional block from
extracted to current.
Cancel Cancels the extraction of the high functional block. The
current state of the element is not modified. The version
number is lowered to the one of the current state. If the
element has no current state, the element is deleted.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
The Properties window of a high functional block is accessible both from an extracted
or a current element.
If you open the window from a current element, you cannot modify it. All
the fields are greyed out.
Double click a high functional block or select the Properties item of its contextual
menu to open the High Level Block Model: Properties window.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Arguments tab
Type Name Description
Nb. Indicates the sequence number of the argument.
Name Indicates the name of the argument.
Basic Types Defines the basic models of the argument.
Non modifiable. By default, the value is
”VARIANT” (meaning ”all type of variable”).
Label Indicates the label of the argument.
Side Defines the argument position in the graphic
representation of the functional block (Top,
Bottom, Left or Right).
Graphic Position Defines the graphical position of the argument
with respect to the selected SIDE.
Negation Supported The argument can be added to the diagram.
In the list of arguments, the user can create, delete, copy or paste an
argument thanks to the contextual menu accessible from a right-click
within the tab area.
Description of the buttons:
The OK button confirms the user's choice and closes the window.
The Cancel button is used to abort the input and quit the function.
The Apply button confirms the user's choice without closing the window.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Select the Cross References item of the HFB 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.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Click the New option in the contextual menu associated to a library to open the
following window:
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Example: becomes
Paste Pastes the element previously cut.
Find Greyed item (only available on the project level).
Issue Is used to change the project from an extract state to a current
state.
The modifications made on the extract model are taken into
account while issuing the model and impact all the objects
produced from the model.
Extract Is used to change the project from a current state to an extract
state.
Example: Current FB .
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Extract state FB .
The version number of the model is then automatically
incremented. In an extract state, modifications on a model are
authorized with no impact on instantiated objects.
Cancel Cancels the model extraction. The current state of the model is
not modified. The number of the version becomes the one of the
current state again. If the model has no current state, it is
deleted.
Hide Is used to hide the model. According to the level of the user, the
model appears with the icon on its left or doesn’t appear at all
in the treeview.
This functionality allows a configuration engineer to hide models
to avoid their use in the project.
This option is unavailable if the element is extract.
Show Is used to unhide the model and show it to everybody.
Edit Linked Is used to configure the link with a document (.doc, .mpg, .html,
Documents URL,...).
Display Linked Is used to display linked documents.
Documents
Cross Is used to display the consumption of the model in the objects of
References the project (cf. 5.4.4,List of the consumptions of a model).
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
The model properties window is accessible in modification mode only if this one is
opened from an extract model.
Select the Properties option or double click an extract model to open the following
window:
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
View Part
Type Name Description
Name Name of the view associated to the model.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Zone A
The zone A contains all the “Masters” of the model (SVM and MVM fields that have
to be linked to other SVM or MVM fields of the model.
Type Name Description
MVM Type of the MVM containing the field.
Path Path of the MVM field.
Tag Tag of the MVM in the model.
Label Label of the field.
Zone B
The zone B displays the different possible links selected for « Master » in the A
zone. The number and types of authorized links are conditioned by the type of the
« Master » field.
Type Name Description
MVM Type of the MVM containing the field.
Path Path of the MVM field.
Tag Tag of the MVM in the model.
Label Label of the field.
Type of Link Type of the link to input.
Zone C
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Select Cross References from the contextual menu associated to a model to open the
following window:
5.5.1 Description
The variables managed by Controcad are single, multiple or internal to the functional
block models. All these variables are constructed from models that are defined in
the variable grid via the Libraries tree.
There are two types of variable model:
Icon Model
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Single variable models (SVM) are used to create single variables, i.e. variables
corresponding to basic types such as Boolean, word, real etc.
Click the New option associated to the contextual menu of a library to open the
following window:
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
The following rules must be observed to enable project (or part project)
imports/exports to manage associated file type documents fully.
Files to be associated to library elements 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.
Clicking on the Variable Models > SVM option of a library contextual menu displays all
the single variable models in this library in the grid.
The SVM characteristics are the common variable characteristics (for their
description, see [CCAD_FUNCT] in 1.7 List of Referenced Documents) with in
addition:
Type Name Description
Version The version number of the SVM is managed by
Controcad in accordance with extractions and issues
of the SVM.
State Indicates the state of the model (Current, Extract or
Masked).
Profile Is used to automate the construction of the process ID
of variables produced from this SVM. The field
contains the prefix of the ID of the variable to be
constructed. This prefix will be completed by a number
that will be incremented for each new variable. The
uniqueness of the tags is thus guaranteed.
Profile High Limit Defines the limit upper of the number incremented
during construction of the ID.
Profile Low Limit Defines the initial value of the number incremented
during construction of the ID.
Author Author of the SVM.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Note : The column headers change color to indicate to the user that a filter is being applied.
These column headers are shown in green.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
In the variable grid, select the Properties option or double click the line of the current
SVM to open the following window:
This window displays the same characteristics as those in the grid, but the
information is presented in a less condensed form (cf. 5.5.2.3,Characteristics of an
SVM). It is synchronized with the grid; i.e. the model in the window always
corresponds to the current line in the grid.
The user can modify the value of the attributes if the model has previously been
extracted. The model can also be modified directly in the grid.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
The Dynamic Drawings tab is used to assign dynamic sub-drawings to an SVM having
exchanges with the control room.
Dynamic sub-drawings are created from the views tree and are stored by category
(see [CCAD_VIEW] in 1.7 List of Referenced Documents).
Description of the fields:
Type Name Description
Category Name of the dynamic sub-drawing category. The
[None] option is used to select no specific category
and thus to obtain the list of all the dynamic sub-
drawings of the project in the zone "List of Dynamic
Drawings".
Filter Used to filter the list of dynamic sub-drawings.
List of Dynamic List of the dynamic sub-drawings belonging to the
Drawings selected category.
Dynamic Drawings Lists the dynamic sub-drawings assigned to the
affected variable model.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
According to the diagram above, a multiple variable model MVM1 will be composed
of 10 variables:
4 multiple variables corresponding to the root and to fields 1, 2 and A.
6 simple variables corresponding to fields 3, B, Z, W, C and D.
A MVM is created in two phases: the root is created first then the fields.
MVMs are identified by their unique roots. The root is shown in the Libraries tree.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Click the New option associated to the contextual menu of a library to open the
following window:
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Clicking on the Variable Models > MVM option from a library displays the roots of all the
multi-variable models contained in this library in the variable grid.
The screen is as shown below:
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Note : The MVM Name, Label, Nature, Profile and Author MVM root fields can be modified if
the MVM is in the ’Extract’ state.
An MVM reflects an ALSPA System variable structure. It can neither be created nor
modified in the project.
A fixed MVM is used to define a project data model that requires the multiple
variables created to have a fixed structure.
A modulate MVM is used to define a project data model that allows the structure of
the variables created from the MVM to be modified.
The profile attributes are optional. They are necessary if the user wishes the ID of
the multi-variables to be constructed automatically during creation.
The following contextual menu is associated to this variable grid:
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Clicking on the Properties option, or double clicking on a MVM line in the variable grid
showing the MVM roots from a library, opens the following window:
This window displays the same attributes as those in the grid (cf.
5.5.3.3,Characteristics of an MVM Root)), but it displays the attributes in a less
condensed form. It is synchronized with the grid; i.e. the MVM displayed in the file
always corresponds to the current line in the grid.
The user can modify the value of the attributes if the MVM has previously been
extracted. The attributes can also be modified directly in the variable grid line.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Select the New… option from the contextual menu associated to the variable grid
showing the fields of an MVM to open the following window:
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Clicking on the Variables Models > MVM Fields option from the contextual menu
associated to an MVM displays the MVM root (in the first line) and the fields in the
grid.
The characteristics of a MVM are common variables with in addition:
Type Name Description
Level Gives the level of the field in the hierarchy of the MVM.
The level 0 is that of the root.
Path Path from the root to the field in the MVM hierarchy.
The path is constructed by concatenating the names of
the fields of the hierarchy separated by dots. The name
of the root is omitted. The name of the field is given
when the path is created,
Pattern Character string identifying the field and used in the
construction of the name of the variable that
corresponds to the field during creation of a “multi-
variable” from the MVM. The pattern is expressed by
means of the characters * and ? where * designates a
series of characters and ? a single character. The
pattern is also used to construct the patterns of the
fields issued from MVMs.
Aspect This is significant for the fields issued from SVMs and
for fields issued from System MVMs. It shows:
Controller if the field is recognized exclusively by the
controller
HMI if the field is recognized exclusively by the control
room HMI
Mixed if the field is recognized by the controller and the
control room HMI
Ctrl Block Model Name of the control block model to be associated to the
MVM.
In the project, model grids are defined in the
Configuration menu (see [CCAD_INTRO] in 1.7 List of
Referenced Documents).
During creation of the variable, a control block will be
created automatically from the model indicated.
The user can modify the values of the MVM field if the MVM has previously been
Extracted.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Clicking on the Properties… option, or double clicking on the line of the MVM field in
the variable grid, opens the following window:
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
In the Libraries tree, select the Edit MVM Rank Grouping option from the contextual
menu associated to an MVM to open the following window:
This window is used to create groups composed of SVMs within an MVM. Only
SVMs defined as a field of the MVM can be associated to these groups. Each SVM
in a group must have a rank in order for all the SVMs in the group to be structured.
The groups created can then be assigned to external exchange arrays. So instead
of assigning the variables one after the other, it is possible to assign the group
containing these variables directly. For the procedure to assign variables to an
exchange array, see [CCAD_HARD] in 1.7 List of Referenced Documents.
Description of the fields:
MVM part
Type Name Description
Name Name of the MVM.
Label Label of the MVM
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
The validant that is the source of the alarm must not relate to a communication fault.
This presumes that the ALSPA HMI discriminates between an invalidity originating
from the controllers (cell validant) and a communication fault type invalidity. The
HMIs must display this data separately.
The requirement exists to transmit this data instead of creating one or more
additional cBSig variables.
Explicitly show the validant bit _V of the variable and the communication fault
between the cell and the ALSPA HMI.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
In the variable grid, the characteristic Sensor default alarm degree is used to assign a
degree of urgency to the alarm produced by the validant. The value of a given
variable can be:
null the function is not used (no alarm).
0 the variable will not cause an alarm when its validant is set to 1 or on the
occurrence of a sensor fault.
1 , 2 , 3 or 4 the variable will cause an alarm if the validant is set to 1 or on the
occurrence of a sensor fault.
The characteristic is accessible in the variable grid and the variable models if the
variable or the model:
is recognized by the supervisory system and by the controllers,
is multiple and if its supervision object type is cASig or cBSig,
is simple and is both an input and is of Signal or SignalInput supervision
exchange type.
Library documentation Model Urgency_def
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
System/Reserved/ DI103_D001 to 0
Aliens DI103_D003
Models/DI103
DI103_D007 to
DI103_D009
DI103_D016 to
DI103_D018
DI103_D020 to
DI103_D067
DI103_D084
DI103_D098 to
DI103_D0115
DI103_D124 to
DI103_D126
DI103_D130 to
DI103_D140
DI103_D160 to
DI103_D167
DI103_D176 to
DI103_D183
DI103_D192 to
DI103_D194
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
DI103_D198 to
DI103_D204
DI103_D206 to
DI103_D212
DI103_DMIX
DI103 System/Reserved/ DI103_GM5_1 3
analog Aliens 8
inputs Models/DI103
DI103_GM1_0 0
0
DI103_GM2_0
0
DI103_GM2_0
2
DI103_GM3_0
0
DI103_GM3_0
2
DI103_GM3_0
4
DI103_GM3_0
6
DI103_GM4_1
2
DI103_GM4_1
4
DI103_GM5_2
0
DI103_GM5_2
2
DI103_GM5_2
4
DI103_GM5_2
6
DI103_GM5_2
8
DI103_GM5_3
0
DI103_GM5_3
2
DI103_GM5_3
4
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
DI103_GM6_4
6
DI103_GM6_5
0
DI103_GM6_5
4
DI-OPC System/Control/ INP_HMI_VT_I Path 0
analog Input-Output/DI- 1 1_Value
inputs OPC
INP_HMI_VT_I Path
2 1_Value
INP_HMI_VT_I Path
2_SWAP 1_Value
INP_HMI_VT_I Path
4 1_Value
INP_HMI_VT_I Path
4_SWAP 1_Value
INP_HMI_VT_ Path
R4 1_Value
INP_HMI_VT_ Path
R4_SWAP 1_Value
INP_HMI_VT_ Path
UI1 1_Value
INP_HMI_VT_ Path
UI2 1_Value
INP_HMI_VT_ Path
UI2_SWAP 1_Value
DI-OPC System/Control/ INP_HMI_VT_ Path 0
analog Input-Output/DI- BOOL 1_Value.
inputs OPC
EPL System/Control/In EPL_AI Path 3
(E8000) put-Output/EPL 1_Input
analog
inputs
EPL System/Control/In EPL_DI Path 3
(E8000) put-Output/EPL 1_Input
boolean
inputs
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Internal variables are single variables used in functional block code. They are
defined for the functional block model by a configuration level user.
Clicking on the Variables Models > Internal Variables option from a functional block
model in a library displays the internal variables of the functional block model in the
grid.
Internal variables are characterized:
by a sub-set of common characteristics:
Kind / Model / Basic Type / Name / Label / Msg State / Unit / Origin / Length /
Constant / Initial value / Setting / Memory Area / Redundancy / Range / Alarm /
Annotation.
by a specific characteristic:
Private: indicates whether the variable is private (Yes) or shared (No). A private
variable is an internal variable specific to each of the instances of the functional
block in the diagrams. A shared variable is an internal variable common to all the
instances of the functional block in the diagrams. If an internal variable is private, a
variable will be created each time the block is placed in a diagram. If an internal
variable is shared, only one copy will exist per controller however many functional
blocks are used in the controller diagrams.
The following contextual menu is associated to the internal variable grid:
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Select the New… option from the contextual menu associated to the internal variable
grid to open the following window:
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Clicking on the Properties option or double clicking on the line of an internal variable
in the grid opens the following window:
This window displays the same characteristics as those in the grid, but the
information is presented in a less condensed form. The window is synchronized with
the grid; which means that the variable displayed in the window always corresponds
to the current line of the grid.
The user can modify the value of the attributes if the functional block has previously
been extracted. The variable can also be modified directly in the grid under the
same conditions.
Normally, these are system variables and variables necessary to the ALSPA System
domain. They appear in the libraries tree with the icon and have associated
target types. They are produced from the Controcad reference list.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
6.1 Introduction
The Basic Function Editor tool is accessible by clicking on the Basic Function Editor
option of the Configuration menu of the main Controcad window.
Clicking on this option opens the following window:
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
or
The Insert menu displayed depends on whether the root library or a BF from the
library is selected.
Description of the options if the library is selected:
Option Description
Basic Function Used to create a BF in the library.
Global variable Used to create a global library variable.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
6.3 Tree
The sign indicates that the tree below the element is deployed.
The sign indicates that the tree below the element is not deployed.
Using the left mouse button in the tree:
Click the name of the library in the tree to see and modify the data contained in
the library tabs, such as the name, the comment and the global variables.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
6.4 Tabs
The different tabs give access to the display, modification and the creation of the
data relative to the BF and to the current library.
Only the fields on a white ground can be modified.
The mandatory fields are fields that must have a value (text or number).
If the field is a field name the first character must be a letter and the name must
not contain any special characters with the exception of the underscore.
If the field is a number such as the length of an array or the position of an input or
an output, the value must be a number.
If the field is a variable type, the type required must be selected from a pull-down
menu.
Optional fields such as initial values must comply with a syntax. There are no
mandatory conditions for comments.
All the mandatory and optional fields can be modified by a simple click. Commands
in the Insert menu should be used to add a variable. The Delete (Delete row) command
in the Edit menu or in the contextual menu must be used to delete a variable from a
line in a grid.
The Copy, Paste and Cut commands accessed by right clicking in a field correspond
to the commands with the same names in the Edit menu. They only function on the
content of a field. An object in a tab field must be selected to prevent the Cut and
Copy commands being deactivated in the contextual menu.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
BOOLEAN 1 Boolean 0 1
CURSOR 16 Cursor Index of an array element
DOUBLE 32 Double - 2 147 483 647 2 147 483 647
DURATION 32 Timeout 0 ms 248 days
INTEGER 16 Integer -32 768 32 768
LONG 32 Long integer 0 4 294 967 295
REAL 32 Real
WORD 16 Word 0 65535
6.4.2 BF Tabs
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
The BF editor is used to edit a library, check its syntax (Check option), create files
used for C compiler tests and install (Install option) the library or not in the
CTOOLKIT for use on target.
6.5.1 Checks
The Check option in the File menu checks the syntax of the FBL file and, if the syntax
is correct, creates the ".h" and ".lib" files used to test the library in the C compiler.
These two files are in the project folder named VC.
While the Check command is being used, a report window opens to show the status
of the syntax check for each FB and the creation of the C compiler files. This
window can only be closed via the close window icon. The Check command can be
stopped but only from this window.
In error messages, the lines indicated are numbered from the start of the library file.
Use the Go to line command and input the line number to display the line that
contains the error.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Installation corresponds to the creation of the ".h" and ".lib" files for the C8035 and
C8075 controllers. These files have the same name as the library that has created
them. The installation of these files enables one or more BFs in the library to be
used on a chosen controller.
Note : There may not be two BFs with the same name in two libraries installed in the CTOOLKIT.
If the Uninstall command and the Remove command are available in the File menu, the
library is installed.
The files that are installed are independent of modifications to the library. If the files
installed need to be updated, use the Install command in the File menu.
Note : Library installation is common for MFC3000 targets and for the simulator.
The window shows the complete path of the library being installed and lists the BFs
installed or in error one by one. The window can be closed when the installation of
the library is completed.
The Uninstall command is used to uninstall the files generated for the controllers
without deleting the library.
When the uninstallation runs a command prompt opens showing the complete path
of the library. This window can be closed when the uninstallation is completed.
The Remove command is used to delete the library and the files that it has
generated.
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
6.5.3 Modifications
If the BFs are updated, this can affect the operation of the Functional Blocks. To
avoid problems it is advisable to extract the Functional Blocks using the modified
BFs and then to reissue them.
The table below shows whether or not extraction / issue is mandatory depending on
the type of modification.
Modifications Extraction - Issue
Input Mandatory
Outputs Mandatory
Variables Mandatory
Code Non-mandatory
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
In accordance with the principal exchanges for which they are configured, the
variables receive an "exchange family name" that enables them to be characterized
rapidly. The rule for determining this family name takes account of the type of the
transmitting equipment, the type of exchange (HMI or network exchange), the sense
of the exchange and the variable type (Boolean or analog).
Equipment (optional):
- DI80, DI103
- C8075, C8035, CE2000 and Gemstart equipments are contracted to C75,
C35, C2K and GM.
-
Nature (optional):
ol = Open loop and cl = Closed loop
Equipment type:
in = Process input
c = Controller (integrates cc and fc)
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.
Variable type
DI = Discrete or Digital Input
DO = Discrete or Digital Output
AI = Analog Input
AO = Analog Output
Sig = Signal
Cmd = Command
SPt = Set Point
IC = Inter Controller (integrates UIC, FIC, ICU and ICD)
UIC= Unit Inter Controller
FIC = Field Inter Controller
ICU = Inter Controller Up
ICD = Inter Controller Down
© ALSTOM 2014 - All rights reserved. We reserve all rights in this document and in the information contained therein. Reproduction, use or disclosure to third parties without express authority is strictly forbidden.