Professional Documents
Culture Documents
RACL Editor
HONEYWELL EXCEL 5000 OPEN SYSTEM
USER GUIDE
USER GUIDE
Software License Advisory This document supports software that is proprietary to Honeywell Inc. and/or to third
party software vendors. Before software delivery, the end user must execute a
software license agreement that governs software use. Software license
agreement provisions include limiting use of the software to equipment furnished,
limiting copying, preserving confidentiality, and prohibiting transfer to a third party.
Disclosure, use, or reproduction beyond that permitted in the license agreement is
prohibited.
EN2B-162GE51 R1114
EN2B-162GE51 R1114
CONTENTS
OVERVIEW ............................................................................................................................. 9
General ................................................................................................................ 9
Abbreviations ....................................................................................................... 9
The Structure of a RACL Program ....................................................................... 9
The Structure of an Excel Functional Module (XFM) file ...................................... 10
The Flow Chart ..................................................................................................... 11
Statements ...................................................................................................... 11
Registers ......................................................................................................... 11
Communication between Main Module and Submodules................................ 12
Representation ................................................................................................ 13
INSTALLATION ............................................................................................................................. 14
5 EN2B-162GE51 R1114
CONTENTS RACL EDITOR
RACL-STATEMENTS ............................................................................................................................. 55
Alphabetical Overview.......................................................................................... 55
Energy Management Statements......................................................................... 57
HC Heating Curve ........................................................................................... 57
ADAH Adaptation of the Heating Curve Parameters ....................................... 57
ADH2 Adaptation of the Heating Curve Parameters ....................................... 58
EOH Energy Optimized Heating ...................................................................... 60
EOH2 Energy Optimized Heating .................................................................... 64
EOV Energy Optimized Ventilation ................................................................. 64
EOV2 Energy Optimized Ventilation ............................................................... 65
MAXX Knowledge Based Control Algorithm .................................................... 66
ECO Economy................................................................................................. 67
NIPU Night Cooling Operation (Night Purge) .................................................. 67
NIPH Night Cooling Operation (Night Purge with Hysteresis) ......................... 68
DEWP Dew Point ............................................................................................ 69
ENT Enthalpy .................................................................................................. 69
DUC Intermittent Operation ............................................................................. 69
ZEB Zero Energy Band/Setpoint Optimization ................................................ 70
Control Statements .............................................................................................. 72
PD Controller ................................................................................................... 72
PI Controller .................................................................................................... 73
PID Controller .................................................................................................. 74
INRT Integral ................................................................................................... 75
DIFT Derivative ............................................................................................... 76
HYS Hysteresis ............................................................................................... 77
Arithmetic, Logic .................................................................................................. 78
AND ................................................................................................................. 78
OR ................................................................................................................. 78
XOR................................................................................................................. 78
Logical NOT .................................................................................................... 79
SIMI Integer Constant (0..127) ........................................................................ 79
SIMF Float Constant ....................................................................................... 79
MUL Product ................................................................................................... 79
EN2B-162GE51 R1114 6
RACL EDITOR CONTENTS
7 EN2B-162GE51 R1114
CONTENTS RACL EDITOR
EN2B-162GE51 R1114 8
OVERVIEW
General
The RACL Editor is a graphical Editor to create strategy logic programs for Excel
500 controllers. Programs are presented graphically in the form of flow charts for
easy overview. These flow charts are created by placing statements into them. The
flow charts are translated into binary loadable files, which can be read by Excel 500
controllers.
The RACL Editor provides the complete development environment for the creation
of the strategy logic, error checking and correction of the logic, and the translation
of the logic to the binary form read by the controllers. Statements can be selected
from a predefined list of statements and added to source files. The inputs and the
outputs of the statements can be connected.
In addition, Excel Function Module (XFM) source files can be developed. These
XFM source files can be translated to XFM loadable files (.CSD) too. The reverse
translation (retranslation) from .CSD files to XFM source files is also possible.
Like any editor, the RACL Editor has additional features like searching for
parameters; editing of parameters using cut, copy and paste operations; and
printing of reports and flow charts to aid in debugging the logic used in the strategy.
Abbreviations
Abbreviations Meaning
RACL Recursive Algorithm Control Language
XFM Excel Functional Module
PRA Program Administration File
RAL File RACL Loadable file
RAP File RACL Parameter file
RAT File RACL Timer register file
RAZ File RACL Z register file
PHX Engineering unit file
The strategy logic in each module (main module and submodules) is made up of a
flow chart. A flow chart is composed of maximal 255 columns, in which the
statements will be placed. Each column can accommodate up to 256 statements.
The statements can be linked by connecting the output of the statement in one
column to the input of the statement in the successive column. The controller
9 EN2B-162GE51 R1114
OVERVIEW RACL EDITOR
executes the flow chart from top to bottom on the column and from leftside to
rightside.
The statements themselves are arranged in six distinct groups based on their
functionality. The groups are:
Each statement has a distinct format which is defined in the statement definition file
by the below items
• Mnemonic
• Opcode
• Inputs required by the statement
• Outputs required by the statement
• The question entry that will be used.
• The number of outputs for the statement
• The statement’s group
• The execution time of the statement
• The RACL Feature version for the statement
Only those statements whose feature version specified in the statement definition
file is older than or the same as the RACL Feature version set in the INI.file are
read by the RACL Editor. Other statements are invalid.
The statement may use parameters, user adresses, Z registers, T registers etc.
These are defined in the parameter file, which contains all the parameters for the
corresponding source file.
A RACL Source file has the following limitations, which must be observed when
editing the flow chart:
• A XFM source is a stand-alone source file and not associated to a .PRA file
• The number of inputs and outputs allowed for the XFM source is limited and the
limit is specified in the INI file.
• The XFM source does not have a special file for its user addresses. The user
addresses are stored along with the XFM source.
• The parameter file used by the XFM source (getting the engineering unit index)
is defined in the INI file.
• The XFM file may be given description text which is stored as part of the XFM
loadable file.
• Each input and output of the XFM source has input and output definitions
respectively.
• The loadable file created when the XFM source is translated is a .CSD file. The
.CSD file is the only file created which contains all the information edited in the
XFM source file.
EN2B-162GE51 R1114 10
RACL EDITOR OVERVIEW
Statements
The following statements (commands) are used to generate a flow chart:
Input command
Represents the signal path from the sensor or external contact to the program.
Output command
Represents the signal path from the RACL Program to the actuator (e.g. pump or
actuator).
Function command
Processes information which is transferred to the command and supplies the result
at the command output (e.g. logic operation or energy management function).
Registers
Various registers are used for storing values.
X Register
Contain the input values for the RACL commands. When moving from one column
to the next, the Y register values, in the current column, are transferred to the X
registers in the next column.
Y Register
Contain the output values for the RACL commands. Once a column has been
processed, the Y registers in this column are transferred to the X registers in the
following columns.
Z Register
Store intermediate values that are to be processed in the current or subsequent
RACL cycle. For example, the values here can be used to make comparisons.
P Register
Contain parameters that are used in the main program or sub module. Parameters
can be set by the user.
T Register
Are time registers that store intermediate values for commands which operate on a
time-interval basis. T registers can be accessed by the user.
11 EN2B-162GE51 R1114
OVERVIEW RACL EDITOR
X1
X1 Y1
X2 Y2
X3
X3 Y3
. .
Y2
. .
Function
. .
. .
. .
. .
X128 Y128
The statement indicates which registers are used (these registers are defined in
each case). The number of registers is either fixed or can in many cases, be
predefined by the user. As already mentioned, the number of X and Y registers is
limited to 127 per column. The total number of Z or T registers per main module or
submodule is limited to 128.
The rules for generating a submodule are the same as those for a main program
wiht one excepiton; a submodule must not contain an MCAL command (submodule
call-up), i.e. it is not possible to branch form one submodule to another.
A submodule is called up from thet main module using the MCAL command. The
inputs and outputs of the MCAL command correspond to the inputs and outputs of
the submodule. the submodule itsself is not represented in the flow chart of the
main moudule. The MCAL command contains the number of the submodule and
the parameter file number for reference purposes.
Main Module
F1
MCAL
Submodule “Heating”
“Heating Boiler”
Call-up Parameters F1
Results F2
SLEV SLEV
EN2B-162GE51 R1114 12
RACL EDITOR OVERVIEW
Representation
The following diagram shows the basic structure of a flow chart indicating the links
between the input, output, parameter and function commands. The numbering of
the X and Y registers can also be clearly seen.
The final statement at the bottom of each column in the flow chart is a SLEV
statement. This statement is used to provide a link to the next column and transfers
the entire contents of the Y registers to the X registers of the next column. Each
main program is executed one column at a time. It is possible to skip columns using
skip commands.
SYSTEM REQUIREMENTS
To install RACL Editor, you need to have the following hardware and software
respectively:
Software
Operating System Windows 3.1 Windows 95
13 EN2B-162GE51 R1114
OVERVIEW RACL EDITOR
INSTALLATION
See Installation chapter in the CARE User Guide.
Clicking Back to CARE, the application exits to CARE where it was invoked from.
If all the command line arguments for executing the RACL Editor from CARE are
correct, the RACL Editor is executed and the caption of the RACL screen is
“Honeywell - CARE RACL-Editor”.
EN2B-162GE51 R1114 14
RACL EDITOR OVERVIEW
• Menus
• Main tool bar
• Statement group tool bar
• Statement selection drop down list
• Module Name field
• Source file window
• Status bars
• Output Window
NOTES: Most of the above elements, which are described in the following sections
are enabled not before you´ve carried out the special procedures need to
fullfil your requirements while engineering. In order to follow the
instructions of this manual, it is assumed that one is familiar with the MS-
Windows 3.11 Software and able to perform the typical procedures like
starting programs, opening, closing and arranging windows e.g.
15 EN2B-162GE51 R1114
OVERVIEW RACL EDITOR
Menus
When the RACL Editor is started, the only menu selections available are File,
Options and Help. These items and further items becoming available while working
on the application are described within the appropriate sections.
Main Tool Bar
Pastes the cut/copied statement at the selected position on the flow chart
Inserts a column
Opens the Search dialog box, to search for Parameters, z-registers etc.
Opens the Parameter File Edit dialog box to edit the parameter file
EN2B-162GE51 R1114 16
RACL EDITOR OVERVIEW
The user can also enter the statement mnemonic directory into the statement
selection drop down list and press ENTER to get into the “Placing statement mode”.
17 EN2B-162GE51 R1114
OVERVIEW RACL EDITOR
Status Bars
Two status bars along the bottom of the RACL screen show the current status of
the RACL Editor. The upper status bar shows the status about the source file
currently being edited. The information displayed for the current source file is:
• Project Name
• Controller Name
• Controller Number
• Number of P-registers available
• Number of Z-registers available
• Number of T-registers available
• Current operation in progress or the tool tip of the pin over which the mouse
cursor is positioned.
• F: Index of the first column visible on the flow chart
• L: Index of the last column visible on the flow chart
• C: Index of the column over which the cursor is positioned.
Output Window
The output window displays the outputs of the various operations performed e.g. as
follows:
EN2B-162GE51 R1114 18
RACL EDITOR OVERVIEW
Each entry in the output window can either be an action item or just an entry. Each
action item gives the path of the source file, the column number, the statement and
the message string. An action item corresponds to a statement on the flow chart.
The statement corresponding to the action item in the output window can be
selected by either double clicking or pressing ENTER on the appropriate entry in
the output window. The statement corresponding to the selected entry is highlighted
with the color set in the INI file. The contents of the output window can be copied to
the clipboard or printed out.
Cursor Shapes
The cursor shape changes depending on the current operation mode. The different
cursor shapes and their corresponding operation modes are tabulated below:
19 EN2B-162GE51 R1114
OVERVIEW RACL EDITOR
EN2B-162GE51 R1114 20
STEP-BY-STEP INSTRUCTIONS
Creating a new Main Module
NOTE: Each RACL project can only have one main module source file
corresponding to a .PRA file.
1. Click the New button on the main tool bar or choose New from the File menu.
The New dialog box appears. The Main Module radio button is set by default.
2. In the Target Drive drop down list, select another drive, if you do not want to
save your new main module on the drive set by default.
3. In the Directories list box, select the directory that contains the .PRA file. All
the .PRA files saved in the selected directory are listed in the Target Project
list box.
4. Select a .PRA file in the Target Project list box. The Project Name, the
Controller Name and the Application Program Name for the selected PRA file
are displayed in the appropriate fields in the dialog box. If there is any main
module present for the selected .PRA file, it is listed in the Target File Name
combo box.
5. Enter the internal module name of the main module to be created into the
Internal Module Name field.
6. Confirm by clicking OK. The Source file window corresponding to the main
module is opened. It is named appropriate to the previously entered target file
name. Its Internal Module Name is shown in the Module Name field and can
be edited.
1. Click the New button on the main tool bar or choose New from the File menu.
The New dialog box appears.
2. Choose the Sub Module radio button.
3. In the Target Drive drop down list, select another drive, if you do not want to
save your new main module on the drive set by default.
4. In the Directories list box, select the directory that contains the .PRA file. All
the .PRA files saved in the selected directory are listed in the Target Project
list box.
5. Select a .PRA file in the Target Project list box. The Project Name, the
Controller Name and the Application Program Name for the selected PRA file
are displayed in the appropriate fields in the dialog box. If there are any
submodules present for the selected .PRA file, they are listed in the Target File
Name combo box.
6. Type or select the index of the submodule number that needs to be created
into the No field.
7. Enter the internal module name of the submodule to be created into the
Internal Module Name field.
8. Confirm by clicking OK. The source file window corresponding to the
submodule is opened. It is named appropriate to the previously entered target
file name. Its Internal Module Name is shown in the Module Name field and
can be edited.
1. Click the New button on the main tool bar or select New from the File
menu.The New dialog box appears.
EN2B-162GE51 R1114 22
RACL EDITOR STEP-BY-STEP INSTRUCTIONS
4. In the Directories list box, select the directory that contains the .PRA file. All
the .PRA files saved in the selected directory are listed in the Target Project
list box.
5. Enter the name of the XFM file into the Target File Name field.
6. Enter the internal module name of the XFM Source to be created into the
Internal Module Name field.
7. To create the XFM Source, confirm by clicking OK. The source file window
corresponding to the XFM Source is opened. It is named appropriate to the
previously entered target file name. Its Internal Module Name is shown in the
Module Name field and can be edited.
The M0 / SubModule *.PRA entry in the List File of Type drop down list is
selected by default.
2. In the Target Drive drop down list, select the drive, where the main module
and submodule respectively is saved.
3. Select the directory in the Directories list box that contains the .PRA file. All
the .PRA files saved in the selected directory are listed in the Target Project
/XFM list box.
4. Select a .PRA file from the Target Project /XFM list box. The Project Name,
Controller Name and the Application Program Name for the selected. PRA file
are displayed in the appropriate fields in the dialog box
5. Select the desired module in the RACL Source list box.
or
Choose the module by typing the desired number into the No field.
6. Confirm by clicking Open. The source file window corresponding to the main
module and submodule respectively is opened.
23 EN2B-162GE51 R1114
STEP-BY-STEP INSTRUCTIONS RACL EDITOR
2. Select XFM’s *.CSD, *.MCS from the List of File Type drop down list.
3. In the Target Drive drop down list, select the drive, where the XFM module is
saved.
4. Select the directory in the Directories list box that contains the .MCS XFM
Source file. All the the .MCS files saved in the selected directory are listed in
the Target Project list box.
5. Select a .MCS file in the RACL Source list box.
6. Confirm by clicking Open. The source file window corresponding to the XFM
module is opened.
All the statements that are used by the RACL Editor (and included in the statement
definition file) are arranged in six distinct groups. Each group is represented by a
button on the statement tool bar:
EN2B-162GE51 R1114 24
RACL EDITOR STEP-BY-STEP INSTRUCTIONS
The mnemonics of the group which is selected on the statement tool bar by
pressing the appropriate button are listed in the statement selection drop down list.
The user can also enter the statement mnemonic directory into the statement
selection drop down list and press ENTER to get into the “Placing statement mode”.
1. On the statement group tool bar, select the group which the statement belongs
to by clicking the appropriate button. The first mnemonic of the statement
group is shown in the statement selection drop down list.
2. Open the drop down list by clicking the right arrow.
If necessary, use the scrolling arrows to find the desired statement.
Click the mnemonic of the statement. The cursor shape is changed to HAND
CARRYING BOX indicating that the statement is selected and can be placed in
the flow chart
or
3. Type the mnemonic of the desired statement into the statement selection drop
down list, and press ENTER. The cursor shape is also changed to HAND
CARRYING BOX.
4. Place the statement in the source file window at the desired position. The
Modify dialog box of the statement is displayed. The fields in the Modify dialog
box depend on the definition of the statement as given in the statement
definition file.
25 EN2B-162GE51 R1114
STEP-BY-STEP INSTRUCTIONS RACL EDITOR
EN2B-162GE51 R1114 26
RACL EDITOR STEP-BY-STEP INSTRUCTIONS
27 EN2B-162GE51 R1114
STEP-BY-STEP INSTRUCTIONS RACL EDITOR
If the number of T registers required by the statement is less than four, fields are
displayed in the dialog box for entering the T register index. Each field corresponds
to the T register required by the statement.
The number of entries in the list box corresponds to the number of T registers
required by the statement.
EN2B-162GE51 R1114 28
RACL EDITOR STEP-BY-STEP INSTRUCTIONS
The number of entries in the list box corresponds to the number of constants
required by the statement.
3. To assign the constant, select the entry and assign the value of the constant
for the entry into the field and click Assign. The value entered in the field is
assigned to the entry in the list box.
4. Confirm by clicking Assign.
5. Confirm by clicking OK.
29 EN2B-162GE51 R1114
STEP-BY-STEP INSTRUCTIONS RACL EDITOR
2. Confirm the Modify... dialog box. A second Modify... dialog box for attribute
assignment appears.
3. To assign the attributes select the attribute from the attribute check box and
select the corresponding attribute text from the text list box on the right. On
assignment of the attribute the attribute selected on the attribute check box is
shown checked.
EN2B-162GE51 R1114 30
RACL EDITOR STEP-BY-STEP INSTRUCTIONS
Setting the Submodule and Parameter File Index for the Statement
1. Click on the submodule index which is required to be assigned.
1. Click on the output pin of the statement from which the connection should be
established. The cursor changes to the CROSS cursor depicting that the Editor
is in the “connection mode”. (Notice the status bar at the bottom).
2. Click on the desired input pin of the statement which is in the column next to
the column from which the output pin was selected. A connection line is drawn
from the output pin to the input pin.
31 EN2B-162GE51 R1114
STEP-BY-STEP INSTRUCTIONS RACL EDITOR
3. The procedure mentioned in the step 2 can be repeated for any number of
input pins. All the input pins are connected to the same output pin selected in
the step 1. To exit the “connection mode”, press ESC so that the cursor shape
changes to NORMAL.
EN2B-162GE51 R1114 32
RACL EDITOR STEP-BY-STEP INSTRUCTIONS
33 EN2B-162GE51 R1114
STEP-BY-STEP INSTRUCTIONS RACL EDITOR
2. When the cursor shape is DOWN ARROW, click left mouse key. All the
statements in the appropriate column get selected and are shown framed.
3. The same procedures mentioned in steps 2 and 3 can be done when the
cursor shape is UP ARROW which is displayed when the cursor is positioned
at the bottom of the column.
EN2B-162GE51 R1114 34
RACL EDITOR STEP-BY-STEP INSTRUCTIONS
1. Select the statement(s) in the flow chart (To select statements refer to chapter
Selecting Statements in the Flow Chart).
2. With the statements selected, use one of the methods described below to cut
the statement(s) from the flow chart:
1. Select the statement in the flow chart (To select statements refer to chapter
Selecting statements in the flow chart).
2. With the statements selected, use one of the methods described below to copy
the statements from the flow chart:
The statements that were last cut or copied from the flow chart are pasted at
the beginning of the column. Already existing statements are shifted down
within the column.
1. Move the cursor to the end of the column, till the UP ARROW cursor is
displayed, and click the left mouse key.
35 EN2B-162GE51 R1114
STEP-BY-STEP INSTRUCTIONS RACL EDITOR
The statements that were last cut or copied from the flow chart are pasted after
the last already existing statement in the column.
NOTE: Multiple statements can be pasted only to the beginning or end of the flow
chart, they cannot be pasted in between statements of the flow chart.
1. Select the statement(s) which is (are) to be deleted from the flow chart.
2. Apply one of the following methods:
1. Select Insert from the Edit menu. The cursor changes to HAND indicating the
“Inserting column mode” .
2. Position the cursor over the column where the (new) empty column needs to be
inserted, and click. An empty column is inserted and the location specified. All
the columns after the newly inserted column are pushed to the left. All the
connections between the statements in the columns preceding and succeeding
the inserted column are lost.
EN2B-162GE51 R1114 36
RACL EDITOR STEP-BY-STEP INSTRUCTIONS
37 EN2B-162GE51 R1114
STEP-BY-STEP INSTRUCTIONS RACL EDITOR
1. Select Undo from the Edit menu or use the CTRL + Z combination.
The flow chart is scrolled to the position it was in, when the operation was
performed and reverts the changes made.
Once a statement is placed in the flow chart, the attributes of the statement can be
modified.
2. The Modify dialog for the statement appears. (for the different kinds of Modify
dialog corresponding to different attributes of the statement please refer to
section Adding statements into the flow chart)
3. Modify the desired values in the fields and confirm by clicking OK.
• Errors
• Errors + Warnings
• Errors + Warnings + Information
1. Select Save / Translate from the File menu or click the Save button on the
main tool bar. A confirmation dialog for the translation of the source file
appears.
EN2B-162GE51 R1114 38
RACL EDITOR STEP-BY-STEP INSTRUCTIONS
39 EN2B-162GE51 R1114
STEP-BY-STEP INSTRUCTIONS RACL EDITOR
1. Click on the Delete Last button in the Parameter File Edit dialog box.
EN2B-162GE51 R1114 40
RACL EDITOR STEP-BY-STEP INSTRUCTIONS
1. Select XFM I/O... from the Edit menu. The XFM I/O dialog box is displayed.
NOTES: The number of fields under the Inputs and Outputs section depends upon
the XFmaxX and XFMmaxY entries specified in the [General] section of
the RACL.INI file. The number of fields enabled depends upon the current
input and output pins of the current module being edited.
2. Enter the name (maximum of three characters) for the inputs and outputs into
the appropriate fields and select a type for each of the input and output pins.
By default, the type for the Input pin is AI and for the output pin it is AO.
1. Select XFM Description... from the Edit menu. The XFM Description dialog
box is displayed.
41 EN2B-162GE51 R1114
STEP-BY-STEP INSTRUCTIONS RACL EDITOR
1. Enter a unique XFM user address string into the XFM Point Name field.
2. Select a XFM address type from the Type drop down list.
3. Click the Add button to add the entry into the list.
The entry is displayed in the list box.
3. To confirm the modification of the user address entry, either click on (the green
checking) button or press ENTER.
4. To cancel the modification of the user address entry, either click on the (red
cancel) button of press ESC.
1. From the list box, select the user address entry which needs to be deleted.
2. Click Delete.
EN2B-162GE51 R1114 42
RACL EDITOR STEP-BY-STEP INSTRUCTIONS
which the search result is listed can be highlighted by double-clicking (or pressing
ENTER) on the corresponding entry in the output window.
1. Select Search from the Edit menu. The Search dialog appears.
3. Click Search.
43 EN2B-162GE51 R1114
STEP-BY-STEP INSTRUCTIONS RACL EDITOR
1. Select Setup from the Options menu. The Setup dialog box is opened.
1. Click the Select Color... button next to the Statements with Unassigned User
Addresses text. The Color dialog box appears.
EN2B-162GE51 R1114 44
RACL EDITOR STEP-BY-STEP INSTRUCTIONS
1. Click the Select Color.. button next to the Statements with Unassigned
inputs (X Registers) text. The Color dialog box appears.
2. Select the color and confirm by clicking OK.
Updating the Color for Statements selected from the Output Window
The following updates the ColorSearchResult entry in the [Editor] section of the INI
file:
1. Click the Select Color.. button next to the Output Window Selection text.
2. The Color dialog box appears.
3. Select the color and confirm the selection by clicking OK.
Assumption:
The mainmodule is opened and the corresponding window active.
1. Select Save As from the File menu. The Save As dialog box appears.
2. In the Target project list box, click the project, that contains the desired main
module as which the active mainmodule should to be stored.
45 EN2B-162GE51 R1114
STEP-BY-STEP INSTRUCTIONS RACL EDITOR
1. Select Save As... from the File menu. The Save As dialog box appears.
NOTE: By default the submodule number is the number of the source file
being saved.
6. Enter the internal module name for the target submodule into the Internal
Module Name list box.
7. Confirm by clicking OK.
Assumption:
The submodule is opened and the corresponding window active.
1. Select Save As... from the File menu. The Save As dialog box appears.
2. Select the drive in the Target Drive list box.
3. Set XFM Source *.MCS in the Save File as Type list box.
4. In the Directories list box, select the directory to which the submodule should
be saved as XFM file.
5. Enter the file name for the XFM source that needs to be created in the Target
File Name field.
6. Enter the internal module name for the XFM source file into the Internal
Module Name field.
7. Confirm by clicking OK.
The submodule file is saved as XFM source and the XFM I/O dialog for
obtaining the XFM I/O definition of the XFM is launched. Otherwise an error
EN2B-162GE51 R1114 46
RACL EDITOR STEP-BY-STEP INSTRUCTIONS
dialog is displayed and the XFM file is not created (for the types and meaning
of the error dialogs please refer to the Appendix).
Assumption:
The XFM source file is opened and the corresponding window active.
1. Select Save As... from the File menu. The Save As dialog box appears.
2. Select SubModule *.PRA. in the Save File as Type list box.
3. In the Directories list box, select the directory that contains the PRA file to
which the the XFM module should be saved as submodule.
4. In the Target Project list box select the .PRA file.
5. Enter the file name for the submodule that needs to be created in the Target
File Name field.
6. Type or select the index of the submodule number into the No field.
7. Enter the internal module name of the XFM source file into the Internal
Module Name field.
8. Confirm by clicking OK. The window corresponding to the submodule is
created and the User Address ReAssign dialog is launched. This dialog is
used to reassign the user addresses that were used by the XFM source to the
user addresses that are available and valid in the selected RACL project.
The user addresses currently used by the XFM source are listed in the User
Address in XFM source section The user addresses available in the .IPG file
of the target submodule are listed in the Sub-Module User Address section.
9. From the User Address in XFM Source section, select the appropriate user
address.
10. From the Sub-Module User Address drop down list, select a user address
which should replace the XFM user address in the User Address in XFM
Source field.
11. To assign the selected user address(es), click Assign.
47 EN2B-162GE51 R1114
STEP-BY-STEP INSTRUCTIONS RACL EDITOR
Assumption:
If the choosen target project is already existing, those files are overwritten by the
current project files.
1. Select Save Project As from File menu. The Save Project As dialog box
appears.
or
EN2B-162GE51 R1114 48
RACL EDITOR STEP-BY-STEP INSTRUCTIONS
d. If Yes is clicked, the file with the name given in the dialog box is
overwritten with the file from the source directory
e. If Yes to All is clicked, all the files from the target project are
overwritten with the files from the source project
f. If No is clicked, the file with the name given in the dialog box is skipped
g. If Cancel is clicked, the procedure is aborted.
49 EN2B-162GE51 R1114
STEP-BY-STEP INSTRUCTIONS RACL EDITOR
2. Click OK to confirm. The following dialog box is displayed which lists all the
files corresponding to the project to which the main module belongs.
4. Click Yes to delete the file whose name is displayed in the dialog box.
or
EN2B-162GE51 R1114 50
RACL EDITOR STEP-BY-STEP INSTRUCTIONS
Click Yes to All to delete all files that were listed in step 2.
or
or
2. First, choose the printing settings by clicking the Setup... button. The Print
Setup dialog box is shown.
NOTE: The Print Setup dialog box depends on the operating system
used. Please refer to the appropriate documentation delivered
with your OS.
Columns/Page
By default, the number of columns printed per page is 5. The minimum is 2 and
the maximum is 8. Enter the value of the number of columns per page.
Copies
By default, the number of copies is 1. Enter the number of copies.
Print Area
Check the All radio button, if the entire flow chart should be printed.
Check the Selection radio button, if the currently selected statements
of the flow chart should be printed. If there isn´t any statement selected
in the flow chart, this option is disabled.
Check the Columns radio button, if a range of columns should be
printed. Enter the first and the last column number which need to be
51 EN2B-162GE51 R1114
STEP-BY-STEP INSTRUCTIONS RACL EDITOR
printed, in the From and To fields. All the columns in between the first
and the last column set, including the first and the last column are
printed. By default the first column (From) is set to 1 and the last
column (To) is the column number of the last column in the flow chart.
Parameters
Check the Parameters check box, to print the parameters additionally.
• User addresses
• Parameters
• Z registers
• T registers
The report shows which statements use which user addresses, parameters, Z
registers and T registers.
Check the Access Lists (Reports) check box to select all above options.
Reselect options which you don´t want to include to the access list.
3. Click OK.
6. Click the Retranslate button to start the retranslation process on the loadable
files. All the retranslated source files of the .PRA file selected are displayed in
the RACL Source list box.
EN2B-162GE51 R1114 52
RACL EDITOR STEP-BY-STEP INSTRUCTIONS
6. Click the Retranslate button to start the retranslation process on the XFM
loadable files. The retranslation messages are displayed in the Output window
and if there are no retranslation errors, the .MCS file retranslated is displayed
in the RACL Source list box.
53 EN2B-162GE51 R1114
STEP-BY-STEP INSTRUCTIONS RACL EDITOR
EN2B-162GE51 R1114 54
RACL-STATEMENTS
Alphabetical Overview
Abbreviation Name/Function
ADH2 Adaptation of the Heating Curve Parameter
(no user address)
AND Logical AND
AOP Analogue output
CDEL Delay
COMP Logical comparison
CONT Counter
CPAR Configuration Parameter
DATE Annual clock
DIFT Derivative
DIV Division
DUC Intermittent operation
ECO Economy
END End - Main Module
ENT Enthalpy
EOH Energy optimized Heating
EOH2 Energy optimized Heating
(indirect TUNCOS information)
EOV Energy optimized Ventilation
EOV2 Energy optimized Ventilation (indirect
TUNCOS information)
EQL Equal
x
EXP e
HC Heating curve
HYS Hysteresis
IBIT Digital input
IDT Identity
INP Analogue input
INRT Integral
IRCL Indexed recall
ISTO Indexed store
LIN Linear product
LN ln(x)
MAX Maximum
MCAL Submodule call
MIN Minimum
MRG Merge Values
MTIM Monoflop timer
MUL Multiplication
MUX Multiplex
NBIT Inverted digital, input
NEG Negation
NIPU Night Cooling Operation
(Night Purge)
NIPH Night Cooling Operation
(Night Purge) with hysteresis
NOP No operation
NOT Arithmetic difference
OBIT Digital output
OR Logical OR
PAR Parameter
PD PD ontroller
PI PI controller
PID PID controller
POL Polynomial
PONT Set line counter
RCL Recall Z register
RIA Read attributes
RNDI Round
RTC Time counter
RTIM Read Timer register
SET Set output
SETL RS flip-flop
SIMF Set Float
SIMI Integer
SKP Skip on positive
SKU Unconditional skip
SKZ Skip on zero
SLEV Next column
SCPR Set configuration parameter
SPLT Split Value
SPR Set parameter
SQRT Square Root
STIM Start Timer register
STO Store Z register
SUB Subtraction
SUM Addition
SWI Conditional transfer
TIME Time
TRN Truncate
WIA Write attributes
WIDO Window
XOR Exclusive OR
ZEB Zero energy band/setpoint optimization
EN2B-162GE51 R1114 56
RACL EDITOR RACL-STATEMENTS
HC Heating Curve
Function The "Heating curve" characteristic determines the flow temperature setpoint from
the room setpoint and the outside air temperature via the heating curve.
Characteristic values for the heating curve are the curvature m and slope S
parameters. The calculated flow temperature setpoint is transferred to the Y
register.
k = S * f(m)
α = g(m)
m = curvature
MWTsp = mixed water temperature setpoint (flow temperature setpoint)
RMTsp = room temperature setpoint
OAT = outside air temperature
Registers P 2
Z 0
T 0
X 2
Y 1
Execution time 8.0 ms
k = S * f(m)
α = g(m)
m = curvature
MWTsp = mixed water temperature setpoint (flow temperature setpoint)
RMTsp = room temperature setpoint
OAT = outside air temperature
57 EN2B-162GE51 R1114
RACL STATEMENTS RACL EDITOR
Registers P 3
Z 10
T 2
X 4
Y 2
Pa = Switch
0 = don’t do adaptation
1 = do adaptation
2 = restart adaptation
User address = Input of the user address of the room temperature setpoint.
Ta = internal timer
Tb = unused
Result Ya : Contains the release signal 0/1 for the calculated heating curve parameters.
0 = Yb contains no valid value
1 = Yb contains a valid value (may be limited by Pb)
EN2B-162GE51 R1114 58
RACL EDITOR RACL-STATEMENTS
k = S * f(m)
α = g(m)
m = curvature
MWTsp = mixed water temperature setpoint (flow temperature setpoint)
RMTsp = room temperature setpoint
OAT = outside air temperature
Registers P 3
Z 10
T 1
X 5
Y 2
Pa = Switch
0 = don’t do adaptation
1 = do adaptation
2 = restart adaptation
User address = Input of the user address of the room temperature setpoint.
Ta = internal timer
Result Ya : Contains the release signal 0/1 for the calculated heating curve parameters.
0 = Yb contains no valid value
1 = Yb contains a valid value (may be limited by Pb)
Yb If Ya = 1 then Yb contains the calculated slope S.
Za = Sum of room temperature samples
Zb = Sum of outdoor temperature samples
Zc = Sum of supply temperature samples
Zd = Number of samples
Ze = Numerator
Zf = Denominator
Zg = time of adaptation condition was true
(room temperature setpoint > 18°C) AND (outdoor temperature < 15°C) AND (pump
on)
59 EN2B-162GE51 R1114
RACL STATEMENTS RACL EDITOR
Optimization without a room sensor works in accordance with the outside air
temperature. Optimization with a room sensor works with room monitoring and
needs the time constants and the dead time to calculate the heat up time. The
setpoint defaults (current setpoint, the next setpoint, time until the next setpoint)
from the time program are assigned to the command via the user address during
processing. The command activates the option (optimization yes/no) in the time
program menu.
k = S * f(m)
α = g(m)
m = curvature
MWTsp = mixed water temperature setpoint (flow temperature setpoint)
RMTsp = room temperature setpoint
OAT = outside air temperature
EN2B-162GE51 R1114 60
RACL EDITOR RACL-STATEMENTS
61 EN2B-162GE51 R1114
RACL STATEMENTS RACL EDITOR
EN2B-162GE51 R1114 62
RACL EDITOR RACL-STATEMENTS
Modes
OpMode Operation
NORMAL_CONTROL supply water temperature controled by
atmospheric conditions (heating curve)
PREHEAT preheating (boost heating)
PREHEAT_ROOM_CONTROL room control
POST_PREHEAT_ROOM_CONTROL preheating
EARLY_SETBACK off
SETBACK off
SETBACK_ROOM_CONTROL room control (room monitoring)
Registers P 17
•
Z 13
T 2
X 2
Y 3
Execution time 15 ms
User address: Enter the user address to assign the values from the time program.
Result Ya = This register contains the setpoint for the heatup or cool down phase. If these
phases have terminated, the setpoint is output of register Xc.
Yb = This register assumes the value 1 during the heat up phase. In all other cases,
the value of Yb is 0.
Yc = This register assumes the value 1 during the cool down phase.
In all other cases, the value of Yb is 0.
63 EN2B-162GE51 R1114
RACL STATEMENTS RACL EDITOR
Registers P 17
Z 13
T 2
X 3
Y 3
Execution time 15 ms
User address: Enter the user address to assign the values from the time program.
Result Ya = This register contains the setpoint for the heatup or cool down phase. If these
phases have terminated, the setpoint is output of register Xc.
Yb = This register assumes the value 1 during the heat up phase. In all other cases,
the value of Yb is 0.
Yc = This register assumes the value 1 during the cool down phase. In all other
cases, the value of Yb is 0.
EN2B-162GE51 R1114 64
RACL EDITOR RACL-STATEMENTS
Registers P 9
Z 6
T 2
X 4
Y 3
Execution time 15 ms
User address:
Enter the user address to assign on/off signal from the time program.
Registers P 9
Z 6
T 2
X 5
Y 3
Execution time 15 ms
65 EN2B-162GE51 R1114
RACL STATEMENTS RACL EDITOR
Registers P 15
Z 3
T 1
X 7
Y 1
EN2B-162GE51 R1114 66
RACL EDITOR RACL-STATEMENTS
ECO Economy
Function This command computes the control output signal Y for energy recovery using the
available outside and exhaust enthalpy and the requirements of a full air
conditioning system. With partial air conditioning systems, this command can be
used for heat recovery with temperature comparison. The economy function
differentiates according to mixed air damper operation or energy recovery with
temperature and humidity regenerative transfer energy cost priority: Heating or
cooling
Registers P 5
Z 0
T 0
X 4
Y 1
Input Xa = X register containing the control output signal Y of the temperature controller
in %
Xb = X register containing the control output signal Y of the humidity controller in %
Xc = X register containing the outside enthalpy or outside air temperature
Xd = X register containing the exhaust enthalpy or exhaust air temperature
Pa = Working range of the ECO statement within the basic controller output signal
(-50% ... +50%) in %
Pb = Decision whether for a full or partial air conditioning system
System with temperature and humidity control = 1
system only with temperature control = 0
Pc = Decision whether a mixed air damper operation or heating and humidity
regenerative transfer
Mixed air damper operation
Heat humidity regenerative transfer 0
Pd = Relative to Parameter P
Mixed air damper operation: Minimum air component input in %
Heat and humidity regenerative transfer: Minimum rotational speed input
in %
Pd = Decision related to energy costs
Heating costs < Cooling costs = 1
Heating costs > Cooling costs = 0
Result Ya = Control output signal of the mixed air damper or the heat humidity regenerative
transfer in %
67 EN2B-162GE51 R1114
RACL STATEMENTS RACL EDITOR
time (night). With a night outside air temperature of 15°C for example, the
ventilation (air conditioning)system purges the room air with 100% outsideair so that
the cooling operation can begin as late as possible on the next day.
Registers P 2
Z 0
T 0
X 5
Y 1
Pb + Pc < Xa - Xb
(if outdoor temp. drops then the hysteresis delays activation of NIPH)
Xb - Pc > Pa
(if NIPH is disabled due to an outside temperature to low then the hysteresis delays
NIPH activation when the outside temperature is rising again
Xa - Pc > Xd + Xe
(if the room temperature rises then the hysteresis delays activation of NIPH)
Registers P 3
Z 0
T 0
X 5
Y 1
EN2B-162GE51 R1114 68
RACL EDITOR RACL-STATEMENTS
Registers P 1
Z 0
T 0
X 1
Y 1
ENT Enthalpy
Function This command calculates the enthalpy and the absolute humidity of the air using a
temperature and associated relative humidity.
Registers P 1
Z 0
T 0
X 2
Y 2
69 EN2B-162GE51 R1114
RACL STATEMENTS RACL EDITOR
Registers P 6
Z 1
T 1
X 4
Y 2
• Heating range
• Zero energy band
• Cooling range
The zero energy band represents a temperature range in which the room
temperature may change without heating or cooling energy being consumed or
expended. The setpoint optimization causes demand-related setpoint control
(cascade input) of a central air conditioning plant, dependent on the individual room
loads, to use the lowest possible energy levels outside the zero energy band.
Registers P 11
Z 0
T 0
X 5
Y 5
Pf = Application type
1 = ZEB
2 = Heating setpoint control
EN2B-162GE51 R1114 70
RACL EDITOR RACL-STATEMENTS
Examples:
Setpoint optimization
Setpoint control for hot and cold duct temperatures in dual duct or multizone
systems.
Setpoint control of the supply air applied to ventilation with residual zone heating, or
VAV systems.
Setpoint control of the chilled water flow temperature.
71 EN2B-162GE51 R1114
RACL STATEMENTS RACL EDITOR
Control Statements
PD Controller
Function Calculates a proportional derivative control signal. This command combines two
components of the PID algorithm in order to obtain a large, initial control response.
The control signal changes with the size and rate of change of the deviation. The
PD function minimizes system oscillation due to large time constants. The output
signal is transferred to the Y register.
deviation
En XC
setpoint
D
error
XC = 100
TR
[E n +
TD ( E n − E n −1 )
tn
]
En + (En − Z a )
100
TD
XC = TR
tn
Proportional + Derivative
E n − E n −1
t0
= Rate of change of the deviation
Registers P 2
Z 1
T 0
X 1
Y 1
EN2B-162GE51 R1114 72
RACL EDITOR RACL-STATEMENTS
PI Controller
Function Produces a proportional-integral control signal. This command uses the PI
component of the PID algorithm to combine reset and proportional functions. The
sum of all previous deviations is added to the proportional deviation. The integral
component of the algorithm is a dimensionless value and is limited to ± 50%. The
system sets this limit internally The reset function causes the proportional band shift
to prevent a residual control deviation. It is used in fast response systems with large
load fluctuations. The PI control signal is transferred to the Y register.
deviation
En XC
setpoint
I
anti wind up limit
TI
error
n
ti
n ∑ Ei
+
100
XC = TR E
i =0 TI
t
XC = TR n
100
E + Z a + En n
TI
Proportional + Integral
n
ti
∑ E T i
i =0 I
= Accumulated deviations * scan time / reset time
Registers P 2
Z 1
T 0
X 1
Y 1
73 EN2B-162GE51 R1114
RACL STATEMENTS RACL EDITOR
To suppress the integral component, set the Parameter Pb to zero (if Pb < 1 sec
then TI is assumed to be ∞).
Result The Y register contains the calculated proportional - integral control signal.
The Za register contains the sum of all previous deviations * scan time / reset time:
n
ti t
∑ E T i
or Z a + En n
i =0 I TI
The current deviation is added to the existing contents of the Z register during the
processing of this command.
PID Controller
Function Sum the proportional rate of rise, accumulated integral component, and derivative
function. The resulting integral component is a dimensionless value with a limitation
of ± 50%. The system sets this limit internally The control signal is transferred to the
Y register.
deviation I
En anti wind up limit XC
setpoint
T
error D I
n
ti TD ( En − En−1 )
n ∑ Ei +
+
100
Xc = TR E tn
i =0 TI
t T
Xc = TR n
100
E + Z a + En n + D (En − Z b )
TI tn
Proportional + Integral + Derivative
EN2B-162GE51 R1114 74
RACL EDITOR RACL-STATEMENTS
n
ti
∑ E T i
i =0 I
= Accumulated deviations * scan time / reset time
En − En −1
tn
= Rate of change of the deviation
Za = Integral Part
Zb = Deviation of the preceding RACL cycle
n = Current cycle number
Registers P 3
Z 2
T 0
X 1
Y 1
∑E
0
n t0 or (Za + En)
INRT Integral
Function Calculates the I component, depending on magnitude and duration of the control.
When the integral function is used with a proportional function, it is designated a
reset function, because it has no residual control deviation. The integral limit of the
correction signal results in a functional limit of the integration, The output signal
cannot be greater than the integral limit, no matter for how long or by how much the
calculated value exceeds the limit.
n
ti tn
I= ∑ E T i
or I = Za + En
i =0 I TI
75 EN2B-162GE51 R1114
RACL STATEMENTS RACL EDITOR
n
ti
∑ E T i
i =0 I
= Accumulated deviations * scan time / reset time
Za = Integral
t0
Ti ( E n ) = Integral of current cycle
Registers P 1
Z 1
T 0
X 2
Y 1
Result The Y register contains the integral output. If the calculated integral is greater than
the integral limit (+/-), then the integral limit is used at the output. In each case, the
Z register contains the absolute smaller value of the integral limit and the sum of the
integrals of all preceding cycles. During the course of the command, the current
integral output is stored in the Z register. The result will never exceed the value of
the integral limit.
DIFT Derivative
Function Calculates the derivative output signal, which changes in proportion to changes, in
the input signal. The output changes only during the cycle in which the input
changes. The input signal is a deviation. It can be a deviation from the setpoint or
another assigned deviation. If the deviation does not change per cycle, the output
signal Y is equal to zero.
En − En−1
D = TD tn
D = Derivative output signal
TD = Rate time (input as a parameter)
tn = Scan time of current RACL cycle
En = Instantaneous deviation
En-1 = Previous deviation (stored in the Z register. If En-1 is equal to zero,
then there was no deviation in the last cycle).
Registers P 1
Z 1
T 0
X 1
Y 1
EN2B-162GE51 R1114 76
RACL EDITOR RACL-STATEMENTS
The Z register contains the difference of the current control deviation and the
deviation of the preceding cycle. During the processing of this command, the
difference is stored in the Z register for use in the next RACL cycle.
HYS Hysteresis
Function Contains a hysteresis function with fixed switching differential and a variable
threshold value (upper limit). The hysteresis function uses a switching differential
with a specified width, between which an input signal functions. The current output
signal is stored in the next available Y register and also in a Z register for use in the
next RACL cycle.
Registers P 1
Z 1
T 0
X 2
Y 1
Result The Y register contains the output signal based on the following functions:
Y =1 if Xa ≥ Xb
Y = 0 if Xa < Xb-Pa
otherwise
Y = Z (Value unchanged since preceding RACL cycle)
The Y register signal is stored in the Z register after processing this command.
77 EN2B-162GE51 R1114
RACL STATEMENTS RACL EDITOR
Arithmetic, Logic
AND
Function Logical AND transfers a 1 into the Y register when a 1 is present at all X registers.
In all other cases, the Y register has the value 0. This command has at least 2 up to
a maximum of 128 inputs, and is used for processing binary signals.
Registers P 0
Z 0
T 0
X 2..128
Y 1
Execution time 0.389 + X * 0.171 ms
OR
Function Logical OR transfers a 1 into the Y register when a 1 is present at least one X
registers. Otherwise the Y register has the value 0. This command has at least 2 up
to a maximum of 128 inputs, and is used for processing binary signals.
Registers P 0
Z 0
T 0
X 2..128
Y 1
Result Y = Xa OR Xb OR Xc ....
XOR
Function Logical XOR transfers a 1 into the Y register when a 1 is present at exactly one X
register. Otherwise the Y register has the value 0. This command has 2 inputs, and
is used for processing binary signals.
Registers P 0
Z 0
T 0
X 2
Y 1
EN2B-162GE51 R1114 78
RACL EDITOR RACL-STATEMENTS
Result Y = Xa XOR Xb
Logical NOT
A logical NOT can be achived in two different ways:
1. Use the RNDI statement with C=1 then Yb will be the inverted input X of
RNDI.
2. Use the NOT statement with a parameter equal 1.0. The output will be the
inverted input X of NOT.
ATTENTION
Both solutions do only work correctly if the input values are either 0.0000 or 1.0000!
Registers P 0
Z 0
T 0
X 0
Y 1
Input none
Result Y=C
Registers P 0
Z 0
T 0
X 0
Y 1
Input none
Result Y=C
MUL Product
Function Multiply/Sum the contents of 2 or more X registers.
79 EN2B-162GE51 R1114
RACL STATEMENTS RACL EDITOR
Registers P 0
Z 0
T 0
X 2..128
Y 1
SUM Sum
Function Sum the contents of 2 or more X registers.
Registers P 0
Z 0
T 0
X 2..128
Y 1
SUB Subtract
Function subtracts Xb from Xa
Registers P 0
Z 0
T 0
X 2
Y 2
Result Ya = Xa - Xb
Yb = abs (Xa - Xb)
EN2B-162GE51 R1114 80
RACL EDITOR RACL-STATEMENTS
Function Calculates the difference between the contents of parameter registers and X
registers and transfers the result to Y registers. Several parameter/X register pairs
can be defined in one command. Up to 128 X registers and parameters can be
processed with one NOT command.
Registers P 1..128
Z 0
T 0
X 1..128
Y 1..128
Result The difference between the X-register and the parameter is transferred to the Y
register.
Ya = Pa - Xa
TIP
If you don't want to use parameters for inversion of binary signals then use the
RNDI statement
NEG Negate
Function Transfers the contents of defined X registers in the sequence specified to the Y
registers. The sign is reversed. Up to 128 X registers can be transferred and
negated with one command.
Registers P 0
Z 0
T 0
X 1...
Y 1...
Input Xa, Xb, Xc, ... X registers in the sequence in which they are to be transferred.
Result Data from X registers are transferred to Y registers with reversed sign.
Ya = -Xa
Yb = -Xb
DIV Division
81 EN2B-162GE51 R1114
RACL STATEMENTS RACL EDITOR
Registers P 0
Z 0
T 0
X 2
Y 1
Result Y = Xa / Xb
Use a SPLT statement with one constant Ca. Ca may be any integer number from 2
to 100.
Ya = Xa mod Ca
Registers P 1..128
Z 0
T 0
X 1..128
Y 1
POL Polynomial
EN2B-162GE51 R1114 82
RACL EDITOR RACL-STATEMENTS
Function Produce a polynomial using specified parameters and X register values. The result
is transferred to the Y register. Up to 128 parameters can be entered in a POL
command.
Registers P 1..128
Z 0
T 0
X 1
Y 1
Result The result of the polynomial is transferred to the Y register. The polynomial is as
follows:
Y = (Xa + Pa) * (Xb + Pb) ...
MIN Minimum
Function Compares the contents of two or more X registers, selects the smallest value and
transfers the result to the Y register. The statements can process up to 128 X
register inputs.
Registers P 0
Z 0
T 0
X 2..128
Y 1
Input Xa, Xb, Xc, ... X registers containing the values to select the minimum.
Result The Y register contains the minimum value of the X registers compared.
MAX Maximum
Function Compares the contents of two or more X registers, selects the greatest value (MAX)
and transfers the result to the Y register. The statements can process up to 128 X
register inputs.
Registers P 0
Z 0
T 0
X 2..128
Y 1
Input Xa, Xb, Xc, ... X registers containing the values to select the maximum.
Result The Y register contains the maximum value of the X registers compared.
83 EN2B-162GE51 R1114
RACL STATEMENTS RACL EDITOR
RNDI Round
Function Rounds a decimal number to an integer. If the decimal part of the input value Xa is
less than 0.5, then it is rounded down. If the decimal part is greater than or equal to
0.5, then it is rounded up to the next integer. The result is transferred to Ya. A
second output Yb contains the result of the subtraction of Ya from a selectable
integer constant C. If C=0, then Yb contains the negative value of Ya. If C = 1, RNDI
fullfils the function of a logical inversion for binary values.
Registers P 0
Z 0
T 0
X 1
Y 2
TRN Truncate
Function Rounds the value of the X input to the next whole number and transfers this to the y
register. Several input values can be rounded with one command because a TRN
command can contain up to 128 X registers.
Registers P 0
Z 0
T 0
X 1..128
Y 1..128
EXP Exponent
Function Raise X to the power of e
Registers P 0
Z 0
T 0
X 1
Y 1
EN2B-162GE51 R1114 84
RACL EDITOR RACL-STATEMENTS
Input X
Result Y = exp(X)
LN Logarithm
Function Logarithm to the base of e
Registers P 0
Z 0
T 0
X 1
Y 1
Input X
Result Y = ln(X)
A RACL alarm will be produced calculating the logarithm of a negative number or
zero.
Registers P 0
Z 0
T 0
X 1
Y 1
Input X
I/O Statements
85 EN2B-162GE51 R1114
RACL STATEMENTS RACL EDITOR
Registers P 0
Z 0
T 0
X 0
Y 1
Input User address = Input the user address whose value is to be transferred to the next
Y register.
Result IBIT:
NBIT:
INP:
RACL Style Guide It is recommended to use INP for analog inputs/virtual points and IBIT/NBIT for
digital inputs/virtual points.
Registers P 0
Z 0
T 0
X 1
Y 0
Input User address: Input the user address of the data output point to which the value of
the X register is to be transferred.
Xa = X register containing the value to be transferred to the data point.
Result AOP:
EN2B-162GE51 R1114 86
RACL EDITOR RACL-STATEMENTS
X register value is transferred to the data point. If the data point is a digital point the
value will be truncated.
IMPORTANT
AOP may as well be used to write to digital-n-state points if a truncate
functionality is needed!
OBIT:
X register value is rounded to integer and transferred to the data point. If the value
is lower than 0 it is set to 0. E.g. if Xa is 0.75 than the value written to the data point
is 1 because the neares integer value to 0.75 is 1. If Xa is 2.3 than the value written
to the data point is 2.
IMPORTANT
OBIT does not only write 0 and 1 to data points (it’s not only one bit even if
the name suggests that)!
RACL Style Guide It is recommended to use AOP for analog outputs/virtual points and OBIT for digital
outputs/virtual points. The use of RACL outputs to pseudo pulse data points is no
good idea.
Registers P 0
Z 0
T 0
X 0
Y Number of
attributes
Input User address = Input the user address whose attribute values are to be transferred
to the next Y register.
Output One or more point attributes. The number of outputs matches the number of
attributes entered.
RIA Attributes Table The following table lists attributes that will be selectable for various point types.
Attribute text AI DI DO AO PI PA PD GA GD FP PP
Access attribute R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W
Write protection R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W
Manual value R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W
Auto value R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W
MaR/Wimum limit 1 R/W R/W
MaR/Wimum limit 2 R/W R/W
Minimum limit 1 R/W R/W
Minimum limit 2 R/W R/W
Suppress Alarm R/W R/W R/W R/W R/W R/W R/W R/W R/W
Alarm Dead Time R/W R/W
Point in Alarm R R R R R
Alarm Status R/W R/W R/W
Alarm Min/MaR/W R R
87 EN2B-162GE51 R1114
RACL STATEMENTS RACL EDITOR
Attribute text AI DI DO AO PI PA PD GA GD FP PP
Flag
Alarm_1/2 Flag R R
Critical R R R R
Hours run R/W R/W R/W
Enable Runtime R/W R/W R/W
Switch on counter R R R
Motor Runtime (open) R/W
Motor Runtime R/W
(close)
Remote Pt failed R R
Operation mode R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W
Is Slave R R
Trend log R/W R/W R/W R/W R/W R/W R/W R/W R/W
Refresh Enabled R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W
Alarm Hysteresis R/W R/W
Trend Hysteresis R/W R/W R/W R/W
Override Status R R
Broadcast Hysteresis R/W
Invisible R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W
Data Point Enabled R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W
Engineering Unit R/W R/W R/W R/W R/W R/W
Tech. Addr. Contr. R R R R R R/W R/W R
Tech. Addr. Board R/W R/W R/W R/W R/W R/W R/W R/W R/W R
Tech. Addr. Point R/W R/W R/W R/W R/W R/W R/W R
No Response R R R R R R R R R R R
Subtype R/W R/W R/W R/W R/W
Characteristic R/W R/W
AI = Analog Input
DI = Digital Input
DO = Digital Output
AO = Analog Output
PI = Pulse Input (Totalizer)
PA = Pseudo Analog
PD = Pseudo Digital
GA = Global Analog
GD = Global Digital
FP = Flexible Point
PP = Pseudo Pulse (Pseudo Totalizer)
R = Read Access (RIA)
R/W = Read (RIA) / Write (WIA) Access
EN2B-162GE51 R1114 88
RACL EDITOR RACL-STATEMENTS
Registers P 0
Z 0
T 0
X Number of
attributes
Y 0
Input All values which will be transfered from the X-Register to the attribute of one
selected datapoint. The number of inputs matches the number of attributes entered.
WIA Attributes Table The following table lists attributes that will be selectable for various point types.
Attribute text AI DI DO AO PI PA PD GA GD FP PP
Access attribute R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W
Write protection R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W
Manual value R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W
Auto value R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W
MaR/Wimum limit 1 R/W R/W
MaR/Wimum limit 2 R/W R/W
Minimum limit 1 R/W R/W
Minimum limit 2 R/W R/W
Suppress Alarm R/W R/W R/W R/W R/W R/W R/W R/W R/W
Alarm Dead Time R/W R/W
Point in Alarm R R R R R
Alarm Status R/W R/W R/W
Alarm Min/MaR/W Flag R R
Alarm_1/2 Flag R R
Critical R R R R
Hours run R/W R/W R/W
Enable Runtime R/W R/W R/W
Switch on counter R R R
Motor Runtime (open) R/W
Motor Runtime (close) R/W
Remote Pt failed R R
Operation mode R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W
Is Slave R R
Trend log R/W R/W R/W R/W R/W R/W R/W R/W R/W
Refresh Enabled R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W
Alarm Hysteresis R/W R/W
Trend Hysteresis R/W R/W R/W R/W
Override Status R R
Broadcast Hysteresis R/W
Invisible R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W
Data Point Enabled R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W
Engineering Unit R/W R/W R/W R/W R/W R/W
Tech. Addr. Contr. R R R R R R/W R/W R
Tech. Addr. Board R/W R/W R/W R/W R/W R/W R/W R/W R/W R
Tech. Addr. Point R/W R/W R/W R/W R/W R/W R/W R
89 EN2B-162GE51 R1114
RACL STATEMENTS RACL EDITOR
Attribute text AI DI DO AO PI PA PD GA GD FP PP
No Response R R R R R R R R R R R
Subtype R/W R/W R/W R/W R/W
Characteristic R/W R/W
AI = Analog Input
DI = Digital Input
DO = Digital Output
AO = Analog Output
PI = Pulse Input (Totalizer)
PA = Pseudo Analog
PD = Pseudo Digital
GA = Global Analog
GD = Global Digital
FP = Flexible Point
PP = Pseudo Pulse (Pseudo Totalizer)
EN2B-162GE51 R1114 90
RACL EDITOR RACL-STATEMENTS
Miscellaneous
Registers P 1
Z 1
T 1
X 2
Y 2
Input Xa =Xa register containing the value to trigger the timing element.
Xb = X register containing the status feedback.
Pa = Parameter number containing the delay time in seconds(set time).
Result Ya = 1 if Xa ≥ 1 and Ta ≥ Pa
Yb = 1 if Ya 1 and Xb < 1
Registers P 0
Z 0
T 0
X 2
Y 1
Result Y = 0, if Xa <Xb
Y = 1, if Xa ≥ Xb
CONT Counter
Function Adds 1 to the count when X. receives a positive change in the pulse value. The
counter is reset when Xb takes on a value greater than or equal to 1. If both
91 EN2B-162GE51 R1114
RACL STATEMENTS RACL EDITOR
conditions occur the counter reset has priority. The count is transferred to the Y
register.
Registers P 0
Z 2
T 0
X 2
Y 1
Input Xa = X register containing the value to be checked for incrementing the counter.
Xb = X register containing the value to be checked for resetting the counter.
DATE
Function Output of time, day and date to Y register. This data comes from the CPU. Output
Ya contains the current time in hours and minutes. This ranges from 0000 (midnight)
to 2359 (one minute before midnight). Output Yb contains the weekday from 1
(Monday) to 7 (Sunday). Output Yc contains the current date. This ranges from 0101
(1st January) to 1231 (31th December).
Registers P 0
Z 0
T 0
X 0
Y 1
TIP
To separate hours and minutes or month and day use the SPLT statement!
TIME
Function Output the current time in minutes after midnight.
Registers P 0
Z 0
T 0
X 0
Y 1
EN2B-162GE51 R1114 92
RACL EDITOR RACL-STATEMENTS
EQL Equal
Function Compares the value of the Xa input with the specified parameter values. If none of
the parameters are equal to Xa the output is set to 0. If at least one parameter is
equal to Xa, the output is set to 1. The number of the parameters to be specified is
variable between 1 and 128. At least one parameter must be defined. The
comparison is carried out between the truncated (integer) Xa value and the
parameter values. Decimal places to the right of the decimal point have no effect on
the comparison.
Registers P 1..128
Z 0
T 0
X 1
Y 1
IDT Identity
Function Transfers the contents of defined X registers in a defined sequence to the next Y
registers. Data is transferred in a defined sequence to the next colum. Up to 128 X
registers can be transferred with one command.
Registers P 0
Z 0
T 0
X 1..128
Y 1..128
Input Xa, Xb, Xc, ... X registers in the sequence in which they are to be transferred.
93 EN2B-162GE51 R1114
RACL STATEMENTS RACL EDITOR
Registers P 0
Z 1..128
T 0
X 1..128
Y 0
Registers P 0
Z 1..128
T 0
X 0
Y 1..128
Registers P 0
Z ?
T 0
X 2
Y 2
EN2B-162GE51 R1114 94
RACL EDITOR RACL-STATEMENTS
Z [Z register number] = Xa
Y = 0 if Z register number < Zend
Y = 1 if Z register number ≥ Zend
Registers P 0
Z ?
T 0
X 1
Y 1
Result Xa is truncated.
calculated Z register number = (Xa + C).
If (Xa + C) is greater than the highest Z register number of the module then the Z
register number is set to the highest possible Z register number.
If (Xa + C) is lower than 1 then IRCL may deliver unexpected results.
Y register contains the contents of the Z register with the calculated number.
Registers P 1
Z 2
T 1
X 1
Y 1
In all other cases, the Y output is set to the value of the preceding cycle. The
current Xa input value is transferred to Za for comparison in the next RACL cycle. Zb
95 EN2B-162GE51 R1114
RACL STATEMENTS RACL EDITOR
contains the current Y register value. Ta = Timer register containing the time in
seconds.
Registers P 1..128
Z 0
T 0
X 0
Y 1..128
Input Pa, Pb,... = Parameter numbers in the sequence in which they are to be transferred.
Registers P 0
Z 0
T 0
X 1..128
Y 0
EN2B-162GE51 R1114 96
RACL EDITOR RACL-STATEMENTS
Xa.The system clock delivers the time signals for the RTC command. The smallest
counting unit is one minute. Runtimes less than one minute are not logged.
Registers P 0
Z 2
T 0
X 2
Y 2
Registers P 0
Z 0
T 1
X 0
Y 1
Input none
Registers P 0
Z 1
T 0
X 2
Y 1
Input Xa
Xb
Result Y = 0 if Xa < Xb
Y = 1 if Xa > Xb
Y = previous state if Xa = Xb
TIP
97 EN2B-162GE51 R1114
RACL STATEMENTS RACL EDITOR
If X values are either 0 or 1 then SET can replace SETL to build a RS-Flip-Flop.
SET is a little bit faster than SETL
• Output Y maintains its status from the preceding cycle if Xa and Xb have
the same status (both 0 or both 1).
Registers P 0
Z 0
T 0
X 2
Y 1
Result The status of the output signal depends on the following conditions:
Y = 0 if Xa < 1 and Xb ≥ 1
Y = 1 if Xa ≥ 1 and Xb < 1
Y = Za if Xa < 1 and Xb < 1 or Xa ≥ 1 and Xb ≥ 1.
Za is set to the value of the Y register.
Registers P 0
Z 1
T 1
X 1
Y 0
Input Xa = X register containing the input value to be checked for a change in value.
EN2B-162GE51 R1114 98
RACL EDITOR RACL-STATEMENTS
SWI Switch
Function Conditional Transfer.Transfers the contents of one of two specified X registers to
the Y register, depending on the value of a third X register.
Registers P 0
Z 0
T 0
X 3
Y 1
Input Xa = Input 1
Xb = Input 2
Xc = Selector
Result Y = Xa if Xc ≥ 1else Y = Xb
MUX Multiplex
Function Conditional Transfer. Transfers the contents of one of n specified X registers to the
Y register, depending on the value of a third X register.
Registers P 0
Z 0
T 0
X 3..128
Y 1
Input Xa = Selector
Xb = Input 1
...
Xn = Input n
WIDO Window
Function Sets the output to 1 if the Xa input value lies between or is equal to one of the two
parameters Pa and Pb. If Xa lies outside the range defined by Pa and Pb the output
is set to 0. If Pa is greater Pb then the condition for Y=1 will never become true.
99 EN2B-162GE51 R1114
RACL STATEMENTS RACL EDITOR
Registers P 2
Z 0
T 0
X 1
Y 1
Execution time 0.688 ms
Registers P 0
Z 0
T 0
X 0
Y 1
Input User address = Input the user address whose TUNCOS information is to be
transferred to the next Y register.
Result Y keeps the data point's TUNCOS information which can be transferred like any
other values in RACL.
IMPORTANT
Don't use this value for calculations. Please just pass it on to submodules
using STO, RCL or IDT statements. You may even use SWI or MUX to
select different data point information. Any other operations may have
unpredictable results.
Program Flow
Registers P 0
Z 0
T 0
X 0
Y 0
Input none
Registers P 0
Z 0
T 0
X 1
Y 0
Result RACL program execution continues at desired column if the condition was true
otherwise execution continues after the skip statement.
Result The contents of the X registers from the Main Module are transferred into the X
registers of the submodule. When the submodule is recalled, it processes the
specified parameters and the contents of the X registers. The END command
terminates the submodule, transfers the contents of the Y registers of the
submodule to the Y registers of the Main Module (M0), and returns to the Main
Module.
Registers P 0
Z 0
T 0
X depends on
submodule
Y depends on
submodule
IMPORTANT
This statement is generated automatically and not visible in a RACL
flowchart
Result The program sequence is interrupted until restarted after the defined RACL cycle
time has expired.
IMPORTANT
This statement is generated automatically and not visible in a RACL
flowchart
Registers P 0
Z 0
T 0
X depends on the submodule
Y depends on the submodule
Input Ya, Yb, ... = Y registers of the submodule which are to be transferred to the Main
Module.
NOTE: With the old RACL Editor it was possible to define the order of submodule
Y register outputs with an END statement. This is no longer possible with
the new RACL editor. The workaround is to insert one more column and to
sort outputs using an IDT statement.
Result Contents of the Y registers of the submodule are transferred to Y registers in the
Main Module.
NOP No Operation
Function No operation
Registers P 0
Z 0
T 0
X 0
Y 0
Input none
Result none
RACL Style Guide It is recommended not to use the NOP statement because it is not necessary to
have it as RACL code is edited by using the RACL-Editor.
Configuration Statements
Registers CP 1..128
Z 0
T 0
X 0
Y 1..128
Input Pa, Pb,... = Parameter numbers in the sequence in which they are to be transferred.
Registers CP 1..128
Z 0
T 0
X 1..128
Y 0
Registers P 0
Z 0
T 0
X 2..128
Y 2
Each X register value is rounded up to an integer value and limited to the allowable
value range 0 ... base-1. Number of inputs must be limited so that register Ya won’t
23
be >= 2 in order to guarantee clear data recovery.
Example:
ba = 2, bb = 4, bc = 4, bd = 3
Xa = 1, Xb = 2, Xc = 3, Xd = 1
Ya = Xa + Xb*ba + Xc*ba*bb + Xd*ba*bb*bc
Ya = 1 + 2*2 + 3*2*4 + 1*2*4*4
Ya = 1 + 4 + 24 + 32 = 61
Application example:
MRG and SPLT are needed for handling of configuration parameters. They are
reverse working statements. Statement MRG summarizes the number of
parameters, e. g. from several heating circuits, in only one Y register. This
Y register may be transferred to a submodule where the parameters will be
extracted with statement SPLT.
Registers P 0
Z 0
T 0
X 1
Y 1..128
Input Xa = several input values compressed by statement MRG into only one value
ba, [bb ...] = constants, possible value range: 2-100
Result Ya, Yb, ... = The number of outputs depends on the number of constants (ba, [bb ...])
Ya = Xa mod ba
Yb = ((Xa-Ya) / ba) mod bb
Yc = (((Xa-Ya) / ba) -Yb) / bb) mod bc
Yd = ((((Xa-Ya) / ba) -Yb) / bb) -Yc) / bc) mod bd
...
Example:
The following example corresponds to the example listed above by the description
of statement MRG.
Xa = 61, ba = 2, bb = 4, bc = 4, bd = 3
Ya = Xa mod ba
Ya = 61 mod 2 = 1
Yb = ((Xa-Ya) / ba) mod bb
Yb = ((61-1) / 2) mod 4 = 2
Errors
Warnings
Information
Errors
Errors
Warnings
Errors
Warnings
Dialogs
Errors
The following errors displayed in dialog boxes are listed alphabetically:
Cause for the error The group button is clicked and there are no statements within the
specified group whose RACL Feature version is less than the RACL
Feature version set in the INI file
Error Correction Change the RACL Feature version set in the INI file and invoke the RACL
Editor again.
Cause for the error The attribute text file is not in the path specified in the INI file.
Error Correction • Copy the attr_txt.txt file at the location specified in the INI file
• Update the INI file entry to the path were the attr_txt.txt file is present.
Cause for the error A wrong destination column number was specified for a SKP, SKZ or
SKU statement.
Error Correction The valid column values ranges between the current column number + 1
to 255.
Cause for the error • The number of T registers set for the statement in the modify dialog is
greater than 128
• The number of Z registers set for the statement in the modify dialog is
greater than 128
• The number of Parameters set for the statement in the modify dialog
is greater than 128
• The T register index set for the statement is greater than 128
• The Z register index set for the statement is greater than 128
Error Correction • The T register count for the statement should be less than or equal to
128
• The Z register count for the statement should be less than or equal to
128
• The Parameter count for the statement should be less than or equal to
128
• The T register index set for the statement should be less than 128
• The Z register index set for the statement should be less than 128
Cause for the error Not enough memory was available to perform the clipboard operation
Error Correction Close some of the applications and perform the operation again.
Cause for the error There is not enough space on the secondary storage to store the RML
file
Error Correction Make enough secondary storage space.
Cause for the error The application could not find the resource Dynamic Link Library (DLL).
Error Correction The resource DLL for the RACL Editor application should be in the same
location as the PCBRACL.EXE executable.
Cause for the error The IPG file corresponding to the project cannot be read.
Error Correction One of the problems mentioned for the IPL file would have occurred
Cause for the error The .PHX file for the project is missing
Error Correction Copy the .PHX file of the project to which the module belongs, into the
project directory.
Cause for the error The IPG.EXE is not in the current directory as the PCBRACL.EXE
Error Correction Copy the IPG.EXE into the correct location
Cause for the error Unable to clear the clipboard off its original contents
Error Correction Clear clip board from the clip board viewer application
Cause for the error Unable to open the clipboard for copying the contents of the cut or
copied statements. The size of the statements cut or copied is very large.
Error Correction Try copying or cutting smaller statement groups from the flow chart
Cause for the error Unspecified error code returned by the IPG.EXE while creating the .IPG
file from the .IPL file
Error Correction Check the version on the IPG.EXE and the format of the .IPL file and
.KDX file used to create the .IPG file
Cause for the error The feature version with which the source file was created is greater than
the feature version currently set in the INI file.
Error Correction Update the feature version set in the INI file such the feature version is
less than or equal to the feature version of the source file
Cause for the error Tried to save the current save to itself using the SaveAs command.
Error Correction A source file cannot be save to itself. Select a different target directory.
Cause for the error The command line specified for the RACL Editor is not correct.
Error Correction Provide the correct command line argument for the RACL Editor. (For the
command line arguments and their meaning please refer the )
Cause for the error Trying to connect output(s) and input(s) of statements which are not
adjacent to each other.
Error Correction Only outputs and inputs of statements in adjacent columns can be
connected.
Cause for the error The value entered into the Value field of the Parameter Edit dialog box
or the Parameter Assign dialog box is not in the range of the minimum
and maximum value set for the parameter.
Error Correction The value entered into the Value field of the Parameter Edit dialog box
or the Parameter Assign dialog box should be greater than or equal to
the minimum value and less than or equal to the minimum value set for
the parameter.
Cause for the error The User Address Name string entered in the XFM User Address dialog
box is not valid.
Error Correction Enter a valid text string for the XFM User Address dialog box.
Cause for the error Trying to add statements into the column which already has 256
statements
Error Correction • There is an upper limit of 256 statements per column in the flow chart
• Delete some of the existing statements in the column and add
statements into the column again.
Cause for the error Trying to open a new window when there are already ten windows opened.
Error Correction Close some of the windows and try opening again.
Cause for the error There is not enough memory to perform the operation
Error Correction Close some of the existing applications and try again
Cause for the error Trying to paste multiple statements into the flow chart.
Error Correction Select either the top or bottom of the flow chart for the pasting of multiple
statements. Multiple statements cannot be pasted in between statements
in the flow chart, only single statements can be pasted at any position in
the flow chart.
Cause for the error Columns can only be inserted between two existing columns.
Error Correction • Try inserting the column between any two existing columns
• Add the statement at the position where the column needs to be
inserted.
Cause for the error Selecting SLEV statement mnemonic from the statement selection box and
placing it into the flow chart.
Error Correction It is not possible to add a SLEV statement. The RACL Editor adds a SLEV
statement at the end of each column during translation.
Cause for the error The .IPL file used to create the .IPG file is not present
Error Correction Check if the .IPL file for the project whose module is being edited is
available.
Cause for the error There is not enough memory in the system
Error Correction Close some executing applications
Cause for the error A wrong or invalid file name was specified for the .MCS file
Error Correction The file name of XFM source must end with .MCS
Cause for the error The page size selected on the Print Setup dialog is too small for
printing reports.
Error Correction Select a bigger page size using the Print Setup dialog.
Cause for the error • No submodule index was selected in the Modify dialog box.
• No parameter file index was selected in the Modify dialog box.
Error Correction • Select a submodule index in the Modify dialog box.
• Select a parameter file index in the Modify dialog box.
Cause for the error The User Addr combo box of the Parameter dialog box has no
selection.
Error Correction Select a user address string in the User Addr combo box.
Cause for the error The difference between the destination skip column and the current
column in which the statement is placed is greater than 127.
Error Correction Enter the destination column such that the difference between the current
column and the destination column is less than 127.
Cause for the error The MUSCROLL.DLL (used for the spin fields in the dialog) is not
present in the search path of the application.
Error Correction Copy the MUSCROLL.DLL into the current directory of the RACL Editor
application (PCBRACL.EXE)
Cause for the error The statement definition file (statdef.txt) could not be found.
Error Correction Check the location where the statement definition file is present.
Check the ExecPath entry under the [General] section of the INI file. The
RACL Editor loads the statement definition file from this location.
Cause for the error Trying to add statements with X registers into the first column of the main
module
Error Correction It is not possible to place statements with X registers into the first column
of the main module.
Place statements which do not have any X registers
Cause for the error • The size of loadable files created exceeds 64 kilo bytes.
Error Correction • The total size of the loadable file should be less than or equal to 64K.
Delete some of the statements from the source file.
Cause for the error A paste operation is trying to paste a column whose index is more than
255.
Error Correction Delete a few columns from the end of the flow chart and try Insert
operation again.
Cause for the error Tried to add more than 128 user addresses for a given type in the XFM
User Address dialog box.
Error Correction Only a maximum of 128 user addresses per type can be added for the
XFM sources.
Cause for the error The value set in the Minimum field is greater than the value set in the
Maximum field.
Error Correction The value set in the Minimum field should be less than or equal to the
value set in the Maximum field.
Cause for the error The number of inputs and outputs set in the XFMmaxX and XFMmaxY in
the INI file is more than 20.
Error Correction The maximum limit of inputs and outputs is set to 20. Only this range is
supported in the XFM I/O dialogs.
Decrease the number set in the XFMmaxX and XFMmaxY entries of the
INI file.
Cause for the error • The number of X registers of the submodule is greater than the
number set in the XFMmaxX value entry of the INI file.
• The number of Y registers of the submodule is greater than the
number set in XFMmaxY value entry of the INI file.
Error Correction • The number of X registers in the first column of the submodule should
be less than or equal to the value set in the XFMmaxX entry of the INI
file.
• The number of Y registers in the last column of the submodule should
be less than or equal to the value set in the XFMmaxY entry of the INI
file
Cause for the error The new statement added into the source file uses T registers and the
number of T registers available is zero.
Error Correction Delete some statements which use T registers
Cause for the error The number of X registers per column of RACL source files is less than
or equal to 128
Error Correction -----
Cause for the error The number of X registers per column of RACL source files is less than or
equal to 128
Error Correction -----
Cause for the error The new statement added into the source file uses Z registers and the
number of Z registers available is zero.
Error Correction Delete some statements which use Z registers
Cause for the error The PHX file to be used by XFM source is not available at the
location specified in the INI file
Error Correction • Copy the PHX file to the location specified in the INI file
• Update the PHX file path in the INI file
Cause for the error Trying to add a statement like MCAL into a submodule or XFM source.
Error Correction Statements like MCAL statement can only be added to a main module. It
cannot be added to a submodule or XFM source file.
Cause for the error Trying to place a statement which takes submodule index (like MCAL)
into an XFM source (.MCS) file
Error Correction It is not allowed to place any statements, which have a submodule index
as its parameter, into the XFM source files.
Cause for the error The IPG file could not be created from the .IPL file
Error Correction The file could be corrupted or invalid.
Cause for the error The User Address string entered in the XFM User Address dialog box is
not unique. A User Address entry with the same name already exists
Error Correction All the entries in the XFM User Address list for the XFM Source should
be unique.
Enter a unique name.
Information To get the confirmation from the user for the delete of the
current source file.
/s Stand-alone
/path= Default path for open and save
/p= Project Name
/c= Controller Name
/cnum= Controller Number (1..30)
The RACL Editor uses RACL.INI file for obtaining set up values. The section in the
INI file and their meaning are:
Each of the above mentioned section has entries which have specific use for the
RACL Editor. These entries and their function (or meaning) are tabulated below:
loadable file
MinimumOSVersion [Featuren] The minimum required OS version.
PasteOption [Editor] The option to be used when pasting
statement on the source file window
PHXFileLocation [General] The path for the .PHX used by XFM
source files
RACLfeatures [General] The current RACL Feature version.
Based on this the appropriate
[Featuren] section of the INI file is
read.
RACLFeatureVersion [Featuren] The feature version of the RACL
Editor
RAGConvert [General] The path for the EXTRACT.EXE
which is used to convert files from the
old .RAG format to the new RACL
format used by RACL Editor
RALFileFormat [Featuren] The format of RAL file
RAPFileFormat [Featuren] The format of RAP file
StandAlone [General] Specified whether stand-alone mode
is allowed or not
WarningLevel [Translator] The warning level used during
translation and re-translation.
XFMmaxX [General] The maximum allowed inputs for XFM
source
XFMmaxY [General] The maximum allowed outputs for
XFM source
Default Values
INDEX
Submodule 13
XFM 14
A Cursor shapes 11
Abbreviations 1 Cutting
About dialog 12 Statements from the flow chart 27
Access lists
Printing 44 D
ADAH
Statement description 49 DATE
Adaption of the Heating Curve Parameters Statement description 84
Statement See ADAH, ADH2 See ADAH, ADH2 Default values 119
Adding Deleting
Statements into the flow chart 16 Entry of the parameter file 32
See SUM Source file 42
ADH2 Statements from the flow chart 28
Statement description 50 XFM user adress 34
AOP Derivative
Statement description 78 Statement See DIFT
Arithmetic Difference Description text
Statement See NOT Editing 33
Arithmetic Statements 70 DEWP
Attributes Statement description 61
Searching for ... 35 Dewpoint
Attributes Statement See DEWP
Modifying 30 Dialog
Errors 103
DIFT
C Statement description 68
CDEL DIV
Statement description 83 Statement description 74
Color Division
of statements selected from output window 37 Statement See DIV
of statements with unassigned inputs 37 DUC
of statements with unassigned parameters 36 Statement description 62
Columns
Inserting into the flow chart 28 E
Selecting in the flow chart 25
Command Line 118 Editing
Command line options 118 I/O definitions 33
COMP Parameter of a source file 32
Statement description 83 XFM description text 33
Conditional Skip XFM user adress 34
Statement See SKP, SKZ END
Conditional Transfer Statement description 94
Statement See SWI End Main Module
Configuration Statements 96 Statement See END
Constants End Submodule
Setting for the statement 20 Statement See END
CONT Ending
Statement description 84 RACL Editor 12
12 Energy Management Statements 49
Contol Statements 64 Energy Optimized Heating
Controlled Alarm Delay Statement See EOH, EOH2 See EOH, EOH2
Statement See CDEL Energy Optimized Ventilation
Copying Statement See EOV, EOV2 See EOV, EOV2
Statements from the flow chart 27 ENT
Counter Statement description 61
Statement See CONT Enthalpy
CPAR Statement See ENT
Statement description 96 EOH
Creating Statement description 52
Main module 13 EOH2
U
Unconditional Skip
Statement See SKU
UNDO
to revert last operation 29
User adress
Deleting 34
Editing 34
ReAssign 39
Searching for ... 35