Escolar Documentos
Profissional Documentos
Cultura Documentos
Microblock Reference
Revised on 28-March-00. Version 3.02 Copyright 2000 Automated Logic Corporation. All rights reserved. 1150 Roberts Boulevard, Kennesaw, GA 30144 Phone (770) 429-3000 FAX (770) 429-3001 Visit us at http://www.automatedlogic.com Printed in the United States of America. Automated Logic is a registered trademark of Automated Logic Corporation. All other brand and product names are trademarked by their respective owners. This manual was produced using FrameMaker.
Contents
Chapter 1 Chapter 2 Introduction 15 BACnet Client Microblocks 19
BACnet Client Read Analog 21 BACnet Client Read Binary 24 BACnet Client Write Analog 27
BACnet Client Write Binary 30 BACnet Client Synchronize Analog 33 BACnet Client Synchronize Binary 37
Chapter 3
BACnet Microblocks
41
42
BACnet Binary Parameter 54 BACnet Analog Parameter BACnet Binary Status 58 BACnet Analog Status 60 56
Chapter 4
I/O Microblocks 67
Analog Input Digital Input 69 71
Contents 3
Timed Local Override Pulse to Analog 75 LAN Analog Input 78 LAN Digital Input 81 Analog Output 83 Digital Output 85
73
Floating Motor Output 87 Pulse-Width Output 90 LAN Analog Output 93 LAN Digital Output 96
Airflow Control
99
Chapter 5
SysIn Microblocks
111
Receive Run Request 113 Receive Heat Request 115 Receive Cool Request 117
4 Contents
121
Get System Status 123 Receive Electrical Demand Level Binary Parameter Analog Parameter 126 127 125
Time Parameter 129 Binary Constant 130 Analog Constant 131 Time Constant 132
Chapter 6
SysOut Microblocks
133
135
Transmit Heat Request 137 Transmit Cool Request 139 Transmit Multiple Heat Requests 141 Transmit Multiple Cool Requests 143 Prime Variable 145 Demand Broadcast 146 Binary Status 147 Analog Status 148 Time Status 149
Contents 5
Chapter 7
176
178
6 Contents
Chapter 8
Control Microblocks
183
Zone Setpoint with Demand and Learning Adaptive Optimal Start 208
Zone Setpoint - Plus with Learning Adaptive Optimal Start 213 Setpoint Optimization Set Color 222 Set Color If True 223 220
Contents 7
227
Chapter 9
Convert Microblocks
229
Zone Controller
231
234
Linear Converter
242
Enthalpy Calculator
244 246
Wet Bulb Temperature Calculator 247 True If = Constant True If > Constant True If < Constant True If = Variable 248 249 250 251
8 Contents
True If Input < Variable Input 253 Analog to Digital Converter Digital to Analog Converter 254 255
Chapter 10
Limit Microblocks
257
Constant High Signal Selector 258 Constant Low Signal Selector Variable High Signal Selector Variable Low Signal Selector Constant Low Limit 262 259 260 261
Constant High Limit 263 Variable Low Limit 264 Variable High Limit 265 266
Chapter 11
Relay Microblocks
269
Constant Duty Cycle 271 Variable Duty Cycle 273 Delay on Make Delay on Break 274 275
Contents 9
Latch Toggle
278 279
Lead/Standby 280
Switch (Normally Closed to Constant) 284 Two Variables Switch Digital Wire Lock Analog Wire Lock 286 287 285
Chapter 12
Logic Microblocks
289
Or - 4 Input 291
Or - 5 Input 292
10 Contents
Chapter 13
Math1 Microblocks
Add Constant to Variable
293
295 296
Modulo Divide by Constant 299 Add Two Variables 300 Add Three Variables 300
Add Four Variables 300 Subtract Two Variables 300 Multiply Two Variables 301 Divide Two Variables 301 Modulo 301 Average 301
Chapter 14
Math2 Microblocks
Sine 304 Cosine 304
303
Contents 11
Tangent
304 304
Chapter 15
Misc Microblocks
309
Chapter 16
Figure
319
Drawing figures 319 Editing figures 322 Editing a figures attributes 323 Editing a figures shape 323 Scaling and rotating 324
Chapter 17
327
12 Contents
System Variables 334 Special Characters 335 Mathematical Functions 335 Programming Structures 342 Error Messages 347
Chapter 18
Appendix A
351
Chapter 19 Chapter 20
Contents 13
14 Contents
1 Introduction
This manual is intended to serve as a reference for each of the microblocks included with Eikon. This manual provides details about the individual microblocks and their associated parameters. For information about creating and editing Graphic Function Blocks (GFBs) or other functions of Eikon, refer to the Eikon Users Guide. The Parameter and Status page text that is shown in this manual assumes the microblock is unconfigured. Underscores (_) represent configurable information on the Parameter page, while tildes (~) represent current status values on the Status page. The following table lists the microblocks that are not supported by each Exec version. Table 1-1. Unsupported microblocks by Exec Version
Exec 3.x Alert Alarm OA3/Primary-Secondary Outside Air Broadcast Digital Trend Analog Trend OCL BACnet Client Read Analog BACnet Client Read Binary BACnet Client Write Analog Exec 4.x Exec 6.x Set Alarm Number Set Message Number Set Runtime Exceeded Flag OA2/PrimarySecondary Outside Air Broadcast
Chapter 1: Introduction 15
BACnet Analog Output BACnet Binary Input BACnet Binary Output BACnet Analog Parameter BACnet Analog Status BACnet Binary Parameter BACnet Binary Status Linear Converter for Variable Inputs Airflow control Zone Controller LogiStat Zone Sensor
16 Chapter 1: Introduction
Chapter 1: Introduction 17
18 Chapter 1: Introduction
Static binding
Static binding requires the following information about the object you want to bind to: object type object instance number device instance number Network address MAC address
Dynamic binding
Dynamic binding is not supported by all BACnet devices; BACnet Class 1 and 2 devices, such as U-cards, do not support this type of binding. Special BACnet services (Who Is and Who Has) are used to locate the BACnet device and object that you want to bind to. Dynamic binding requires either the Object Name or Instance number of the object you want to bind to, along with any of the following: Device Instance Device Name Network # and MAC address
For example, by creating a VAV Zone GFB with a BACnet Client microblock that binds to the object named Supply Air Temp in the device named VAV AHU, the GFB can be used in any sites using VAV AHU as the name for the module controlling the VAV air handling unit. The following BACnet Client microblocks are available: BACnet Client Read Analog 21 BACnet Client Read Binary 24 BACnet Client Write Analog BACnet Client Write Binary 27 30
Microblock Library icon
The BACnet Communications section on the microblock dialog allows you to enable BACnet communications on this point. Disable this parameter for troubleshooting. The Simulation section on the microblock dialog allows you to define a value for this microblock that will be used during Eikons simulation. For details about using simulation to test the operation of a GFB, refer to the section Testing the GFB of the Eikon Users Guide. Assign settings for the remote BACnet objects that you want to communicate with in the Bind Settings section of the microblock dialog. The Object Instance or Name parameter allows you to set the instance number (read as the instance number if all the characters are numbers) or the name (read as the name if any of the characters are not numbers). When this parameter is used as an object name, it uses the Who-Has BACnet service to find the object. See the ANSI/ASHRAE standard, SPC 135 for more information on the Who-Has service. The Object Type can be set to AI, AO, AV, or Custom for this microblock. If set to Custom, you must provide information in the Custom Settings section. The Refresh Time allows you to set a time interval in minutes and seconds before the module reads a point.
The Default Value determines the value that the microblock uses on the GFB output wire when communication with the remote BACnet object is lost. The Custom Settings section allows you to specify the Object Type, Property, and Data Type of the bound object. See the ANSI/ASHRAE standard, SPC 135 for more information. The Data Type field values are Boolean (1), Unsigned (2), Integer (3), Real (4), Double (5), or Enumerated (9). The Device Instance or Name parameter allows you to set the BACnet device instance (read as the device instance if all the characters are numbers) or the name (read as the name if any of the characters are not numbers). When this parameter is used as a name, it uses the WhoHas BACnet service to find the object. A value of this-device indicates that the BACnet property is in this device; this allows for communication with the device without generating traffic on the network. A value of default allows you to enter the remote device information on the module driver page. This information is used to insert multiple BACnet Client microblocks that are referencing the same remote device into a GFB. To disable this parameter, enter novalue. The Network # parameter allows you to enter the BACnet network number of the segment but if the module is on the same network, enter local. The MAC Address parameter allows you to enter the MAC address. The letter h at the end of either of these strings indicates that the string is hexadecimal. To disable either of these parameters, enter no-value.
NOTE If the Network # and MAC Address are entered, they will be used for dynamic binding instead of the Device Name. But for static binding to occur, the Object Instance, Network #, MAC Address, and Device Instance are required.
If a field is not used, enter no-value. When no-value is entered, the BACnet Client microblock uses the Who-Is or Who-Has BACnet services to locate and dynamically bind to the BACnet object for communication. Only remote devices that are BACnet Class 3 or higher can support dynamic binding.
Microblock
indicates that the BACnet property is in this device; this allows for communication with the device without generating traffic on the network. A value of default allows you to enter the remote device information on the module driver page. This information is used to insert multiple BACnet Client microblocks that are referencing the same remote device into a GFB. To disable this parameter, enter novalue. The Network # parameter allows you to enter the BACnet network number of the segment but if the module is on the same network, enter local. The MAC Address parameter allows you to enter the MAC Address. The letter h at the end of either of these strings indicates that the string is hexadecimal. To disable either of these parameters, enter no-value.
NOTE If the Network # and MAC Address are entered, they will be used for dynamic binding instead of the Device Name. But for static binding to occur, the Object Instance, Network #, MAC Address, and Device Instance are required.
If a field is not used, enter no-value. When no-value is entered, the BACnet Client microblock uses the Who-Is or Who-Has BACnet services to locate and dynamically bind to the BACnet object for communication. Only remote devices that are BACnet Class 3 or higher can support dynamic binding.
The BACnet Communications section on the microblock dialog allows you to enable BACnet communications on this point. Disable this parameter for troubleshooting. The Simulation section on the microblock dialog allows you to define a value for this microblock that will be used during Eikons simulation. For details about using simulation to test the operation of a GFB, refer to the section Testing the GFB of the Eikon Users Guide. Assign settings for the remote BACnet objects that you want to communicate with in the Bind Settings section of the microblock dialog. The Object Instance or Name parameter allows you to set the instance number (read as the instance number if all the characters are numbers) or the name (read as the name if any of the characters are not numbers). When this parameter is used as an object name, it uses the Who-Has BACnet service to find the object. See the ANSI/ASHRAE standard, SPC 135 for more information on the Who-Has service. The Object Type can be set to AI, AO, AV, BI, BO, BV or Custom for this microblock. If set to Custom, you must provide information in the Custom Settings section. The Refresh Time allows you to set a time interval in minutes and seconds before the module writes a point. When this value is set to 0:00, write operations only occur at start-up or when the input value changes.
The Custom Settings section allows you to specify the Object Type, Property, and Data Type of the bound object. See the ANSI/ASHRAE standard, SPC 135 for more information. The Data Type field values are Boolean (1), Unsigned (2), Integer (3), Real (4), Double (5), or Enumerated (9). The Device Instance or Name parameter allows you to set the BACnet device instance (read as the device instance if all the characters are numbers) or the name (read as the name if any of the characters are not numbers). When this parameter is used as a name, it uses the WhoHas BACnet service to find the object. A value of this-device indicates that the BACnet property is in this device; this allows for communication with the device without generating traffic on the network. A value of default allows you to enter the remote device information on the module driver page. This information is used to insert multiple BACnet Client microblocks that are referencing the same remote device into a GFB. To disable this parameter, enter novalue. The Network # parameter allows you to enter the BACnet network number of the segment but if the module is on the same network, enter local. The MAC Address parameter allows you to enter the MAC Address. The letter h at the end of either of these strings indicates that the string is hexadecimal. To disable either of these parameters, enter no-value.
NOTE If the Network # and MAC Address are entered, they will be used for dynamic binding instead of the Device Name. But for static binding to occur, the Object Instance, Network #, MAC Address, and Device Instance are required.
If a field is not used, enter no-value. When no-value is entered, the BACnet Client microblock uses the Who-Is or Who-Has BACnet services to locate and dynamically bind to the BACnet object for communication. Only remote devices that are BACnet Class 3 or higher can support dynamic binding.
The BACnet Communications section on the microblock dialog allows you to enable BACnet communications on this point. Disable this parameter for troubleshooting. The Simulation section on the microblock dialog allows you to define a value for this microblock that will be used during Eikons simulation. For details about using simulation to test the operation of a GFB, refer to the section Testing the GFB of the Eikon Users Guide. Assign settings for the remote BACnet objects that you want to communicate with in the Bind Settings section of the microblock dialog. The Object Instance or Name parameter allows you to set the instance number (read as the instance number if all the characters are numbers) or the name (read as the name if any of the characters are not numbers). When this parameter is used as an object name, it uses the Who-Has BACnet service to find the object. See the ANSI/ASHRAE standard, SPC 135 for more information on the Who-Has service. The Object Type can be set to AI, AO, AV, BI, BO, BV or Custom for this microblock. If set to Custom, you must provide information in the Custom Settings section. The Refresh Time allows you to set a time interval in minutes and seconds before the module writes a point. When this value is set to 0:00, write operations only occur at start-up or when the input value changes. The Custom Settings section allows you to specify the Object Type, Property, and Data Type of the bound object. See the ANSI/ASHRAE standard, SPC 135 for more information. The Data Type field values are Boolean (1), Unsigned (2), Integer (3), Real (4), Double (5), or Enumerated (9). The Device Instance or Name parameter allows you to set the BACnet device instance (read as the device instance if all the characters are numbers) or the name (read as the name if any of the characters are not numbers). When this parameter is used as a name, it uses the WhoHas BACnet service to find the object. A value of this-device
indicates that the BACnet property is in this device; this allows for communication with the device without generating traffic on the network. A value of default allows you to enter the remote device information on the module driver page. This information is used to insert multiple BACnet Client microblocks that are referencing the same remote device into a GFB. To disable this parameter, enter novalue. The Network # parameter allows you to enter the BACnet network number of the segment but if the module is on the same network, enter local. The MAC Address parameter allows you to enter the MAC Address. The letter h at the end of either of these strings indicates that the string is hexadecimal. To disable either of these parameters, enter no-value.
NOTE If the Network # and MAC Address are entered, they will be used for dynamic binding instead of the Device Name. But for static binding to occur, the Object Instance, Network #, MAC Address, and Device Instance are required.
If a field is not used, enter no-value. When no-value is entered, the BACnet Client microblock uses the Who-Is or Who-Has BACnet services to locate and dynamically bind to the BACnet object for communication. Only remote devices that are BACnet Class 3 or higher can support dynamic binding.
Microblock Library icon
The BACnet Communications section on the microblock dialog allows you to enable BACnet communications on this point. Disable this parameter for troubleshooting. The Simulation section on the microblock dialog allows you to define a value for this microblock that will be used during Eikons simulation. For details about using simulation to test the operation of a GFB, refer to the section Testing the GFB of the Eikon Users Guide. The Enable Two-way synchronization parameter allows the Value parameter in the SuperVision database to be synchronized with the remote BACnet Object that the microblock is bound to. If the parameter is set to yes, the microblock sends periodic read services and changes the Value parameter if the remote BACnet property changes. It sends a write service if the SuperVision Value is changed. If the Enable Two-way synchronization is set to no, the microblock periodically writes the Value parameter to the remote BACnet property.
NOTE If Enable Two-way synchronization is set to yes, any change of the remote BACnet Objects value updates the Value parameter. This causes a parameter mis-match of the GFB. The module parameters need to be transferred to the SuperVision database to complete the update.
The Read on first execution parameter is only applicable if Enable Two-way synchronization is set to yes. If set to no, the Value parameter is initially written to the remote BACnet Object. If Read on first execution is yes, the remote BACnet propertys state is read and updates the Value parameter. Assign settings for the remote BACnet objects that you want to communicate with in the Bind Settings section of the microblock dialog. The Object Instance or Name parameter allows you to set the instance number (read as the instance number if all the characters are numbers) or the name (read as the name if any of the characters are not numbers). When this parameter is used as an object name, it uses the Who-Has BACnet service to find the object. See the ANSI/ASHRAE standard, SPC 135 for more information on the Who-Has service. The Object Type can be set to AI, AO, AV, BI, BO, BV or Custom for this microblock. If set to Custom, you must provide information in the Custom Settings section. The Refresh Time allows you to set a time interval in minutes and seconds before the module synchronizes the points. If Enable Two-way synchronization is set to no, the Refresh Time indicates how frequently it writes. If set to yes, the refresh timer indicates how frequently it reads. The Value parameter is the SuperVision value that the microblock synchronizes with in the remote BACnet Objects property value. This represents the state of the remote BACnet Objects property that the microblock is bound to. When two-way synchronization is enabled, the Value can be changed in SuperVision or in the remote BACnet device. Synchronization microblocks are most useful for interfacing with BACnet devices that are not directly accessible to SuperVision. The Custom Settings section allows you to specify the Object Type, Property, and Data Type of the bound object. See the ANSI/ASHRAE standard, SPC 135 for more information. The Data Type field values are Boolean (1), Unsigned (2), Integer (3), Real (4), Double (5), or Enumerated (9). The Device Instance or Name parameter allows you to set the BACnet device instance (read as the device instance if all the characters are numbers) or the name (read as the name if any of the characters are not numbers). When this parameter is used as a name, it uses the WhoHas BACnet service to find the object. A value of this-device
indicates that the BACnet property is in this device; this allows for communication with the device without generating traffic on the network. A value of default allows you to enter the remote device information on the module driver page. This information is used to insert multiple BACnet Client microblocks that are referencing the same remote device into a GFB. To disable this parameter, enter novalue. The Network # parameter allows you to enter the BACnet network number of the segment but if the module is on the same network, enter local. The MAC Address parameter allows you to enter the MAC Address. The letter h at the end of either of these strings indicates that the string is hexadecimal. To disable either of these parameters, enter no-value.
NOTE If the Network # and MAC Address are entered, they will be used for dynamic binding instead of the Device Name. But for static binding to occur, the Object Instance, Network #, MAC Address, and Device Instance are required.
If a field is not used, enter no-value. When no-value is entered, the BACnet Client microblock uses the Who-Is or Who-Has BACnet services to locate and dynamically bind to the BACnet object for communication. Only remote devices that are BACnet Class 3 or higher can support dynamic binding.
The BACnet Communications section on the microblock dialog allows you to enable BACnet communications on this point. Disable this parameter for troubleshooting. The Simulation section on the microblock dialog allows you to define a value for this microblock that will be used during Eikons simulation. For details about using simulation to test the operation of a GFB, refer to the section Testing the GFB of the Eikon Users Guide. The Enable Two-way synchronization parameter allows the Value parameter in the SuperVision database to be synchronized with the remote BACnet Object that the microblock is bound to. If the parameter is set to yes, the microblock sends periodic read services and changes the Value parameter if the remote BACnet property changes. It sends a write service if the SuperVision Value is changed. If the Enable Two-way synchronization is set to no, the microblock periodically writes the Value parameter to the remote BACnet property.
NOTE If Enable Two-way synchronization is set to yes, any change of the remote BACnet Objects value updates the Value parameter. This causes a parameter mis-match of the GFB. The module parameters need to be transferred to the SuperVision database to complete the update.
The Read on first execution parameter is only applicable if Enable Two-way synchronization is set to yes. If set to no, the Value parameter is initially written to the remote BACnet Object. If Read on first execution is yes, the remote BACnet propertys state is read and updates the Value parameter. Assign settings for the remote BACnet objects that you want to communicate with in the Bind Settings section of the microblock dialog. The Object Instance or Name parameter allows you to set the instance number (read as the instance number if all the characters are numbers) or the name (read as the name if any of the characters are not numbers). When this parameter is used as an object name, it uses the
Who-Has BACnet service to find the object. See the ANSI/ASHRAE standard, SPC 135 for more information on the Who-Has service. The Object Type can be set to BI, BO, BV or Custom for this microblock. If set to Custom, you must provide information in the Custom Settings section. The Refresh Time allows you to set a time interval in minutes and seconds before the module synchronizes the points. If Enable Two-way synchronization is set to no, the Refresh Time indicates how frequently it writes. If set to yes, the refresh timer indicates how frequently it reads. The Value parameter is the SuperVision value that the microblock synchronizes with in the remote BACnet Objects property value. This represents the state of the remote BACnet Objects property that the microblock is bound to. When two-way synchronization is enabled, the Value can be changed in SuperVision or in the remote BACnet device. Synchronization microblocks are most useful for interfacing with BACnet devices that are not directly accessible to SuperVision. The Custom Settings section allows you to specify the Object Type, Property, and Data Type of the bound object. See the ANSI/ASHRAE standard, SPC 135 for more information. The Data Type field values are Boolean (1), Unsigned (2), Integer (3), Real (4), Double (5), or Enumerated (9). The Device Instance or Name parameter allows you to set the BACnet device instance (read as the device instance if all the characters are numbers) or the name (read as the name if any of the characters are not numbers). When this parameter is used as a name, it uses the WhoHas BACnet service to find the object. A value of this-device indicates that the BACnet property is in this device; this allows for communication with the device without generating traffic on the network. A value of default allows you to enter the remote device information on the module driver page. This information is used to insert multiple BACnet Client microblocks that are referencing the same remote device into a GFB. To disable this parameter, enter novalue.
The Network # parameter allows you to enter the BACnet network number of the segment but if the module is on the same network, enter local. The MAC Address parameter allows you to enter the MAC Address. The letter h at the end of either of these strings indicates that the string is hexadecimal. To disable either of these parameters, enter no-value.
NOTE If the Network # and MAC Address are entered, they will be used for dynamic binding instead of the Device Name. But for static binding to occur, the Object Instance, Network #, MAC Address, and Device Instance are required.
If a field is not used, enter no-value. When no-value is entered, the BACnet Client microblock uses the Who-Is or Who-Has BACnet services to locate and dynamically bind to the BACnet object for communication. Only remote devices that are BACnet Class 3 or higher can support dynamic binding.
3 BACnet Microblocks
The BACnet menu contains microblocks that are used to communicate values with devices that use the BACnet communications protocol. Use these microblocks instead of the corresponding microblocks on the I/O, SysIn, and SysOut menus when you want to make this information available to BACnet devices.
NOTE All the microblocks on the BACnet menu require Exec version 6.0 or greater. Up to 1,000 BACnet microblocks can be used in each control module.
BACnet Binary Parameter 54 BACnet Analog Parameter 56 BACnet Binary Status 58 BACnet Analog Status 60
Microblock
The Units setting indicates what unit the value is measured in. You can scroll through the most common unit types by clicking and holding the left mouse button on the unit name setting. If the unit you need is not listed, enter the units number in the unit number field. A list of available engineering units and their corresponding unit numbers is available in the section Units on page 62. The Trend section on the microblock dialog allows you to enable trending on this point and set the trend interval. The interval can be measured in seconds or minutes. For more information about trending and setting the trend parameters, refer to the SuperVision Users Guide. The Simulation section on the microblock dialog allows you to define a value for this microblock that will be used during Eikons simulation. For details about using simulation to test the operation of a GFB, refer to the section Testing the FB of the Eikon Users Guide. On the Parameter page, the lock setting allows you to define a value for the microblock which will be used instead of the actual value read by the module. Set the lock parameter to N to use the actual value read by the module.
Microblock
The Simulation section on the microblock dialog allows you to define a value for this microblock that will be used during Eikons simulation. For details about using simulation to test the operation of a GFB, refer to the section Testing the FB of the Eikon Users Guide. On the Parameter page, the lock setting allows you to define a value for the microblock which will be used instead of the actual value read by the module. Set the lock parameter to N to use the actual value read by the module. The fail setting indicates what the value of the microblock should default to when the equipment is turned off. The fail setting also corresponds to the Polarity property of the BACnet Binary Input Object. When fail is set to no, the Polarity property is Normal. When fail is set to yes, the Polarity property is Reverse.
Microblock
The Units setting indicates what unit the value is measured in. You can scroll through the most common unit types by clicking and holding the left mouse button on the unit name setting. If the unit you need is not listed, enter the units number in the unit number field. A list of available engineering units and their corresponding unit numbers is available in the section Units on page 62. The Trend section on the microblock dialog allows you to enable trending on this point and set the trend interval. The interval can be measured in seconds or minutes. For more information about trending and setting the trend parameters, refer to the SuperVision Users Guide. On the Parameter page, the lock setting allows you to override the microblocks actual value. When the lock parameter is set to Y, the value of the microblock is written using BACnet priority 8. When the lock parameter is set to N, the value of the microblock is written using BACnet priority 16. Set the lock parameter to N to use the actual value of the microblock. The Status page shows the BACnet priority level currently being used by this microblock. The priority ranges from 1 to 16, with 1 being the highest priority.
Microblock
trending and setting the trend parameters, refer to the SuperVision Users Guide. On the Parameter page, the lock setting allows you to override the microblocks actual value. When the lock parameter is set to Y, the value of the microblock is written using BACnet priority 8. When the lock parameter is set to N, the value of the microblock is written using BACnet priority 16. Set the lock parameter to N to use the actual value of the microblock. The Status page shows the BACnet priority level currently being used by this microblock. The priority ranges from 1 to 16, with 1 being the highest priority. The fail setting indicates what the value of the microblock should default to in the event the module is unable to communicate with the equipment (such as a power failure in the module). The fail setting also corresponds to the Polarity property of the BACnet Binary Output Object. When fail is set to no, the Polarity property is Normal. When fail is set to yes, the Polarity property is Reverse.
Microblock
Microblock
Microblock
Microblock
Units
Units
Area Currency square-meters (0) square-feet (1) currency1 (105) currency2 (106) currency3 (107) currency4 (108) currency5 (109) currency6 (110) currency7 (111) currency8 (112) currency9 (113) currency10 (114) milliamperes (2) amperes (3) ohms (4) kilohms (122) megohms (123) volts (5) millivolts (124) kilovolts (6) megavolts (7) volt-amperes (8) kilovolt-amperes (9) megavolt-amperes (10) volt-amperes-reactive (11) kilovolt-amperes-reactive (12) megavolt-amperes-reactive (13) degrees-phase (14) power-factor (15) joules (16) kilojoules (17) kilojoules-per-kilogram (125) megajoules (126) watt-hours (18) kilowatt-hours (19) btus (20) therms (21) ton-hours (22)
Electrical
Energy
Units
joules-per-kilogram-dry-air (23) btus-per-pound-dry-air (24) joules-per-degree-Kelvin (127) joules-per-kilogram-degree-Kelvin (128) cycles-per-hour (25) cycles-per-minute (26) hertz (27) kilohertz (129) megahertz (130) per-hour (131) grams-of-water-per-kilogram-dry-air (28) percent-relative-humidity (29) millimeters (30) meters (31) inches (32) feet (33) watts-per-square-foot (34) watts-per-square-meter (35) lumens (36) luxes (37) foot-candles (38) kilograms (39) pounds-mass (40) tons (41) kilograms-per-second (42) kilograms-per-minute (43) kilograms-per-hour (44) pounds-mass-per-minute (45) pounds-mass-per-hour (46) milliwatts (132) watts (47) kilowatts (48) megawatts (49) btus-per-hour (50) horsepower (51) tons-refrigeration (52)
Humidity Length
Light
Mass
Mass Flow
Power
Units
Pressure
pascals (53) hectopascals (133) kilopascals (54) millibars (134) bars (55) pounds-force-per-square-inch (56) centimeters-of-water (57) inches-of-water (58) millimeters-of-mercury (59) centimeters-of-mercury (60) inches-of-mercury (61) degrees-Celsius (62) degrees-Kelvin (63) degrees-Fahrenheit (64) degree-days-Celsius (65) degree-days-Fahrenheit (66) years (67) months (68) weeks (69) days (70) hours (71) minutes (72) seconds (73) meters-per-second (74) kilometers-per-hour (75) feet-per-second (76) feet-per-minute (77) miles-per-hour (78) cubic-feet (79) cubic-meters (80) imperial-gallons (81) liters (82) us-gallons (83)
Temperature
Time
Velocity
Volume
Units
Volumetric Flow
cubic-feet-per-minute (84) cubic-meters-per-second (85) cubic-meters-per-hour (135) imperial-gallons-per-minute (86) liters-per-second (87) liters-per-minute (88) liters-per-hour (136) us-gallons-per-minute (89) degrees-angular (90) degrees-Celsius-per-hour (91) degrees-Celsius-per-minute (92) degrees-Fahrenheit-per-hour (93) degrees-Fahrenheit-per-minute (94) kilowatt-hours-per-square-meter (137) kilowatt-hours-per-square-foot (138) megajoules-per-square-meter (139) megajoules-per-square-foot (140) no-units (95) parts-per-million (96) parts-per-billion (97) percent (98) percent-per-second (99) per-minute (100) per-second (101) psi-per-degree-Fahrenheit (102) radians (103) revolutions-per-minute (104) watts-per-square-meter-degree-kelvin (141)
Other
Units
4 I/O Microblocks
The I/O menu contains input and output microblocks that are used to communicate values between the modules and the HVAC equipment, or between modules on the CMnet. The following Input/Output Point microblocks are available:
Analog Input 69 Digital Input 71 73
Timed Local Override Pulse to Analog 75 LAN Analog Input 78 LAN Digital Input 81 Analog Output 83 Digital Output 85
Floating Motor Output 87 Pulse-Width Output 90 LAN Analog Output 93 LAN Digital Output 96
Airflow Control
99
107
Analog Input
Analog Input
The Analog Input microblock reads the value of a physical input on the module. The raw data from the sensor is converted to the appropriate range for its unit (like mA, degrees Fahrenheit, or psi) using the Offset and Gain settings. You can assign a name to each input which appears on the face of the microblock. The Expander setting (Exec 4.x and 5.x only) indicates the number of the expander module (normally 0-5 or 0-6). The Channel setting indicates which input on the hardware module this microblock represents. The Offset and Gain values are used to convert the raw data to a meaningful value used by the Graphic Function Block (GFB). The Technical Instructions document for your hardware module or the Technical Handbook can provide you with guidelines for determining the Expander, Channel, Offset, and Gain settings. These settings can be adjusted on the Parameter page using the chan, exp, offs, and gain parameters, respectively; however, these settings should not need to be adjusted after the initial installation unless the input point on the module is changed. The Trend section on the microblock dialog allows you to enable trending on this point and set the trend interval. The interval can be measured in seconds or minutes. When using this microblock in Exec 3.x modules, trends are enabled in the header of the Parameter page, not on the microblock dialog. For more information about trending and setting the trend parameters, refer to the SuperVision Users Guide. The Simulation section on the microblock dialog allows you to define a value for this microblock that will be used during Eikons simulation. For details about using simulation to test the operation of a GFB, refer to the section Testing the FB of the Eikon Users Guide. On the Parameter page, the lock setting allows you to define a value for the microblock which will be used instead of the actual value read by the module. Set the lock parameter to N to use the actual value read by the module.
Microblock
Analog Input
Digital Input
Digital Input
The Digital Input microblock reads the on or off value of a physical input on the module. You can assign a name to each input which appears on the face of the microblock. The Expander setting (Exec 4.x and 5.x only) indicates the number of the expander module (normally 0-5 or 0-6). The Channel setting indicates which input on the hardware module this microblock represents. The Technical Instructions document for your hardware module or the Technical Handbook can provide you with guidelines for determining the Expander and Channel settings. These settings can be adjusted on the Parameter page using the chan and exp parameters, respectively; however, these settings should not need to be adjusted after the initial installation unless the input point on the module is changed. The Trend section on the microblock dialog allows you to enable trending on this point and set the trend interval. The interval can be measured in seconds or minutes. When using this microblock in Exec 3.x modules, trends are enabled in the header of the Parameter page, not on the microblock dialog. For more information about trending and setting the trend parameters, refer to the SuperVision Users Guide. The Simulation section on the microblock dialog allows you to define a value for this microblock that will be used during Eikons simulation. For details about using simulation to test the operation of a GFB, refer to the section Testing the FB of the Eikon Users Guide. On the Parameter page, the lock setting allows you to define a value for the microblock which will be used instead of the actual value read by the module. Set the lock parameter to N to use the actual value read by the module. The fail setting indicates what the value of the microblock should default to when the equipment is turned off. When used with Exec 3.x modules, the Digital Input microblock can be configured to track the accumulated runtime of the equipment by setting the Acc runtime setting to yes. This causes the microblock to measure the amount of time in hours that the input has been on. A Runtime limit can also be configured; when this limit is reached, the input will automatically turn off. On the Parameter page, these settings can be adjusted using the runtime: clr and lim
Microblock
Digital Input
parameters. In Exec 4.x modules, use the Runtime Monitor microblock in the GFB to serve this function.
Microblock
closed setting to define the amount of time the override will be in effect. On the Parameter page, you can change this setting using the Broadcast Request Time parameter.
NOTE The Time Local Override microblock has a maximum accumulated time of 546 minutes.
Parameter text for Fixed Width and Mechanical Input (Exec 4.x)
________________(TLO) exp ___ chan __ lock _ ___ Mode=_ (1=Pulse;2=Timr;3=Fixed) Broadcast Request time _____ (mm:ss)
Pulse to Analog
Pulse to Analog
The Pulse to Analog microblock counts pulses from a digital input over a specified period of time. The value of the microblock is determined by calculating the average number of pulses received over the specified time. You can assign a name to the input which appears on the face of the microblock. The Expander setting (Exec 4.x and 5.x only) indicates the number of the expander module (normally 0-5 or 0-6). The Channel setting indicates which input on the hardware module this microblock represents. The Technical Instructions document for your hardware module or the Technical Handbook can provide you with guidelines for determining the Expander and Channel settings. These settings can be adjusted on the Parameter page using the chan and exp parameters, respectively; however, these settings should not need to be adjusted after the initial installation unless the input point on the module is changed. The Gain setting determines the quantity that each pulse represents. The Pulse window setting determines the time period over which the rate is averaged. The average is calculated every minute using the following formula (where P is the number of pulses received over the duration of the pulse window, M is Pulse window setting, and G is the Gain setting):
P ---- G = microblock value M
Microblock
The example below shows how this microblock can be used to calculate instantaneous demand.
Pulse to Analog
Instantaneous Demand
The Pulse-to-Analog microblock (labeled "KWH PULSE" in the diagram above) uses the following values: The Gain is the value of kilowatt-hours per pulse, which is provided by the electric company (in this case, 1 KWH/Pulse). The Pulse Window is the time period used to calculate the instantaneous demand (in this case, 30 minutes). The microblocks value is multiplied by 60 to convert the result from kilowatt-hours per minute to kilowatthours. If 50 pulses are counted during the pulse window, the following result is calculated for instantaneous demand:
50 5 ----- 1 = -- 60 = 100 KW 30 3 NOTE The Pulse to Analog microblock cannot count more than 4 pulses per second. Because of the delay associated with the T-Line subnet, the use of this microblock in T-Line modules is not recommended or supported.
Pulse to Analog
Microblock
NOTE When receiving a Timed Local Override broadcast from a nongraphic function block, the input must be multiplied by 16. This is because the old-style broadcast is not 100% compatible with the new microblock.
The Inact value setting on the microblocks dialog determines the value that the microblock uses when information from a LAN Analog Output is unavailable. The Simulation section of the dialog allows you to determine a cell number to read or a value for the microblock to use during Eikon simulation. For more information about using cells and Eikon simulation, refer to the section Testing the FB of the Eikon Users Guide. On the Parameter page, the lock setting allows you to define a value for the microblock which will be used instead of the microblocks actual value. Set the lock parameter to N to use the actual value of the microblock. Once a GFB using the LAN Analog Input microblock is complete, you must indicate which LAN Analog Output the LAN Analog Input receives information from. This is done by assigning special twonumber addresses to the microblocks on each GFBs Parameter page in SuperVision. The Listen to parameter for LAN Analog Input contains the address of the LAN Analog Output that the input gets its information from. For example, if a LAN Analog Input is used to receive information from a LAN Analog Output whose address is 101, 2, then the LAN Analog Input would have 101, 2 entered as its Listen to parameter. For information about assigning addresses to LAN Analog Outputs, refer to the section LAN Analog Output on page 93.
Microblock
On the Parameter page, the lock setting allows you to define a value for the microblock which will be used instead of the microblocks actual value. Set the lock parameter to N to use the actual value of the microblock.
Once a GFB using the LAN Digital Input microblock is complete, you must indicate which LAN Digital Output the LAN Digital Input receives information from. This is done by assigning special twonumber addresses to the microblocks on each GFBs Parameter page in SuperVision. The Listen to parameter for LAN Digital Input contains the address of the LAN Digital Output that the input gets its information from. For example, if a LAN Digital Input is used to receive information from a LAN Digital Output whose address is 101, 2, then the LAN Digital Input would have 101, 2 entered as its Listen to parameter. For information about assigning addresses to LAN Digital Outputs, refer to the section LAN Digital Output on page 96.
Analog Output
Analog Output
The Analog Output microblock sends a value from the GFB to a physical output on the module. The value received by this microblock from the GFB is converted to a signal which is read by the hardware module. You can assign a name to each input which appears on the face of the microblock. The Expander setting (Exec 4.x and 5.x only) indicates the number of the expander module (normally 0-5 or 0-6). The Channel setting indicates which output on the hardware module this microblock represents. The Offset and Gain values are used to convert the microblocks value to a form that is used by the module. The Technical Instructions document for your hardware module or the Technical Handbook can provide you with guidelines for determining the Expander, Channel, Offset, and Gain settings. These settings can be adjusted on the Parameter page using the chan, exp, offs, and gain parameters, respectively; however, these settings should not need to be adjusted after the initial installation unless the output point on the module is changed. The Trend section on the microblock dialog allows you to enable trending on this point and set the trend interval. The interval can be measured in seconds or minutes. When using this microblock in Exec 3.x modules, trends are enabled in the header of the Parameter page, not on the microblock dialog. For more information about trending and setting the trend parameters, refer to the SuperVision Users Guide. On the Parameter page, the lock setting allows you to define a value for the microblock which will be used instead of the microblocks actual value. Set the lock parameter to N to use the actual value of the microblock.
Microblock
Analog Output
Digital Output
Digital Output
The Digital Output microblock transmits the on or off value from the GFB to a physical output on the module. You can assign a name to each input which appears on the face of the microblock. The Expander setting (Exec 4.x and 5.x only) indicates the number of the expander module (normally 0-5 or 0-6). The Channel setting indicates which output on the hardware module this microblock represents. The Technical Instructions document for your hardware module or the Technical Handbook can provide you with guidelines for determining the Expander and Channel settings. These settings can be adjusted on the Parameter page using the chan and exp parameters, respectively; however, these settings should not need to be adjusted after the initial installation unless the output point on the module is changed. The Trend section on the microblock dialog allows you to enable trending on this point and set the trend interval. The interval can be measured in seconds or minutes. When using this microblock in Exec 3.x modules, trends are enabled in the header of the Parameter page, not on the microblock dialog. For more information about trending and setting the trend parameters, refer to the SuperVision Users Guide. On the Parameter page, the lock setting allows you to define a value for the microblock which will be used instead of the microblocks actual value. Set the lock parameter to N to use the actual value of the microblock. The fail setting indicates what the value of the microblock should default to in the event the module is unable to communicate with the equipment (such as a power failure in the module). When used with Exec 3.x modules, the Digital Output microblock can be configured to track the accumulated runtime of the equipment and define a minimum amount of time for the equipment to be on or off. The Minimum ON time setting (mon on the Parameter page) determines how long the output should stay on when the microblock sends an "on" signal to the module. The Minimum OFF time setting (moff on the Parameter page) determines how long the output should stay off when the microblock sends an "off" signal to the module. In Exec 4.x modules, use the Minimum On/Off Timer microblock to serve this function.
Microblock
Digital Output
Runtime can be tracked in Exec 3.x modules by setting the Acc runtime setting to yes. This causes the microblock to measure the amount of time in hours that the output has been on. A Runtime limit can also be configured; when this limit is reached, the input will automatically turn off. On the Parameter page, these settings can be adjusted using the runtime: clr and lim parameters. In Exec 4.x modules, use the Runtime Monitor microblock in the GFB to serve this function.
Microblock
If the Full travel time is inaccurate, the calculated position of the actuator will also be inaccurate. Over time, multiple adjustments can cause the error to be quite large and affect the ability of the equipment to efficiently achieve the desired setpoint. For this reason it is recommended that you program the GFB to allow the Floating Motor Output microblock to recalibrate itself by using a value of 0% or 100%. When the microblocks value is either 0% or 100%, the microblock recalibrates by sending an additional signal for the full duration of the travel time to ensure that a fully open or fully closed position is obtained. On the microblocks dialog, the Expander setting (Exec 4.x and 5.x only) indicates the number of the expander module (normally 0-5 or 0-6). The Channel setting indicates which output on the hardware module this output represents. Because the Floating Motor Output microblock actually controls two digital points, two different channel numbers are required for each point. The Technical Instructions document for your hardware module or the Technical Handbook can provide you with guidelines for determining the Expander and Channel settings. These settings can be adjusted on the Parameter page using the chan and exp parameters, respectively; however, these settings should not need to be adjusted after the initial installation unless the output point on the module is changed. The Min pulse width setting (Min Pulse on the Parameter page) indicates the minimum amount of time the motor should be activated anytime it moves. When the Floating Motor microblock receives a new position, if the time required to move that amount is less than the Min pulse width, the microblock will not activate the motor. The Maintain contact closure setting allows you to determine whether the motor should remain activated after it has recalibrated itself at 0% or 100%. This setting can be adjusted using the Maintain OPEN at 100% and CLOSE at 0% parameter on the Parameter page. If this is set to YES, the motor remains activated after it has reached its limit of 0% or 100%. If this is set to NO, the motor will stop after recalibrating to its fully open or closed position. If this is set to NO when the module is restarted or when the Floating Motor Output microblock has a value of 0% or 100%, then the Parameter page text Proceeding with power up initialization appears.
The fail setting indicates what the status the equipment should default to in the event the module is unable to communicate with the equipment (such as a power failure in the module). The lock setting cannot be changed.
Pulse-Width Output
Pulse-Width Output
The Pulse-Width Output microblock converts a percent value from the GFB to a digital on or off signal. The duration of the signal is calculated according to the percent value of the microblock and is based on minimum and maximum values you define. The PulseWidth Modulation Output microblock can be used for hot wax valve modulation or for interfacing with a pulse width transducer. You can assign a name for the Pulse-Width Output which appears on the face of the microblock. The Expander setting (Exec 4.x and 5.x only) indicates the number of the expander module (normally 0-5 or 0-6). The Channel setting indicates which output on the hardware module this microblock represents. The Technical Instructions document for your hardware module or the Technical Handbook can provide you with guidelines for determining the Expander and Channel settings. These settings can be adjusted on the Parameter page using the chan and exp parameters, respectively; however, these settings should not need to be adjusted after the initial installation unless the output point on the module is changed. On the microblock dialog, the 100% setting defines the maximum duration the signal should be when the value of the microblock is 100%. On the Parameter page, this setting is represented as Full Scale. The 0% setting defines the minimum duration the signal should be when the value of the microblock is 0%. On the Parameter page, this setting is represented as Min Pulse. The total duration of the signal is a combination of the minimum (0%) and maximum (100%) times. The signal duration is calculated as follows, where m is the 0% setting (minimum pulse width), M is the 100% setting (maximum pulse width), and P is the percent value of the microblock:
signal duration = m + ( M P )
Microblock
Pulse-Width Output
Example
0% = 5 sec., 100% = 40 sec., input = 25%
In this example, the signal duration equals (5 sec.) + (40 sec. x .25), or 15 seconds. In the Pulse refresh time section, the Minimum setting defines how long to wait before sending a new signal. If the microblocks value changes before this time, the GFB will ignore it until the minimum time expires. This value can be adjusted on the Parameter page using the Min Refresh parameter.
TIP The minimum refresh time must be at least as long as the total of the 0% and 100% pulse width times, otherwise the minimum time may expire before the complete pulse has been sent.
The Maximum setting defines how long to wait before sending a new signal if the percent value has not changed since the last pulse. If the value has not changed by the time the maximum time expires, the GFB will send the same pulse again. This setting can be adjusted on the Parameter page using the Max Refresh parameter. The maximum time must be longer than the minimum time. The maximum is usually obtained from the end-device manufacturer's specifications. If the percent value changes after the minimum refresh time but before the maximum refresh time, the FB will immediately send a new pulse and reset minimum refresh time and maximum refresh time. On the Parameter page, the lock setting allows you to define a value for the microblock which will be used instead of the microblocks actual value. Set the lock parameter to N to use the actual value of the microblock.
Pulse-Width Output
Microblock
If the microblocks value is being used only by other graphic FBs, enter 129 as the command number on the microblocks dialog (the Send command setting on the Parameter page). If the value is being used by non-graphic FBs, click the button representing the global command the microblock broadcasts: an occupancy override (command 3), or a LAN variable (command 11-global variables). You can also broadcast other analog global commands by entering the appropriate command
number in the Send command setting. The section Non-Graphic FB Commands on page 351 provides a description of global commands and command numbers that can be used with non-graphic FBs. The Simulation section of the dialog allows you to determine what cell number, if any, to write to during Eikon simulation. For more information about using cells and Eikon simulation, refer to the section Testing the FB of the Eikon Users Guide. On the Parameter page, the lock setting allows you to define a value for the microblock which will be used instead of the microblocks actual value. Set the lock parameter to N to use the actual value of the microblock. Once a GFB using the LAN Analog Output microblock is complete, you must indicate an address for the microblock that LAN Analog Input microblocks can use to receive information. This is done by assigning a special two-number address to the microblock on the GFBs Parameter page in SuperVision. The Using Address parameter for the LAN Analog Output should be assigned as described below: When transferring information between modules on the same CMnet, use numbers 101-199 for the first number of the address. When transferring information between modules on the same LGnet but different CMnets, use the numbers 201-254 for the first number of the address. The second number of the address should be 1-60, and should be sequentially increased by one for each LAN output on the CMnet.
For example, control module number 5 is using a LAN AO to broadcast information to module number 16 on the same CMnet. The LAN AO has 105, 1 entered as its Using Address parameter, and the LAN AI receiving the information in control module number 16 has 105, 1 entered as its Listen to parameter. Every LAN AO in a system must have a unique address; however, more than one LAN AI can receive information from a single LAN AO.
Microblock
If the microblocks value is being used only by other graphic FBs, enter 129 as the command number on the microblocks dialog (the Send command setting on the Parameter page). If the value is being used by non-graphic FBs, click the button representing the global command the microblock broadcasts: shutdown (command 1), norm/rev (command 2-changeover), compressor shutdown (command 4), soft shutdown (command 6), or LAN on/off (command 11-global
variables). You can also broadcast other digital global commands by entering the appropriate command number in the Send command setting. The section Non-Graphic FB Commands on page 351 provides a description of global commands and command numbers that can be used with non-graphic FBs. The Simulation section of the dialog allows you to determine what cell number, if any, to write to during Eikon simulation. For more information about using cells and Eikon simulation, refer to the section Testing the FB of the Eikon Users Guide. On the Parameter page, the lock setting allows you to define a value for the microblock which will be used instead of the microblocks actual value. Set the lock parameter to N to use the actual value of the microblock. Once a GFB using the LAN Digital Output microblock is complete, you must indicate an address for the microblock that LAN Digital Input microblocks can use to receive information. This is done by assigning a special two-number addresses to the microblock on the GFBs Parameter page in SuperVision. The Using Address parameter for the LAN Digital Output should be assigned as described below: When transferring information between modules on the same CMnet, use numbers 101-199 for the first number of the address. When transferring information between modules on the same LGnet but different CMnets, use the numbers 201-254 for the first number of the address. The second number of the address should be 1-60, and should be sequentially increased by one for each LAN output on the CMnet.
For example, control module number 3 is using a LAN DO to broadcast information to module number 8 on the same CMnet. The LAN DO has 101, 1 entered as its Using Address parameter, and the LAN DI receiving the information in control module number 8 has 101, 1 entered as its Listen to parameter. Every LAN DO in a system must have a unique address; however, more than one LAN DI can receive information from a single LAN DO.
Airflow Control
Airflow Control
The Airflow Control microblock accesses the airflow control algorithm available in U-Line control modules using Exec 6.02 (or later) module drivers. This microblock provides inputs and outputs that communicate parameter and status values to and from the flow control algorithm using predefined channel numbers. This microblock is also used to access the built-in testing and balancing procedure that allows a VAV box to be commissioned through a LogiStat Pro zone sensor. To use this microblock, be sure to select Exec 6.x and Zone GFB from the Option menu on the menu bar. To select GFBs created in previous versions of this microblock, select GFBInsert MB on the menu bar.
Microblock
Airflow Control
The OCC input lets the microblock know if the zone is occupied or unoccupied. This determines whether the Occupied Min Airflow or the Unoccupied Min Airflow parameter will be used as the low limit for the flow setpoint. The HEAT MODE input lets the microblock know if the Air Handling Unit is supplying warm air to the VAV box. Many VAV systems are cooling only, in which case this input would never be active, but some VAV systems have heating coils in the Air Handling Unit and can supply warm air to the VAV boxes when heating is required. In these systems, a LAN point or other external logic must be used to tell the VAV zones if the Air Handling Unit is supplying warm air or cool air to the VAV boxes. The FAN input should be used if the VAV box includes a circulation fan, either series or parallel. If the VAV box contains such a fan, parameters in this microblock are used to assign an output channel number to this fan, and this output will turn on whenever the FAN input is on. By routing the fan signal through this microblock, the technician can switch the fan on or off from a LogiStat Pro while testing and balancing. The clg% and htg% inputs are normally connected to the corresponding outputs on a Zone microblock. Under normal circumstances, The clg % input will control the airflow setpoint from 0 to the Cooling Max Airflow setting as the clg % input ranges from 0 to 100%. (Various minimum airflow parameters can set a lower limit on this setpoint, as determined by operating conditions.) If the HEAT MODE input is on and the Use Supply Air for Heating parameter is set to yes, the htg % input will take control of the damper and modulate the airflow setpoint from 0 to the Heating Max Airflow setting in a similar manner. The htg % input is also passed through the microblock to the AUX HEAT output, allowing this microblock to control an auxiliary heating coil if one is present in the VAV box. This passthrough occurs regardless of the the state of the HEAT MODE input or the Use Supply Air for Heating parameter. As with the fan control, the advantage of controlling the heating coil through this microblock is that it allows the technician to open and close the heating valve from a LogiStat Pro while testing and balancing. The other outputs from this microblock are the actual flow reading (FLOW), the flow setpoint (FLOW SP), and outputs indicating that the damper has reached a fully open or fully closed position (FULL OPN, FULL CLS). The damper full open or closed signals are only active
Airflow Control
when a control module with built-in actuator, such as a U341v+, is used. If any other module is being used, these outputs will always be off. For more information on the built-in testing and balancing procedures, refer to the appropriate control module documentation.
Airflow Control
The Flow Measurement Units field is for display and documentation purposes only. The sensor reading will be given in the same units used during the system calibration. If the flow calibration readings are entered in CFM, for example, the flow sensor will read in CFM. This field allows you to record what units were used and to display them on the Status and Parameter pages. The Damper Travel Time field should be set to the total time required for the damper motor to travel from its full-closed to full-open position. The Direction field tells the flow control algorithm whether the motor turns clockwise or counter-clockwise to open the dampers. If the Use Supply Air for Heating when Heat Mode is ON field is set to yes, the flow control algorithm uses the htg % input to control the VAV dampers when the Air Handling unit is supplying warm air to the VAV boxes. If this field is set to no, the dampers will be controlled to provide the appropriate minimum occupied or unoccupied airflow to the zone during the warm-up period. The Flow Loop # allows multiple instances of this microblock to be used in the same GFB. If this is a typical single-duct VAV system, this number should be set to 1. Dual-duct systems require two Airflow Control microblocks (one for each duct). The microblock which is controlling the primary cooling duct should have this field set to 1. The microblock which is controlling the second duct, typically a heating or ventilating duct, should have this field set to 2.
NOTE This microblock requires the hardware configuration and airflow source of these loops be set on the module driver's Parameter page.
The Name field can be used to give this microblock a unique 24character name, such as VAV 1-2 Cooling Flow or Dual-Duct Heating Flow, for display on the Status and Parameter pages. This parameter is for documentation and display purposes only and does not affect the operation of the microblock. The Simulation section on the dialog controls the outputs of this microblock in Eikon's simulation mode. The values entered do not affect the outputs during actual operation.
Airflow Control
Airflow Calibration
The Parameter page provides access to the calibration data needed to convert the flow sensor reading into an air flow measurement for the particular VAV box being controlled. For accuracy, follow a fourpoint calibration procedure. Instructions for performing this calibration manually (from SuperVision) are included on the Parameter page. You can view these instructions, along with the calibration table, can be viewed by setting the Use Calibration Table parameter to yes. If you are using a LogiStat Pro zone sensor, you can calibrate each individual zone by using a preprogrammed calibration procedure. This procedure allows testing and balancing personnel to fill in the calibration table directly, as they balance the system, without requiring them to relay information to a SuperVision operator. If the calibration has not yet been performed, the default values in the calibration table provide enough control over the VAV box to allow initial mechanical system testing and verification to be done. If the flow characteristics of the VAV box are known (either from a K-factor or a factory supplied flow graph) better control is achieved by entering the flow reading that corresponds to a 1 water gauge velocity pressure on the flow sensor. To enter this value, set the Use Calibration Table parameter to no. The Parameter page then displays the line Air flow at 1" water column_________.
Airflow Control
Enter the appropriate airflow reading in this parameter, and the flow sensor will use this as a calibration point. This does not prevent you from doing a more accurate four-point calibration procedure at a later date. The pre-programmed LogiStat Pro calibration procedure automatically resets the Use Calibration Table parameter to yes and uses the measured calibration data in place of the estimated value entered for 1" water column.
NOTE If you are not using water column units, enter the flow reading in whatever units you prefer for the equivalent of 1 water column. For example, if you have flow data in cubic meters/hr vs mm of HG, enter the flow reading for 1.8665 mm HG (the equivalent of a 1-inch water column).
Airflow Control
Airflow Control
Microblock
5 SysIn Microblocks
The SysIn menu contains microblocks that receive heat and cool requests, as well as other system information. Requests are the method by which GFBs communicate their heating and cooling needs to each other. By using requests you can construct a software "chain" mimicking the mechanical chain of equipment in the building. When properly constructed, requests allow you to schedule terminal or zone equipment only, and allow other equipment to respond to the zone requests. The equipment serving the zones can use requests along with the setpoint optimization microblock to constantly adjust discharge setpoints in order to minimize energy consumption. The following microblocks are available in the SysIn menu:
Receive Run Request 113 Receive Heat Request 115 Receive Cool Request 117
Receive Heat and Cool Requests 119 Get System Variable 121
Get System Status 123 Receive Electrical Demand Level Binary Parameter Analog Parameter 126 127 125
Microblock
In the example above, the parameter text for the binary parameter microblock reads Allowed to cancel run requests? You can then change this parameter to Yes or No on the Parameter page depending on whether or not you want the GFB to cancel requests. The Transmit Run Request microblock that is sending the request should contain the address of the GFB containing the Receive Run Request microblock. Therefore, on the Parameter page of the Receive Run Request microblock, the listen to requests sent to parameter should be set to 0,0 (yourself). If you need to receive requests from a GFB located on a different CMnet that shares the same LGnet, use the LAN Input and Output microblocks instead of the Transmit and Receive Request microblocks. Refer to the section I/O Microblocks on page 67 for more information about the LAN Input and Output microblocks.
On the microblock dialog, the Simulation section allows you to determine a cell number to read or a value for the microblock to use during Eikon simulation. For more information about using cells and Eikon simulation, refer to the section Testing the FB of the Eikon Users Guide.
Microblock
In the example above, the parameter text for the binary parameter microblock reads Allowed to cancel run requests? You can then change this parameter to Yes or No on the Parameter page depending on whether or not you want the GFB to cancel requests. The microblock that is sending the request (Transmit "I need heat" Request or Transmit Multiple Heat Request) should contain the address of the GFB containing the Receive Heat Request microblock. Therefore, on the Parameter page of the Receive Heat Request microblock, the listen to requests sent to parameter should
be set to 0,0 (yourself). If you need to receive requests from a GFB located on a different CMnet that shares the same LGnet, use the LAN Input and Output microblocks instead of the Transmit and Receive Request microblocks. Refer to the section I/O Microblocks on page 67 for more information about the LAN Input and Output microblocks. On the microblock dialog, the Simulation section allows you to determine a cell number to read or values for the microblock to use during Eikon simulation. For more information about using cells and Eikon simulation, refer to the section Testing the FB of the Eikon Users Guide.
Microblock
In the example above, the parameter text for the binary parameter microblock reads Allowed to cancel run requests? You can then change this parameter to Yes or No on the Parameter page depending on whether or not you want the GFB to cancel requests. The microblock that is sending the request (Transmit "I need cool" Request or Transmit Multiple Cool Request) should contain the address of the GFB containing the Receive Cool Request microblock. Therefore, on the Parameter page of the Receive Cool Request microblock, the listen to requests sent to parameter should
be set to 0,0 (yourself). If you need to receive requests from a GFB located on a different CMnet that shares the same LGnet, use the LAN Input and Output microblocks instead of the Transmit and Receive Request microblocks. Refer to the section I/O Microblocks on page 67 for more information about the LAN Input and Output microblocks. On the microblock dialog, the Simulation section allows you to determine a cell number to read or values for the microblock to use during Eikon simulation. For more information about using cells and Eikon simulation, refer to the section Testing the FB of the Eikon Users Guide.
Microblock
In the example above, the parameter text for the binary parameter microblock reads Allowed to cancel run requests? You can then change this parameter to Yes or No on the Parameter page depending on whether or not you want the GFB to cancel requests. The microblock that is sending the request should contain the address of the GFB containing the Receive Heat and Cool Request microblock. Therefore, on the Parameter page of the Receive Heat and Cool
Request microblock, the listen to requests sent to parameter should be set to 0,0 (yourself). If you need to receive requests from a GFB located on a different CMnet that shares the same LGnet, use the LAN Input and Output microblocks instead of the Transmit and Receive Request microblocks. Refer to the section I/O Microblocks on page 67 for more information about the LAN Input and Output microblocks. On the microblock dialog, the Simulation section allows you to determine a cell number to read or values for the microblock to use during Eikon simulation. For more information about using cells and Eikon simulation, refer to the section Testing the FB of the Eikon Users Guide.
Microblock
The Outside Air temperature, humidity and enthalpy are only available to this microblock if an Outside Air Broadcast microblock is used in a GFB in the same CMnet. If an Outside Air Broadcast microblock is not used on the CMnet, the Get System Variable microblock will have an invalid value. An invalid value may also be the result of a communication, power, or other failure in the CMnet. The Status page text for this microblock varies depending on the type of information received. If you need to receive information that is only available on a different CMnet that uses the same LGnet, use the LAN Input and Output microblocks to transfer this value. Refer to the
section I/O Microblocks on page 67 for more information about the LAN Input and Output microblocks.
Microblock
This microblock can only be used to determine the status of outside air temperature or communication on the same CMnet. The Status page text changes depending on which option is chosen on the microblock dialog.
Microblock
Binary Parameter
Binary Parameter
Binary Parameter microblocks are used to create a yes or no, on or off signal to be sent to another microblock in the GFB. You determine the description of the microblock using the Parameter screen prompt text setting on the microblocks dialog. You set the value of this microblock on the microblock dialog or on the Parameter page. The descriptive parameter text is displayed on the Parameter page in gray, and the value is displayed in blue. The microblock can be assigned a yes/no or on/off value on the microblock dialog. The Value setting on the dialog defines the default value of the microblock, where 0 represents no or off, and 1 represents yes or on.
Microblock
Analog Parameter
Analog Parameter
Analog Parameter microblocks are used to specify a numeric value to be sent to another microblock in the GFB. This value can be changed on the GFBs Parameter page or on the microblocks dialog. You determine the description of the microblock using the Parameter screen prompt text setting on the microblocks dialog. The descriptive parameter text is displayed on the Parameter page in gray, and the value is displayed in blue. The microblocks value can be assigned one of four ranges or values: -100 to +100, -30,000 to +30,000, floating point, or enumerated value. The range that you choose affects the amount of memory used by the GFB, so choose the smallest range that suits your application. The floating point option uses the most memory, while the -100 to +100 range uses the least.
Microblock
An enumerated value can represent a word or phrase corresponding to the microblocks value. To include an enumerated value in an Analog Parameter microblock, select the GFB-Insert MBs option on the menu bar instead of selecting it from the palette. Then, select M$PARA2.sym from the drop-down list and press the ##,ABC enum button to display the Value-String Pairs edit window. Enter the input value and the phrase that you would like it to represent in the ValueString Pairs edit window.
Analog Parameter
Time Parameter
Time Parameter
Time Parameter microblocks are used to specify a time value to be sent to another microblock in the GFB. This value can be changed on the GFBs Parameter page or on the microblocks dialog. You determine the description of the microblock using the Parameter screen prompt text setting on the microblocks dialog. The descriptive parameter text is displayed on the Parameter page in gray, and the value is displayed in blue.
Microblock
Binary Constant
Binary Constant
Binary Constant microblocks are used to specify a yes/no or on/off value to be sent to another microblock in the GFB. Binary Constants do not appear on the Parameter or Status pages and should be used instead of Binary Parameter microblocks when the value of the microblock will not change. The microblock can be assigned a yes/no or on/off value, depending on your application. The Value setting indicates the default value of the microblock, where 0 represents no or off and 1 represents yes or on. This value can only be changed on the microblock dialog.
Microblock
Analog Constant
Analog Constant
Analog Constant microblocks are used to specify a numeric value to be sent to another microblock in the GFB. Analog Constants do not appear on the Parameter or Status pages and should be used instead of Analog Parameter microblocks when the value of the microblock will not change (such as a flow coefficient or pi). The microblocks value can be assigned one of three ranges: -100 to +100, -30,000 to +30,000, or floating point. The range that you choose will affect the amount of memory used by the GFB, so you can choose the smallest range that suits your application. The floating point option uses the most memory, while the -100 to +100 range uses the least.
Microblock
Time Constant
Time Constant
Time Constant microblocks are used to specify a time value to be sent to another microblock in the GFB. Time Constants do not appear on the Parameter or Status pages and should be used instead of Time Parameter microblocks when the value of the microblock will not change. The microblocks value must be defined in hours and minutes.
Microblock
6 SysOut Microblocks
The SysOut menu contains microblocks that send heat and cool requests, as well as other system information. Requests are the method by which GFBs communicate their heating and cooling needs to each other. Using requests you can construct a software "chain" mimicking the mechanical chain of equipment in the building. When properly constructed, requests allow you to schedule terminal or zone equipment only and allow other equipment to respond to the zone requests. The equipment serving the zones can use requests along with the setpoint optimization microblock to constantly adjust discharge setpoints in order to minimize energy consumption. The following microblocks are available in the SysOut menu:
Transmit Run Request 135
Transmit Heat Request 137 Transmit Cool Request 139 Transmit Multiple Heat Requests 141 Transmit Multiple Cool Requests 143 Prime Variable 145 Demand Broadcast 146 Binary Status 147 Analog Status 148 Time Status 149
Microblock
Microblock
Microblock
Microblock
Microblock
Prime Variable
Prime Variable
The Prime Variable microblock identifies a single specific value from the GFB that the workstation needs quick access to, such as the current zone temperature. The value of the Prime Variable microblock, like the FBs color, is stored in the gateway module where the workstation can retrieve it quickly and without having to access the individual GFB. The prime variable is sent after the GFBs update time has expired. The update time is visible in the header of the GFBs Parameter page. Because the prime variable can be retrieved by the workstation as quickly as the colors can, you can add a prime variable to a SuperVision graphic without significantly increasing the redraw time of the graphic. To include the prime variable in a GFBs graphic drawing, use ALC Draws Variable Text feature and the following text expression: FBID$T, where FBID is the ID of the GFB (located in the header of the GFBs Parameter page).
Microblock
Demand Broadcast
Demand Broadcast
The Demand Broadcast microblock sends the current demand level to the Receive Electrical Demand Level microblock in another GFB on the same CMnet. The value of this microblock is either 0, 1, 2, or 3, corresponding to the current electrical demand level. The demand level can be calculated using the Pulse to Analog microblock and information obtained from your electric company. For an example of how to calculate demand in a GFB, refer to the section Pulse to Analog on page 75. If the Receive Electrical Demand Level microblock is located on a different CMnet using the same LGnet, use the LAN Input and Output microblocks instead of the Demand microblocks. Refer to the section I/O Microblocks on page 67 for more information about the LAN Input and Output microblocks.
Microblock
Binary Status
Binary Status
The Binary Status microblock displays a yes/no or on/off value from the GFB on the Status page. You can use this microblock to display the value of another microblock that would not normally appear on the Status page. You determine the description of the microblock using the Status screen prompt text setting on the microblocks dialog. The microblock can be assigned a yes/no or on/off value on the microblock dialog, according to the type of information received.
Microblock
Analog Status
Analog Status
The Analog Status microblock displays the numeric value from the GFB on the Status page. You can use this microblock to display the value of another microblock that would not normally appear on the Status page. You determine the description of the microblock using the Status screen prompt text setting on the microblocks dialog. The microblocks value can be assigned one of four ranges or values: -100 to +100, -30,000 to +30,000, floating point, or enumerated value. The range that you choose affects the amount of memory used by the GFB, so choose the smallest range that suits your application. The floating point option uses the most memory, while the -100 to +100 range uses the least.
Microblock
An enumerated value can represent a word or phrase corresponding to the microblocks value. To include an enumerated value in an Analog Status microblock, select the GFB-Insert MBs option on the menu bar instead of selecting it from the palette. Then, select M$STATA2.sym from the drop-down list and press the ##,ABC enum button to display the Value-String Pairs edit window. Enter the input value and the phrase that you would like it to represent in the ValueString Pairs edit window.
Time Status
Time Status
The Time Status microblock displays a time value from the GFB on the Status page. You can use this microblock to display the value of another microblock that would not normally appear on the Status page. You determine the description of the microblock using the Status screen prompt text setting on the microblocks dialog. The microblocks value must be defined in hours and minutes. If the microblock receives a numeric value, minutes and seconds value, or other value, it will not be converted to an hours and minutes value.
Microblock
Microblock
Microblock
message on the Parameter page, note that the following alarm and message flags are reserved: Table 6-1. Reserved alarm and message flags
Type of flag alarm message message message message Flag number 1 1 6 7 8 Reserved for Point under manual lock Runtime Expired FB error Daily Trend Report Daily Status Report
The Text setting in the Parameter page header indicates the number that corresponds to the text of the alarm or message. The alarm and message text can be located in the xxxalarm.txt or sysalarm.txt files. If you need to broadcast this microblocks values to GFBs on a different CMnet that shares the same LGnet, use the LAN Input and Output microblocks instead of the Outside Air Broadcast and Get System Variable microblocks. Refer to the section I/O Microblocks on page 67 for more information about the LAN Input and Output microblocks.
NOTE This microblock is not compatible with Exec 6.x firmware. If Exec 6.x modules are installed, use the OA3 microblock (described on page 154).
Microblock
The following table describes the microblocks inputs and outputs Table 6-2. OA3 microblock inputs and output
Name temp humidity enthalpy alarm Description temperature input humidity input enthalpy input Alert event trigger output Type of value numeric (analog) numeric (analog) numeric (analog) on or off (digital)
7 Log Microblocks
The Log menu contains microblocks that log system information such as trends and alarms. The following microblocks are available in the Log menu:
Digital Trend 158 Analog Trend 160 Set Alarm Number 162 Set Message Number 164 Set Runtime Exceeded Flag 166 Runtime Monitor Alert Event 170 168
176
178
Digital Trend
Digital Trend
The Digital Trend microblock records data for trend purposes from a digital microblock output. If you want to trend information from a Digital Input microblock, this can be accomplished using the Digital Input alone, without the Digital Trend microblock. Refer to the section Digital Input on page 71 for details. When enabled, this microblock records its value in the modules memory at the interval you define. The interval can be measured in minutes or seconds. Each trend holds the most recent 288 samples in memory (288 = 24 hours at 5 minute intervals). You can use up to 254 Digital or Analog Trend microblocks in a single GFB; however, because each active trend consumes a portion of the module's memory, the maximum number of trends you can use at any one time will be less than this. Each trend may be individually enabled and disabled, and when disabled, consumes no memory. (To enable the trend from the Parameter page, make sure the trend parameter is set to Y.) Trend reports are no longer generated or viewed as in previous versions of Alert EL. Refer to the SuperVision and Gopher Users Guides for details about viewing trend information. The trend from this microblock assumes the same address of the FB in which it resides, except the expander number is 94 and the channel number is the trend's wire number (as reported in the wire parameter on the Parameter or Status page).
Microblock
Digital Trend
Analog Trend
Analog Trend
The Analog Trend microblock records data for trend purposes from an analog microblock output. If you want to trend information from an Analog Input microblock, this can be accomplished using the Analog Input alone, without the Analog Trend microblock. When enabled, this microblock records its value in the modules memory at the interval you define. The interval can be measured in minutes or seconds. Each trend holds the most recent 288 samples in memory (288 = 24 hours at 5 minute intervals). You can use up to 254 Digital or Analog Trend microblocks in a single GFB; however, because each active trend consumes a portion of the module's memory, the maximum number of trends you can use at any one time will be less than this. Each trend may be individually enabled and disabled, and when disabled, consumes no memory. (To enable the trend from the Parameter page, make sure the trend parameter is set to Y.) Trend reports are no longer generated or viewed as in previous versions of Alert EL. Refer to the SuperVision and Gopher Users Guides for details about viewing trend information. The trend from this microblock assumes the same address of the FB in which it resides, except the expander number is 94 and the channel number is the trend's wire number (as reported on the Parameter or Status page).
Microblock
Analog Trend
Microblock
In this example, alarm flags 2 and 7 have been enabled. When alarm flag 2 is activated in the GFB, the alarm report displays the text represented by the number 72 in the xxxalarm.txt or sysalarm.txt files. When alarm flag 7 is activated, the alarm report shows the text for number 115 in the xxxalarm.txt or sysalarm.txt files. If both the xxxalarm.txt or sysalarm.txt files contain the same number (for example, they each contained different text for number 72), the information in the xxxalarm.txt file is displayed. Alarm flag 1 is reserved for indicating that points are under manual lock. If this flag is enabled on the Parameter page, an alarm will be reported whenever a microblocks lock parameter is set to Y on the Parameter page.
Microblock
In this example, message flag 2 has been enabled. When message flag 2 is activated in the GFB, the message report displays the text represented by the number 15 in the xxxalarm.txt or sysalarm.txt files. If both the xxxalarm.txt or sysalarm.txt files contain the same number (for example, they each contained different text for number 15), the information in the xxxalarm.txt file is displayed. Table 7-1 shows which message flags are reserved. Message flags 1 and 6 cannot be set on the microblock dialog. Message flags 7 and 8 are
not supported in SuperVision v3.0 or Alert v3.0 but, in previous versions, should be used to send a trend report or status report. Table 7-1. Reserved message flags
Flag number 1 6 7 8 Reserved for Runtime Expired FB error Daily Trend Report Daily Status Report
Microblock
In this example, message flag 2 has been enabled. When message flag 2 is activated in the GFB, the message report displays the text represented by the number 15 in the xxxalarm.txt or sysalarm.txt files. If both the xxxalarm.txt or sysalarm.txt files contain the same
number (for example, they each contained different text for number 15), the information in the xxxalarm.txt file is displayed. Table 7-1 on page 165 shows which message flags are reserved. Message flag 1 is reserved for an expired runtime message; use this flag with this microblock if possible. Message flags 6, 7, and 8 cannot be set on the microblock dialog.
Runtime Monitor
Runtime Monitor
The Runtime Monitor microblock monitors the amount of time that a piece of equipment has been running and provides an alarm output that can be used to trigger the Alert Alarm microblock when the specified runtime limit is exceeded. The microblock tracks the amount of time that its input remains on. When the limit (set either on the microblock dialog or using the limit parameter on the Parameter page) is reached, the microblocks output is turned on. This output may be wired to an Alert microblock to generate a runtime exceeded alarm. Refer to the section Alert Event on page 170 for more information about the Alert microblock. The Status page shows the number of hours of runtime accumulated since the time the microblocks input was turned on and also shows the time at which the microblock began counting. If the clear parameter on the Parameter page is set to yes or if the microblocks input changes to off, the number of hours of accumulated runtime is reset to zero. The accumulated runtime value monitored by the this microblock is stored in the modules non-volatile memory, so that if power is lost this value is retained. In modules containing Exec 3.x or Exec 4.x, the runtime value is stored once every hour.
NOTE This microblock can only be displayed in SuperVision for Windows version 2.5b or later.
Microblock
Runtime Monitor
Alert Event
Alert Event
The Alert Event microblock is used to transmit alarms and supplemental data from the GFB to the Alert event management system. An event generated by this microblock is time-stamped with the time the event was generated. Alert microblocks tell Alert: what event has occurred (according to the event ID) whether the event requires a return to normal conditions before it can be closed whether the event is critical what additional information from the GFB is available to Alert
Microblock
This information can be specified on the microblock dialog or on the Parameter page. In order for Alert to receive an event, the Enable event setting (Enable on the Parameter page) must be set to yes. Event IDs The event ID is an eight-character name that identifies the event for Alert. Alert knows what information to display and what actions are applicable to an event based on its ID. Event IDs can be made up of uppercase letters, numbers, and any symbol on the keyboard. Certain default event IDs are reserved for special uses; Table 7-2 on page 171 lists these special IDs and their uses.
NOTE Events with an ID of STATUS are not supported by Alert version 3.0 or later. Events with this ID are supported by Alert versions 1.2a and
Alert Event
below, but these events record the date and time the event was received, instead of the date and time the event occurred.
A1 ALERTERR
DEFAULT
GATEWAY
Return to normal If you want to require that an event return to normal before it can be closed, set Return to normal required to yes (on the Parameter page, the RTN reqd parameter). If an event does not require a return to normal
Alert Event
before closing, then the event is closed as soon as it has been acknowledged and its reporting actions are complete. Critical events The difference between a critical and a non-critical event is the amount of time that might pass before Alert is notified of an events occurrence. Critical events are sent to Alert as soon as they occur in the module. To identify an event as a critical event, set Is this a critical event to yes on the microblock dialog (the Critical parameter on the Parameter page). If you are monitoring your system through a modem connection, noncritical events are stored in the gateway until a critical event occurs, the gateway is contacted by SuperVision, or the gateway buffer is full, at which time all the events are sent to Alert. If you monitor the system through a direct or network connection, Alert collects non-critical events from the gateway at predetermined intervals. These intervals are determined when the connection is configured in SuperVision; refer to the SuperVision Configuration Guide for details. Time inputs You have the option of overriding an events time and date of generation with other time and date inputs from the GFB. Normally the Alert microblock records the time and date the event occurred. This is the time and date that is shown in the event report in Alert. By enabling the microblocks time inputs, you can specify a different time and date you want recorded for the event.
NOTE Since these inputs will override the time and date the event actually occurred, the enable TIME inputs setting should normally be set to no.
Simulation The Simulation section of the microblock dialog is used to test the event during Eikon simulation. When using simulation to test the event, make sure Enable event is also set to yes. The Test event setting (Test on the Parameter page) must be set to no during normal operation for Alert to receive and handle events properly.
Alert Event
Optional inputs In addition to the specific event information, the Alert microblock can record up to five other values from the GFB at the time the event is generated. These values are recorded using the Alert microblocks optional inputs. To use these inputs, first you must define a name for the input and the inputs type (analog or digital) on the Alert microblocks dialog. The microblock will then show the additional inputs which can then be wired to receive the appropriate information from other parts of the GFB. In order for information from these inputs to be displayed in Alerts event report, you must configure the event in Alert so that the information will appear. Refer to the Alert Configuration Guide for details. Figure 7-7 shows an example of how you could use an Alert microblock to generate an event in a GFB.
Alert Event
History Recorder
History Recorder
The History Recorder microblock records a current and previous value from a microblock in a GFB. You determine when the value is recorded. The Status page shows the current and previous values (Current cycle and Previous cycle), and the time of day and the date when the recordings were made. The microblocks analog input receives the value that is to be recorded. When the rec input is on, the microblock transfers the current value of its input to its primary output, and the prior output value is transferred to the prev output. The value is recorded only once while the rec input is on. For example, if the microblock is used to record the zone temperature, and the rec input remains on while the temperature changes, only the temperature that was current at the time the rec input turned on will be recorded.
Microblock
Microblock
Microblock
Runtime Accumulation
Runtime Accumulation
The Runtime Accumulation microblock calculates the amount of time in hours that a piece of equipment has been running. This microblock records the amount of time its primary digital input is on. You can reset the microblocks value when you choose by using the microblocks clr input. The Preset runtime value parameter on the Parameter page allows you to define the number of hours which the microblock begins to count from. For example, if Preset runtime value is set to 5, the Runtime Accumulation microblock begins counting runtime hours at 5. The Latch in preset value now parameter resets the microblocks value to the value indicated by the Preset runtime value setting. The Simulation section of the microblocks dialog allows you to determine whether a preset runtime value will be used in simulation, and what that value should be. For more information about using Eikon simulation, refer to the section Testing the FB of the Eikon Users Guide.
Microblock
Runtime Accumulation
Runtime Accumulation
8 Control Microblocks
The Control microblocks output signals that are used mainly for control and scheduling purposes. Many of these microblocks generate colors, which are used by SuperVision to communicate the status of the Graphic Function Block (GFB). You should use a Zone Setpoint, Set Color, or Set Color If True microblock (but not a combination of these) in every GFB. Since each GFB can broadcast only one color, there cannot be more than one Zone Setpoint or Set Color microblock in a GFB. You can use more than one Set Color If True microblock; however, only one Set Color If True microblock can display its color at any given time. The Zone Setpoint microblocks use an optimal start routine to control equipment. If you plan to use a Zone Setpoint microblock, be sure to read the section Optimal Start on page 185.
NOTE Zone Setpoint microblocks can only be used with Exec 6.00g and newer modules.
Zone Setpoint with Demand and Learning Adaptive Optimal Start 208
Zone Setpoint - Plus with Learning Adaptive Optimal Start 213 Setpoint Optimization Set Color 222 Set Color If True 223 220
227
Optimal Start
Optimal Start
All Zone Setpoint microblocks provide an optimal start routine that allows equipment to begin heating or cooling a zone before occupancy begins. This way, zone temperatures can reach the ideal comfort range at the time occupancy begins. Optimal start works by calculating setpoints during the unoccupied period that are gradually adjusted toward the occupied setpoints. The adjusted setpoints and their rate of change are calculated using the following information: Occupancy mode (occupied/unoccupied) - received from the occ input Time remaining in current mode - received from the for input Current zone temperature - received from the zone input Current electrical demand level - received from the dem input (not available on all Zone Setpoint microblocks) Current outside air temperature - received from the modules firmware Heating/cooling capacity of the zone in question - entered on the microblocks dialog or the Parameter page
Once optimal start begins, the GFBs color changes from gray (unoccupied) to the appropriate color according to the occupied color band on the setpoint graph. As the optimal start routine continues to adjust the unoccupied setpoints toward the occupied setpoints, the zone temperature changes with it, ideally reaching the desired range by the time occupancy begins. Depending on which Zone Setpoint microblock you are using, it may be possible to prevent heating and cooling setpoints from being adjusted due to optimal start. Refer to the individual microblock descriptions for details. The rate at which the setpoints are adjusted relates directly to the heating and cooling capacities of the equipment. The optimal start routine calculates the actual heating or cooling capacity of the
Optimal Start
equipment at the current outside air temperature using the following formulas.
Use the following formulas for Exec 6.00g and later modules.
Optimal Start
Use the following formula for versions earlier than Exec 6.00g.
Actual Capacity =
X Capacity at 65F
Optimal Start
Actual Capacity =
X Learned Capacity
Because learning adaptive optimal start uses learned capacities, the optimal start calculations are more accurate and equipment is controlled more efficiently. The current learned capacities are displayed on the Status page and are available to other parts of the GFB from the microblocks HCAP and CCAP outputs. Following is an example of how learning adaptive optimal start works: Example The heating capacity for the zone is 5 degrees per hour. When the zone becomes occupied, the zone temperature is 1 degree below the occupied setpoint, indicating a need for additional heat. Since the zone temperature was low by 1 degree, the heating capacity will be decreased by the light blue Learning Adaptive Optimal Start value (1 degree below setpoint is in the light blue region). If the light blue Learning Adaptive Optimal Start value is 0.06, the heating capacity will be adjusted to 4.94 for the next optimal start
Optimal Start
period. This causes the setpoint adjustment to begin sooner in the next unoccupied period. Enter the Learning Adaptive Optimal Start values on the microblocks dialog or on the Parameter page. In heating mode, the microblock subtracts the adjustment value from the heating capacity. In cooling mode, the microblock adds the adjustment value to the cooling capacity. The learning adaptive optimal start routine will not adjust the learned heating or cooling capacities lower than .0625 or higher than 15.938 degrees per hour. If you are using learning adaptive optimal start, be aware that learned capacities can be distorted during override periods. For this reason, you should prevent learned capacities from being adjusted during override periods by using the microblocks LRNI input. When this input is turned on, learning adaptive optimal start will still occur, but the learned heating and cooling capacities will not be changed from the previous unoccupied periods values. Also, make sure that all other control sequences in the GFB, including PID loops, are tuned and functioning properly before using the learning adaptive optimal start microblocks. Otherwise, setpoints could be improperly adjusted.
Zone Setpoint
Zone Setpoint
The Zone Setpoint microblock is used to calculate effective setpoints and zone colors for GFBs controlling single zone equipment. You can determine a zones setpoints for both occupied and unoccupied periods; however, because of factors such as local overrides or optimal start routines, the zones effective setpoints may be calculated differently by the microblock. The color generated by the microblock represents the status of the GFB to SuperVision and can be used by other microblocks in the GFB (such as the True if Color = microblock) to perform additional control.
NOTE Do not use the Zone Setpoint microblock in combination with the Set Color or Set Color If True microblocks in the same GFB. There cannot be more than one Zone Setpoint microblock in a GFB.
Microblock
The microblocks occ and for inputs provide information used during adaptive optimal start (see the section Optimal Start on page 185). The occ input indicates whether or not the zone is currently occupied, and the for input indicates the amount of time remaining until the occupancy status changes. Occupancy is normally determined by a Scheduler or Scheduler with Override microblock. If some other method is used to determine occupancy, attach a Binary Status microblock to the wire that leads into the Zone Setpoints occ input. This status microblock should be given an MbCode of MOCC. This will enable SuperVision to display the correct occupancy on the setpoint graph. The zone input receives the current zone temperature. The color broadcast by the microblock is based on the zone temperature in relation to the effective setpoints. The ht and cl outputs on the microblock contain the effective heating and cooling setpoints, respectively. If the zone is occupied, the effective setpoints are the same as those defined on the microblock dialog, the Parameter page, or the setpoint graph. If the zone is currently unoccupied, the microblock calculates effective setpoints for an adaptive optimal start routine (see the section Optimal Start on page 185).
Zone Setpoint
Zone Setpoint
is 65F. The accuracy of these values affects the ability of the equipment to bring the zone temperature to the occupied setpoint exactly at occupancy time, rather than too early or too late. On the Parameter page, use the Heating Capacity and Cooling Capacity settings to change these values. On the microblock dialog, the settings on the colored bands determine the width (in degrees) of the colored bands on the setpoint graph in SuperVision. Actual occupied and unoccupied setpoint values can be entered in the heating setpt and cooling setpt fields beneath the graph on the microblock dialog, or using the Heating and Cooling settings on the Parameter page. On the Parameter page, the Bands settings determine the width of the color bands on the setpoint graph. The Free setting determines the width of the speckled green band (which allows free cooling from the outside air dampers when appropriate). If free cooling is not available, this parameter should be set to 0.00. The Stage 1 setting determines the width of the yellow band for cooling and the light blue band for heating, and the Stage 2 setting determines the width of the orange band for cooling and the dark blue band for heating. The Color Change Hysteresis is represented by the Hyst setting on the Parameter page. When returning to normal, it is the number of degrees required to exceed the setpoint before the microblocks color changes. An appropriate hysteresis prevents equipment from "chattering" when the temperature is very close to and oscillating around the setpoint.
Zone Setpoint
Microblock
The microblocks occ, for, and dem inputs provide information used during adaptive optimal start (see the section Optimal Start on page 185). The dem input indicates the current electrical demand level (obtained from a Get Electrical Demand Level or LAN Input microblock). The occ input indicates whether or not the zone is currently occupied, and the for input indicates the amount of time remaining until the occupancy status changes. Occupancy is normally determined by a Scheduler or Scheduler with Override microblock. If some other method is used to determine occupancy, attach a Binary Status microblock to the wire that leads into the Zone Setpoints occ input. This status microblock should be given an MbCode of MOCC. This enables SuperVision to display the correct occupancy on the setpoint graph. The zone input receives the current zone temperature. The color broadcast by the microblock is based on the zone temperature in relation to the effective setpoints. The ht and cl outputs on the microblock contain the effective heating and cooling setpoints, respectively.
page, use the Heating Design Temp and Cooling Design Temp settings to change these values. The Capacity section of the microblock dialog indicates the maximum rate (in degrees F per hour) at which the heating and cooling equipment can change the temperature if the outside air temperature is 65F. The accuracy of these values affects the ability of the equipment to bring the zone temperature to the occupied setpoint exactly at occupancy time, rather than too early or too late. On the Parameter page, use the Heating Capacity and Cooling Capacity settings to change these values. On the microblock dialog, the settings on the colored bands determine the width (in degrees) of the colored bands on the setpoint graph in SuperVision for each level of electrical demand (0, 1, 2, or 3). The occupied band represents demand level zero. For each increase in the level of demand, you can offset the width of the color bands on the setpoint graph by the number of degrees indicated on the appropriate band. Actual occupied and unoccupied setpoint values can be entered in the heating setpt and cooling setpt fields beneath the graph (the Heating and Cooling settings on the Parameter page). When the zone is occupied, these values, adjusted for demand level, are the effective setpoints. When the zone is unoccupied, the microblock calculates effective setpoints using the adaptive optimal start routine (see the section Optimal Start on page 185). For example, Figure 8-6 shows the dem1 bands cooling offset is 1.00, and the occupied cooling setpoint is 76.00. When the building is occupied and operating under demand level 1, the effective cooling setpoint is then 77.00. This effective setpoint is further adjusted by the value of the microblocks cadj input. This strategy allows the total building demand to be lowered, often without shutting off any equipment. On the Parameter page, the Bands settings determine the width of the color bands on the setpoint graph. The Free setting determines the width of the speckled green band (which allows free cooling from the outside air dampers when appropriate). If free cooling is not available, this parameter should be set to 0.00. The Stg1 setting determines the width of the yellow band for cooling and the light blue
band for heating, and the Stg2 setting determines the width of the orange band for cooling and the dark blue band for heating. These settings for Free, Stg1 and Stg2 are used when the demand level is zero. The Offset settings allow you to enter an amount (in degrees) by which the Free, Stg1, and Stg2 settings will be adjusted for each level of demand. The Color Change Hysteresis is represented by the Hyst setting on the Parameter page. When returning to normal, it is the number of degrees required to exceed the setpoint before the microblocks color changes. An appropriate hysteresis prevents equipment from "chattering" when the temperature is very close to and oscillating around the setpoint.
Remote setpoint adjustment (the hadj and cadj inputs on the microblock) Optimal start inhibit (the hosi and cosi inputs on the microblock) Night setback mode notification (the ns output on the microblock). This output turns on when the zone is unoccupied, optimal start is not in progress, and the unoccupied heating or cooling setpoint has been exceeded
You can determine a zones setpoints for both occupied and unoccupied periods; however, because of factors such as local overrides, demand level, setpoint adjustments, or optimal start routines, the zones effective setpoints may be calculated differently by the microblock. The color generated by the microblock represents the status of the GFB to SuperVision and can be used by other microblocks in the GFB (such as the True if Color = microblock) to perform additional control.
NOTE Do not use the Zone Setpoint with Demand microblock in combination with the Set Color or Set Color If True microblocks in the same GFB. There cannot be more than one Zone Setpoint microblock in a GFB.
The following table describes the microblocks inputs and outputs. Table 8-1. Zone Setpoint - Plus microblock inputs and outputs
Input or Output Description Digital input - indicates whether or not the zone is currently occupied Analog input - indicates how long the zone will remain in its current state of occupancy Analog input - current zone temperature Analog input - current electrical demand level. This is normally received from a Get Electrical Demand Level or LAN Input microblock and should be a value of 0, 1, 2, or 3 Analog input - the amount (in degrees) by which the heating setpoint should be adjusted Analog input - the amount (in degrees) by which the cooling setpoint should be adjusted Digital input - indicates whether or not the heating setpoint will be affected by adaptive optimal start Digital input - indicates whether or not the cooling setpoint will be affected by adaptive optimal start Analog output - the color representing the zones temperature in relation to the zones effective setpoints Analog output - the zones effective heating setpoint Analog output - the zones effective cooling setpoint Digital output - indicates whether or not the zone is in night setback mode
Occupancy is normally determined by a Scheduler or Scheduler with Override microblock. If some other method is used to determine occupancy, attach a Binary Status microblock to the wire that leads into the Zone Setpoints occ input. This status microblock should be
given an MbCode of MOCC. This will enable SuperVision to display the correct occupancy on the setpoint graph.
On the microblock dialog, the settings on the colored bands determine the width (in degrees) of the colored bands on the setpoint graph in SuperVision for each level of electrical demand (0, 1, 2, or 3). The occupied band represents demand level zero. For each increase in the level of demand, you can offset the width of the color bands on the setpoint graph by the number of degrees indicated on the appropriate band. Actual occupied and unoccupied setpoint values can be entered in the heating setpt and cooling setpt fields beneath the graph (the Heating and Cooling settings on the Parameter page). When the zone is occupied, these values, adjusted for demand level and additional inputs (the hadj and cadj inputs on the microblock), are the effective setpoints. When the zone is unoccupied, the microblock calculates effective setpoints using the adaptive optimal start routine (see the section Optimal Start on page 185).
For example, Figure 8-6 shows the dem1 bands cooling offset is 1.00, and the occupied cooling setpoint is 76.00. When the building is occupied and operating under demand level 1, the effective cooling setpoint is then 77.00. This effective setpoint is further adjusted by the value of the microblocks cadj input. This strategy allows the total building demand to be lowered, often without shutting off any equipment. On the Parameter page, the Bands settings determine the width of the color bands on the setpoint graph. The Free setting determines the width of the speckled green band (which allows free cooling from the outside air dampers when appropriate). If free cooling is not available, this parameter should be set to 0.00. The Stg1 setting determines the width of the yellow band for cooling and the light blue band for heating, and the Stg2 setting determines the width of the orange band for cooling and the dark blue band for heating. These settings for Free, Stg1 and Stg2 are used when the demand level is zero. The Offset settings allow you to enter an amount (in degrees) by which the Free, Stg1, and Stg2 settings will be adjusted for each level of demand. The Color Change Hysteresis is represented by the Hyst setting on the Parameter page. When returning to normal, it is the number of degrees required to exceed the setpoint before the microblocks color changes. The hysteresis prevents equipment from "chattering" when the temperature is oscillating around the setpoint.
Microblock
NOTE Do not use the Zone Setpoint with Learning Adaptive Optimal Start microblock in combination with the Set Color or Set Color If True microblocks in the same GFB. There cannot be more than one Zone Setpoint microblock in a GFB.
Figure 8-7: Using the Zone Setpoint with Learning Adaptive Optimal Start microblock
The Learning Adaptive Optimal Start settings determine the amount by which the heating or cooling capacities are adjusted, depending on the zones color when occupancy begins. A different value may be entered for each color. Note that two values may be entered for the color green: one for heating mode (the left-hand value) and one for cooling mode (the right-hand value).
Figure 8-8: Zone Setpoint with Learning Adaptive Optimal Start microblock dialog
On the microblock dialog, the settings on the colored bands determine the width (in degrees) of the colored bands on the setpoint graph in SuperVision. Actual occupied and unoccupied setpoint values can be entered in the heating setpt and cooling setpt fields beneath the graph on the microblock dialog, or using the Heating and Cooling settings on the Parameter page. On the Parameter page, the Bands settings determine the width of the color bands on the setpoint graph. The Free setting determines the width of the speckled green band (which allows free cooling from the outside air dampers when appropriate). If free cooling is not available, this parameter should be set to 0.00. The Stage 1 setting determines the width of the yellow band for cooling and the light blue
band for heating, and the Stage 2 setting determines the width of the orange band for cooling and the dark blue band for heating. The Color Change Hysteresis is represented by the Hyst setting on the Parameter page. When returning to normal, it is the number of degrees required to exceed the setpoint before the microblocks color changes. An appropriate hysteresis prevents equipment from "chattering" when the temperature is very close to and oscillating around the setpoint.
Microblock
NOTE Do not use the Zone Setpoint with Learning Adaptive Optimal Start microblock in combination with the Set Color or Set Color If True microblocks in the same GFB. There cannot be more than one Zone Setpoint microblock in a GFB.
Figure 8-9: Using the Zone Setpoint with Demand and Learning Adaptive Optimal Start microblock
Zone Setpoint with Demand and Learning Adaptive Optimal Start parameters
The Design Temp section of the microblock dialog indicates the extreme outside temperatures at which equipment must run constantly in order to maintain comfort. Design temperatures are based on the geographic area of the building and are available from ASHRAE publications and most design references. On the Parameter page, use the Heating Design Temp and Cooling Design Temp settings to change these values. The Capacity section of the microblock dialog indicates the maximum rate (in degrees F per hour) at which the heating and cooling equipment can change the temperature if the outside air temperature is 65F. On the Parameter page, use the Heating Capacity and Cooling Capacity settings to change these values. The actual heating and cooling capacities used to calculate optimal start may vary because of the way learning adaptive optimal start is performed. Refer to the section Learning adaptive optimal start on page 187. If the heating and cooling capacity parameters are changed and transferred to the module, the learned heating and cooling capacities will change to the new values. If the capacities are not changed but other parameters from the GFB are transferred to the module, the learned capacities will not be affected.
The Learning Adaptive Optimal Start settings determine the amount by which the heating or cooling capacities are adjusted, depending on the zones color when occupancy begins. A different value may be entered for each color. Note that two values may be entered for the color green: one for heating mode (the left-hand value) and one for cooling mode (the right-hand value).
.
Figure 8-10: Zone Setpoint with Demand and Learning Adaptive Optimal Start microblock dialog
On the microblock dialog, the settings on the colored bands determine the width (in degrees) of the colored bands on the setpoint graph in SuperVision for each level of electrical demand (0, 1, 2, or 3). The occupied band represents demand level zero. For each increase in the level of demand, you can offset the width of the color bands on the setpoint graph by the number of degrees indicated on the appropriate band.
Actual occupied and unoccupied setpoint values can be entered in the heating setpt and cooling setpt fields beneath the graph (the Heating and Cooling settings on the Parameter page). When the zone is occupied, these values, adjusted for demand level, are the effective setpoints. When the zone is unoccupied, the microblock calculates effective setpoints using the learning adaptive optimal start routine (see the section Optimal Start on page 185). For example, Figure 8-10 shows the dem1 bands cooling offset is 1.00, and the occupied cooling setpoint is 76.00. When the building is occupied and operating under demand level 1, the effective cooling setpoint is then 77.00. This effective setpoint is further adjusted by the value of the microblocks cadj input. This strategy allows the total building demand to be lowered, often without shutting off any equipment. On the Parameter page, the Bands settings determine the width of the color bands on the setpoint graph. The Free setting determines the width of the speckled green band (which allows free cooling from the outside air dampers when appropriate). If free cooling is not available, this parameter should be set to 0.00. The Stg1 setting determines the width of the yellow band for cooling and the light blue band for heating, and the Stg2 setting determines the width of the orange band for cooling and the dark blue band for heating. These settings for Free, Stg1 and Stg2 are used when the demand level is zero. The Offset settings allow you to enter an amount (in degrees) by which the Free, Stg1, and Stg2 settings will be adjusted for each level of demand. The Color Change Hysteresis is represented by the Hyst setting on the Parameter page. When returning to normal, it is the number of degrees required to exceed the setpoint before the microblocks color changes. An appropriate hysteresis prevents equipment from "chattering" when the temperature is very close to and oscillating around the setpoint.
Cooling Capacity ____ (deg/hr) Cooling Design Temp _____ Learning Adaptive Optimal Start: Upon transitioning from Unoccupied to Occupied, apply these values: Red | DkBlue | LtBlue | Green or SpGrn | Yellow | Orange | Red _____ _____ _____ _____ _____ _____ _____ _____
Microblock
NOTE Do not use the Zone Setpoint with Learning Adaptive Optimal Start microblock in combination with the Set Color or Set Color If True microblocks in the same GFB. There cannot be more than one Zone Setpoint microblock in a GFB.
The following table describes the microblocks inputs and outputs. Table 8-2. Zone Setpoint - Plus with Learning Adaptive Optimal Start microblock inputs and outputs
Input or Output Description Digital input - indicates whether or not the zone is currently occupied Analog input - indicates how long the zone will remain in its current state of occupancy
OCC FOR
Table 8-2. Zone Setpoint - Plus with Learning Adaptive Optimal Start microblock inputs and outputs (Continued)
Input or Output Description Analog input - current zone temperature Analog input - current electrical demand level. This is normally received from a Get Electrical Demand Level or LAN Input microblock and should be a value of 0, 1, 2, or 3 Analog input - the amount (in degrees) by which the heating setpoint should be adjusted. Analog input - the amount (in degrees) by which the cooling setpoint should be adjusted Digital input - indicates whether or not the heating setpoint will be affected by adaptive optimal start Digital input - indicates whether or not the cooling setpoint will be affected by adaptive optimal start Analog input - the percentage by which the learned heating capacity should be adjusted Analog input - the percentage by which the learned cooling capacity should be adjusted Digital input - indicates whether or not learned heating and cooling capacities will be calculated for optimal start Analog output - the color representing the zones temperature in relation to the zones effective setpoints Analog output - the zones effective heating setpoint Analog output - the zones effective cooling setpoint Digital output - indicates whether or not the zone is in night setback mode Analog output - the learned heating capacity Analog output - the learned cooling capacity
ZONE DEM
HADJ CADJ HOSI COSI HCAP% CCAP% LRNI COLOR HT CL NS HCAP CCAP
Figure 8-11: Using the Zone Setpoint - Plus with Learning Adaptive Optimal Start microblock
Figure 8-12: Zone Setpoint - Plus with Learning Adaptive Optimal Start microblock dialog
the cooling setpoint is 76.00. When the building is operating under demand level 1, the effective cooling setpoint will then be 77.00. This strategy allows the total building demand to be lowered often without shutting off any equipment. On the Parameter page, the Bands settings determine the width of the color bands on the setpoint graph. The Free setting determines the width of the speckled green band (which allows free cooling from the outside air dampers when appropriate). If free cooling is not available, this parameter should be set to 0.00. The Stg1 setting determines the width of the yellow band for cooling and the light blue band for heating, and the Stg2 setting determines the width of the orange band for cooling and the dark blue band for heating. These settings for Free, Stg1 and Stg2 are used when the demand level is zero. The Offset settings allow you to enter an amount (in degrees) by which the Free, Stg1, and Stg2 settings will be adjusted for each level of demand. The Color Change Hysteresis is represented by the Hyst setting on the Parameter page. When returning to normal, it is the number of degrees required to exceed the setpoint before the microblocks color changes. An appropriate hysteresis prevents equipment from "chattering" when the temperature is very close to and oscillating around the setpoint.
Setpoint Optimization
Setpoint Optimization
The Setpoint Optimization microblock calculates a setpoint for the equipment controlled by the GFB based on the number of heating or cooling requests received by the equipment. You can determine a maximum and minimum temperature that the setpoint will not exceed, and you can determine when and how often the setpoint is calculated. This type of control allows you to efficiently meet the buildings requirements by calculating the setpoint according to the amount of heating or cooling that is needed. The microblocks req input accepts the number of requests received by the GFB (usually from a Receive Requests microblock). Setpoint calculations are only performed when the microblocks go input receives an on signal. If this inputs value is off, then the setpoint will remain at the initial value and will not be adjusted. The Initial Setpoints section of the microblock dialog determines the starting setpoint for the equipment and the minimum and maximum allowable setpoints. The microblock determines the setpoint with a "trim and respond" calculation using the settings in the following statement: Every _____ mins, Trim by ____ and Respond by ____ but no more than ____. For cooling, you should use a positive Trim by value and a negative value for the Respond by and but no more than parameters. For heating, you should use a negative value for Trim by and a positive value for the Respond by and but no more than parameters. Setpoints are calculated using the following formula:
New Setpoint = Previous Setpoint + trim by + ( respond by number of requests )
Microblock
Example 1 The initial setpoint for a VAV air handler (which is the source of cold air for a number of VAV boxes) is 60 degrees, with a minimum of 55 degrees and a maximum of 65 degrees. The trim and respond parameters are set as follows: Every 2.0 mins, Trim by 0.25 and Respond by -0.50 but no more than -3.0. If the current setpoint is 57 degrees, and 4 requests are received, the new setpoint would be 55.25 degrees (57 degrees + .25 trim + (-.50 x 4) respond).
Setpoint Optimization
Example 2 The same VAV air handler later receives seven cooling requests. The trim and respond parameters are set as follows: Every 2.0 mins, Trim by 0.25 and Respond by -0.50 but no more than -3.0. If the current setpoint is 55.25 degrees, the new setpoint would be 52.5 degrees (57 degrees +.25 trim + (-3.0) respond). Because the number of requests (7) multiplied by the Respond by value (-.50) is greater than the no more than value, the no more than value is used in the calculation instead.
Set Color
Set Color
The Set Color microblock defines a color (white, gray, or red) for a GFB that does not use a Zone Setpoint or Set Color If True microblock. This microblock is used so the GFB displays a color in SuperVision indicating its status. For example, this microblock can be used to generate a color for a piece of equipment depending on its status: white if the equipment is running, gray if the equipment is not running and red if an alarm condition exists for the equipment.
NOTE Do not use the Set Color microblock in combination with any Zone Setpoint or Set Color If True microblocks in the same GFB. There cannot be more than one Set Color microblock in a GFB.
Microblock
When the microblocks alrm input receives an on signal, the GFBs broadcast color is red, regardless of the value of the run input. When the alrm input is off and the run input is on, the GFBs broadcast color is white. If both inputs are off, the GFBs broadcast color is gray.
Microblock
True If Color =
True If Color =
The True If Color = microblock allows you to define control sequences based on the GFBs current color. This microblock accepts a color value from a Zone Setpoint or Set Color microblock. If the color matches one of the colors selected for the microblock (from the microblock dialog), the microblocks output is turned on. For example, this microblock can be used to create a signal that turns an Alert microblock on when the GFBs color is either red or orange.
Microblock
On the microblock dialog, click the button or buttons representing the color or colors that will turn the microblocks output on. On the Parameter page, indicate the desired color or colors by changing the appropriate dash to an X. The dashes represent the colors in the order indicated by the letters (rdlggyor): red (heat alarm), dark blue, light blue, green, speckled green, yellow, orange, and red (cooling alarm). The dashes represented by the letters (gw) stand for the colors gray and white.
True If Color =
Scheduler
Scheduler
The Scheduler microblock reads schedules from SuperVision and generates signals to tell the GFB whether or not the zone is occupied, and how long the zone will remain in its current state of occupancy. The microblock has two outputs: the occ output, which indicates whether the zone is currently occupied (on) or unoccupied (off); and the timer output, which indicates the number of minutes remaining until the occupancy changes. The value of these outputs depends on the schedule entered for the GFB in SuperVision. To enter or view schedules, use SuperVisions Schedule feature. Refer to the SuperVision Users Guide for details. The microblock dialog allows you to set values that the microblock can use during simulation. You cannot set schedules using the microblocks dialog. For more information about simulating a GFB, refer to the Eikon Users Guide. The Status page shows the current occupancy status of the zone and the time when the occupancy is scheduled to change.
NOTE Only one Scheduler or Scheduler with Override microblock can be used per GFB. Otherwise, Eikon will not complete the Make FB process successfully.
Microblock
Microblock
9 Convert Microblocks
The Convert menu microblocks take information from other microblocks, change it in some way, and then output the modified data. These microblocks should be placed in the middle of the GFB between the Inputs and Outputs. The following microblocks are available in the Convert menu:
Zone Controller
231
234
238
Linear Converter
242
Enthalpy Calculator
244
Dewpoint Temperature Calculator 246 Wet Bulb Temperature Calculator 247 True If = Constant True If > Constant 248 249
250
True If = Variable 251 True If > Variable Input 252 True If Input < Variable Input 253 Analog to Digital Converter Digital to Analog Converter 254 255
Zone Controller
Zone Controller
The Zone Controller microblock is designed to provide stable temperature control of a single-zone heating and cooling system using two modified PID control loops. The two PID loops (a direct acting loop for the cooling output and a reverse acting loop for the heating output) are non-linear. This allows for fine-tuning corrections when the system is near setpoint and larger corrections when the setpoint or the load changes and the system needs to adjust quickly. To use this microblock, be sure to select Exec 6.x from the Option menu on the menu bar. For more information about PID loops, see the Technical Handbook. The Zone Controller microblock is supported by Exec 6.01 (or later) and is well-suited for controlling a VAV box when used with an Airflow microblock; refer to the section Airflow Control on page 99. The OCC input on the Zone Controller microblock is the occupied or unoccupied status (on means occupied). This information comes from a Scheduler microblock and any additional logic, such as a timed local override switch, used to determine occupancy status. The FOR input is the amount of time, in minutes, remaining in the current OCC status. This information comes from a Scheduler microblock and any additional logic which affects this value. The ZONE input is the zone temperature in degrees. The CLSP input is the cooling setpoint in degrees. The HTSP is the heating setpoint in degrees.
NOTE The units for ZONE, CLSP, and HTSP are dependent on the Metric setting on the Options-Edit Options dialog box. If the Metric option is set to yes, all temperatures are expressed in Celsius. Otherwise, Fahrenheit is used.
Microblock
The outputs on the Zone Controller are used to control the cooling and heating systems through an output microblock, such as the Airflow microblock. The output can also be used to trigger I need cool/heat requests back to the air handler unit.
Zone Controller
Zone Controller
Microblock
The Gain section of the microblock dialog indicates the values used by the PID microblock to calculate each portion of the PID routine. Proper adjustment of these values results in the most efficient use of the equipment. Automated Logic Corporation provides tools to assist you in tuning PID loops. These tools are available in the ALC File Library, which can be accessed at http://www.automatedlogic.com/techsupport. The Proportional gain (P-gain) value is used to calculate the proportional component of the routine. This component increases in direct proportion to the difference between the setpoint and the current temperature. If you define only the P-gain portion of the PID microblock, the microblocks output value could cause the temperature to oscillate around the setpoint or possibly to never reach the setpoint (if the P-gain is too low). The proportional value is calculated using the following formula:
P = ( Input Setpoint ) P-gain
For example, if the P-gain is 20, the setpoint is 65, and the current temperature is 67, the proportional value is 40. The value of the proportional component (p) appears on the Status page.
The Integral gain (I-gain) value is used to calculate the integral component of the PID routine. The integral value accounts for the amount of time that the temperature and the setpoint have been different. The longer that the temperature and setpoint are different, the larger the integral value becomes. The integral value is calculated as follows:
I = Previous I value + [ ( Input Setpoint ) I-gain ]
For example, if the I-gain is 2, the setpoint is 65, and the current temperature is 67, the integral value for the first interval will be 4. If at the end of the second interval the temperature is still 67, the integral value will increase to 8. The Derivative gain (D-gain) value attempts to control the rate at which the temperature is brought to setpoint in order to prevent the setpoint from being exceeded. This value uses information from the current and previous intervals and is calculated using the following formula:
D = [ ( Input Setpoint ) current ( Input Setpoint )previous ] D-gain
For example, if the D-gain is 3, the setpoint is 65, and the current temperature is 67, the derivative value for the first interval is 6 ([2 - 0] x 3 = 6). If at the end of the second interval the temperature is still 67, the derivative value will decrease to 0 ([2 - 2] x 3 = 0). The microblocks output percentage uses all three components as follows:
Output (%) = Bias + P + I + D
The Bias is set on the microblock dialog or the Parameter page. Using the examples listed for each component above, and assuming a bias value of 0, the output value of the PID microblock for the first interval would be 50; for the second interval the value would be 48. The Loop section of the microblock dialog contains settings that affect the overall operation of the microblock. The Bias value is added to the proportional, integral, and derivative values calculated by the microblock to create the final output value. The bias can be viewed as a starting point for the calculation or as an offset to the final value.
When the go input is off, the microblocks output defaults to the Bias value. The Interval setting indicates how often the microblock calculates its output value. When the microblocks go input is on, the output value is calculated only once each interval. The Hold I error setting, when enabled, retains the last calculated integral value when the microblocks go input is off. You can edit the Parameter screen prompt text on the microblock dialog to provide a meaningful description of the microblocks use on the Parameter page.
NOTE Because this microblock has been updated to avoid integral error problems, PID microblocks which were inserted into GFBs prior to Eikon 2.0 should be deleted and reinserted using Eikon 2.0 or later.
Microblock
The Gain section of the microblock dialog indicates the values used by the PID microblock to calculate each portion of the PID routine. Proper adjustment of these values results in the most efficient use of the equipment. Automated Logic Corporation provides tools to assist you in tuning PID loops. These tools are available in the ALC File Library, which can be accessed at http://www.automatedlogic.com/techsupport. The Proportional gain (P-gain) value is used to calculate the proportional component of the routine. This component increases in direct proportion to the difference between the setpoint and the current temperature. If you define only the P-gain portion of the PID microblock, the microblocks output value could cause the temperature to oscillate around the setpoint or possibly to never reach the setpoint (if the P-gain is too low). The proportional value is calculated using the following formula:
P = ( Input Setpoint ) P-gain
For example, if the P-gain is 20, the setpoint is 65, and the current temperature is 63, the proportional value is -40. The value of the proportional component (p) appears on the Status page.
The I-gain value is used to calculate the integral component of the PID routine. The integral value accounts for the amount of time that the temperature and the setpoint have been different. The longer that the temperature and setpoint are different, the larger the integral value becomes. The integral value is calculated as follows:
I = Previous I value + [ ( Input Setpoint ) I-gain ]
For example, if the I-gain is 2, the setpoint is 65, and the current temperature is 63, the integral value for the first interval will be -4. If at the end of the second interval the temperature is still 63, the integral value will increase to -8. The derivative value attempts to control the rate at which the temperature is brought to setpoint in order to prevent the setpoint from being exceeded. This value uses information from the current and previous intervals, and is calculated using the following formula:
D = [ ( Input Setpoint ) current ( Input Setpoint )previous ] D-gain
For example, if the D-gain is 3, the setpoint is 65, and the current temperature is 63, the derivative value for the first interval is -6 ([-2 0] x 3 = -6). If at the end of the second interval the temperature is still 63, the derivative value will increase to 0 ([-2 - (- 2)] x 3 = 0). The microblocks output percentage uses all three components as follows:
Output (%) = Bias P I D
The bias is set on the microblock dialog or the Parameter page. Using the examples listed for each component above, and assuming a bias value of 0, the output value of the PID microblock for the first interval would be 50; for the second interval the value would be 48. The Loop section of the microblock dialog contains settings that affect the overall operation of the microblock. The Bias value is added to the proportional, integral, and derivative values calculated by the microblock to create the final output value. The bias can be viewed as a starting point for the calculation, or as an offset to the final value. When the go input is off, the microblocks output defaults to the Bias
value. The Interval setting indicates how often the microblock calculates its output value. When the microblocks go input is on, the output value is calculated only once each interval. The Hold I error setting, when enabled, retains the last calculated integral value when the microblocks go input is off. You can edit the Parameter and Status screen prompt text on the microblock dialog to provide a meaningful description of the microblocks use on the Parameter and Status pages.
NOTE Because this microblock has been updated to avoid integral error problems, PID microblocks which were inserted into GFBs prior to Eikon 2.0 should be deleted and reinserted using Eikon 2.0 or later.
Linear Converter
Linear Converter
The Linear Converter microblock converts a value in a range to a proportionate value in a different range. You define both the starting (Input) and ending (Output) ranges on the microblock dialog. For example, you can use this microblock to convert a PID output percent value to a 3-13 psi value to operate a hot water valve. You could also use this microblock to establish a setpoint range for equipment based on the outside air temperature range. See Figure 9-6 below for an example of this application. You can edit the Parameter screen prompt text on the microblock dialog to provide a meaningful description of the microblocks use on the Parameter page.
Microblock
Microblockck
X and Y define the output range. For example, you can use this microblock to allow a BACview keypad to adjust the range of an output point such as a damper. See Figure 98 below for an example of this application.
The Linear Converter for Variable Inputs microblock is supported by Exec 6.01 (or later) modules.
Enthalpy Calculator
Enthalpy Calculator
The Enthalpy Calculator microblock accepts a dry bulb temperature and a relative humidity input and calculates a corresponding value for enthalpy. Enthalpy is a measure of energy inherent in the air. A high enthalpy value indicates a higher air temperature. Figure 9-9 shows how you can use the Enthalpy calculator microblock to modulate an economizer and take advantage of free cooling.
Microblock
In cases where the temperature and humidity input values are very high or very low, the enthalpy calculation can become distorted. In these cases it may be necessary to substitute additional logic in place of the Enthalpy Calculator microblock. Figure 9-10 illustrates this substitute programming.
Enthalpy Calculator
Microblock
In cases where the temperature and humidity input values are very high or very low, the dewpoint temperature can become distorted. To prevent this, use Constant High Limit and Constant Low Limit microblocks to limit the temperature and humidity input values. See Figure 9-12 below:
Figure 9-12: Limiting input values for the Dewpoint Temperature Calculator microblock
Microblock
True If = Constant
True If = Constant
The True If = Constant microblock creates an on (or true) signal when the value of the microblocks input is equal to the trip point. You define the trip point on the microblocks dialog or the Parameter page. You can edit the Parameter screen prompt text on the microblock dialog to provide a meaningful description of the microblocks use on the Parameter page.
Microblock
Microblock
Microblock
True If = Variable
True If = Variable
The True If = Variable microblock creates an on (or true) signal when the value of the microblocks if = input equals the microblocks other input. The microblock accepts two analog values wired from other parts of the GFB.
Microblock
Microblock
Microblock
Microblock
Microblock
10 Limit Microblocks
The Limit menu contains microblocks which accept signals from other microblocks, limit the value in some way, and then output the modified signal. These microblocks should be placed in the middle of the Graphic Function Block (GFB) between the Inputs and Outputs. The following microblocks are available in the Limit menu:
Constant High Signal Selector 258 Constant Low Signal Selector Variable High Signal Selector Variable Low Signal Selector Constant Low Limit 262 259 260 261
Constant High Limit 263 Variable Low Limit 264 Variable High Limit 265 266
Microblock
Microblock
Microblock
Microblock
Microblock
Microblock
Microblock
Microblock
Microblock
The Initial Values section of the microblock dialog sets the rate at which the input value can be increased or decreased. These settings correspond to the text on the Parameter page. The description on the Status page changes according to the actual state of the microblock.
11 Relay Microblocks
The Relay menu contains microblocks which accept signals from other microblocks, change or limit them in some way, and then output the modified signal. These microblocks should be placed in the middle of the Graphic Function Block between the Inputs and Outputs. The following microblocks are available in the Relay menu:
Constant Duty Cycle 271 Variable Duty Cycle 273 Delay on Make Delay on Break 274 275
Maximum On Timer 276 Minimum On/Off Timer Latch Toggle 278 279 277
Lead/Standby 280
286 287
Microblock
NOTE If the cycle time is changed, the change will not take effect until the current cycle is completed or the module is powered down and restarted.
Microblock
Delay on Make
Delay on Make
The Delay on Make microblock provides a delay before passing an on signal to the next microblock. You can set the length of the delay on the microblock dialog or the Parameter page. When the microblock receives an on signal, its output remains off until the delay time has passed. The delay time applies only to an on signal. Once the input turns off, the output turns off immediately. If the input turns off before the delay period passes, the output does not turn on.
NOTE If you change the delay time after the input is turned on, the change will not take effect until the original delay time expires or the module is restarted.
Microblock
Delay on Break
Delay on Break
The Delay on Break microblock provides a delay before passing an off signal to the next microblock. You can set the length of the delay on the microblock dialog or the Parameter page. When the microblock receives an off signal, its output remains on until the delay time has passed. The delay time applies only to an off signal. Once the input turns on, the output turns on immediately. If the input turns on before the delay period passes, the output does not turn off.
NOTE If you change the delay time after the input is turned off, the change will not take effect until the original delay time expires or the module is restarted.
Microblock
Maximum On Timer
Maximum On Timer
The Maximum On Timer microblock is used to limit the amount of time a signal remains on. When the microblocks input turns on, the microblock turns its output on and begins to track the amount of time that passes. When the specified amount of time passes, the microblock turns its output off. If the input turns off before this time is reached, the microblocks output turns off immediately. You can set the maximum amount of time the microblocks output stays on using the Maximum "on" duration setting on the microblock dialog or the Delay time is setting on the Parameter page. You can edit the Parameter and Status screen prompt text on the microblock dialog to provide a meaningful description of the microblocks use on the Parameter and Status pages.
NOTE If you change the delay time after the input is turned on, the change will not take effect until the original delay time expires or the module is restarted.
Microblock
Microblock
Latch
Latch
The Latch microblock maintains an on signal until some other condition occurs to turn the signal off. Once the latch input receives an on signal, the output turns on and remains on until the clr input turns on, even if the latch input turns off. When the clr input turns on, the microblocks output turns off as long as the latch input is off. If both the latch input and clr input receive an on signal at the same time, the clr input takes precedence, and the microblocks output turns off.
Microblock
You can edit the Status screen prompt text on the microblock dialog to provide a meaningful description of the microblocks use on the Status page.
Toggle
Toggle
The Toggle microblock toggles its output value whenever its input turns on. For example, when the toggle input turns on, the output turns on and remains on when the input turns off again. When the input turns back on, the output toggles off. When the clr input turns on, the output turns off or remains off if it is off already. You can edit the Status screen prompt text on the microblock dialog to provide a meaningful description of the microblocks use on the Status page.
Microblock
Lead/Standby
Lead/Standby
The Lead/Standby microblock controls two outputs to maintain an on or off signal. If one of the output signals is interrupted by an alarm condition or an expired runtime, the other output is activated to continue the signal. The output that produces the same signal received by the go input is called the lead output. The other output is the standby output, which becomes the lead output when the lead output is inactivated. This occurs when one of the following happens: The lead outputs corresponding alarm input (a1 or a2) turns on. The a1 input corresponds to the o1 output, and the a2 input corresponds to the o2 output. Note that one of the outputs will be on even when both alarm inputs are on. For example, if a1 is on, then o2 turns on. If a2 then turns on, then o1 turns on even though a1 is still on. The lead outputs runtime expires. The maximum runtime for the lead output can be defined on the microblocks dialog or on the Parameter page. The swap input turns on. When the swap input turns off, the outputs are not affected. Note that as long as the swap input is on, the alarm inputs do not affect the outputs. For example, if o1 is on and swap turns on, then o1 turns off and o2 turns on. If a2 then turns on while swap is still on, o2 will remain on. To avoid this situation, you can send a pulse signal to the swap input that turns swap on only long enough for the outputs to change.
Microblock
The lstat output turns on when the lead and standby outputs are changed as a result of the swap input turning on. When the go input is off, both outputs are turned off. If you want the standby output to become the lead based on runtime, set the Swap based on runtime option on the microblock dialog to yes. Use the Swap lead output after ____ hrs setting to determine when the lead outputs runtime expires. You can determine the starting runtime value using the Preset runtime value setting on the Parameter page.
Lead/Standby
For example, if the Preset runtime value is 100, and the Swap lead output after __ hrs setting is 150, the lead output becomes the standby output after 50 hours have passed (150 hours - 100 hours preset = 50 hours). Once the Preset runtime value is used, the Latch in preset value now parameter automatically changes to N. You must change this parameter back to Y to use the Preset runtime value again.
TIP If you need to have at least one of the outputs on at all times, you may want to use Delay on Break microblocks on the outputs to account for the possibility of lag time when the outputs are swapped. See Figure 11-11 for an example.
Lead/Standby
Microblock
Microblock
The microblocks output will normally equal the first numeric input, unless the sw input is on. When the sw input is on, the microblocks output equals the second numeric input.
Microblock
Microblock
12 Logic Microblocks
The Logic menu contains microblocks which perform logical operations on signals received from other microblocks. Often these microblocks are used to determine conditions that trigger equipment starts, stops, or alarms. These microblocks accept only digital inputs and produce on or off (digital) signals. The following microblocks are available in the Logic menu:
Or - 4 Input 291
And - 2 Input
And - 2 Input
The And - 2 Input microblock accepts two on or off (digital) signals. If both inputs are on, the microblocks output turns on. If either of the two inputs is off, the microblocks output is off.
Microblock
And - 3 Input
The And - 3 Input microblock accepts three on or off (digital) signals. If all the inputs are on, the microblocks output turns on. If any of the three inputs is off, the microblocks output is off.
Microblock
And - 4 Input
The And - 4 Input microblock accepts four on or off (digital) signals. If all the inputs are on, the microblocks output turns on. If any of the four inputs is off, the microblocks output is off.
Microblock
And - 5 Input
And - 5 Input
The And - 5 Input microblock accepts five on or off (digital) signals. If all the inputs are on, the microblocks output turns on. If any of the five inputs is off, the microblocks output is off.
Microblock
Or - 2 Input
The Or - 2 Input microblock accepts two on or off (digital) signals. If either of the two inputs are on, the microblocks output turns on. If neither of the two inputs are on, the microblocks output turns off.
Microblock
Or - 3 Input
The Or - 3 Input microblock accepts three on or off (digital) signals. If any of the three inputs are on, the microblocks output turns on. If none of the inputs are on, the microblocks output turns off.
Microblock
Or - 4 Input
The Or - 4 Input microblock accepts four on or off (digital) signals. If any of the four inputs are on, the microblocks output turns on. If none of the inputs are on, the microblocks output turns off.
Microblock
Or - 5 Input
Or - 5 Input
The Or - 5 Input microblock accepts five on or off (digital) signals. If any of the five inputs are on, the microblocks output turns on. If none of the inputs are on, the microblocks output turns off.
Microblock
Exclusive Or (XOR)
The Exclusive Or (XOR) microblock accepts two on or off (digital) signals. If either of the two inputs are on (but not both), the microblocks output turns on. If none of the inputs are on, or if both of the inputs are on, the microblocks output turns off.
Microblock
Not
Microblock
The Not microblock produces an output opposite of its input. For example, when the microblocks input is on, the output is off. When the input is off, the output is on.
13 Math1 Microblocks
The Math1 menu contains microblocks which perform mathematical operations on value(s) from other microblocks. These microblocks should be placed in the middle of the Graphic Function Block between the Inputs and Outputs. The following microblocks are available in the Math1 menu:
295 296
Modulo Divide by Constant 299 Add Two Variables 300 Add Three Variables 300
Add Four Variables 300 Subtract Two Variables 300 Multiply Two Variables 301 Divide Two Variables 301 Modulo 301
Average
301
Microblock
Microblock
Microblock
Microblock
Microblock
Microblock
Microblock
Microblock
Modulo
The Modulo microblock divides the value of its first input by the value of its second input. The microblocks output equals the remainder of this calculation. For example, if the microblocks first input is ten, and the second input is three, the microblocks output is one.
Microblock
Average
The Average microblock calculates the average of its two input values. The microblocks output is the result of this calculation.
Microblock
Change Sign
Change Sign
The Change Sign microblock changes the sign of its input value by multiplying the value by -1. For example, if the microblocks input value is -32, the output value is 32.
Microblock
Absolute Value
The Absolute Value microblock determines the absolute value of its input by removing its sign. For example, if the microblocks input is 10, the output is 10. If the microblocks input is 8, the output is 8.
Microblock
14 Math2 Microblocks
The Math2 menu contains microblocks which perform mathematical operations on value(s) received from other microblocks. These microblocks should be placed in the middle of the Graphic Function Block between the Inputs and Outputs. The following microblocks are available in the Math2 menu:
Sine 304 Cosine Tangent 304 304 304
Sine
Sine
Microblock
The Sine microblock accepts a value in degrees and calculates the sine of this value. The microblocks output is the result of this calculation.
Cosine
Microblock
The Cosine microblock accepts a value in degrees and calculates the cosine of this value. The microblocks output is the result of this calculation.
Tangent
Microblock
The Tangent microblock accepts a value in degrees and calculates the tangent of this value. The microblocks output is the result of this calculation.
Natural Log
Microblock
The Natural Log microblock calculates the natural logarithm of its input. The microblocks output is the result of this calculation.
Log
Log
Microblock
The Log microblock calculates the base 10 logarithm of its input. The microblocks output is the result of this calculation.
Exponent
The Exponent microblock raises the value of its second input to the power of its first input. The microblocks output is the result of this calculation.
Microblock
Square Root
Microblock
The Square Root microblock calculates the square root of its input value. The microblocks output is the result of this calculation.
Integrator
Integrator
The Integrator microblock calculates a value over time (minutes or hours) at a rate defined by the value of the input. The microblocks output is based on the value of the input and the rate chosen on the microblock dialog. On the microblock dialog you define whether the microblocks value is calculated over minutes (units/min) or hours (units/hr). For example, if the microblocks input value is 10, and the rate is measured in units per hour, the microblocks output increases at a rate of 10 per hour. At the end of the first hour, the output value is 10; at the end of the second hour, the output is 20, and so on. When the clr input turns on, the microblocks output value is reset to zero.
Microblock
You can edit the Status screen prompt text on the microblock dialog to provide a meaningful description of the microblocks use on the Status page.
Round Up/Down
Round Up/Down
The Round Up/Down microblock rounds the input value up or down and produces a whole number. If the fraction of the input value is less than 0.5, the microblock rounds the number down to the next whole number. If the fraction of the input is 0.5 or greater, the microblock rounds the number up to the next whole number.
Microblock
Truncate
The Truncate microblock discards the fractional portion of its input and provides a whole number output.
Microblock
Truncate
15 Misc Microblocks
The Misc menu contains miscellaneous microblocks. Although the OCL microblock appears in the Misc menu, it is discussed in the section Operators' Control Language on page 327 because of its complexity. The following microblocks are available in the Misc menu:
DO/DI Proof
DO/DI Proof
The DO/DI Proof microblock verifies proper equipment operation by comparing the status of a Digital Input with the status of a corresponding Digital Output. For example, the microblock can compare an input indicating the fans on or off status with the output that turns the fan on or off. If the two inputs do not receive the same signal, the DO/DI Proof microblock provides two outputs that can be used to trigger alarms.
Microblock
On the microblock dialog, the Feedback delay setting allows you to specify an allowable delay between the time a Digital Output turns on and the time the Digital Input registers the new status. When the microblocks do input turns on, if the di input does not turn on by the time the feedback delay time expires, the alrm output turns on. The Debounce time setting is the amount of time that the di input must remain on or off before it is considered valid. The debounce time should not be longer than the feedback delay; otherwise, an alarm will be generated each time the equipment starts. The alrm output turns on when the do input is on but the di input is off, indicating that the equipment is not running when it should have been turned on. The hand output turns on when the do input is off but the di input is on, indicating that the equipment is still running when it should have been turned off. You can edit the Parameter screen prompt text on the microblock dialog to provide a meaningful description of the microblocks use on the Parameter page.
DO/DI Proof
Up/Down Counter
Up/Down Counter
The Up/Down Counter microblock counts the number of on signals it receives and produces a number that increases or decreases according to the input receiving the signal. Each time the inc input turns on, the output value is increased by one. Each time the dec input turns on, the output value is decreased by one (but does not fall below zero). When the clr input turns on, the output value resets to zero. You can edit the Status screen prompt text on the microblock dialog to provide a meaningful description of the microblocks use on the Status page.
Microblock
Sunrise/Sunset
Sunrise/Sunset
The Sunrise/Sunset microblock calculates the time the sun will rise and set based on location and time zone information entered on the microblocks dialog or the Parameter page. The sunrise and sunset outputs produce todays sunrise and sunset times. The daylight output turns on when the current time falls between sunrise and sunset and turns off when the current time is before sunrise or after sunset. The Latitude, Longitude, and Offset from Greenwich Mean Time settings must be entered accurately in order to ensure that the correct sunrise and sunset times are calculated. Consult an atlas or your local weather station to determine this information for your area. When entering the longitude for a location in the Western Hemisphere (North or South America), enter the longitude as a negative number. Choose the appropriate negative number for the timezone: EST = -5 CST = -6MST = -7 PST = -8
Microblock
The Daylight Saving Time section of the microblock dialog allows you to enter the dates that Daylight Saving Time is in effect for up to seven years.
Sunrise/Sunset
Text
Text
Text microblocks do not interact with other microblocks in the GFB and are used only to place descriptive text on the Parameter page. The position of the text on the Parameter page can be controlled by clicking Reorder-Edit Order. The text is entered and edited on the microblock dialog but cannot be edited on the Parameter page.
Microblock
Multi-Text
Multi-Text
The Multi-Text microblock can be used to place descriptive text on the Function Block's Parameter and Status pages. The microblock accepts a numeric input of 1 to 15, which corresponds to one of 15 lines of descriptive text you can define. When an input from 1 to 15 is received, the corresponding text appears on the Status page. If an input higher than 15 or lower than 1 is received, no text for this microblock appears on the Status page. Each line of text may contain up to 48 characters, but quotation marks cannot be used. The position of the text on the Parameter page can be controlled by clicking Reorder-Edit Order. The text is entered and edited on the microblock dialog. The text cannot be edited on the Parameter page.
Microblock
Multi-Text
Version
Version
The Version microblock allows you to attach a fixed version number to a Graphic Function Block. This number appears only on the face of the microblock and on the Modstat page of the module where the GFB resides. The version number can only be changed on the microblock dialog. The Version microblock does not interact with any other microblock in the GFB and does not have any corresponding Parameter or Status page text.
Microblock
16 Figure
Unlike the other Microblock menus, the Figure menu contains figures that allow the operator to draw on the Eikon screen. This feature is helpful for organizing areas of a GFB. For example, an unfilled rectangle could be drawn around a certain area of logic with descriptive text. The Figure menu can be used along with the editing commands available in Eikon (Move, Delete, etc.) and the Palette (which can be shown by clicking Options-Palette). The Palette allows you to choose the colors, pattern, and line style for the figure you are drawing.
Drawing figures
Figures are drawn using the same basic steps. From the Figure menu, click the figure you want to draw. Click the color and pattern or line style you want from the palette. You can then begin drawing a figure following the specific instructions for the shape (instructions begin on page 320).
Palette
Line Styles
If you choose to use one of the available patterns for your figure, you can click a foreground color for your figure and right-click a
Drawing figures
background color. A choice of line style is only necessary when you are drawing a line or an unfilled object. Following are specific instructions for drawing each type of shape on the Figure menu. Some of the shapes are available as both filled and unfilled objects, but the technique for drawing a filled or unfilled object is the same.
To draw a line 1. Start the line by holding down the left mouse button where you want to begin the line. Drag the mouse to draw the line the length you want. To create additional segments, right-click while holding down the left mouse button and moving the cursor to the desired location. Up to 15 segments can be made in a line. 4. To finish the line, release the left mouse button. The backspace key can cancel line segments starting with the last one as long as you have not completed the figure and released the left mouse button.
2. 3.
To draw a square or rectangle 1. Start the rectangle by holding down the left mouse button where you want to begin the object. Drag the mouse to an opposite corner to create the shape you want. To finish the rectangle, release the left mouse button.
2.
3.
Drawing figures
To draw a circle 1. Start the circle by holding down the left mouse button where the center of the completed circle should be. Drag the mouse away from the center until the circle is the desired size. To finish the circle, release the left mouse button.
2.
3.
To draw an ellipse Use the circle figure to draw an ellipse. 1. Start the ellipse by holding down the left mouse button where the center of the completed ellipse should be. Drag the mouse away from the center until the ellipse has the horizontal width you desire. While still holding the left mouse button down, click and release the right mouse button and move the mouse up/down or left/right until the desired ellipse has been formed.
2.
3.
TIP It may take some practice to form an ellipse of the proper size and shape.
To draw an arc 1. Start the arc by holding down the left mouse button where the center of the completed circle should be. Drag the mouse away from the center until the circle is the desired size. While still holding the left mouse button down, right-click the mouse button and move the cursor clockwise or counter-
2.
3.
Editing figures
clockwise until the desired arc has been formed. To finish the shape, release the left button.
To draw a polygon 1. Start the polygon by holding down the left mouse button where you want to begin the object. Drag the mouse to another corner to form the first side of the polygon. While still holding the left mouse button, right-click the mouse to draw the next side of the figure. Continue in this manner until the figure is complete. Up to 15 directional changes can be made. 5. To finish the figure, release the left mouse button.
2.
3.
4.
To draw dots 1. Click and release the left mouse button where you want to draw a dot. Each dot is a separate figure with its own origin. Background color and line style do not apply when drawing dots.
Editing figures
The figures you draw using the Figure menu can be moved, deleted, and copied using the Edit menu commands, just as you would move, delete or copy microblocks or wires. It is also possible to change the shape, color, pattern, or line style of a figure and to rotate and scale the figure to a different size.
Editing figures
To edit the attributes of a figure 1. 2. 3. Click Edit-Edit-Attributes. Click the figure to be edited. Click the desired color, pattern, or line style.
TIP You can also click Edit-Edit-Others-Attributes to change the font, direction, or alignment of text. Enter text using the Abc option on one of the microblock libraries.
To edit the shape of an arc, circle, ellipse, or rectangle 1. 2. Click Edit-Edit-Shape. Click and hold the left mouse button inside the figure to be edited. Drag the outline of the figure to the desired shape. Release the left mouse button to complete the shape.
3. 4.
Editing figures
To edit the shape of a line or polygon 1. 2. Click Edit-Edit-Shape. Click and hold the left mouse button inside the figure to be edited. The last segment of the figure as it was originally drawn becomes active. 3. Drag the segment to the desired position. To add additional segments, click the right mouse button and continue as you would to draw the line or segment. Refer to the procedure To draw a line on page 320 or the procedure To draw a polygon on page 322 for details. To remove segments, press Backspace while continuing to hold the left mouse button. 4. When the figure is complete, release the left mouse button.
The minimum and maximum range of scaling is from zero percent to approximately 32,000 percent. If a figure is scaled up or down over 90 percent of its original size, it may not be possible to scale the figure back.
Editing figures
2.
Type the amount in percent that you want to scale the figure horizontally (on the X-axis) and vertically (on the Y-axis). A negative percentage shrinks the figure, and a positive percentage enlarges it. If you do not want to change the figures size, leave these values at 100.
3.
Type the amount in degrees that you want to rotate the figure. A negative number rotates the figure counter-clockwise around its origin (or starting point). A positive number rotates the figure clockwise around its origin. If you do not want to rotate the figure, leave this value at 0.
4. 5.
TIP You can scale or rotate multiple objects by using the right mouse button to drag an outline around a group of objects. Release the mouse button to complete the scale or rotation.
Editing figures
An OCL program is made up of two parts: the variable declaration section and the body of the program itself. The variable declaration section allows you to define features that are unique to the microblock and variables that are used in the body of the program. OCL also provides a number of terms, variables, mathematical functions, and programming commands you can use to complete your program. Note that although OCL has a great deal of flexibility, you should not try to program an entire FB into a single microblock. The program will function more efficiently if you break it up into smaller sections, using wires and other microblocks whenever possible. This way, you will also be able to easily see the components of the GFB, which will make the program easier to troubleshoot if necessary. The OCL program is not case-sensitive, but there are certain characters that have a special meaning, and there are cases in which a certain syntax must be used for the command to be understood. This information is noted in the applicable sections in this chapter. When you click OK on the OCL microblock dialog, the program is saved and checked for errors. A list of possible error messages and their explanations is located in the section Error Messages on page 347.
To create a custom microblock using OCL 1. Click the OCL microblock icon from the Misc microblock menu. Click where you want to place the microblock. The OCL microblock appears as a blank gray microblock when it is first placed. When you define the microblocks title, inputs, and outputs, the microblock will expand to accommodate the necessary text on the microblocks face. 3. To enter the programming for the microblock, press F5 and then click the OCL microblock. Type the program into the editing window. Click OK to save the program and close the editing window. If errors are found in the program, a message appears. The message indicates which line of the program the error was found in, so you can correct the error more easily. Error messages and their explanations are listed in the section Error Messages on page 347. If no errors are found, the program is saved and the microblock changes appearance to reflect the title and any inputs or outputs defined.
TIP If you want to use this microblock in more than one GFB, select the microblock by pressing F9 and clicking the microblock. Then save the microblock as a symbol by clicking Edit-Copy To. Refer to the Eikon Users Guide for more information about symbols.
2.
4. 5.
Programming structure
This is the microblock that results from the program shown above.
program. You cannot create a variable using the same name as any of the predefined symbols, functions, or commands. When entering the variable declaration section, you only need to include those items that are used by the microblock. Each term can be typed either in upper or lower case letters and should be followed by at least one space.
AINPUT
This term is used to define the microblocks analog inputs. Each inputs name must begin with a letter. While each name can be up to 32 characters long, only the first four characters appear on the face of the microblock. If you need to define more than one analog input, separate each inputs name with a comma. Example
AINPUT TMP1,CUR5,ENT3
This line creates three analog inputs for the microblock named TMP1, CUR5, and ENT3.
AOUTPUT
This term is used to define the microblocks analog outputs. Each outputs name must begin with a letter. While each name can be up to 32 characters long, only the first four characters appear on the face of the microblock. If you need to define more than one analog output, separate each outputs name with a comma. Example
AOUTPUT COIL,POWR,HEAT
This line creates three analog outputs for the microblock named COIL, POWR, and HEAT.
DINPUT
This term is used to define the microblocks digital inputs. Each inputs name must begin with a letter. While each name can be up to 32 characters long, only the first four characters appear on the face of the microblock. If you need to define more than one digital input, separate each inputs name with a comma.
Example
DINPUT STA1,PMP2
This line creates two digital inputs for the microblock named STA1 and PMP2.
DOUTPUT
This term is used to define the microblocks digital outputs. Each outputs name must begin with a letter. While each name can be up to 32 characters long, only the first four characters appear on the face of the microblock. If you need to define more than one digital output, separate each outputs name with a comma.
Example
DOUTPUT SEC7,LIG2
This line creates two digital outputs for the microblock named SEC7 and LIG2.
PAR
This term is used to define variables that are used in the body of the OCL program, and if necessary, to define the text for these variables that appears on the Parameter page. Each variable can be any letter or letter combination you choose, as long as it is not already used by OCL. If the variable appears on the Parameter page, the Parameter page text should be entered within quotation marks following the variable. To display the value of the parameter, you must use the underscore character (_). You must enter enough underscores to account for all the digits required to display the value; otherwise, the value will be truncated.
TIP If you want to display the variables value on the Parameter page but do not want the value to be changed, you can use a tilde (~) in place of the underscore. Refer to the example below.
Example
PAR E = 2.71 "E equals ____", X = 5.0 "X equals ~~~"
In this example, OCL assigns the variable E to 2.71 and X to 5.0. On the parameter page, the text "E equals 2.71" will be displayed, with the "2.71" in blue text, indicating that this value can be
changed. The text "X equals 5.0" also appears on the Parameter page, but the value "5.0" appears in yellow text, indicating that it cannot be changed.
TIMER The TIMER declaration is used to define timing variables.
These are defined similar to the VAR declaration, with a variable name, text within quotes, and a string of tildes to display the present value of the variable. Example
TIMER T2 "Time remaining for Timer2 = ~~~~ (mm:ss)"
In this example, OCL displays the given text on the Status page along with the present value of T2 instead of the string of tildes.
TITLE
This term defines the title of the microblock that appears on the microblocks face. The title will not appear if no inputs or outputs are defined. The title may be up to eight characters long.
Example
TITLE ICEPLANT
the OCL program, and if necessary, to define the text for these variables that appears on the Status page. Each variable can be any letter or letter combination you choose, as long as it is not already used in the variable declaration section or by OCL. If the variable appears on the Status page, the Status page text should be entered within quotation marks following the variable. To display the value of the variable, you must use the tilde character (~). You must enter enough tildes to account for all the digits required to display the value; otherwise, the value will be truncated.
Predefined Symbols
Example
VAR Z "Z equals ~~~~"
In this example, OCL displays the text "Z equals" along with the present value of Z.
Predefined Symbols
OCL provides a number of predefined symbols, which are terms that already have an assigned value. These terms can be used in the body of your OCL program. You cannot change the value of any of these terms, and you should not list these terms in the variable declaration section. Table 17-1. Predefined OCL symbols
Symbol GRAY HRED KBLUE LTBLUE GREEN SPECKLE YELLOW ORANGE CRED WHITE Value 1 2 3 4 5 6 7 8 9 10 Symbol JAN FEB MAR APR MAY JUN JUL AUG SEP OCT NOV TRUE FALSE ON 1 0 1 MON 1 DEC Value 1 2 3 4 5 6 7 8 9 10 11 12
System Variables
System Variables
OCL provides several system variables, which read information from the GFB. You can use these variables in your program whenever one of these values is required. Each system variable produces a number corresponding to the variables current value in the GFB.
COLOR MDAY MONTH TIME WDAY
TRepresents the GFBs current color (1-10). Represents the current day of the month (1-31). Represents the current month (1-12).
Represents the current day of the week (Monday=1, Sunday=7). Represents the current day of the year (1-366).
YDAY
Special Characters
Special Characters
When typing your OCL program, there are certain characters that represent specific functions or values in OCL. The characters that have a special significance in OCL are described below: Table 17-2. Special Characters
Character () Description Used to override order of evaluation in an expression, delineate arguments in function calls, and to specify a conditional expression. (comma) Used to separate arguments in function calls. (colon) Used to identify labels referenced by GOSUB and GOTO keywords. Used to place comments in the program. Any text following two front slashes is ignored by the OCL complier. Used to represent one hour, or 3600 seconds. Used to represent one minute, or 60 seconds. Reserved but has no effect. The default time unit is seconds.
, : // H M S
Mathematical Functions
OCL provides a number of mathematical and logical functions you can use in your program. Each of these functions acts on a value or set of values in parenthesis following the name of the function. These functions can act on numbers, variables, or expressions to calculate the results.
ABS
This function returns the absolute value of the number, variable, or expression in parenthesis.
Mathematical Functions
Example
X = -10 Y = ABS(X) Z = ABS(5+3)
In this example, OCL assigns Y to 10, because the absolute value of X equals 10. OCL assigns Z to 8, because the absolute value of 5+3 equals 8.
AVG
The AVG function returns the average of a set of values. Example
XAN = 5 BETA = AVG(1,4,XAN,9)
In this example, OCL assigns BETA to: ( 1 + 4 + XAN + 9 ) (1 + 4 + 5 + 9) ------------------------------------------------- = ----------------------------------- = 19 = 4.75 4 4 4
BETWEEN
This function evaluates the three values in parentheses and determines whether the first value falls between the second and third values. If the first value does fall between the second and third values, the function returns a value of 1.0. If not, the between function returns a value of 0.0. Example
STAT1 = BETWEEN(17,15,20) BETA = 2 STAT2 = BETWEEN(BETA,3,5)
In this example, OCL assigns the value of STAT1 to 1.0, since 17 falls between 15 and 20. OCL assigns the value of STAT2 to 0.0, since BETA (which has a value of 2) is not between 3 and 5.
Mathematical Functions
COS
This function computes the cosine of the value (in degrees) in parentheses. Example
VAL = COS(45)
DELON
This function calculates whether a variable or expression has been on or true for the amount of time specified. The time must be specified as a number, variable, or expression. Example
STAGE1 = DELON(GAS, 1:00)
This example turns on the variable STAGE1 after the variable GAS has been on for 1 minute. Example
STAGE2 = DELON(FLOW1 > 125, 5 H)
This example turns on the variable STAGE2 after the value of the variable FLOW1 has been greater than 125 for 5 hours.
LMT
This function limits a value based on the high and low limits specified. This function requires three values: the first value is the value to be limited, the second value is the low limit, and the third value is the high limit. Each of the values can be a number, a variable, or an expression. If the first value falls between the low and high limits, the value is unchanged. If the first value is lower than the low limit, the low limit becomes the functions value. If the first value is higher than the high limit, the high limit becomes the functions value.
Mathematical Functions
Example
ZETA1 = 3 ZETA2 = LMT(ZETA1, 5, 10)
In this example, ZETA2 = 5, since the value of ZETA1 (which is 3) is less than the low limit of 5.
LN
The LN function calculates the natural logarithm of the indicated value. Example
Y = LN(134)
LOG
The LOG function calculates the base 10 logarithm of the indicated value. Example
X = LOG(134)
MAX
This function determines the larger number from a set of two numbers, variables, constants, or expressions.
Mathematical Functions
Example
SIGMA = 7 GAMMA = MAX(SIGMA,10)
In this example, OCL sets GAMMA equal to 10, since 10 is larger than SIGMA (which is set to 7).
MIN
This function determines the smaller number from a set of two numbers, variables, constants, or expressions. Example
X=2 RHO = MIN(1+X,4)
In this example, OCL sets RHO equal to 3, since 1+X (when X = 2) is less than 4.
POW
This function calculates the first value raised to the power of the second value. Example
CHI = POW(TAU,3)
In this example, OCL sets CHI equal to TAU raised to the power of 3 (TAU cubed).
RATIO
This function converts converts a value in a range to a proportionate value in a different range. The first value in parenthesis is the value to be converted. The next two values indicate the current range that the first value belongs in, and the last two numbers indicate the range the value should be converted to.
Mathematical Functions
Example
N=40 DELTA = RATIO(N, 0, 100, 3, 13)
RND
The RND function rounds the specified number to the nearest whole number. Example
KAPPA = RND(3.442) LAMBDA = RND(10.59)
In this example, OCL sets KAPPA equal to 3.0 and LAMBDA equal to 11.0.
SIN
This function calculates the sine of the value (in degrees) in parenthesis. Example
X = SIN(90)
SQRT
This function calculates the square root of the indicated value. Example
Y = SQRT(81)
Mathematical Functions
START
The START function turns on the variable or variables in parenthesis. You can use as many variables as necessary, separating each variable with a comma. Example
START(FAN1, PUMP4, STAGE2)
In this example, OCL turns on the variables FAN1, PUMP4, and STAGE2.
STOP
This function turns off all of the variables listed in parenthesis. You can use as many variables as necessary, separating each variable with a comma. Example
STOP (ALARM, LIGHT2, COMP4)
This example turns off the variables ALARM, LIGHT2, and COMP4.
TAN
This function calculates the tangent of the value (in degrees) indicated in parenthesis. Example
XI = TAN(71)
TOF
This function returns the amount of time in seconds that the variable or expression in parenthesis has been off or false.
Programming Structures
Example
X = TOF(CHILLER1)
In this example, OCL sets X equal to the amount of time in seconds that CHILLER1 has been off.
TON
This function returns the amount of time in seconds that the variable or expression in parenthesis has been on or true. Example
Y = TON(BOILER2)
In this example, OCL sets Y equal to the amount of time in seconds that BOILER2 has been running.
TRN
This function discards the fractional portion of the value in parenthesis. Example
WEIGHT= TRN((CREQ1 + CREQ2 + CREQ3)/3)
In this example, OCL evaluates the equation in parenthesis and truncates the value. If CREQ1 equals 2, CREQ2 equals 5, and CREQ3 equals 0, the value of WEIGHT is 2.
Programming Structures
OCL supports several programming structures, which are common to many other programming languages.
BEGIN...END
The BEGIN...END structure is used to group together a number of program statements. This structure is often used to group together a
Programming Structures
sequence of statement that should be executed when a given condition is met. Example
IF (OCC) THEN BEGIN START PUMP1 START BOILER1 RATE = 4 * LMT(FLOW,5,10) END
In this example, OCL starts PUMP1, starts BOILER1, and calculates RATE whenever OCC is TRUE.
DELAY
This structure halts execution for the amount of time specified. The time may be defined in hours (H), minutes (M), or seconds (the default unit). Example
DELAY 10H
EVERY...DO
This structure tells OCL to execute a program statement once every time the specified interval of time passes. The time may be defined in hours (H), minutes (M), or seconds (the default unit). The actual amount of time can be a number or a variable. Example
EVERY 10 M DO A = B + AVG(C, D + E)
Programming Structures
EXITLOOP
The EXITLOOP structure is used to skip the remaining portion of a WHILE...DO loop if the specified condition is met. Example
WHILE (CONTENT < 90.1) DO BEGIN IF (TLO = ON) THEN EXITLOOP D=D+2 END
In this example, OCL continues to calculate the value of the variable D until either the value of CONTENT becomes greater than 90.1 or the variable TLO turns on.
EXITPROG
EXITPROG is used to end the OCL program. You should place all subroutines after the EXITPROG statement to prevent them from being executed inadvertently. Syntax
EXITPROG
GOSUB...RETURN
The GOSUB structure is used to call a subroutine which is referenced by a label or name. You should place all subroutines after the EXITPROG statement to ensure that they are not executed inadvertently. Once the subroutine is finished, the RETURN statement resumes execution of the OCL program at the point where the subroutine was invoked.
Programming Structures
Example
IF X < 23.0 THEN GOSUB TURNON ELSE GOSUB TURNOFF EXITPROG TURNON: START (LOCK1) START (LOCK2) RETURN TURNOFF STOP (LOCK1) STOP (LOCK2) RETURN
In this example, OCL begins the TURNON subroutine, which turns LOCK1 and LOCK2 on, if X is less than 23. If X is greater than 23, OCL begins the TURNOFF subroutine, which turns LOCK1 and LOCK2 OFF.
GOTO
The GOTO structure transfers execution of OCL to the designated label. Use of the GOTO structure is not recommended because it creates difficulties in debugging the OCL sequence. Example
IF (PH >= 6) THEN GOTO ACID Y = GB - X GOTO LAST ACID: Y = GB + X LAST:
In this example, OCL jumps to the line labeled ACID if PH is greater than or equal to 6. After it reaches line ACID, it sets Y equal to GB + X and proceeds to the line LAST. If PH is less than 6, OCL sets Y equal to GB - X and jumps to the line LAST.
Programming Structures
IF...THEN
The IF...THEN structure tells OCL to execute the given program statement if the value of the variable or expression in parenthesis is TRUE. Example
IF (BOILER9) THEN X = 45
IF...THEN...ELSE
The IF...THEN...ELSE structure works similarly to IF...THEN but adds an alternative statement to be executed if the value of the variable or expression in parenthesis is FALSE. Example
IF (HUMIDITY > 88) THEN DEMAND = 4 ELSE DEMAND = 2
In this example, OCL sets DEMAND equal to 4 if HUMIDITY is greater than 88; otherwise OCL sets DEMAND equal to 2.
IFONCE...THEN
This structure works similarly to the IF...THEN structure but executes the program statement only once after the value of the variable or expression in parenthesis has been determined to be true. Example
IFONCE(PRESSURE > 178) THEN START (ALARM6)
In this example, OCL starts ALARM6 if PRESSURE becomes greater than 178.
Error Messages
Operators
The following operators can be used with If statements:
WHILE...DO
This structure tells OCL to execute a program statement provided that the value of the variable or expression in parenthesis is TRUE. Example
WHILE (POSITION>150) DO POSITION = POSITION - 1
Error Messages
ASSERT ERROR Did not expect the item encountered. ASSERT ERROR: EXPECTED 'THEN'
statements.
ASSERT ERROR: EXPECTED ',' Function arguments must be comma
delimited.
ASSERT ERROR: EXPECTED 'DO' DO required with WHILE or EVERY
statements.
ASSERT ERROR: EXPECTED '=' ASSERT ERROR: EXPECTED '('
parentheses.
ASSERT ERROR: EXPECTED ')' CAN'T FIND LABEL
Encountered GOSUB or GOTO label statement but was unable to find the label.
Only variable.
DOUBLY-DEFINED ITEM Attempting to declare the same item twice.
Error Messages
ELSE WITHOUT IF
END WITHOUT BEGIN Encountered END without a preceding BEGIN. EXITLOOP WITHOUT WHILE
preceding WHILE.
FUNCTION CALL ARGUMENT MISMATCH
A call to a function was made with an incorrect number of arguments. Encountered a GOSUB without a subsequent RETURN. The only valid characters are 'A'- 'Z', 'a'-'z', and '_'. Item names must begin with alpha characters. The number of digits in a constant exceeded 32
INVALID CONSTANT
characters.
ITEM RESERVED AS AN OCL KEYWORD
A variable was used before being declared in the variable declaration section. Attempting to nest statements too
deeply.
RETURN WITHOUT GOSUB
GOSUB.
INVALID PARAMETER DECLARATION
A number must follow '=' of the PAR statement in the variable declaration section. The combined number of analog/digital
The number of items declared in the variable declaration section must not exceed 1000.
Error Messages
Error in
declaration syntax.
UNKNOWN OPERATOR An operator was expected, but some other
A variable was referenced in the body of the OCL program which was not first declared in the header portion.
Error Messages
18 Appendix A
Non-Graphic FB Commands
The commands listed in this appendix section were originally used to pass information between non-graphic FBs. While these commands may still be used for this purpose, they may also be used to send global commands from GFBs to non-graphic FBs using LAN Output microblocks (discussed in the I/O Microblocks chapter). A non-graphic FB can receive commands from up to four different LAN Outputs. In order to receive these commands, the non-graphic FB must have the correct address of the transmitting LAN Output in the Command From parameter on the parameter page. Four entries are available in the Command From parameter for this purpose. The global commands are presented in the following format: Command # - Command Name (Command Type) Broadcast By: Received By: Explanation: Additional commands are available that do not require a command number or Command From address. These commands are listed at the end of this appendix. 0 - Normal (Digital) Broadcast By: Any FB listed in "Broadcast By" of this appendix. Received By: Any FB listed in "Received By" of this appendix.
Chapter 18: Appendix A 351
Non-Graphic FB Commands
Explanation: Returns a receiving FB to normal operation. 1 - Shutdown (Digital) Broadcast By: AI1, ALB, DI2, DLB, PTR, SL2, SL4, SLB, TC1, ULB, WSP Received By: AH1-AH8, AHB, AHC, AHF, AHM, AHN, AHT, AHU, ALB, AM1, AMB, AMB, AMR, ASI, AVG, AW1, AW2, AZ1, BC1, BM2, CH1-CH5, CL2, CL3, CLH, CM1-CM6, CMB, CMF, CMN, CMT, CO1-CO3, COV, CPG, CPL, CPM, CPP, CSM, CT1, CT2, DI3, DLB, DO2-DO4, DOA, DOL, DOS, EC1, EC2, ECO, ET2, ET3, ETI, ETR, FCT, FM1, FM2, FTC, FTR, GIR, HL2, HLR, HP1, HP2, LC2, LM1, MCM, MTS, MV1, ORC, OSI, PC1, PM1, PM2, PMN, PT2-PT5, PTR, SC1, SC2, SC4, SLB, SS1-SS5, TC1, TC2, TCR, TOI, TPC, TPF, TS1, ULB, VV1, VVR, WBC, WH1, WSPZC1, ZC2, ZF1-ZF3, ZH1, ZP1, ZS1, ZV1 Explanation: Forces FB to an unoccupied or inactive state and forces all outputs off or to an inactive state. 2 - Changeover (Digital) Broadcast By: ALB, DLB, MC1, MCM, SLZ, SL4, SLB, TPC, ULB, WSM Received By: AH7, AHM, AHN, AHU, BM2, CL1-CL3, CM2, CM5, CO1-CO3, COV, SL2, SL4, SLB, SS1,TC1, TCR, TPF, VVR, ZP1, ZS1 Explanation: Sends a digital command to switch to Changeover mode. This mode is opposite of the "Normal" mode parameter defined in each receiving FB's parameter page (heating or cooling). 3 - TLO (Analog) Broadcast By: SL2, SL4, SLB, TL8, TLC, TLO Received By: AHB, AHC, AI1-AI4, ALB, ASI, BTU, CMB, CMF, CPP, DI1, DI4, DLB, DOA, DOS, EM6-EM8, ET2, ET3, ETI, ETR, FTR, GIR, HP1, HP2, LC1, LC2, LM1, MCM, NP1, OSI, PA1, PSV, PT2-PT5, PTR,
Non-Graphic FB Commands
SL2, SL4, SLB, SM1, TC1, TC2, TCR, TL8, TLC, TLO, TOI, TPF, TS1, ULB, VV1, VVR, WH1, WSP, ZC1, ZC2, ZF1-ZF3, ZH1, ZP1, ZS1, ZV1 Explanation: Sends an override command. Any FBs capable of listening to this command will go into occupied mode. 4 - Compressor Shutdown (Digital) Broadcast By: ALB, DI2, DLB, SL2, SL4, SLB, ULB, WSM, WSP Received By: HP1, HP2, SL2, SL4, SLB, ZC2, ZH1, ZP1, ZS1, ZV1 Explanation: Sends the command to shutdown compressor outputs. All other outputs will function formally, and the FB will remain in its current state of occupancy. 5 - Chilled Water Temp. Setpoint (Analog) Broadcast By: ALB, BM2, CM2, CM3, CM4, CM5, CM6, CMB, CMT, CPG, CPL, CPM, SL2, SL4, SLB, TS1, ULB Received By: ALB, CH1-CH5, DLB, HL2, HLL, HLR, SL2, SL4, SLB, SS1, SS5, ULB Explanation: Sends the command to adjust the chilled water temperature setpoint. Normally used to adjust the chillers' and boilers' FB temperature setpoints to be the same as that at the Chiller Manager or Boiler Manager FB. 6 - Soft Shutdown (Digital) Broadcast By: ALB, DI2, DLB, SL2, SL4, SLB, ULB, WSM, WSP Received By: AH3, AHM, AHU, ALB, CH5, CL3, DLB, DO3, DO4, DOA, DOL, DOS, ET3, ETR, HP1, HP2, LC2, SL2, SL4, SLB, TPF, ULB, VVR, ZF1-ZF3, ZH1, ZP1, ZS1, ZV1 Explanation: Sends the command to shut off all digital outputs, but otherwise run as normal.
Non-Graphic FB Commands
7 - Modify Setpoint: -Cool (Analog) Broadcast By: NP1, SL2, SL4, SLB, SM1 Received By: AI1-AI3, ET2, ET3, ETI, ETR, FTR, GIR, HP1, HP2, PT2PT5, PTR, SL2, SL4, SLB, SM1, TC1, TC2, TCR, TPR, VV1, VVR, WH1, WSP, ZC1, ZC2, ZF1-ZF3, ZH1, ZP1, ZS1, ZV1 Explanation: Sends the command to decrease the cooling setpoint of a zone. 8 - Modify Setpoint: +Heat (Analog) Broadcast By: NP1, SL2, SL4, SLB, SM1 Received By: AI1-AI3, ET2, ET3, ETI, ETR, FTR, GIR, HP1, HP2, PT2PT5, PTR, SL2, SL4, SLB, SM1, TC1, TC2, TCR, TPR, VV1, VVR, WH1, WSP, ZC1, ZC2, ZF1-ZF3, ZH1, ZP1, ZS1, ZV1 Explanation: Sends the command to increase the heating setpoint of a zone. 9 - Modify Setpoint: +Heat, -Cool (Analog) Broadcast By: NP1, SL2, SL4, SLB, SM1 Received By: AI1-AI3, ET2, ET3, ETI, ETR, FTR, GIR, HP1, HP2, PT2PT5, PTR, SL2, SL4, SLB, SM1, TC1, TC2, TCR, TPR, VV1, VVR, WH1, WSP, ZC1, ZC2, ZF1-ZF3, ZH1, ZP1, ZS1, ZV1 Explanation: Sends the command to decrease the cooling setpoint and increase the heating setpoint of a zone. 10 - Modify Setpoint: -Heat, +Cool (Analog) Broadcast By: NP1, SL2, SL4, SLB, SM1
Non-Graphic FB Commands
Received By: AI1-AI3, ET2, ET3, ETI, ETR, FTR, GIR, HP1, HP2, PT2PT5, PTR, SL2, SL4, SLB, SM1, TC1, TC2, TCR, TPR, VV1, VVR, WH1, WSP, ZC1, ZC2, ZF1-ZF3, ZH1, ZP1, ZS1, ZV1 Explanation: Sends the command to decrease the heating setpoint and increase the cooling setpoint of a zone. 11 - Global Variables (Analog/Digital) Broadcast By: GV1, SL2, SL4, SLB Received By: 88H, AH1-AH8, AHB, AHC, AHF, AHM, AHN, AHT, AHU, AI1-AI4, ALB, AM1, AMB, AMG, AMR, ASI, AVG, AW1, AW2, AZ1, BC1, BM2, BTU, CH1-CH5, CL1-CL3, CLH, CM1-CM6, CMB, CMF, CMN, CMT, CO1-CO3, COV, CP1, CP2, CPG, CPL, CPM, CPP, CSM, CT1, CT2, DI1-DI5, DLB, DO2-DO5, DOA, DOL, DOS, EC1, EC2, ECO, EM1-EM8, CM., ET2, ET3, ETR, TCT, FM1, FM2, FTC, FTR, GIR, GM1, GV1, HL2, HLL, HLR, HP1, HP2, LC1, LC2, LM1, MC1, MCM, MTS, MV1, NP1, OA1, OA2, OA4, OA5, OAN, ORC, OSI, OTO, OT1-OT3, OT5, PA1, PAC, PC1, PCT, PM1, PM2, PMN, PSB, PSC, PSR, PST, PSV, PT2-PT5, PTR, SC1, SL2, SL4, SLB, SM1, SS1-SS5, TC1, TC2, TCR, TL8, TLC, TLO, TOI, TPC, TPF, TS1, ULB, VV1, VVR, WBC, WH1, WM1, WSM, WSP Explanation: Sends an analog or digital value as a global broadcast to a non-graphic FB.
NOTE Command 11 requires that the input in the non-graphic FB that receives the broadcast must have the correct global channel number listed. The following channel numbers are used for receiving global broadcasts: A1, A2, A3, A4 (for analog broadcasts) and B1, B2, B3, B4 (for digital broadcasts). These channel numbers correspond to the addresses in the Command From parameter. For example, an analog input with a channel number of A3 would listen to broadcasts received from the address listed in the third entry in the Command From parameter. Note that it is not possible to use the same number for digital and analog channels (for example, both A3 and B3) in the same FB.
Non-Graphic FB Commands
12 - Economizer Mode (Digital) Broadcast By: CPL, SL2, SL4, SLB Received By: CPL, CT1, CT2, SL2, SL4, SLB Explanation: This allows the above FBs to operate using setpoints appropriate for waterside Economizer operation. 13 - Pressurization Mode (Digital) Broadcast By: DI2, SL2, SL4, SLB Received By: ZP1, ZS1 Explanation: Used to force VAV FBs to a predetermined setpoint based on a global building condition. 14 - Telephone Override (Digital) Broadcast By: SL2, SL4, SLB, TOI Received By: SL2, SL4, SLB, TLO Explanation: Used to concentrate more than 1 TLO broadcast going to a single zone into a single TLO broadcast. 15 - Optimal Start Inhibitor (Digital) Broadcast By: OSI, SL2, SL4, SLB Received By: AI1-AI3, ASI, ET2, ET3, ETI, ETR, FTR, GIR, HP1, HP2, PT2-PT5, HPR, SL2, SL4, SLB, SM1, TC1, TC2, TCR, TPF, VV1, VVR, WH1, WSPZC1, ZC2, ZF1-ZF3, ZH1, ZP1, ZS1, ZV1 Explanation: Used to inhibit optimal start role on the above FBs.
Non-Graphic FB Commands
16 - Relative Schedule Time Remaining (Analog) Broadcast By: RTS Received By: All Exec. 3.x FBs. Explanation: Used to broadcast the number of minutes until the next scheduled transition time (occupied or unoccupied). 99 - Momentary Pulse 'heartbeat' (Digital) Broadcast By: RTS (or any graphic FB with a LAN DO) Received By: All Exec. 3.x FBs (or any graphic FB with a LAN DI). Explanation: Used to revalidate a broadcast (or LAN DO) in the receiving FB. When an on broadcast is sent, the receiving FB sees a momentary on then off signal. This can be used to trigger FB logic to indicate a failed or separated module. It can also be used to revalidate a relative schedule time broadcast in receiving FBs. If the receiving FB does not receive this broadcast, the relative schedule will default to the downloaded schedule.
Additional Commands
The following broadcasts can be received by any Exec 3.x FB as long as the appropriate channel number is entered for the receiving input. No address is required in the Command From parameter. Table 18-1. Exec 3.x Broadcasts
Broadcast Outside Air Humidity Outside Air Enthalpy Dry Bulb Temperature Channel Number FD FE FF
Non-Graphic FB Commands
19 Glossary
ADAPTIVE OPTIMAL START
A method used by certain Zone Setpoint microblocks to regulate setpoints so that the ideal temperature range can be achieved when building occupancy begins. The Adaptive Optimal Start routine adjusts setpoints at a constant rate based on the heating or cooling capacity of the equipment and the amount of time remaining prior to occupancy. See also Learning Adaptive Optimal Start.
Function Block in a system. The address is composed of the site number, gateway number, module number, and Function Block number. For example, a Function Block with an address of 1,2,7,3 is the third Function Block in module number seven, which is connected to the second gateway in site number one.
ALERT A comprehensive event management software package. Alert
is designed for maximum event handling flexibility, including several event notification options and reporting actions.
CELL
A temporary storage location used to simulate the transmission of data between Function Blocks in Eikons simulation mode.
CHANNEL NUMBER
A two-digit number that tells a Function Block where to locate an input or output point on a control module. The channel number represents the physical input or output channel on a module and can be configured on the Parameter page or on the microblock dialog.
CMNET
A peer-to-peer local area network which allows up to 99 control modules to communicate with one another with equal authority.
CONTROL MODULE
A microprocessor-based hardware product designed for stand-alone direct digital control of HVAC equipment. Many types are available in a variety of input/output configurations. Control modules are wired together to form a local area network called a CMnet.
DUTY CYCLE
A period of time during which equipment is alternately on and off. A Windows-based application which provides the ability to graphically program, display, and interact with any HVAC sequence of operation. It features microblocks (representing common control devices and complex energy management functions) interconnected on the screen by graphical wires to form logical connections.
EIKON
A module which is added to an existing module in order to expand the number of I/O points. One or more expander modules connected to a base module is called a stack. Each expander has a unique address in the stack which is called the expander number. A number that tells a Function Block which expander module contains an input or output point. Expander numbers are assigned to points using either the point microblocks dialog or the Parameter page. The software program that resides in a control modules Programmable Read-Only Memory (PROM). The firmware, or Exec, controls the processing of the Function Blocks in the module.
EXPANDER NUMBER
FIRMWARE
A software program designed specifically for controlling HVAC equipment. A Function Block (FB) consists of small program blocks (called microblocks) that can be linked together to create logical control sequences. Operating parameters for the Function Block can be assigned by the operator or by the Function Blocks designer and can be changed in SuperVision on the Parameter page. The current status of these parameters can be
A parameter which a Function Block multiplies with an analog I/O value in order to convert the signal into desired units (for example, converting mA to degrees Fahrenheit). Gain is used with the Offset parameter to calibrate a point. A number that describes the type of LAN broadcast sent between Function Blocks which may or may not be located on the same CMnet.
GLOBAL COMMAND
referred to as global points, since they can transmit and receive information between CMnets residing on the same LGnet.
GLOBAL VARIABLE A value (such as outside air temperature or
electrical demand level) that is broadcast by a LAN Output microblock. Global variables are available to Function Blocks on different CMnets that share the same LGnet.
GRAPHIC FUNCTION BLOCK (GFB)
A Graphic Function Block (GFB) is a term used to describe the graphic representation of a Function Block program. This representation is created in Eikon and can be viewed in SuperVision using the Live GFB feature. A method of connecting microblocks to each other in a Graphic Function Block. Labels are used to carry analog or digital values between microblocks when a wire cannot be drawn or is not appropriate. See also Wire.
LABEL
Setpoint microblocks to regulate setpoints so that the ideal temperature range can be achieved when building occupancy begins. The Learning Adaptive Optimal Start routine adjusts setpoints based on the heating or cooling capacity of the equipment, which is adjusted (or learned) over time as the equipment meets or fails to meet the ideal temperature range. See also Adaptive Optimal Start.
LGNET
A peer-to-peer global network that allows Function Blocks on different CMnets to communicate with equal authority. Each CMnet communicates with the LGnet through a gateway (like a LANgate or LGRM-E). LAN Input and Output microblocks can be used to broadcast information between Function Blocks residing in different CMnets that share the same LGnet.
MBCODE
A code assigned to each microblock in a Function Block. MbCodes can be changed by the Function Blocks designer if the microblock has its own dialog box.
specific purpose and is represented by a graphic symbol. Microblocks are combined in Eikon with wires and labels to create Function Blocks. Custom microblocks can be created using Operators Control Language (OCL).
NIB
A small pin on the side of a microblock. Wires and labels must connect with a microblocks nib in order for the Graphic Function Block to compile.
value in order to shift its range to match a standard range (for example, 4-20mA, 3-15psi, or 0-10V). Offset is used with the Gain parameter to calibrate a point.
PARAMETER PAGE The Parameter page is a display in SuperVision
where a Function Blocks operating parameters can be viewed or changed. The Parameter page is composed of the settings for each microblock in the Function Block. The Function Blocks programmer can control the content and appearance of the Parameter page using special editing features in Eikon.
PARAMETER PAGE HEADER
The Parameter page header is the topmost portion of the Parameter page. The header includes general information about the function block such as its name, ID, system address, and update time. In Exec 3.x modules, the header is also used to configure and enable trends, alarms, and messages.
heating and cooling needs to each other. By using requests you can construct a software "chain" mimicking the mechanical chain of equipment in the building. When properly constructed, requests allow you to schedule terminal or zone equipment only, and allow other equipment to respond to the zone requests. Requests are communicated using Transmit and Receive microblocks, which are located in the SysIn and SysOut microblock libraries.
RUNTIME SETPOINT
A temperature value that is maintained by the HVAC equipment. Separate setpoints are determined for heating and cooling. The Status page is a display in SuperVision where the current status of a Function Blocks operating parameters can be viewed. The Function Blocks programmer can control the content and appearance of the Status page using special editing features in Eikon.
STATUS PAGE
SUPERVISION
A full-featured software package designed as a graphical HVAC system interface featuring high resolution, dynamic color graphics.
SYMBOL
A group of graphic objects (such as microblocks and wires) that are stored together in a separate file. Symbol files use the extension .sym, and can be created using Eikons Edit-Copy To menu command. Symbols can be used to store graphic programming sequences that are used in more than one Function Block, like a sequence that controls a fans operation.
CMnet or LGnet. Systems can be divided into sites. Function Blocks can only communicate with other Function Blocks that are located in the same system.
TOKEN PASS
The method used by control modules to communicate with one another on the CMnet. The gateway transmits a signal, or "token" to the first control module on the CMnet, which in turn transmits the token to the next module, and so on back to the
gateway, which begins the token pass again. When a module receives the token, it transmits data such as colors, prime variables, LAN broadcasts, and requests to other modules on the CMnet.
UPDATE TIME
The frequency at which a Function Block transmits important information to the gateway module. When the update time expires and the Function Blocks module has the token, the Function Block transmits the following information to the gateway: color, prime variable, and broadcasts from LAN Input and Output microblocks. In addition, Function Blocks that can receive heating, cooling, or run requests ask for those requests when the update time expires (and the module containing the Function Block has the token). A special line drawn in Eikon to transmit values from one microblock to another. Analog data is transferred along solid wires, and digital data is transferred along dashed wires. Wires can be connected to microblocks, labels, or other wires. When a wire cannot be drawn or should not be used, a label serves the same purpose. See also Label.
WIRE
20 Index
A
absolute value 302 actuator 87 adaptive optimal start 185, 359 preventing 202, 217 add constant to variable 295 four variables 300 three variables 300 two variables 300 address 94, 113, 359 demand controller address 125 trend address 158, 160 airflow calibration 103 airflow control 99 alarm alarm flag 162 ALC Draw 145 Alert 359 Alert event 170 enabling 170 testing 172 analog constant 131 convert from digital 255 convert to digital 254 input 69 output 83 parameter 127 status 148 trend 160 wire lock 287 and 2 input 290 3 input 290 4 input 290 5 input 291 average 301
B
BACnet 41 analog input 42 analog output 48 analog parameter 56 analog status 60 binary input 45 binary output 51 binary parameter 54 binary status 58 microblock menu 41 BACnet communication lost bias 235, 239 binary constant 130 parameter 126 status 147
123
C
capacity 191 adjusting learned capacities cooling capacity 185 heating capacity 185 learned capacity 188, 204 cell 359 218
centrifugal chiller 117 change sign 302 channel number 359 characters in OCL 335 cmnet 78, 94, 113, 359 coil 150 cold deck 119 color 183 set color 222 set color if true 223 true if color 224 comm lost 123 communication validity of 123 condensation pump 113, 135 constant binary constant 130 duty cycle 271 greater than 249 high limit 263 high signal selector 258 less than 250 low limit 262 low signal selector 259 time constant 132 true if equal to 248 control module 360 expander module 360 T-Line 76 convert menu 229 cooling capacity 185 cosine 304 counter 312 custom microblock 327
dehumidification 246 delay feedback delay 310 on break 275 on make 274 design temperature 191 dewpoint temperature calculator 246 d-gain 235, 239 digital convert from analog 254 convert to analog 255 input 71 input proof 310 output 85 output proof 310 trend 158 wire lock 286 divide two variables 301 variable by constant 298 DO/DI proof 310 Draw 145 dry bulb temperature 244, 246247 duty cycle 125, 360 constant 271 variable 273
E
economizer 244 electric meter 125 electrical demand level 125, 146 adjusting setpoints based on 194, 198, 208 demand broadcast 146 demand controller address 125 instantaneous demand 76 receive demand level 125 with adaptive optimal start 185 enthalpy 121, 150 enthalpy calculator 244
D
damper 87, 150 day 121 daylight savings time debounce time 310
313
enumerated value analog parameter 127 analog status 148 error message in OCL 347 evaporative cooling 247 exclusive or 292 Exec 360 Exec 3.x 15 Exec 4.x 15 Exec 5.x 15, 41 expander module 360 expander number 360 exponent 305
H
heating capacity 185 high limit constant 263 variable 265 high peak recorder 176 high signal constant 258 variable 260 history recorder 175 hot deck 119 hot wax valve 90 hour 121 humidity 121, 150, 244, 246247 hysteresis 249250, 252 setpoint 192
F
feedback delay 310 firmware 150, 360 floating motor output 87 for zone controller 231 free cooling 192 function block 360
I
I/O menu 67 i-gain 235, 239 input analog input 69 BACnet analog input 42 BACnet binary 45 digital input 71 LAN analog input 78, 94 LAN digital 81 LAN digital input 97 instantaneous demand 76 integrator 306 interval PID 236, 240
G
gain 361 PID gain 234 gateway 145 get system status 123 get system variable 121 global command 93, 96, 351, 361 global point 361 global variable 78, 361 graphic function block 361 greater than constant 249 variable 252
L
label 361 LAN analog input 78, 94 LAN analog output 79, 93 LAN digital input 81, 97 LAN digital output 82, 96
latch 278 learning adaptive optimal start less than constant 250 variable 253 lgnet 78, 94, 113, 362 limit menu 257 linear converter constant ratio 242 variable ratio 243 locked point 162, 171 locked value analog wire lock 287 digital wire lock 286 logarithm 305 natural log 304 logic menu 289 LogiStat zone sensor 107 setpoint adjust 108 timed local override 108 low limit constant 262 variable 264 low peak recorder 178 low signal constant 259 variable 261
187, 361
minimum on/off timer 277 minute 121 misc menu 309 modulo 301 modulo divide by constant 299 month 121 multiply two variables 301 variable by constant 297 multi-text 316 multi-zone air handling unit 119
N
natural log 304 nib 362 night setback 198, 213 non-graphic FB 93, 96 commands 351 not 292
O
occupancy 226227 adaptive optimal start 185 offset 362 operators control language 327 optimal start 183, 185 or 2 input 291 3 input 291 4 input 291 5 input 292 exclusive 292 output analog output 83 BACnet analog 48 BACnet binary 51 digital output 85 floating motor 87 LAN analog output 79, 93 LAN digital output 82, 96
M
math1 menu 293 math2 menu 303 mathematical function 293, 303 in OCL 335 maximum on timer 276 mbcode 362 menu I/O 67 message message flag 164 runtime expired message 166 microblock 362
outside air broadcast 121 broadcast validity 123 enthalpy 121, 150 humidity 121, 150 temperature 121, 150 temperature history 176, 178 override. See timed local override
P
parameter analog 127 BACnet analog 56 BACnet binary 54 binary 126 time 129 parameter page 362 header 362 p-gain 234, 238 PID direct acting 234 reverse acting 238 predefined symbols 333 prime variable 145 programming structure in OCL 342 proof 310 pulse to analog 75 pulse width transducer 90 pulse-width output 90
receive heat 115 receive heat and cool 119 receive run 113 setpoint based on 220 transmit cool 139 transmit heat 137 transmit multiple cool 143 transmit multiple heat 141 transmit run 135 round up/down 307 runtime 363 accumulated 166, 168 lead/standby based on 280 on digital output 85 runtime accumulation microblock 180 runtime expired message 165166 runtime monitor 168
S
schedule scheduler microblock 226 scheduler with override microblock 227 set alarm number 162 set color 222 set color if true 223 set message number 164 set runtime exceeded flag 166 setpoint 363 adaptive optimal start 185 adjusting remotely 198, 213 based on requests 220 hysteresis 192 preventing adjustment 202 setpoint optimization 111, 220 sign changing a numbers sign 302 sine 304 special characters in OCL 335
R
ramp 266 ratio constant 242 variable 243 relay menu 269 remainder 299, 301 request 111, 363 receive cool 117
square root 305 status analog 148 BACnet analog 60 BACnet binary 58 binary 147 report 165 system status 123 time 149 status page 363 steam boiler 113, 135 steam heat exchanger 115 subtract constant from variable 296 two variables 300 sunrise/sunset 313 SuperVision 363 schedules 226227 switch between two variables 285 normally closed to constant 284 normally closed to variable 283 symbol 363 in OCL 333 sysalarm.txt 162, 164 system 363 system variable 121 in OCL 334
timed local override 73 learned capacities and 189 scheduler with override microblock 227 timer maximum on 276 minimum on/off 277 title 329 T-Line 76 toggle 279 token 363 token pass 363 trend analog 160 digital 158 report 165 trim and respond 220 true if < constant 250 true if < variable 253 true if = constant 248 true if = variable 251 true if > constant 249 true if > variable 252 true if color 224 truncate 307
U
underscore 15 up/down counter 312 update time 113, 364
T
tangent 304 text 315 multi-text 316 tilde 15 time 121 constant 132 debounce time 310 of alarm generation 172 parameter 129 status 149
V
variable duty cycle 273 greater than 252 high limit 265 high signal 260 less than 253 low limit 264 low signal 261
system variable 121 true if equal to 251 variable declaration 329 version 318
W
wet bulb temperature calculator wire 364 247
X
xor 292 xxxalarm.txt 162, 164
Y
year 121
Z
zone controller 231 zone setpoint 190 zone setpoint - plus 198 zone setpoint - plus with learning adaptive optimal start 213 zone setpoint with demand 194 zone setpoint with demand and learning adaptive optimal start 208 zone setpoint with learning adaptive optimal start 204