En2b0162 Ge51r1114

Honeywell
RACL Editor
HONEYWELL EXCEL 5000 OPEN SYSTEM
USER GUIDE
EN2B-162 GE51 R1114

Trademark Information Echelon, LON, LONMARK, LONW ORKS, LonBuilder, NodeBuilder, LonManager,
LonTalk, LonUsers, LonPoint, Neuron, 3120, 31701, the Echelon logo, the LonMark
logo, and the LonUsers logo are trademarks of Echelon Corporation registered in
the United States and other countries. LonLink, LonResponse, LonSupport, and
LonMaker are trademarks of Echelon Corporation.
BACnet is a registered trademark of the American Society of Heating, Refrigerating

and Air-Conditioning Engineers, Inc.
Microsoft and Windows are registered trademarks of Microsoft Corporation. Other

brands and their products are trademarks or registered trademarks of their
respective holders and should be noted as such.
EN2B-162GE51 R1114 Copyright © 2010 Honeywell Inc. • All Rights Reserved

RACL Editor
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
SYSTEM REQUIREMENTS ............................................................................................................................. 13
INSTALLATION ............................................................................................................................. 14
STARTING THE RACL EDITOR ............................................................................................................................. 14
THE RACL SCREEN ............................................................................................................................. 15

Menus................................................................................................................... 16
Main Tool Bar ....................................................................................................... 16
Statement Group Tool Bar ................................................................................... 16
Statement Selection Drop Down List.................................................................... 17
Module Name Field .............................................................................................. 17
Source File Window ............................................................................................. 17
Status Bars ........................................................................................................... 18
Output Window..................................................................................................... 18
Cursor Shapes ..................................................................................................... 19
Modifying the Zoom Factor................................................................................... 20
ENDING THE RACL EDITOR ............................................................................................................................. 20
STEP-BY-STEP INSTRUCTIONS ............................................................................................................................. 21

Creating a new Main Module ................................................................................ 21
Creating a new Submodule .................................................................................. 21
Creating a new XFM ............................................................................................. 22
Opening an existing Mainmodule or Submodule.................................................. 23
Opening an existing XFM Source ......................................................................... 24
Adding Statements into the Flow Chart ................................................................ 24
Setting the User Address for the Statement .................................................... 25
Setting Parameters for the Statement ............................................................. 26
Setting Z Registers for the Statement ............................................................. 27
Setting the T Register for the Statement ......................................................... 27
Setting Constants for the Statement................................................................ 28
Setting the Attribute for the WIA / RIA Statement ........................................... 29
Setting the Submodule and Parameter File Index for the Statement .............. 31
Connecting Inputs and Outputs of Statements .................................................... 31
Selecting Statements in the Flow Chart ............................................................... 32
Selecting a single Statement ........................................................................... 32
Selecting multiple Statements randomly ......................................................... 32
Selecting multiple Statements which are in Sequence .................................... 33
Select a complete Column .............................................................................. 33
Selecting multiple Columns randomly ............................................................. 34
Selecting multiple Columns in Execution Sequence ....................................... 34
Cutting Statements from the Flow Chart .............................................................. 35
Copying Statements from the Flow Chart ............................................................ 35
Pasting Statements into the Flow Chart ............................................................... 35
Pasting Statements to the Beginning of the Column ....................................... 35
Pasting Statements to the End of the Column................................................. 35
Pasting a single Statement at any Place on the Flow Chart............................ 36
Moving Statements in a Column .......................................................................... 36
Deleting Statements from the Flow Chart ............................................................ 36
Inserting Columns into the Flow Chart ................................................................. 36
Reverting the last Operation performed on the Flow Chart .................................. 37
5 EN2B-162GE51 R1114
CONTENTS RACL EDITOR
Modifying the Attributes of the Statements on the Flow Chart ............................. 38

Saving and Translating the Source Files ............................................................. 38
Editing Parameter for a Source File ..................................................................... 40
Adding new Parameters to the Parameter File ............................................... 40
Modifying an existing Parameter of the Parameter file .................................... 40
Deleting the existing Entry of the Parameter File ............................................ 40
XFM source file .................................................................................................... 41
Assigning I/O Definitions for the Source File ................................................... 41
Editing XFM Description Text for the Source File............................................ 41
Editing XFM User Address for the XFM Source .............................................. 42
Adding new XFM User Address for the XFM Source.................................. 42
Modifying an existing XFM User Address Entry.......................................... 42
Deleting an existing XFM User Address Entry............................................ 42
Searching in the Flow Chart ................................................................................. 42
Searching for a Parameter, a Z-Register, or a Timer Register........................ 43
Searching for a User Address ......................................................................... 43
Searching for Statements ................................................................................ 43
Setting RACL Flags for the Main Module ............................................................. 44
Setup Editor Options ............................................................................................ 44
Updating the Color for Statements with unassigned Parameters.................... 44
Updating the Color for Statements with unassigned Inputs ............................ 45
Updating the Color for Statements selected from the Output Window............ 45
Saving the current Source File as a different Source File .................................... 45
Saving a Main Module as a Main Module of another Project .......................... 45
Saving a Submodule as another Submodule .................................................. 46
Saving a Submodule as a XFM Source .......................................................... 46
Saving a XFM Source as a Submodule .......................................................... 47
Saving the Current Project as a different Project ................................................. 48
Previewing the current Flow Chart ....................................................................... 49
Deleting the current Source File .......................................................................... 50
Deleting a current Submodule or XFM Source File ......................................... 50
Deleting a current Main Module ...................................................................... 50
Printing the Flow Chart......................................................................................... 51
Retranslating the RACL loadable Files ................................................................ 52
Retranslating the XFM’s ....................................................................................... 53
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
SUM Sum ........................................................................................................ 80

SUB Subtract ................................................................................................... 80
NOT Arithmetic Difference............................................................................... 80
NEG Negate .................................................................................................... 81
DIV Division ..................................................................................................... 81
Modulo Division Using SPLT ........................................................................... 82
LIN Linear Product........................................................................................... 82
POL Polynomial ............................................................................................... 82
MIN Minimum .................................................................................................. 83
MAX Maximum ................................................................................................ 83
RNDI Round .................................................................................................... 84
TRN Truncate .................................................................................................. 84
EXP Exponent ................................................................................................. 84
LN Logarithm ................................................................................................... 85
SQRT Square Root ......................................................................................... 85
I/O Statements ..................................................................................................... 85
Inputs (INP, IBIT, NBIT) ................................................................................... 85
Outputs (AOP, OBIT) ....................................................................................... 86
Miscellaneous ...................................................................................................... 91
CDEL Controlled Alarm Delay ......................................................................... 91
COMP Logical Comparison ............................................................................. 91
CONT Counter ................................................................................................. 91
DATE ............................................................................................................... 92
TIME ................................................................................................................ 92
EQL Equal ....................................................................................................... 93
IDT Identity ...................................................................................................... 93
STO Store Value in Z Register ........................................................................ 93
RCL Recall Z Register ..................................................................................... 94
ISTO Indexed Store ......................................................................................... 94
IRCL Indexed Recall ........................................................................................ 95
MTIM Monoflop Timer ...................................................................................... 95
PAR Read Parameter ...................................................................................... 96
SPR Set Parameter ......................................................................................... 96
RTC Time Counter .......................................................................................... 96
RTIM Read Timer ............................................................................................ 97
SET "Set Output" ............................................................................................. 97
SETL RS Flip-Flop ........................................................................................... 98
STIM Set Timer................................................................................................ 98
SWI Switch ...................................................................................................... 99
MUX Multiplex.................................................................................................. 99
WIDO Window................................................................................................. 99
TUNC Time Until Next Change Of State ......................................................... 100
Program Flow ....................................................................................................... 101
SKU Unconditional Skip .................................................................................. 101
SKP, SKZ Conditional Skip ............................................................................. 101
MCAL Submodule Call .................................................................................... 101
SLEV Next Column .......................................................................................... 102
END End Main Module .................................................................................... 102
END End Submodule ...................................................................................... 102
NOP No Operation .......................................................................................... 103
Configuration Statements ..................................................................................... 104
CPAR Read Configuration Parameter ............................................................. 104
SCPR Set Configuration Parameter ................................................................ 104
MRG Merge Values ......................................................................................... 104
SPLT Split Values............................................................................................ 105
APPENDIX ............................................................................................................................. 107

RACL Source Translation Outputs ....................................................................... 107
Errors ............................................................................................................... 107
Warnings ......................................................................................................... 108
Information ...................................................................................................... 108
RACL Loadable Retranslation Outputs ................................................................ 109
Errors ............................................................................................................... 109
XFM Source Translation Outputs ......................................................................... 110
Errors ............................................................................................................... 110
Warnings ......................................................................................................... 110
XFM Loadable Retranslation Errors ..................................................................... 111
Errors ............................................................................................................... 111
Warnings ......................................................................................................... 111
7 EN2B-162GE51 R1114
CONTENTS RACL EDITOR
Dialogs ................................................................................................................. 111

Errors .............................................................................................................. 111
Information and Warnings ............................................................................... 125
Command Line Options ....................................................................................... 126
Initialization (INI) File Entries. .............................................................................. 126
Default Values ...................................................................................................... 127
INDEX ............................................................................................................................. 128
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 Structure of a RACL Program

A RACL Program is associated to a Program Administration File (.PRA). The PRA
file defines the Application Program Name, Controller Name and Controller Number
for the entire RACL source files created. The entire RACL program is associated as
a project, the PRA file being the link for the project. Each project consists of one
main module (*.M00) and up to 128 submodules (1 to 127). The structure of the
main module and each submodule is very similar except for a few limitations of the
submodule. Each submodule provides the total strategy logic for a special plant
component e. g. a heater or a cooler. The main module provides communication
functions for the submodules by using the special MCAL statement (Module Call).
Only the main module can use the MCAL statement. Each submodule of the project
is defined as stand-alone module independent of the others and communicates via
the main module.
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:
• Arithmetic and Logic Statements

• Control Statements
• Energy Management Statements
• Miscellaneous Statements
• Configuration Statements
• Input Output Statements
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:
• Maximal 255 columns

• Maximal 1024 statements per column
• Maximal 128 X registers per column
• Maximal 128 Y registers per column
• Maximal 128 P registers per column
• Maximal 128 Z registers per column
• Maximal 128 T registers per column
• The MCAL statement used to call the submodule can only be added into the
main module.
The Structure of an Excel Functional Module (XFM) file

An XFM source is similar to the RACL source file except for a few differences listed
below:
• 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
The Flow Chart
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
The following figure shows schematically an example for processing.
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.
Communication between Main Module and Submodules

Submodules can be generated to meet the specific requirements of individual
applications. An application-specific submodule can, therefore, be generated if a
particular task occurs repeatedly. This submodule can be called up any number of
times from the main module. It is possible to create a library of submodules so that
these can also be used in other main modules.
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
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.
NOTE: SLEV as well as END statements are added automatically by the

Translator.
SYSTEM REQUIREMENTS
To install RACL Editor, you need to have the following hardware and software
respectively:
Minimum Required Recommended

Hardware
Computer IBM PC or 100%-compatible with an IBM PC or 100%-compatible
80486DX 33 MHz processor or with a Pentium 90 MHz
better processor or better
RAM 24 MB 32 MB
Free Hard Disk Space 2 MB 4 MB
Display / Monitor VGA (640x480) 1024x768 with 256 colors
Software
Operating System Windows 3.1 Windows 95
13 EN2B-162GE51 R1114
INSTALLATION
See Installation chapter in the CARE User Guide.
STARTING THE RACL EDITOR

The RACL Editor can be executed from CARE. When the RACL Editor is
invoked from CARE, it requires additional command line parameters which
are necessary for setting up the default values in the RACL Editor. The
command line parameters required are described in detail in the Appendix
chapter. If the RACL Editor is invoked from CARE with the appropriate
command line arguments, it validates the values of Path, Project Name,
Controller Name and the Controller Number value set in the command line
argument. The following dialog is displayed.
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
THE RACL SCREEN

After starting the RACL Editor the RACL screen is displayed. Screen
The RACL screen shows the following elements:
• 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
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
The main tool bar shows the following buttons:
Creates a new RACL or XFM source file.
Opens an existing RACL or XFM source file.
Saves the currently opened source file.
Cuts the currently selected statement(s).
Copies the currently selected statement(s).
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
Opens the Zoom dialog box, to set the zoom factor
Opens the Setup dialog box to edit settings
Prints the flow chart shown in the active window.
Shows the About dialog of the RACL Editor.
Statement Group Tool Bar

The statement group tool bar provides six statement groups by clicking on the
appropriate button, given below:
ARITHMETIC AND LOGICAL statement group
CONTROL statement group
EN2B-162GE51 R1114 16
ENERGY MANAGEMENT statement group
MISCELLANEOUS statement group
CONFIGURATION statement group
I/O statement group
Statement Selection Drop Down List

The statement selection drop down list lists all the statements available of the group
that has been selected by clicking the appropriate group button.
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”.
Module Name Field

The Module Name field is shown next to the statement selection drop down list. It is
used to set the internal module name of the active source file. When opening or
creating a main or submodule by the appropriate File menu commands the Internal
Module Name being set is shown automatically.
Source File Window

The source file window is used for editing the flow chart of the RACL or XFM source
file. There can several source file windows be opened showing different flow charts.
17 EN2B-162GE51 R1114
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
The lower status bar displays the following:
• 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:
• Translation errors, warning and information

• Contents of the RML file after the translation of the RACL main module
• Retranslation errors or warnings
• Results of the search operation performed on the current source file
EN2B-162GE51 R1114 18
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:
Cursor shape Cursor name Operation mode

NORMAL The editor is in normal mode
HAND Ready to insert a column
UP ARROW The cursor is at the bottom of the

column
DOWN ARROW The cursor is at the top of the
column
CROSS Connection is in progress
HAND CARRYING BOX Ready to place a statement in the

current column
HAND CARRYING BOX Ready to place a statement in the

next column
RIGHT ARROW Input pin can be selected
19 EN2B-162GE51 R1114
Modifying the Zoom Factor

NOTE: The RACL Editor can be set in any zoom factor from 2 to 8. The default
zoom factor is 3. Zoom factors 7 and 8 do not allow editing in the source
file window.
1. Select Zoom from the View menu.

2. The Zoom dialog box appears.
3. Set the zoom factor required by either directly editing the value or by using the
up and down arrows.
4. Confirm by clicking OK.

5. The flow charts are updated and viewed with the currently set zoom
factor.
ENDING THE RACL EDITOR

1. Save all project files and source files edited.
2. Double-click the upper left system menu.
or
3. Choose Exit from the File menu.
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.
Creating a new Submodule

NOTE: Each RACL project can have up to 127 submodule source files
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.
2. Choose the Sub Module radio button.
21 EN2B-162 GE51 R1010

STEP-BY-STEP INSTRUCTIONS RACL EDITOR
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
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.
Creating a new XFM

NOTE: The XFM module can exist as a stand-alone module.
1. Click the New button on the main tool bar or select New from the File
menu.The New dialog box appears.
2. Select the XFM Source radio button.

EN2B-162GE51 R1114 22
RACL EDITOR STEP-BY-STEP INSTRUCTIONS
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
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.
Opening an existing Mainmodule or Submodule

1. Click the Open button on the main tool bar or select Open from the File menu.
The Open dialog box appears.
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
/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
Opening an existing XFM Source

1. Click the Open button on the main tool bar or select Open from the File menu.
The Open dialog box appears.
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.
Adding Statements into the Flow Chart

A RACL or XFM Source file consists of a control strategy in the form of a flow chart.
This flow chart represents the complete flow of the logic. Each flow chart has the
following limitations which must be observed when editing the flow chart:
• Maximal 255 columns

• Maximal 256 statements per column
• Maximal 128 X registers per column
• Maximal 128 Y registers per column
• Maximal 128 P registers per column
• Maximal 128 Z registers per column
• Maximal 128 T registers per column
• The MCAL statement used to call the submodule can only be added into the
main module.
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:
ARITHMETIC AND LOGIC statement group
CONTROL statement group
EN2B-162GE51 R1114 24
ENERGY MANAGEMENT statement group
MISCELLANEOUS statement group
CONFIGURATION statement group
I/O statement group
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”.
To add a statement into the flow chart:
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.
Setting the User Address for the Statement

1. Select the user address string listed in the User Address drop down list.
25 EN2B-162GE51 R1114
Setting Parameters for the Statement
1. Click the Parameters... button in the Modify... dialog box.
The Parameter Assignment dialog box appears.
2. Select a parameter in the upper Statement section and a parameter in the

below P -- File section.
3. Click the Assign button to assign the parameter selected in the P – File
section to the parameter selected in the Statement section.
4. To assign the successive parameter in the Statement section, click the Assign
button. The next parameter in the Statement section and P – File section is
selected automatically. If the parameter of the P – File section was assigned
previously, the selection in the P – File section is automatically removed.
EN2B-162GE51 R1114 26
Setting Z Registers for the Statement

If the number of Z registers required by the statement is less than four, fields are
displayed for entering the Z register indexes. Each field corresponds to the Z
register required by the statement.
1. Enter the Z register index into the appropriate field.
2. Confirm by clicking OK. If the number of Z registers required by the statement

is more than or equal to four, a list box field is displayed for assigning the Z
register index to the statement.
3. The number of entries in the list box corresponds to the number of Z registers
required by the statement.
4. To assign the Z register index, select the entry.
5. Confirm the assignment of the register index by clicking Assign.
Setting the T Register for the Statement
27 EN2B-162GE51 R1114
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.
1. Enter the T register index into the appropriate field.

2. Confirm by clicking OK. If the number of T registers required by the statement
is more than or equal to four, a list box field is displayed in the dialog box to
assign the T register index for the statement.
The number of entries in the list box corresponds to the number of T registers
3. To assign the T register index, select the entry.

4. Confirm the assignment of the register index by clicking Assign.
Setting Constants for the Statement

If the number of constants required by the statement is less than four, fields are
displayed in the dialog box for entering the value of the constants.
EN2B-162GE51 R1114 28
Each field corresponds to the constant required by the statement.
1. Enter the value of the constant into the appropriate field.

2. Confirm the assignment of the constants to the statement by clicking OK. If the
number of constants required by the statement is more than or equal to four, a
list box field is displayed in the dialog box to assign the values of the constants
for the statement.
The number of entries in the list box corresponds to the number of constants
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.
Setting the Attribute for the WIA / RIA Statement

1. Select the user address from the User Address drop down list for the WIA /
RIA statement and enter the number of attributes required for the WIA/ RIA
statement.
.
29 EN2B-162GE51 R1114
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
Setting the Submodule and Parameter File Index for the Statement
1. Click on the submodule index which is required to be assigned.
2. Click on the parameter file index which needs to be assigned.

3. Confirm the dialog box for assigning the value to the statement.
4. Enter the values required by the statement in the statement Modify dialog box
and confirm by clicking OK. The statement block is displayed at the position
where the statement was placed in the source file window.
Connecting Inputs and Outputs of Statements

NOTE: Only inputs and outputs of adjacent statements can be connected. The
same output from a statement can be connected to multiple inputs of
adjacent statements. Connections can only be made from left to right,
which means that you have to start with the output of the left positioned
statement of two adjacent statements and connect it to the input(s) of the
second statement.
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
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.
Selecting Statements in the Flow Chart
Selecting a single Statement

1. To select a single statement, click over a statement using the left mouse key. A
statement selected is shown framed.
Selecting multiple Statements randomly

1. Press CTRL.
2. With left mouse key, click all the statements, which need to be selected. All
clicked statements are shown framed.
EN2B-162GE51 R1114 32
Selecting multiple Statements which are in Sequence

1. Press SHIFT.
2. With left mouse key, click over the first statement of the statement sequence
that needs to be selected.
3. With left mouse key, click over the last statement of the statement sequence
that needs to be selected. All the statements which are in between the
statements selected are shown framed.
Select a complete Column

1. Move the cursor to the top of the column to be selected till the DOWN ARROW
cursor is displayed. The DOWN ARROW cursor indicates that the top of the
column is reached.
33 EN2B-162GE51 R1114
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.
Selecting multiple Columns randomly

1. Press CTRL.
column is reached.
3. When the cursor shape is DOWN ARROW, with left mouse key click all the
columns, which need to be selected. All the statements of the appropriate
columns get selected and are shown framed.
Selecting multiple Columns in Execution Sequence

1. Press SHIFT.
column is reached.
3. When the cursor shape is DOWN ARROW, with left mouse key click the first
column, which need to be selected.
4. Click the last column. All the columns between the first and the last column are
selected. The statements of the appropriate columns are shown framed.
EN2B-162GE51 R1114 34
Cutting Statements from the Flow Chart

NOTE: Cutting statements from the flow chart writes the text form of the
statements into the clipboard. Each empty column of the flow chart is
written as SLEV.
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:
a. Select Cut from Edit menu.

b. Use CTRL + X combination. (changed the order!!!!)
c. Use SHIFT + DEL combination.
The selected statement(s) are removed from the flow chart.
Copying Statements from the Flow Chart

NOTE: Copying statements from the flow chart writes the text form of the
statements into the clipboard. Each empty column on the flow chart is
written as SLEV.
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:
a. Select Copy from Edit menu.

b. Use CTRL + C combination.
c. Use CTRL + INS combination.
The selected statements are copied from the flow chart.
Pasting Statements into the Flow Chart

NOTE: The last cut or copied statements are pasted into the flow chart.
Pasting Statements to the Beginning of the Column

1. Cut and copy respectively the statements you want to paste.
2. Move the cursor to the top of the column, till the DOWN ARROW cursor is
displayed, and click the left mouse key.
3. Apply one of the following methods:
a. Select Paste from Edit menu.

b. Use CTRL + V combination.
c. Use SHIFT + INS combination
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.
Pasting Statements to the End of the Column

NOTE: The last cut or copied statements are pasted into the flow chart.
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
2. Apply one of the folowing methods:

The statements that were last cut or copied from the flow chart are pasted after
the last already existing statement in the column.
Pasting a single Statement at any Place on the Flow Chart

1. Select the position on the flow chart using the left mouse key, where the single
statement needs to be pasted.
2. To paste the statement at the selected position, apply one of the folowing
methods:

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.
Moving Statements in a Column

NOTE: Statements can only be moved within columns.
1. Select the statement to be moved by clicking on it.

2. Press the left mouse key and move the statement by moving the cursor in the
desired direction (up or down the column). When the statement strikes against
an adjacent statement, this and all other following statements are moved in the
same direction as the first selected statement.
Deleting Statements from the Flow Chart

NOTE: The delete command removes the statement(s) from the flow chart. The
deleted statements are lost and the connections of other statements to
them too.
1. Select the statement(s) which is (are) to be deleted from the flow chart.
2. Apply one of the following methods:
a. Select Delete from Edit menu.

b. Press DEL.
Inserting Columns into the Flow Chart

NOTE: When inserting a column, all the other columns (empty or with statements)
are shifted to the right. This means that you can insert a column between
two columns where statements have already being positioned and
connected. All the extant connections between the statements are
maintained in this way.???
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
Reverting the last Operation performed on the Flow Chart

NOTE: The RACL Editor provides one level of UNDO.
Anyone of the following operations can be reverted using the UNDO

option.
• Addition of a new statement into the flow chart

• Connection of an output and input.
• Delete operation on the flow chart
• Cut operation on the flow chart
37 EN2B-162GE51 R1114
• Paste operation on the flow chart

• Modification of the statement attributes using the Modify dialog.
• Moving of the statement in the flow chart
• Editing of parameters of the source file using the Parameter Edit dialog.
• Editing of the XFM User Address of the XFM source file.
• Editing of the XFM I/O definition of the source file
Editing of the XFM Description of the source file
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.
Modifying the Attributes of the Statements on the Flow Chart

NOTE: Modification done to the attributes (like Parameter Index, Register index,
User Address etc.) cannot be reverted
Once a statement is placed in the flow chart, the attributes of the statement can be
modified.
1. Either double-click the statement

or
move cursor over the statement, click right mouse key and select Modify.
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.
Saving and Translating the Source Files

The results of the translation process on the source file are displayed in the output
window. The statements for which the errors or warnings are provided can be
selected by double-clicking or pressing ENTER on the corresponding entry in the
output window. The range of information displayed in the flow chart can be selected
from the options dialogs. There are three options provided:
• 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
2. Clicking on No does not translate the source file.

3. Clicking on Yes starts the translation of the source file and the results of the
translation process are displayed in the output window.
4. To view the statement to which the translation process has generated the
entry, double-click or press ENTER on the appropriate line in the output
window. This highlights the corresponding statement in the source file window.
39 EN2B-162GE51 R1114
Editing Parameter for a Source File

1. Select Parameter from the Edit menu.
The Parameter File Edit dialog box appears.
Adding new Parameters to the Parameter File

1. Edit the description text of the parameter in the Description field.
2. Edit the value of the parameter in the Value field.
3. Edit the minimum and maximum values of the parameter in the Minimum and
Maximum field respectively.
4. Select the engineering unit for the parameter from the Eng. Unit drop down list.
5. Click the Append button to add the new parameter into the list box.
Modifying an existing Parameter of the Parameter file

1. Select the parameter which needs to be edited.
2. Edit the values of the selected parameter in the corresponding fields.
3. To confirm the modified parameter, either click on the appropriate (green
checking) icon or press ENTER.
4. To cancel the modified parameter, either click on the (red cancel) button of
press ESC.
Deleting the existing Entry of the Parameter File

NOTE: Only the last entry in the parameter list can be deleted.
1. Click on the Delete Last button in the Parameter File Edit dialog box.
EN2B-162GE51 R1114 40
XFM source file
Assigning I/O Definitions for the Source File

The XFM I/O definitions are used to provide input and output definition for the input
pins in the first column and the outputs pins in the last column of the XFM source.
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.
Editing XFM Description Text for the Source File

The XFM Description is used to provide textual description for the XFM source files.
1. Select XFM Description... from the Edit menu. The XFM Description dialog
box is displayed.
2. Enter the description text and confirm by clicking OK.
41 EN2B-162GE51 R1114
Editing XFM User Address for the XFM Source

NOTES: The XFM User Address command is enabled only if the source file being
edited is a XFM source (*.MCS). When a RACL submodule is saved as
XFM source, the user addresses used in the submodule are saved as XFM
user addresses in the XFM source. There is a limit of 128 user addresses
for a given type in the XFM source.
1. Make sure, that the XFM source file window is active.

2. Select XFM User Addresses from the Edit menu. The XFM User Address
and the Parameter File List dialog box respectively appears.
Adding new XFM User Address for the XFM Source
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.
Modifying an existing XFM User Address Entry
1. Select the user address entry which needs to be modified.

2. Modify the selected entry by editing the name and/or selecting a different type.
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.
Deleting an existing XFM User Address Entry
1. From the list box, select the user address entry which needs to be deleted.
2. Click Delete.
Searching in the Flow Chart

It is possible to search for parameters, Z-registes, T-registers and user addresses.
The results of the search operation are displayed in the output window. Each entry
in the output window corresponds to the statement which meets the required search
criteria selected in the Search dialog. The statement in the source file window for
EN2B-162GE51 R1114 42
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.
Searching for a Parameter, a Z-Register, or a Timer Register

1. Choose the option you want to search for by checking the appropriate radio
button Parameter, Z-Register, or Timer-Register.
2. Select and enter respectively the corresponding index which needs to be
searched into the center field.
3. Click Search.
Searching for a User Address

1. Check the User Address radio button.
2. Select the user address name in the adjacent drop down list.
3. Click Search.
Searching for Statements

1. Check the Statement Mnemonic radio button.
2. Select a statement mnemonic in the adjacent drop down list.
3. Click Search.
43 EN2B-162GE51 R1114
Setting RACL Flags for the Main Module

NOTE: The RACL Flags command is only enabled, if the RACL Feature version
set in the INI file is 1.2.0 or above and the current source file being edited
is a RACL main module.
1. Select RACL Flag from the Edit menu.

2. The RACL Flag dialog box appears.
3. Check the Configurable Application check box.

Setup Editor Options

The entries of the INI file are read and displayed in the Setup dialog box. It is used
to update the current settings of the INI file.
1. Select Setup from the Options menu. The Setup dialog box is opened.
Updating the Color for Statements with unassigned Parameters

The following updates the ColorUnassigned entry in the [Editor] section of the INI
file:
1. Click the Select Color... button next to the Statements with Unassigned User
Addresses text. The Color dialog box appears.
EN2B-162GE51 R1114 44
2. Select the color and confirm by clicking OK.
Updating the Color for Statements with unassigned Inputs

The following updates the ColorOpenInputs entry in the [Editor] section of the INI
file:
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.
Saving the current Source File as a different Source File
Saving a Main Module as a Main Module of another Project

NOTES: A main module source file can only be saved as another main module; it
cannot be saved as a submodule or XFM source file. A submodule or XFM
source file cannot be saved as a main module. A submodule can be saved
either as another submodule or a XFM module. A XFM module can be
saved as either another XFM module or submodule.
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
Saving a Submodule as another Submodule

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.

list box.
4. Select the .PRA file in the Target Project list box to which the submodule
needs to be saved. All the submodules available for the selected .PRA file are
listed in the Target File Name list box.
5. Select the number of the submodule to which the source file should be saved.
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.
Saving a Submodule as a XFM Source

NOTES: A submodule can be saved as a XFM source only, if the number of inputs
in the submodule is less than or equal to the value set in the XFMmaxX
entry of the INI file and the number of the outputs in the submodule is less
than or equal to the value set in the XFMmaxY entry of the INI file. All the
user addresses of the submodule are saved as user adresses of the target
XFM source file.
Assumption:
The submodule is opened and the corresponding window active.
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.
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
dialog is displayed and the XFM file is not created (for the types and meaning
of the error dialogs please refer to the Appendix).
Saving a XFM Source as a Submodule

NOTES: On saving an XFM source as a submodule, the user addresses used by
the XFM source can be reassigned by using the XFM user addresses. This
is required because the user addresses used in the XFM source may not
be valid user addresses present in the .IPG file used for the target
submodule source file. On saving a XFM source as a submodule, the
parameters assigned to the statements are made un-assigned. This is
because the engineering unit index used by the XFM source file is not valid
in the target submodule file.
Assumption:
The XFM source file is opened and the corresponding window active.
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.
NOTE: By default the module number is set to 1.
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
Saving the Current Project as a different Project

NOTE: Saving a current project as a different project means that all included files
will be renamed but maintaining their extensions e. g.:
Saving TEST1.PRA as TEST2.PRA results in TEST1.M01 becomes
TEST2.M01. a.s.o.
Assumption:
If the choosen target project is already existing, those files are overwritten by the
current project files.
A main or a submodule has to be opened and the corresponding window to be

activated.
1. Select Save Project As from File menu. The Save Project As dialog box
appears.
2. In the Target Drive list box, select the drive.

3. In the Directories list box, select the directory.
4. Do one of the following:
Save as new project

a. Enter a new name for the target project into the File Name for All Files
field. The .PRA extension as well as the Application program name,
Project Name, Controller Name and the the Controller Number for the
destination project is formed automatically.
b. Click OK.
or
Save as existing project

c. In the Target Project list box, select a project to which the current
project should be saved.
NOTE: If an existing project is selected those files will be overwritten by

the current project files. In this case the Confirm File Copy
dialog box is shown providing the following options
EN2B-162GE51 R1114 48
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.
Previewing the current Flow Chart

1. Select Print Preview from the File menu. The preview window is opened.
2. To view the previous page, click on .

3. To view the next page, click on .
4. To view the page on the right of the current view, click on .
5. To view the page on the left of the current view, click on .
6. To increase the current view, click on
7. To reduce the current view, click on
8. To print the previewed source file, click on
9. To close the preview, click on the
49 EN2B-162GE51 R1114
Deleting the current Source File

NOTE: The Delete command from the File menu deletes the physical copy of the
file on the disk. No back is created in this case.
Deleting a current Submodule or XFM Source File

1. Select Delete from the File menu. A delete confirmation dialog is launched.
2. Click OK to delete the submodule and XFM source file respectively
Deleting a current Main Module

1. Select Delete from the File menu. A delete confirmation dialog is launched.
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.
3. Confirm by clicking OK. The following dialog box is opened.
4. Click Yes to delete the file whose name is displayed in the dialog box.
or
EN2B-162GE51 R1114 50
Click Yes to All to delete all files that were listed in step 2.
or
Click No to skip the file whose name is displayed
or
Click Cancel to abort the delete operation.
Printing the Flow Chart

1. Select Print from the File menu. The Print dialog box appears. By default the
Flow chart check box is selected.
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.
It is possible to selectively print the contents of a flow chart concerning area,

reports and information data by setting the following options:
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
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.
Access Lists (Reports)

When printing Access Lists (Reports), the following options can be selected
and printed for the currently edited source file.
• 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.
Information Text/XFM Information

Check the Information Text/XFM Information check box, if XFM Description
Text, XFM I/O Description, and XFM User Address List should be printed.
3. Click OK.
Retranslating the RACL loadable Files

1. Select Open from the File menu. The Open dialog box is shown.
3. Select M0 / SubModule *.PRA in the List File of Type combo box.
4. In the Directories list box, select the directory that contains the loadable files
to retranslate. The Target Project /XFM list box lists all the .PRA files saved in
the selected directory.
5. In the Target Project /XFM list box, select the desired .PRA file. The
Retranslate button is enabled.
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
Retranslating the XFM’s

1. Select Open from the File menu. The Open dialog box is shown.
3. Select XFM’s *.CSD, *.MCS from the List Files of Type combo box.
4. In the Directories list box, select the directory that contains the loadable XFM
files to retranslate. The Target Project /XFM list box lists all the .CSD files
saved in the selected directory.
5. In the Target Project /XFM list box, select the desired .CSD file. The
Retranslate button is enabled.
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
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
55 EN2B-162 GE51 R1010

RACL STATEMENTS RACL EDITOR
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
Energy Management 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.
Heating curve equation MWTsp = RMTsp + k (RMTsp - OAT)α
k = S * f(m)
α = g(m)
m = curvature
MWTsp = mixed water temperature setpoint (flow temperature setpoint)
RMTsp = room temperature setpoint
OAT = outside air temperature
curvature m f(m) = g(m) =

m < 1.25 1.44613 0.9
1.25 ≤ m ≤ 1.41 2.09128 0.8
1.41 < m 3.02425 0.7
Registers P 2
Z 0
T 0
X 2
Y 1
Execution time 8.0 ms
Input Xa = X register containing the room temperature setpoint

Xb = X register containing the outside air temperature
Pc = Parameter number containing the curvature m
Pb = Parameter number containing the slope S
Result The Y register contains the calculated flow temperature setpoint.
Related statements ADAH, ADH2
ADAH Adaptation of the Heating Curve Parameters

Function This command adapts the slope S of the heating curve for the determination of the
flow temperature setpoint to the building characteristics. The slope S of the heating
curve is calculated from the room temperature, the flow temperature and the
outside air temperature. Before transferring values into the characteristic curve
function "Heating curve" HC with "Set parameters" SPR, a plausibility check is
carried out. Adaptation is done if the condition (room temperature setpoint > 18°C)
AND (outdoor temperature < 15°C) AND (pump on) is true at least 6 hours per day.
k = S * f(m)
α = g(m)
m = curvature
57 EN2B-162GE51 R1114

m < 1.25 1.44613 0.9
1.25 ≤ m ≤ 1.41 2.09128 0.8
1.41 < m 3.02425 0.7
Registers P 3
Z 10
T 2
X 4
Y 2
Input Xa = X Register, contains the room temperature

Xb = X Register, contains the outside air temperature
Xc = X Register, contains the flow temperature
Xd = X Register, contains the status of the heating loop pump (0 = off, 1 = on)
Pa = Switch
0 = don’t do adaptation
1 = do adaptation
2 = restart adaptation
Pb = Standard value of the slope S

The standard value is output if unallowable parameters are recognized in
the plausibility check.
If ADAH calculates a greater value than Pb then Yb is set to Pb.
Pc = curvature of the heating curve (must be the same as referred to by HC

statement!)
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)
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)
Related statements ADH2, HC
ADH2 Adaptation of the Heating Curve Parameters

Function This command adapts the slope S of the heating curve for the determination of the
flow temperature setpoint to the building characteristics. The slope S of the heating
curve is calculated from the room temperature, the flow temperature and the
outside air temperature. Before transferring values into the characteristic curve
function "Heating curve" HC with "Set parameters" SPR, a plausibility check is
carried out. Adaptation is done if the condition (room temperature setpoint > 18°C)
AND (outdoor temperature < 15°C) AND (pump on) is true at least 6 hours per day.
EN2B-162GE51 R1114 58
k = S * f(m)
α = g(m)
m = curvature

m < 1.25 1.44613 0.9
1.25 ≤ m ≤ 1.41 2.09128 0.8
1.41 < m 3.02425 0.7
Registers P 3
Z 10
T 1
X 5
Y 2
Input Xa = X Register, TUNCOS information

Xb = X Register, contains the room temperature
Xc = X Register, contains the outside air temperature
Xd = X Register, contains the flow temperature
Xe = X Register, contains the status of the heating loop pump (0 = off, 1 = on)
Pa = Switch
0 = don’t do adaptation
1 = do adaptation
2 = restart adaptation
Pb = Standard value of the slope S

The standard value is output if unallowable parameters are recognized in the
plausibility check. If ADAH calculates a greater value than Pb then Yb is set to
Pb.
Pc = curvature of the heating curve (must be the same as referred to by HC

statement!)
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)
Related statements ADAH, HC, TUNC
59 EN2B-162GE51 R1114
EOH Energy Optimized Heating

Function This command calculates the values for Optimum start and Optimum stop for
heating. Two modes of operation are used:
• Optimization without a room sensor

• Optimization with a room sensor
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

m < 1.25 1.44613 0.9
1.25 ≤ m ≤ 1.41 2.09128 0.8
1.41 < m 3.02425 0.7
Operation Modes of EOH
Change up,with room sensor (Pa=1) / optimised
1 = Operation Mode PREHEAT_ROOM_CONTROL

2 = Operation Mode POST_PREHEAT_ROOM_CONTROL
Change up, with room sensor (Pa=2) / optimised

force room control mode (new feature since XL 1.06.90)
EN2B-162GE51 R1114 60
Change up, without room sensor (Pa=0) / optimised
Change down, optimised
Change down, not optimised
Change down (optimised or not) followed by optimised off
61 EN2B-162GE51 R1114
Change down (optimised or not) followed by off (not optimised)
Change down (optimised or not) followed by higher setpoint
Lower setpoit (optimised or not) followd by optimised change up
Change not optimised
EN2B-162GE51 R1114 62
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
Input Xa = X register containing the room temperature in °C

Xb = X register containing the outside air temperature in °C
Pa = room sensor
0 = no
1 = yes, supply water temperature controled by atmospheric conditions in
normal mode
2 = yes, force room control in normal mode
Pb = Minimum preheat time for optimum heating with a room sensor recommended:
0..1440 min
Pb = Maximum heating temperature for optimum heating with a room sensor sensor
Pc = default water temperature for preheating
Pd = In the absence of a room sensor this value is added to the desired room
setpoint. This new setpoint is then used in the heating curve equation to
calculate the supply water temperature.
Pe = minimum outdoor temperature to allow early setback
Pf = preheating time (in min) for outdoor temperature of 0°C. Used when no room
sensor is present.
Pg = setback slope adjust
Ph = Dead time 1 (short decay) sensor recommended: 0..60 min
Pi = Time constant 1 (short decay) sensor recommended: 0..2880 min
Pj = Dead time 2 (long decay) sensor recommended: 0..60 min
Pk = Time constant 2 (long decay) sensor recommended: 0..2880 min
Pl = Identification of time constants and
dead time takes place = 0
does not take place = 1
restart identification = 2
Pm = throttling range
Pn = integral reset time
Po = maximum supply water temperature
Pp = heating curve curvature
Pq = heating curve slope
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.
Related statements EOV
63 EN2B-162GE51 R1114
EOH2 Energy Optimized Heating

Function see EOH
Registers P 17
Z 13
T 2
X 3
Y 3
Input Xa = X register containing the data point TUNCOS information

Xb = X register containing the room temperature in °C
Xc = X register containing the outside air temperature in °C
Pa = room sensor
0 = no
1 = yes, supply water temperature controled by atmospheric conditions in
normal mode
2 = yes, force room control in normal mode
Pb = Minimum preheat time for optimum heating with a room sensor
recommended: 0..1440 min
Pb = Maximum heating temperature for optimum heating with a room sensor sensor
Pc = default water temperature for preheating
Pd = In the absence of a room sensor this value is added to the desired room
setpoint. This new setpoint is then used in the heating curve equation to
calculate the supply water temperature.
Pe = minimum outdoor temperature to allow early setback
Pf = reheating time (in min) for outdoor temperature of 0°C. Used when no room
sensor is present.
Pg = setback slope adjust
Ph = Dead time 1 (short decay) sensor recommended: 0..60 min
Pi = Time constant 1 (short decay) sensor recommended: 0..2880 min
Pj = Dead time 2 (long decay) sensor recommended: 0..60 min
Pk = Time constant 2 (long decay) sensor recommended: 0..2880 min
Pl = Identification of time constants and
dead time takes place = 0
does not take place = 1
restart identification = 2
Pm = throttling range
Pn = integral reset time
Po = maximum supply water temperature
Pp = heating curve curvature
Pq = heating curve slope
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.
Related statements TUNC, EOH, EOV2
EOV Energy Optimized Ventilation

heating or cooling. The setpoint for device on is defined in Xa . The time program is
used to switch form off (0) to on (1). The command activates the option
(optimization yes/no) in the time program menu.
EN2B-162GE51 R1114 64
Registers P 9
Z 6
T 2
X 4
Y 3
Input Xa = X register containing the room temperature setpoint in °C

Xb = X register containing the room temperature in °C
Xc = X register containing the outside air temperature in °C
Xd = X register containing the mode (1 = heating, 0 = cooling)
Parameters for Heating:
Pa = minimum preheat time for heating (eng. unit: min)

Pb = preheat factor (will be adapted, eng. unit: min
K )
Pc = minimum outdoor temperature for optimized setback (eng. unit: °C)
Pd = early setback factor (eng. unit: min
K )
Parameters for Cooling:
Pe = minimum precool time for cooling (eng. unit: min)

min
Pf = precool factor (will be adapted, eng. unit: K )
Pg = maximum outdoor temperature for optimized setback (eng. unit: °C)
min
Ph = early setback factor (eng. unit: K )
Parameter for Adaptation:
Pi = Adaptation off (1), on (0), restart (2)
User address:
Enter the user address to assign on/off signal from the time program.
Result Ya device on (=1), device off (=0)

Yb during optimum on phase (=1) else (=0)
Yc during optimum off phase (=1) else (=0)
Related statements TUNC, EOH, EOV2
EOV2 Energy Optimized Ventilation

heating or cooling. The setpoint for device on is defined in Xa. The time program is
used to switch form off (0) to on (1). The command activates the option
(optimization yes/no) in the time program menu.
Registers P 9
Z 6
T 2
X 5
Y 3
65 EN2B-162GE51 R1114
Input Xa = X register containing the data point TUNCOS information

<A HREF="#TUNC">TUNC</A>)
Xb = X register containing the room temperature setpoint in °C
Xc = X register containing the room temperature in °C
Xd = X register containing the outside air temperature in °C
Xe = X register containing the mode (1 = heating, 0 = cooling)
Parameters for Heating
Pa = minimum preheat time for heating eng. unit: min

min
Pb = preheat factor (will be adapted) eng. unit: K
Pc = minimum outdoor temperature for optimized setback eng. unit: °C
min
Pd = early setback factor eng. unit: K
Parameters for Cooling
Pe = minimum precool time for cooling (eng. unit: min)

min
Pf = precool factor (will be adapted) (eng. unit: K )
Pg = maximum outdoor temperature for optimized setback (eng. unit: °C)
min
Ph = early setback factor (eng. unit: K )
Parameter for Adaptation
Pi = Adaptation off (1), on (0), restart (2)
Result Ya device on (=1), device off (=0)

Yb during optimum on phase (=1) else (=0)
Yc during optimum off phase (=1) else (=0)
Related statements TUNC, EOV, EOH2
MAXX Knowledge Based Control Algorithm

Function see M. Tannert, "Das Wissenbasierte Analytische Regelverfahren WAR".
Registers P 15
Z 3
T 1
X 7
Y 1
Input Xa = physical input 1 (Matrix in X-direction)

Xb = physical input 2 (Matrix in Y- direction)
Xc = physical input 3 (Matrix in Z- direction)
Xd = Deviation xInstant - xSet
Xe = Limit for integrator output in order to avoid infinite oscillation
Xf = 1: Optimization of balance
≠ 1: no Optimization of balance
Xg = File number of parameter file, in which control rules have been saved
Pa = Maximum of linguistic domain for input Xa
Pb = Maximum des linguistic Wertevorrats für Eingang Xb
Pc = Maximum of linguistic domain for input Xc
Pd = Minimum of physical domain for input Xa
Pe = Maximum of physical domain for input Xa
Pf = Minimum of physical domain for input Xb
Pg = Maximum of physical domain for input Xb
Ph = Minimum of physical domain for input Xc
Pi = Maximum of physical domain for input Xc
Pj = Integral action time (reset time) TN for integrator
EN2B-162GE51 R1114 66
Pk = Factor for waiting time between 2 optimizations (TWT=Pk*TN), e.g. Pk = 3

Pl = Minimum of balancing error: if the limit is exceeded, correction of control rules
must occur.
Pm =Toleranz range for statistical rest window referring to deviation, since the
deviation is zero in static state.
Pn = Factor for correction value ∆uB = Ph * uR,I: in order not to add the total
balancing error, but to approach iteratively to the optimum of the control rules
Po = Value for cycle counter of the length of the statistical rest window: in other
words, how many cycles the process is in a quasi-stational state
Za = Z-Register for temporary storage of the integrator output of the last cycle.
Zb = Z-Register for temporary storage of the deviation of the last cycle.
Zc = Z-Register of statistical rest window for temporary storage of the cycle counter
Result Ya = Total correction signal u = uB + uR,I
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 %
NIPU Night Cooling Operation (Night Purge)

Function This function offers the possibility to save expensive cooling energy for ventilation
and air conditioning systems if cold outside air is available during the non operating
67 EN2B-162GE51 R1114
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

Xc = Switch night cooling yes/no = 1/0
Xd = ∆ Xs Displacement of the room temperature setpoint (compensation)
Xe = X Register, contains the room temperature setpoint
Pa = min. permitted outside air temperature 25 ... 30°C
Pb = min. difference between room and outdoor temperature
(Pb establishes how many K the outside air temperature must be colder than
the room temperature so that night cooling operation can be initiated).
Result Y = 1, night purge active

Y = 0, night purge passive
Related statements NIPH
NIPH Night Cooling Operation (Night Purge with Hysteresis)

Function This function offers the possibility to save expensive cooling energy for ventilation
and air conditioning systems if cold outside air is available during the non operating
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.
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

Xc = Switch night cooling yes/no = 1/0
Xd = ∆ Xs Displacement of the room temperature setpoint (compensation)
Xe = X Register, contains the room temperature setpoint
Pa = min. permitted outside air temperature 25 ... 30°C
EN2B-162GE51 R1114 68
Pb = min. difference between room and outdoor temperature

(Pb establishes how many K the outside air temperature must be colder than
the room temperature so that night cooling operation can be initiated).
Pc = Switching hysteresis
Result Y = 1, night purge active

Y = 0, night purge passive
Related statements NIPU
DEWP Dew Point

Function This command calculates the dewpoint temperature from the absolute humidity.
Registers P 1
Z 0
T 0
X 1
Y 1
Input Xa = absolute humidity in mbar
Result Ya = dewpoint temperature in °C
Related statements ENT
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
Input Xa = X register containing the air temperature in °C(-5°C...+50°C)

Xb = X register containing the air relative humidity 0 ... 100%
Pa = Describes the air pressure (mbar) at the location for which the enthalpy is to be
calculated.
Result Ya = Calculated enthalpy in the range from 0 kJ/kg to 150 kJ/kg

Yb = Calculated absolute humidity in the range from 0 g/kg to 40 g/kg of dry air
DUC Intermittent Operation

Function During the core occupancy time the "DUC" command switches the ventilating and
air conditioning systems intermittently, provided that the desired room conditions
are maintained. A prerequisite for intermittent operation is spare output capacity in
the system particularly during transient times of the year. Electrical fan motor
energy is reduced due to the intermittent run time.
69 EN2B-162GE51 R1114
Registers P 6
Z 1
T 1
X 4
Y 2
Input Xa = Highest zone temperature

Xb = Lowest zone temperature
Xc = Fan status
1 = off
2 = stage 2
3 = stage 1
Xd = Room temperature setpoint
Pa = Temperature difference ± K (comfort range)
Pb = Maximum switch-off time in %
Pc = Minimum switch-off time in %
Pd = Cycle time in minutes
Pe = DUC type: 1 = heating, 2 = cooling, 3 = heating + cooling
Pf = 2-stage fan 1 = yes, 0 = no
Result Ya = Fan stage 2: 0 = off 1 on

Yb = Fan stage 1: 0 = off 1 on
ZEB Zero Energy Band/Setpoint Optimization

Function The ZEB instruction subdivides a specified comfort range into:
• 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
Input Xa = Highest zone temperature

Xb = Lowest zone temperature
Xc = Average zone temperature
Xd = Air humidity (relative in%RH or absolute in g/kg)
Xe = Setpoint Temperature
Pa = Temperature difference ± X (recommended: 2 K)
Pb = Humidity sensor type (1 = RH, 2 = absolute)
Pc = Minimum cooling setpoint (recommended: 14°C)
Pd = Maximum heating setpoint (recommended: 35°C)
Pe = Minimum mixed air setpoint (recommended: 13°C)
Pf = Application type
1 = ZEB
2 = Heating setpoint control
EN2B-162GE51 R1114 70
3 = Cooling setpoint control

4 = Heating + cooling setpoint control
Pg = Humidity test (1 = yes, 0 = no)
Ph = Upper room humidity limit (recommended: 65 %RH)
Pi = Heating shift range (recommended: 15K)
Pj = Cooling shift range (recommended: 6K)
Pk = Mixed air shift range (recommended: 7K)
Result Ya = Heating medium duty

Yb = Cooling medium duty
Yc = Heating setpoint - cascade controller
Yd = Cooling setpoint-cascade controller
Ye = Mixed air value setpoint-cascade controller
Examples:
Zero energy band

Multizone system with zoned mixed air dampers.
Dual duct systems with mixing boxes.
VAV systems without room control.
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
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
The portion of the PD algorithm is as follows:
XC = 100
TR
[E n +
TD ( E n − E n −1 )
tn
]
 
 En + (En − Z a )
100
TD
XC = TR
 tn 
Proportional + Derivative
XC = Control output signal (correction signal)

TR = Proportional band (in physical units)
TD = Rate time
tn = Scan time of current RACL cycle
En = Current control deviation
En-1 = Previous deviation
(stored in a Z register during the last RACL cycle)
E n − E n −1
t0
= Rate of change of the deviation
Za = Deviation of the preceding RACL cycle

n = Current cycle number
Registers P 2
Z 1
T 0
X 1
Y 1
Input Xa = X register containing the current control deviation.
Pa = Parameter number containing the proportional band(in physical units).

Pb = Parameter number containing the rate time (in seconds). Storage and access
to the Z register takes place internally
To suppress the derivative component, set Parameter Pb to zero.
EN2B-162GE51 R1114 72
Result The Y register contains the output value.

The Z register contains the deviation from the last cycle. The current control
deviation is stored in this register during the processing of this command.
Related statements DIFT, INRT, PI, PID
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
The portion of the PID algorithm is as follows:
 n
 ti  
 n ∑  Ei 
+
100
XC = TR E
 i =0  TI 
  t 
XC = TR  n
100
E +  Z a + En n 
  TI 
Proportional + Integral

TI = Reset time
Za = Integral part
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
Input Xa = X register containing the current deviation.
Pa = Parameter number containing the proportional band (in physical units).

Pb = Parameter number containing the reset time (in seconds). Storage and access
to the Z register take place internally. The integral limit is ± 50 %.
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.
Related statements DIFT, INRT, PD, PID
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
The complete PID algorithm is as follows:
 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

TI = Reset time
TD = Rate time
En-1 = Previous deviation
EN2B-162GE51 R1114 74
(stored in a Z register during the last RACL cycle)
n
 ti 
∑  E T i

i =0  I 
En − En −1
tn
= Rate of change of the deviation
Za = Integral Part
Zb = Deviation of the preceding RACL cycle
Registers P 3
Z 2
T 0
X 1
Y 1

Pa = Parameter number containing the proportional band (in physical units).
Pb = Parameter number containing the rate time(TD)in seconds.
Pc = Parameter number containing the reset time (TI) in seconds.
To suppress the derivative component, set Parameter Pb to zero.

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 PID control signal.

The Za register contains the sum of all previous deviations from the integral
component of the formula:
n
∑E
0
n t0 or (Za + En)
Register Zb contains the last deviation.

Both Z registers are updated with the new cycle values during the processing of this
command.
Related statements DIFT, INRT, PI, PD
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
I = Integral output signal

TI = Reset time
En = Current deviation
75 EN2B-162GE51 R1114
n
 ti 
∑  E T i

i =0  I 
Za = Integral
t0
Ti ( E n ) = Integral of current cycle
Registers P 1
Z 1
T 0
X 2
Y 1
Input Xa = X register containing the control deviation of the current cycle

Xb = X register containing the limit value (integral limit). The integral output must not
exceed this value.
Pa = Parameter number containing the reset time Ti.
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)
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
Execution time 1,168 ms

Pa = Parameter number containing the rate time TD.
Result Y = 0 if the input is unchanged since the last cycle.
EN2B-162GE51 R1114 76
Y > 0 if the deviation is increasing.

Y < 0 if the deviation is decreasing.
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.
Related statements INRT, PI, PD, PID
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
Input Xa = X register containing the input value

Xb = X register containing the upper threshold value
Pa = Parameter number containing the switching differential.
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.
NOTE: If Pa is negative, there is no hysteresis!
77 EN2B-162GE51 R1114
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
Input Xa, Xb, ... =X register containing status value 0/l
Result Y = Xa AND Xb AND Xc ....
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
Input Xa, Xb, ... =X register containing status value 0/l
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
Input Xa, Xb =X register containing status value 0/l
EN2B-162GE51 R1114 78
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!
SIMI Integer Constant (0..127)

Function Set output Y to C
Registers P 0
Z 0
T 0
X 0
Y 1
Input none
Result Y=C
Related statements SIMF
SIMF Float Constant

Function Set output Y to C
Registers P 0
Z 0
T 0
X 0
Y 1
Input none
Result Y=C
Related statements SIMI
MUL Product
Function Multiply/Sum the contents of 2 or more X registers.
79 EN2B-162GE51 R1114
Registers P 0
Z 0
T 0
X 2..128
Y 1
Input Xa , Xb...... registers with the the values to be multiplied
Result The result of the multiplication is transferred to the Y register.

Y = Xa * Xb * ...
Related statements DIV, SUM, SUB
SUM Sum
Function Sum the contents of 2 or more X registers.
Registers P 0
Z 0
T 0
X 2..128
Y 1
Input Xa , Xb...... registers with the the values to be added.
Result The result of the sum is transferred to the Y register.

Y = Xa + Xb + ...
Related statements NEG, SUB, MUL, DIV
SUB Subtract
Function subtracts Xb from Xa
Registers P 0
Z 0
T 0
X 2
Y 2
Input Xa , Xb... registers with the values to be subtacted
Result Ya = Xa - Xb
Yb = abs (Xa - Xb)
Related statements SUM, MUL, DIV, NEG
NOT Arithmetic Difference
EN2B-162GE51 R1114 80
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
Input Xa, Xb, ... = X registers

Pa, Pb, ... = Parameters
Result The difference between the X-register and the parameter is transferred to the Y
register.
Ya = Pa - Xa
NOTE: If P = 1, the NOT command works as an inverter for binary signals.
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...
Execution time 0.344 ms + X * 0.082 ms
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
Related statements IDT, SUB, NOT
DIV Division
81 EN2B-162GE51 R1114
Function Division of two X registers. The result is transferred to the Y register.
Registers P 0
Z 0
T 0
X 2
Y 1
Input Xa = X register containing the dividend

Xb = X register containing the divisor
Result Y = Xa / Xb
NOTE: Division by "0" causes an error message. "0" is transferred to the Y

register as a result.
Related statements SUM, MUL
Modulo Division Using SPLT

There is no RACL statement for the mathematical modulo operation but you could
use the SPLT statement in the following way:
Use a SPLT statement with one constant Ca. Ca may be any integer number from 2
to 100.
Ya = Xa mod Ca
LIN Linear Product

Function Calculates an output value proportional to an input value. This is accomplished by
calculating the linear product of an X register value and a Parameter register value.
Several linear products can be calculated and summed. The result of a
multiplication or the sum of several multiplications is transferred to the Y register.
Up to 128 X registers and parameters can be processed by one LIN command.
Registers P 1..128
Z 0
T 0
X 1..128
Y 1
Input Xa Xb... = X register numbers

Pa Pb... = Parameter numbers
Result Linear product is transferred to the Y register. Y = Xa * Pa + (Xb * Pb +...
Related statements POL, SUM
POL Polynomial
EN2B-162GE51 R1114 82
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
Execution time 0.561 + P * 0.427 ms
Input Xa, Xb = X register

Pa, Pb, = Parameter numbers
Result The result of the polynomial is transferred to the Y register. The polynomial is as
follows:
Y = (Xa + Pa) * (Xb + Pb) ...
Related statements LIN, MUL
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
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
Input Xa = X register containing the value to be rounded.

C = a whole number between 0 and 127.
Result Ya = Rounded value of Xa

Yb = C - Ya.
Yb = - Ya if C = 0
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
Input Xa Xb Xc .... = X registers containing a float number.
Result Ya = Value of Xa rounded to a whole number.

Yb = Value of Xb rounded to a whole number
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
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.
SQRT Square Root

Function Square Root
Registers P 0
Z 0
T 0
X 1
Y 1
Input X
Result Y = square root of X

A RACL alarm will be produced when calculating the root of a negative value.
I/O Statements
Inputs (INP, IBIT, NBIT)

Function INP and IBIT transfer the value of a data point to the Y register. (value = attribute
manual value)
85 EN2B-162GE51 R1114
Registers P 0
Z 0
T 0
X 0
Y 1
Execution time IBIT: 0,703 ms

NBIT: 0,703 ms
INP: 5,000 ms
Input User address = Input the user address whose value is to be transferred to the next
Y register.
Result IBIT:
Y register is set to an integer value,depending on the status of the data point.

StatusY register value:
0 0.0
1 1.0
2 2.0
3 3.0
NBIT:
Y register is set 0 or 1, depending on the status of the digital input point.

StatusY register value:
0 1
>0 0
INP:
Y register is set to the value of the data point.
RACL Style Guide It is recommended to use INP for analog inputs/virtual points and IBIT/NBIT for
digital inputs/virtual points.
Related statements AOP, OBIT
Outputs (AOP, OBIT)

Function Load the information of a defined X register to an output point. The command
contains the user address of the data point into which the value is to be transferred.
AOP transferres the value as it is to the data point. OBIT rounds the value to an
integer value. AOP and OBIT both allow writing to any type of data points.
(value = attribute auto value of the data point)
Registers P 0
Z 0
T 0
X 1
Y 0
Execution time AOP: 6.000 ms

OBIT: 0.698 ms
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
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.
Related statements INP, IBIT, NBIT
Read attributes (RIA)

Function Read one or more attributes for a user address and make these values available as
inputs to other control icons or hardware/software points.
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
Minimum limit 1 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
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
Write attributes (WIA)

Function Write one or more values to different attributes of a user address. The values can
come from a parameter, physical point or another control icons.
EN2B-162GE51 R1114 88
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.
Output A datapoint with changed attributes.
WIA Attributes Table The following table lists attributes that will be selectable for various point types.
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
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
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 90
Miscellaneous
CDEL Controlled Alarm Delay

Function Produces a simple switch-on delay at output Ya. It likewise produces Yb = 1 if the
status of Xb does not switch from 0 to 1 during the delay time. The same timing
element serves both outputs. When the Xa status changes from 0 to 1, the time
delay starts.
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
Za =X of the respective preceding RACL cycle.

Ta = 0 if Xa ≥ l and Za < l start of the delay time
NOTE: In order to get a correct CDEL command execution, ensure Xa switches on

before Xb.
Related statements MTIM
COMP Logical Comparison

Function Compare the contents of two X registers. Transfer "0" or "l" to the Y register,
depending on the result of the comparison.
Registers P 0
Z 0
T 0
X 2
Y 1
Input Xa, Xb = X registers whose contents are to be compared.
Result Y = 0, if Xa <Xb
Y = 1, if Xa ≥ Xb
Related statements HYS
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
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.
Result The count is determined as follows:

Zb contains the last value of Xa
Zacontains the last value of the counter.
Y = 0, if Xa ≥ 1
The count output (Y register) and Za are set to zero.
Y = Y+ 1 if Xa > Zb
The count is increased by 1, and the new value is transferred to the Y register and
to Za.
NOTE: If both conditions coincide, the counter is reset to zero.
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
Result Ya = (100 * hours) + minutes, e.g. 21.50 hours = 2150

Yb = Weekday, e.g. Monday = 1
Yc = (100 * month) + day in month, e.g. 25th Feb. = 0225
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
Result Ya = number of minutes after midnight
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
Input Xa = X register containing the input quantity to be compared.

Pa Pb ... = Parameter numbers with the values to be compared.
Result The Y register is set as follows:

Y =1 if Xa =Pa or Xa = Pb ...
Before the comparison, the parameters and Xa are truncated after the decimal
places.
Negative parameter values are given a positive sign.
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
Execution time 0.36 + X * 0.075ms
Input Xa, Xb, Xc, ... X registers in the sequence in which they are to be transferred.
Result Data from X registers is transferred to Y registers.
Related statements NEG
STO Store Value in Z Register

Function Stores the contents of X the register into a Z register.
93 EN2B-162GE51 R1114
Registers P 0
Z 1..128
T 0
X 1..128
Y 0
Execution time 0,429 ms
Input Xa = X register containing the value to be stored in the Z register.

Za = Z register where data should be stored
Result contents of Za = contents of Xa
Related statements ISTO, RCL, IRCL
RCL Recall Z Register

Function Transfer the data from a Z register to a Y.
Registers P 0
Z 1..128
T 0
X 0
Y 1..128
Input Za = Z register which should be read
Result Y register contains the contents of the Z register.
Related statements STO, ISTO, IRCL
ISTO Indexed Store

Function Stores values present at Xa in the Z register whose number is the sum of
(Xb + Zstart -1). The Z register number may not exceed the value of Zend. To produce
valid register numbers, Xb is rounded to the next whole number. If Xb < 0, then it is
set to 0. If Xb > 127, then Xb is set to 127, and the Y output to 1.
Registers P 0
Z ?
T 0
X 2
Y 2
Input Xa = X register containing the value to be stored in the Z register.

Xb = X register containing the Z register index
Zstart = The offset of the Z register for index = 1
Zend = The upper limit of the index plus offset
Result Z register number = (Xb + Zstart -1)

If Z register number < 0, then Z register number 0 will be used
If Z register number > Zend, then Z register number will be set to Zend
EN2B-162GE51 R1114 94
Z [Z register number] = Xa
Y = 0 if Z register number < Zend
Y = 1 if Z register number ≥ Zend
Related statements STO, IRCL
IRCL Indexed Recall

Function Loads values from Z registers. The Z register number is determined by the sum of
Xa + C. The decimal places of Xa are set to zero in order to get an integer. Since Z
register number 0 does not exist, the index (Xa + C) must be greater than or equal
to 1.
Registers P 0
Z ?
T 0
X 1
Y 1
Input Xa = X register containing the Z register index.

C = Value of the offset to the index.
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.
Related statements RCL, ISTO
MTIM Monoflop Timer

Function Sets the output to 1 for a specific time period if a defined X register exceeds its
previous value. At the end of the time period, the output is set to zero. The output
value is transferred to the Y register.
Registers P 1
Z 2
T 1
X 1
Y 1
Input Xa = X register containing the input value.

Pa = Parameter number containing the time period in seconds for which the output
is held at 1. Storage and access to the Z registers takes place internally; Xa and the
Y output value of the preceding cycle are stored there.
Result The Y register is set as follows:

Y = 1 and Ta = 0, if Xa > Za
Y = 0, if Ta ≥ Pa and Xa ≤ Za
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
contains the current Y register value. Ta = Timer register containing the time in
seconds.
PAR Read Parameter

Function Transfer the data from defined parameter registers to Y registers in the sequence
specified. Up to 128 parameters can be transferred with one PAR command. The
parameters read by PAR must be in the same main module or submodule as the
PAR command.
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.
Result Contents of the parameter registers are transferred to Y registers.
Related statements SPR
SPR Set Parameter

Function Stores X register values in defined parameter registers. The SPR command can set
parameters from the PAR or any other commands. SPR overwrites the previous
parameter values. The parameter can be any physical value. The number of X
register/parameter pairs transferred by one SPR command is variable between 1
and 128. The parameters set by SPR must be in the same main module or
submodule as the SPR command.
Registers P 0
Z 0
T 0
X 1..128
Y 0
Input Xa = X register containing the value to be stored.

Pa = Parameter number under which the value is stored.
Result Pa = Xa, Pb = Xb, ...
Related statements PAR
RTC Time Counter

Function Logs the runtime, and provides the hours at output Ya and the minutes at output Yb.
The total runtime is given by Ya (hours) + Yb (minutes). The runtime is logged when
the input signal Xa is greater than or equal to 1; when Xa is smaller than 1, the
unchanged value of the last cycle is present at the output. If the counter reset signal
Xb is greater than or equal to 1, the output is reset to 0, regardless of the status of
EN2B-162GE51 R1114 96
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
Input Xa = X register with the input signal (≥ 1 means log runtime

Xb = X register with the reset signal (≥ 1 means reset)
Result Ya = Runtime in hours

Yb = Runtime in minutes
RTIM Read Timer

Function Read a timer register (0..65536 sec)
Registers P 0
Z 0
T 1
X 0
Y 1
Input none
Result Y = T timer value in seconds
Related statements STIM
SET "Set Output"

Function Compare two inputs and set the output depending in the result.
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
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
Related statements SETL

SETL RS Flip-Flop
Function RS flip-flop with the inputs Xa for SET and Xb for RESET
Output Y switches from 0 to 1 when one of the following conditions occurs:
• Xa switches from 0 to 1 while Xb remains at 0.

or
Xa remains at 1 while Xb switches from 1 to 0.
• Output Y switches from1 to 0 when either:
Xa remains at 0 while Xb switches from 0 to 1.

or
Xa switches from 1 to 0 while Xb remains at 1.
• 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
Input Xa = X register containing the SET input value

Xb = X register containing the RESET input value.
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.
Related statements SET
STIM Set Timer

Function Reset a timer if the X register changed to 1.
Timer registers are always free running timers (after a timer reaches 65536 sec it
starts again with 0)
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.
Result T = 0 if Xa of the previous cycle was <1 and Xais now ≥ 1
EN2B-162GE51 R1114 98
Related statements RTIM
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
Related statements MUX
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
Execution time 0.5 + X-1 * 0.5 ms
Input Xa = Selector
Xb = Input 1
...
Xn = Input n
Result Y = Xb if Xa < 1 or Xa ≥ number of inputs

Y = Xc if Xa = 1 and Xa < 2
Y = Xd if Xa ≥ 2 and Xa < 3
Related statements SWI
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
Registers P 2
Z 0
T 0
X 1
Y 1
Input Xa = X register containing the input value

Pa, Pb = parameter numbers defining the range of the window
Result Y=1 if Pa <= Xa <= Pb

Y=0 if Xa < Pa or Xa > Pb
TUNC Time Until Next Change Of State

Function Reads the “Time Until Next Change Of State”-information from a data point which is
driven by a time program and transfers it to a Y register. This information can only
be used by EOH2 and EOV2.
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.
Related statements EOH2, EOV2
EN2B-162GE51 R1114 100

Program Flow
SKU Unconditional Skip

Function Skip forward to the first command of the defined column.
Registers P 0
Z 0
T 0
X 0
Y 0
Input none
Result RACL program execution continues at desired colum.
Related statements SKP, SKZ
SKP, SKZ Conditional Skip

Function If the value of the selected X register is positive (SKP) or zero (SKZ) skip forward to
the first command of the defined column.
Registers P 0
Z 0
T 0
X 1
Y 0
Input number of columns skipped

Xa = X register
Result RACL program execution continues at desired column if the condition was true
otherwise execution continues after the skip statement.
Related statements SKU
MCAL Submodule Call

Function Recalls a submodule from the Main Module (MO). This command can only be used
in the Main Module (M0). It contains the submodule names and parameter list. The
contents of the X registers of the Main Module are transferred to the X registers of
the submodule. Up to 128 X registers can be transferred to the submodule.
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.
101 EN2B-162GE51 R1114

Registers P 0
Z 0
T 0
X depends on
submodule
Y depends on
submodule
Execution time 0.962 + X * 0.081 + Y * 0.07 ms
Input Submodule = Name of the submodule to be recalled.

Parameter list = Parameter list recalled to the submodule.
Xa, Xb ... = X registers of the Main Module transferred to the submodule.
Related statements END
SLEV Next Column

Function Marks the end of a column. This statement is generated automatically and not
visible in a RACL flowchart
Execution time 0.386 + Y * 0.02 ms
END End Main Module

Function Identifies the end of a Main Module (M0). The program sequence is interrupted until
a defined RACL cycle time has elapsed. The Main Module (M0) is then repeated
again.
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.
END End Submodule

Function Identifies the end of a submodule and returns to the Main Module (M0). The
contents of the Y registers from the submodule are transferred to the next available
Y registers of the Main Module. The END instruction specifies the sequence in
which the Y registers of the submodule are transferred to the Main Module. Up to
128 Y registers can be transferred to the Main Module.
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.
EN2B-162GE51 R1114 102

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.
Related statements MCAL
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.
103 EN2B-162GE51 R1114

Configuration Statements
CPAR Read Configuration Parameter

Function Transfer the data from defined configuration parameter registers to Y registers in
the sequence specified. Up to 128 parameters can be transferred with one CPAR
command. Configuration Parameters can be accessed from every module.
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.
Result Contents of the parameter registers are transferred to Y registers.
SCPR Set Configuration Parameter

Function Stores X register values in defined configuration parameter registers. The SCPR
command can set parameters from the CPAR command. SCPR overwrites the
previous parameter values. The parameter can be any integer value ranging from -
32768 to 32767. The number of X register/configuration parameter pairs
transferred by one SCPR command is variable between 1 and 128. Configuration
Parameters can be accessed from every module.
Registers CP 1..128
Z 0
T 0
X 1..128
Y 0
Input Xa = X register containing the value to be stored.

Pa = Configuration Parameter number under which the value is stored.
Result Pa = Xa, Pb = Xb, ...
MRG Merge Values

Function Merge will be used for data compression from several X registers. Input values will
be compressed into only one output value. The compressed input value can be
retrieved clear with statement SPLT. statement MRG may be used for reducing the
inputs of submodules. Negative inputs are treated like 0.
Registers P 0
Z 0
T 0
X 2..128
Y 2
EN2B-162GE51 R1114 104

Execution time 500 + X * 500 ms
Input ba, [bb ...] = constants, possible value range: 2-100

Xa, Xb, ... = digits of a number to base n; integer values;
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.
Result Ya = Xa + Xb*ba + Xc*ba*bb + Xd*ba*bb*bc ...

Yb = 0 if no error occurs
1 if an error occurs
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.
Related statements SPLT
SPLT Split Values

Function SPLT retrieves clear all single values from a value, compressed with statement
MRG. Negative inputs are treated like 0.
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
105 EN2B-162GE51 R1114

Yc = (((Xa-Ya) / ba) -Yb) / bb) mod bc

Yc = (((61-1) / 2) - 2) / 4) mod 4 = 3
Yd = ((((Xa-Ya) / ba) -Yb) / bb) -Yc) / bc) mod bd
Yd = ((((61-1) / 2) - 2) / 4) - 3) / 4) mod 3 = 1
Related statements MRG
EN2B-162GE51 R1114 106

APPENDIX
This chapter provides the various error, information and warning messages. In the
case of error dialogs a description for the correction procedures have been given. In
addtion, settings as command line options and devault values are described.
RACL Source Translation Outputs
Errors
Error Message Meaning of Error

Error: Attributes not assigned The Attributes for the WIA / RIA statements
are not assigned
Error: Incorrect column value in the The column value specified in the SKP, SKZ
SKIP statement and SKU statement is greater than the current
column plus 127
Error: IPG.EXE not found The IPG.EXE executable is not present in the
current path of the RACL Editor executable
Error: IPL file does not exist The .IPL file corresponding to the project
being translated is not present in the project
directory
Error: Open input The input of the statement is not connected to
the Y registers of the previous column
Error: Parameter not assigned A Parameter of the statement is not assigned
an index from the Parameter File
Error: Unassigned Constant(s) The constant for the statement is not assigned
Error: Unassigned T register(s) The T register index for the statement is not
assigned
Error: MCAL P-file does not exist The P-File whose index is set in the MCAL
statement is not available
Error: MCAL number of Inputs/Outputs The number of inputs and outputs of the
does not match sub - module MCAL statement does not match the number
of X registers in the first column and the
number of Y registers in the last column of the
submodule called by the MCAL statement.
Error: MCAL submodule does not exist The submodule whose index is set in the
MCAL statement is not available
Error: Unassigned Z register(s) The Z register index for the statement is not
assigned
Error: No statements in this module There are no statements in the main module
of the project (.PRA) being translated
Error: Unassigned User address The user addresses for the column are not
assigned.
107 EN2B-162 GE51 R0107

APPENDIX RACL EDITOR
Warnings
Warning Message Meaning of Warning

Warning: Double write to T Two or more statements are writing into the same T
register register index.
Warning: Double write to Z Two or more statements are writing into the same Z
register register index.
Warning: Double Write to user Two or more statements are writing into the same
address User Address.
Information
Information Meaning of Information

Application Name : The Application Program name of the project to which the
source file belongs
Execution Time : The Execution time of the source file in milli-seconds
File Name : The file name of the source file
IPG.EXE Version The version of the IPG.EXE used.
Length in Bytes : Number of bytes of the source file in the loadable file
Number of Columns : Number of columns in the source file
Number of Statements : Number of statements in the source file
Number of T-Registers : Number of T registers used by the source file
Number of Z-Registers : Number of Z registers used by the source file
RACL - Editor Version : The version of RACL Editor
EN2B-162GE51 R1114 108

RACL EDITOR APPENDIX
RACL Loadable Retranslation Outputs
Errors

Error: Cannot create Mxx file The source files cannot be created
(disk space not available)
Error: Error in reading PHX file The .PHX file for the project being
retranslated is not available
Error: Incompatible RACL Feature Version The feature version of the
loadable file is not equal the
feature version set in the INI file
Error: Invalid opcode The Opcode specified in the
loadable file could not be found in
the statement definition file
Error: IPG.EXE not found The IPG.EXE for converting .IPL
to .IPG file is not available.
Error: IPL file does not exist The .IPL file of the project being
retranslated is not available.
Error: RAL, RAP, RAT, RAZ file format not correct The loadable files are not valid
RACL loadable files
Error: RAL, RAP, RAZ, RAT loadable files not The loadable file(s) are not
present present for the select .PRA file.
Error: The .KDX file for the project not present The .KDX file of the project being
retranslated is not available.
109 EN2B-162GE51 R1114

XFM Source Translation Outputs
Errors

Error: Attributes not assigned The Attributes for the WIA / RIA statements are
not assigned
Error: Incorrect column value in the The column value specified in the SKP, SKZ and
SKIP statement SKU statement is greater than the current column
plus 127
Error: Open input The input of the statement is not connected to the
Y registers of the previous column
Error: Parameter not assigned A Parameter of the statement is not assigned an
index from the Parameter File
Error: Unassigned Constant(s) The constant for the statement is not assigned
Error: Unassigned T register(s) The T-register index for the statement is not
assigned
Error: Unassigned Z register(s) The Z-register index for the statement is not
assigned
Error: Unassigned User address The user addresses of the column are not
assigned.
Error: Undefined User Address The XFM User Address used in the statement is
not defined in the XFM User Address list.
Warnings

Warning: Double write to T register Two or more statements are writing into the
same T register index.
Warning: Double write to Z register Two or more statements are writing into the
same Z register index.
Warning: Double write to user Two or more statements are writing into the
address same User Address.
Warning: XFM I/O definition is not The I/O definition for the XFM source is not
complete complete.
EN2B-162GE51 R1114 110

XFM Loadable Retranslation Errors
Errors

Error: Invalid opcode The opcode used in the XFM source is not found
in the statement definition file
Warnings

Warning: Description text too long to The description text is longer than the internal
accommodate in buffer buffer allocated to store it. The Description text is
truncated.
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.
111 EN2B-162GE51 R1114

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.
EN2B-162GE51 R1114 112

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.
113 EN2B-162GE51 R1114

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
EN2B-162GE51 R1114 114

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.
115 EN2B-162GE51 R1114

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 spelling of the mnemonic is incorrect

• The statement with the mnemonic is missing in the statement definition
file
• The RACL Feature version of the statement whose mnemonic was
entered is less than the RACL Feature version set in the INI file.
Error Correction • Enter the correct mnemonic name (as given in the statement definition
file)
• Change the RACL Feature version set in the INI file
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.
EN2B-162GE51 R1114 116

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.
117 EN2B-162GE51 R1114

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
EN2B-162GE51 R1114 118

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 The serial hardware plug is installed.

Error Correction The RACL Editor is protected by hardware lock. Install the hardware lock
on the parallel port and try invoking the RACL Editor again.
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.
119 EN2B-162GE51 R1114

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.
EN2B-162GE51 R1114 120

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.
121 EN2B-162GE51 R1114

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
EN2B-162GE51 R1114 122

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
123 EN2B-162GE51 R1114

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.
EN2B-162GE51 R1114 124

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 and Warnings
Information To get the confirmation from the user for the delete of the
current source file.
Information Trying to overwrite an existing source file
Information Trying to delete multiple statements from the flow chart
125 EN2B-162GE51 R1114

Information Tried to open a window which is already opened. The

new window will be opened in Read Only mode only.
Command Line Options

The command line options valid for RACL Editor are:
/s Stand-alone
/path= Default path for open and save
/p= Project Name
/c= Controller Name
/cnum= Controller Number (1..30)
Initialization (INI) File Entries.
Section Name Meaning

[Editor] Option for RACL Editor
[Featuren] (n = 0 .. 3) The RACL Feature Version
information
[General] General option valid for RACL Editor
[Retranslator] ReTranslator Information
[Translator] Translator Information
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:
Entry Name Section Name Meaning

AttributeTable [Featuren] The path of the attr_txt.txt file used to
assign attributes in WIA /RIA
statements
ColorOpenInputs [Editor] Color of the statement which has
open inputs
ColorSearchResult [Editor] Color of the statement which have be
selected from the output window by
double clicking on the entry in the
output window.
ColorUnassigned [Editor] Color of the statement which has
unassigned User Address,
Parameter, Z or T register(s)
FeatureSetName [Featuren] The description of the Feature
Version
HeaderVersion [Featuren] The version of header used in
EN2B-162GE51 R1114 126

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
Attribute Default Value

Color of statement selected from the output window Green
Color of statement with unassigned variables like user address, Red
parameter, Z register, T register etc.
Color of statement with open inputs Red
PasteOption Always ask the
user
RACL features Feature 0
WarningLevel Error + Warning
Zoom factor of the flow chart on the source file window 3
Zoom factor of the flow chart on print out 5
127 EN2B-162GE51 R1114

EN2B-162GE51 R1114 128

RACL EDITOR
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
129 EN2B-162GE51 R1114

INDEX RACL EDITOR
Statement description 56 Statement See IDT

EOV IDT
EOV2 Indexed Recall
Statement description 57 Statement See IRCL
EQL Indexed Store
Statement description 85 Statement See ISTO
Equal Information
Statement See EQL RACL source 100
Error INI file
Cause 103–17 Initialization 118
Correction 103–17 Modifying entries 36
Messages 103–17 Sections 118
Errors Initialization
Cause and correction of dialog errors 103–17 INI file 118
RACL loadable source retranslation 101 INP
RACL source translation outputs 99 Statement description 78
shown in dialog boxes 103 Input
XFM loadable source retranslation 103 Connecting with output 23
XFM source 102 Inputs
Excel Functional Module See XFM Statements See INP, IBIT, NBIT
EXP INRT
Exponent Inserting
Statement See EXP Columns into the flow chart 28
Integer Constant
Statement See SIMI
F Integral
Float Constant Statement See INRT
Statement See SIMF Intermittent Operation
Flow chart 5 Statement See DUC
Adding statements into 16 IRCL
Copying statements from 27 Statement description 87
Cutting statements from 27 ISTO
Deleting statements from 28 Statement description 86
Inserting columns into 28
Moving statements in a column 28
Part of a program 1
L
Pasting statements into 27, 28 Limitations
Previewing 41 of source file 2
Printing 41, 43 LIN
Selecting columns 25 Statement description 74
Selecting statements 24, 25 Linear Product
Zooming 41 Statement See LIN
Format Logic Statements 70
of statement definition file 2 Logical Comparison
Statement See COMP
Logical NOT
H Statement description 71
Hardware requirements 5
HC
Statement description 49
M
Heating Curve Main module
Statement See HC Setting RACL flags 36
HYS Main module
Statement description 68 Communication with submodules 4
Hysteresis Creating 13
Statement See HYS Opening 15
Saving as 37
Main tool bar 7, 8
I MCAL
I/O definitions Statement description 93
Editing 33 Menus 7, 8
IBIT Merge Values
Statement description 78 Statement See MRG
Identity MIN
EN2B-162GE51 R1114 130

RACL EDITOR INDEX
Statement description 75 Connecting with input 23

Minimum Window 31
Statement See MIN Output window 10
Modifying Output Window 7
Attributes of a statement 30 Outputs
Entries of the INI file 36 RACL loadable source retranslation errors 101
Statement 30 RACL source information 100
Zoom factor 12 RACL source translation errors 99
Module Name RACL source translation warnings 100
field 9 Statements See AOP, OBIT
Module Name field 7 XFM source translation errors 102
Modulo Division XFM source translation warnings 102
Statement description See SPLT
Monoflop Timer
Statement See MTIM P
Moving PAR
Statements in a column 28 Statement description 88
MRG Parameter
Statement description 96 Searching for ... 35
MTIM Parameter
Statement description 87 Deleting from the parameter file 32
MUL Editing 32
Statement description 71 Parameter file
Multiplex Deleting parameter 32
Statement See MUX Parameters
Multiplication Printing 44
Statement See MUL Pasting
MUX Statements into the flow chart 27, 28
Statement description 91 PD
N PD Controller
Statement See PD
NBIT PI
NEG PI Controller
Statement description 73 Statement See PI
Negate PID
Statement See NEG Statement description 66
Next Column PID Controller
Statement See SLEV Statement See PID
Night Cooling Operation POL
Statement See NIPU, NIPH See NIPU, NIPH Statement description 75
NIPH Polynomia
Statement description 60 Statement See POL
NIPU PRA File 1
Statement description 60 Preview
No Operation Flow chart 41
Statement See NOP Printing
NOP Access lists 44
Statement description 95 Flow chart 41, 43
NOT Parameters 44
Statement description 73 Reports 44
User adress 44
XFM I/O description 44
O XFM I/O description text 44
XFM User adress list 44
OBIT
Programm Flow Statements 93
Project
Opening
Saving as different project 40
Main module 15
Submodule 15
XFM 16 R
Operation
Reverting the last 29 RACL
OR Project 1
Statement description 70 Screen 7
Output RACL Editor
131 EN2B-162GE51 R1114

INDEX RACL EDITOR
Ending 12 for a parameter 35

General 1 for a T Register 35
Overview 1 for a user adress 35
RACL flags for a Z register 35
Setting for the main module 36 for attributes 35
RACL Program Selecting
Structure 1 Columns in the flow chart 25
RACL source Statements in the flow chart 24, 25
Retranslating loadable files 44 SET
RCL Statement description 89
Statement description 86 Set Configuration Parameter
Read Configuration Parameter Statement See SCPR
Statement See CPAR Set Output
Read Parameter Statement See SET
Statement See PAR Set Parameter
Read Time Statement See SPR
Statement See RTIM Set Timer
ReAssign Statement See STIM
User adress 39 SETL
Recall Z Register Statement description 90
Statement See RCL Setting
Registers 3 RACL flags for the main module 36
Printing 44 SIMF
Reports Statement description 71
Printing 44 SIMI
Retranslating Statement description 71
RACL loadable files 44 SKP
XFM loadable files 45 Statement description 93
Retranslation SKU
RACL loadable source output errors 101 Statement description 93
XFM loadable errors 103 SKZ
XFM loadable warnings 103 Statement description 93
Reverting SLEV
last operation 29 Statement description 94
RIA Software requirements 5
Statement description 79 Source file
RNDI Deleting 42
Statement description 76 Source file
Round Editing parameter 32
Statement See RNDI Saving 30
RS Flip-Flop Translating 30
Statement See SETL Source file limitations 2
RTC Source file window 7, 9
Statement description 88 Split Values
RTIM Statement See SPLT
Statement description 89 SPLT
used for Modulo Division 74
S SPR
Saving Statement description 88
Project as 40 Statement
Saving Assigning parameter file index 23
Source file 30 Assigning parameters 18
Saving as main module Assigning submodule index 23
Main module 37 Definition file 2
Saving as submodule Groups 2
Submodule 38 12
XFM 39 Modifying 30
Saving as XFM Setting constants 20
Submodule 38 Statement group tool bar 7, 8
SCPR Statement selection drop down list 7, 9
Statement description 96 Statements
Screen Set color 36, 37
of the RACL Editor 7 Statements 3
Screen Adding into the flow chart 16
Elements 7 Alphabetic overview 47
Searching Copying from the flow chart 27
EN2B-162GE51 R1114 132

RACL EDITOR INDEX
Cutting from the flow chart 27 User adress

Deleting from the flow chart 28 Printing 44
Moving in a column 28
Pasting into the flow chart 27, 28
Selecting 24, 25 W
Status bars 7, 10 Warnings
STIM RACL source translation 100
Statement description 90 XFM loadable source retranslation 103
STO XFM source 102
Statement description 85 WIA
Store Value in Z Register Statement description 81
Statement See STO WIDO
SUB Statement description 91
Statement description 72 Window
Submodule Statement See WIDO
Communication with main module 4
Creating 13
Opening 15 X
Saving as another submodule 38
Saving as XFM 38 XFM
Submodule Call Deleting user adress 34
Statement See MCAL Editing description text 33
Subtraction Editing I/O definitions 33
Statement See SUB Editing user adress 34
SWI XFM
Statement description 91 Creating 14
Switch loadable retranslation errors 103
Statement See SWI loadable retranslation warnings 103
Opening 16
Retranslating loadable files 45
T Saving as submodule 39
Source file structure 2
T Register XFM I/O description
Searching for ... 35 Printing 44
TIME XFM I/O description text
Statement description 84 Printing 44
Time Until Next Change of State XFM User adress list
Statement See TUNC Printing 44
Timer Counter XOR
Statement See RTC Statement description 70
Translating
Source file 30
Translation Z
RACL source information 100
RACL source output errors 99 Z Register
RACL source output warnings 100 Searching for ... 35
XFM source output errors 102 ZEB
XFM source output warnings 102 Statement description 62
TRN Zero Energy Band/Setpoint Optimization
Statement description 76 Statement See ZEB
Troubleshooting 103–17 Zoom factor
Truncate Modifying 12
Statement See TRN Zooming
TUNC Flow chart 41
U
Unconditional Skip
Statement See SKU
UNDO
to revert last operation 29
User adress
Deleting 34
Editing 34
ReAssign 39
Searching for ... 35
133 EN2B-162GE51 R1114

EN2B-162GE51 R1114 134
RACL EDITOR INDEX
135 EN2B-162GE51 R1114

Manufactured for and on behalf of the Environmental and Combustion Controls Division of Honeywell Technologies Sàrl, Rolle, Z.A. La Pièce 16, Switzerland by its Authorized Representative
Automation and Control Solutions
Honeywell International Inc. Honeywell Limited-Honeywell Limitee Honeywell GmbH
1985 Douglas Drive North 35 Dynamic Drive Böblinger Straβe 17
Golden Valley, MN 55422 Scarborough, Ontario M1V 4Z9 71101 Schönaich
USA Canada Germany
http://www.honeywell.com http://www.honeywell.ca http://europe.hbc.honeywell.com
EN2B-0162GE51 R1114 Printed in Germany Subject to change without notice

En2b0162 Ge51r1114

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

En2b0162 Ge51r1114

Uploaded by

Copyright:

Available Formats

Honeywell

EN2B-162 GE51 R1114

BACnet is a registered trademark of the American Society of Heating, Refrigerating

Microsoft and Windows are registered trademarks of Microsoft Corporation. Other

EN2B-162GE51 R1114 Copyright © 2010 Honeywell Inc. • All Rights Reserved

SYSTEM REQUIREMENTS ............................................................................................................................. 13

STARTING THE RACL EDITOR ............................................................................................................................. 14

THE RACL SCREEN ............................................................................................................................. 15

ENDING THE RACL EDITOR ............................................................................................................................. 20

STEP-BY-STEP INSTRUCTIONS ............................................................................................................................. 21

Modifying the Attributes of the Statements on the Flow Chart ............................. 38

SUM Sum ........................................................................................................ 80

APPENDIX ............................................................................................................................. 107

Dialogs ................................................................................................................. 111

INDEX ............................................................................................................................. 128

The Structure of a RACL Program

• Arithmetic and Logic Statements

• Maximal 255 columns

The Structure of an Excel Functional Module (XFM) file

The Flow Chart

The following figure shows schematically an example for processing.

Communication between Main Module and Submodules

NOTE: SLEV as well as END statements are added automatically by the

Minimum Required Recommended

STARTING THE RACL EDITOR

THE RACL SCREEN

The RACL screen shows the following elements:

The main tool bar shows the following buttons:

Creates a new RACL or XFM source file.

Opens an existing RACL or XFM source file.

Saves the currently opened source file.

Cuts the currently selected statement(s).

Copies the currently selected statement(s).

Opens the Zoom dialog box, to set the zoom factor

Opens the Setup dialog box to edit settings

Prints the flow chart shown in the active window.

Shows the About dialog of the RACL Editor.

Statement Group Tool Bar

ARITHMETIC AND LOGICAL statement group

CONTROL statement group

ENERGY MANAGEMENT statement group

MISCELLANEOUS statement group

CONFIGURATION statement group

I/O statement group

Statement Selection Drop Down List

Module Name Field

Source File Window

The lower status bar displays the following:

• Translation errors, warning and information

Cursor shape Cursor name Operation mode

HAND Ready to insert a column

UP ARROW The cursor is at the bottom of the

CROSS Connection is in progress

HAND CARRYING BOX Ready to place a statement in the

HAND CARRYING BOX Ready to place a statement in the

RIGHT ARROW Input pin can be selected

Modifying the Zoom Factor

1. Select Zoom from the View menu.

4. Confirm by clicking OK.

ENDING THE RACL EDITOR

Creating a new Submodule

21 EN2B-162 GE51 R1010

Creating a new XFM