LX Graphical Programming Interface (GPI) Tool

Transcription

1 Technical Bulletin Issue Date July 16, 2009 LX Graphical Programming Interface (GPI) Tool Graphical Programming Interface (GPI) Tool...16 Key Concepts GPI System Requirements...17 GPI User Interface...17 Main Menu Toolbar...18 File Edit View Build Debug Format Tools Window Help Toolbars Standard Toolbar Layout Toolbar View Toolbar Compile and Debug Programming Sheet Thumbnail display Toolbox Pane Code Library Pane Project Explorer Pane Output Pane Properties Pane Error List Pane Statistics Pane Johnson Controls, Inc. Code No. LIT

2 2 LX Graphical Programming Tool Technical Bulletin Resources Viewer Pane Detailed Procedures Getting Started on LX Platform...36 Pre-Configuration Checklist Installing the Device Configuration Wizards...36 Using the Programming Sheet...37 Resizing the Programming Sheet Displaying Multiple Pages within the Programming Sheet Adding another Page to the Programming Sheet GPI Blocks GPI Block Description...39 Advanced Configuration...40 Configure Ports Format Editor Format Drop-Down Menu Enumeration Picker...43 Format Selection...44 Edit Value Edit Mode and Value...45 View Content...46 Go To Source...46 Synchronize Bindings...46 Configure Copy From...47 Dual PID Configuration...48 PID Configuration...50 Hardware Input Configuration...52 DISCONNECTED LINEAR TRANS_TABLE Translation Table Configuration Example: Temperature Translation DIGITAL... 56

3 LX Graphical Programming Tool (GPI) Technical Bulletin 3 MULTI_LEVEL Multi-Level Table Configuration Example: HVAC Mode STD_THERMISTOR SETPOINT_OFFSET Hardware Output Configuration...63 UNASSIGNED DIGITAL PWM ANALOG_0_10V ANALOG_4_20MA Network Variable Input Configuration Network Variable Output Configuration Smart Sensor Module Configuration General Display Floating Output Configuration...71 Damper Control Configuration...72 Damper Network Variable Comparators...74 Equal Example Inputs Outputs Block Properties Not Equal Inputs Outputs Block Properties Less or Equal...77 Inputs Outputs... 77

4 4 LX Graphical Programming Tool Technical Bulletin Block Properties Greater or Equal...77 Inputs Outputs Block Properties Less Than Inputs Outputs Block Properties Greater Than...79 Inputs Outputs Block Properties Constants & Variables...80 Constant Numeric...80 Example Inputs Outputs Block Properties Constant Enum...82 Inputs Outputs Block Properties Internal Constant...83 Inputs Outputs Block Properties Variable Numeric...83 Inputs Outputs Block Properties Variable Enum...84 Inputs... 84

5 LX Graphical Programming Tool (GPI) Technical Bulletin 5 Outputs Block Properties Custom Custom Block...85 Example Inputs Outputs Block Properties Conditional Custom Block...86 Inputs Outputs Block Properties General Latch Inputs Outputs Block Properties Example Toggle Inputs Outputs Block Properties Example Hysteresis Inputs Outputs Block Properties Example Limit Inputs Outputs Block Properties Example... 94

6 6 LX Graphical Programming Tool Technical Bulletin Digital Fault Inputs Outputs Block Properties Example Numeric Fault...96 Inputs Outputs Block Properties Example Startup Inputs Outputs Block Properties Example Ramp Inputs Outputs Block Properties Example Rising Edge Inputs Outputs Block Properties Example Falling Edge Inputs Outputs Block Properties Count Up Inputs Outputs Block Properties

7 LX Graphical Programming Tool (GPI) Technical Bulletin 7 Example Count Down Inputs Outputs Block Properties Example Linear Inputs Outputs Block Properties Example Pid Inputs Outputs Block Properties Dual Pid Inputs Outputs Block Properties Example HVAC Analog Stages Inputs Outputs Block Properties Example Digital Stages Inputs Outputs Block Properties Example Digital Stages + Delay Inputs

8 8 LX Graphical Programming Tool Technical Bulletin Outputs Block Properties Example Smart Stages Inputs Outputs Block Properties Example Stages With Modulation Inputs Outputs Block Properties Optimum Start/Stop Inputs Outputs Block Properties Example Enthalpy Inputs Outputs Block Properties Example Dew Point Inputs Outputs Block Properties Example Wet Bulb Inputs Outputs Block Properties Example Inputs and Outputs...125

9 LX Graphical Programming Tool (GPI) Technical Bulletin 9 Hardware Input Inputs Outputs Block Properties Hardware Output Inputs Outputs Block Properties Network Variable Input Inputs - N/A Outputs Block Properties Network Variable Output Inputs Outputs Block Properties Floating Output Inputs Outputs Block Properties SmartSensor Module Inputs Outputs Block Properties Logic And Inputs Outputs Block Properties Example Not Inputs Outputs

10 10 LX Graphical Programming Tool Technical Bulletin Block Properties Or Inputs Outputs Block Properties Xor Inputs Outputs Block Properties Switch Inputs Outputs Block Properties Example Multiplexer Inputs Outputs Block Properties Example Math Absolute Add Average Divide Maximum Min/Max/Average Input(s) Output(s) Block Properties Minimum Input(s) Output(s) Block Properties

11 LX Graphical Programming Tool (GPI) Technical Bulletin 11 Modulus Input(s) Output(s) Block Properties Multiply Input(s) Output(s) Block Properties Subtract Inputs Outputs Block Properties Multiply Inputs Outputs Block Properties Divide Inputs Outputs Block Properties Absolute Inputs Outputs Block Properties Modulus Inputs Outputs Block Properties Summation Inputs Outputs Block Properties Example

12 12 LX Graphical Programming Tool Technical Bulletin Square Root Inputs Outputs Block Properties Example Minimum Inputs Outputs Block Properties Maximum Inputs Outputs Block Properties Average Inputs Outputs Block Properties Min/Max/Average Inputs Outputs Block Properties Example SNVT Conversions SNVT_scene Demux Inputs Outputs Block Properties Example SNVT_scene Mux Inputs Outputs Block Properties Example

13 LX Graphical Programming Tool (GPI) Technical Bulletin 13 SNVT_state Demux Inputs Outputs Block Properties Example SNVT_state Mux Inputs Outputs Block Properties Example SNVT_switch Demux Inputs Outputs Block Properties Example SNVT_switch Mux Inputs Outputs Block Properties Example Time Min On Time Inputs Outputs Block Properties Example Min Off Time Inputs Outputs Block Properties Min On Off Time Inputs Outputs

14 14 LX Graphical Programming Tool Technical Bulletin Block Properties Start Delay Inputs Outputs Block Properties Example Stop Delay Inputs Outputs Block Properties Start Stop Delay Inputs Outputs Block Properties Timer Inputs Outputs Block Properties Schedule Inputs - N/A Outputs Block Properties Real Time Clock Inputs - N/A Outputs Block Properties Tools Text Inputs - N/A Outputs - N/A Block Properties Monitor Inputs

15 LX Graphical Programming Tool (GPI) Technical Bulletin 15 Outputs - N/A Block Properties Reference Hub Inputs - N/A Outputs N/A Block Properties Reference Target Inputs - N/A Outputs-N/A Block Properties VAV Damper Control Inputs Outputs Block Properties Flow Sensor Inputs Outputs Block Properties Appendix A: Quick Start Guide Creating a New Project Developing a Control Sequence Building a Project Debugging a Project...197

16 16 LX Graphical Programming Tool Technical Bulletin Graphical Programming Interface (GPI) Tool The Graphical Programming Interface (GPI) tool makes Building Automation System (BAS) programming effortless by providing you with the building blocks necessary to meet your needs. By dragging and dropping a few block objects from the GPI tool s vast library and linking them with a simple click, select and release, you can quickly assemble common and customized programs. The GPI tool is designed to program free programmable controllers and also supports the configuration of a line of smart sensors, a series of communicating sensors with LCD display. Developed with Microsoft Windows operating system User Interface (UI) standards using Visual Basic.Net, the GPI tool provides users with an intuitive programming environment. With a dynamic range of menu windows that can be moved, docked and hidden, you can make this tool your own. The programming area is where you can develop your code and when several code segments need to be managed, new program drawing sheets can always be created and layered relative to each other. The GPI s block object toolbox supplies you with an ample collection of components and functions that you can use to create simple and more complex control sequences. If you wish to design innovative codes, you can easily create your own custom blocks. Block objects not only make coding clean and easy, but they also reduce basic errors that may arise when writing code conventionally. Furthermore, the GPI tool s smart code compiling, error-list pane and live debugger enable users to execute their codes, view input/output values and troubleshoot errors in real-time. The GPI tool supports powerful features that allow for lean, efficient and cost-effective system design. Fan-in bindings reduce programming time by comparing several variables at once. Schedules can be used to save energy and resources and can also be bound to receive information from a building automation system for optimum start sequencing. Many other features including a real-time clock, persistent values and PID loops, make the GPI tool a complete BAS programming package.

17 LX Graphical Programming Tool (GPI) Technical Bulletin 17 Key Concepts GPI System Requirements Table 1 details the GPI system requirements. Table 1: GPI System Requirements Operating System Microsoft Windows XP operating system Microsoft Windows Vista operating system Processor XP: 500 MHz or higher Vista: 1 GHz or faster Memory XP: 256 MB RAM minimum Vista: 1 GB RAM minimum Hard Drive XP: 500MB minimum free disk space Vista: 500MB minimum free disk space Display XP: Super Video Graphics Array (SVGA) 800 x 600 minimum x 768 recommended Vista: 128 MB video card minimum Accessories CD-ROM drive, mouse or other Windowscompatible pointing devices Network Interfaces LONWORKS network interface required GPI User Interface The GPI UI was developed to follow Windows UI standards. The UI employs a number of easy-to-use and dynamic utility panes and toolbars. The utility panes can be moved, docked, and/or hidden to suit the user s needs. With such versatility the user can truly configure the GPI tool to make the tool their own.

18 18 LX Graphical Programming Tool Technical Bulletin Programming Sheet Figure 1: The GPI User Interface (UI) Output pane Main Menu Bar and Toolbars Toolbox Pane 8 Project Explorer Pan 9 Error List Code Library Pane Resources Viewer Pane Properties Pane Main Menu Toolbar The Main Menu toolbar is situated at the top of the GPI tool. This toolbar contains the commands and options that are needed to manage and use the GPI. File The file menu contains functions essential for starting, saving, and managing your project.

19 LX Graphical Programming Tool (GPI) Technical Bulletin 19 Figure 2: The File Menu

20 20 LX Graphical Programming Tool Technical Bulletin Table 2: File Menu Menu Save Project New Project Import Project Export Project Add Close Page Setup Print Print Preview Print Resources Report Recent Projects Quit Description Saves the current project into the device s database. The Save Project function can also be accessed through the Standard toolbar or by pressing Ctrl+S from the keyboard. Note: Please note that the current project only pertains to the device associated with the project. When the GPI tool is started from the same device the project associated with the device appears. Starts a new project. Imports an existing GPI (*.gpi) project into the current project. The GPI project to be imported can come from a controller or a computer. Exports the current project as a.gpi file that can be saved on a controller or on a computer. Adds another drawing document to the current project. A new page tab is added to the upper left corner of the Programming sheet. The different documents of the project can be navigated through the Project Explorer pane or by selecting the desired document tab from the Programming sheet. Closes the current page of the current project. The document can be reopened through the Project Explorer pane. The Close function can also be accessed through the Standard toolbar or by pressing Ctrl+F4 from the keyboard. Opens the page setup window. The Page Setup function can also be accessed through the document Properties. Prints the current project. Selecting this command opens the Print window where the printing options, such as selecting the printer, are determined. Click OK to start the printing process. The Print function can also be accessed through the Standard toolbar or by pressing Ctrl+P from the keyboard. Opens the Print Preview window. The Print Preview window allows you to view the project as it looks after printed. The Print Preview function can also be accessed through the Standard toolbar. Opens the Resource Report Print Options window. This window can also be opened by pressing the Print Resources Report button on the Standard toolbar. Displays the most recently worked on projects. To open a project from the list, simply click on the desired list. Click Clear List to empty the list. Closes the GPI tool. The GPI prompts you to save the project if any work is unsaved. Edit The Edit menu contains commands for text and block editing. Figure 3: Edit Menu

21 LX Graphical Programming Tool (GPI) Technical Bulletin 21 Table 3: Edit Menu Menu Option Undo Redo Cut Copy Paste Duplicate Delete Select All Auto Increment Block Numbers Description Reverses an action. The Undo action can also be performed through the Standard toolbar or by pressing Ctrl+Z from the keyboard. Reapplies an action. Normally used after an action is accidentally undone (through the Undo function). The Redo action can also be performed through the Standard toolbar or by pressing Ctrl+Y from the keyboard. Removes a selected portion of text or blocks and keeps it temporarily in memory so that it can be added to another location of the project. Use the Paste function to re-add the cut text/blocks to the new location. The Cut action can also be performed through the Standard toolbar or by pressing Ctrl+X from the keyboard. Copies a selected portion of text or blocks and keeps it temporarily in memory so that it can be added to another location of the project. Use the Paste function to re-add the copied text/blocks to the new location. The Copy action can also be performed through the Standard toolbar or by pressing Ctrl+C from the keyboard. Used in conjunction with either the Cut or Copy functions. After selecting the new location for the cut/copied text/blocks use the Paste function to place the text/blocks in the new location. The Paste function can also be performed through the Standard toolbar or by pressing Ctrl+V from the keyboard. Opens the duplicate window. You can also access by Ctrl+D on the keyboard. Deletes the selected text/blocks from the Programming Sheet of the project. The Delete function can also be performed through the Standard toolbar or by pressing the Delete key from the keyboard. Selects all objects on the Programming Sheet of the current document of the project. The Select All function can also be performed through the Standard toolbar or by pressing Ctrl+A from the keyboard. When checked, increments the block number to the first available number (starting from 1 to the last available number) every time a block of the same type is either cut, copied and pasted, or duplicated on the Programming Sheet. View Use the View menu to determine what utility panes (Project Explorer, Properties) are displayed. Once displayed the View menu can then be used to select the displayed utility pane. The View menu also contains zoom functions that allow you to either zoom in or zoom out of the Programming Sheet.

22 22 LX Graphical Programming Tool Technical Bulletin Figure 4: View Menu Table 4: View Menu Menu Option Project Explorer Properties Error List Statistics Toolbox Code Library Resources Viewer Output Messages History Toolbars Zoom Zoom In Zoom Out Zoom to Page Size Description Displays the Project Explorer pane. The Project Explorer pane can also be displayed and selected through the View toolbar or by pressing the F6 key from your keyboard. Displays the Properties pane. The Properties pane can also be displayed and selected through the View toolbar or by pressing the F4 key from your keyboard. Displays the Error List pane. The Error List pane can also be displayed and selected through the View toolbar. Displays the Statistics pane. The Statistics pane can also be displayed and selected through the View toolbar. Displays the Toolbox pane. The Toolbox pane can also be displayed and selected through the View toolbar. Displays and selects the Code Library pane. This pane can also be displayed and selected by pressing the Code Library button on the View toolbar. Displays and selects the Resources View pane. This pane can also be displayed and selected by pressing the Resources Viewer button on the View toolbar. Displays and selects the Output pane. Opens the message history window. Selects which toolbars are displayed. Determines the zoom percentage of the Programming Sheet. Choose a value from the drop-down menu or simply enter the desired zoom percentage in the text box. The Zoom function can also be accessed through the View toolbar. Zooms in on the Programming Sheet. Press once to zoom in by 25%. Every time this function is used, the zoom percentage increases by 25%. The Zoom In function can also be accessed through the View toolbar or by pressing Ctrl+Shift+I from the keyboard. Zooms out of the Programming Sheet. Press once to zoom out by 25%. Every time this function is used, the zoom percentage decreases by 25%. The Zoom Out function can also be accessed through the View toolbar or by pressing Ctrl+Shift+O from the keyboard. Displays the entire Programming Sheet. The Zoom to Page Size function can also be accessed by pressing the Zoom to Page Size button on the View Toolbar.

23 LX Graphical Programming Tool (GPI) Technical Bulletin 23 Build The Build contains all the commands relevant to compile or build the project and, if all is correct, send the compiled code to the device. This menu can also be used to synchronize the database on the device with that on the computer. Figure 5: The Build Menu Table 5: Build Menu Menu Option Build Project Build And Send To Device Synchronize Generate Debug Messages Description Compiles the project and verifies the code for any errors. Any errors found are displayed in the Error List pane. The Build Project function can also be accessed through the Standard toolbar or by pressing Ctrl+B from the keyboard. Compiles the project, verifies the code for any errors, and (if all is correct) downloads the project into the device. The Build And Send To Device function can also be accessed by pressing Ctrl+Shift+B from the keyboard. Performs a comparison between the device s database and that on the computer. When selected the Device Synchronization window appears. The Synchronize function can also be accessed through the Standard toolbar or by pressing F9 from the keyboard. Generates debug messages while the project is being built. These messages are then used during the debug process. Debug Use the Debug menu to debug the project after it has been built. By debugging the code the GPI executes the project and displays debug values on each blocks output. Figure 6: Debug Menu

24 24 LX Graphical Programming Tool Technical Bulletin Table 6: Debug Menu Menu Option Start Debugging Stop Debugging Clear Debug Values Description Starts the debugging process. The debugging process continues to run until it is stopped by using the Stop Debugging command. The Start Debugging command can also be accessed through the Standard toolbar or by pressing F5 on the keyboard. Stops the debugging process. The Stop Debugging command can also be accessed through the Standard toolbar or by pressing Shift+F5 on the keyboard. Clears all debug values that were generated during the debugging of the project. Format The format menu contains functions to help you better organize and clean up a project s work space. Figure 7: Format Menu Table 7: Format Menu Menu Option Description Align Aligns two or more block objects along one of their sides. Selecting the Align function opens up a submenu that then offers the alignment options available to the user. The align options available are Left, Center, Right, Top, Middle and Bottom. The Align options can also be accessed through the Layout toolbar. Note: When you are aligning blocks, the last block selected is the reference block. This means that all the other blocks selected are aligned in reference to the reference block. Make Same Size Makes two or more blocks equal in width. After selecting the desired blocks select Make Same Size and then click Width. Note: When you are resizing blocks, the last block selected is the reference block. This means that all the other blocks selected are resized to match the width of the reference block. Spacing Makes the space between two or more blocks equidistant from each other. Selecting the Space function opens up a submenu that then offers the spacing options available to the user. The blocks can equalize their horizontal space, their vertical space, or both their horizontal and then their vertical space.

25 LX Graphical Programming Tool (GPI) Technical Bulletin 25 Tools The Tools menu contains options that define what commands and toolbars appear in the GPI interface. Figure 8: Tools Menu Table 8: Tools Menu Menu Option Device Information Customize Options Description Displays information about the selected device. Allows you to define and customize the commands and toolbars that are used and displayed by the GPI tool. Selecting Customize opens the Customize window. Opens the Options window. Options Figure 9 shows the Options window. Figure 9: Options Window Window Use the Window menu to navigate through all open projects. All open documents within project are listed in this menu. To access a document, simply click on the desired document.

26 26 LX Graphical Programming Tool Technical Bulletin Figure 10: Window Table 9: Window Menu Menu Option Description Close All Windows Closes all open projects. Help Figure 11: Help Table 10: Help Menu Menu Option Contents About Description Opens the GPI s Online Help. Displays information on the version, build number, and other attributes of the GPI tool software. Toolbars The GPI comes with four menu bars: Standard, Layout, Compile and Debug, and View menu bar. Standard Toolbar The Standard toolbar contains the most commonly used commands from the File and Edit menus. Figure 12: Standard Toolbar

27 LX Graphical Programming Tool (GPI) Technical Bulletin 27 Table 11: Standard Toolbar Button Button Name Description Add Drawing Document Allows you to add a drawing document. Import From File Save Project Print Print Preview Print Resources Report Allows you to import from a file. Saves the current project. Prints the current project. Displays a preview of the print layout for the current project. Prints the resource report. Cut Copy Paste Delete Undo Redo Start Debugging Stop Debugging Build Project Synchronize Auto Increment Block Numbers Allows you to cut the current selection. Allows you to copy the cut selection. Allows you to paste the item from the clipboard. Deletes the current selection. Erases the last action. Reapplies the last Undo. Starts the debugging process. Stops the debugging process. Builds the project. Synchronizes the current project. Determines if block numbers should be automatically incremented.

28 28 LX Graphical Programming Tool Technical Bulletin Layout Toolbar The Layout toolbar contains the Align commands found in the Format menu. For more information, see the Align commands section. Figure 13: Layout Toolbar Table 12: The Layout Toolbar Button Button Name Description Align Top Aligns the selection on the top of the screen. Align Middle Align Bottom Align Left Align Center Align Right Aligns the selection in the middle of the screen. Aligns the selection on the bottom of the screen. Aligns the selection on the left side of the screen. Aligns the selection in the center of the screen. Aligns the selection on the right side of the screen. View Toolbar The View toolbar contains the commands from the View menu. Figure 14: The View Toolbar Table 13: View Toolbar Button Button Name Description Toolbox Displays the Toolbox pane. Properties Error List Project Explorer Statistics Resources Viewer Zoom drop-down Zoom In Zoom Out Zoom to Page Size Displays the Properties pane. Displays the Error List. Displays the Project Explorer pane. Displays the Statistics. Displays the resources viewer. Allows you to select the Zoom percent. Zooms in on the current project. Zooms out of the current project. Displays the entire Programming Sheet.

29 LX Graphical Programming Tool (GPI) Technical Bulletin 29 Compile and Debug The Compile and Debug toolbar contains the commands from the Compile and Debug menu Table 14: View Toolbar Button Button Name Description Build Project Builds the project. Build and Send to Device Start Debugging Stop Debugging Synchronizing Builds the project and sends to the device. Begins debugging the project. Stops debugging the project. Synchronizes the project. Programming Sheet The Programming Sheet is the main section of the user interface where you program the device. Block objects are dragged and dropped from the Toolbox pane onto the Programming Sheet area and then linked together using the click, select, and release technique. The Programming Sheet contains a grid background and an automatic snap function that allows for easier sizing and aligning of any blocks on the sheet.

30 30 LX Graphical Programming Tool Technical Bulletin Figure 15: Programming Sheet Thumbnail display The Programming Sheet employs a dynamic Thumbnail display in the upper right corner. The Thumbnail displays your current location on the page (marked by the purple box) with a miniature representation of what you are currently viewing. The purple box can also be used to move the view to another part of the Programming Sheet simply by clicking and dragging the box around the Thumbnail display. Figure 16: Thumbnail Display

31 LX Graphical Programming Tool (GPI) Technical Bulletin 31 Toolbox Pane The Toolbox pane is where the block object library can be found. The blocks are dragged and dropped from the Toolbox pane onto the Programming Sheet. The blocks are divided into 12 different categories. Figure 17: Toolbox Pane

32 32 LX Graphical Programming Tool Technical Bulletin Code Library Pane The Code Library pane contains saved projects, code, or parts of code that you can drag and drop onto the Programming Sheet. Figure 18: Code Library Pane Project Explorer Pane The Project Explorer pane employs a tree-view list that allows easy navigation through the blocks and documents of a project. Figure 19: Project Explorer Pane

33 LX Graphical Programming Tool (GPI) Technical Bulletin 33 Double-clicking a block displayed in the Project Explorer pane selects the block on the Programming Sheet (the block appears with a blinking highlight around it) and loads the blocks properties in the Properties pane. You can transfer to another document by double-clicking on another document. Output Pane The Output pane shows background operations performed by the GPI tool, such as the progress of a build. Figure 20: Output Pane Properties Pane The Properties pane is used to define the properties of the project documents and each block object in the Programming Sheet. The specific properties displayed in the pane are also dependent on what the user selected.

34 34 LX Graphical Programming Tool Technical Bulletin Figure 21: Properties Pane Some block objects have minimal properties where only the block s name, location, and width are definable through the Properties pane. Other block objects are more complex and you cannot define the block s name, location, and width, but you can define the number of visible ports as well as more complex programming. Error List Pane The Error List pane indicates any errors that occur while building a project or control sequence. This pane assists the user to locate, troubleshoot, and debug problems. Figure 22: Error List pane The Error List pane also shows the user where exactly the problem is. Double-clicking the error message highlights the affected block. Statistics Pane After you build a project, the Statistics pane displays certain statistics such as memory usage, input and output usage, and compiling time. The information pertains to the device associated with the project.

35 LX Graphical Programming Tool (GPI) Technical Bulletin 35 Figure 23: Statistics pane Resources Viewer Pane The Resources Viewer Pane displays information about all inputs, outputs, constants, and variables in the device. You can configure and print these points from this pane. Figure 24: Resources Viewer Pane

36 36 LX Graphical Programming Tool Technical Bulletin Detailed Procedures Getting Started on LX Platform Pre-configuration Checklist Before you install a device wizard, add a device to a network database, and launch the device configuration wizard, you must follow certain steps to enable the LX Platform to support the controllers. These are the steps that must first be followed: 1. Install the LX Wizard support pack (The latest support pack can be installed by using the Johnson Controls Smart Installer software. The Smart Installer can be downloaded from the FX Workbench Installation CD ROM). 2. Connect to a platform. 3. Install the Johnson Controls LX_Support pack_x_y_z.dist distribution files through the platform Distribution File Installer. Note: x, y, and z are the version number. 4. Connect to the station. 5. Install the BCP Server under Services from the bcs palette. Installing the Device Configuration Wizards To install the device wizard: 1. Close any programs that are running on the PC. 2. Double-click the device wizard setup executable file. 3. The installation welcome screen opens. Click Next > to continue. 4. Follow the on screen instructions for any subsequent confirmation prompts that may appear (depending on whether this is a new installation of the wizard or an update). 5. Click the Finish button to complete the installation. When you update a previous version of the wizard, you are given the option to reboot the computer now or later. It is highly recommended you reboot the computer immediately and to not run other software/wizard setups before rebooting.

37 LX Graphical Programming Tool (GPI) Technical Bulletin 37 Using the Programming Sheet Resizing the Programming Sheet You can resize the Programming Sheet to match the desired size of the block coding on the sheet. Perform the following to resize the Programming Sheet: To resize the programming sheet: 1. Right-click an empty spot on the Programming Sheet and click Properties. This opens the Properties pane. Figure 25: Accessing the Properties pane 2. Enter the desired width and height in the Width and Height fields. The measurements are in pixels. Figure 26: Resizing the Properties pane

38 38 LX Graphical Programming Tool Technical Bulletin Displaying Multiple Pages within the Programming Sheet It is possible that a project contains more than one page of block coding. By default the GPI tool displays the first page of the project when started. The other pages are represented by tabs in the upper left corner of the Programming Sheet. Figure 27: Programming Sheet page tabs To access the other pages simply click on the desired page tab. The other pages also appear in the Project Explorer pane. Adding another Page to the Programming Sheet As described in Displaying Multiple Pages within the Programming Sheet section, it is possible for a project to have more than one page. To add another page to the programming sheet: 1. Select Add. 2. From the file menu, select Drawing Document or click the Add Drawing Document button. A new page tab appears in the upper left corner of the Programming Sheet.

39 LX Graphical Programming Tool (GPI) Technical Bulletin 39 GPI Blocks The GPI blocks allow you to quickly and easily assemble common and customized programs. These programs can be assembled simply by dragging and dropping the required blocks from the vast block library found in the Toolbox pane onto the Programming Sheet and then linking them together with a simple click, select, and release technique. GPI Block Description Every block found in the Toolbox pane has a unique function, though they all have the same basic elements in common. Figure 28: Block Description Typical block object components include: Block logo Block name (editable) Block type and number (if applicable) Input ports Output ports Port connection indicators (white for connected port; red for unconnected port). Only default ports have connection indicators. Default ports are always visible and cannot be hidden.

40 40 LX Graphical Programming Tool Technical Bulletin Advanced Configuration Aside from the block configuration that can be done directly to the block or through the Properties pane, every block is able to access one or more advanced configuration windows. The following is a list of all advanced configuration windows that can be opened either directly from a block or through other configuration windows: Configure Ports Format Editor Enumeration Picker Format Selection Edit Value Edit Mode and Value View Content Go To Source Synchronize Bindings Configure Copy From These advanced configuration windows can either be opened by: Right-clicking the block and selecting the advanced configuration window name or selecting the block and clicking the advanced configuration window name in the Properties pane. Figure 29: Opening Advanced Configuration Window through Block Pop-Up Menu

41 LX Graphical Programming Tool (GPI) Technical Bulletin 41 Figure 30: Opening Advanced Configuration Window through Properties Pane Configure Ports The Configure Ports window lists all the input and output ports available in the selected block. To make a port visible or hidden, simply check or uncheck the associated box. Note: Default ports cannot be unchecked or hidden. This advanced configuration window is accessible directly through all the blocks except the Text, Reference Hub, and Reference Target blocks. Figure 31: Configure Ports Window Table 15: Configure Ports Window Option Description Check All Checks all input ports If an input is selected. If an output is selected checks all output ports. Uncheck All Unchecks all input ports except default ports If an input is selected. If an output is selected, uncheck all output ports except default ports. Rename Allows you to edit the name of the selected port (applicable to Custom blocks only). Move Up Moves the selected port up one position (applicable to Custom blocks only). Move Down Moves the selected port down one position (applicable to Custom blocks only). Format Opens the Format Editor window. If the arrow is selected, the Format Drop-Down Menu opens.

42 42 LX Graphical Programming Tool Technical Bulletin Format Editor The Format Editor window provides all the formats that can be assigned to the selected output. Note: This advanced configuration window is only accessible through the Configure Ports window. Figure 32: Format Editor Window Table 16: Format Editor Window Field Description Numeric Value Assigns no format to the output and leave it as a numeric value. LonMark enumeration Enables the Select button to open the Enumeration Picker window. LonMark format Enables the Select button to open the Format Selection window. Auto select format Allows the formatted output to follow the measurement system of the project (Metric or English). If unchecked, the formatted output follows the measurement system specified by the LONMARK format (SI or US). Units Displays the units assigned to the selected output. Text Enables the drop-down menu to select a constant format or you may type in a format.

43 LX Graphical Programming Tool (GPI) Technical Bulletin 43 Format Drop-Down Menu The Format drop-down menu lists the 10 most recently used formats. Figure 33: Format Drop-Down Menu Table 17: Format Drop-Down Menu Menu Item Description Clear List Clears the list of most recently used formats. Clear Format Clears the current format of the selected output. Edit Opens the Format Editor window. Enumeration Picker The Enumeration Picker window provides all the enumerations that can be assigned to the selected output. Note: This advanced configuration window is accessible through the Format Editor window or directly through the Constant Enum and Variable Enum blocks. Figure 34: Enumeration Picker Window

44 44 LX Graphical Programming Tool Technical Bulletin Table 18: Enumeration Picker Window Field Type File Enumerations Values Description Displays a list of all available type files from the device resource file catalog (standard and manufacturer defined). The Enumerations change based on the.typ file selected. Displays a list of enumerations contained within the selected.typ file sorted by Name or Index. Displays a list of values contained within the selected enumeration sorted by Name or Value. Each value corresponds to an integer value. Format Selection The Format Selection window provides all the SNVT format types that can be assigned to the selected output. Note: This advanced configuration window is only accessible through the Format Editor window. Figure 35: Format Selection Window

45 LX Graphical Programming Tool (GPI) Technical Bulletin 45 Table 19: Format Selection Window Field Options Format File Formats Description Allows you to select the formats to be displayed; Network Variable Formats, Configuration Property Formats or both. Displays a list of all available format files from the device resource file catalog (standard and manufacturer defined). The Formats change based on the.fmt file selected. Displays a list of formats contained within the selected.fmt file sorted by Name, Field or Length. Edit Value The Edit Value window allows you to set the value of the block. For a Constant Numeric block, set any decimal value between and For a Constant Enum block, set any integer value between -128 and 12. For a Network Variable Input block, the values that can be set depend on the SNVT type of the block. Note: This advanced configuration window is accessible directly through the Constant Numeric, Constant Enum, and Network Variable Input blocks. Figure 36: Edit Value Window Edit Mode and Value The Edit Mode and Value window allows the mode and value of the block to be set. The mode can be set to either Manual, in which case the value entered remains constant, or to Automatic, in which case the value received from another block or attached device is read. For a Variable Numeric and Hardware Input block, set any decimal value between and. For a Variable Enum block, set any integer value between -128 and 12. For a Hardware Output block, set any decimal value between 0 and 100. Note: This advanced configuration window is accessible directly through the Variable Numeric, Variable Enum, Hardware Input and Hardware Output blocks.

46 46 LX Graphical Programming Tool Technical Bulletin Figure 37: Edit Mode and Value Window View Content View Content opens a Programming Sheet where you can view and create the code within Custom blocks. Note: This advanced configuration is accessible directly through the Conditional Custom and Custom blocks. Figure 38: View Content Go To Source Go To Source highlights the Reference Hub block linked to the Reference Target block. These two blocks are linked by Tag Names. Note: This advanced configuration is only accessible directly through the Reference Target block. Figure 39: View Content Synchronize Bindings Synchronize Bindings updates Network Variable Inputs (fan-in inputs) after a new binding is made. These fan-in network variable inputs use a dynamic table to record the values of the bound variables. This table needs to be refreshed every time a new binding is made in order to keep track of which values are coming from which devices.

47 LX Graphical Programming Tool (GPI) Technical Bulletin 47 Note: This advanced configuration is only accessible directly through Network Variable Input blocks Figure 40: View Content Configure Copy From The Configure window provides advanced configuration settings relevant to the selected block. Note: This advanced configuration window is accessible directly from the Dual PID, PID, Hardware Input, Hardware Output, Network Variable Input, Network Variable Output, Floating Output, SmartSensor Module, and Damper Control blocks. The Copy From window applies to blocks with the block number property. If there are multiple copies of the same type of block with different block numbers in the same project, one block can copy the configuration of another block through this window. Figure 41: Copy From Window

48 48 LX Graphical Programming Tool Technical Bulletin Dual PID Configuration The Dual PID Configuration window provides a simplified interface for specifying the PID loop using the proportional and integral parameters, as well as an advanced interface giving full control of the integral and derivative parameters. The only difference between the Dual PID block and the PID block is that the Dual PID block has two control loops that have two outputs based on two separate setpoints. Note: If the system is oscillating, start by increasing the proportional band and then increase the integral time. The Dual PID Configuration window allows the proportional gain (P) as well as integral (I) and derivative (D) parameters to be specified. The relationship between the PID parameters and the output can be summarized as follows: Figure 42: PID Output Relationship Figure 43: Dual Pid Configuration Window

49 LX Graphical Programming Tool (GPI) Technical Bulletin 49 Table 20: Dual Pid Configuration Window Field Proportional gain Integral gain Integral time Derivative gain Derivative time Dead band Bias Reverse action Description The proportional gain is the instantaneous effect of the error on the output. The proportional gain and proportional band have the following relationship: proportional gain = 200/(proportional band). For example, For a room temperature of 20ºF and a setpoint of 23ºF, the error is 3ºF. Now assume that the proportional gain is 10%/ºF. This means that the output of the PID loop is 30%. A multiplication factor that adds weight to the integral part of the PID loop. The accumulated error is multiplied by the integral gain value and contributes to the control output. If required, it is recommended to adjust the integral time and leave the integral gain equal to the proportional gain. The integral time is a factor of the effect of the error (deviation from setpoint) over time. The integral time determines how quickly the system responds to a given error. A multiplier giving weight to the derivative part of the PID loop. The derivative gain should be set to 0 (unless needed or recommended). The derivative time determines the effect of the derivative action on the system response. The derivative time is sometimes referred to as rate time. The derivative time should be set to 0 (unless needed or recommended). The dead band is a range (centered about the setpoint) in which no corrective action is taken; for example, the output of the PID loop remains the same. For example, If the dead band is set to 0.4 F (±0.2 F), then the output of the PID loop does not change if the input deviates by less than 0.2 F from the setpoint. The bias is the default percentage of the output upon reset of the device. It is a constant value that is applied to the control loop to correct offsets; for example, a type of manual reset. If checked, the control loop acts in reverse. Thus, an increase in the error is inversely proportional to the increase in the output (the more positive the error; the more negative the output). If unchecked, the control loop acts directly. Thus, an increase in the error is directly proportional to the increase in the output (the more positive the error; the more positive the output).

50 50 LX Graphical Programming Tool Technical Bulletin Note: Derivative control is generally not used in HVAC control systems due to the slow reaction time of the input and slow reaction of the equipment. PID Configuration The PID Configuration window provides a simplified interface for specifying the PID loop using the proportional and integral parameters, as well as an advanced interface, giving full control of the integral and derivative parameters. Note: If the system is oscillating, start by increasing the proportional band and then increase the integral time. The PID Configuration window allows the proportional gain (P) as well as integral (I) and derivative (D) parameters to be specified. The relationship between the PID parameters and the output can be summarized as follows: Figure 44: PID Output Relationship Figure 45: Pid Configuration Window

51 LX Graphical Programming Tool (GPI) Technical Bulletin 51 Table 21: Pid Configuration Window Field Proportional gain Integral gain Integral time Derivative gain Derivative time Dead band Bias Reverse action Description The proportional gain is the instantaneous effect of the error on the output. The proportional gain and proportional band have the following relationship: proportional gain = 200/(proportional band). For example, for a room temperature of 20ºF and a setpoint of 23ºF, the error is 3ºF. Now assume that the proportional gain is 10%/ºF. This means that the output of the PID loop is 30%. A multiplication factor that adds weight to the integral part of the PID loop. The accumulated error is multiplied by the integral gain value and contributes to the control output. If required, it is recommended to adjust the integral time and leave the integral gain equal to the proportional gain. The integral time is a factor of the effect of the error (deviation from setpoint) over time. The integral time determines how quickly the system responds to a given error. A multiplier giving weight to the derivative part of the PID loop. The derivative gain should be set to 0 (unless needed or recommended). The derivative time determines the effect of the derivative action on the system response. The derivative time is sometimes referred to as rate time. The derivative time should be set to 0 (unless needed or recommended). The dead band is a range (centered about the setpoint) in which no corrective action is taken; for example, the output of the PID loop remains the same. For example, If the dead band is set to 0.4 F (±0.2 F), then the output of the PID loop does not change if the input deviates by less than 0.2 F from the setpoint. The bias is the default percentage of output upon reset of the device. It is a constant value that is applied to the control loop to correct offsets; for example, a type of manual reset. If checked, the control loop acts in reverse. Thus, an increase in the error is inversely proportional to the increase in the output (the more positive the error; the more negative the output). If unchecked, the control loop acts directly. Thus, an increase in the error is directly proportional to the increase in the output (the more positive the error; the more positive the output). Note: Derivative control is generally not used in HVAC control systems due to the slow reaction time of the input and slow reaction of the equipment

52 52 LX Graphical Programming Tool Technical Bulletin Hardware Input Configuration The Hardware Input Configuration window provides all the settings required to configure any type of hardware input including sensors, switches, and contacts, for example. Depending on the Signal interpretation selected, the options available under Settings vary. DISCONNECTED The hardware input is not used. Figure 46: Hardware Input Configuration Window Disconnected LINEAR A linear curve is used to interpret a voltage (0-10V), current (4-20mA) or resistance (0-10kΩ) input signal. Figure 47: Hardware Input Configuration Window Linear

53 LX Graphical Programming Tool (GPI) Technical Bulletin 53 Table 22: Hardware Input Configuration Window - Linear Field Signal type Offset Input min Input max Min value Max value Use filter Description This parameter determines the input signal type of the connected sensor. The following signal types are supported: RESISTANCE: Resistance input, typically 0-10kΩ VOLTAGE_0_10V: Voltage input, 0-10V MILIAMPS_4_20MA: Current input, 4-20mA (DC) Note: If the input value falls out of the expected input range, it is interpreted as the lower or upper value of the range. For example, if the input is 3.5mA, then it is rounded up to 4mA and if the input is 21mA, then it is clipped at 20mA. Note: Exceeding the upper limits for current and voltage may damage the controller. For current inputs (4-20mA), any input below 3.5mA causes an electrical fault. For resistance inputs (0-10kΩ), if disconnected (+inf Ω) it causes an electrical fault. The offset is a constant value that is applied to the sensor input reading to compensate for reading errors; for example, to perform sensor calibration. For example, assume that a temperature sensor is connected to one of the hardware inputs. If the actual room temperature is 72ºF but the sensor reading is 74ºF, an offset of -2ºF can be applied to correct the error. The Input min is used to correlate with the Min value to create the lower point of the linear interpolation curve that is used to interpret the raw input reading. The Input max is used to correlate with the Max value to create the higher point of the linear interpolation curve that is used to interpret the raw input reading. The Min value is used to correlate with the Input min to create the lower point of the linear interpolation curve that is used to interpret the raw input reading. The Max value is used to correlate with the Input max to create the higher point of the linear interpolation curve that is used to interpret the raw input reading. For example, if there is a resistance input (0-10kΩ) and an Input min of 2000Ω, an Input max of 8000Ω, a Min value of 60ºF and a Max value of 80ºF are set, then 2000Ω corresponds to 60ºF and 8000Ω corresponds to 80ºF. If checked, the input signal is filtered from any noise or distortion caused by the input wires running too close to an electrical source. TRANS_TABLE A translation table is applied to the input. A user-defined curve can be setup to interpret the input signal in the Translation Table Configuration window. A curve is generated based on the points defined and is interpolated linearly.

54 54 LX Graphical Programming Tool Technical Bulletin Figure 48: Hardware Input Configuration Window Translation Table Table 23: Translation Table Field Signal type Offset Trans Table Use filter Description Determines the input signal type of the connected sensor. The following signal types are supported: RESISTANCE: Resistance input, typically 0-10kΩ VOLTAGE_0_10V: Voltage input, 0-10V MILIAMPS_4_20MA: Current input, 4-20mA (DC) Note: Exceeding the upper limits for current and voltage may damage the controller. For current inputs (4-20mA), any input below 3.5mA causes an electrical fault. For resistance inputs (0-10kΩ), if disconnected (+inf Ω) it causes an electrical fault. Display a constant value that is applied to the sensor input reading to compensate for reading errors; for example, to perform sensor calibration. For example, assume that a temperature sensor is connected to one of the hardware inputs. If the actual room temperature is 72ºF but the sensor reading is 74ºF, an offset of -2ºF can be applied to correct the error. Opens the Translation Table Configuration window. If checked, the input signal is filtered from any noise or distortion caused by the input wires running too close to an electrical source. Translation Table Configuration The translation table consists of 16 rows used to define a curve that converts the raw input value (ma, V, Ω) into the appropriate units of measurement (for example, ºF). The curve is interpolated linearly based on the values entered. It is not necessary to fill out all the rows since a linear curve is generated automatically between each pair of points and interpolated/extrapolated as required.

55 LX Graphical Programming Tool (GPI) Technical Bulletin 55 Note: The values in the Input value column must be in ascending order, otherwise the conversion is incorrect. Example: Temperature Translation The following example illustrates how a translation table can translate a thermistor s resistance values into temperature values. The following graph and window display the data points. Input Value vs. Translated Input Translated Input Input Value Figure 49: Graph of Temperature Translation Figure 50: Translation Table Configuration Window

56 56 LX Graphical Programming Tool Technical Bulletin Table 24: Translation Table Field Input Value (ma, V or Ω) Output Value Description Displays the raw hardware input reading. Must be in ascending order. Displays the converted input value. DIGITAL Figure 51: Hardware Input Configuration Window Digital

57 LX Graphical Programming Tool (GPI) Technical Bulletin 57 Table 25: Digital Field Signal type Normal digital input Pulse count input Description This parameter determines the input signal type of the connected sensor. The following signal types are supported: RESISTANCE: Resistance input, typically 0-10kΩ VOLTAGE_0_10V: Voltage input, 0-10V MILIAMPS_4_20MA: Current input, 4-20mA (DC) Note: Exceeding the upper limits for current and voltage may damage the controller. For current inputs (4-20mA), any input below 3.5mA causes an electrical fault. For resistance inputs (0-10kΩ), if disconnected (+inf Ω) it causes an electrical fault. A normal digital two-state (On/Off) input such as a light switch, occupancy contact, window, and contact, for example. A Pulse count input is comprised of a rising edge and a falling edge. Therefore, the value of a pulse count input is equal to the summation of all pulse cycles and is based on the following equation: Pulse count input value = (# of rising edges x value of rising edge) + (# of falling edges x value of falling edge) For example, a pulse count input has been configured with a rising edge value of 5 and a falling edge value of 0. After four pulse cycles the value of the input is as follows (as based on the previous equation): (4 x 5) + (4 x 0) = 20. ON Value OFF Value Reverse The value of the block when the input is ON. The value of the NVO when the input is OFF. The input is normally ON when the contact is closed and OFF when it is open. When the reverse option is checked, the input is ON when the contact is open and OFF when it is closed. MULTI_LEVEL A translation table is applied to the input. A user-defined function can be setup to interpret the signal in the Multi Level Table Configuration window. A step function is generated based on the points defined.

58 58 LX Graphical Programming Tool Technical Bulletin Figure 52: Hardware Input Configuration Window Multi Level Table 26: Multi Level Field Signal type Trans Table Description Determines the input signal type of the connected sensor. The following signal types are supported: RESISTANCE: Resistance input, typically 0-10kΩ VOLTAGE_0_10V: Voltage input, 0-10V MILIAMPS_4_20MA: Current input, 4-20mA (DC) Note: Exceeding the upper limits for current and voltage may damage the controller. For current inputs (4-20mA), any input below 3.5mA causes an electrical fault. For resistance inputs (0-10kΩ), if disconnected (+inf Ω) it causes an electrical fault. This button opens the Mutli-Level Table Configuration window. Multi-Level Table Configuration The multi-level table consists of 16 rows used to define a function that converts the raw input value (ma, V, Ω) into the appropriate level. The function is interpolated based on the values entered. It is not necessary to fill out all the rows since a step function is automatically generated between each pair of points and interpolated/extrapolated as required. Note: The values in the Input Value column must be in ascending order, otherwise the conversion is incorrect.

59 LX Graphical Programming Tool (GPI) Technical Bulletin 59 Example: HVAC Mode The following example illustrates how a multi-level table can assign a thermistor s resistance values to a corresponding level. Each level corresponds to a particular HVAC mode as follows: -1 = HVAC_NUL, 0 = HVAC_AUTO, 1 = HVAC_HEAT, 3 = HVAC_COOL, 6 = HVAC_OFF. The following graph and window display the data points that have been used. Translated Input Input Value vs. Translated Input HVAC_NUL HVAC_AUTO HVAC_HEAT Input Value HVAC_COOL HVAC_OFF Figure 53: Graph of HVAC Mode Translation

60 60 LX Graphical Programming Tool Technical Bulletin Field Figure 54: Multi-Level Table Configuration Window Input Value (ma, V or Ω) Output Value Description The raw hardware input reading. Must be in ascending order. The converted input value. STD_THERMISTOR Predefined translation tables that apply to the standard type thermistors that are used within sensors. Figure 55: Hardware Input Configuration Standard Thermistor

61 LX Graphical Programming Tool (GPI) Technical Bulletin 61 Table 27: Standard Thermistor Field Signal type Offset Min value Max value Thermistor type Use filter Description Determines the input signal type of the connected sensor. The following signal types are supported: RESISTANCE: Resistance input, typically 0-10kΩ VOLTAGE_0_10V: Voltage input, 0-10V MILIAMPS_4_20MA: Current input, 4-20mA (DC) Note: Exceeding the upper limits for current and voltage may damage the controller. For current inputs (4-20mA), any input below 3.5mA causes an electrical fault. For resistance inputs (0-10kΩ), if disconnected (+inf Ω) it causes an electrical fault. Displays a constant value that is applied to the sensor input reading to compensate for reading errors; for example, to perform sensor calibration. for example, assume that a temperature sensor is connected to one of the hardware inputs. If the actual room temperature is 72ºF but the sensor reading is 74ºF, an offset of -2ºF can be applied to correct the error. Correlates with a value in a pre-defined translation table to create the lower point that is used to interpret the raw input reading. The Max value is used to correlate with a value in a pre-defined translation table to create the upper point that is used to interpret the raw input reading. For example, if a Min value and Max value are set, then the predefined translation table is cut off at those values. So if a Min value of 32ºF and a Max value of 122ºF are set, then the input value never passes these limits even if the sensed value reads values higher or lower than the maximum or minimum value respectively. Determines the thermistor type being used. The following thermistor types are supported: PT100, PT1000, 10K Type II and 10K Type III. If checked, the input signal is filtered from any noise or distortion caused by the input wires running too close to an electrical source. SETPOINT_OFFSET An offset input (±) that is applied to the heating and cooling setpoints. Figure 56: Hardware Input Configuration Window Setpoint Offset

62 62 LX Graphical Programming Tool Technical Bulletin Table 28: Setpoint Offset Field Signal type Input min Input max Min value Max value Description Determines the input signal type of the connected sensor. The following signal types are supported: RESISTANCE: Resistance input, typically 0-10kΩ VOLTAGE_0_10V: Voltage input, 0-10V MILIAMPS_4_20MA: Current input, 4-20mA (DC) Note: If the input value falls out of the expected input range, it is interpreted as the lower or upper value of the range. For example, if the input is 3.5mA, then it is rounded up to 4mA and if the input is 21mA, then it is clipped at 20mA. Note: Exceeding the upper limits for current and voltage may damage the controller. For current inputs (4-20mA), any input below 3.5mA causes an electrical fault. For resistance inputs (0-10kΩ), if disconnected (+inf Ω) it causes an electrical fault. The Input min is used to correlate with the Min value to create the lower point of the linear interpolation curve that is used to interpret the raw input reading. The Input max is used to correlate with the Max value to create the higher point of the linear interpolation curve that is used to interpret the raw input reading. The Min value is used to correlate with the Input min to create the lower point of the linear interpolation curve that is used to interpret the raw input reading. The Max value is used to correlate with the Input max to create the higher point of the linear interpolation curve that is used to interpret the raw input reading. For example, if there is a resistance input (0-10kΩ) and an Input min of 2000Ω, an Input max of 8000Ω, a Min value of -10ºF and a Max value of 10ºF are set, then 2000Ω corresponds to -10ºF and 8000Ω corresponds to 10ºF.

63 LX Graphical Programming Tool (GPI) Technical Bulletin 63 Hardware Output Configuration The Hardware Output Configuration window provides all the settings required to configure any type of hardware output including fans, heating/cooling systems, and lights, for example. Depending on the Signal type selected, the options available under Settings vary. UNASSIGNED Figure 57 Hardware Output Configuration Window Unassigned DIGITAL Figure 58: Hardware Output Configuration Window Digital Table 29: Digital Configuration Window Field Description Reverse Check this box to invert the output. This option is useful when using equipment that uses negative logic.

64 64 LX Graphical Programming Tool Technical Bulletin PWM Figure 59: Hardware Output Configuration Window PWM Table 30: PWM Configuration Window Field Min value Max value PWM period Reverse Description The minimum value that is allowed for PWM outputs. The maximum value that is allowed for PWM outputs. Note: The input value from nvihwoutputx (x = output number) is rescaled between these min and max outputs. Used to specify the PWM period. Lowering the default value results in a faster response and provides a more stable temperature when using perimeter heating. However, it must be ensured that the PWM period is not too low (fast) for the equipment. Check this box to invert the output. This option is useful when using equipment that uses negative logic.

65 LX Graphical Programming Tool (GPI) Technical Bulletin 65 ANALOG_0_10V Figure 60: Hardware Output Configuration Window Analog 0-10V Table 31: Analog Configuration Window Field Min value Max value Reverse Description The minimum value that is allowed for Analog outputs. The maximum value that is allowed for Analog outputs. Note: The input value from nvihwoutputx (x = output number) is rescaled between these min and max outputs. Check this box to invert the output. This option is useful when using equipment that uses negative logic. ANALOG_4_20MA Figure 61: Hardware Output Configuration Window Analog 4-20mA Table 32: Analog Configuration Window Field Description Min value The minimum value that is allowed for Analog outputs. Max value The maximum value that is allowed for Analog outputs. Note: The input value from nvihwoutputx (x = output number) is rescaled between these min and max outputs. Reverse Check this box to invert the output. This option is useful when using equipment that uses negative logic.

66 66 LX Graphical Programming Tool Technical Bulletin Network Variable Input Configuration The Network Variable Input Configuration window allows the maximum receive time and persistent state to be specified. Figure 62: Network Variable Input Configuration Window Table 33: Network Variable Input Configuration Window Field Max receive time Persistent Description The maximum time period between received updates of the network variable on the network (whether or not the variable's value has changed). The maximum receive time is also known as the heartbeat. A max receive time failure occurs if a network variable update is not received on the network within the time period set in the textbox. On a max receive time failure, the device goes into alarm, the device status is updated to indicate a failure and the NVI returns to its default value. The appropriate alarm and status bits are updated on a max receive time failure. When a network variable is marked as persistent, the network variable value is written to the EEPROM. Once written to the EEPROM, the network variable value is preserved during power failures and resets. Every time a new network variable value is received, the new value is written into the EEPROM. Note: If the network variable is constantly changing and if it is received from the network on every change, the network variable could exhaust the ability of the EEPROM to store it in permanent memory. Therefore do not select the persistent option if the NVI is being polled. Note: When the persistent option is selected, the current value of the NVI is not written to the EEPROM. The device waits until the NVI changes value (next value) before saving it. The persistent option is ignored for NVIs that are bound.

67 LX Graphical Programming Tool (GPI) Technical Bulletin 67 Network Variable Output Configuration The Network Variable Output Configuration window allows the minimum and maximum send times to be specified. Network congestion occurs when network variables are transmitted too frequently on the network. Network congestion can be reduced by only transmitting network variables as frequently as is necessary to meet the system requirements. Figure 63: Network Variable Output Configuration Window Table 34: Network Variable Output Configuration Window Field Description Min send time The minimum time period that must pass between network variable updates on the network. If the value of the network variable changes, an update is only sent after this time expires. Setting the min send time to 0 disables it. The min send time is often referred to as the throttle. Max send time The maximum time period between automatic transmissions of the network variable on the network (whether or not the variable's value has changed). Setting the max send time to 0 disables it. The max send time is often referred to as the heartbeat. Smart Sensor Module Configuration The Smart Sensor Module Configuration window provides all the settings required to configure any type of Smart-Sensor. Depending on the Smart Sensor Type selected, the options available vary.

68 68 LX Graphical Programming Tool Technical Bulletin General Figure 64: Smart Sensor Module Configuration Window General

69 LX Graphical Programming Tool (GPI) Technical Bulletin 69 Table 35: General Module Selection Field Module type Enable all buttons override Offset Setpoint read only Setpoint Description Select the type of Smart-Sensor to be configured. The following Smart-Sensor types are supported: LN-VSTAT and LN-PSTAT. This is not enabled for the LN-VSTAT and LN-PSTAT. The offset is a constant value that is applied to the sensor input reading to compensate for reading errors; for example, to perform sensor calibration. If unchecked, the setpoint is adjustable by room occupants. If checked, the setpoint is read-only. Select either a setpoint offset or absolute setpoint input. The Absolute setpoint option allows the midpoint to be set between the Min range and Max range values. The midpoint can be varied between these limits by pressing the DOWN and UP arrow buttons on the Smart-Sensor. Midpoint Definition: The midpoint is the median value between the cooling and heating setpoints. If an occupant changes the midpoint, the cooling and heating setpoints change by the same value. The following diagram illustrates the relation between the midpoint and the heating/cooling setpoints. In this example, the range between the heating and cooling setpoints is 2ºC and the midpoint is 21ºC. Min range Max range Hvac Mode Options Fan Speed Options If the HVAC mode is in cooling, the effective setpoint (for example, the actual setpoint) is the cooling setpoint. Similarly, if the HVAC mode is in heating, the effective setpoint is the heating setpoint. The heating and cooling setpoints can be set to the same value to create a single setpoint. This can be useful for a fan coil unit (FCU) in a hotel room, where the requirements are basic and ease of use is important. The Offset from setpoint option allows the effective setpoint to be lowered below the heating or cooling setpoint by an amount equal to the Min range value or raised above the heating or cooling setpoint by an amount equal to the Max range value. The setpoint can be varied between these limits by pressing the DOWN and UP arrow buttons on the Smart-Sensor. This field is used to specify the value of the minimum setpoint offset or absolute setpoint. This field is used to specify the value of the maximum setpoint offset or absolute setpoint. Check the HVAC modes that are available to the Smart-Sensor to be initiated. Check the fan speeds that are available to the Smart-Sensor to be initiated.

70 70 LX Graphical Programming Tool Technical Bulletin Display Figure 65: Smart Sensor Module Configuration Window Rolling Display

71 LX Graphical Programming Tool (GPI) Technical Bulletin 71 Table 36: Display Options Field Rolling display/static display Room temp Setpoint Welcome message HVAC Mode Occupancy State Fan Speed Welcome Message Custom x (x = 1-5) Number of Decimals Description Units Description If Rolling display is selected, each item checked in the Rolling Display Options field and Custom Values field is shown in a Rolling display on the Smart Sensor. If Static display is selected, only the item selected in the Static Display options is shown on the Smart Sensor. If checked, the room temperature is displayed on the rolling display of the Smart-Sensor. If checked, the setpoint is displayed on the rolling display of the Smart-Sensor. If checked, the welcome message is displayed on the rolling/static display of the Smart-Sensor. If checked, The HVAC mode is displayed on the rolling display of the Smart Sensor. Only available if Rolling display is selected. Only available if Rolling display is selected. If checked, the occupancy state is displayed on the rolling display of the Smart Sensor. If checked, the occupancy state is displayed on the rolling display of the Smart Sensor. Only available if Rolling display is selected. Enter the welcome message (8 characters per line maximum length). If checked, the custom item is displayed on the rolling display of the Smart-Sensor Custom inputs usually receive values from hardware inputs connected to the controller or through network variable outputs over the network. Specify the number of decimals in the custom value between 0, 1, and 2. Enter the description of the custom value (8 character maximum). Enter the units of the custom value. Floating Output Configuration The Floating Output Configuration window provides all the settings required to configure a floating output. Figure 66: Floating Output Configuration Window

72 72 LX Graphical Programming Tool Technical Bulletin Table 37: Floating Output Configuration Window Field Open Close Min pulse on Min pulse off Drive time On init resync Description Select which hardware output is used to move the actuator to the open position. Select which hardware output is used to move the actuator to the closed position. Note: Consecutive hardware outputs must be chosen for the Open and Close settings. This field defines the minimum amount of time for which the actuator can move. This field defines the minimum amount of time during which the actuator cannot move. This field defines the amount of time it takes for the actuator to go from being fully closed to fully open or vice-versa. When the device is reset or when the floating output is set back to automatic control from override, the actuator needs to be resynchronized. Select whether the output should be made fully open or fully closed on resynchronization. Damper Control Configuration The Damper Control Configuration window provides all the settings required to configure a damper. Damper Figure 67: Damper Control Configuration Window Damper

73 LX Graphical Programming Tool (GPI) Technical Bulletin 73 Table 38: Damper Field Damper type Initialize Damper Drive time Damper response Direction Description Select whether the internal or an external damper is being used. Resets the damper position and calculates the total number of steps between the stops. Use this option if the mechanical stops on the actuator have been moved to limit the range of movement of the damper. Note: The actuator mechanical stops should be moved only to limit damper movement from going under 0% or over 100%. Used to specify the time that the damper takes to go from the fully closed position to the fully open position or vice-versa. The damper drive time can be set to between 45 seconds and 150 seconds. However, we recommend using the default value of 95 seconds for the built-in actuator. For the built-in actuator in normal control, the lower the drive time is set, the faster the actuator moves from fully open to fully closed and vice versa. Likewise, the higher the drive time is set, the slower the actuator moves from fully open to fully closed and vice versa. A multiplier (in %) applied to the calculated damper movement. It is used to adjust the reaction speed of the damper. For example, the controller determines that the damper should move for 30 seconds to achieve the desired setpoint. If the damper response is set to 20%, the damper moves for 6 seconds (20% X 30 seconds). The controller waits for a few seconds and performs a new calculation to determine how much to move the damper. This iterative process prevents the damper from overshooting and prevents hunting (oscillations). Minimizing hunting reduces wear on the damper actuator and also minimizes irregular flow. Used to specify the direction (Clockwise or Counter Clockwise) in which the actuator rotates to open the damper. Network Variable Figure 68: Damper Control Configuration Window Network Variable

74 74 LX Graphical Programming Tool Technical Bulletin Table 39: Network Variable Field Min send time Max send time Description The minimum time period that must pass between network variable updates on the network. If the value of the network variable changes, an update is only sent after this time expires. Setting the min send time to 0 disables it. The min send time is often referred to as the throttle. The maximum time period between automatic transmissions of the network variable on the network (whether or not the variable's value has changed). Setting the max send time to 0 disables it. The max send time is often referred to as the heartbeat. Comparators Comparators are blocks that evaluate two numeric inputs using a particular function (=,, <,, > and ). The block outputs whether the comparison is true (1) or false (0) relative to the function used. The following blocks are available in this category: Equal Not Equal Less or Equal Greater or Equal Less Than Greater Than Equal Description: The output is true (1) if input 1 is equal to input 2 (input 1 = input 2). The output is false (0) if input 1 is not equal to input 2 (input 1 input 2). Example Comparators are very basic blocks that are often implicitly incorporated within other more complex blocks. However, they are useful when building simple control sequences. The following example shows how an Equal and Less Than block is used to control a Baseboard (Hardware Output block) through the use of an And block, Schedule block, schedule setpoint (Internal Constant block), Room Temperature, and Setpoint (Hardware Input blocks) inputs.

75 LX Graphical Programming Tool (GPI) Technical Bulletin 75 Inputs Figure 69: Comparators Example The Equal block compares the occupancy from the Schedule block to the set occupancy from the Internal Constant block. Thus, the output of the Equal block is only TRUE when the occupied mode is scheduled. Similarly, the Less Than block compares the Room Temperature from a Hardware Input block to a Setpoint also from a Hardware Input block. Therefore, the output of the Less Than block is only TRUE when the Room Temperature is below the Setpoint. The And block checks the outputs of the Equal and Less Than blocks; and only when both conditions are TRUE, does the Output of the And block become TRUE and turn the Baseboard (Hardware Output block) ON. Inputx (x=1-2) Numeric Input of the block. The two values that are compared.

76 76 LX Graphical Programming Tool Technical Bulletin Outputs Output Digital 0 or 1 Output of the block. The result of the comparison. Block Properties Type Range Default Description (Name) String Unlimited Equal Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Not Equal Description: The output is true (1) if input 1 is not equal to input 2 (input 1 input 2). The output is false (0) if input 1 is equal to input 2 (input 1 = input 2). Inputs Inputx (x=1-2) Numeric Input of the block. The two values that are compared. Outputs Output Digital 0 or 1 Output of the block. The result of the comparison. Block Properties Type Range Default Description (Name) String Unlimited Not Equal Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

77 LX Graphical Programming Tool (GPI) Technical Bulletin 77 Less or Equal Description: The output is true (1) if input 1 is less than or equal to input 2 (input 1 input 2). The output is false (0) if input 1 is greater than input 2 (input 1 > input 2). Inputs Inputx (x=1-2) Numeric Input of the block. The two values that are compared. Outputs Output Digital 0 or 1 Output of the block. The result of the comparison. Block Properties Type Range Default Description (Name) String Unlimited Less Or Name of the block. Equal Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Greater or Equal Description: The output is true (1) if input 1 is greater than or equal to input 2 (input 1 input 2). The output is false (0) if input 1 is less than input 2 (input 1 < input 2). Inputs Inputx (x=1-2) Numeric Input of the block. The two values that are compared.

78 78 LX Graphical Programming Tool Technical Bulletin Outputs Output Digital 0 or 1 Output of the block. The result of the comparison. Block Properties Type Range Default Description (Name) String Unlimited Greater Or Equal Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Less Than Description: The output is true (1) if input 1 is less than input 2 (input 1 < input 2). The output is false (0) if input 1 is greater than or equal to input 2 (input 1 input 2). Inputs Inputx (x=1-2) Numeric Input of the block. The two values that are compared. Outputs Output Digital 0 or 1 Output of the block. The result of the comparison. Block Properties Type Range Default Description (Name) String Unlimited Less Name of the block. Than Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

79 LX Graphical Programming Tool (GPI) Technical Bulletin 79 Greater Than Description: The output is true (1) if input 1 is greater than input 2 (input 1 > input 2). The output is false (0) if input 1 is less than or equal to input 2 (input 1 input 2). Inputs Inputx (x=1-2) Numeric Input of the block. The two values that are compared. Outputs Output Digital 0 or 1 Output of the block. The result of the comparison. Block Properties Type Range Default Description (Name) String Unlimited Greater Name of the block. Than Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

80 80 LX Graphical Programming Tool Technical Bulletin Constants & Variables Constants are blocks that are mostly used to configure set values that may need to be available to an HMI such as setpoints, delays, and limits, for example. Variables are blocks that are mostly used to monitor changing values or calculate new values using old values that may need to be available to an HMI. There are two types of constant and variable blocks. Numeric blocks output any decimal number between and. They can be used for several purposes including creating setpoints, making calculations, and monitoring values, for example. Enumeration (enum) blocks output any integer value from -128 to 127. They are often used to correspond to various equipment modes (HVAC, fan, and occupancy, for example) or as two-state Boolean values representing true or on with a value of 1 and false or off with a value of 0. There is also another type of constant block. The Internal Constant block is used within the program only and is not exposed to the network or an HMI. This block can be either numeric or enum and are often used for math calculations. All the variables are exposed to the network. The following blocks are available in this category: Constant Numeric Constant Numeric Constant Enum Internal Constant Variable Numeric Variable Enum Example Constants & Variables are blocks that are used to set and monitor values. These values are either used for internal calculation only or they can be exposed to the network. The following example shows how Constant Numeric and Internal Constant blocks can be used to assign limits for supply air and outdoor air temperature through the use of Linear and Limit blocks. The Supply Air Temperature Setpoint is then calculated and sent to a Variable Numeric block based on an Outdoor Air Temperature value received from a Hardware Input block. Figure 70: Constants & Variables Example

81 LX Graphical Programming Tool (GPI) Technical Bulletin 81 The Internal Constant blocks set the outdoor air temperature limits, which are not required to change. The Constant Numeric blocks set the supply air temperature limits, which can be changed through an HMI over the network. The Linear block then creates a linear interpolation based on these limits and the Limit block sets the values received from the Constant Numeric blocks as outdoor air temperature limits. The Hardware Input block sends the value of the Outdoor Air Temperature and the Supply Air Temperature Setpoint is calculated and outputted by the Limit block to the Variable Numeric block where it can be monitored by an HMI over the network. Description: Mainly used for adjustable setpoint values or for constant values requiring monitoring. These blocks are available in 4 structured network constant inputs (NCI). ncicstnum1_7, ncicstnum8_14, ncicstnum15_21 and ncicstnum22_28 contain constant numeric blocks Number of Blocks: 28 Advanced Configuration: Set Value Inputs N/A Outputs Output Numeric Output of the block. The set constant value. Block Properties Type Range Default Description (Name) String Unlimited Constant Name of the block. Numeric Description String Unlimited - Description of the block. Number Menu See Description Constant Numeric 1 The number of blocks available. Use the drop-down menu to select from the 28 available blocks. Note: When a new Constant Numeric block is added to the drawings, the block s number is incremented to the next available block number. Value Numeric Value of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

82 82 LX Graphical Programming Tool Technical Bulletin Constant Enum Description: Mainly used for adjustable mode values or for constant values requiring monitoring. They can be formatted to any standard enumeration or to Boolean values (true or false). These blocks are available in a structured network constant input (NCI). ncicstenum1_31 contains constant enum blocks Number of blocks: 31 Advanced Configuration: Set Value, Select Enumeration Inputs N/A Outputs Output Enum Output of the block. The set constant value. Block Properties Type Range Default Description (Name) String Unlimited Constant Name of the block. Enum Description String Unlimited - Description of the block. Number Menu See Description Constant Enum 1 The number of blocks available. Use the drop-down menu to select from the 31 available blocks. Note: When a new Constant Enum block is added to the drawings, the block s number is incremented to the next available block number. Value Enum Value of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

83 LX Graphical Programming Tool (GPI) Technical Bulletin 83 Internal Constant Description: Mainly used for internal math processing, internal mode changes or for constant values not requiring monitoring. They can be formatted to any standard enumeration or to Boolean values (true or false). Note: When this block is modified, the code must be recompiled. Inputs N/A Outputs Output Numeric Output of the block. The set constant value. Block Properties Type Range Default Description Description String Unlimited - Description of the block. Value Numeric Value of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Variable Numeric Description: Mainly used for variable values requiring monitoring. These blocks are available in 5 structured network variable outputs (NVO). nvovarnum1_7, nvovarnum8_14, nvovarnum15_21, nvovarnum22_28, nvovarnum29_35, contains variable numeric blocks Number of blocks: 35 Advanced Configuration: Set Mode Inputs Input Numeric Input of the block. The read value.

84 84 LX Graphical Programming Tool Technical Bulletin Outputs Output Numeric Mode Digital 0 or 1 Mode of the input: Block Properties Output of the block. The read (Automatic) value or set (Manual) value. 0 = Automatic 1 = Manual Type Range Default Description (Name) String Unlimited Variable Name of the block. Numeric Description String Unlimited - Description of the block. Number Menu See Description Location Integer Variable Numeric 1 The number of blocks available. Use the drop-down menu to select from the 35 available blocks. Note: When a new Variable Numeric block is added to the drawings, the block s number is incremented to the next available block number. X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Variable Enum Description: Mainly used for variable values requiring monitoring. They can be formatted to any standard enumeration or to Boolean values (true or false). These blocks are available in a structured network variable output (NVO). nvovarenum1_27 contains variable enum blocks Number of blocks: 27 Advanced Configuration: Set Mode, Select Enumeration Inputs Input Enum Input of the block. The read value. Outputs Output Enum Output of the block. The read (Automatic) value or set (Manual) value. Mode Digital 0 or 1 Mode of the input: 0 = Automatic 1 = Manual

85 LX Graphical Programming Tool (GPI) Technical Bulletin 85 Block Properties Type Range Default Description (Name) String Unlimited Variable Enum Name of the block. Description String Unlimited - Description of the block. Number Menu See Description Location Integer Variable Enum 1 The number of blocks available. Use the drop-down menu to select from the 27 available blocks. Note: When a new Variable Enum block is added to the drawings, the block s number is incremented to the next available block number. X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Custom Custom blocks are used to simplify drawings by creating blocks that can contain multiple other blocks that may make up a unique sequence, function, or logic. There are two types of Custom blocks. The regular Custom block is executed in sequence with other blocks in the code. The Conditional Custom block is used for advanced programming and allows for the execution of a part of the sequence when the block is enabled.the following blocks are available in this category: Custom Block and Conditional Custom Block. Custom Block Example Custom blocks simplify control sequence drawings by allowing complex code to be built within a single block. Therefore, as seen in the following example, an apparently simple control sequence consisting of only a Hardware Input and Custom block is displayed. However, within the Custom block, is a more complex code consisting of several Internal Constant blocks, a Linear block and a Limit block. Figure 71: Custom Block Example The only exposed input to the Custom block is Outdoor Air Temperature. The Outdoor Air Temperature value inputted into this port from the Hardware Input block is then taken inside the Custom block to follow the sequence and is then sent to the exposed output, Supply Air Temperature Setpoint.

86 86 LX Graphical Programming Tool Technical Bulletin Figure 72: Inside the Custom Block Inside the Custom block, the Outdoor Air Temperature input is sent to the Linear block. Supply air and outdoor air temperature limits from the Internal Constant blocks are used by the Linear block to create a linear interpolation. The Limit block receives the Output of the Linear block, evaluates it against the High and Low outdoor air temperature limits from the Internal Constant blocks, and outputs the result to the Supply Air Temperature Setpoint output of the Custom block. Description: Used to simplify graphics control sequences by grouping multiple blocks together and creating a new block for advanced controls. These new blocks can then be added to the block toolbox. Advanced Configuration: View Content Inputs The block can have several different kinds of inputs depending on the blocks it contains. Outputs The block can have several different kinds of outputs depending on the blocks it contains. Block Properties Type Range Default Description (Name) String Unlimited Custom Name of the block. Block Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Conditional Custom Block Description: Use to simplify graphics control sequences by grouping multiple blocks together and creating a new block for advanced controls. The block s sequences also have the ability to be executed only when the block is enabled. These new blocks can then be added to the block toolbox. Advanced Configuration: View Content

87 LX Graphical Programming Tool (GPI) Technical Bulletin 87 Inputs The block can have several different kinds of inputs depending on the blocks it contains. Enabled Digital 0 or 1 Used to enable or disable the block. Setting the input to 0 disables the block, whereas setting the input to 1 enables the block. Outputs The block can have several different kinds of outputs depending on the blocks it contains. Block Properties Type Range Default Description (Name) String Unlimited Conditional Name of the block. Custom Block Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. General General blocks are used to perform various important functions in a program. Some of these blocks are essential to a sequence since they provide control, flexibility, and organization. The following blocks are available in this category: Toggle Hysteresis Limit Digital Fault Numeric Faul Startup Ramp Rising Edge Falling Edge Count Up Count Down Linear PID Dual PID

88 88 LX Graphical Programming Tool Technical Bulletin Latch Description: Use for a set-reset logic. If the Set input turns ON, the block outputs and hold an ON value. If the Reset input turns ON, the block outputs and holds an OFF value. However, if the Reset input turns ON while the Set input is ON, then the output remains ON. Likewise, if the Set input turns ON while the Reset input is ON, then the output remains OFF. Set Reset Output 0 0 No change No change Inputs Set Digital 0 or 1 Set input. If ON, Output turns ON. Reset Digital 0 or 1 Reset input. If ON, Output turns OFF. Outputs Output Digital 0 or 1 Output of the block. Block Properties Type Range Default Description (Name) String Unlimited Latch Name of the block. Description String Unlimited - Description of the block. Persist Location Menu Integer See Description False - When this option is true, the output state is preserved during any type of reset. X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

89 LX Graphical Programming Tool (GPI) Technical Bulletin 89 Example The Latch block can be used for switching operations in which a reset is required. The following example shows how this block can be used along with Wireless Module, Timer, Rising Edge, Greater Or Equal, Internal Constant, Hardware Output and Logic blocks to create a timed lighting system. Figure 73: Latch Block Example The Latch block receives its Set command through an And block when a Light Switch (Wireless Module block) is turned ON. When the Set input is ON, the Output of the Latch block turns the Light (Hardware Output block) and Timer block ON. If the Output of the Timer block reaches 60 minutes, the Output of the Greater Or Equal block becomes TRUE and turns ON the Rising Edge block. If the Output of the Rising Edge block is ON or the Light Switch (Wireless Module block) is turned OFF, the Reset of the Latch block is turned ON, which turns the Output of the Latch block OFF. In turn, the Light (Hardware Output block) and Timer block are also turned OFF. If the Output of the Rising Edge block is ON or the Light Switch (Wireless Module block) is turned ON while the Light (Hardware Output block) is already ON, the Reset of the Timer block is turned ON. Toggle Description: Use for a toggle logic. If the Toggle input turns ON and the output is OFF, the block outputs and holds an ON value. If the Toggle input turns ON and the output is ON, the block outputs and holds an OFF value. Whenever the Reset input turns ON, the block outputs and holds an OFF value.

90 90 LX Graphical Programming Tool Technical Bulletin Inputs Toggle Reset Output 0 0 No change or Toggle Digital 0 or 1 Toggle input. If Output is OFF and Toggle turns ON, Output turns ON. If Output is ON and Toggle turns ON, Output turns OFF. Reset Digital 0 or 1 Reset input. If ON, Output turns OFF. Outputs Output Digital 0 or 1 Output of the block. Block Properties Type Range Default Description (Name) String Unlimited Toggle Name of the block. Description String Unlimited - Description of the block. Persist Menu See Description Location Integer False When this option is true, the output state is preserved during any type of reset. X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Example The Toggle block can be used for toggle switching operations in which a reset is required. The following example shows how this block can be used along with Hardware Input, Schedule, Equal, Internal Constant and Hardware Output blocks to control an Exhaust Fan (Hardware Output block).

91 LX Graphical Programming Tool (GPI) Technical Bulletin 91 Figure 74: Toggle Block Example The Toggle block receives its Toggle command from a Hardware Input block and its Reset command from an Equal block. The Equal block compares the occupancy from the Schedule block to the set occupancy from the Internal Constant block. Thus, the output of the Equal block is only TRUE when the unoccupied mode is scheduled. When the Equal block is TRUE, the Toggle block is reset and the Exhaust Fan (Hardware Output block) is turned OFF. Assuming that the Reset of the Toggle block is OFF, if the Exhaust Fan Push Button (Hardware Input block) is turned ON, the Exhaust Fan (Hardware Output block) turns ON if it was OFF and turns OFF if it was ON. Hysteresis Description: Use to hold the output value steady until the input value has surpassed either the high or low limits. It prevents the output from changing often due to small, yet frequent changes to the input. Inputs Input Numeric Input of the block. SwitchOn Numeric SwitchOff Numeric If the Input is less than or equal to this value, the Output turns ON. Note: Typically the SwitchOn value is less than the SwitchOff value. If however the SwitchOff value is less than the SwitchOn value, then the logic would be reversed and the Output would turn OFF. If the Input is greater than or equal to this value, the Output turns OFF. Note: Typically the SwitchOn value is less than the SwitchOff value. If however the SwitchOff value is less than the SwitchOn value, then the logic would be reversed and the Output would turn ON.

92 92 LX Graphical Programming Tool Technical Bulletin Outputs Output Digital 0 or 1 Output of the block. Block Properties Type Range Default Description (Name) String Unlimited Hysteresis Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Example The Hysteresis block can be used to prevent an output from changing states too often when it is affected by an input that oscillates frequently. The following example shows how this block can be used to control a Baseboard (Hardware Output block) through the use of an And block, Equal block, Math blocks, Schedule block, Internal Constant blocks, Room Temperature and Setpoint (Hardware Input blocks). Figure 75: Hysteresis Block Example

93 LX Graphical Programming Tool (GPI) Technical Bulletin 93 The Hysteresis block receives the Room Temperature (Hardware Input block) as its Input. The block only outputs an ON value when its Input is less than or equal to the SwitchOn value; for example, 0.5 F less than the Setpoint (Hardware Input block). Likewise, the block only outputs an OFF value when its Input is greater than or equal to the SwitchOff value; for example, 0.5 F greater than the Setpoint (Hardware Input block). The Baseboard (Hardware Output block) only turns ON when both inputs of the And block are 1; for example, when the occupied mode is scheduled and when the Hysteresis block outputs an ON value. Limit Description: Use to control the input value within a specified range. If only one of the limits (either High or Low) is given a value, then the input is only limited in one direction. This is called a onesided Limit. Inputs Input Numeric Input of the block. High Numeric Low Numeric Outputs Output Digital 0 or 1 Output of the block. Block Properties The maximum value of the input. If the Input is greater than this value, this value is outputted. The minimum value of the input. If the Input is less than this value, this value is outputted. Type Range Default Description (Name) String Unlimited Limit Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

94 94 LX Graphical Programming Tool Technical Bulletin Example The Limit block can be used to prevent a value from exceeding a specified range. The following example shows how this block can be used to limit the Supply Air Temperature Setpoint (Variable Numeric block) through the use of an Outdoor Air Temperature value (Hardware Input block), Constant Numeric, Internal Constant, and Linear blocks. Figure 76: Limit Block Example The Limit block receives the Output of the Linear block, which calculates the Supply Air Temperature Setpoint (Variable Numeric block) based on a linear interpolation generated from set values and the Outdoor Air Temperature (Hardware Input block). The Limit block then ensures that its Input is within the High limit, which is received from Maximum Supply Air Temperature (Constant Numeric block) and Low limit, which is received from Minimum Supply Air Temperature (Constant Numeric block). If the input of the Limit block exceeds the High limit, then the block outputs the High limit value and if it exceeds the Low limit, the block outputs the Low limit value. Digital Fault Description: Use to evaluate a digital fault condition such as a fan or a pump stop. When the input is different than the status for a defined time period (Activation Delay), the block outputs an alarm. There are two types of alarms; run alarms and stop alarms. Inputs Input Digital 0 or 1 Input of the block. Status Digital 0 or 1 The status value of the block. Enabled Digital 0 or 1 Used to enable or disable the block. Setting the input to 0 disables the block, whereas setting the input to 1 enables the block.

95 LX Graphical Programming Tool (GPI) Technical Bulletin 95 Outputs RunAlarm Digital 0 or 1 State of the run alarm. StopAlarm Digital 0 or 1 State of the stop alarm. Block Properties Type Range Default Description (Name) String Unlimited Digital Fault Activation Delay Name of the block. Integer The time (in seconds) that a fault condition must be true before an alarm is activated. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Example The Digital Fault block can be used to determine whether a digital condition is working properly. The following example shows how these blocks can be used along with Hardware Input, Internal Constant, Numeric Fault, SNVT_state Mux and Network Variable Output blocks to evaluate if a Supply and Return Fan (Hardware Output blocks) are in the correct state. Figure 77: Digital Fault Block Example

96 96 LX Graphical Programming Tool Technical Bulletin Numeric Fault The Digital Fault blocks compare the Input (the desired state) to the Status (the actual state) and check if they are the same. In the case of the Supply Fan, the Input is ON, but the Status is OFF; therefore, once the Activation Delay has passed the StopFault turns ON. In the case of the Return Fan, the Input and Status are both OFF; therefore, both Faults remain OFF. These Fault values, along with values from the Numeric Fault and Hardware Input blocks, are then sent to a SNVT_state Mux block, which in turn sends all these fault values to a Network Variable Output block. Description: Use to evaluate a numeric fault condition such as a supply temperature low limit. If the input is less than or equal to the low limit or greater than or equal to the high limit for a defined time period (Activation Delay), the block outputs an alarm. There are two types of alarms; low alarms, and high alarms. Inputs Input Numeric Input of the block. LowLimit Numeric The minimum value of the input. HiLimit Numeric The maximum value of the input. Enabled Digital 0 or 1 Used to enable or disable the block. Setting the input to 0 disables the block, whereas setting the input to 1 enables the block. Outputs LowAlarm Digital 0 or 1 State of the low limit alarm. HiAlarm Digital 0 or 1 State of the high limit alarm.

97 LX Graphical Programming Tool (GPI) Technical Bulletin 97 Block Properties Type Range Default Description (Name) String Unlimited Numeric Fault Activation Delay Name of the block. Integer The time (in seconds) that a fault condition must be true before an alarm is activated. Description String Unlimited - Description of the block. Hysteresis Numeric Location Integer Used to keep the alarms from turning ON and OFF often, when the input value frequently moves above and below the LowLimit or HiLimit. X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Example The Numeric Fault block can be used to determine whether a numeric condition is working properly. The following example shows how this block can be used along with Hardware Input, Hardware Output, Internal Constant, Digital Fault, SNVT_state Mux and Network Variable Output blocks to evaluate if the Supply Air Temperature (Hardware Input block) is within the specified limits (Internal Constant blocks). Figure 78: Numeric Fault Block Example

98 98 LX Graphical Programming Tool Technical Bulletin The Numeric Fault block checks if the Input is within the LowLimit and HiLimit. Since the Input is lower than the LowLimit and there is no Hysteresis set, the LowFault turns ON once the Activation Delay has passed. This Fault value, along with values from the Digital Fault and Hardware Input blocks, are then sent to a SNVT_state Mux block, which in turn sends all these fault values to a Network Variable Output block. Startup Description: Use for program initialization and to output a true value at the first code execution (after a reset or power reset). Inputs N/A Outputs Output Digital 0 or 1 Startup value. Block Properties Type Range Default Description (Name) String Unlimited Startup Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Example The Startup block is used to output an ON value at the first code execution. The following example shows how this block can be used along with a Switch block and Constant & Variable blocks to reset the static pressure setpoint. Figure 79: Startup Block Example

99 LX Graphical Programming Tool (GPI) Technical Bulletin 99 The Startup block pulses an ON value at the first code execution then remains OFF until the next reset. This ON value is received by a Switch block and outputs the Constant Static Pressure Setpoint (Constant Numeric block). For the remainder of the code execution, the Switch block outputs the Effective Static Pressure Setpoint (Variable Numeric block), which is governed by a separate algorithm. Ramp Description: Use to provide a way to increase or decrease an input s value at a specified rate. Inputs Input Numeric Input of the block. RampUp% Numeric Rate of ramp up per RampUpTm. Set the value to 0 to effectively disable this feature. RampUpTm Integer Time (in minutes) that the Output ramps up to the RampUp%. RampDown% Numeric Rate of ramp down per RampDownTm. Set the value to 0 to effectively disable this feature. RampDown Tm Integer Time (in minutes) that the Output ramps down to the RampDown%. Enabled Digital 0 or 1 Used to enable or disable the block. Setting the input to 0 disables the block, whereas setting the input to 1 enables the block. Outputs Output Numeric Output of the block. Block Properties Type Range Default Description (Name) String Unlimited Ramp Name of the block. Description String Unlimited - Description of the block. TimeBase Location Menu Integer See Description Second - Select the unit of time: Second, Minute or Hour. X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

100 100 LX Graphical Programming Tool Technical Bulletin Example The Ramp block is used to increase or decrease an input s value at a specified rate. The following example shows how this block can be used along with Hardware Input, Schedule, Rising Edge, Latch, PID, Internal Constant and Comparator blocks to ramp up the output of a Cooling Valve (Hardware Output block). Figure 80: Ramp Block Example The Ramp block receives its Input from a PID block for Supply Air Temperature (Hardware Input block). The Ramp block then increases a value at a rate of 100% over 2 minutes and outputs this to a Cooling Valve (Hardware Output block). The PID and Ramp blocks are enabled when the occupied mode is scheduled. The Ramp block is disabled when the Output of the Ramp block is less than or equal to the Output of the PID block. Rising Edge Description: Output pulses ON if the input goes from OFF to ON or any other value. The output remains ON for the duration of one code execution. Inputs Input Digital 0 or 1 Input of the block. Outputs Output Digital 0 or 1 Output of the block. Block Properties Type Range Default Description (Name) String Unlimited Rising Name of the block. Edge Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

101 LX Graphical Programming Tool (GPI) Technical Bulletin 101 Example The Rising Edge block can be used to pulse an ON Output value when it receives an OFF to ON Input value. The following example shows how this block can enable a Conditional Custom block to execute a lighting command to control a Light (Hardware Output block) through the use of Network Variable Input, SNVT_scene Demux, Internal Constant, Comparator, Logic, and Variable Numeric blocks. Figure 81: Rising Edge Block Example The Rising Edge block receives a value from the Network Variable Input block through the SNVT_scene Demux, Comparator and Logic blocks. Depending on the scene number of the Network Variable Input, one of the Rising Edge blocks receives an ON input and pulse an ON to its Output to enable either the Scene 5 Lighting or Scene 6 Lighting Conditional Custom block. Falling Edge Description: Output turns ON if the input goes from ON to OFF or any other value. The output remains ON for the duration of one code execution. Inputs Input Digital 0 or 1 Input of the block. Outputs Output Digital 0 or 1 Output of the block.

102 102 LX Graphical Programming Tool Technical Bulletin Block Properties Type Range Default Description (Name) String Unlimited Falling Edge Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

103 LX Graphical Programming Tool (GPI) Technical Bulletin 103 Count Up Description: Use to increment the output by 1 on every OFF-to-ON transition, ON-to-OFF transition or every OFF-to-ON and ON-to-OFF transition. Inputs Input Digital 0 or 1 Input of the block. CntLimit Numeric 1 The upper limit for the Overflow. Note: When the Output has reached this number, the Overflow is set to 1 and the Output is reset to 0. Reset Digital 0 or 1 When ON (1), the Output and Overflow are set to 0. When OFF (0) the Output is incremented. Outputs Output Numeric 1 Output of the block. Number of the count. Overflow Digital 0 or 1 Count overflow limit. Indicates that the maximum count number has been reached. The maximum counter limit is determined by the CntLimit. Note: This can be used in another count up block to get more count steps. Block Properties Type Range Default Description (Name) String Unlimited Count Up Name of the block. CountType Menu See Description RisingEdge Set the condition under which the count is decremented: RisingEdge (ON-to-OFF), FallingEdge (OFFto-ON) or Both (ON-to-OFF/OFFto-ON). Description String Unlimited - Description of the block. Persist Menu See Description Location Integer False When this option is true, the output state is preserved during any type of reset. X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Example The Count Up block can be used to count the number of OFF to ON values received by its Input. The following example shows how this block can be used to count the number of times a Chiller (Hardware Output block) turns ON for maintenance purposes through the use of Rising Edge and Constants & Variables blocks.

104 104 LX Graphical Programming Tool Technical Bulletin Figure 82: Count Up Block Example The Count Up block receives values from the Chiller (Hardware Output block) and outputs the number of times it receives an ON value to a Variable Numeric block. Once the count reaches the specified limit of 10000, the OverFlow output sends a 1 value to a second Count Up block. This second Count Up block is used to collect the overflow from the first one and continues to count every Chiller (Hardware Output block) starts and sends the count to a second Variable Numeric block. Both Count Up blocks are programmed to be reset by a Manual Count Reset (Constant Numeric block). Count Down Description: Use to decrement the output by 1 at every OFF-to-ON transition, ON-to-OFF transition or every OFF-to-ON and ON-to-OFF transition. Inputs Input Digital 0 or 1 Input of the block. CntLimit Numeric 1 The count start-point. The counter then commences counting down to 0. Note: When the Output has reached 0, the Overflow is set to 1 and the Output is reset to 0. Reset Digital 0 or 1 When ON (1), the Output and Overflow are set to 0. When OFF (0) the Output is decremented. Outputs Output Numeric 1 Output of the block. Number of the count. Underflow Digital 0 or 1 Count underflow limit. Indicates that the count number has reached 0. Note: This can be used in another count down block to get more count steps.

105 LX Graphical Programming Tool (GPI) Technical Bulletin 105 Block Properties Type Range Default Description (Name) String Unlimited Count Down CountType Menu See Description RisingEdge Name of the block. Set the condition under which the count is decremented: RisingEdge (ON-to-OFF), FallingEdge (OFFto-ON) or Both (ON-to-OFF/OFFto-ON). Description String Unlimited - Description of the block. Persist Location Menu Integer See Description False - When this option is true, the output state is preserved during any type of reset. X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Example The Count Down block can be used to count down the number of OFF to ON values received by its Input. The following example shows how this block can be used to count the number of times a Pump (Hardware Output block) turns ON before maintenance is required through the use of Rising Edge and Constants & Variables blocks. Figure 83: Count Down Block Example The Count Down block receives values from the Pump (Hardware Output block) and outputs a Pump Maintenance Notice (Variable Numeric block) from the UnderFlow output once the block receives 1000 Pump (Hardware Output block) starts; for example, the count limit. The Count Down block is programmed to be reset by a Manual Count Reset (Constant Numeric block).

106 106 LX Graphical Programming Tool Technical Bulletin Linear Description: Provides a proportional reset based on the linear equation (y = mx + b) for applications such as supply temperature reset in relation to the outside air temperature. Inputs Input Numeric ± Input of the block. or N/A X1 Numeric ± Value for X1. or N/A Y1 Numeric ± Value for Y1. or N/A X2 Numeric ± Value for X2. or N/A Y2 Numeric ± or N/A Value for Y2. Outputs Output Numeric ± Output of the block. Result of the linear interpolation of the Input. Block Properties Type Range Default Description (Name) String Unlimited Linear Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Example The Linear block can be used to interpolate a value based on a generated linear curve. The following example shows how this block can be used to interpolate the value of Outdoor Air Temperature (Hardware Input block) based on a linear curve generated by values from Constant Numeric and Internal Constant blocks to output the Supply Air Temperature Setpoint (Variable Numeric block).

107 LX Graphical Programming Tool (GPI) Technical Bulletin 107 Figure 84: Linear Block Example The Linear block generates a linear curve based on values from the Constant Numeric and Internal Constant blocks. It then receives the Outdoor Air Temperature (Hardware Input block) and interpolates it based on this curve to output the Supply Air Temperature Setpoint (Variable Numeric block). The Limit block then ensures that the value outputted by the Linear block is within the specified limits and outputs it to the Numeric Variable block. The linear curve is calculated as follows: y = mx + b y = Output m = Slope = y x 2 2 y1 x x = Input = x-x 1 (only valid if x1=0) b = Offset = y 1 y = x 2 y x 1 1 ( x x1 ) y1 2 1 y + Pid Description: Use to provide a proportional, integral and derivative (PID) control. Number of Blocks: 16 (Pid & Dual Pid) Advanced Configuration: Configure

108 108 LX Graphical Programming Tool Technical Bulletin Inputs Input Numeric Input of the block. Setpoint Numeric The setpoint. Enabled Digital 0 or 1 Used to enable or disable the block. Setting the input to 0 disables the block, whereas setting the input to 1 enables the block. Outputs Output Numeric Output of the PID loop. Block Properties Type Range Default Description (Name) String Unlimited Pid Name of the block. Description String Unlimited - Description of the block. Number Menu See Description Pid 1 The number of blocks available. Use the drop-down menu to select from the 16 available blocks. Note: When a new Pid block is Location Integer added to the drawings, the block s number is incremented to the next available block number. X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Dual Pid Description: Use to provide a proportional, integral and derivative (PID) control. Number of instances: 16 (PID & Dual PID) Advanced Configuration: Configure

109 LX Graphical Programming Tool (GPI) Technical Bulletin 109 Inputs Input Numeric Input of the block. HiSetPt Numeric The upper setpoint limit. LowSetPt Numeric The lower setpoint limit. Enabled Digital 0 or 1 Used to enable or disable the block. Setting the input to 0 disables the block, whereas setting the input to 1 enable the block. Outputs HiVal Numeric High value output of the PID loop. LowVal Numeric Low value output of the PID loop. Block Properties Type Range Default Description (Name) String Unlimited Dual PID Name of the block. Description String Unlimited - Description of the block. Number Menu See Description PID 1 The number of blocks available. Use the drop-down menu to select from the 16 available blocks. Note: When a Dual PID block is Location Integer added to the drawings, the block s number is incremented to the next available block number. X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Example The Dual PID block is used to provide PID control for a pair of setpoints. The following example shows how this block can be used along with Hardware Input, Comparator, Logic, Internal Constant, and SmartSensor Module blocks to control HVAC modes.

110 110 LX Graphical Programming Tool Technical Bulletin Figure 85: Dual PID Block Example The Dual PID block receives the Room Temperature (Hardware Input block), compares it to heating and cooling setpoints (Internal Constant blocks) and outputs either a heating or cooling demand. This demand is then sent to Comparator and Logic blocks which output the HVAC_AUTO mode to be selected by the SmartSensor Module block through the Multiplexer block. HVAC HVAC blocks are used for standard HVAC requirements such as stage control and psychometric calculations. The following blocks are available in this category: Analog Stages Digital Stages Digital Stages + Delay Smart Stages Stages With Modulation Optimum Start/Stop Enthalpy Dew Point Wet Bulb

111 LX Graphical Programming Tool (GPI) Technical Bulletin 111 Analog Stages Description: Use to control multiple analog stages. As the Input or demand increases, the Output stages turn ON in a sequential manner. If only 2 stages are configured, the first stage increases at double the rate of the Input so that when the Input reaches 50%, the first stage reaches 100% and turns ON. As the Input increases beyond 50%, the second stage begins to increase at double the rate of the Input so that finally when the Input reaches 100%, the second stage also reaches 100% and the second stage turns ON. This block behaves similarly if 3 or 4 stages are configured; for example, each stage increases in sequence at 3 times the rate of the Input (3 stages) or 4 times the rate of the Input (4 stages). As the Input decreases, each stage turns OFF in the opposite manner that it increased; for example, if 2 stages are configured, the second stage turns OFF when the Input reaches 50% and the first stage turns OFF when the Input reaches 0%. 100% 100% Demand 50% Demand 67% 33% 0% 0% Time Time 100% Demand 75% 50% 25% Stage 4 Stage 3 Stage 2 Stage 1 0% Time Figure 86: 2-Stage, 3-Stage and 4-Stage Analog Control

112 112 LX Graphical Programming Tool Technical Bulletin Inputs Input Numeric Stage demand, usually the output of a PID block. Enable Digital 0 or 1 Used to enable or disable the block. Setting the input to 0 disables the block, whereas setting the input to 1 enables the block. Outputs Outputx (x=1-4) Numeric Output for the analog stage control. Note: Two outputs are always visible. The other two possible outputs can be added by the user through the Properties pane. Block Properties Type Range Default Description (Name) String Unlimited Analog Name of the block. Stages Description String Unlimited - Description of the block. NumberOf Stages Integer Number of stages being controlled. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Example The Analog Stages block is used to control multiple analog outputs based on the demands of one input. The following example shows how this block can be used to control a pair of compressors (Hardware Output blocks) through the use of a Room Temperature sensor (Hardware Input block), Dual PID, Digital Stages and Internal Constant blocks. Figure 87: Analog Stages Block Example

113 LX Graphical Programming Tool (GPI) Technical Bulletin 113 The Analog Stages block receives its Input or cooling demand from the HiVal of the Dual PID block. The Dual PID block evaluates the Room Temperature (Hardware Input block) against heating and cooling setpoints (Internal Constant blocks) and outputs either a cooling demand to the Analog Stages block, which controls a pair of compressors (Hardware Output blocks) or a heating demand to the Digital Stages block, which controls a pair of heaters (Hardware Output blocks). Digital Stages Description: Use to control multiple digital stages. As the Input or demand increases, the Output stages turn ON in a sequential manner. If only 2 stages are configured, the first stage turns ON when the Input reaches 50% and the second stage turns ON when the Input reaches 100%. This block behaves similarly if 3 or 4 stages are configured; for example, each stage turns at each third of the Input (3 stages) or each fourth of the Input (4 stages). As the Input decreases, each stage turns OFF in the opposite manner that it increased, for example, if 2 stages are configured, the second stage turns OFF when the Input reaches 50%, and the first stage turns OFF when the Input reaches 0%. 100% 100% Demand 50% Demand 67% 33% 0% 0% Time Time 100% Demand 75% 50% 25% Stage 4 Stage 3 Stage 2 Stage 1 0% Time Figure 88: 2-Stage, 3-Stage and 4-Stage Digital Control

114 114 LX Graphical Programming Tool Technical Bulletin Inputs Input Numeric Stage demand, usually the output of a Pid block. Enable Digital 0 or 1 Used to enable or disable the block. Setting the input to 0 disables the block, whereas setting the input to 1 enables the block. Outputs Outputx (x=1-4) Digital 0 or 1 Output for the digital stage control. Note: Two outputs are always visible. The other two possible outputs can be added by the user through the Properties pane. Block Properties Type Range Default Description (Name) String Unlimited Digital Name of the block. Stages Description String Unlimited - Description of the block. NumberOf Stages Integer Number of stages being controlled. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Example The Digital Stages block is used to control multiple digital outputs based on the demands of one input. The following example shows how this block can be used to control a pair of heaters (Hardware Output blocks) through the use of a Room Temperature sensor (Hardware Input block), Dual PID, Analog Stages and Internal Constant blocks. Figure 89: Digital Stages Block Example

115 LX Graphical Programming Tool (GPI) Technical Bulletin 115 Digital Stages + Delay The Digital Stages block receives its Input or heating demand from the LowVal of the Dual PID block. The Dual PID block evaluates the Room Temperature (Hardware Input block) against heating and cooling setpoints (Internal Constant blocks) and outputs either a cooling demand to the Analog Stages block, which controls a pair of compressors (Hardware Output blocks) or a heating demand to the Digital Stages block, which controls a pair of heaters (Hardware Output blocks). Description: Use to control multiple digital stages with ON and OFF delays. Inputs This block works the same way as the Digital Stages block, except that a time delay can be added between each stage depending on whether it is turning ON or OFF. Input Numeric Stage demand, usually the output of a PID block. MinOn Integer Minimum ON delay (in minutes). MinOff Integer Minimum OFF delay (in minutes). Enable Digital 0 or 1 Used to enable or disable the block. Setting the input to 0 disables the block, whereas setting the input to 1 enables the block. Outputs Outputx (x=1-4) Digital 0 or 1 Output for the digital stage control. Note: Two outputs are always visible. The other two possible outputs can be added by the user through the Properties pane. Block Properties Type Range Default Description (Name) String Unlimited Digital Name of the block. Stages + Delay Description String Unlimited - Description of the block. NumberOf Stages Integer Number of stages being controlled. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

116 116 LX Graphical Programming Tool Technical Bulletin Example The Digital Stages + Delay block is used to control multiple digital outputs based on the demands of one input with optional delays between each stage. The following example shows how this block can be used to control a pair of heaters (Hardware Output blocks) through the use of a Room Temperature sensor (Hardware Input block), Dual PID, Analog Stages and Internal Constant blocks. Figure 90: Digital Stages + Delay Block Example The Digital Stages + Delay block receives its Input or heating demand from the LowVal of the Dual PID block. The Dual PID block evaluates the Room Temperature (Hardware Input block) against heating and cooling setpoints (Internal Constant blocks). It then outputs either a cooling demand to the Analog Stages block, which controls a pair of compressors (Hardware Output blocks), or a heating demand to the Digital Stages block, which controls a pair of heaters (Hardware Output blocks). The stages go ON and OFF only after a 2-minute delay (Internal Constant blocks). Smart Stages Description: Use to control multiple digital stages based on the number of cycles per hour. Smart stages are similar to digital stages except for the fact that whereas digital stages operate using a digital output type, smart stages function by a PWM. The PWM range varies in proportion to the number of stages, so that if there is 1 stage, the PWM range is 100%; if 2 stages, then the PWM range for the first stage is 0-50%, and the PWM range for the second stage is % and so on for 3 and 4-stage outputs. For example, A 4-stage output is setup for a period of 6 minutes and the load for the first and second stage reaches 100%, whereas the load for the third stage reaches 50%. In this case, the first and second stage are each be ON 100% of the time (for example, 6 X 100% = 6 minutes), whereas the third stage is ON 50% of the time (for example, 6 X 50% = 3 minutes), and the fourth stage is OFF.

117 LX Graphical Programming Tool (GPI) Technical Bulletin 117 Inputs Input Numeric Stage demand, usually the output of a PID block. MinOn Integer Minimum ON delay (in minutes). MinOff Integer Minimum OFF delay (in minutes). Enable Digital 0 or 1 Used to enable or disable the block. Setting the input to 0 disables the block, whereas setting the input to 1 enables the block. Period Numeric 1 10 Number of cycles per hour. Outputs Outputx (x=1-4) Digital 0 or 1 Output for the smart stage control. Note: Two outputs are always visible. The other two possible outputs can be added by the user through the Properties pane. Block Properties Type Range Default Description (Name) String Unlimited Smart Name of the block. Stages Description String Unlimited - Description of the block. NumberOf Stages Integer Number of stages being controlled. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Example The Smart Stages block is used to control multiple PWM outputs based on the demands of one input with optional delays between each stage. The following example shows how this block can be used to control a pair of compressors (Hardware Output blocks) through the use of a Room Temperature sensor (Hardware Input block), Dual PID, Add, Constant Enum, Limit, and Internal Constant blocks. Figure 91: Smart Stages Block Example

118 118 LX Graphical Programming Tool Technical Bulletin The Smart Stages block receives its Input or heating demand from the sum of the HiVal and LowVal of the Dual PID block. The Dual PID block evaluates the Room Temperature (Hardware Input block) against heating and cooling setpoints (Internal Constant blocks) and outputs either a cooling demand or a heating demand. The stages go ON after a 7.5-minute delay and OFF after a 5-minute delay (Internal Constant blocks). The period is limited between 2 and 4 cycles/hour. Stages with Modulation Description: Use to control multiple digital stages with one analog stage. All stages must have the same load. As the load increases, a dedicated (analog or PWM) output modulates from 0 to 100%. As soon as it reaches 100%, it immediately resets back to 0% and the first stage is turned ON. If the load continues to increase, then the dedicated output again modulates from 0 to 100%. As soon as it reaches 100% again, it immediately resets back to 0% and the next stage is turned ON. This process continues to repeat until all stages are turned ON so long as the load increases. Note: The first stage is always analog. All other stages are digital. Inputs Input Numeric Stage demand, usually the output of a PID block. Enable Digital 0 or 1 Used to enable or disable the block. Setting the input to 0 disables the block whereas setting the input to 1 enables the block. Outputs Output1 Numeric Output for the analog stage control. Outputx Digital 0 or 1 Output for the digital stage control. (x=2-4) Note: Two outputs are always visible. The other two possible outputs can be added by the user through the Properties pane.

119 LX Graphical Programming Tool (GPI) Technical Bulletin 119 Block Properties Type Range Default Description (Name) String Unlimited Stages Name of the block. with Modulation Description String Unlimited - Description of the block. NumberOf Stages Integer Number of stages being controlled. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Optimum Start/Stop Description: Use to determine the start time and/or stop time in order to optimize the heating or cooling of a space based on its occupancy. Optimum start time is the time at which heating or cooling is started before occupancy to ensure that the space is at its required setpoint by the time the space becomes occupied. Optimum stop time is the time at which heating or cooling demands are ignored before a space becomes unoccupied in order to not waste energy for heating or cooling a space that is soon to become unoccupied.

120 120 LX Graphical Programming Tool Technical Bulletin Inputs Temperature Numeric Current room temperature. + OccSp Numeric Occupied setpoint. + UnoccSp Numeric Unoccupied setpoint. + CurrentState Enum -1 3 Current occupancy state: -1 = OC_NUL 0 = OC_OCCUPIED 1 = OC_UNOCCUPIED 2 = OC_BYPASS 3 = OC_STANDBY NextState Enum -1 3 Next occupancy state: -1 = OC_NUL 0 = OC_OCCUPIED 1 = OC_UNOCCUPIED 2 = OC_BYPASS 3 = OC_STANDBY TimeToNext State Integer The length of time (in minutes) before the current occupancy state changes to the next occupancy state. StartTime Integer The length of time, before the start of occupied mode, at which the optimum start is enabled. StopTime Numeric The length of time, before the start of unoccupied mode, at which the optimum stop is enabled. Enable Digital 0 or 1 When this input is ON (1) the block is enabled. When this input is OFF (0) then the output follows the current state directly. Outputs OptSetPoint Numeric Optimum setpoint. + OptStart Digital 0 or 1 Optimum start status. Status OptStop Status Digital 0 or 1 Optimum stop status. Block Properties Type Range Default Description (Name) String Unlimited Optimum Name of the block. Start/Stop Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

121 LX Graphical Programming Tool (GPI) Technical Bulletin 121 Example The Optimum Start/Stop block is used to optimize the heating and/or cooling of a space based on its occupancy. The following example shows how this block can be used to control a PID block for a Heater and a Fan (Hardware Output blocks) through the use of a Room Temperature sensor (Hardware Input block), Schedule and Internal Constant blocks. Figure 92: Optimum Start/Stop Block Example The Optimum Start/Stop block receives the Room Temperature (Hardware Input block) and occupancy (Schedule block) and based on these and other inputs (Internal Constant blocks) determines if optimum start should be initiated. If optimum start is initiated, the Fan (Hardware Output block) is turned ON immediately and the PID block is enabled to control the Heater (Hardware Output block). Enthalpy Description: Use to calculate air enthalpy when supplied with the dry bulb air temperature, relative humidity, and atmospheric pressure. Inputs Humidity Numeric 0 Air relative humidity in % % Temp Numeric 5.00 C Dry bulb air temperature in C or F C F F Note: The temperature unit used is determined by the user through the Format Selection window. Press Numeric 83.00kPa kPa 12.04psi 15.75psi Atmospheric pressure in kpa or psi. Note: The pressure unit used is determined by the user through the Format Selection window.

122 122 LX Graphical Programming Tool Technical Bulletin Outputs Output Numeric Air enthalpy reading in kj/kg or BTU/lb. Note: The enthalpy unit used is determined by the user through the Format Selection window. Block Properties Type Range Default Description (Name) String Unlimited Enthalpy Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

123 LX Graphical Programming Tool (GPI) Technical Bulletin 123 Example The Enthalpy block is used to calculate the air enthalpy. The following example shows how this block uses atmospheric pressure (Internal Constant block), the Outdoor Relative Humidity and Outdoor Air Temperature (Hardware Input blocks) to calculate the Outdoor Enthalpy and sends it to a Variable Numeric block. Figure 93: Enthalpy Block Example Dew Point Description: Use to calculate the air dew point (at atmospheric pressure) when supplied with the dry bulb air temperature and humidity. Inputs Humidity Numeric 0 Air relative humidity (RH) in % % Temp Numeric 0.00 C Dry bulb air temperature in C or F C F F Note: The temperature unit used is determined by the user through the Format Selection window. Outputs Air dew point reading in C or F. Note: Output Numeric Block Properties The dew point unit used is determined by the user through the Format Selection window. Type Range Default Description (Name) String Unlimited Dew Name of the block. Point Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

124 124 LX Graphical Programming Tool Technical Bulletin Example The Dew Point block is used to calculate the dew point temperature of the air. The following example shows how this block uses the Room Relative Humidity and Room Temperature (Hardware Input blocks) to calculate the Room Dew Point temperature and sends it to a Variable Numeric block. Wet Bulb Figure 94: Dew Point Block Example Description: Use to calculate the wet bulb temperature (at atmospheric pressure) when supplied with the dry bulb air temperature and humidity. Inputs Humidity Numeric 0 Air relative humidity (RH) in % % Temp Numeric 0.00 C Dry bulb air temperature in C or F C F F Note: The temperature unit used is determined by the user through the Format Selection window. Outputs Output Numeric Wet bulb temperature reading in C or F. Note: The wet bulb temperature unit used is determined by the user through the Format Selection window. Block Properties Type Range Default Description (Name) String Unlimited Wet Bulb Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

125 LX Graphical Programming Tool (GPI) Technical Bulletin 125 Example The Wet Bulb block is used to calculate the wet bulb temperature of the air. The following example shows how this block uses the Outdoor Relative Humidity and Outdoor Air Temperature (Hardware Input blocks) to calculate the Outdoor Wet Bulb temperature and send it to a Variable Numeric block. Figure 95: Wet Bulb Block Example Inputs and Outputs Inputs and Outputs are blocks used to interface with various types of physical inputs and outputs, as well as network variable inputs (NVI) and network variable outputs (NVO). The following blocks are available in this category: Hardware Input Hardware Output Network Variable Input Network Variable Output Floating Output Smart Sensor Module Hardware Input Description: Use to interface with a hardware input. Number of Blocks: Depends on the number of hardware inputs on the controller being used. Advanced Configuration: Set Mode, Configure

126 126 LX Graphical Programming Tool Technical Bulletin Inputs ClrPulse Digital 0 or 1 Set this input to 1 (ON) to clear the pulse count. Outputs Output Digital 0 or 1 Output of the block. Whether the block outputs a digital value or a numeric value depends on what type of Signal interpretation is selected in the block s Configure window. Numeric Note: For numeric inputs, if there is an open or short circuit, the output is. Mode Digital 0 or 1 Mode of the input: 0 = Automatic 1 = Manual Override Digital 0 or 1 Value of the override (Bypass). The Override output only emits a pulse, thus if it is required to stay on for an extended period of time, a Min On Time block should be used. ElectAlm Digital 0 to 1 Electrical fault alarm status. Block Properties Type Range Default Description (Name) String Unlimited Hardware Name of the block. Input Description String Unlimited - Description of the block. Number Menu See Description Location Integer Hardware Input 1 The number of blocks available. Use the drop-down menu to select from the available blocks. Note: When a new Hardware Input block is added to the drawings, the block s number is incremented to the next available block number. The number of blocks available depends on the number of inputs on the controller being used. X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

127 LX Graphical Programming Tool (GPI) Technical Bulletin 127 Hardware Output Description: Use to interface with a hardware output. Number of Blocks: Depends on the number of hardware outputs on the controller being used. Advanced Configuration: Set Mode, Configure Inputs Input Digital 0 or 1 Value of the output. Numeric Outputs Output Digital 0 or 1 Numeric Effective value of the output. This value takes into consideration the manual and physical (HOA) override values. Whether the block outputs a digital value or a numeric value is dependent on what type of Signal type is selected in the block s Configure window. Note: For numeric inputs, if there is an open or short circuit, the output is. Mode Digital 0 or 1 Mode of the input. 0 = Automatic 1 = Manual HwOvrSt Enum 0 2 Hardware override status (HOA switches). 0 = OFF 1 = Auto 2 = Hand HwOvrVal Numeric Hardware override value.

128 128 LX Graphical Programming Tool Technical Bulletin Block Properties Type Range Default Description (Name) String Unlimited Hardware Output Name of the block. Description String Unlimited - Description of the block. Number Menu See Description Location Integer Hardware Output 1 The number of blocks available. Use the drop-down menu to select from the available blocks. Note: When a new Hardware Output block is added to the drawings, the block s number is incremented to the next available block number. The number of blocks available depends on the number of outputs on the controller being used. X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Network Variable Input Description: Use to interface with any network variable input (NVI) that has a length of 1 or 2 bytes (SNVT or UNVT). Different outputs are available depending on the Network Variable Input number selected: Network Variable Inputs 1-12: Output, Com Failure Network Variable Inputs 13-14: Output, Com Failure, HiSel, HiSel Subnet Id, HiSel Node Id, LowSel, LowSel Subnet Id, LowSel Node Id Network Variable Inputs 15-17: Output, Com Failure, HiSel, HiSel Subnet Id, HiSel Node Id, LowSel, LowSel Subnet Id, LowSel Node Id, Sum, Avg Number of Blocks: 17 Advanced Configuration: Set Value, Change Type, Configure Note: If used with a structured NV, more outputs are available Inputs - N/A

129 LX Graphical Programming Tool (GPI) Technical Bulletin 129 Outputs Output Numeric Value of the SNVT_temp_p. Note: The outputs are defined according to the SNVT or UNVT type selected. Com Failure Digital 0 or 1 Communication failure alarm status. HiSel Numeric Highest value among the fan-in inputs. HiSel Subnet Integer Subnet ID of the input with the highest value. Id HiSel Node Id Integer Node ID of the input with the highest value. LowSel Numeric Lowest value among the fan-in inputs. LowSel Integer Subnet ID of the input with the lowest value. Subnet Id LowSel Node Integer Node ID of the input with the lowest value. Id Sum Numeric The sum of all the values of the inputs. Avg Numeric The average value of the inputs. Block Properties Type Range Default Description (Name) String Unlimited Network Name of the block. Variable Input Description String Unlimited - Description of the block. Format Menu See Description Number Menu See Description Location Integer The format of the SNVT type selected. The available formats vary depending on the type of SNVT used. Network Variable Input 1 The number of blocks available. Use the drop-down menu to select from the 17 available blocks. Note: When a new Network Variable Input block is added to the drawings, the block s number is incremented to the next available block number. X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

130 130 LX Graphical Programming Tool Technical Bulletin Network Variable Output Description: Use to interface with any network variable output (NVO) of any type and length (SNVT or UNVT). Inputs Number of Blocks: 17 Advanced Configuration: Change Type, Configure Note: If used with a structured NV, more outputs are available Value of the SNVT_temp_p. Note: Input Numeric See Description Outputs Output Numeric See Value of the SNVT_switch. Description The inputs are defined according to the SNVT or UNVT type selected. Block Properties Type Range Default Description (Name) String Unlimited Network Name of the block. Variable Output Description String Unlimited - Description of the block. Format Menu See Description Number Menu See Description Location Integer The format of the SNVT type selected. The available formats vary depending on the type of SNVT used. Network Variable Output 1 The number of blocks available. Use the drop-down menu to select from the 17 available blocks. Note: When a new Network Variable Output block is added to the drawings, the block s number is incremented to the next available block number. X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

131 LX Graphical Programming Tool (GPI) Technical Bulletin 131 Floating Output Description: Use to interface with a floating actuator connected to the controller s output. Advanced Configuration: Configure Inputs Position Numeric 0 100% The inputted open or close position value for the floating actuator. Outputs Position Numeric 0 100% The outputted open or close position value for the floating actuator. Close Digital 0 or 1 If 1, indicates that the floating actuator is closing. The amount of close movement is determined by the Position output. Open Digital 0 or 1 If 1, indicates that the floating actuator is opening. The amount of open movement is determined by the Position output. Block Properties Type Range Default Description (Name) String Unlimited Floating Name of the block. Output Description String Unlimited - Description of the block. FloatingPair Location Menu Integer See Descriptio n Not Set - The floating output pair. Use the drop-down menu to gain access to the Floating Output Configuration window and to select the desired floating output pair. X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

132 132 LX Graphical Programming Tool Technical Bulletin SmartSensor Module Description: Use to interface with a Smart-Sensor connected to the controller s SMRT terminals. Advanced Configuration: Configure

133 LX Graphical Programming Tool (GPI) Technical Bulletin 133 Inputs Setpoint Numeric Indicates the temperature setpoint. FanSpeed Enum -1 5 Indicates the fan speed. The values are defined as such: -1 = ST_NUL 0 = ST_OFF 1 = ST_LOW 2 = ST_MED 3 = ST_HIGH 4 = ST_ON 5 = ST_AUTO OccState Enum -1 3 Indicates the occupancy state of the room. The values are defined as such: -1 = OC_NUL 0 = OC_OCCUPIED 1 = OC_UNOCCUPIED 2 = OC_BYPASS 3 = OC_STANDBY HVACmode Enum Indicates the HVAC mode of the room. The values are defined as such: -1 = HVAC_NUL 0 = HVAC_AUTO 1 = HVAC_HEAT 2 = HVAC_MRNG_WRMUP 3 = HVAC_COOL 4 = HVAC_NIGHT_PURGE 5 = HVAC_PRE_COOL 6 = HVAC_OFF 7 = HVAC_TEST 8 = HVAC_EMERG_HEAT 9 = HVAC_FAN_ONLY 10 = HVAC_FREE_COOL 11 = HVAC_ICE 12 = HVAC_MAX_HEAT 13 = HVAC_ECONOMY 14 = HVAC_DEHUMID 15 = HVAC_CALIBRATE 16 = HVAC_EMERG_COOL 17 = HVAC_EMERG_STEAM 18 = HVAC_MAX_COOL 19 = HVAC_HVC_LOAD 20 = HVAC_NO_LOAD Customx Numeric Indicates the custom value as configured in the (x=1-5) Smart Sensor Module Configuration window.

134 134 LX Graphical Programming Tool Technical Bulletin Outputs Temp Numeric Indicates the room temperature. Setpoint Numeric The temperature setpoint being set by the Smart- Sensor. FanSpeed Enum -1 4 Te fan speed being set by the Smart-Sensor. HVACmode Enum The HVAC mode being set by the Smart-Sensor. Override Digital 0 or 1 Value of the override (Bypass). The Override output only emits a pulse, thus if it is required to stay on for an extended period of time, a Min On Time block should be utilized. Block Properties Type Range Default Description (Name) String Unlimited Smart Name of the block. Sensor Module Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Logic Logic blocks take one or more logic-level inputs and produce a single logic-level output. Because the output is also a logic level, an output of one logic block can connect to the input of one or more other logic blocks. These blocks are used with digital values. The following blocks are available in this category: And Not Or Xor Switch Multiplexer

135 LX Graphical Programming Tool (GPI) Technical Bulletin 135 And Description: Use to perform a standard And logic function. The output is ON (1) if all connected inputs are ON (1). The output is OFF (0) if any connected input is OFF (0). Input 1 Input 2 Output Note: The block can compare as many inputs as are connected to the block s inputs. Inputs Inputx (x=1-10) Digital 0 or 1 Input of the block. Note: Two inputs are always visible. The other eight possible inputs can be added by the user through the Configure Ports window. Outputs Output Digital 0 or 1 Output of the block. Block Properties Type Range Default Description (Name) String Unlimited And Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Example Logic blocks are common components in any type of code. They are very useful for digital sequences; for example, turning components ON and OFF. The following is an example of how Multiplexer, And and Not blocks are used to startup a Fan (Hardware Output block) through the use of a Schedule block, as well as Freeze and Smoke Detection inputs (Hardware Input blocks).

136 136 LX Graphical Programming Tool Technical Bulletin Figure 96: Logic Example The Multiplexer block converts the enumerated occupancy modes into Boolean values. In this way if occupied mode is selected, then the Multiplexer block outputs a 1. Otherwise, if unoccupied or standby mode is selected, then the Multiplexer block outputs a 0. The Not blocks check the freeze and smoke detection inputs (Hardware Input blocks) and output ON if the inputs are OFF and OFF if the inputs are ON. Finally, the And block checks the outputs of the Multiplexer and Not blocks and if all are outputting an ON value; for example, the unit is in occupied mode and no ice or smoke is detected, then the And block outputs an ON value and thus turns ON the Fan (Hardware Output block). Otherwise, if any one of the inputs to the And block are OFF, then the And block outputs an OFF value and the Fan (Hardware Output block) is turned OFF. Not Description: Use to perform a standard Not logic function. The output is ON (1) if the input is OFF (0). The output is OFF (0) if the input is ON (1). Input Output Inputs Input Digital 0 or 1 Input of the block. Outputs Output Digital 0 or 1 Output of the block.

137 LX Graphical Programming Tool (GPI) Technical Bulletin 137 Block Properties Type Range Default Description (Name) String Unlimited Not Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Or Description: Use to perform a standard Or logic function. The output is ON (1) if any connected input is ON (1). The output is OFF (0) if all connected inputs are OFF (0). Input 1 Input 2 Output Note: The block can compare as many inputs as are connected to the block s inputs. Inputs Inputx (x=1-10) Digital 0 or 1 Input of the block. Note: Two inputs are always visible. The other eight possible inputs can be added by the user through the Configure Ports window. Outputs Output Digital 0 or 1 Output of the block. Block Properties Type Range Default Description (Name) String Unlimited Or Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

138 138 LX Graphical Programming Tool Technical Bulletin Xor Description: Use to perform a standard Xor logic function. The output is ON (1) if an odd number of inputs are ON (1), but not all of them. The output is OFF (0) if either all connected inputs are ON (1) or OFF (0) or if an even number of inputs are ON (1). Input 1 Input 2 Output Inputs Inputx (x=1-10) Digital 0 or 1 Input of the block. Note: Two inputs are always visible. The other eight possible inputs can be added by the user through the Configure Ports window. Outputs Output Digital 0 or 1 Output of the block. Block Properties Type Range Default Description (Name) String Unlimited Xor Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

139 LX Graphical Programming Tool (GPI) Technical Bulletin 139 Switch Description: Use to perform a standard Switch logic function. Inputs On Numeric Off Numeric The value outputted when the Select input receives an ON signal. The value outputted when the Select input receives an OFF signal. Select Digital 0 or 1 Input of the block. Receives either an ON or OFF signal. Outputs Output Numeric Output of the block. Block Properties Type Range Default Description (Name) String Unlimited Switch Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Example The Switch block can be used for standard switching operations between two inputs. The following example shows how this block can be used to switch ON an Outdoor Air Damper Position PID block through the use of Schedule, Variable Numeric, Multiplexer, Linear and Internal Constant blocks to control an Outdoor Air Damper (Hardware Output block).

140 140 LX Graphical Programming Tool Technical Bulletin Figure 97: Switch Block Example The Switch block is controlled by the Variable Numeric block. When the Switch block receives an ON value, free cooling is enabled, and the Output of the PID block is activated. When it receives an OFF value, free cooling is disabled, and 0% is outputted. The Output of the Switch block is sent to the Linear block where it is interpolated to give the Outdoor Air Damper (Hardware Output block) position. Multiplexer Description: Use to perform a standard Multiplexer logic function.

141 LX Graphical Programming Tool (GPI) Technical Bulletin 141 Inputs Inputx (x=0-9) Numeric The value outputted when the Select input receives an x signal. Note: Two inputs are always visible. The other eight possible inputs can be added by the user through the Configure Ports window. Select Integer 0 9 Input of the block. Receives an integer from 0 9. Outputs Output Numeric Output of the block. Block Properties Type Range Default Description (Name) String Unlimited Multiplexe Name of the block. r Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Example The Multiplexer block can be used for standard switching operations between multiple inputs. The following example shows how this block can be used to switch HVAC modes through the use of Dual PID, SmartSensor Module, Comparator, Switch, and Internal Constant blocks. Figure 98: Multiplexer Block Example The Multiplexer block is controlled by the SmartSensor Module block. When the Multiplexer block receives an HVAC_AUTO (0) value, Input0 is activated, and the Output of the created code in the upper part of the example. When it receives other values, the corresponding input of the Multiplexer block is activated. The Output of the Multiplexer block is sent back to the SmartSensor Module block to be displayed.

142 142 LX Graphical Programming Tool Technical Bulletin Math Absolute Math blocks are used to perform mathematical operations with the inputted data and then output the result of the math operation. The following blocks are available in this category: Absolute Add Average Divide Maximum Min/Max/Average Minimum Modulus Multiply Square Subtract Summation Root Description: Used to perform a standard absolute operation. The block outputs the absolute value of the connected input; for example, a negative value is changed to positive and a positive value is unchanged. Input(s) Input Numeric Output(s) Output Numeric 0 Input of the block is not a value supported by the Absolute block. If such a value were to be inputted then the block outputs a value of The absolute value of the input.

143 LX Graphical Programming Tool (GPI) Technical Bulletin 143 Block Properties Type Range Default Description (Name) String Unlimited Absolute Name of the block. Description String Unlimited - Description of the block. Location Integer Unlimited - X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Add Description: Used to perform a standard addition operation. The block outputs the sum value of all the connected inputs. The addition is calculated as follows: Output = n= 2 10 i= 1 Inputi Be aware that as a result of the calculation, the input values may cause an overflow (>) or underflow (< ) on the Output.

144 144 LX Graphical Programming Tool Technical Bulletin Input(s) Inputx (x=1-10) Numeric Input of the block. Two inputs are always visible. The other eight possible inputs can be added by the user through the Configure Ports window. Output(s) Output Numeric The sum value of the inputs. Block Properties Type Range Default Description (Name) String Unlimited Add Name of the block. Description String Unlimited - Description of the block. Location Integer Unlimited - X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Example Math blocks are used to create mathematical functions. The following example shows how a Celsius value from a Constant Numeric block can be converted to a Fahrenheit value through the use of a Multiply and Add block, as well as a pair of Internal Constant blocks. Figure 99: Math Example The Multiply block outputs the result of the multiplication between the Celsius value coming from the Constant Numeric block and a constant value of 1.8 from an Internal Constant block. The Add block then adds the Output of the Multiply block and a constant value of 32 from an Internal Constant block. The Output of the Add block is the converted Fahrenheit value. In the previous example the result is calculated as follows: = 68

145 LX Graphical Programming Tool (GPI) Technical Bulletin 145 Average Description: Used to calculate the average value of the inputs. The average value is calculated as follows: Output = n= 2 10 i= 1 Inputi n Be aware that as a result of the calculation, the input values may cause an overflow (>) or underflow (< ) on the Output. Input(s) Inputx (x=1-10) Numeric Input of the block. Two inputs are always visible. The other eight possible inputs can be added by the user through the Configure Ports window. Output(s) Output Numeric The average value of the inputs. Block Properties Type Range Default Description (Name) String Unlimited Average Name of the block. Description String Unlimited - Description of the block. Location Integer Unlimited - X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

146 146 LX Graphical Programming Tool Technical Bulletin Divide Description: Used to perform a standard division operation. The block outputs the division value of the connected inputs. The division is calculated as follows: Output = Input1 Input2 Input(s) Be aware that as a result of the calculation, if Input2 is between -1 and 1 it may cause an overflow (>) or underflow (< ) on the Output. If Input2 is equal to 0 and Input1 has a positive value, then the block outputs the maximum value (). If Input2 is equal to 0 and Input1 has a negative value, then the block outputs the minimum value ( ). Input1 Numeric Input2 Numeric Input of the block. The dividend. Input of the block. The divisor. Output(s) Output Numeric The division value or quotient of the inputs. Block Properties Type Range Default Description (Name) String Unlimited Divide Name of the block. Description String Unlimited - Description of the block. Location Integer Unlimited - X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

147 LX Graphical Programming Tool (GPI) Technical Bulletin 147 Maximum Description: Used to output the highest (maximum) value of the inputs. Input(s) Inputx (x=1-10) Numeric Input of the block. Two inputs are always visible. The other eight possible inputs can be added by the user through the Configure Ports window. Output(s) Output Numeric The maximum value of the inputs. Block Properties Type Range Default Description (Name) String Unlimited Maximum Name of the block. Description String Unlimited - Description of the block. Location Integer Unlimited - X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

148 148 LX Graphical Programming Tool Technical Bulletin Min/Max/Average Description: Used to calculate the minimum, maximum and average value of the inputs. The average value is calculated as follows: Output = n= 2 10 i= 1 Inputi n Be aware that as a result of the calculation, the input values may cause an overflow (>) or underflow (< ) on the Average. Inputx (x=1-10) Input(s) Output(s) Numeric Input of the block. Two inputs are always visible. The other eight possible inputs can be added by the user through the Configure Ports window. Minimum Numeric Maximum Numeric Average Numeric Block Properties The minimum value of the inputs. The maximum value of the inputs. The average value of the inputs. Type Range Default Description (Name) String Unlimited Min/Max/ Name of the block. Average Description String Unlimited - Description of the block. Location Integer Unlimited - X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

149 LX Graphical Programming Tool (GPI) Technical Bulletin 149 Example The Min/Max/Average block is used to evaluate a set of values. The following example shows how this block can compare temperatures of different zones in a space (Hardware Input blocks). Figure 100: Min/Max/Average Block Example The Min/Max/Average block outputs the minimum, maximum and average values of its inputs. In the previous example, the minimum value is 55 F being received from zone 2, the maximum value is 80 F being received from zone 4 and the average value is: 68 F + 55 F + 76 F + 80 F + 79 F 5 = 71.6 F

150 150 LX Graphical Programming Tool Technical Bulletin Minimum Description: Used to output the lowest (minimum) value of the inputs. Input(s) Inputx (x=1-10) Numeric Input of the block. Two inputs are always visible. The other eight possible inputs can be added by the user through the Configure Ports window. Output(s) Output Numeric The minimum value of the inputs. Block Properties Type Range Default Description (Name) String Unlimited Minimum Name of the block. Description String Unlimited - Description of the block. Location Integer Unlimited - X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

151 LX Graphical Programming Tool (GPI) Technical Bulletin 151 Modulus Description: Used to perform a standard modulus operation. The block outputs the modulus value or remainder of the division between the connected inputs. Input(s) Input1 Integer Input2 Integer Input of the block. The dividend. Input of the block. The divisor. Output(s) Output Integer The modulus value or remainder of the division. Block Properties Type Range Default Description (Name) String Unlimited Modulus Name of the block. Description String Unlimited - Description of the block. Location Integer Unlimited - X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Multiply Description: Used to perform a standard multiplication operation. The block outputs the multiplication value of the connected inputs. The multiplication is calculated as follows: Output = Input1 Input2 Be aware that as a result of the calculation, the input values may cause an overflow (>) or underflow (< ) on the Output.

152 152 LX Graphical Programming Tool Technical Bulletin Input(s) Inputx (x=1-2) Numeric Input of the block. Output(s) Output Numeric The multiplication value of the inputs. Block Properties Type Range Default Description (Name) String Unlimited Multiply Name of the block. Description String Unlimited - Description of the block. Location Integer Unlimited - X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Subtract Description: Used to perform a standard subtraction operation. The block outputs the subtraction value of the connected inputs. The subtraction is calculated as follows: Output = Input1 Input2. Inputs Input1 Numeric Input of the block. The minuend. Input2 Numeric Input of the block. The subtrahend. Outputs Output Numeric The subtraction value of the inputs. Block Properties Type Range Default Description (Name) String Unlimited Subtract Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

153 LX Graphical Programming Tool (GPI) Technical Bulletin 153 Multiply Description: Used to perform a standard multiplication operation. The block outputs the multiplication value of the connected inputs. Inputs Inputx (x=1-2) Numeric Input of the block. Outputs Output Numeric The multiplication value of the inputs. Block Properties Type Range Default Description (Name) String Unlimited Multiply Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

154 154 LX Graphical Programming Tool Technical Bulletin Divide Description: Used to perform a standard division operation. The block outputs the quotient of the input1/input2. The output is calculated as follows: output = input1/input2. Note: If input 2 is equal to 0 and input 1 has a positive value then the block outputs the maximum value ( ). If input 2 is equal to 0 and input has a negative value then the block outputs the minimum value ( ). Inputs Input1 Numeric Input of the block. - the dividend. Input2 Numeric Input of the block. - the divisor. Outputs Output Numeric The division value or quotient of the inputs. Block Properties Type Range Default Description (Name) String Unlimited Divide Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

155 LX Graphical Programming Tool (GPI) Technical Bulletin 155 Absolute Description: Used to perform a standard absolute operation. The block outputs the absolute value of the connected input. Inputs Input of the block. Note: Input Numeric - Outputs is not a value supported by the Absolute block. If such a value were to be inputted then the block outputs a value of Output Numeric 0 The absolute value of the input. Block Properties Type Range Default Description (Name) String Unlimited Absolute Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Modulus Description: Used to perform a standard modulus operation. The block outputs the modulus value or remainder of input1 divided by input2. Inputs Input1 Integer Input of the block. The dividend Input2 Integer Input of the block. The divisor

156 156 LX Graphical Programming Tool Technical Bulletin Outputs Output Integer The modulus value or remainder of the division of the inputs. Block Properties Type Range Default Description (Name) String Unlimited Modulus Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Summation Description: Used to perform a standard summation operation. The value of the input is added to the previous value of the input over a user-defined time interval. The value is then outputted from the block. Inputs Input Numeric Input of the block. Reset Digital 0 or 1 Enabling this input (1) resets the output to 0. Outputs Output Numeric The summation value of the input. Count Numeric 0 Block Properties Number of times that the block has performed a summation operation. Type Range Default Description (Name) String Unlimited Summation Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. TimeInterval Numeric The summation time interval in minutes. Note: Minimum time interval is 30 seconds (0.5 min).resolution: ± 1 second.

157 LX Graphical Programming Tool (GPI) Technical Bulletin 157 Example The Summation block can be used to perform a mathematical calculation. The following example shows how this block can be used along with Hardware Output, Multiply, Internal Constant, Variable Numeric, Real Time Clock, Not Equal, and Conditional Custom blocks to calculate the Daily Power Consumption (Variable Numeric block) of a Duct Heater (Hardware Output block). The Duct Heater (Hardware Output block) outputs the percentage of power used by the equipment. The Multiply block multiplies this percentage by the total power capacity of the equipment (5kW) and outputs the Instantaneous Kilowatt Usage (Variable Numeric block). The Summation block takes this value and adds it to the previous value every minute. The Multiply block then multiplies this result by 24 hours so that after a day has passed, it outputs the Daily Power Consumption (Variable Numeric block) in kilowatt hours (kwh). The Real Time Clock, Variable Numeric, Not Equal and Conditional Custom blocks make up a sequence whereby the Summation block is reset after a day has passed. Square Root Description: Used to perform a standard square root operation. The block outputs the square root value of the connected input. Inputs Input Numeric 0 Input of the block. Outputs Output Numeric The square root value of the input.

158 158 LX Graphical Programming Tool Technical Bulletin Block Properties Type Range Default Description (Name) String Unlimited Square Root Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Example The Square Root block can be used to perform a mathematical calculation. The following example shows how this block can be used along with Multiply and Internal Constant blocks to calculate airflow when given a Supply Air Velocity Pressure from a Hardware Input block. Figure 101: Square Root Block Example The Square Root block outputs the square root of the Supply Air Velocity Pressure, while the Multiply blocks output the Air Velocity, Duct Area and Flow, respectively. The previous example is representative of the following equation: Q = 4005A p v Q = Air flow ( CFM) p v = Supply air velocity pressure (1.13) A = Duct area, L x W (2ft x 2ft or 4ft 2 )

159 LX Graphical Programming Tool (GPI) Technical Bulletin 159 Minimum Description: Used to output the lowest (minimum) value of the inputs. Inputs Inputx (x=1-10) Numeric Input of the block. Note: Two inputs are always visible. The other eight possible inputs can be added by the user through the Configure Ports window. Outputs Output Numeric The minimum value of the inputs. Block Properties Type Range Default Description (Name) String Unlimited Minimum Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

160 160 LX Graphical Programming Tool Technical Bulletin Maximum Description: Used to output the highest (maximum) value of the inputs. Inputs Inputx (x=1-10) Numeric Input of the block. Note: Two inputs are always visible. The other eight possible inputs can be added by the user through the Configure Ports window. Outputs Output Numeric The maximum value of the inputs. Block Properties Type Range Default Description (Name) String Unlimited Maximum Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

161 LX Graphical Programming Tool (GPI) Technical Bulletin 161 Average Description: Used to calculate the average value of the inputs. Inputs Inputx (x=1-10) Numeric Input of the block. Note: Two inputs are always visible. The other eight possible inputs can be added by the user through the Configure Ports window. Outputs Output Numeric The average value of the inputs. Block Properties Type Range Default Description (Name) String Unlimited Average Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

162 162 LX Graphical Programming Tool Technical Bulletin Min/Max/Average Description: Used to calculate the minimum, maximum and average value of the inputs. Inputs Inputx (x=1-10) Numeric Input of the block. Note: Two inputs are always visible. The other eight possible inputs can be added by the user through the Configure Ports window. Outputs Minimum Numeric The minimum value of the inputs. Maximum Numeric The maximum value of the inputs. Average Numeric The average value of the inputs. Block Properties Type Range Default Description (Name) String Unlimited Min/Max/ Name of the block. Average Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

163 LX Graphical Programming Tool (GPI) Technical Bulletin 163 Example The Min/Max/Average block is used to evaluate a set of values. The following example shows how this block can compare temperatures of different zones in a space (Hardware Input blocks). Figure 102: Min/Max/Average Block Example The Min/Max/Average block outputs the minimum, maximum and average values of its inputs. In the previous example the minimum value is 55 F being received from zone 2, the maximum value is 80 F being received from zone 4 and the average value is: 68 F + 55 F + 76 F + 80 F + 79 F 5 = 71.6 F SNVT Conversions The SNVT Conversion blocks are used to deal with structured SNVT types of 2 bytes length. The following blocks are available in this category: SNVT_scene Demux SNVT_scene Mux SNVT_state Demux SNVT_state Mux SNVT_switch Demux SNVT_switch Mux

164 164 LX Graphical Programming Tool Technical Bulletin SNVT_scene Demux Description: Used to deconstruct a SNVT_scene type into its separate components. SNVT_scene is composed of a Function and a Scene_number. Inputs SNVT_scene Numeric Input of the block. Outputs Function Numeric The Function component of SNVT_scene. Scene_ number Enum The Scene_number component of SNVT_scene. Block Properties Type Range Default Description (Name) String Unlimited SNVT_ Name of the block. scene Demux Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Example The SNVT_scene Demux block is used to deconstruct a network variable of the SNVT_scene type. The following example shows how this block receives a value from a Network Variable Input block, deconstructs it and sends it to control a Light (Hardware Output block) through the use of Internal Constant, Comparator, Logic, Rising Edge, Conditional Custom, and Variable Numeric blocks.

165 LX Graphical Programming Tool (GPI) Technical Bulletin 165 Figure 103: SNVT_scene Demux Block Example The SNVT_scene Demux block receives a value from the Network Variable Input block and separates it into its Function and Scene_number outputs. If the Function is SC_RECALL and the Scene_number is 5, then the Scene 5 Lighting Conditional Custom block is Enabled and the Light (Hardware Output block) turns ON. If the Function is SC_RECALL and the Scene_number is 6, then the Scene 6 Lighting Conditional Custom block is Enabled and the Light (Hardware Output block) turns OFF. SNVT_scene Mux Description: Used to construct a SNVT_scene type from its separate components. SNVT_scene is composed of a Function and a Scene_number. Inputs Function Numeric The Function component of SNVT_scene. Scene_ number Integer The Scene_number component of SNVT_scene. Outputs SNVT_scene Numeric Output of the block.

166 166 LX Graphical Programming Tool Technical Bulletin Block Properties Type Range Default Description (Name) String Unlimited SNVT_ Name of the block. scene Mux Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Example The SNVT_scene Mux block is used to construct a network variable of the SNVT_scene type. The following example shows how this block can be used with Schedule, Multiplexer, and Internal Constant block to create a network variable that is sent to a Network Variable Output block. Figure 104: SNVT_scene Mux Block Example The SNVT_scene Mux block receives a SC_RECALL value into its Function input from the Internal Constant block and a value of 5 into its Scene_number input from the Multiplexer block, which makes Boolean values out of the input it receives from the Schedule block. This Function and Scene_number are then joined to create a network variable of the SNVT_scene type and is sent to the Network Variable Output block.

167 LX Graphical Programming Tool (GPI) Technical Bulletin 167 SNVT_state Demux Description: Used to deconstruct a SNVT_state type into its separate components. SNVT_state is composed of Bit0 - Bit15. Inputs SNVT_state Numeric Input of the block. Outputs Bitx (x=0-15) Digital 0 or 1 The Bit component of SNVT_state. Block Properties Type Range Default Description (Name) String Unlimited SNVT_ Name of the block. state Demux Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

168 168 LX Graphical Programming Tool Technical Bulletin Example The SNVT_state Demux block is used to deconstruct a network variable of the SNVT_state type. The following example shows how this block receives a value from a Network Variable Input block, deconstructs it and sends it to control 2 Evaporative Condenser Fans of 4 speeds each (Hardware Output blocks). Figure 105: SNVT_state Demux Block Example The SNVT_state Demux block receives a value from the Network Variable Input block and separates it into its appropriate bits. These bits are then sent to Hardware Output blocks to control the speeds of evaporative condenser fans.

169 LX Graphical Programming Tool (GPI) Technical Bulletin 169 SNVT_state Mux Description: Used to construct a SNVT_state type from its separate components. SNVT_state is composed of Bit0 Bit15. Inputs Bitx (x=0-15) Digital 0 or 1 The Bit component of SNVT_state. Outputs SNVT_state Numeric Output of the block. Block Properties Type Range Default Description (Name) String Unlimited SNVT_ Name of the block. state Mux Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

170 170 LX Graphical Programming Tool Technical Bulletin Example The SNVT_state Mux block is used to construct a network variable of the SNVT_state type. The following example shows how this block can be used along with Hardware Input, Internal Constant, Numeric Fault, Digital Fault, and Hardware Output blocks to create a network variable that is sent to a Network Variable Output block. Figure 106: SNVT_state Mux Block Example The SNVT_state Mux block receives digital values from Digital Fault, Numeric Fault and Hardware Input blocks into its first 8 Bit inputs. These Bits are then joined to create a network variable of the SNVT_state type and is sent to the Network Variable Output block. SNVT_switch Demux Description: Used to deconstruct a SNVT_switch type into its separate components. SNVT_switch is composed of a Value and a State. Inputs SNVT_switch Numeric Input of the block. Outputs Value Numeric The Value component of SNVT_switch. State Digital 0 or 1 The State component of SNVT_switch.

171 LX Graphical Programming Tool (GPI) Technical Bulletin 171 Block Properties Type Range Default Description (Name) String Unlimited SNVT_ Name of the block. switch Demux Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Example The SNVT_switch Demux block is used to deconstruct a network variable of the SNVT_switch type. The following example shows how this block receives a value from a Network Variable Input block, deconstructs it and sends it to control a Fan and Variable Frequency Drive (Hardware Output blocks). Figure 107: SNVT_switch Demux Block Example The SNVT_switch Demux block receives a value from the Network Variable Input block and separates it into its Value and State outputs. The Value is sent to control the speed of a Variable Frequency Drive (Hardware Output block) and the State is sent to turn a Fan (Hardware Output block) ON and OFF. SNVT_switch Mux Description: Use to construct a SNVT_switch type from its separate components. SNVT_switch is composed of a Value and a State. Inputs Value Numeric The Value component of SNVT_switch. State Digital 0 or 1 The State component of SNVT_switch. Outputs SNVT_switch Numeric Output of the block.

172 172 LX Graphical Programming Tool Technical Bulletin Block Properties Type Range Default Description (Name) String Unlimited SNVT_ Name of the block. switch Mux Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Example The SNVT_switch Mux block is used to construct a network variable of the SNVT_switch type. The following example shows how this block can be used with Hardware Output, Multiply, and Internal Constant blocks to create a network variable that is sent to a Network Variable Output block. Figure 108: SNVT_switch Mux Block Example The SNVT_switch Mux block receives an ON (1) value into its State input from the Hardware Output block and a value of 100 into its Value input from the Multiply block, which multiplies the ON (1) value received from the Hardware Output block by 100. This Value and State are then joined to create a network variable of the SNVT_switch type and is sent to the Network Variable Output block. Time Time blocks are used to configure delays, schedules and time. The following blocks are available in this category: Min On Time Min Off Time Min On Off Time Start Delay Stop Delay Start Stop Delay Timer Schedule Real Time Clock

173 LX Graphical Programming Tool (GPI) Technical Bulletin 173 Min On Time Description: Use to maintain the output in the ON state for a user-defined duration. Inputs Input Digital 0 or 1 Input of the block. MinOn Numeric The minimum time (in seconds) that the output is maintained in the ON position before it can be turned OFF. Enable Digital 0 or 1 When set to ON (1), the block is enabled and the output follows the MinOn timer. If set to OFF (0) then the output directly follows the input. Outputs Output Digital 0 or 1 The output value of the object. Block Properties Type Range Default Description (Name) String Unlimited Min On Name of the block. Time Description String Unlimited - Description of the block. TimeBase Location Menu Integer See Description Second - Select the unit of time: Second, Minute or Hour. X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

174 174 LX Graphical Programming Tool Technical Bulletin Example The Min On Time block is used to keep an output ON for a specific duration. The following example shows how this block is used with SmartSensor Module, PID, Schedule, Equal, Logic and Internal Constant blocks to keep an override (bypass occupancy) command ON for 60 minutes. Figure 109: Min On Time Block Example The Min On Time block receives its Input from the Override of the SmartSensor Module block. When the Override turns ON, the Min On Time block outputs an ON value for 60 minutes. When the unoccupied mode is scheduled and the override is turned ON, the Switch blocks output bypass mode, which is sent and displayed on the SmartSensor Module block.

175 LX Graphical Programming Tool (GPI) Technical Bulletin 175 Min Off Time Description: Use to maintain the output in the OFF state for a userdefined duration. Inputs Input Digital 0 or 1 Input of the block. MinOff Numeric The minimum time (in seconds) that the output is maintained in the OFF position before it can be turned ON. Enable Digital 0 or 1 When set to ON (1), the block is enabled and the output follows the MinOff timer. If set to OFF (0) then the output directly follows the input. Outputs Output Digital 0 or 1 The output value of the object. Block Properties Type Range Default Description (Name) String Unlimited Min Off Name of the block. Time Description String Unlimited - Description of the block. TimeBase Location Menu Integer See Description Second - Select the unit of time: Second, Minute or Hour. X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

176 176 LX Graphical Programming Tool Technical Bulletin Min On Off Time Description: Use to maintain the output in the ON and OFF state for a user-defined duration. Inputs Input Digital 0 or 1 Input of the block. MinOn Numeric The minimum time (in seconds) that the output is maintained in the ON position before it can be turned OFF. MinOff Numeric The minimum time (in seconds) that the output is maintained in the OFF position before it can be turned ON. Enable Digital 0 or 1 When set to ON (1), the block is enabled and the output follows the MinOff timer. If set to OFF (0) then the output directly follows the input. Outputs Output Digital 0 or 1 The output value of the object. Block Properties Type Range Default Description (Name) String Unlimited Min On Name of the block. Off Time Description String Unlimited - Description of the block. TimeBase Location Menu Integer See Description Second - Select the unit of time: Second, Minute or Hour. X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

177 LX Graphical Programming Tool (GPI) Technical Bulletin 177 Start Delay Description: Use to provide a delay before turning the output ON. The input must remain ON for the duration of the delay before the block s output is turned ON. Inputs Input Digital 0 or 1 Input of the object. Delay Numeric The minimum time (in seconds) that the input must stay ON before the output is turned ON. Enable Digital 0 or 1 When set to ON (1), the block is enabled and the output follows the Delay timer. If set to OFF (0), the output directly follows the input. Outputs Output Digital 0 or 1 The output value of the object. Block Properties Type Range Default Description (Name) String Unlimited Start Name of the block. Delay Description String Unlimited - Description of the block. TimeBase Location Menu Integer See Description Second - Select the unit of time: Second, Minute or Hour. X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

178 178 LX Graphical Programming Tool Technical Bulletin Example The Start Delay block is used to delay the turning ON of an output for a specific duration. The following example shows how this block is used with Network Variable Input, Greater Or Equal, Logic, Add, and Internal Constant blocks to delay the increase of the Effective Static Pressure Setpoint (Variable Numeric block) when one of the dampers is open more than 90%. Figure 110: Start Delay Block Example The Start Delay block receives an ON Input when it is outputting an OFF value and when one of the dampers is greater than 90%. If after 3 minutes, the Start Delay block is still receiving an ON Input, it outputs an ON value and starts increasing the Effective Static Pressure Setpoint (Variable Numeric block) by 0.1 inch WC. Stop Delay Description: Use to provide a delay before turning the output OFF. The input must remain OFF for the duration of the delay before the block s output is turned OFF.

179 LX Graphical Programming Tool (GPI) Technical Bulletin 179 Inputs Input Digital 0 or 1 Input of the object. Delay Numeric The minimum time (in seconds) that the input must stay OFF before the output is turned OFF. Enable Digital 0 or 1 When set to ON (1), the block is enabled and the output follows the Delay timer. If set to OFF (0) then the output directly follows the input. Outputs Output Digital 0 or 1 The output value of the object. Block Properties Type Range Default Description (Name) String Unlimited Stop Name of the block. Delay Description String Unlimited - Description of the block. TimeBase Location Menu Integer See Description Second - Select the unit of time: Second, Minute, or Hour. X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Start Stop Delay Description: Use to provide a delay before turning the output ON and OFF. The input must remain ON for the duration of the start delay before the block s output is turned ON. The input must remain OFF for the duration of the stop delay before the block s output is turned OFF.

180 180 LX Graphical Programming Tool Technical Bulletin Inputs Input Digital 0 or 1 Input of the object. StartDelay Numeric The minimum time (in seconds) that the input must stay ON before the output is turned ON. StopDelay Numeric The minimum time (in seconds) that the input must stay OFF before the output is turned OFF. Enable Digital 0 or 1 When set to ON (1), the block is enabled and the output follows the StartDelay and StopDelay timers. If set to OFF (0), then the output directly follows the input. Outputs Output Digital 0 or 1 The output value of the object. Block Properties Type Range Default Description (Name) String Unlimited Start Stop Name of the block. Delay Description String Unlimited - Description of the block. TimeBase Location Menu Integer See Description Second - Select the unit of time: Second, Minute or Hour. X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Timer Description: Use to calculate the amount of time that the equipment has been running. Number of Blocks: 15 Inputs Input Digital 0 or 1 Input of the block. Reset Digital 0 or 1 Enabling this input (1) resets the output to 0. Outputs Output Numeric The time count in seconds. The time count stops automatically when the range limit (83886 seconds) is reached.

181 LX Graphical Programming Tool (GPI) Technical Bulletin 181 Block Properties Type Range Default Description (Name) String Unlimited Timer Name of the block. Description String Unlimited - Description of the block. IntervalType Menu See Descriptio n Second The unit of time that the timer uses. Use the drop-down menu to select Second, Minute, or Hour. Number Menu See Descriptio n Timer 1 The number of blocks available. Use the drop-down menu to select from the 15 available blocks. Note: When a new Timer block is added to the drawings, the block s number is incremented to the next available block number. Persist Location Menu Integer See Descriptio n False - When this option is true, the output state is preserved during any type of reset. X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Schedule Description: Use to calculate the amount of time that the equipment has been running. Number of Blocks: 2 Inputs - N/A Outputs Current State Enum -1 3 Current scheduled status state based on the occup_t enumeration. The values are defined as follows: -1 = OC_NUL 0 = OC_OCCUPIED 1 = OC_UNOCCUPIED 2 = OC_BYPASS 3 = OC_STANDBY NextState Enum 0 3 Next scheduled status state based on the occup_t enumeration. The values are defined as follows: 0 = OC_OCCUPIED 1 = OC_UNOCCUPIED 2 = OC_BYPASS 3 = OC_STANDBY TimeToNext Numeric Time (in minutes) to the next status state. State Com Failure Digital 0 or 1 Communication failure alarm status.

182 182 LX Graphical Programming Tool Technical Bulletin Block Properties Type Range Default Description (Name) String Unlimited Schedule Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Number Menu See Description Schedule 1 The number of blocks available. Use the drop-down menu to select from the 2 available blocks. Note: When a new Schedule block is added to the drawings, the block s number is incremented to the next available block number. Width Integer Width of the block. Real Time Clock Description: Supplies and maintain real time for a controller. Device Support: LX-PRG203, LX-PRG300, LX-PRG4x0, LX- PRG5x0. Inputs - N/A

183 LX Graphical Programming Tool (GPI) Technical Bulletin 183 Outputs Year Integer The current 4-digit year. Month Enum 1 12 The current month: 1 = January 2 = February 3 = March 4 = April 5 = May 6 = June 7 = July 8 = August 9 = September 10 = October 11 = November 12 = December Day Integer 1 31 The current day of the month. DayOfWeek Enum 0 6 The current day of the week. 0 = Sunday 1 = Monday 2 = Tuesday 3 = Wednesday 4 = Thursday 5 = Friday 6 = Saturday Hour Integer 0 23 The current hour. Minute Integer 0 59 The current minute of the hour. Second Integer 0 59 The current second. Block Properties Type Range Default Description (Name) String Unlimited Real Name of the block. Time Clock Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Tools Tools are blocks that are used to help program developers keep their codes organized. The following blocks are available in this category: Text Monitor

184 184 LX Graphical Programming Tool Technical Bulletin Reference Hub Reference Target Text Description: Use to write comments or explanations about the program. Inputs - N/A Outputs - N/A

185 LX Graphical Programming Tool (GPI) Technical Bulletin 185 Block Properties Type Range Default Description Alignment Menu See Description Left The alignment of the text. Use the drop-down menu to select left, center, or right. Description String Unlimited - Description of the block. Text String Unlimited - Text of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Size Integer Width of the page within the block Height of the page within the block. Monitor Description: Use to monitor values in the program. Inputs Reference Hub Input Numeric Input of the block. Outputs - N/A Block Properties Type Range Default Description Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Description: Use to organize a code by providing a reference to an output of a block. Inputs - N/A Outputs N/A

186 186 LX Graphical Programming Tool Technical Bulletin Block Properties Type Range Default Description Description String Unlimited - Description of the block. TagName String Unlimited - Reference tag name to link to target. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Reference Target Description: Used to organize a code by providing a reference to an input of a block. Inputs - N/A Outputs-N/A Block Properties Type Range Default Description Description String Unlimited - Description of the block. TagName Menu See Description Location Integer Select a tag name to link target to the desired hub. X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. VAV Use VAV blocks to interface with the flow sensor and actuator of a free programmable VAV controller for single-duct and dual-duct applications. The following blocks are available in this category: Damper Control Flow Sensor Damper Control Description: Use to interface with the VAV controller s damper actuator for flow control.

187 LX Graphical Programming Tool (GPI) Technical Bulletin 187 Inputs Flow Numeric 0 FlowSetPt Numeric 0 ControlMode Actual flow value read from the sensor input. Flow setpoint. DamperPos Numeric Damper position feedback. Outputs DamperCmd Numeric Damper command. DamperPos Numeric Actual damper position. Block Properties Type Range Default Description (Name) String Unlimited Damper Control Name of the block. Description String Unlimited - Description of the block. Location Integer X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block. Flow Sensor Description: Use to interface with the VAV controller s differential pressure sensor input to measure airflow. Inputs MinFlow Numeric 0 Minimum flow. MaxFlow Numeric 0 Maximum flow. Demand Numeric 0 Flow demand. ZeroCalib Digital 0 or 1 Zero calibration.

188 188 LX Graphical Programming Tool Technical Bulletin Outputs Pressure Numeric 0 Flow Numeric 0 FlowSetpoint Numeric 0 Block Properties Actual air pressure. Actual flow value read from the sensor input. Flow setpoint. Type Range Default Description (Name) String Unlimited Flow Sensor Name of the block. Description String Unlimited - Description of the block. FlowFormat Menu See Descriptio n Pressure Format Menu See Descriptio n Location Integer The format of the flow. The available formats are: SNVT_flow#SI SNVT_flow#US UNVT_flow#SI_m3h - The format of the differential pressure. The available formats are: SNVT_press_p#SI SNVT_press_p#US UNVT_press_p#US_milli X-coordinate of the block location. Y-coordinate of the block location. Width Integer Width of the block.

189 Graphical Programming Tool (GPI) Technical Bulletin 189 Appendix A: Quick Start Guide This section provides you with an example of how to create a new project, develop a control sequence, and build and debug a project. Creating a New Project The first thing that appears when you launch the GPI tool from a blank controller is an empty Programming Sheet. This is where you assemble the control sequence. Figure 111: New Project To create the new project: 1. Open the Project Explorer pane and select the project. Figure 112: New Project Explorer Pane 2009 Johnson Controls, Inc. Code No. LIT

190 190 LX Graphical Programming Tool Technical Bulletin 2. Open the Properties pane. Here is where information about the project can be entered. 3. Select the (Name) field and enter the name of the project. 4. Select the MeasurementSystem field and the units of measurement (Metric or English). Figure 113: New Project Properties Configuration 5. Select the Author, ControllerType, Description and/or Version fields to enter the name of the author of the project, the type of controller for which the project is created, a description of the project and the version number of the project. Developing a Control Sequence To develop a control sequence: 1. Open the Toolbox pane and select the Inputs & Outputs category. 2. Drag and drop the Hardware Input block onto the Programming Sheet.

191 LX Graphical Programming Tool (GPI) Technical Bulletin 191 Figure 114: Hardware Input Block 3. With the Hardware Input block selected, enter the name of the block in the Properties pane. Figure 115: Naming Hardware Input Block 4. Open the Hardware Input Configuration window.

192 192 LX Graphical Programming Tool Technical Bulletin Figure 116: Opening Hardware Input Configuration Window 5. Configure a standard 10k ohm type II thermistor with a range of F. Figure 117: Configuring Hardware Input Block 6. Open the Configure Ports window.

193 LX Graphical Programming Tool (GPI) Technical Bulletin 193 Figure 118: Opening Hardware Input Configure Ports Window 7. Configure the Output to have a SNVT_temp_p#US format. Figure 119: Formatting Output of Hardware Input Block 8. Drag and drop the PID block onto the Programming Sheet. 9. Hide the Enabled input and configure the Output to have a % format.

194 194 LX Graphical Programming Tool Technical Bulletin Figure 120: Hiding the Enabled Port of the PID Block 10. Connect the Output of the Hardware Input block to the Input of the PID block. Figure 121: Connecting the Hardware Input Block to the Pid Block 11. Add an Internal Constant block to the Programming Sheet by right-clicking on the Setpoint port of the PID block and selecting Link To Constant... from the drop-down menu.

195 LX Graphical Programming Tool (GPI) Technical Bulletin 195 Figure 122: Linking the Setpoint of the PID Block to an Internal Constant Block 12. Configure the Internal Constant block to have a SNVT_temp_p#US format and give it a value of 70. Figure 123: Entering the Value of the Internal Constant Block 13. Add a PWM Hardware Output block named Cooling Valve with a range of 0-100% and a period of 10 seconds to the Programming Sheet, format the Output to be in % and monitor it, and connect its Input to the Output of the PID block. Figure 124: Completed Control Sequence

196 196 LX Graphical Programming Tool Technical Bulletin Building a Project Once the control sequence is created, it needs to be built before it can be put into effect. The sequence can either be built only or be built and sent to the device. Figure 125: Build Options Once the sequence is built certain information can be viewed in various panes at the bottom of the GPI tool. The Output pane shows the progress of the build and displays the steps involved. Figure 126: Output Pane The Statistics pane presents the memory used, the compilation time and the resources allocated to the build by the device. Figure 127: Statistics Pane

197 LX Graphical Programming Tool (GPI) Technical Bulletin 197 The Error List pane highlights any errors that may have occurred in the assembly of the sequence. When an error message is double-clicked, that part of the sequence is highlighted in the Programming Sheet. Figure 128: Error List Pane Figure 129: Highlighted Error Finally the Resources Viewer pane displays information about all the inputs, outputs, constants and variables available in the device. Figure 130: Resources Viewer Pane Debugging a Project Once the control sequence is built, it can be debugged to show the values outputted by each block. This is useful to view the execution of the sequence and to spot any anomalies or errors in the control logic. Figure 131: Debugging Building Efficiency 507 E. Michigan Street, Milwaukee, WI Johnson Controls are registered trademark of Johnson Controls, Inc. All other marks herein are the marks of their respective owners Johnson Controls, Inc.