honeywell excel 5000 open system user guide...flow chart. a flow chart is composed of maximal 255...

Honeywell

RACL Editor

USER GUIDE

EN2B-162 GE51 R1114

HONEYWELL EXCEL 5000 OPEN SYSTEM

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

Trademark Information Echelon, LON, LONMARK, LONWORKS, 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

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

5 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

CONTENTS RACL EDITOR

EN2B-162GE51 R1114 6

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

RACL EDITOR CONTENTS

7 EN2B-162GE51 R1114

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

CONTENTS RACL EDITOR

EN2B-162GE51 R1114 8

Dialogs ................................................................................................................. 111 Errors .............................................................................................................. 111 Information and Warnings ............................................................................... 125

Command Line Options ....................................................................................... 126 Initialization (INI) File Entries. .............................................................................. 126 Default Values ...................................................................................................... 127

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

9 EN2B-162GE51 R1114

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

OVERVIEW RACL EDITOR

EN2B-162GE51 R1114 10

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.

RACL EDITOR OVERVIEW

11 EN2B-162GE51 R1114

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.


EN2B-162GE51 R1114 12

The following figure shows schematically an example for processing. 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.

SLEV

F1

F2

Call-up Parameters

Results

SLEV

MCAL “Heating Boiler”

F1

Main Module

Submodule “Heating”

X1

X2

X3

X128

.

.

.

.

.

.

Y1

Y2

Y3

Y128

.

.

.

.

.

.

Function

X1

X3

Y2


13 EN2B-162GE51 R1114

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

80486DX 33 MHz processor or better

IBM PC or 100%-compatible with a Pentium 90 MHz 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


EN2B-162GE51 R1114 14

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”.


15 EN2B-162GE51 R1114

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.


EN2B-162GE51 R1114 16

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


17 EN2B-162GE51 R1114

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.


EN2B-162GE51 R1114 18

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


19 EN2B-162GE51 R1114

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


EN2B-162GE51 R1114 20

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.

21 EN2B-162 GE51 R1010

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.

STEP-BY-STEP INSTRUCTIONS RACL EDITOR

EN2B-162GE51 R1114 22

3. In the Target Drive drop down list, select another drive, if you do not want to save your new main module on the drive set by default.

4. In the Directories list box, select the directory that contains the .PRA file. All the .PRA files saved in the selected directory are listed in the Target Project list box.

5. Select a .PRA file in the Target Project list box. The Project Name, the Controller Name and the Application Program Name for the selected PRA file are displayed in the appropriate fields in the dialog box. If there are any submodules present for the selected .PRA file, they are listed in the Target File Name combo box.

6. Type or select the index of the submodule number that needs to be created into the No field.

7. Enter the internal module name of the submodule to be created into the Internal Module Name field.

8. Confirm by clicking OK. The source file window corresponding to the submodule is opened. It is named appropriate to the previously entered target file name. Its Internal Module Name is shown in the Module Name field and can be edited.

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. 3. In the Target Drive drop down list, select another drive, if you do not want to

save your new main module on the drive set by default.

RACL EDITOR STEP-BY-STEP INSTRUCTIONS

23 EN2B-162GE51 R1114

4. In the Directories list box, select the directory that contains the .PRA file. All the .PRA files saved in the selected directory are listed in the Target Project list box.

5. Enter the name of the XFM file into the Target File Name field. 6. Enter the internal module name of the XFM Source to be created into the

Internal Module Name field. 7. To create the XFM Source, confirm by clicking OK. The source file window

corresponding to the XFM Source is opened. It is named appropriate to the previously entered target file name. Its Internal Module Name is shown in the Module Name field and can be edited.

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 the .PRA files saved in the selected directory are listed in the Target Project /XFM list box.

4. Select a .PRA file from the Target Project /XFM list box. The Project Name, Controller Name and the Application Program Name for the selected. PRA file are displayed in the appropriate fields in the dialog box

5. Select the desired module in the RACL Source list box. or Choose the module by typing the desired number into the No field. 6. Confirm by clicking Open. The source file window corresponding to the main

module and submodule respectively is opened.


EN2B-162GE51 R1114 24

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


25 EN2B-162GE51 R1114

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. 2. Confirm by clicking OK.


EN2B-162GE51 R1114 26

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.


27 EN2B-162GE51 R1114

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. 6. Confirm by clicking OK.

Setting the T Register for the Statement


EN2B-162GE51 R1114 28

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

required by the statement. 3. To assign the T register index, select the entry. 4. Confirm the assignment of the register index by clicking Assign.

5. Confirm by clicking OK.

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.


29 EN2B-162GE51 R1114

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 required by the statement.

3. To assign the constant, select the entry and assign the value of the constant

for the entry into the field and click Assign. The value entered in the field is assigned to the entry in the list box.

4. Confirm by clicking Assign. 5. Confirm by clicking OK.

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.

.


EN2B-162GE51 R1114 30

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.


31 EN2B-162GE51 R1114

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.


EN2B-162GE51 R1114 32

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.


33 EN2B-162GE51 R1114

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.


EN2B-162GE51 R1114 34

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. 2. Move the cursor to the top of the column to be selected till the DOWN ARROW


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.

4. The same procedures mentioned in steps 3 and 4 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 in Execution Sequence 1. Press SHIFT. 2. Move the cursor to the top of the column to be selected till the DOWN ARROW


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.

5. The same procedures mentioned in steps 3 and 4 can be done when the cursor shape is UP ARROW which is displayed when the cursor is positioned at the bottom of the column.


35 EN2B-162GE51 R1114

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.


EN2B-162GE51 R1114 36

2. Apply one of the folowing 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 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: a. Select Paste from Edit menu. b. Use CTRL + V combination. c. Use SHIFT + INS combination

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.


37 EN2B-162GE51 R1114

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


EN2B-162GE51 R1114 38

• 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.


39 EN2B-162GE51 R1114

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.


EN2B-162GE51 R1114 40

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.


41 EN2B-162GE51 R1114

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.


EN2B-162GE51 R1114 42

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


43 EN2B-162GE51 R1114

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.


EN2B-162GE51 R1114 44

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. 4. Confirm by clicking OK.

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.


45 EN2B-162GE51 R1114

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.


EN2B-162GE51 R1114 46

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. 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 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. 7. Confirm by clicking OK.

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.

1. Select Save As... from the File menu. The Save As dialog box appears. 2. Select the drive in the Target Drive list box. 3. Set XFM Source *.MCS in the Save File as Type list box. 4. In the Directories list box, select the directory to which the submodule should

be saved as XFM file. 5. Enter the file name for the XFM source that needs to be created in the Target

File Name field. 6. Enter the internal module name for the XFM source file into the Internal

Module Name field. 7. Confirm by clicking OK. The submodule file is saved as XFM source and the XFM I/O dialog for

obtaining the XFM I/O definition of the XFM is launched. Otherwise an error


47 EN2B-162GE51 R1114

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.

1. Select Save As... from the File menu. The Save As dialog box appears. 2. Select SubModule *.PRA. in the Save File as Type list box. 3. In the Directories list box, select the directory that contains the PRA file to

which the the XFM module should be saved as submodule. 4. In the Target Project list box select the .PRA file. 5. Enter the file name for the submodule that needs to be created in the Target

File Name field. 6. Type or select the index of the submodule number into the No field.

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.


EN2B-162GE51 R1114 48

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


49 EN2B-162GE51 R1114

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


EN2B-162GE51 R1114 50

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


51 EN2B-162GE51 R1114

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


EN2B-162GE51 R1114 52

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. 2. Select the drive in the Target Drive list box. 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.


53 EN2B-162GE51 R1114

Retranslating the XFM’s 1. Select Open from the File menu. The Open dialog box is shown. 2. Select the drive in the Target Drive list box. 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.


EN2B-162GE51 R1114 54

55 EN2B-162 GE51 R1010

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 EXP ex 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

RACL STATEMENTS RACL EDITOR

EN2B-162GE51 R1114 56

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

RACL EDITOR RACL-STATEMENTS

57 EN2B-162GE51 R1114

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

Registers

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.



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

P 2 Z 0 T 0 X 2 Y 1


EN2B-162GE51 R1114 58

Registers


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.


P 3 Z 10 T 2 X 4 Y 2


59 EN2B-162GE51 R1114



Registers


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


P 3 Z 10 T 1 X 5 Y 2


EN2B-162GE51 R1114 60

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.



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)



61 EN2B-162GE51 R1114

Change up, without room sensor (Pa=0) / optimised

Change down, optimised

Change down, not optimised

Change down (optimised or not) followed by optimised off


EN2B-162GE51 R1114 62

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


63 EN2B-162GE51 R1114

Modes

Registers •

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

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)

P 17 Z 13 T 2 X 2 Y 3


EN2B-162GE51 R1114 64

EOH2 Energy Optimized Heating Function see EOH

Registers


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 Function This command calculates the values for Optimum start and Optimum stop for

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.

P 17 Z 13 T 2 X 3 Y 3


65 EN2B-162GE51 R1114

Registers


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) Pf = precool factor (will be adapted, eng. unit: min

K ) Pg = maximum outdoor temperature for optimized setback (eng. unit: °C) Ph = early setback factor (eng. unit: min

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 Function This command calculates the values for Optimum start and Optimum stop for

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 4 Y 3

P 9 Z 6 T 2 X 5 Y 3


EN2B-162GE51 R1114 66

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 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) Pf = precool factor (will be adapted) (eng. unit: min

K ) Pg = maximum outdoor temperature for optimized setback (eng. unit: °C) Ph = early setback factor (eng. unit: min

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


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

P 15 Z 3 T 1 X 7 Y 1


67 EN2B-162GE51 R1114

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


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

P 5 Z 0 T 0 X 4 Y 1


EN2B-162GE51 R1114 68

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



Xb = X Register, contains the outside air temperature 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



Xb = X Register, contains the outside air temperature 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

P 2 Z 0 T 0 X 5 Y 1

P 3 Z 0 T 0 X 5 Y 1


69 EN2B-162GE51 R1114

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


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


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.

P 1 Z 0 T 0 X 1 Y 1

P 1 Z 0 T 0 X 2 Y 2


EN2B-162GE51 R1114 70

Registers


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


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

P 6 Z 1 T 1 X 4 Y 2

P 11 Z 0 T 0 X 5 Y 5


71 EN2B-162GE51 R1114

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.


EN2B-162GE51 R1114 72

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.

XCEn

setpoint

error

deviation

P

D

The portion of the PD algorithm is as follows:

XC = ( )[ ]n

nnD

R tEET

nT E 1 100 −−+

XC = ( )

−+ an

n

DnT ZE

tTE

R

100

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 E

tn n− −1

0 = Rate of change of the deviation Za = Deviation of the preceding RACL cycle n = Current cycle number

Registers


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.

P 2 Z 1 T 0 X 1 Y 1


73 EN2B-162GE51 R1114

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.

XCEn

setpoint

error

deviation

P

Ianti wind up limit

TI

The portion of the PID algorithm is as follows:

XC =

+ ∑

=

n

i I

iinT T

tEER

0

100

XC =

++

I

nnanT T

tEZER

100

Proportional + Integral XC = Control output signal (correction signal) TR = Proportional band (in physical units) En = Current control deviation TI = Reset time tn = Scan time of current RACL cycle Za = Integral part

∑

=

n

i I

ii T

tE0 = Accumulated deviations * scan time / reset time

n = Current cycle number

Registers

P 2 Z 1 T 0 X 1 Y 1


EN2B-162GE51 R1114 74


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

i I

ii T

tE0

or

+

I

nna T

tEZ

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.

XCEn

setpoint

error

deviation

P

I

D

anti wind up limit

TI

The complete PID algorithm is as follows:

Xc = ( )

+

+ −−

=∑ n

nnD

R tEET

n

i I

iinT T

tEE 1 0

100

Xc = ( )

−+

++ bn

n

D

I

nnanT ZE

tT

TtEZE

R

100

Proportional + Integral + Derivative XC = Control output signal (correction signal) TR = Proportional band (in physical units) TI = Reset time TD = Rate time tn = Scan time of current RACL cycle En = Current control deviation En-1 = Previous deviation


75 EN2B-162GE51 R1114

(stored in a Z register during the last RACL cycle)

∑

=

n

i I

ii T


n

nntEE 1−−

= Rate of change of the deviation Za = Integral Part Zb = Deviation of the preceding RACL cycle n = Current cycle number

Registers


Input Xa = X register containing the current deviation. 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:

E n

n

0∑ 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.

I = ∑=

n

i I

ii T

tE0

or I = nI

na E

TtZ +

I = Integral output signal TI = Reset time En = Current deviation tn = Scan time of current RACL cycle

P 3 Z 2 T 0 X 1 Y 1


EN2B-162GE51 R1114 76

∑

=

n

i I

ii T


Za = Integral

tT ni

E0 ( ) = Integral of current cycle

n = Current cycle number

Registers


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.

D = TD nnn

tEE 1−−

D = Derivative output signal TD = Rate time (input as a parameter) tn = Scan time of current RACL cycle En = Instantaneous deviation En-1 = Previous deviation (stored in the Z register. If En-1 is equal to zero, then there was no deviation in the last cycle).

Registers

Execution time 1,168 ms

Input Xa = X register containing the current deviation.

Pa = Parameter number containing the rate time TD.

Result Y = 0 if the input is unchanged since the last cycle.

P 1 Z 1 T 0 X 2 Y 1

P 1 Z 1 T 0 X 1 Y 1


77 EN2B-162GE51 R1114

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


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!

P 1 Z 1 T 0 X 2 Y 1


EN2B-162GE51 R1114 78

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

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


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

Execution time 0.575 ms Input Xa, Xb =X register containing status value 0/l

P 0 Z 0 T 0 X 2..128 Y 1

P 0 Z 0 T 0 X 2..128 Y 1

P 0 Z 0 T 0 X 2 Y 1


79 EN2B-162GE51 R1114

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


Input none

Result Y = C

Related statements SIMF

SIMF Float Constant Function Set output Y to C

Registers


Input none Result Y = C

Related statements SIMI

MUL Product Function Multiply/Sum the contents of 2 or more X registers.

P 0 Z 0 T 0 X 0 Y 1

P 0 Z 0 T 0 X 0 Y 1


EN2B-162GE51 R1114 80

Registers


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


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


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

P 0 Z 0 T 0 X 2..128 Y 1

P 0 Z 0 T 0 X 2..128 Y 1

P 0 Z 0 T 0 X 2 Y 2


81 EN2B-162GE51 R1114

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


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

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

P 1..128 Z 0 T 0 X 1..128 Y 1..128

P 0 Z 0 T 0 X 1... Y 1...


EN2B-162GE51 R1114 82

Function Division of two X registers. The result is transferred to the Y register.

Registers


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


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

P 0 Z 0 T 0 X 2 Y 1

P 1..128 Z 0 T 0 X 1..128 Y 1


83 EN2B-162GE51 R1114

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

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


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


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.

P 1..128 Z 0 T 0 X 1 Y 1

P 0 Z 0 T 0 X 2..128 Y 1

P 0 Z 0 T 0 X 2..128 Y 1


EN2B-162GE51 R1114 84

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


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


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 2

P 0 Z 0 T 0 X 1..128 Y 1..128

P 0 Z 0 T 0 X 1 Y 1


85 EN2B-162GE51 R1114


Input X

Result Y = exp(X)

LN Logarithm Function Logarithm to the base of e

Registers


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


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)

P 0 Z 0 T 0 X 1 Y 1

P 0 Z 0 T 0 X 1 Y 1


EN2B-162GE51 R1114 86

Registers

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

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:

P 0 Z 0 T 0 X 0 Y 1

P 0 Z 0 T 0 X 1 Y 0


87 EN2B-162GE51 R1114

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 Input User address = Input the user address whose attribute values are to be transferred

to the next Y register. Output One or more point attributes. The number of outputs matches the number of

attributes entered.

RIA Attributes Table The following table lists attributes that will be selectable for various point types.

Attribute text AI DI DO AO PI PA PD GA GD FP PP Access attribute R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W Write protection R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W Manual value R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W Auto value R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W MaR/Wimum limit 1 R/W R/W MaR/Wimum limit 2 R/W R/W Minimum limit 1 R/W R/W Minimum limit 2 R/W R/W Suppress Alarm R/W R/W R/W R/W R/W R/W R/W R/W R/W Alarm Dead Time R/W R/W Point in Alarm R R R R R Alarm Status R/W R/W R/W Alarm Min/MaR/W R R

P 0 Z 0 T 0 X 0 Y Number of

attributes


EN2B-162GE51 R1114 88

Attribute text AI DI DO AO PI PA PD GA GD FP PP Flag Alarm_1/2 Flag R R Critical R R R R Hours run R/W R/W R/W Enable Runtime R/W R/W R/W Switch on counter R R R Motor Runtime (open) R/W Motor Runtime (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 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.


89 EN2B-162GE51 R1114

Registers 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.

Attribute text AI DI DO AO PI PA PD GA GD FP PP Access attribute R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W Write protection R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W Manual value R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W Auto value R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W MaR/Wimum limit 1 R/W R/W MaR/Wimum limit 2 R/W R/W Minimum limit 1 R/W R/W Minimum limit 2 R/W R/W Suppress Alarm R/W R/W R/W R/W R/W R/W R/W R/W R/W Alarm Dead Time R/W R/W Point in Alarm R R R R R Alarm Status R/W R/W R/W Alarm Min/MaR/W Flag R R Alarm_1/2 Flag R R Critical R R R R Hours run R/W R/W R/W Enable Runtime R/W R/W R/W Switch on counter R R R Motor Runtime (open) R/W Motor Runtime (close) R/W Remote Pt failed R R Operation mode R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W Is Slave R R Trend log R/W R/W R/W R/W R/W R/W R/W R/W R/W Refresh Enabled R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W Alarm Hysteresis R/W R/W Trend Hysteresis R/W R/W R/W R/W Override Status R R Broadcast Hysteresis R/W Invisible R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W Data Point Enabled R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W R/W Engineering Unit R/W R/W R/W R/W R/W R/W Tech. Addr. Contr. R R R R R R/W R/W R Tech. Addr. Board R/W R/W R/W R/W R/W R/W R/W R/W R/W R Tech. Addr. Point R/W R/W R/W R/W R/W R/W R/W R

P 0 Z 0 T 0 X Number of

attributes Y 0


EN2B-162GE51 R1114 90

Attribute text AI DI DO AO PI PA PD GA GD FP PP No Response R R R R R R R R R R R Subtype R/W R/W R/W R/W R/W Characteristic R/W R/W

AI = Analog Input DI = Digital Input DO = Digital Output AO = Analog Output PI = Pulse Input (Totalizer) PA = Pseudo Analog PD = Pseudo Digital GA = Global Analog GD = Global Digital FP = Flexible Point PP = Pseudo Pulse (Pseudo Totalizer) R = Read Access (RIA) R/W = Read (RIA) / Write (WIA) Access


91 EN2B-162GE51 R1114

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


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


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

P 1 Z 1 T 1 X 2 Y 2

P 0 Z 0 T 0 X 2 Y 1


EN2B-162GE51 R1114 92

conditions occur the counter reset has priority. The count is transferred to the Y register.

Registers


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


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 2 T 0 X 2 Y 1

P 0 Z 0 T 0 X 0 Y 1

P 0 Z 0 T 0 X 0 Y 1


93 EN2B-162GE51 R1114

Execution time 0.944 ms 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


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

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.

P 1..128 Z 0 T 0 X 1 Y 1

P 0 Z 0 T 0 X 1..128 Y 1..128


EN2B-162GE51 R1114 94

Registers

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


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


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

P 0 Z 1..128 T 0 X 1..128 Y 0

P 0 Z 1..128 T 0 X 0 Y 1..128

P 0 Z ? T 0 X 2 Y 2


95 EN2B-162GE51 R1114

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


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

Execution time 2.474 ms 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

P 0 Z ? T 0 X 1 Y 1

P 1 Z 2 T 1 X 1 Y 1


EN2B-162GE51 R1114 96

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


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


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

P 1..128 Z 0 T 0 X 0 Y 1..128

P 0 Z 0 T 0 X 1..128 Y 0


97 EN2B-162GE51 R1114

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


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


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


Input Xa

Xb

Result Y = 0 if Xa < Xb Y = 1 if Xa > Xb Y = previous state if Xa = Xb

TIP

P 0 Z 2 T 0 X 2 Y 2

P 0 Z 0 T 1 X 0 Y 1

P 0 Z 1 T 0 X 2 Y 1


EN2B-162GE51 R1114 98

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


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


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

P 0 Z 0 T 0 X 2 Y 1

P 0 Z 1 T 1 X 1 Y 0


99 EN2B-162GE51 R1114

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


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

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.

P 0 Z 0 T 0 X 3 Y 1

P 0 Z 0 T 0 X 3..128 Y 1


EN2B-162GE51 R1114 100

Registers


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


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

P 2 Z 0 T 0 X 1 Y 1

P 0 Z 0 T 0 X 0 Y 1


101 EN2B-162GE51 R1114

Program Flow

SKU Unconditional Skip Function Skip forward to the first command of the defined column.

Registers


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


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.

P 0 Z 0 T 0 X 0 Y 0

P 0 Z 0 T 0 X 1 Y 0


EN2B-162GE51 R1114 102

Registers

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


Input Ya, Yb, ... = Y registers of the submodule which are to be transferred to the Main

Module.

P 0 Z 0 T 0 X depends on

submodule Y depends on

submodule

P 0 Z 0 T 0 X depends on the submodule Y depends on the submodule


103 EN2B-162GE51 R1114

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


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.

P 0 Z 0 T 0 X 0 Y 0


EN2B-162GE51 R1114 104

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


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


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

CP 1..128 Z 0 T 0 X 0 Y 1..128

CP 1..128 Z 0 T 0 X 1..128 Y 0

P 0 Z 0 T 0 X 2..128 Y 2


105 EN2B-162GE51 R1114

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 be >= 223 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


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

P 0 Z 0 T 0 X 1 Y 1..128


EN2B-162GE51 R1114 106

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

107 EN2B-162 GE51 R0107

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 SKIP statement

The column value specified in the SKP, SKZ 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 does not match sub - module

The number of inputs and outputs of the 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.

APPENDIX RACL EDITOR

EN2B-162GE51 R1114 108

Warnings

Warning Message Meaning of Warning 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 address

Two or more statements are writing into the same 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

RACL EDITOR APPENDIX

109 EN2B-162GE51 R1114

RACL Loadable Retranslation Outputs

Errors

Error Message Meaning of Error 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 present

The loadable file(s) are not 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.


EN2B-162GE51 R1114 110

XFM 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 SKIP statement

The column value specified in the SKP, SKZ and 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 Message Meaning of Warning 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 address

Two or more statements are writing into the same User Address.

Warning: XFM I/O definition is not complete

The I/O definition for the XFM source is not complete.


111 EN2B-162GE51 R1114

XFM Loadable Retranslation Errors

Errors

Error Message Meaning of Error Error: Invalid opcode The opcode used in the XFM source is not found

in the statement definition file

Warnings

Warning Message Meaning of Warning Warning: Description text too long to accommodate in buffer

The description text is longer than the internal 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.


EN2B-162GE51 R1114 112

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.


113 EN2B-162GE51 R1114

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.


EN2B-162GE51 R1114 114

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


115 EN2B-162GE51 R1114

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.


EN2B-162GE51 R1114 116

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.


117 EN2B-162GE51 R1114

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.


EN2B-162GE51 R1114 118

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


119 EN2B-162GE51 R1114

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.


EN2B-162GE51 R1114 120

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.


121 EN2B-162GE51 R1114

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.


EN2B-162GE51 R1114 122

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


123 EN2B-162GE51 R1114

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


EN2B-162GE51 R1114 124

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.


125 EN2B-162GE51 R1114

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


EN2B-162GE51 R1114 126

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= /p= /c= /cnum=

Default path for open and save Project Name Controller Name 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


127 EN2B-162GE51 R1114

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, parameter, Z register, T register etc.

Red

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


EN2B-162GE51 R1114 128

RACL EDITOR

129 EN2B-162GE51 R1114

INDEX

A Abbreviations 1 About dialog 12 Access lists

Printing 44 ADAH

Statement description 49 Adaption of the Heating Curve Parameters

Statement See ADAH, ADH2 See ADAH, ADH2 Adding

Statements into the flow chart 16 See SUM ADH2

Statement description 50 AOP

Statement description 78 Arithmetic Difference

Statement See NOT Arithmetic Statements 70 Attributes

Searching for ... 35 Attributes

Modifying 30

C CDEL

Statement description 83 Color

of statements selected from output window 37 of statements with unassigned inputs 37 of statements with unassigned parameters 36

Columns Inserting into the flow chart 28 Selecting in the flow chart 25

Command Line 118 Command line options 118 COMP

Statement description 83 Conditional Skip

Statement See SKP, SKZ Conditional Transfer

Statement See SWI Configuration Statements 96 Constants

Setting for the statement 20 CONT

Statement description 84 12 Contol Statements 64 Controlled Alarm Delay

Statement See CDEL Copying

Statements from the flow chart 27 Counter

Statement See CONT CPAR

Statement description 96 Creating

Main module 13

Submodule 13 XFM 14

Cursor shapes 11 Cutting

Statements from the flow chart 27

D DATE

Statement description 84 Default values 119 Deleting

Entry of the parameter file 32 Source file 42 Statements from the flow chart 28 XFM user adress 34

Derivative Statement See DIFT

Description text Editing 33

DEWP Statement description 61

Dewpoint Statement See DEWP

Dialog Errors 103

DIFT Statement description 68

DIV Statement description 74

Division Statement See DIV

DUC Statement description 62

E Editing

I/O definitions 33 Parameter of a source file 32 XFM description text 33 XFM user adress 34

END Statement description 94

End Main Module Statement See END

End Submodule Statement See END

Ending RACL Editor 12

Energy Management Statements 49 Energy Optimized Heating

Statement See EOH, EOH2 See EOH, EOH2 Energy Optimized Ventilation

Statement See EOV, EOV2 See EOV, EOV2 ENT

Statement description 61 Enthalpy

Statement See ENT EOH

Statement description 52 EOH2

INDEX RACL EDITOR

EN2B-162GE51 R1114 130

Statement description 56 EOV

Statement description 56 EOV2

Statement description 57 EQL

Statement description 85 Equal

Statement See EQL Error

Cause 103–17 Correction 103–17 Messages 103–17

Errors Cause and correction of dialog errors 103–17 RACL loadable source retranslation 101 RACL source translation outputs 99 shown in dialog boxes 103 XFM loadable source retranslation 103 XFM source 102

Excel Functional Module See XFM EXP

Statement description 76 Exponent

Statement See EXP

F Float Constant

Statement See SIMF Flow chart 5

Adding statements into 16 Copying statements from 27 Cutting statements from 27 Deleting statements from 28 Inserting columns into 28 Moving statements in a column 28 Part of a program 1 Pasting statements into 27, 28 Previewing 41 Printing 41, 43 Selecting columns 25 Selecting statements 24, 25 Zooming 41

Format of statement definition file 2

H Hardware requirements 5 HC

Statement description 49 Heating Curve

Statement See HC HYS

Statement description 68 Hysteresis

Statement See HYS

I I/O definitions

Editing 33 IBIT

Statement description 78 Identity

Statement See IDT IDT

Statement description 85 Indexed Recall

Statement See IRCL Indexed Store

Statement See ISTO Information

RACL source 100 INI file

Initialization 118 Modifying entries 36 Sections 118

Initialization INI file 118

INP Statement description 78

Input Connecting with output 23

Inputs Statements See INP, IBIT, NBIT

INRT Statement description 67

Inserting Columns into the flow chart 28

Integer Constant Statement See SIMI

Integral Statement See INRT

Intermittent Operation Statement See DUC

IRCL Statement description 87

ISTO Statement description 86

L Limitations

of source file 2 LIN

Statement description 74 Linear Product

Statement See LIN Logic Statements 70 Logical Comparison

Statement See COMP Logical NOT

Statement description 71

M Main module

Setting RACL flags 36 Main module

Communication with submodules 4 Creating 13 Opening 15 Saving as 37

Main tool bar 7, 8 MCAL

Statement description 93 Menus 7, 8 Merge Values

Statement See MRG MIN

RACL EDITOR INDEX

131 EN2B-162GE51 R1114

Statement description 75 Minimum

Statement See MIN Modifying

Attributes of a statement 30 Entries of the INI file 36 Statement 30 Zoom factor 12

Module Name field 9

Module Name field 7 Modulo Division

Statement description See SPLT Monoflop Timer

Statement See MTIM Moving

Statements in a column 28 MRG

Statement description 96 MTIM

Statement description 87 MUL

Statement description 71 Multiplex

Statement See MUX Multiplication

Statement See MUL MUX


N NBIT

Statement description 78 NEG

Statement description 73 Negate

Statement See NEG Next Column

Statement See SLEV Night Cooling Operation

Statement See NIPU, NIPH See NIPU, NIPH NIPH

Statement description 60 NIPU

Statement description 60 No Operation

Statement See NOP NOP

Statement description 95 NOT


O OBIT

Statement description 78 Opening

Main module 15 Submodule 15 XFM 16

Operation Reverting the last 29

OR Statement description 70

Output

Connecting with input 23 Window 31

Output window 10 Output Window 7 Outputs

RACL loadable source retranslation errors 101 RACL source information 100 RACL source translation errors 99 RACL source translation warnings 100 Statements See AOP, OBIT XFM source translation errors 102 XFM source translation warnings 102

P PAR

Statement description 88 Parameter

Searching for ... 35 Parameter

Deleting from the parameter file 32 Editing 32

Parameter file Deleting parameter 32

Parameters Printing 44

Pasting Statements into the flow chart 27, 28

PD Statement description 64

PD Controller Statement See PD

PI Statement description 65

PI Controller Statement See PI

PID Statement description 66

PID Controller Statement See PID

POL Statement description 75

Polynomia Statement See POL

PRA File 1 Preview

Flow chart 41 Printing

Access lists 44 Flow chart 41, 43 Parameters 44 Reports 44 User adress 44 XFM I/O description 44 XFM I/O description text 44 XFM User adress list 44

Programm Flow Statements 93 Project

Saving as different project 40

R RACL

Project 1 Screen 7

RACL Editor

INDEX RACL EDITOR

EN2B-162GE51 R1114 132

Ending 12 General 1 Overview 1

RACL flags Setting for the main module 36

RACL Program Structure 1

RACL source Retranslating loadable files 44

RCL Statement description 86

Read Configuration Parameter Statement See CPAR

Read Parameter Statement See PAR

Read Time Statement See RTIM

ReAssign User adress 39

Recall Z Register Statement See RCL

Registers 3 Printing 44

Reports Printing 44

Retranslating RACL loadable files 44 XFM loadable files 45

Retranslation RACL loadable source output errors 101 XFM loadable errors 103 XFM loadable warnings 103

Reverting last operation 29

RIA Statement description 79

RNDI Statement description 76

Round Statement See RNDI

RS Flip-Flop Statement See SETL

RTC Statement description 88

RTIM Statement description 89

S Saving

Project as 40 Saving

Source file 30 Saving as main module

Main module 37 Saving as submodule

Submodule 38 XFM 39

Saving as XFM Submodule 38

SCPR Statement description 96

Screen of the RACL Editor 7

Screen Elements 7

Searching

for a parameter 35 for a T Register 35 for a user adress 35 for a Z register 35 for attributes 35

Selecting Columns in the flow chart 25 Statements in the flow chart 24, 25

SET Statement description 89

Set Configuration Parameter Statement See SCPR

Set Output Statement See SET

Set Parameter Statement See SPR

Set Timer Statement See STIM

SETL Statement description 90

Setting RACL flags for the main module 36

SIMF Statement description 71

SIMI Statement description 71

SKP Statement description 93

SKU Statement description 93

SKZ Statement description 93

SLEV Statement description 94

Software requirements 5 Source file

Deleting 42 Source file

Editing parameter 32 Saving 30 Translating 30

Source file limitations 2 Source file window 7, 9 Split Values

Statement See SPLT SPLT

Statement description 97 used for Modulo Division 74

SPR Statement description 88

Statement Assigning parameter file index 23 Assigning parameters 18 Assigning submodule index 23 Definition file 2 Groups 2 12 Modifying 30 Setting constants 20

Statement group tool bar 7, 8 Statement selection drop down list 7, 9 Statements

Set color 36, 37 Statements 3

Adding into the flow chart 16 Alphabetic overview 47 Copying from the flow chart 27

RACL EDITOR INDEX

133 EN2B-162GE51 R1114

Cutting from the flow chart 27 Deleting from the flow chart 28 Moving in a column 28 Pasting into the flow chart 27, 28 Selecting 24, 25

Status bars 7, 10 STIM

Statement description 90 STO

Statement description 85 Store Value in Z Register

Statement See STO SUB

Statement description 72 Submodule

Communication with main module 4 Creating 13 Opening 15 Saving as another submodule 38 Saving as XFM 38

Submodule Call Statement See MCAL

Subtraction Statement See SUB

SWI Statement description 91

Switch Statement See SWI

T T Register

Searching for ... 35 TIME

Statement description 84 Time Until Next Change of State

Statement See TUNC Timer Counter

Statement See RTC Translating

Source file 30 Translation

RACL source information 100 RACL source output errors 99 RACL source output warnings 100 XFM source output errors 102 XFM source output warnings 102

TRN Statement description 76

Troubleshooting 103–17 Truncate

Statement See TRN TUNC


U Unconditional Skip

Statement See SKU UNDO

to revert last operation 29 User adress

Deleting 34 Editing 34 ReAssign 39 Searching for ... 35

User adress Printing 44

W Warnings

RACL source translation 100 XFM loadable source retranslation 103 XFM source 102

WIA Statement description 81

WIDO Statement description 91

Window Statement See WIDO

X XFM

Deleting user adress 34 Editing description text 33 Editing I/O definitions 33 Editing user adress 34

XFM Creating 14 loadable retranslation errors 103 loadable retranslation warnings 103 Opening 16 Retranslating loadable files 45 Saving as submodule 39 Source file structure 2

XFM I/O description Printing 44

XFM I/O description text Printing 44

XFM User adress list Printing 44

XOR Statement description 70

Z Z Register

Searching for ... 35 ZEB

Statement description 62 Zero Energy Band/Setpoint Optimization

Statement See ZEB Zoom factor

Modifying 12 Zooming

Flow chart 41

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

honeywell excel 5000 open system user guide...flow chart. a flow chart is composed of maximal 255...

Documents