E2 User`s Manual Supplement - Emerson Climate Technologies
Contents
1. 026 1620 Rev 2 06 APR 2010 EZ Function Description Examples NEWYEAR Returns a 1 0 if the year has changed since the last NEWYEAR result ON transitiononce time the algorithm has been run Otherwise it returns per year 0 0 The result is a short ON transition once per year NEWYEAR result ERROR no paren at 12 midnight on January Ist Parenthesis accepts no thesis arguments but empty parenthesis must still be placed at the end of this function name in the equation TIME Returns the current time in the number of seconds TIME at 00 01 00 result 60 since midnight Parenthesis accepts no arguments but TIME at 06 45 00 result 24300 empty parenthesis must still be placed at the end of TIME result ERROR no parenthesis this function name in the equation MINUTEO Returns the minute portion of the current time Paren MINUTE at 00 14 00 result 14 thesis accepts no arguments but empty parenthesis MINUTE at 12 00 00 result 0 must still be placed at the end of this function name in MINUTE result ERROR no parenthe the equation sis HOUR Returns the hour portion of the current time in24 hour HOUR at 00 14 00 result 0 format Parenthesis accepts no arguments but empty HOUR at 14 00 00 result 14 parenthesis must still be placed at the end of this func HOUR result ERROR no parenthesis tion name in the equation DAYO Returns the day of the month Parenthesis accep2. 026 1620 Rev 2 06 APR 2010 Ee EINSTEIN E2 User s Manual Supplement Flexible Combiner Programming n A y I EMERSON gt gt EMERSON 3240 Town Point Drive NW Suite 100 Kennesaw GA 30144 Phone 770 425 2724 Fax 770 425 9319 ALL RIGHTS RESERVED The information contained in this manual has been carefully checked and is believed to be accurate However Computer Process Controls Inc assumes no responsibility for any inaccuracies that may be contained herein In no event will Computer Process Controls Inc be liable for any direct indirect special incidental or consequential damages resulting from any defect or omission in this manual even if advised of the possibility of such damages In the interest of continued product development Com puter Process Controls Inc reserves the right to make improvements to this manual and the products described herein at any time without notice or obligation FCC COMPLIANCE NOTICE This device complies with Part 15 of the FCC Rules Operation is subject to the fol lowing two conditions 1 this device may not cause harmful interference and 2 this device must accept any interference received including interference that may cause undesired operation CE COMPLIANCE NOTICE Class A Product Information for Einstein E2 Controllers The Retail Solutions Einstein and E2 controllers are Class A products In a domestic environment this product may cause radio interferen
3. 1 4 1 4 2 Output EQuaQuions ii 1 4 LAS Delay Equations TS TE 1 5 1 4 4 Pulse Width TA AAA O 1 5 1 5 ENGINEERING UNITS su 2 528 es hakk nn BIER Ionen 1 6 156 DESCRIPTION PROPERTIES R EEE na 1 7 1 7 ALARMS 0 A A 1 7 2 BUILDING EQUATIONS 0000800 0800880 0800880 080 0880880 0880080 06 2 1 2 1 INPUT AND OUTPUT VARIABLES nn E E A guste 2 1 2 2 CONSTANTS Hessens in E ee Ad 2 2 2 2 1 Constants and Engineering Units 2 2 2 2 2 Specifying a Constant s Engineering Unit with Type 2 3 44243 Time AY LAR EE E ER OS ONO 2 3 2 3 O O NN 2 5 2 3 1 Multiple Operators and Parenthesis ucesessersersnersnesnnennesnnennennernnennnsnnnnnonsnennonsonnansnennnnsensnnnnensonnnensnnsnensensnn 2 5 2 4 FUNCTIONS ERDE iaa 2 6 2 4 1 Extended Math Functions a kA Sada a 2 7 2 4 2 Extended Logical Functions 10113 iiv ein da qe paves eta rd in 2 9 2 4 3 L garithm ENCINA ais 2 10 2 4 4 Trigonometry FUNCTIONS Wa didnt 2 10 2 4 5 Anal g Change Detection A NOS 2 11 2 4 6 Unit Conversion and Temperature Functions oonoconcncnnnonnonnnanonannnnonac na
4. C per hour F foot candles FM F per minute L UX i P j INW inches of water O ohms CMW cm of water R revolutions per minute PSI pounds per RPMM square inch BAR bars DINW differential inches of water KPA kilopascals DCMW differential cm of water A pascals DPSI i sure in PSI RH relative humidity DBAR differential in bars TC UX DCM C per minute PPM ars per million HM PM I U S jo v 3 S 3 o E en T EE DKPA differential in kilopascals FPM feet per minute Table 2 6 Type Suffixes for Flexible Combiner Constants Constants Suffix Unit Unit meters per min differential in ute pascals meters per sec GAL gallons ond gallons per min L liters ute 1 9 iters per second CF cubic feet cubic meter cubic feet per CM minute cubic meters CCF cubic centi feet per second V volts CCFH cubic centi feet per hour milliamps M meters percent Table 2 6 Type Suffixes for Flexible Combiner Constants M M G PS PM LPS FM MS A MA PCT It is important to note that when type suffixes are used that are different from the E2 s internal SI values they are converted to the SI units behind the scenes For exam ple the equation AI1 0 2BAR actually adds 20 000 to the raw value of 0 2 bars converted to pascals or 20 000PA Type Suffixes for Temperature Offsets DDF and DDC If you are using a
5. Using AMI asa counter that increments when DI is ON The current value of AM1 will be preserved even if the E2 is rebooted The output of analog mem ory equation is stored so the value is consistent across reboots This is useful for implementing long term counters or timers Table 1 1 Commonly Used Equation Examples 026 1620 Rev 2 06 APR 2010 Desired Function Equation Turn on an DO2 exhaust fan at CUTINOUT AI1 120DF 100DF DO2 DO2 when a temperature rises above 120 F and turn it off again when the tempera ture falls below 100 F AND combi nation of digi AND DI1 DI8 tal inputs DI through DI8 Table 1 1 Commonly Used Equation Examples 1 4 3 Delay Equations RX 366 Unit 13 16 89 16 DO1 On Delay Line 2 DO3 On Delay Line 2 DO4 On Delay Line 2 001 Off Delay Line 2 DO2 Off Delay Line 2 H DO3 Off Delay Line 2 Off Delay Line 2 F1 TAB F2 NEXT TAB F4 STATUS F5 CANCEL Figure 1 6 Flexible Combiner Delay Equations The digital outputs of a Flex Combiner application have optional equations that can be used to program ON and OFF delays If the outputs are directly controlling devices ON and OFF delays can help minimize switching by turning the output ON or OFF only when the equation result that caused the transition remains in that state for longer than the delay In other word
6. 7 Parenthesis accepts no arguments but empty parenthesis must still be placed at the end of this function name in the equa tion 6 0 Friday DAYOFWEEK on 07 04 2005 result 2 0 Monday Table 2 17 Time and Date Functions Functions Functions 2 13 ee Function Description Examples DAYOFYEAR Returns a number from 1 365 based on the current day DAYOFYEARO on 01 07 2005 result 7 of the year from Jan 1 1 to Dec 31 365 or 366 if a DAYOFYEAR on 07 04 2005 result leap year 185 YEARFRAC Returns a decimal from 0 0 to 1 0 equal to the current YEARFRAC on 01 07 2005 result DAYOFYEAR divided by the number of days in the 0 02 year YEARFRAC on 07 04 2005 result 0 51 FIRSTRUN Returns a one if the flexible combiner cell has just FIRSTRUN immediately following an been created for example after a reboot It will remain a one for one control loop Otherwise it will return zero E2 reboot result 1 UDRO Returns the update rate in seconds of the flexible com biner This can be used by the functions to do math based on the update rate of the cell The update rate is set in the General tab Assume the Flex Combiner s update rate is set to 0 0 20 UDR result 20 Table 2 17 Time and Date Functions 2 4 9 IF Functions Function Description Examples IF value true false If value is non zero returns the value of true If value is zero returns
7. Other times errors will be due to equations being properly formed but wrongly constructed resulting in unexpected results and potentially math error conditions such as dividing by zero For this reason after building your equations in the Flexible Combiner you must check the application status to make sure there are no syntax errors and you must also test your equation to make sure it is functioning the way it was intended 3 1 The Status field in the Flexible Combiner Status screen is the first place you should look for error mes Checking for Errors sages If all equations are formatted in a way the Flex Combiner application understands and the equations are yielding valid results the Status will read OK Other wise if there are problems the Status field will read Math Error When the Status field reads Math Error you can check Detailed Status to learn more about which equation is causing the error and why it is occurring To access the Eq Errors screen of Detailed Status 1 Press to bring up the Actions Menu 2 Select Detailed Status 3 Press twice to scroll over to the Eq Errors screen 68 26 RX 366 Unit 13 Use Ctrl X to Select CX Tabs DETAILED STATUS Eq Errors CH MMH Flexible Combiner FLEXCEL61 Eq Errors ALG STATUS Mat error ED Bad Type A04 EQ ERR D01 EQ ERR DO1 ON EQ ERR DO2 ON EQ ERR DO3 ON EQ ERR DO2 OFF EQ
8. a 1 0 ifthe minute has changed since the last NEWMINUTEO result ON transition time the algorithm has been run Otherwise it returns once per minute a zero The result is a short ON transition about once NEWMINUTE result ERROR no per minute Parenthesis accepts no arguments but parenthesis empty parenthesis must still be placed at the end of this function name in the equation NEWHOURO Returns a 1 0 ifthe hour has changed since the last NEWHOUR result ON transition time the algorithm has been run Otherwise it returns once per hour a zero The result is a short ON transition once per NEWHOUR result ERROR no paren hour on or about the top of the hour Parenthesis thesis accepts no arguments but empty parenthesis must still be placed at the end of this function name in the equa tion NEWDAY Returns a 1 0 ifthe day has changed since the last time NEWDAY result ON transition once the algorithm has been run Otherwise it returns a per day zero The result is a short ON transition once per day NEWDAY result ERROR no parenthe on or around midnight Parenthesis accepts no argu sis ments but empty parenthesis must still be placed at the end of this function name in the equation NEWMONTH Returns a 1 0 if the month has changed since the last NEWMONTHO result ON transition once per month NEWMONTH result ERROR no parenthesis Table 2 17 Time and Date Functions 2 12 E2 User s Manual Supplement Flexible Combiner
9. build equations in detail 1 4 1 Types of Equations and Where Equations are Entered There are three different screens in the Flexible Com biner setup for output equations Screen 4 the Output Eq screen is where equations that determine the output s value are entered Screen 5 the Delay Eq screen is only visible if dig ital outputs are present Equations that determine the ON and OFF delays for digital outputs are entered in this screen Screen 6 the PW Eq screen is only visible if one or more digital outputs have been set up as one shot outputs Equations that determine the pulse width and period are entered in this screen Each of these screens lists the application outputs that apply to it along with a 40 character field where the equa tion must be entered Section 2 Building Equations provides a detailed explanation of equation syntax in the Flexible Combiner application Using the Second Line If the Show Eq Line 2 field is set to Yes in Screen 1 a Line 2 field will be directly underneath each equa tion to expand the total equation size to 80 characters If an equation takes more than 40 characters to write simply write the first 40 characters in the first line and write the remaining ones in the second line as ifit were an extension of the first line You can split variable names constants etc between the two lines with no problem For example if while writ ing an equatio
10. dewpoint that cannot be handled with operators alone Functions For these reasons the Flexible Combiner offers a large number of functions that can be used in output eguations A function is essentially asmall mathematical formula that accepts one or more variables as inputs and returns a numeric result In an equation a function typically takes the form of the name ofthe function followed by a set of parenthesis that contain the value or values the function will use as inputs The values inside the parenthesis of a function may be constants or inputs Functions are always evaluated first in an equation from left to right unless parenthesis are used before operators are executed 026 1620 Rev 2 06 APR 2010 2 4 1 EZ Extended Math Functions Function Description Examples MOD number divisor Divides the number by the divisor and returns the modulo or the remainder of the division operation In the example MOD 16 5 the modulo is 1 because 5 goes into 16 three times with a remainder of 1 MOD 16 5 result I MOD 16 7 5 result 1 7 MOD 4 2 result 0 of rounding for positive numbers 0 5 or above rounds the integer UP less than 0 5 rounds down for negative numbers 0 5 or above rounds DOWN less than 0 5 rounds UP ABS number Returns the absolute value of the number ABS 14 result 14 ABS 7 7 result 7 7 FRAC value Returns the decimal part of the numbe
11. first fol lowed by the multiplication and finally the exponent resulting in 441 EXAMPLE EQUATIONS INPUTS CONSTANTS AND OPERATORS Equation Description AI4 60 The value of 14 plus 60 DI1 DI2 The expression DI1 DI2 returns a 1 0 when both inputs are ON and a 0 0 if only one or the other is ON The at the beginning of this equation then inverts the result of that expression The final result is a logical XOR of and DI2 Note this can be done more elegantly with the XOR function which is explained later in this section DII amp amp DI2 AIl Because amp amp DI2 is in parenthesis the logical AND of and DI2 is performed first The result of this is multiplied with AI1 This means the output will be equal to 1 0 AI1 when DII and DID are both ON and zero 0 0 AI1 when one or both are OFF Table 2 9 Equation Examples Inputs Using Constants 2 6 E2 User s Manual Supplement Flexible Combiner ee 2 4 Eguations for most applications can be built using nothing but inputs constants and operators However in some cases it is notalways practical or easy to use nothing but these components and in some cases the eguation you d have to build would exceed the 80 character limit Furthermore you may sometimes need eguations to do more complicated things such as converting a floating point number to an integer or converting a temperature to
12. the value of false In this function value true and false can each be sep arate equations that include inputs operators and functions IF ATI gt 70DF AT2 0 0 result 1 if is equal to or greater than 70DF otherwise 0 IF VOTE DI1 DI8 AI3 AI4 result AI3 if more than four of the eight DI inputs are ON otherwise 14 IF TIME gt 64800 1 0 0 0 result 1 0 if current time is between 9 p m 64 800 seconds past midnight and midnight when TIME resets to 0 seconds past midnight Otherwise 0 0 Table 2 18 IF Function 2 14 E2 User s Manual Supplement Flexible Combiner 026 1620 Rev 2 06 APR 2010 3 Testing and Troubleshooting Equations 300 Unit 13 Flex Combiner 18 87 27 ALARN 1m m m Flexible Combiner Name FLEXCELO1 Analog Inputs 11 397 4 12 7 8 13 12 8 AIS 17 8 Status Math Error Analog Outputs Digital Inputs Digital Outputs One Shot State Trigger D01 ON 002 ON D03 OFF DO4 OFF F1 SUCTION Figure 3 1 Troubleshooting Equations Because building equations is a complex process it will not be uncommon to experience errors when program ming a Flexible Combiner Sometimes these errors will be due to typographic errors like misspelling function names or failing to close parenthesis Often these sorts of errors will be noticed immediately by the Flexible Combiner application and you will get an error message immediately
13. to 14400 seconds In all cases time constants are all converted to a num ber of seconds when used by the Flex Combiner so that mathematical operations like 00 01 00 2 results in 120 60 seconds multiplied by 2 In the case of a time constant in HH MMx format this can be used along with the TIME function to do compar isons between the current time and the setpoint For exam ple IF TIME gt 06 00p TRUE 60 50 compares the current TIME which returns the time in a number of sec onds since midnight to 06 00p which is converted to 21600 seconds EXAMPLE EQUATIONS INPUTS AND CONSTANTS Equation Description 14 60 The value of 14 plus 60 PI 10M 2 AI2 Assuming 12 is a linear sensor whose output reflects a water level position in meters this equation calcu lates the volume of a cylin drical tank whose radius is 10 meters The constant PI is multiplied by the radius squared 10M 2 to yield the circular area of the tank and this value is multiplied with AD to yield volume Al1 3DDF DI2 Assuming is a tempera ture sensor this equation adds three degrees Fahren heit to the value of when DI2 is ON Because ON is equal to 1 0 then 3DDF 1 0 3DDF When DI2 is OFF 0 0 the expression 3DDF 0 0 ODDF Table 2 7 Equation Examples Inputs Using Constants 2 4 E2 User s Manual Supplement Flexible Combiner ee 026
14. 1 AI4 rated by commas or a range of inputs designated bya AVG AI1 AI7 colon between the two ends of the range e g 7 SUM range Returns the sum of all values in the range Range can SUM 2 5 7 14 result 28 be a set of constants or input variable separated by SUM AI1 AI4 commas or a range of inputs designated by a colon SUM AI1 AI between the two ends of the range e g AI1 AI7 RAND low high Returns a random number between low and high every RAND 1 10 result random number time the algorithm is updated every few seconds from 1 to 10 Table 2 10 Extended Math Functions 2 8 E2 User s Manual Supplement Flexible Combiner 026 1620 Rev 2 06 APR 2010 EZ 2 4 2 Extended Logical Functions If test is above high the result is 1 0 If test is between the value of low and high the result will be equal to between This should be filled by the name of the same outputyou are building the equation for so that when test is between the output remains in whatever state it s in thus creating a hysteresis between the cut in and cut out setpoints Function Description Examples CUTINOUTCtest low high Returns a 1 0 or a 0 0 based on the following CUTINOUT 4 5 12 DOT result 0 0 between If test is below low the result is 0 0 low CUTINOUT 14 5 12 DO1 result 1 0 high CUTINOUT 7 5 12 DO1 result DO1 between COUNT range Returns the number of values in the specified ran
15. 1620 Rev 2 06 APR 2010 EZ 2 3 Operators are symbols in equations that perform cer tain mathematical or logical operations The most recog nizable and perhaps most common example of operators Operators are plus and minus signs An operator is typically placed between two inputs and or constants in an equation and yield a single value Table 2 8 lists the operators avail able in Flexible Combiner Operator Description Examples Adds two values 4 2 result 6 4 3 2 result 9 Subtracts two values 4 2 result 2 4 3 2 result 1 Multiplies two values 4 2 result 8 4 3 2 result 24 Divides two values 4 2 result 2 4 3 2 result 0 67 gt lt Exponential The value on the left is raised to the power of the value on the right 472 result 16 41312 result 4096 Equality comparison of two values Result is 1 0 if the two values are equal 0 0 if the values are not equal 4 2 result 0 0 4 3 1 result 1 0 lt gt Inequality comparison of two values Result is 1 0 if the two values not equal 0 0 ifthe 4 lt gt 2 result 1 0 values are equal 4 lt gt 3 1 result 0 0 gt Greater than comparison of two values Result is 1 0 if the value to the left of the sign is 4 gt 2 result 1 0 greater than the value to the right of the sign If they are equal or if the value to the rightis 4 gt 3 1 result 0 0 greater the result is 0 0 lt Less than compari
16. AN AI1 AI7 between the two ends of the range e g AI1 AI7 SUMSQ range Returns the sum square of all values in parenthesis SUMSQ 5 4 3 result 50 Each input or constant is squared and then added SUMSQ AI1 AI7 result sum square of together Range can be a set of constants or input vari all seven inputs able separated by commas or a range of inputs desig nated by a colon between the two ends of the range e g 7 PROD range Returns the product of all values in the range multi PROD 2 3 4 result 24 plied together Range can bea set of constants or input PROD AI1 AI4 variable separated by commas or a range of inputs 7 designated by a colon between the two ends of the range e g AI1 A17 MAX range Returns the maximum value ofall values in therange MAX 2 5 7 14 result 14 Range can be a set of constants or input variable sepa MAX AI1 AI4 rated by commas or a range of inputs designated bya MAX AI1 AI7 colon between the two ends of the range e g 7 MIN range Returns the minimum value of all values in the range MIN 2 5 7 14 result 2 Range can be a set of constants or input variable sepa MIN AII AI4 rated by commas or a range of inputs designated by a MIN AI1 A17 colon between the two ends of the range e g AI1 AI7 AVG range Returns the average value of all values in the range AVG 2 5 7 14 result 7 Range can be a set of constants or input variable sepa AVG AI
17. DO3 OFF EQ ERR No Equation DO4 OFF EQ ERR No Equation F1 PREU TAB F2 NEXT TAB Figure 3 2 Equation Errors Page The Eq Errors screen lists the names of all equation fields in the Flex Combinerapplication When there are no errors all status fields in this screen should read either None for no errors or No Equation equation is blank and therefore unused If an equation has errors its status field will display an error message Table 3 1 shows the error messages and what they mean Message Description Resolution No Buffer There is not enough memory in E2 to parse the equation This shouldn t happen unless there is a major problem with E2 memory either due to a software issue or other type of system failure Contact Emerson Retail Solutions technical support if you receive this error message Table 3 1 Equation Errors Checking for Errors Checking for Errors 3 1 ee Message Description Resolution Mismatch Mismatched parenthesis Verify that each open parenthesis has a corresponding close parenthesis Example AI3 7 2 should be AI3 7 2 Missing A function that reguires arguments in parenthesis does not have parenthesis Verify if a function needs parenthesis that they are present and correctly paired for example SIN PD is correct not SIN PI or SIN PI This will also occur if you used a function that reguires no argum
18. DPA Air Velocity feet per minute FPM meters per minute MPM meters per second MPS meters per sec onds MPS Liguid Velocity gallons per minute GPM liters per second LPS liters per sec ond LPS Volume Flow cubic feet per minute CFM cubic meters per second CMS cubic meters per second Table 2 2 SI Units for Analog Inputs Input and Output Variables 2 1 ee Input Type Choices SI Unit Electrical amperes A amperes A Numeric Current milliamperes MA Constant Examples Description Power Rate watts W watts W Types kilowatts KW Integers 7 30 Whole numbers A minus Power Con watt hours WH watt hours sign in front will make it sumption kilowatt hours KWH WH negative Lumination foot candles FTC lux LUX Non integers 1 0 0 3 Also called decimal or float lux LUX 3 14 ing point values A minus sign in front will make it Table 2 2 SI Units for Analog Inputs negative Digital Input Values and Analog Conversion Exponential 1 1E04 Large numbers can be Numbers 4 5E 12 entered in exponential for A digital input value is converted to a numerical value when read into Flexible Combiner equations A digital input that is ON is treated as a unitless analog value of 1 0 An OFF is treated as an analog value of 0 0 Logical oper ators such as AND OR XOR and other functions typi cally used to combine d
19. HVAC Converts pressure to the corresponding temperature based on the chosen refrigerant This function accepts the following values for refrigerant R502 R22 R401A R401B R402A R402B R408A R134A R404A R507 and R717 P2T 100PSLR22 result 15 1 DC 59 1 DF P2T 6BAR R404A result 4 9 DC 40 8 DF T2P temperature refrigerant Used for refrigeration and HVAC Converts tempera ture to the corresponding pressure based onthe chosen refrigerant This function accepts the following values for refrigerant R502 R22 R401A R401B R402A R402B R408A R134A R404A R507 and R717 T2P 15 1DC R22 result 100 PSI T2P 40 8DF R404A result 6 BAR ENTHALPY temp hum Returns enthalpy for the given temperature temp and relative humidity hum ENTHALPY 78DF 50 result 86 3 BTU Lb perature temp and relative humidity hum DEWPT temp hum Returns the dewpoint for the given temperature temp DEWPT 78DF 50 result 58 3 DF and relative humidity hum WETBULB temp hum Returns the wet bulb temperature for the given tem WETBULB 78DF 50 result 65 1 DF APPTEMP temp hum Returns the apparent temperature for the given tem perature temp and relative humidity hum APPTEMP 78DF 50 result 78 5 DF Table 2 15 Conversion and Temperature Functions Functions Functions 2 11 2 4 7 ee Extended Digital Functions Function Description Examples BOTHEDGE input Returns 1 0 w
20. I1 AND DI4 DI8 also correct since both and AND DI4 DI8 are valid values that can be operated on by the operator By process of elimination then the problem with AND DI AND DI4 DI8 DI2 is the first AND func tion The AND function as pe the description accepts only multiple values separated by commas or ranges separated by a colon The argument DI1 AND DI4 DI8 incor rectly uses an operator which is not allowable in a range argument Therefore this expression is wrong and must be formatted in some other way that achieves the same result A valid alternative would be to use the opera tor amp amp instead of an AND function DI1 AND D14 DI8 amp amp DI2 Entering this expression by itself in the equation field yields no errors With the error resolved you can enter the corrected full equation and recheck the result IF DIL AND D14 DI8 amp amp DI2 TRUE AND DI1 DI2 OR DI1 DI2 This equation parses correctly with no errors Checking for Errors 3 3 Appendix When an alarm output is set AL1 AL4 the text that will appear in the Alarm Log can be configured Section 1 7 Alarms A complete list of the available alarm text appears below Trip Alarm Last On Time Expired Last Off Time Expired Events Events Per Hour Total Time Occupied High Limit Occupied Low Limit Unoccupied High Limit Unoccupied Low Limit Gradual Change Limit High Limit Ala
21. US F5 CANCEL Figure 1 7 Flexible Combiner Pulse Width Equations If one or more digital inputs have been configured to be One Shot type outputs the width of the ON pulse is Equations 1 5 determined by the value of the Pulse Width equations When a one shot output is called to be ON the Flex Com biner will run this equation and use the resulting value as the number of seconds the output will pulse ON Like delay equations pulse width equations most com monly will only be constant values since there is usually little need for variance in one shot pulse width However a delay equation can be any mathematical expression including inputs constants operators or functions that results in an analog value representing number of sec onds Desired Equation Function q 5 second DO1 PulseWidth pulse onDO1 5 2 minute DO2 PulseWidth pulse on DO2 00 02 15 second DO3 PulseWidth pulse width IF TIME lt 08 00a TRUE 15 10 on DO3 unless the cur rent time is before 8 a m in which case the pulse width is 10 seconds Table 1 3 Commonly Used Equation Examples 1 6 E2 User s Manual Supplement Flexible Combiner 1 5 Engineering Units RX 366 Unit 13 SETUP Eng Units 11 Eng Unit AI2 Eng Unit AI3 Eng Unit AI4 Eng Unit A01 Eng Unit A02 Eng Unit F1 PREU TAB F2 NEXT TAB F3 EDIT F4 LOOK UP FS CANCEL Figure 1 8 Engineering Units The engine
22. ar in this list it may be because your E2 is not version 2 20 or higher 3 Enter the number of Flexible Combiners you wish to add in the How many field 4 Press to add the new applications 1 2 E2 User s Manual Supplement Flexible Combiner 5 When the E2 asks Do you wish to edit the new applications now press Mil The E2 will take you to the first setup screen of the application you added or if you added multiple applications it will take you to the first application you added 1 3 1 2 68 19 65 RX 366 Unit 13 Use Ctr1 X to Select CX Tabs SETUP Flexible Combiner General Setup 9 49 11 ALARM 4 No Digital Digital F1 PREU TAB F2 NEXT TAB F3 EDIT F4 STATUS F5 CANCEL Figure 1 2 Flexible Combiner General Setup The first screen of the Flexible Combiner is where you will set up the general parameters required to further define the application s functions Name Enter a short description of the Flexible Combiner s function in the Name field Num of AI Enter the number of analog inputs the Flexible Com biner will use in this field Num of AO Enter the number of analog outputs the Flexible Com biner will use in this field Num of DI Enter the number of digital inputs the Flexible Com biner will use in this field Num of DO Enter the number of digital outputs the Flexible Com biner will use in this field Show Eq Line 2 Each output in the Flexible Combiner h
23. as two lines of 40 characters each that may be used to enter its equation Since an equation rarely exceeds 40 characters it is usu ally safe to hide the second line from display to make the screen easier to read This will be explained in further detail in Section 1 4 1 for now leave this field set to NO DO1 DO8 The eight DO1 DO8 Type fields are used to specify 026 1620 Rev 2 06 APR 2010 whether each digital output will be a simple ON OFF digi tal output or a one shot pulse output Choose the desired output type here DO1 DO8 Trigger If any of the DO1 DO8 Type fields were set up as one shot outputs choose the method the Flexible Combiner will use to generate pulses The choices are Edge Pulse is generated when the application tran sitions the output from OFF to ON e Inv Edge Pulse is generated when the application transitions the output from ON to OFF Both Edge Pulse is generated every time a state transition occurs whether it is OFF to ON or ON to OFF Press to proceed to the Inputs screen 1 3 1 3 68 19 65 RX 366 Unit 13 Use Ctrl X to Select CX Tabs SETUP Inputs 10 08 13 ALARM Controller Application Output F1 PREU TAB F2 NEXT TAB F3 EDIT F4 LOOK UP F5 CANCEL Figure 1 3 Flexible Combiner Inputs The Inputs screen will show the input definitions for the number of analog and digital inputs you specified in Screen 1 General The default inpu
24. ce in which case the user may be required to take adequate measures This covers Einstein family product types RX Refrigeration Controller 830 xxxx BX Building HVAC Controller 83 1 xxxx and all ver sion models 300 400 500 All E2 family product types RX Refrigeration Controller 834 xxxx BX Building HVAC Controller 835 xxxx CX Convenience Store Controller 836 xxxx and all version models 300 400 500 Table of Contents 1 FLEXIBLE COMBINER 22 cecdeosvcsceccestcectcceseestsccnscdcesdeocessosdesesevedsedeesetessesessetsesoctsded sdeccotecdeotvensecseseses 1 1 Lol OVERVIEW a Een rn eee A ene eed pea ede ee is ee ions eee 1 1 1 2 HOW IT WORKS tutik 522er yp eve ges te usb ER ANE 1 1 1 24 Examples Sas AUS ASS AN 1 1 1 3 INPUT AND OUTPUTA SSIGNMENT oo st usa ap EEEa ee ES aeae e ARE PE a AE 1 2 1 3 1 Programming the Inputs and 2 1 2 1 3 1 1 Adding a Flexible Combiner Application cccceccccceseescescesesseeeeseesecsecsecaecasessesseasecsecsecaeeseceeseceeseeseeseaseaseaseaseaes 1 2 1 3 1 2 Flexible Combiner General Setup 1 31 33 AAA er sts 1 3 LA 1 3 14 EQUATIONS en ns IA naa EE OS AS RS 1 4 1 4 1 Types of Equations and Where Equations are
25. constant in an equation that is being used to offset the value of a temperature sensor you must use the delta degrees suffixes DDF and DDC not the standard temperature suffixes DF and DC A constant with a DF or DC suffix is interpreted as a literal tempera ture and converted before the math operation is performed so an equation like AI1 10DF is interpreted as plus the value of 10DF converted to Celsius 12 2 The cor rect way to write this would be AI1 10DDF which would add 10 F to the value of before converting the entire equation to SI units Use the DDF and DDC suffixes in every equation that uses basic math in conjunction with temperature offsets 2 2 3 Used in delay equations and pulse width PW equa tions constants representing times of day or delay time durations can be entered into equations in a variety of ways Asa duration in HH MM hours minutes Example 01 45 sets the time delay to 1 hour 45 minutes 6300 seconds Asa duration in HH MM SS hours minutes seconds Example 01 00 00 sets the time delay to 1 hour 3600 seconds Use this format for min Time Constants Constants 2 3 ute seconds by entering 00 for the hour example 00 30 00 for 30 minutes Asa time of day n HH MMx where x is a if the time is a m or p if the time is p m This is con verted to a number of seconds after midnight Example 04 00a is converted
26. d functions enter them separately and see if they parse correctly In the case of the example equation a good starting place would be the test argument in the IF statement AND DI1 AND DI4 DI8 DI2 TRUE For the IF statement to work correctly this equation alone should yield a zero or non zero value If there is an error here there would likewise be an error in the whole equation In fact when this equation is entered by itself it Checking for Errors yields a Bad Type error It still isn t quite obvious why the error occurs so the next step is to reduce it further _ Because the operator requires two valid values to compare the expression AND DI1 AND DI4 DI8 DI2 if formatted correctly should result in some value that can be compared to TRUE Entering this expression by itself in the equation field however causes a Missing Arg error This means one or more functions in this expression are missing a valid argument they need Because of this the expression AND DI1 AND DI4 DI8 DI2 did not yield a valid value that could be compared to TRUE using the oper ator this is why the error in the full equation was a Bad Type error To find the bad or missing argument you can analyze each operator and function starting with the smallest com ponent and working up AND DI4 DIS8 is correctly formatted and gives no errors since the AND function accepts a range of digital inputs D
27. ents and did not include the parenthesis TIMEO is correct not TIME Missing Arg A function does not have enough arguments Verify the function has all the arguments they reguire and that each argument is separated by a comma CUTIN OUT A11 60 100 will return a Missing Ag error no between argument Bad Type A function name or operator is incorrectly used or spelled ora type mismatch or typographical error has occurred in one or more arguments Check the eguation carefully and make sure all input and out put variable names and function names are spelled correctly Bad Type can also occur when a type suffix is misspelled AI1 38F is a Bad Type error because there is no F type suffix AI1 38DDF is correct This can also be caused by incorrect operators DI1 amp DI7 is wrong DI1 amp amp DI7 is correct Bad Syntax A function has too many arguments or there is some other problem with the equation formatting Check the arguments for each function and make sure there are exactly the number required separated by commas and properly closed in parenthesis If using a function that takes no arguments verify the parenthesis after the function name have nothing between them NEWMINUTE TIME is incorrect NEWMINUTE is correct Divide by 0 Based on the current values of all inputs used in this equation a number is being divided by zero thus giving an invalid result This might occur if you are using an input a
28. er Application Input If you wish to use the input of another E2 applica tion as the destination for a Flexible Combiner s output value use the Look Up Table to select the con troller application name and input name for each field in the definition If you want an output to be a board and point address from a MultiFlex output board press to change the I O format and select MN from the menu to change the format to Board and Point Then enter the board and point address of the relay or analog point in each field ON DELAY and OFF DELAY Each digital output will have two corresponding out puts one for its on delay and one for its off delay It is not necessary to configure these outputs They are only there so the value of the on and off delays may be logged used in generic alarm control and presented in status screens Once all inputs and outputs are configured you will be ready to complete the Flexible Combiner programming by building equations Input and Output Assignment 1 3 1 4 The value of each output in a Flexible Combiner appli cation is determined by its own equation which usually takes the values of one or more inputs and performs a mathematical operation or function on them to yield a sin gle numerical value or digital state Equations When entering an equation you must follow a strict format so that the E2 can properly understand and use the equation This section will explain how to
29. ering units used for each analog input and output must be defined in Screen 7 of the Flexible Com biner setup screens the Eng Units screen The units chosen for inputs are particularly important in determining how the value will be scaled and used in equations see Section 2 2 1 Constants and Engineering Units For outputs setting an engineering unit determines how it is displayed in the Flex Combiner status screen Ifa unit is chosen for an output that is different from the default engineering unit ofthe same type used by the E2 in General Controller Info the chosen type is substituted for the default type on this screen only In other words if AO1 is set to display in DF in the Flexible Combiner cell but the default temperature unit for the E2 is in DC the output value will only be displayed in DF on the Flex Combiner statusscreen everywhere else including the Flex Combiner Summary Screen it will display in DC 026 1620 Rev 2 06 APR 2010 Description Properties C b RX 308 Unit 3 E 13 58 06 to Select Tabs SETUP ALARH Flexible Combiner FLEXCEL61 Descript Description Description F1 PREU TAB F2 NEXT TAB F3 EDIT STATUS F5 CANCEL Figure 1 9 Flexible Combiner Description Properties The Description Properties screen will show the descriptions of the associated inputs and outputs entered by the user Pertinent descriptions can be entered that explain inputs and outputs to aid in
30. ge that are non zero Typically used with digital inputs to count the number of ON inputs Range can be a set of constants or input variable separated by commas ora range of inputs designated by a colon between the two ends of the range e g DI1 DI7 COUNT 0 0 1 0 1 result 2 COUNT 0 0 0 0 result 0 COUNT DII DI4 COUNT DII D17 VOTE range Returns a 1 0 if more that 50 of the values in the range are non zero otherwise returns 0 0 This means if the range contains an even number of values the number of non zero inputs must be more than half to yield a result of 1 0 Rangecan be a set of constants or input variable separated by commas or a range of inputs designated by a colon between the two ends of the range e g DI1 DI7 VOTE 0 0 1 0 result 0 0 VOTE 0 0 1 1 result 0 0 not more than half non zero in range VOTE 1 1 1 0 result 1 0 VOTE DI1 DI4 VOTE DII D17 AND range Returns a 1 0 only when all values in the range are non zero and 0 0 if one or all values are zero Range can be a set of constants or input variable separated by commas or a range of inputs designated by a colon between the two ends of the range e g DI1 DI7 AND 1 1 result 1 0 AND 0 1 result 0 0 AND 1 1 1 1 0 result 0 0 AND DI DI4 AND DI1 DI7 OR range Returns a 1 0 when one or all values in the range are non zero and 0 0 if all values are zero Range can be a set of constants or input variable separated by com mas o
31. hen the digital input digital output or alarm output has transitioned either from OFF to ON or ON to OFF When used as an equation for a one shot output the result will be an ON 1 0 pulse for an amount of time determined by the PW equation see Section 1 4 4 Pulse Width Equations BOTHEDGE DB BOTHEDGE AND DII DI4 INVEDGE input Returns 1 0 when the digital input digital output or alarm output has transitioned either from ON to OFF When used as an equation for a one shot output the result will be an ON 1 0 pulse for an amount of time determined by the PW equation see Section 1 4 4 Pulse Width Equations INVEDGE DI3 INVEDGE AND DI1 DI4 EDGE input Returns 1 0 when the digital input digital output or alarm output has transitioned either from OFF to ON When used as an equation for a one shot output the result will be an ON 1 0 pulse for an amount of time determined by the PW equation see Section 1 4 4 Pulse Width Equations EDGE DI3 EDGE AND DI1 DI4 Table 2 16 Extended Logarithmic Functions 2 4 8 Time and Date Functions time the algorithm has been run Otherwise it returns a 0 0 The result is a short ON transition once per month at 12 midnight on day 1 of each month Paren thesis accepts no arguments but empty parenthesis must still be placed at the end of this function name in the equation Function Description Examples NEWMINUTEO Returns
32. ical OFF Table 2 5 Named Constants 2 2 1 Units Constants and Engineering Numerical and named constants are assumed to be 026 1620 Rev 2 06 APR 2010 EZ unitless numbers In other words a 3 0 in an equation by itself is not assumed to be 3 0 degrees or kilowatts How ever when used with a function or operator that involves inputs of a specific type the result of the operation or function will use the inputs engineering unit designation For example if analog input AI6 is a 0 100 humidity sensor that is currently reading a humidity of 50 the result of the equation AI6 5 will result in an output value of 10 even though the number 5 has no unit 2 2 2 Specifying a Constant s Engi neering Unit with Type Suffixes Occasionally you may want to be specific about a con stant s engineering units The equation parser supports the use of a type suffix at the end of a constant to specify a particular engineering unit Table 2 6 lists all type suffixes recognized by the Flexible Combiner s equation parser Type suffixes must be placed directly after the constant with no spaces in between the constant and the suffix i e 75DF not 75 DF Unit Suffix Unit percent degrees F degrees C delta degrees F KW use this suffix for offsets watts kilowatts delta degrees watt hours use this suffix for offsets DFH F per hour KWH kilowatt hours DFC
33. igital inputs are all designed to treat non zero values as ONs for purposes of logic and zero values as OFFs EXAMPLE EQUATIONS INPUTS Equation Description 14 The real time value of 14 AI1 AI2 AI3 Total sum of inputs 12 and AB mat Format should be a number with one significant digit to the left of the deci mal followed by an E then followed by an integer that corresponds to the power of ten the number will be mul tiplied by Example 1 1E06 is 1 1 times 10 to the sixth power or 1 100 000 A minus sign to the left of the number makes the num ber negative A minus sign in between the E and the exponent specifies a nega tive exponent Table 2 3 Equation Examples Inputs 2 2 In addition to inputs Flexible Combiner equations will typically require use of constants These can be either numeric constants entered as numbers and used as num bers named consents named strings that are parsed as numbers or time constants times of day used in com parisons Table 2 4 and Table 2 5 show the different types of numeric and named constants Constants 2 2 E2 User s Manual Supplement Flexible Combiner Table 2 4 Numeric Constants Named Description Constant PI The value of pi 3 1415926535897 TRUE 1 0 to signify a logical TRUE FALSE 0 0 to signify a logical FALSE ON 1 0 to signify a logical ON OFF 0 0 to signify a log
34. ions must be entered by the user and require some basic knowledge of the E2 s scripting language which is further explained in this section of the manual Outputs The outputs of the Flexible Combiner are the real time results of the application s equations Each output s value is determined by the equation assigned to it in the Flexible Combiner application Outputs of the Flexible Combiner application may be tied to relay or analog output points on a Retail Solutions output board or they may be passed along to the inputs of other E2 applications 1 2 1 Figure 1 1 shows a symbolic diagram of an example Flexible Combiner application In this diagram there are two equations shown one for analog output AO1 and another for digital output DO2 Example The equation in AO1 is set up to make analog output AOI equal to the average value of the two analog inputs and AI7 The equation adds these two values together and then divides the result by two The equation in DO2 performs a logical AND function on digital inputs through DI3 When all of these out puts are ON the value of DO2 will be ON otherwise if one or more of the inputs are OFF DO2 will be off FLEX COMBINER APPLICATION EQUATIONS gt AO1 7 2 DO2 AND DI1 DI3 Figure 1 1 Flexible Combiner Control Diagram Overview 1 1 1 3 Input and Output Assignment The first step in setting up a Flexible Co
35. lue is assumed ASINR PD result ERROR to be radians Value must be constrained to between 1 ASINR 1 result 1 57 and 1 otherwise a Bad Result math error will occur ACOSR value Same as the ACOS function except value is assumed ACOSR PI result ERROR to be radians Value must be constrained to between 1 ACOSR 1 result 0 and 1 otherwise a Bad Result math error will occur value Same as the ATAN function except value is assumed ATANR PI result 1 26 to be radians ATANR 1 result 0 79 Table 2 13 Extended Trigonometry Functions 2 4 5 Analog Change Detection Function Description Examples CHANGE analog input change delta Returns a 1 when the analog input has changed values greater then the change delta since the last run CHANGE All IDDF Ifthe current AIl value gt is greater than the previous 1DDF or the current value lt is less than the previous All IDDF the result is 1 0 Table 2 14 Analog Change Detection 2 4 6 Unit Conversion and Temperature Functions Function Description Examples EUC value type Converts the value of value from its engineering unit designated by type to its equivalent SI unit Refer to Table 2 2 for a list of unit types suffixes and their equivalent SI units EUC 212 DF result 100 converts 212 F to 100 C P2T pressure refrigerant Used for refrigeration and
36. mbiner is con figuring the application s inputs The first question that must be answered before input assignment can begin is What do I want the Flexible Combiner to do Will it choose the highest value from a series of temperature sensors Will it calculate enthalpy from temperature and humidity sensors Will it read a set of proofs and turn an output ON if more than half of them fail When you have determined this make a note of the following How many inputs of each type you will need ana log and digital How many outputs of each type you will need ana log and digital The types of analog inputs that will be used tem perature pressure etc For analog outputs the range of values you want each output to vary between 0 5V 0 10V 1 5V etc For digital outputs whether you want each output to be a simple ON OFF digital output or a one shot output The next step is to assign all the inputs and outputs to the numbered input and output slots in the Flexible Com biner application 1 3 1 Outputs 1 3 1 1 Adding a Flexible Combiner Application Programming the Inputs and If you haven t added a Flexible Combiner application yet you will need to create it in the E2 s Add Application screen 1 Press CPE to access the Add Application screen 2 With the cursor highlighting the Type field press and choose Flexible Combiner from the Look Up Table Note If Flexible Combiner does not appe
37. n select EN Override 68 26 65 RX 366 Unit 13 14 28 62 Flex Combiner FULL ALARM Flexible Combiner Name FLEXCELO1 tatus Math Error Override Update Property THIS 61 1 FLEXCEL61 In Override No Override Time 6 00 00 Override Value Figure 3 3 Override Screen In the In Override field press to select Yes In the Override Time field enter the amountof time you want the override to last in H MM SS format If you want an indefinite override enter 0 00 00 Enter the desired value for override in the Over ride Value field a number if analog a digital state ON or OFF if digital Press GD to begin the override and return to the Status Screen The overridden input s value should appear with a light blue background to signify override The outputs whose equations use the overridden input s value should also change to reflect the new value Verify the output value is correct for the chosen input value and repeat as many times as necessary to insure the equation will work cor rectly for every possible value of the input Find Errors By Reducing Complex Equations Consider this complex equation for a digital output IF AND DI1 AND DI4 DI8 DI2 TRUE AND DI1 D12 OR DI1 D12 As written this eguation will return a Bad Type error for reasons that are not very easy to understand The easi est way to determine the problem would be to isolate cer tain operators an
38. n you have only two spaces left at the end of line 1 and you must write the variable name A03 sim ply write AO in the last two spaces and the 3 as the first character of line two When E2 parses the equation it will push line 1 and line 2 together into one long string and it will recognize the variable name as AO3 1 4 E2 User s Manual Supplement Flexible Combiner Output Equations 68 19 65 RX 366 Unit 13 Use Ctr1 X to Select CX Tabs SETUP p C3 Outputs C7 Eng Units C8 Eq Errors Flexible Combiner FLEXCEL61 C1 General C4 Output Eg les Output Eg UNE F1 PREU TAB F2 NEXT TAB F3 EDIT STATUS F5 CANCEL Figure 1 5 Flexible Combiner Output Equations Screen 4 of the Flexible Combiner setup screens is where equations that determine the output s value are entered An output equation typically involves using math ematical operators or functions to combine or compare one or more analog or digital outputs to yield a new output result Table 1 1 gives some useful examples of sensor control applications used in refrigeration HVAC applica tions and the equations used to achieve them See Section 2 Building Equations for a more detailed explanation of equation components and functions Desired Equation Function a Averaging AO4 three tempera AVG AI1 AT2 AI3 ture sensors through AI3 and pass ing the result to AO4 AMI If DIL ON AM1 1 AM1
39. no no ono ono nn cnn cane cnn n rana 2 11 24 7 Extended Digital Functions visitarnos aora 2 12 2 48 Time and Date Functions A A la ete as eee 2 12 ZA LEP UNCUHIOIS atada 2 14 3 TESTING AND TROUBLESHOOTING EQUATIONS ssussussnsssnssnnssnnsnnsnnssnnsnansnessansnnssnnnssssnnssussnnsnnssnnsnnssnne 3 1 3 1 CHECKING ERRORS un essen anadir tap liada 3 1 3 1 1 Equation Troubleshooting 3 2 A NANA A 1 E2 User s Manual Supplement Flexible Combiner Table of Contents EZ 1 Flexible Combiner 1 1 The Flexible Combiner application a new feature of E2 versions 2 20 and above is a highly advanced and ver satile I O control program used to combine multiple ana log and digital input values using programmed equations similar to those used in spreadsheets Overview A Flexible Combiner application may have up to eight analog outputs and four digital outputs each of whose val ues are determined by user programmed equations that mathematically combine up to eight analog inputs and eight digital inputs Four of the analog outputs have the ability to remember their output state over an E2 power cycle Additionally up to four alarms can be set up whose trigger and alarm delays are equations Alarm type prior ity and the message for each alarm are user config
40. o degrees DEG I result 57 3 DEG PI result 180 RAD value Converts value from degrees to radians RAD 57 3 result 1 RAD 180 result 3 14 SIN value Returns the sine of value SIN 90 result 1 SIN 270 result 1 SIN 0 result 0 COS value Returns the cosine of value COS 90 result 0 COS 270 result 1 COS 0 result 1 TAN value Returns the tangent of value TAN 0 result 0 TAN 270 result 1 8E 07 very high number to simulate infinity ASIN value Returns the arcsine of value Value must be con ASIN 0 5 result 30 ASIN 1 01 result EROR ACON value Returns the arccosine of value Value must be con strained to between 1 and 1 otherwise a Bad Result math error will occur ACOS 0 5 result 60 ACOS 1 01 result ERROR ATAN value Returns the arctangent of value ATAN 0 5 result 26 6 ATAN 1 result 45 SINR value Same as the SIN function except value is assumed to SINR PI result 0 be radians SINR 1 result 0 84 COSR value Same as the COS function except value is assumedto COSR PI result 1 be radians COSR 1 result 0 54 Table 2 13 Extended Trigonometry Functions 2 10 E2 User s Manual Supplement Flexible Combiner 026 1620 Rev 2 06 APR 2010 EZ Function Description Examples TANR value Same as the TAN function except value is assumed to TANR PI result 0 be radians TANR I result 1 56 ASINR value Same as the ASIN function except va
41. of low and high a Bad Value error is gener ated in the equation SCALE 5 0 10 0 3 result 1 5 SCALE 150 0 10 0 100 result ERROR LIMIT value low high Limits the highest and lowest possible values of the number If the value is above the high number in this limit the result will be equal to the high number If the value is below the low number in this limit the result will be equal to the low number LIMIT 0 5 0 1 result 0 5 LIMIT 3 0 1 result 1 LIMIT 4 2 10 result 2 thesis Range can be a set of constants or input vari able separated by commas or a range of inputs designated by a colon between the two ends of the range e g AI1 AI7 VAR range Returns the variance mean squared deviation for all VAR AI1 AI4 values in parenthesis Range can be a set of constants VAR AI1 AI7 or input variable separated by commas or a range of inputs designated by a colon between the two ends of the range e g AI1 A17 STDDEV range Returns the standard deviation for all values in paren STDDEV AI1 AI4 STDDEV AI1 AI7 Table 2 10 Extended Math Functions Functions Functions 2 7 ee Function Description Examples MEDIAN range Returns the median of all values in parenthesis Range MEDIAN 3 7 8 14 result 7 5 can be a set of constants or input variable separated by MEDIAN AI1 AI4 commas or a range of inputs designated by a colon MEDI
42. r and retains the FRAC 6 75 result 0 75 sign positive or negative FRAC 12 result 0 0 INT value Returns the integer part of the number always round INT 6 75 result 6 ing DOWN to the next lowest integer even when the INT 0 99 result 0 number is negative INT 7 98 result 8 INT 7 11 result 8 CEILING value Returns the integer part of the number rounded in CEIL 6 75 result 7 whichever direction is away from zero i e up to the CEIL 0 04 result 1 next highest integer when positive and down to the CEIL 7 98 result 8 next lowest integer when negative CEIL 7 11 result 8 FLOOR value Returns the integer part of the number rounded in FLOOR 6 75 result 6 whichever direction is toward zero i e down to the FLOOR 0 04 result 0 next lowest integer when positive and up to the next FLOOR 7 98 result 7 highest integer when negative FLOOR 7 11 result 7 TRUNC value Returns the portion to the left of the decimal without TRUNC 6 75 result 6 rounding up or down TRUNC 0 04 result 0 TRUNC 7 98 result 7 TRUNC 7 11 result 7 ROUND value Rounds the value off to an integer using standard rules ROUND 6 75 result 7 ROUND 0 04 result 0 ROUND 7 98 result 8 ROUND 7 11 result 7 SCALE value low1 high1 low2 high2 Returns a number between low2 and high2 that is lin early proportional to where the value is in regards to low and high1 Note that if the value is out of the range
43. r a range of inputs designated by a colon between the two ends of the range e g DI1 DI7 OR 1 1 result 1 0 OR 0 1 result 1 0 OR 0 0 0 0 0 result 0 0 OR DI1 D14 OR DI1 DI7 XOR range Same as OR except returns 0 0 when all values are non zero XOR 1 1 result 0 0 XOR 0 1 result 1 0 XOR 0 0 0 0 0 result 0 0 XOR DH DI4 XOR DI1 DI7 Table 2 11 Extended Math Functions Functions Functions 2 9 Eee 2 4 3 Logarithm Functions Function Description Examples SQRT value Returns the square root of value Value must not be negative or else a Bad Result error will occur SQRT 4 result 2 SQRT 77 result 8 77 SQRT 4 result ERROR SQRT ABS 4 result 2 POWER value power Returns value to the power of power This is the same POWER 2 3 result 8 as the operator POWER 7 2 result 49 LOG10 value Returns the base 10 logarithm of value LOG10 5 result 0 7 LOG10 1 result 0 LOG10 100 result 2 EXP value Returns e 2 72 raised to the power of value EXP 1 result 2 72 EXP 0 5 result 1 65 LN value Returns natural logarithm of value LN 1 result 0 LN 2 72 result 1 0 LN 7 result 1 95 Table 2 12 Extended Logarithmic Functions 2 4 4 Trigonometry Functions strained to between 1 and 1 otherwise a Bad Result math error will occur Function Description Examples DEG value Converts value from radians t
44. r major elements inputs defined in the Flexible Com biner application constants such asnumerical values used in mathematical computations operators such as plus signs or greater than signs gt used to perform basic math functions and functions such as if then statements or boolean logic AND OR 2 1 ables Input and Output Vari of All the equation AI1 10 would be incorrect because this would add 10 to the value of AI in Celsius since E2 s Variable Name Description Alx x input number The analog value of input Alx in SI units DIx x input number The digital state ofinput DIx converted to analog 1 0 if input is ON 0 0 if input is OFF AOx x output number The analog value of output AOx in SI units DOx x output number The digital state of output DOx con verted to analog 1 0 if input is ON 0 0 if input is OFF Table 2 1 Input and Output Variable Names The most commonly used variables in an equation will be the Flexible Combiner s input values These are repre sented in equations by their variable names AI1 AI8 and DI1 DI8 To use input values in an eguation just enter their names AI for analog input or DI for digital input and a number from 1 through 8 corresponding to the input num ber The E2 will look for input variable names and create a link to the input s value when parsing the equation Analog Input Values and SI Unit
45. rder in which these operators are used can be signifi cant and may cause error if not arranged correctly When parsing an equation the E2 follows a specific order when multiple operators are present Operators Multiple Operators and 1 Parenthesis tors from left to right from left to right gt from left to right 4 greater than less than operators lt gt lt All exponent operators from left to right All multiplication and division and opera 3 addition and subtraction and operators and 5 All equality and inequality operators lt gt from Operators 2 5 left to right 6 All logical operators NOT amp amp from left to right If you cannot arrange an equation s operators in a way that parses them in the order you need or if you simply want to remove all doubt you may use parenthesis to specify a different order of operator execution Expres sions that are in parenthesis are executed first before any operators outside of parenthesis are used For example 5 2 3 without parenthesis results in 11 because the multiplication is executed first before the addition How ever in the equation 5 2 3 the addition is executed first because it is in parenthesis resulting in 21 Equations and operators in parenthesis can themselves contain other operators and equations in parenthesis For example 5 2 3 2 executes the addition
46. rm Low Limit Alarm Alarm Limit Exceeded Normal High Limit Normal High Limit Alternate High Limit Alternate Low Limit Comb Temp High Limit Comb Temp Low Limit Case Temp High Limit Case Temp Low Limit Curtail On Discharge Trip High Discharge Limit High Suction Limit Low Suction Limit Proof Fail All Lights On HVAC Shutdown REFR Shutdown HVAC Phase Loss REFR Phase Loss Did Not Term Defrost Product mp Hi Product Temp Lo Limit Differential Limit KW Demand Limit FreezeStat is too low Smoke Detected Dirty Filter Detected Door en VS Arm e 1
47. s The value of an AI input will always be equal to the current input value in the E2 s internal standard SI units This is important to remember because any mathe matical operations that involve this value will use its SI units which may cause the equation to be wrong if you are assuming the wrong units Example is reading a value of 212 F If you wanted to write an equation that added 10 F to the value Input and Output Variables SI unit for temperature is Celsius The way to correct this would be convert the number 10 to an equivalent number of degrees C AI1 5 6 or else use a type suffix so the E2 knows you want to add 10 degrees AI1 10DDF Type suffixes are explained in further detail in Section 2 2 2 Specifying a Constant s Engineering Unit with Type Suffixes Table 2 2 lists the SI units used by E2 Input Type Choices SI Unit Temperature degrees Fahrenheit DF degrees Celsius DC degrees C DC Change in Temperature delta degrees Fahrenheit DDF delta degrees Celsius DDC delta degrees C DDC Pressure inches of water INW centimeters of water CMW pounds per sq inch PSI bars BAR kilopascals KPA pascals PA pascals PA Change in Pressure delta inches of water DINW delta centimeters of water DCMW delta pounds per sq inch DPSI delta bars DBAR delta kilopascals DKPA delta pascals DPA delta pascals
48. s if an OFF delay is 30 seconds and the result of the input equation transitions from ON to OFF the result must remain OFF for thirty seconds before its corresponding output actually changes state Delay equations do not actually have to be equations Most commonly they will be constants However a delay equation can be any mathematical expression including inputs constants operators or functions that results in an Equations analog value representing number of seconds If you have digital outputs and would like to use ON and OFF delays enter constants or equations in these fields See Section 2 Building Equations for a more detailed explanation of equation components and func tions Desired Equati Function ee Output DO DO1 OFF Delay has a 60 sec 60 ond ON delay DO2 OFF Delay and a 60 sec 60 ond OFF delay Output DO2 DO2 OFF Delay has a 90 min 01 30 ute ON delay DO2 OFF Delay and a 90 min 01 30 ute OFF delay Output DO3 DO3 uses a 5 min IF TIME gt 9 00p 00 05 00 00 03 00 ute delay between the hours of 9 p m and mid night and a 3 minute delay otherwise Table 1 2 Commonly Used Equation Examples 1 4 4 Pulse Width Equations 68 25 65 RX 366 Unit 13 Use Ctr1 X to Select CX Tabs SETUP Ci General p p C7 Eng Units C8 Eq Errors Flexible Combiner FLEXCEL61 Eq Value E ea Line 2 F1 PREU TAB F2 NEXT TAB F3 EDIT Fa STAT
49. s a divisor For example DI1 DI2 would be just fine as long as DI2 is ON 1 0 however when DI2 is 0 0 the result is DI1 0 0 which is invalid Avoid creating equations that use inputs as divisors Bad Result Based on the current values of all inputs used in this equation the result is not a real number This might occur if using an input in a function that depend ing upon the value of the input yields an imaginary number would be a Bad Result error when All is negative because the result is an imaginary number also ASIN AI2 would give a Bad Result error if AI2 was greater than 1 or less than 1 Bad Value A value passed to a function is incorrect for that function If using inputs as arguments verify the values being passed from these inputs are valid values the function can use as argu ments Table 3 1 Equation Errors 3 1 1 Tips Equation Troubleshooting Test Your Equations Especially if an equation you are using is complex validate the equation is working as you intended it by con trolling the input values being fed into the equation The easiest way to do that is to override inputs from the Flex Combiner Status screen and watch what happens 3 2 E2 User s Manual Supplement Flexible Combiner to the outputs On the Flex Combiner Status screen highlight the input value with the arrow keys 026 1620 Rev 2 06 APR 2010 nter cl e Press EI the
50. son of two values Result is 1 0 if the value to the right of the sign is 4 lt 2 result 0 0 greater than the value to the left of the sign If they are equal or if the value to the left is 4 lt 3 1 result 0 0 greater the result is 0 0 3 lt 5 result 1 0 gt Same as greater than gt except the result will also be 1 0 if the two values are equal 4 gt 2 result 1 0 4 gt 3 1 result 1 0 lt Same as less than lt except the result will also be 1 0 if the two values are equal 4 lt 2 result 0 0 4 lt 3 1 result 1 0 1 Digital inversion of the value to the right of this sign If the value is non zero the result is 10 result 1 0 7 0 0 If the value is zero the result is 1 0 17 result 0 0 Same as only using a different format The value to be inverted must be put in parenthesis next to the NOT operator see example NOT 0 result 1 0 NOT 7 result 0 0 Logical AND Ifthe values to the right and left of these symbols are both non zero numbers the result will be 1 0 Otherwise if one or both values are 0 the result will be 0 0 4 amp amp 2 result 1 0 4 amp amp 0 result 0 0 0 amp amp 0 result 0 0 Logical OR If either of the values to the left or right of these symbols are non zero num bers the result is 1 0 If both are zero the result is 0 0 4 2 result 1 0 4 0 result 1 0 0 0 result 0 0 Table 2 8 Operators 2 3 1 Often an equation will contain more than one operator The o
51. t format is Controller Applica tion Output If you wish to use the output from another E2 application as an input for the Flexible Combiner appli cation use the Look Up Table to select the con troller application name and output name foreach field in the definition If you want an input to be a board and point address from a MultiFlex input board press to change the I O format and select MN from the menu to change the format to Board and Point Then enter the board and point address of the input point in each field NOTE If a point you enter in this manner has not been configured yet from the Input Summary screen you will need to do so before entering its board and point address Input and Output Assignment here Refer to the E2 User s Manual P N 026 1610 for more details Once all inputs are defined make a note of the names of each input you defined AI1 AI8 and DI1 DI8 These names are the ones that are used when building equations When finished press to proceed to the Outputs screen 1 3 1 4 Outputs RX 366 Unit 13 to Select CX Tabs SETUP 001 ON DELAY DO2 ON DELAY 001 OFF DELAY 002 OFF DELAY F1 PREU TAB F2 NEXT TAB_ F3 EDIT F4 LOOK UP FS CANCEL Figure 1 4 Flexible Combiner Outputs The Outputs screen will show the output definitions for the number of analog and digital outputs you specified in Screen 1 General The default output format is Controll
52. ts no DAY on 01 07 2005 result 7 arguments but empty parenthesis must still be placed DAY on 02 28 1985 result 28 at the end of this function name in the equation DAY result ERROR no parenthesis MONTH Returns a number from 1 12 representing the month of MONTH on 01 07 2005 result 1 the year Parenthesis accepts no arguments but empty MONTH on 09 07 1974 result 7 parenthesis must still be placed at the end of this func MONTH result ERROR no parenthe tion name in the equation sis YEARO Returns the current year in four digit format Paren YEAR on 01 07 2005 result 2005 thesis accepts no arguments but empty parenthesis YEAR result ERROR no parenthesis must still be placed at the end of this function name in the equation ISLEAP If the current year is a leap year returns a 1 0 Other ISLEAPO on 01 07 2005 result 0 0 wise returns 0 0 Parenthesis accepts no arguments ISLEAPO on 01 01 2008 result 1 0 but empty parenthesis must still be placed at the end of this function name in the equation ISDSTO If daylight savings time is active returns a 1 0 Other ISDST on 01 07 2005 result 0 0 wise returns 0 0 Parenthesis accepts no arguments ISDST on 07 04 2005 result 1 0 but empty parenthesis must still be placed at the end of this function name in the equation DAYOFWEEK Returns a number from 1 7 based on the current day of DAYOFWEEK on 01 07 2005 result the week from Sunday 1 to Saturday
53. understanding the intent of the programming performed in the flexible com biner Descriptions for analog memory outputs appear only in expanded status If text is not entered for a description for an input and a connection is made to the output of another application the description is automatically filled in with the applica ton name and property of that output If text is entered for an input and a new connection is made the text is not automatically changed This applies to inputs only out puts are not affected Description Properties 1 7 Alarms C b RX 366 Unit 3 12 21 42 Cx Tabs SETUP FULL ALARM Area Ctrl Application Input DELAY DELAY DELAY Eq Delay Eq Message Type Priority CANCEL Figure 1 10 Flexible Combiner Alarm Setup The alarm output and delay equations control the trig ger of the alarm and how long to delay before setting an advisory in the advisory log These equations are executed exactly like analog and digital outputs The alarm output equations combined with the delay equations control the outputs ALI AL4 The results of the delay equation are sent to outputs ALI AL4 DELAY The alarm type can be set to either Notice or Alarm The alarm priority sets the priority of the advisory generated For a complete list of advisory text see the Appendix section Description Properties 1 7 amp 2 Building Equations Equations are made up of different combinations of fou
54. urable Equations used to calculate output values and time delays may use mathematical combinations of any of the Flexible Combiner s analog and digital inputs as well as numeric and named constants operators functions and even rudimentary if then logic functions For control of digital outputs the Flexible Combiner also supports separate equations that determine ON and OFF delays The Flexible Combiner may also be pro grammed to operate a digital output as a PWM pulse width modulation output In this instance the equation written for a PWM output determines its period and pulse width 1 2 How It Works A typical Flexible Combiner application consists of three types of components inputs equations and out puts Inputs Inputs for a Flexible Combiner applications may be sensor values from input points on a MultiFlex input board or outputs from other software applications in the E2 Inputs are the building blocks you will use to create the control function you need A Flexible Combiner output may be configured with up to eight analog inputs and eight digital inputs Equations Equations are used to combine or otherwise mathemat ically alter one or more inputs from the Flexible Combiner to create an output that performs a desired function Each output has its own equation a string of characters up to 80 Overview characters in length that the E2 parses or decodes to determine the output s value Equat
Download Pdf Manuals
Related Search