Facility Prime User Guide. For Facility Prime and Facility Prime Editor Applications

Transcription

1 Facility Prime User Guide For Facility Prime and Facility Prime Editor Applications Building Technologies

2 Copyright Notice Notice Document information is subject to change without notice by Siemens Industry, Inc. Companies, names, and various data used in examples are fictitious unless otherwise noted. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Siemens Industry, Inc. All software described in this document is furnished under a license agreement and may be used or copied only in accordance with license terms. For further information, contact your nearest Siemens Industry, Inc. representative. Copyright 2015 by Siemens Industry, Inc. To the Reader Your feedback is important to us. If you have comments about this document, please submit them to: SBT_technical.editor.us.sbt@siemens.com. Credits Facility Prime is a trademark of Siemens Industry, Inc. APOGEE and Insight are registered trademarks of Siemens Industry, Inc. Other product or company names mentioned herein may be the trademarks of their respective owners. Printed in the USA. 2

3 Contents How to Use This Guide... 8 Conventions... 8 Safety Symbols... 9 Getting Help... 9 Part 1: Getting Started Overview Tabs Graphics Tab List View Tab Charts Tab Tools Tab Connecting to the BAS Logging In to the BAS Logging Out of Facility Prime Part 2: Working with Graphics Introduction Displaying Graphics Generating a PDF File of a Graphic Changing Settings and Values Using the Navigation Bar Viewing the Current User s Name and Accessing the User Account Verification Dialog box Plotting Dynamic Values of Point Labels Viewing and Responding to Alarms Viewing a Node Hierarchy Part 3: Using Charts Using the Charts Tab Generating a PDF File of a Chart Part 4: Using Facility Prime Tools Introduction Creating Scannable QR Codes Scanning QR Codes Using the BACnet Browser Downloading Data Importing Data Viewing Data in the Browser Removing Field Panel and Point Data from the Browser Exporting a Point List to a Text File Using the Siemens P2 Browser

4 Downloading Data Importing Field Panel Data Removing Field Panel and Point Data from the Browser Exporting a Point List to a Text File Using the Program Viewer Using the Schedule Viewer Using Node Builder Creating a Node Hierarchy Manually Creating a Hierarchy by Importing Field Panel Data Part 5: Managing Files Introduction Setting a Home Graphic (Editor only) Copying a Graphic (Editor only) Creating Templates (Editor only) Exporting Graphics Erasing exported graphic backup files from the ipad (Editor only) Importing Graphics Renaming a Graphic (Editor only) Deleting a Graphic Transferring Files between a Computer and the ipad Part 6: Creating Graphics with Facility Prime Editor Introduction Steps to Success Prerequisite Knowledge and Skills Process Overview Plan Prepare Design Test Online and Offline Editing Planning for Online Editing Planning for Offline Editing Enabling Edit Mode Adding a Container Enabling Snap to Grid Adding Background Images Adding Graphic Elements Linking Elements to Points Configuring and Formatting Elements

5 Filtering Elements Removing Elements from a Graphic Part 7: Configuring Elements (Editor only) Introduction Monitor Elements Alarm Group Circular Gauge Data Feed Gradient Indicator Point Table Space Sensor Vertical Indicator Command Elements Analog Commander Binary Commander Display Button State Commander Monitor and Command Elements Analog Display Group Temperature, Humidity, Ventilation, Lights, Air Quality, and Blinds Mini Temperature, Humidity, CO2, Pressure, and Lights Point Label Critical Environments Elements LvlLightCntrl (three-level light control) ACH Hazard Sign Pressure Ball Vertical Gauge General Use Elements Document FLN Device Image Link Commander Position Animation Rotation View Text Graphs Analytic Graph Bar Graph

6 Charts Dynamic Plotter, Trend Plotter Line Graph Pie Graph Sample Graph Special Use Elements CCTV Location SVG Appendix A: APOGEE BAS and ipad Settings Add the ipad to the APOGEE Network Configure Facility Prime/Facility Prime Editor Settings on the ipad Appendix B: Element Quick Reference LvlLightCntrl (three-level light control) ACH Analog Commander Analog Display Analytic Graph Bar Graph Binary Commander Circular Gauge Display Button Dynamic Plotter, Trend Plotter FLN Device Gradient Indicator Group Temperature, Humidity, Ventilation, Lights, Air Quality, and Blinds Line Graph Location Mini Temperature, Humidity, CO2, Pressure, and Lights Pie Graph Point Label Point Table Pressure Ball Sample Graph Space Sensor State Commander Vertical Gauge Vertical Indicator Index

7 7

8 How to Use This Guide This guide is for users of the Facility Prime family of applications (Facility Prime and Facility Prime Editor). The Facility Prime Editor application provides all the capabilities of the Facility Prime application for viewing and commanding points, plus the ability to create and edit Facility Prime graphics. Conventions The following table lists conventions to help you use this manual in a quick and efficient manner. Convention Numbered Lists (1, 2, 3 ) indicate a procedure with sequential steps. Actions that should be performed are specified in boldface font. Examples 1. Turn OFF power to the field panel. 2. Turn ON power to the field panel. 3. Contact the local Siemens Industry representative. Type F for Field panels. Tap OK to save changes and close the dialog box. This symbol signifies Notes. Notes provide additional information or helpful hints. Placeholders indicate text that can vary based on your selection. Placeholders are specified by italicized letters and enclosed with brackets [ ]. Type A C D H [username] [field panel #]. 8

9 Safety Symbols The following table lists the safety symbols used in this manual to draw attention to important information. Symbol Meaning Description CAUTION Equipment damage may occur if a procedure or instruction is not followed as specified. WARNING Personal injury or property damage may occur if a procedure or instruction is not followed as specified. DANGER Electric shock, death, or severe property damage may occur if a procedure or instruction is not followed as specified. Getting Help For more information, visit the Facility Prime website at and contact your local Siemens Industry, Inc. representative. The information in this guide is also available from within the Facility Prime application. Tap and then tap? to open the Help panel to view descriptive and procedural information. From the Help panel, you can also connect to the Facility Prime Web site and send us an at facilityprime.industry@siemens.com. 9

10 1 Part 1: Getting Started Overview With Siemens Facility Prime applications, you can use an Apple ipad tablet to wirelessly connect to Ethernet-based building automation system (BAS) field panels to monitor and control the BAS (at least one APOGEE field panel is required). There are two versions of the application: Facility Prime and Facility Prime Editor. The Facility Prime Editor application has the same features as Facility Prime plus additional features for creating graphics. NOTE: This guide provides instructions for both the Facility Prime and Facility Prime Editor applications. The features available only in Facility Prime Editor are identified as such. 10

11 1 Tabs Facility Prime has four tabs, located on the tab bar at the bottom of the application: Graphics, List View, Charts, and Tools. Graphics Tab Use the Graphics tab to view BAS status and to change settings and values through interactive graphics and links. Graphics are created with the Facility Prime Editor application, which is sold separately. Each graphic is composed of various elements that link to points in your BAS. For more information about Facility Prime Editor, visit the Facility Prime website at or the itunes Store. Only one graphic may be active at a time. The active graphic determines the information displayed on the List View and Charts tabs. 11

12 1 List View Tab The List View tab shows a scrollable list of the elements in a graphic that are linked to points. Only those elements with values appear in the list view. Elements that are not linked to points and image elements do not appear. 12

13 1 Charts Tab The Charts tab displays point data from the active graphic plotted on scatter (line), bar, or pie charts. You can customize the chart appearance, such as the colors and line types. NOTE: The chart types and data values are selected through graphic elements configured with the Facility Prime Editor. For information on creating charts, see Charts on page

14 1 Tools Tab Use the Tools tab to create scannable QR codes, to view BAS field panels, points, programs, and schedules, and to build a node hierarchy with Node Builder. 14

15 1 Connecting to the BAS The Facility Prime applications use Wi-Fi communications to communicate with your BAS through the BAS field panels. The BAS must have at least one APOGEE field panel that uses Siemens P2 Ethernet communications or BACnet/IP communications to manage user authentication. After authenticating with this panel, Facility Prime can communicate with any Siemens P2 Ethernet panel, native BACnet panel, or Siemens Insight BACnet Server. NOTE: Facility Prime does not work with APOGEE Ethernet Microservers (AEMs) or RS-485 networks. For sites with AEMs or RS-485 networks, it is recommended that you install the Insight BACnet Server option to make AEM points available through the BACnet Server interface. The sizing, configuration, and installation of the Insight BACnet Server option are outside the scope of this document. Before you begin using Facility Prime, verify that the APOGEE network and the ipad have been configured. See Appendix A: APOGEE BAS and ipad Settings on page 136 for instructions. Logging In to the BAS You can perform many tasks in Facility Prime without logging in to the BAS. For example, you can: View graphics, object lists, and charts. Create and reports. Create and scan QR codes. Import and export graphic files. However, to perform the following tasks, you must log in to the BAS with at least Command access rights: Command and release points. Change configuration parameters, such as alarm limits and state values. You may be instructed to log in to Facility Prime using your BAS user initials and password, or your system administrator may have provided you with a secure QR code and PIN. If you are unsure of how you will log in to Facility Prime, or if you need a higher access level, contact your building automation system administrator. Prior to the first time you log in, you must enter address information for the field panel that will authenticate your Building Level Network (BLN) user account credentials. 15

16 1 To enter field panel address information: 1. Tap and then tap Users. The User Account Verification dialog box appears. 2. Tap. The Authorization Panel Information dialog box appears. 3. Tap the network type. 4. Do one of the following: If the panel is a BACnet panel, enter the BLN name, panel instance number, and IP address for the field panel that will authenticate your BLN user access rights. If the panel is a Siemens P2 panel, enter the BLN name, panel name, and IP address for the field panel that will authenticate your BLN user access rights. 5. Tap Set Panel Info. The panel information is saved. To log in to Facility Prime with user initials and a password: 1. Tap and then tap Users. The User Account Verification dialog box appears. 2. Enter the user initials and password for the BLN account and tap Log In. To log in to Facility Prime with a secure QR code: 1. Tap and then tap Users. The User Account Verification dialog box appears. 2. Tap Scan Log In. The ipad camera viewer appears. 3. Center the secure QR code in the ipad camera viewer. The Code Scanner automatically scans the QR code and verifies your credentials. 4. If the QR code is accepted, the User PIN dialog box appears. Enter your PIN and then tap OK. 16

17 1 Logging Out of Facility Prime Follow the instructions below to log out of Facility Prime. To log out, do one of the following: Tap and then tap Users. The User Account Verification dialog box appears. Tap Log Out. Tap anywhere in the Graphics tab. The navigation bar appears at the top of the Facility Prime window. Tap User:[username]. The User Account Verification dialog box appears. Tap Log Out. Shut down the Facility Prime application on the ipad by double-clicking the ipad Home button and then dragging the Facility Prime app upwards to move it off the ipad. Press the Home button again. 17

18 2 Part 2: Working with Graphics Introduction Facility Prime graphics display information from the building automation system (BAS) field panels. Using the Graphics tab, you can view facility information and change settings such as room temperature and airflow setpoints. Facility Prime can store as many different graphics as the ipad storage allows, but only one graphic can be active at a time. Displaying Graphics The Facility Prime Menu lists the graphics that are available for monitoring and controlling the BAS. The Menu is located near the top left of the Facility Prime application space. To display a graphic: 1. From any tab, tap Menu. 2. (Optional) To quickly find a graphic, begin typing the name in the Search box to filter the list. 3. Tap the graphic name. The graphic is displayed on the Graphics tab, and data from the BAS begins to appear on the graphic and in the List View and Charts tabs. Generating a PDF File of a Graphic You can save a copy of what is displayed on the Graphics tab as a PDF file, which can then be saved on the ipad and/or ed. To generate and/or send a report: 1. On the Graphics tab, tap and then tap Report. The Generate Report dialog box appears. 18

19 2 2. Do one of the following: To save the report as a.pdf file, tap File. The file is saved on the ipad. To view the PDF, use the itunes File Sharing function to copy the report file (*.pdf) to another location. For more information, see Transferring Files between a Computer and the ipad on page 57. To send the file as an e-attachment, tap . A blank message opens with the file attached. To both save the file and it, tap File & . NOTE: If you do not receive the ed report, verify that the ipad is communicating with your network. The ipad mail application stores the in the Outbox until it can be sent. Changing Settings and Values You can change settings and values in the BAS through Facility Prime graphics. You must be logged in to the BAS to make changes; see Logging In to the BAS on page 15. Each graphic is composed of elements that link to points in the BAS. The way in which you change settings and values differs depending on the element type. See Appendix B: Element Quick Reference for instructions specific to each element type. Using the Navigation Bar The navigation bar appears at the top of the Facility Prime window when you tap anywhere in the Graphics tab. From the navigation bar you can perform the following tasks: See who is logged in to Facility Prime and display the User Account Verification dialog box, allowing you to log in or out Plot the dynamic values of Point Label elements to assist with analyzing system performance View and respond to alarms 19

20 2 View a tree structure, or hierarchy, of the nodes in the BAS (if one has been created) The following sections describe each of these tasks in more detail. Viewing the Current User s Name and Accessing the User Account Verification Dialog box If a user is logged in to Facility Prime, the user is identified next to User in the navigation bar. If the user logged in with initials and a password, the user s initials appear. If the user logged in by scanning a secure QR code, the user s last name appears. If Facility Prime is offline, the word Offline appears, and if no user has logged in, the word None appears. Tapping User displays the User Account Verification dialog box, which allows you to log in or out of Facility Prime. Plotting Dynamic Values of Point Labels You can create dynamic plots of Point Label elements on a graphic using the Analysis feature on the navigation bar. This is useful for analyzing a group of related points, such as the points in an air handling unit. Once displayed, you can drag the plots to any location within the displayed graphic. To add dynamic plots to a graphic: On the navigation bar, tap Analysis. Dynamic plots appear on the graphic, overlaying each Point Label. To remove a plot, triple-tap it; to remove all plots, reload the graphic. 20

21 2 Viewing and Responding to Alarms The Alarm Status Screen displays a list of points that are currently in alarm and allows you to acknowledge the alarms. Any point in alarm from the field panels listed in the BACnet Browser and Siemens P2 Browser appear in the Alarm Status screen, even if the point is not linked to an element on a graphic. You can view the list of field panels by tapping Panel List. To display the Alarm Status Screen: On the navigation bar, tap Alarm Status Screen. To acknowledge an alarm: 1. Tap the alarms you want to acknowledge. A checkmark appears next to each alarm you tap. 2. Tap Acknowledge. The User Account Verification dialog box appears. 3. Enter your user initials and user password and then tap Log In. The alarm is acknowledged and removed from the Alarm Status Screen. 4. To refresh the alarm list, tap Refresh. NOTE: You must provide your account credentials when acknowledging alarms, even if you are already logged in. Viewing a Node Hierarchy In addition to custom graphics, your Facility Prime application may include a node hierarchy diagram showing the structure of the nodes in your BAS. The hierarchy may also include links to custom graphics and to the current values of key points in the system. From the hierarchy, you can generate a basic graphic showing the points as Analog Bar elements. NOTE: Node Hierarchies are configured with Facility Prime Editor. For information on creating a Node Hierarchy, see Using Node Builder on page 41. To display the node hierarchy: On the navigation bar, tap Hierarchy. In the illustration below, the hierarchy consists of a node named Campus which has three subnodes: ScienceBldg, Library, and Fieldhouse. Branches of the hierarchy can be expanded or collapsed by tapping a node on the branch. If a node has an associated graphic, the graphic name appears at the bottom of the hierarchy window when the node is tapped. In the illustration below, the graphic named Datacenter has 21

22 2 been linked to the Library node. The Datacenter graphic is displayed by tapping Launch Graphic in the lower left corner of the window. 22

23 2 The next illustration shows a point list that has been associated with the Library node. The point list is displayed by tapping Show Points in the lower right corner of the window. 23

24 2 The next illustration shows an auto-generated graphic of the points associated with the Library node. To create this graphic, tap Auto Generate Graphic in the lower center of the window. 24

25 3 Part 3: Using Charts Using the Charts Tab Your Facility Prime application may include up to six charts per graphic on the Charts tab. Charts can show current values or historical data plotted as scatter (line), bar, or pie charts. You can change the appearance of a chart, such as the colors and scales. You can also save a chart as a PDF and attach the PDF to an ; see Generating a PDF File of a Chart on page 27 for instructions. Scatter (Line) Chart Bar Chart Pie Chart NOTE: The chart types and data are configured with Facility Prime Editor. For information on creating charts, see Charts on page 129. To view charts for a graphic: From the Charts tab, tap Menu and then tap the graphic that is linked to the chart you want to view. If the graphic is linked to more than one chart, swipe to see the other charts. 25

26 3 To format a chart: 1. With the graphic containing the chart you want to format displayed on the Graphics tab, tap the Charts tab. Swipe to display the chart you want to format. 2. Tap and then tap Edit Chart. The chart formatting dialog box appears. 3. At the top of the dialog box, scroll the list to select the point you want to format. 4. Below the point list, scroll the list to select the color you want to represent the point data. By default, all points are set to green. To facilitate distinguishing among the points in the chart, select a different color for each point. 5. If the chart is a scatter chart, select the line style for the point data (Solid, Dotted, or Dashed) and then move the slider to select the line thickness. 6. Tap the Gradient switch to enable or disable the gradient. 7. For Scatter and Bar charts, tap the Advanced Mode switch and then tap the buttons to configure the chart axes as follows: Y-Axis Start: Sets the starting value of the Y (vertical) axis. Y-Axis Range: Sets the range for the Y-axis. This will determine the upper limit for the scale. For example, if the Y-Axis Start is -5 and the range is 105, then the upper limit for the Y-axis will be 100. Y-Interval: Sets the interval for the scale on the Y-axis. For example, if the Y-Interval is set to 5, then the scale will show 0, 5, 10, 15, and so on. Y-Ticks/Interval: Sets the number of tick marks that appear between the intervals. X-Interval: Sets the interval for the scale on the X-axis. For example, if the X-Interval is set to 50, then the scale will show 50, 100, 150, and so on. X-Ticks/Interval: Sets the number of tick marks that appear between the intervals. 8. Tap Save. 26

27 3 Generating a PDF File of a Chart You can save a copy of what is displayed on the Charts tab as a PDF file, which can then be saved on the ipad and/or ed. To generate and/or send a report: 1. On the Charts tab, tap and then tap Report. The Generate Report dialog box appears. 2. Do one of the following: To save the report as a.pdf file, tap File. The file is saved on the ipad. To view the PDF, use the itunes File Sharing function to copy the report file (*.pdf) to another location. For more information, see Transferring Files between a Computer and the ipad on page 57. To send the file as an e-attachment, tap . A blank message opens with the file attached. To both save the file and it, tap File & . NOTE: If you do not receive the ed report, verify that the ipad is communicating with your network. The ipad mail application stores the in the Outbox until it can be sent. 27

28 4 Part 4: Using Facility Prime Tools Introduction The Facility Prime Tools tab provides access to the following tools: Scan Code Generator Create scannable quick response (QR) codes that display text or open Facility Prime graphics BACnet Browser Browse BACnet field panels and points; add field panel data to Facility Prime for offline use; read and command points; adjust point parameters, such as descriptors Siemens P2 Browser Browse Siemens P2 field panels and points; add field panel data to Facility Prime for offline use Program Viewer View the PPCL program in a field panel Schedule Viewer View the BACnet schedule in a field panel, including schedule details Node Builder Depict the structure of your site as a tree diagram and provide access to key points and graphics. For more information, see Using Node Builder beginning on page 41. Creating Scannable QR Codes With the Scan Code Generator, you can create scannable quick response (QR) codes in.png format that display text or open Facility Prime graphics. To create a QR code: 1. On the Tools tab, enter text for encoding. The options are: Descriptive Text Enter the text to be displayed after the code is scanned. QR codes can accept 4296 alphanumeric characters. Graphic Link Enter an identifier in the following format to open a specific graphic (the format is case-sensitive): Graphic:[graphicname] (example) Graphic:3-West 28

29 4 Scanning QR Codes Location Element Link Enter an identifier in the following format to open a graphic and show a specific Location element on that graphic (the format is case-sensitive): Graphic:[graphicname],Location:[locationvalue] (example) Graphic:3-West,Location:2 2. Do one of the following: To store the QR code file on the ipad, tap the Store Image as file name switch to enable it and then enter the filename in the box. (After the file is created, use itunes to access the file. For more information, see Transferring Files between a Computer and the ipad on page 57.) To the file, tap the Send Image as switch to enable it. 3. Tap Generate Scan Code. The image file is saved on the ipad and/or attached to an . Using the ipad camera and the Facility Prime scanning function, you can scan QR codes to retrieve encoded information or to display Facility Prime graphics. To scan a QR code: 1. On the Graphics tab, tap and then tap Code Scanner. 2. Center the QR code in the ipad camera viewer. The Code Scanner automatically scans the code and decodes the information. If the QR code contains a graphic link, the graphic is opened and if applicable, a Location element pinpoints a position on the graphic. If the QR code contains text, the text is displayed. Tap OK to acknowledge the message. 29

30 4 Scanning a QR Code Using the BACnet Browser The BACnet Browser enables you to download device data (from field panels and TECs) and object (point) data from BACnet networks. If you are working offline, you can also import field panel and point data from a.csv file. Once downloaded or imported, you can view the data in the browser and use it to link graphical elements to points in Facility Prime Editor. The BACnet Browser is accessible from the Tools tab. In Facility Prime Editor, you can also access the browser from within elements that link to points. NOTE: Before you begin building graphics with Facility Prime Editor, it is recommended that you download or import the field panel and point data so you can easily link to points in the system. 30

31 4 Downloading Data To download data, you must be connected to the same network as the field panel. You can either manually enter field panel address data or use the BACnet auto-discovery feature to locate field panels. After you download data, the points appear in the browser and in the Point Selector (Editor only) so you can link them to elements in your graphics. NOTE: If you will be editing graphics offline, use the manual entry method to add the field panel. Allowing the browser to auto-discover the devices on the subnets does not maintain the data when you are offline. For manual entry, you will need the following field panel address data: Device Instance # IP Address MAC Address and Network # (to link to a point in an MSTP device, such as a TEC) If you are using auto-discovery, Facility Prime must be connected to the same subnet as the field panels you want to discover, or a proper BBMD table must be used. (For information about BACnet network configurations, see the BACnet standards document.) To download data using auto-discovery: 1. Tap the Tools tab. 2. Tap and then tap BACnet Browser. The BACnet Browser appears. 3. Do one of the following: To manually enter device data: a. Tap +. The Enter Information dialog box appears. b. In the Device Instance# box, type the device instance number. To discover devices: a. Tap. The BACnet Who-Is Filter dialog box appears. b. In the Instance Number Low Range and Instance Number High Range boxes, enter the range of device instance numbers you want to find. Continued on next page 31

32 4 To manually enter device data: c. In the IP Address box, type the IP address of the field panel. For BACnet MSTP devices such as TECs, include the MAC address and network number in the following format: [IPaddress]:[MACaddress]:[netw ork#] d. Tap OK. The device is listed in the browser. To discover devices: c. In the Network Number box, enter the network number on which you want to search. To search all connected networks, enter 0. d. Tap Send Who-Is. The devices that meet the criteria you specified are displayed in the browser. 4. Tap the device. Facility Prime requests point data from the device and displays the point data in the browser. Importing Data To import field panel data, you must have a properly named, encoded, and formatted text file. In addition, the field panel list in the browser must be empty. The text file must be named BACnetPanelList.txt and it must be encoded in UTF-16 Little Endian, Line Breaks: Unix (LF). NOTE: You will need a Unicode text editor to create and save the import file. The text file must be formatted as follows: [instance#],[ipaddress]; Note that the panel instance number and IP address are separated by a comma and that each panel is separated by a semi-colon. For example: Panel data: Instance # IP Address :1:2 Note: This is an MSTP device with MAC = 1 and Network = 2 Text file: 7001, ;100, ;13000, :1:2 To import point data, you must know the panel instance number and IP address, and you must have a properly-formatted.csv file containing the point data you want to 32

33 4 import. After you import the.csv file, the points will appear in the browser and the Point Selector in Facility Prime Editor so you can link them to elements in your graphics. To import field panel data from a.txt file: 1. Transfer the.txt file to the ipad. See Transferring Files between a Computer and the ipad on page In Facility Prime, tap the Tools tab. 3. Tap and then tap BACnet Browser. The BACnet Browser appears and the field panels from the file are listed. 4. (Optional) Remove the.txt file from the ipad. To import point data from a.csv file: 1. Transfer the.csv file to the ipad. See Transferring Files between a Computer and the ipad on page In Facility Prime, tap the Tools tab. 3. Tap and then tap BACnet Browser. The BACnet Browser appears. 4. Tap +. The Enter Information dialog box appears. 5. Type the Device Instance# and IP Address of the device, and then tap OK. The device is listed in the browser. 6. Tap the device and then tap. The Field Panel CSV Importer dialog box appears. 7. Tap the Panel CSV File box, tap the.csv file you want to import, and then tap Select. 8. Tap Import. The points appear in the browser. Viewing Data in the Browser The BACnet Browser enables you to view field panel and point data that have been downloaded or imported into Facility Prime. If you are connected to the same network as the field panel, you can also read point data directly from the field panel and issue write commands. 33

34 4 To open the BACnet Browser (from the Tools tab): Tap and then tap BACnet Browser. The BACnet Browser appears showing the device list. Tap a device to see the points in that device. The points list is organized by object type: analog value, binary output, binary value, command, and so on. You can use the index along the right side of the list to display points of a particular object type. You can also search for a point by name, type, or instance number using the Search box at the top of the points list. To view point details: In the points list, tap the point you want to view. The Object Detail Reporter dialog box appears. The Object Detail Reporter displays some of the commonly-viewed properties of the point (object), including the present value, and enables you to send Read and Write commands to the point. A Read command retrieves the properties of the point, while a Write command enables you to command the point to a different value or change the properties of the point. 34

35 4 To send a Read command to a point: 1. In the Object Detail Reporter, tap Read Point Information. The BACnet Read Commander dialog box appears. 2. (Optional) By default, the Property Identifier is set to object-name. To view a different property, tap to clear the box. The property identifier selector appears. Tap the property you want to read. 3. Tap Read Command. The Commander retrieves the data from the point and displays it in the green box. To send a Write command to a point: 1. In the Object Detail Reporter, tap Write Point Information. The BACnet Write Commander dialog box appears. 2. Edit the properties of the point as needed. To command the point, enter the new value in the Property Value box. 3. Tap Send Write Property Command. 4. Tap outside the BACnet Write Commander dialog box to close it. 35

36 4 To refresh the points list: In the browser, tap the device and then tap. Facility Prime requests point (object) data from the device and displays the point data in the browser. Removing Field Panel and Point Data from the Browser Follow these procedures to remove field panel and point data from the BACnet Browser. Note that removing a field panel or point from the browser does not remove the field panel or point from the BAS. To remove field panel data from the Browser: 1. Tap and then tap BACnet Browser. The BACnet Browser appears. 2. Swipe to the left over the device you want to delete. A Delete button appears. 3. Tap Delete. The device is removed from the browser. To remove point data from the Browser: 1. Tap the Tools tab. 2. Tap and then tap BACnet Browser. The BACnet Browser appears. 3. Tap the device and then tap Edit. A message appears informing you that deleting points removes them from the browser and not the field panel. 4. Tap OK to acknowledge the message. Delete buttons appear next to each point. 5. Tap a delete button to remove the point from the browser. Tap Edit again to hide the delete buttons. Exporting a Point List to a Text File You can export a point list to a text (.txt) file and use the text file to build a node hierarchy using Node Builder. For more information about Node Builder, see Using Node Builder on page 41. To export points to a text file: In the browser, tap the device and then tap. A message appears informing you that the points have been exported. Tap OK.. 36

37 4 Using the Siemens P2 Browser The Siemens P2 Browser enables you to download field panel (device) and point (object) data from Siemens P2 networks. Once downloaded, you can view the data in the browser and use it to link graphical elements to points in Facility Prime Editor. You can also import a list of field panels from a text file. NOTE: Before you begin building graphics with Facility Prime Editor, it is recommended that you download or import the field panel data and download point data so you can easily link to points in the system. Downloading Data To download data, you must be connected to the same network as the field panel. You can either manually enter field panel address data or use the auto-discovery feature to locate field panels. After you download data, the points appear in the browser and the Point Selector in Facility Prime Editor so you can link them to elements in your graphics. NOTE: If you will be editing graphics offline, use the manual entry method to add the field panel. Allowing the browser to auto-discover the devices on the subnets does not maintain the data when you are offline. For manual entry, you will need the following field panel address data: P2 BLN Name P2 Panel Name P2 IP Address To download data from a field panel: 1. Tap the Tools tab. 2. Tap and then tap P2 Browser. The P2 Browser appears. 3. Tap +. The Enter Information dialog box appears. 4. Type the Node Name, BLN Name, and IP Address of the field panel, and then tap OK. The field panel is listed in the browser. 5. Tap the field panel. Facility Prime requests point data from the field panel and displays the point data in the browser. 37

38 4 To view object properties: In the points list, tap a point. The P2 Object Detail Reporter dialog box appears showing the properties of the point. Importing Field Panel Data To import field panel data, you must have a properly named, encoded, and formatted text file. In addition, the field panel list in the browser must be empty. The text file must be named P2PanelList.txt and must be encoded in UTF-16 Little Endian, Line Breaks: Unix (LF). NOTE: You will need a Unicode text editor to create and save the import file. The text file must be formatted as follows: [panelname],[blnname],[ipaddress]; Note that the panel name, BLN name, and IP address are separated by a comma and that each panel is separated by a semi-colon. For example: Panel data: Panel Name BLN Name IP Address AHU1 BLN AHU2 BLN Text file: AHU1,BLN02, ;AHU2,BLN02, To import field panel data from a.txt file: 1. Transfer the.txt file to the ipad. See Transferring Files between a Computer and the ipad on page In Facility Prime, tap the Tools tab. 3. Tap and then tap Siemens P2 Browser. The Siemens P2 Browser appears and the field panels from the file are listed. 4. (Optional) Remove the.txt file from the ipad. 38

39 4 Removing Field Panel and Point Data from the Browser Follow these procedures to remove field panel and point data from the Siemens P2 Browser. Note that removing a field panel or point from the browser does not remove the field panel or point from the BAS. To remove field panel data from the Browser: 1. Tap and then tap Siemens P2 Browser. The Siemens P2 Browser appears. 2. Swipe to the left over the field panel you want to delete. A Delete button appears. 3. Tap Delete. The field panel is removed from the browser. To remove point data from the Browser: 1. Tap the Tools tab. 2. Tap and then tap Siemens P2 Browser. The Siemens P2 Browser appears. 3. Tap the device and then tap Edit. A message appears informing you that deleting points removes them from the browser and not the field panel. 4. Tap OK to acknowledge the message. Delete buttons appear next to each point. 5. Tap a delete button to remove the point from the browser. Tap Edit again to hide the delete buttons. Exporting a Point List to a Text File You can export a point list to a text (.txt) file and use the text file to build a node hierarchy using Node Builder. For more information about Node Builder, see Using Node Builder on page 41. To export points to a text file: Using the Program Viewer Tap the field panel and then tap. A message appears informing you that the points have been exported. Tap OK. The Program Viewer enables you to view PPCL programs from Siemens BACnet and P2 field panels. To view programs in BACnet field panels, you must know the program name, field panel instance number, and field panel IP address. For Siemens P2 field panels, you must know the program name, BLN name, node name, and IP address. Note that you cannot edit programs with the Viewer. 39

40 4 To view a program in Program Viewer: 1. Tap the Tools tab. 2. Tap and then tap Program Viewer. The PPCL Program Viewer appears. 3. Do one of the following: If the program is running in a BACnet field panel, enter the Program Name, Panel Instance #, and IP Address. If the program is running in a Siemens P2 field panel, enter the Program Name, BLN Name, Panel Instance #, and IP Address. 4. Tap Load PPCL. The program appears in the green box. Using the Schedule Viewer The Schedule Viewer enables you to view BACnet schedule objects. Note that you cannot edit schedules with the Viewer. To view a BACnet schedule in Schedule Viewer: 1. Tap the Tools tab. 2. Tap and then tap Schedule Viewer. The BACnet Schedule Viewer appears. 3. Tap Select Schedule. The BACnet Browser appears. 4. Tap the schedule you want to view. The properties of the schedule are displayed in the Viewer. 5. In the Schedule Details area, do the following: Tap Schedule Objects to see the objects (points) affected by the schedule. Tap Schedule Output to see the days and times of the schedule. Tap Schedule Exceptions to see the exceptions to the schedule, such as holidays. 6. When you are finished viewing the schedule, tap Return. 40

41 4 Using Node Builder If you have many points in your BAS and your users do not need custom graphics (for example, building engineers or other technical staff), you can use Node Builder to create a tree structure of your site and provide access to key points. The tree structure, or hierarchy is accessible from the navigation bar, which appears at the top of the Facility Prime window when you tap anywhere in the Graphics tab (with Editor Mode turned off). The hierarchy can display a custom graphic and a list of points and current values. It can also automatically generate a basic graphic showing the points as Analog Bar elements. In the illustration below, the graphic named Datacenter has been linked to the Library node. The Datacenter graphic is displayed by tapping Launch Graphic in the lower left corner of the window. 41

42 4 The next illustration shows a point list that has been associated with the Library node. The point list is displayed by tapping Show Points in the lower right corner of the window. 42

43 4 The next illustration shows an auto-generated graphic of the points associated with the Library node. To create this graphic, tap Auto Generate Graphic in the lower center of the window. Before you begin creating the hierarchy, you should determine which nodes you want displayed in the hierarchy, the levels of the hierarchy, and whether you want to link graphics and point to nodes. There are two methods for creating the hierarchy in Node Builder: manually and by importing field panel data. These methods are discussed next. NOTE: For instructions on using the hierarchy, see Viewing a Node Hierarchy on page 21. Creating a Node Hierarchy Manually The process for building the hierarchy manually is as follows: 1. Create all nodes in the hierarchy (for example, campus, buildings, floors, rooms). 2. Create the hierarchy by assigning lower-level nodes as subnodes to higherlevel nodes. 3. (Optional) Associate a graphic with a node. 43

44 4 4. (Optional) Associate points with a node. 5. Save and view the hierarchy. Instructions for completing each of these steps are provided next. To create nodes: 1. Tap the Tools tab. 2. Tap and then tap Node Builder. The Node Builder page appears. 3. Tap. If you have an existing node hierarchy, a message appears asking if you want to replace the existing hierarchy with a new one. Tap OK. 4. Tap Edit and then tap +. The node details page appears. 44

45 4 5. In the Node Name box, type the name of the highest node in the hierarchy and then tap Save. The node is added to the Node Builder page. 6. Tap In the Node Name box, type the name of a node in the next level in the hierarchy (for example, FieldHouse). 8. Tap Save. The node is added to the Node Builder page. 9. Repeat Steps 7 and 8 to add the remaining nodes at all levels. 10. On the Node Builder page, tap Done. 45

46 4 To create the hierarchy by assigning subnodes: 1. On the Node Builder page, tap the highest node in the hierarchy. The node details page appears. 2. Tap Sub Nodes on the selector bar. 3. At the bottom of the node details page, tap Add Item. A dialog box showing the nodes you defined appears. 4. Tap a node to add it to the list of subnodes. 5. Repeat Steps 3 and 4 to assign subnodes to this node. 6. Tap Save. The Node Builder page appears. 7. Repeat this procedure to add subnodes to other nodes in the hierarchy. 46

47 4 (Optional) To associate a graphic with a node: 1. From the Node Builder page, tap the node to which you want to associate a graphic. The node details page appears. 2. Tap in the Graphic box. The list of graphics in Facility Prime appears. 3. Tap the graphic you want to associate with the node. 4. Tap Save. The Node Builder page appears. (Optional) To associate points with a node: 1. From the Node Builder page, tap the node to which you want to associate points. The node details page appears. 2. Tap Points on the selector bar. 3. At the bottom of the node details page, tap Add Item. The Point Selector appears. 4. Tap the network type and then do one of the following: If the network type is: BACnet or P2 BACnet And you are linking the point by: Using Auto Discovery to select the point Manually entering the point details Then follow these steps: a. Tap Auto Discovery. The browser appears. b. Tap the field panel containing the point you want to link. A listing of points in that field panel appears. c. Tap the point you want to link. d. (P2 only) Tap the point type. e. Tap Add Point. a. In the Object Type box, tap to clear the box, tap the desired Object Type from the list, and then tap Save. b. In the Object Instance# box, tap to clear the box and then type an Object Instance number in the box. Continued on next page 47

48 4 If the network type is: P2 And you are linking the point by: Manually entering the point details Then follow these steps: c. In the Property Identifier box, tap to clear the box, tap the desired Property Identifier from the list, and then tap Save. d. In the IP Address box, tap to clear the box and then type an IP Address in the box. e. Tap Add Point. a. Tap the point type. b. Enter the following data in the boxes: P2 Point Name P2 BLN Name P2 Panel Name P2 IP Address c. Tap Add Point. 5. Repeat Steps 3 and 4 for each point you want to link. 6. At the bottom of the node details page, tap Save. The Node Builder page appears. To save and view the hierarchy: 1. At the top of the Node Builder page, tap Save. The Root Node dialog box appears. 2. Type the name of the node at the highest level in the hierarchy and then tap OK. Node Builder closes. 3. Tap the Graphics tab. 4. If necessary, turn off Edit Mode by tapping and then tapping the Edit Mode switch to turn it off. 5. Tap anywhere in the displayed graphic. The navigation bar appears at the top of the page. Note that the navigation bar appears only briefly and then disappears. 48

49 4 6. On the navigation bar, tap Hierarchy. The node hierarchy appears. To expand the hierarchy, tap. Creating a Hierarchy by Importing Field Panel Data You can also create a hierarchy by importing field panel data from a properly-formatted.csv file. You can manually create the.csv file, or if your field panels use structured point naming (for example, BLD1.AHU1.RAT), you can export the point list to a text file using the BACnet Browser or Siemens P2 Browser, edit the text file and save it as a.csv, and then import the.csv file into Node Builder. This method takes advantage of the structured naming convention to automatically define the levels of the hierarchy in Node Builder. 49

50 4 NOTE: The.csv file must be located on the ipad before you begin. See Transferring Files between a Computer and the ipad on page 57 for instructions. The example below shows a list of field panels, the properly-formatted.csv file, and the resulting Node Builder hierarchy. Field panel list: CAMPUS.SCIENCEBLDG.FLOOR1 CAMPUS.SCIENCEBLDG.FLOOR2 CAMPUS.FIELDHOUSE.MAINGYM CAMPUS.FIELDHOUSE.FITNESS CAMPUS.FIELDHOUSE.WLOCKERS CAMPUS.FIELDHOUSE.MLOCKERS CAMPUS.LIBRARY.csv file: CAMPUS.SCIENCEBLDG.FLOOR1,CAMPUS.SCIENCEBLDG.FLOOR2,CAMPUS.FIE LDHOUSE.MAINGYM,CAMPUS.FIELDHOUSE.FITNESS,CAMPUS.FIELDHOUSE.WL OCKERS,CAMPUS.FIELDHOUSE.MLOCKERS,CAMPUS.LIBRARY, Resulting hierarchy after import: After importing the field panel list into Node Builder, you can associate points and graphics with each node as explained in the instructions for creating a node hierarchy manually beginning on page

51 4 To prepare an exported point list for use with Node Builder: Export as a text file the point list you want to use. See instructions in Using the BACnet Browser on page 30 or Using the Siemens P2 Browser on page Transfer the text file to a computer. See Transferring Files between a Computer and the ipad on page Open the text file in a text editor. 3. Edit the point names to reflect only the node name. For example, if the point name is BLDG1.AHU1.RAT, edit the name to BLDG1.AHU1. 4. Ensure each node name is separated by a comma (,) and that a comma follows the last node name in the file. 5. Save the file with a.csv extension. 6. Transfer the.csv file back to the ipad. To import a.csv file into Node Builder: 1. Tap the Tools tab. 2. Tap and then tap Node Builder. The Node Builder page appears. 3. Tap. If you have an existing node hierarchy, a message appears asking if you want to replace the existing hierarchy with a new one. Tap OK. 4. Tap Import. A list of available.csv files appears. 5. Tap the.csv file you want to import. The file is imported and the nodes appear on the Node Builder page. Tap a node to see the assigned subnodes. 51

52 5 Part 5: Managing Files Introduction This section provides instructions for managing graphics on the ipad. It includes procedures for setting a Home graphic, copying graphics to facilitate creation of similar graphics, creating templates for FLN applications (TECs, DEMs, VFDs and so on), importing and exporting graphics for use on other ipads or for back-up purposes, renaming graphics, transferring image and document files from a computer to the ipad, and deleting graphics you no longer need. Setting a Home Graphic (Editor only) You can set a Home graphic that will display every time a user launches Facility Prime. (If you do not set a Home graphic, Facility Prime displays the last graphic in the Menu.) When you set a Home graphic, Facility Prime Editor generates a file named homegraphicnamefile.txt. You can transfer this file to other ipads running Facility Prime or Facility Prime Editor to set the same Home graphic on those ipads. For instructions on transferring files, see Transferring Files between a Computer and the ipad on page 57. To set a Home graphic: 1. Display the graphic you want to set as the home graphic. 2. Tap and then tap Graphic Container Editor to display the Graphic Container Editor menu. 3. Tap Function. 4. Scroll the list to select Set Home Graphic. 5. Tap Execute Function. Copying a Graphic (Editor only) If you will be creating a number of graphics that are similar, you can save time by creating the first graphic, copying that graphic, renaming it, and using the copy as a starting point for creating another graphic. Alternatively, you can export the graphic to an XML file, edit the XML, and then import the edited file as a new graphic. For instructions on exporting a graphic, see Exporting Graphics on page

53 5 To copy a graphic: 1. In Edit Mode, display the graphic you want to copy. 2. Tap and then tap Graphic Container Editor. The Graphic Container Editor menu appears. 3. At the top of the Graphic Container Editor, tap Function. 4. With Copy Graphic selected, tap Execute Function. A copy of the graphic is created and appears in the Menu as [graphicname]copy. 5. Rename the copy. See Renaming a Graphic on page 56 for instructions. Creating Templates (Editor only) Templates are graphics that represent the components of the application in a Siemens FLN device. A template is linked to an FLN Device element. When a user taps the FLN Device on a graphic, the associated template appears in a secondary window. A single template can be linked to any number of FLN Device elements. For more information about the FLN Device element, see FLN Device on page 111. Templates can contain a total of 15 elements, including: One Image element (e.g., background image) One Text element (title block) Point Labels Analog Commander and Binary Commander elements Document elements Special Property of the Text Element When used in a template, the Text element is designed to be the title block. It has a special property that automatically appends the text you enter with a colon followed by the TEC description. For example, suppose you enter Floor 2 into the Text element of your template, and you associate the template with an FLN Device element linked to a TEC with the description Room 201 VAV 4. When you display the graphic with Edit Mode turned off, the Text element will read Floor 2: Room 201 VAV 4. If you want other static text on your template graphic, include the static text on the background image. 53

54 5 To create a template: 1. In Edit Mode, display the graphic you want to use as a template. Important: The graphic you use to create the template must be named the same as the application number; for example, 2020 (for a P1 VAV Cooling Only application) or 6596 (for a BACnet TEC Expanded IO application). If you need to rename the graphic, see Renaming a Graphic on page 56 for instructions. 2. Tap and then tap Import/Export Graphics. The Import/Export Graphics Menu appears. 3. Tap Template From Current Graphic. The graphic is saved to the ipad with a.xml extension. Exporting Graphics The Export Graphics function allows you to create backup copies of Facility Prime graphics so you can copy the backups to your computer or other media. After you have copied the files from the ipad to your computer or other media, you can use the Erase All Exports function (Editor only) to delete the backups from the ipad. For more information about transferring files between your computer and the ipad, see Transferring Files between a Computer and the ipad on page 57. You can also use the Export Graphics function to copy a single graphic from one ipad to another. After you export the graphic from Facility Prime, copy the backup file and any associated image and document files to your computer, and then copy the files from your computer to another ipad. If you want to copy the entire Facility Prime database from one ipad to another, do not use the Export Graphics function; see Transferring Files between a Computer and the ipad on page 57. Backup graphic filenames include the graphic name, a date and time stamp, and a.grpxml (xml-based graphics) or.grpbk (legacy graphic format) extension, as shown below. [graphicname]-[mmddyyyy]-[hhmmss].grpxml or [graphicname]-[mmddyyyy]-[hhmmss].grpbk NOTE: The preferred format for graphic backup files is xml (.grpxml). The format is selected in ipad Settings for the Facility Prime Editor application. 54

55 5 To export graphics: 1. From the Graphics tab, tap and then tap Import/Export Graphics. The Import/Export Graphics Menu appears. 2. Do one of the following: To export the graphic that is currently displayed, tap Export Current Graphic. A message appears indicating that the graphic has been exported. Tap OK. To export all graphics, tap Export All Graphics. A message appears indicating that all graphics have been exported. Tap OK. Erasing exported graphic backup files from the ipad (Editor only) Use the Erase All Exports function to erase all graphic backup files from your ipad when they are no longer needed. NOTE: The Erase All Exports function does not erase the graphic file itself, only the backup file. Only those graphic backup files saved in the currently-selected format (.grpxml or.grpbk) will be removed. The format is selected in ipad Settings for the Facility Prime Editor application. To erase graphic backup files from the ipad: 1. Tap and then tap Graphic Container Editor. The Graphic Container Editor dialog box appears. 2. Tap Function. 3. Scroll the list and select Erase All Exports. 4. Tap Execute Function. A message appears confirming that the graphic backup files have been erased. 5. Tap OK. Importing Graphics Use the Import function to copy an exported (backup) graphic file from the ipad into Facility Prime. Backup graphic filenames include the graphic name, a date and time stamp, and a.grpxml (xml-based graphics) or.grpbk (legacy graphic format) extension, as shown below: [graphicname]-[mmddyyyy]-[hhmmss].grpxml or [graphicname]-[mmddyyyy]-[hhmmss].grpbk 55

56 5 The date and time stamp indicates when the graphic was exported, making it unique from other versions of that graphic. To avoid having multiple versions of the same graphic on an ipad, use itunes to delete the previous versions before importing the new ones. To import graphics into Facility Prime: 1. From the Graphics tab, tap and then tap Import/Export Graphics. The Import/Export Graphics Menu appears. 2. Do one of the following: To import a single graphic, tap Import New Graphic. The Select File For Import dialog box appears. Tap the file you want to import and then tap Import. To import all graphics from the ipad into Facility Prime, tap Import All Graphics. A message appears asking you to confirm that you want to import all graphic backup files into Facility Prime. Tap OK. Renaming a Graphic (Editor only) Follow the steps below to rename a graphic. To rename a graphic: 1. In Edit Mode, display the graphic you want to rename. 2. Tap and then tap Graphic Container Editor. The Graphic Container Editor menu appears. 3. Tap Function. 4. Scroll the list to select Rename Graphic and then tap Execute Function. The New Graphic Name dialog box appears. 5. Type the new name in the box and then tap OK. Deleting a Graphic If you find you have graphics in the Menu you no longer need, you can delete them from the Menu and from the ipad. CAUTION: Before you delete graphics, make a backup of any graphics you might want to restore in the future. To make a backup, see Exporting Graphics on page

57 5 NOTE: Backup graphic files (with a.grpxml or.grpbk extension) are not deleted when you delete a graphic from the Menu. To delete a graphic, do one of the following: Tap Menu. Swipe to the left over the graphic you want to delete. A Delete button appears. Tap Delete. The graphic is deleted from the Menu and the ipad. (Editor only) In Edit Mode, tap Menu and then tap Edit. A minus sign ( ) appears next to each graphic in the Menu. Tap and then tap Delete. The graphic is deleted from the Menu and the ipad. Tap Edit again to return the Menu to the normal state. Transferring Files between a Computer and the ipad As you work with Facility Prime, you may need to transfer files between your computer and the ipad. You may also want to duplicate the entire Facility Prime database from one ipad and copy it to one or more additional ipads. The following table lists examples of the types of files that you may need to transfer. Examples of files to transfer from computer to ipad Image files for use as background graphics (Facility Prime Editor accepts image files in.jpg and.png format) Document files, such as PDFs or Word documents to display from a graphic.csv files for use with Node Builder Examples of files to transfer from ipad to computer Graphic backup files and all related files (such as images, documents,.csv files, text files, etc.) for offline storage Image or document files for editing To duplicate a Facility Prime database from one ipad to one or more additional ipads, you must copy all image and document files and all files with a.sqlite extension to your computer and then copy the files from your computer to the other ipads (overwrite any existing files of the same name). NOTE: If you want to move a single graphic file from one ipad to another, export the graphic, copy it to your computer, and then copy it to the other ipad. See Exporting Graphics on page 54 for more information. 57

58 5 To copy files from your computer to the ipad: 1. Connect the ipad to your computer. itunes should automatically open, and you should see the ipad listed under Devices. 2. In the left pane, select the ipad under Devices. 3. At the top of the main pane, select Apps. 4. Scroll the main pane until you see File Sharing. 5. Under File Sharing in the Apps list, click FacilityPrime. A list of files appears in the FacilityPrime Documents list, which is located next to the Apps list. The FacilityPrime Documents list shows the files that are on the ipad. 6. Scroll the main pane to the bottom. Under the FacilityPrime Documents list, click Add. The Add dialog box appears. 7. Locate and select the file you want to add to the ipad and then click Open. The file is copied to the ipad. 8. Eject the ipad from itunes by clicking the eject button ( ), located next to the ipad name in the left pane under Devices. 9. Disconnect the ipad from the computer. To transfer files from the ipad to a computer: 1. Connect the ipad to your computer. itunes should automatically open, and you should see the ipad listed under Devices. 2. In the left pane, select the ipad under Devices. 3. At the top of the main pane, select Apps. 58

59 5 4. Scroll the main pane until you see File Sharing. 5. Under File Sharing in the Apps list, click FacilityPrime. A list of files appears in the FacilityPrime Documents list, which is located next to the Apps list. The FacilityPrime Documents list shows the files that are on the ipad. 6. Select the files you want to copy to the computer. NOTE: Graphic backup files are named with the graphic title followed by the date and time of export and ending with a.grpxml or.grpbk extension. In addition to copying the backup file, you should also copy files used in the graphic, such as.pdf,.png, and.jpg files, and any related files such as.csv files, text files, and so on. 7. Scroll the main pane to the bottom. Under the FacilityPrime Documents list, click Save To. The Save To dialog box appears. 8. Locate the folder on the computer where you want to save the files and then click Select Folder. The files are copied to the computer. 9. Eject the ipad from itunes by clicking the eject button ( ), located next to the ipad name in the left pane under Devices. 10. Disconnect the ipad from the computer. 59

60 6 Part 6: Creating Graphics with Facility Prime Editor Introduction Facility Prime Editor allows to you create graphics that appear on the Graphics tab, List View, and Charts tab. Graphics act as an interface to the building and can be customized to meet the needs of many different users and user types. A library of graphic elements for displaying gauges, graphs, images, and animation is included with Facility Prime Editor. In addition, you can import documents and custom images (such as floor plans, equipment schematics, logos, and photos) to use in your graphics. Points are linked to graphics by entering point address information or by using the autodiscovery function. Graphics can be exported from one ipad and shared with other ipads. Facility Prime Editor enables you to create graphics in two ways: Building custom graphics and templates Facility Prime enables you to build custom graphics for almost any need. With an extensive library of graphical elements and the ability to import images and other files, you can create professional-looking graphics for many types of users. You can also build a single graphic template for FLN devices and link that graphic to any number of FLN Device elements. This part of the guide provides instructions for creating custom graphics. For information about templates, see Creating Templates on page 53. Using Node Builder Node Builder lets you create basic graphics quickly by building a tree structure of your site that provides access to key points and custom graphics. The tree structure, or hierarchy is accessible from the navigation bar, which appears at the top of the Facility Prime window when you tap anywhere in the Graphics tab. If your users are technical staff, such as building engineers or maintenance staff, who need access to many points but do not need a full set of custom graphics, you may be able to meet their needs using Node Builder. For more information about Node Builder, see Using Node Builder on page

61 6 The process for creating a custom graphic is as follows; detailed instructions are provided later in this guide: 1. Log in to Facility Prime Editor (requires a user account on the BLN with at least Edit access rights). See Logging In to the BAS on page (Optional) Copy background images onto the ipad, then into Facility Prime Editor. See Transferring Files between a Computer and the ipad on page 57 and Adding Background Images on page 70 for instructions. 3. Enable Edit Mode. 4. Create a new graphic container. 5. Add the desired graphic elements to the container. 6. Resize and position the elements. 7. If applicable, link standard graphic elements to point data. 8. If applicable, configure element settings and format the appearance of the element. You can create many graphics for your system, but only one graphic can be active at a time. A library of graphic elements is included with Facility Prime Editor. In addition, you can import background images (such as floor plans and equipment schematics), logos, documents, and photos to use in your graphics. You can also use the ipad camera to take photos to use in your graphics. NOTE: You may find it easier to use a stylus when creating graphics. A stylus provides more precision than your finger in performing gestures on the ipad. You may also find a Bluetooth keyboard easier to work with than a conventional keyboard. A Bluetooth keyboard prevents the soft keyboard from appearing in the editing space. Steps to Success A successful Facility Prime job site begins with great graphics graphics that are intuitive and that fit the needs of the intended users. High-quality graphics are the result of careful planning and good design decisions. This section provides an overview of the process for creating graphics. It also presents some planning steps to help you build your graphics efficiently. 61

62 6 Prerequisite Knowledge and Skills Before you begin working with Facility Prime Editor, you should have the knowledge and skills to: Operate the BAS on the site for which you are using Facility Prime Editor. Work with Siemens P2 and BACnet networks. Set up or use an existing itunes account on a computer. Create or obtain background images in.jpg or.png format. You may be able to export background images from your BAS graphic editor, such as Micrografx Designer or Desigo CC. Or you may use a commercially-available graphics application or even Microsoft PowerPoint to create background images. Process Overview The process for creating graphics is depicted below. Although this guide focuses primarily on the Design step, it also includes information to help you plan the number and types of graphics you will need and to prepare some resources before you begin designing your graphics. These front-end steps will save time and help you work more efficiently. At the end of this section, you will also find some suggestions for testing your graphics to ensure they are performing correctly. Plan If you have created graphics for other BAS applications, you know the importance of thoughtfully considering the graphics you will need before you begin building them. Use the list of questions below to guide you in creating a plan for your Facility Prime graphics. Who are your users? Are they primarily building maintenance staff who are comfortable with BAS concepts? Are they tenants who are not familiar with the BAS? Thinking about your users will help you determine the level of complexity to include in your graphic design. 62

63 6 What are your users needs? Will they use the graphics only to monitor conditions? Will they need to do simple commanding, like changing a room temperature setpoint? Will they need to able to make more complex adjustments, such as in lab or healthcare environments? Are there parts of the system your users should not be able to access? Thinking about your users needs for commanding will help you determine whether they will need user accounts on the system in order to be able to issue commands and whether commands should be recorded in the system activity log. How many graphics will you need to create? If graphics will be linked to each other, what will you include on the top-level graphic? What is the hierarchy or structure of the links between graphics? What type of visual indicator will you use to represent a link to another graphic? Planning the links between graphics will help you use real estate more efficiently, which can improve usability. It will also help you scope the effort of creating the graphics and to determine the best sequence in which to create the graphics. Are there opportunities to create a single graphic that can be copied and modified for another use? Reusing graphics for similar spaces saves time. Are there any considerations for naming the graphics? For example, users may call a space a room or they may call it a suite. A building might be called a dorm by one college and a residence hall by another. Choose names that your users will understand. How will your users orient the ipad when they are using the graphics? If the ipad is to be physically mounted in the space, will it be mounted in the portrait or landscape orientation? Knowing the orientation will drive the design so that the graphics display correctly. Prepare After you have a plan for the graphics you will create, you can save time by making sure you have at hand the information you need to create the graphics. Use the list below to help you gather resources before you begin. Network topology Determine the type of network and the arrangement of field panels on the network. Facility Prime can operate on a BACnet network or a Siemens P2 network on Ethernet. It is not supported on Siemens P2 networks with virtual APOGEE Ethernet Microservers (AEMs). If your system uses AEMs or virtual AEMs, you must use the BACnet server option to access these panels and associated points. 63

64 6 Point address information Depending on the network type (BACnet or Siemens P2) and the editing method you will use (online or offline), you will need to have at hand point address data so you can link points to your graphics. See Online and Offline Editing on page 66 for more information. Background image files You can import background images from your computer into the ipad using itunes. See Transferring Files between a Computer and the ipad on page 57 for instructions. You can also take a photo using the ipad camera to use as a background image. See Adding Background Images on page 70. Documents that will be accessible from graphics If you plan to display documents from links within your graphics, those documents must be imported from your computer into the ipad using itunes or, if the document is located on an FTP site, you will need to know the URL to the document. For instructions on importing documents from your computer to the ipad, see Transferring Files between a Computer and the ipad on page 57. Web site links that will be accessible from graphics Make a list of web sites that will be links in your graphics. Links could be URLs to web pages or XML links to data feeds. Test the links to verify they are correct. Site-specific style preferences (colors, fonts, borders, logos, etc.) Obtain or make a list of any style preferences for graphics (some elements allow you to select colors and fonts while others do not). You may need to stylize background images if styles cannot be achieved with selections in the elements. Obtain logo files and import them into the ipad. See Transferring Files between a Computer and the ipad on page 57 for instructions. Design The remaining sections of this guide provide instructions for using Facility Prime Editor to design graphics. The key steps in designing graphics are depicted below. 64

65 6 You will begin by starting Edit Mode in Facility Prime Editor and creating a Graphic Container. You can think of the Container as the canvas on which you will compose your graphic. Next, you can add a background image if desired. The background image is one you created outside of Facility Prime and imported through itunes or a photo you took with the ipad camera. The final step is to add graphical elements. Elements display information to the user and enable users to interact with the system. Facility Prime Editor provides a library of elements for many BAS functions. The elements are described in Part 7: Configuring Elements. Take a few moments to familiarize yourself with the library of elements so you can choose the elements that best fit the need. While it is outside the scope of this guide to instruct on the principles of graphic design, there are a few design considerations that are worth mentioning here. Consider the screen size and limit the number of elements on each graphic to enable users to quickly find the data they need. When possible, choose fonts, font sizes, and text colors that are easy to read on the screen. Ensure that there is enough contrast between background colors and element colors so elements can be easily seen. Be consistent in the placement and representation of navigation links and boilerplate images across all graphics. Consider making a template graphic with common images such as logos, borders, and navigation links. Use a copy of the template as the starting point for building all other graphics. Arrange related elements in logical groupings. Test After you have finished creating your graphics, you should test them online to ensure they are working properly and that they meet the user s needs. At a minimum, you should test the following aspects of each graphic: Verify that the graphic displays correctly in the intended orientation of the ipad. Ensure that elements are not obscured, overlapping, or positioned off the page. Verify that links between graphics work correctly. Verify that there are no spelling errors. Verify that links to URLs and documents work correctly. 65

66 6 Observe elements that monitor points to verify that the correct value is displayed. For commandable elements, issue commands and verify that the command is executed and the system responds as expected. CAUTION: Take appropriate precautions before issuing commands to the system. Online and Offline Editing Facility Prime Editor can be used online or offline. A comparison of the two methods is shown below. Online method Requires a user account on the BLN with at least Edit access rights Provides real-time access to all field panels and points Development of graphics can occur offsite if you have remote access to the network Offline method Does not require access to the BAS once point address data has been downloaded to Facility Prime Editor Allows development of graphics to occur offsite Requires point address data to be either manually entered or, on BACnet networks, imported from a.csv file Planning for Online Editing If you will be creating your graphics online, you must set up the ipad to access the BAS and authenticate your user account credentials with a field panel on the BLN. See the Connecting to the BAS on page 15 for instructions. In addition, you will need certain field panel address data in order to be able to link points to elements on your graphics. The type of data you will need depends on the network type; refer to the table that follows. 66

67 6 BACnet Networks If you are connected to the same subnet as the points you want to link to or if a proper BBMD table is used: None; use the auto-discovery feature (For information about BACnet network configurations, see the BACnet standards document.) If you cannot use auto-discovery, you will need the following data for unicast communications: Device Instance # IP Address MAC Address and Network # (to link to a point in an MSTP device, such as a TEC) Siemens P2 Networks Node Name BLN Name IP Address To save time, add field panels and BACnet TECs through the BACnet and Siemens P2 Browsers prior to creating your graphics. This will allow you to quickly link elements to points as you add and configure each element. For more information about using the browsers, see Using the BACnet Browser on page 30 and Using the Siemens P2 Browser on page 37. Planning for Offline Editing If you are planning to create your graphics offline, you must determine how you will get field panel and point data into Facility Prime Editor. You can accomplish this in one of the following ways: Download field panel and point data from the network before you begin creating graphics. Import field panel and point data from a.csv file before you begin creating graphics. Manually enter field panel and point data as you build your graphics. Downloading field panel and point data from the network If you will download field panel and point data, you will need to connect to the network once and add field panels and points through the BACnet Browser or Siemens P2 Browser. After the data has been downloaded, you will be able to link graphical elements to points without being connected to the network. To use this method, you must first set up the ipad to access the BAS and authenticate your user account credentials with a field panel on the BLN. See Connecting to the BAS on page 15 for instructions. In addition, you will need certain field panel address data in order to connect to the field panels on the network. The type of data you will need depends on the network type. See the table in Planning for Online Editing on page 66 for a list of the data you will need. 67

68 6 For more information about using the browsers, see Using the BACnet Browser on page 30 and Using the Siemens P2 Browser on page 37. Importing a.csv file containing field panel data (BACnet only) If you are working with a BACnet network, you can import a.csv file containing point data from a single field panel into itunes and then into Facility Prime Editor. After importing the.csv file into Facility Prime Editor, you will use the BACnet Browser to associate the point data to the respective field panel. See Using the BACnet Browser on page 30 and Using the Siemens P2 Browser on page 37 for instructions. Manually enter field panel and point data If you will be entering field panel and point data manually, you must have this data at hand as you build your graphics. The type of data you will need depends on the network type, as shown in the table below. BACnet Networks Object Type Object Instance # Property Identifier Field Panel IP Address MAC Address and Network # (to link to a point in an MSTP device, such as a TEC)* *The format for entering an IP address for an MSTP device is [IPaddress]:[MACaddress]:[network#] Siemens P2 Networks P2 Point Name or TEC Name and Subpoint Name (to link to a subpoint in a TEC)** P2 BLN Name P2 Panel Name P2 IP Address **The format for entering a TEC point is [TECname]:[subpointname] Enabling Edit Mode Edit Mode allows you to access the editing functions of Facility Prime Editor. To enable Edit Mode: 1. Do one of the following: If you are working offline, ensure that Wi-Fi and Airplane Mode are both off in the ipad Settings. If you are working online, log in to Facility Prime. See Logging In to the BAS on page 15 for instructions. 2. Tap the Graphics tab. 3. Tap. 4. Tap Edit Mode. 68

69 6 Adding a Container A Facility Prime graphic container is the canvas on which you will place graphic elements that compose a graphic. Naming considerations for containers: The name you give the container becomes the name of the graphic and will appear in the Menu. If you plan to save the graphic as a template for a TEC application, you must name the container after the application number; for example, See Creating Templates on page 53 for more information about templates. If you plan to scan QR codes to display the graphic or link to the graphic from the Remote Notification option in Insight (RENO), the name cannot contain spaces or underscores; however, dashes are acceptable. To create a container: 1. On the Graphics tab, tap Menu. 2. Tap Type the name of the new graphic container and tap OK. A container is created and ready for editing. Enabling Snap to Grid When you are viewing a graphic in Edit Mode, the graphic will have gridlines in the background. The gridlines can help you align elements vertically and horizontally. To obtain more precise alignment, you can turn on an alignment grid, which forces (or snaps ) elements to specific horizontal and vertical points in the graphic. (Note that these snap points do not correspond to the gridlines that appear in the background.) 69

70 6 To enable snap to grid: 1. Tap and then tap Graphic Container Editor to display the Graphic Container Editor menu. 2. Tap Function. 3. Scroll the list to select Snap Parameters. 4. Tap Execute Function. The Snap Parameters dialog box appears. 5. Tap the Snap switch to enable snap to grid. 6. In the Snap Vertical Size and Snap Horizontal Size boxes, enter the dimensions of the grid in pixels. 7. Tap Done. A message appears acknowledging the changes to the grid. Tap OK. 8. Reopen the graphic from the Menu. Adding Background Images Background images are static image files such as floor plans, equipment schematics, logos, and photos. If your graphic will have a background image, you can insert an image file or use the camera to take a photo to use as the background. Image files can be.png,.jpg, or.svg files, and the image you want to insert into your graphic must be on the ipad. See Transferring Files between a Computer and the ipad on page 57 for instructions. To add a.png or.jpg background image to a container: 1. Tap and then tap Graphic Container Editor to display the Graphic Container Editor menu. 2. Tap Element. 3. Scroll the list to select Image. 4. Tap Add Element. An Image element is added to the graphic. 5. Tap. 70

71 6 6. Do one of the following: To add an image from a file: a. Tap File. A list of available image files appears. b. Scroll the list to select the file you want to use and then tap Select. The image is added to the container. To take a picture with the camera: a. Tap Camera. The Photo Capture dialog box appears. b. Type a name for the photo and then tap. c. Take a photo with the camera; tap Use Photo to use the photo you took or Retake to retake the photo. d. In the Photo Capture dialog box, tap Done. The photo is added to the container. 7. (Optional) Drag the background image to the desired location. Moving an element displays the location/size dialog box. You can use this dialog box to more precisely position the element. Tap Location, enter coordinates, and then tap Move. 8. (Optional) Resize the background image by pinching or stretching it with your fingers. To more precisely size the image, move it until the location/size dialog box appears. Tap Size, enter the width and height, and then tap Resize. 9. Tap. 10. Do one of the following: To automatically stretch the image so it fills the screen, tap Auto Scale Image to Full Screen. This also turns on scaling and locks the image, which sends the image to the background and prevents it from being moved. Reload the graphic by selecting it from the Menu. To manually configure the image settings, follow these steps: a. To prevent the image from moving, tap the Lock switch to enable it. b. To make the height and width of the image the same, tap the Scale switch to enable it. Reload the graphic by selecting it from the Menu. 71

72 6 Adding Graphic Elements c. (.png images only) To make white portions of the image transparent, tap the No White switch to enable it. Reload the graphic by selecting it from the Menu. d. To rotate the image, tap the Rotation switch to enable it. Ensure that the Lock and Scale switches are disabled; if not, tap them to disable them. Rotate the image with your fingers. The Rotation dialog box appears, allowing you to rotate the image more precisely. Type degrees of rotation in the box, or tap the to enter degrees; tap Save. To add a.svg background image to a container: 1. Tap and then tap Graphic Container Editor to display the Graphic Container Editor menu. 2. Tap Element. 3. Scroll the list to select SVG. 4. Tap Add Element. An SVG element is added to the graphic. 5. Tap. A list of available SVG image files appears. 6. Scroll the list to select the file you want to use and then tap Save. The image is added to the container and sized to full screen. 7. (Optional) To resize the background image, tap and then tap the Lock switch to turn it off. Pinch or stretch the image with your fingers. To more precisely size the image, move it until the location/size dialog box appears. Tap Size, enter the width and height, and then tap Resize. The Facility Prime Editor application includes graphic elements that provide a means of displaying point data and other content. A list of the elements, their functions, and instructions for configuring the properties of each element are provided in Part 7: Configuring Elements. To help you select the element for a particular purpose, the elements in the list are grouped by function: Monitor, Monitor and Command, Critical Environments, General, and Special Use. Refer to this list, along with the instructions below, as you add graphic elements to a container. To add a graphic element to a container: 1. Tap and then tap Graphic Container Editor to display the Graphic Container Editor menu. 2. Tap Element. 72

73 6 Linking Elements to Points 3. Scroll the list to select the element you want to add. 4. Tap Add Element. Depending on the element you selected, you may be prompted to enter an element title. Type the title and then tap OK. The element is added to the container. 5. (Optional) Drag the element to the desired location. Moving an element displays the location/size dialog box. You can use this dialog box to more precisely position the element. Tap Location, enter coordinates, and then tap Move. 6. (Optional) Resize the element by pinching or stretching it with your fingers. To more precisely size the image, move it until the location/size dialog box appears. Tap Size, enter the width and height, and then tap Resize. Some elements link to points and display point data. After you add an element to a graphic, the next step is to link the element to the desired point. Some elements link to a single point and some to multiple points. Also, some elements do not display point data and do not need to be linked. Each element that can display point data has a network button ( ) that you tap to display either the BACnet Browser or Siemens P2 Browser. If you downloaded point data from your field panels or imported a.csv file containing point data, you will be able to select the point from the browser when you configure the element. (See Steps to Success on page 61 for more information about downloading and importing point data.) If you did not download or import point data and you are connected to the BACnet or P2 network, you can tap the + in the browser and download field panel and point data. See Using the BACnet Browser on page 30 and Using the Siemens P2 Browser on page 37 for instructions on downloading field panel and point data. If you did not download or import point data and you are working offline, you must enter the point data manually. The type of data you will enter depends on the network type, as shown in the table that follows. 73

74 6 BACnet Networks Object Type Object Instance # Property Identifier Field Panel IP Address MAC Address and Network # (to link to a point in an MSTP device, such as a TEC)* *The format for entering an IP address for an MSTP device is [IPaddress]:[MACaddress]:[network#] Siemens P2 Networks P2 Point Name or TEC Name and Subpoint Name (to link to a subpoint in a TEC)** P2 BLN Name P2 Panel Name P2 IP Address **The format for entering a TEC point is [TECname]:[subpointname] For specific instructions on linking each type of element, see Part 7: Configuring Elements. Configuring and Formatting Elements Some elements have configuration settings that control how the element behaves. In addition, some elements may also have formatting options that allow you to change the appearance of the element, such as colors, line styles, fonts, and so on. For instructions for configuring and formatting elements, see Part 7: Configuring Elements. Filtering Elements If your graphic has many elements, it may be difficult to select a specific element in order to move or edit it. Use the Filter function to isolate the element so you can more easily, move, resize, or configure the element without affecting other nearby elements. To filter an element: 1. Tap and then tap Graphic Container Editor. 2. Tap Filter. 3. Tap Show Tag Number. Tag numbers appear over each element in the graphic. Note the tag number of the element you want to isolate. Note: Multiple elements can have the tag number 0 if new elements were added since the graphic was last opened. To assign unique numbers to all the elements, open a different graphic and then reopen the graphic with the duplicate tag numbers. 4. Tap and then tap Graphic Container Editor. 74

75 6 5. In the Filter box, type the tag number and then tap Filter. The element is isolated so that only that element can be moved or tapped. 6. To remove the filter do one of the following: Reload the graphic by selecting it from the Menu. Tap and then tap Graphic Container Editor. Tap Unfilter All. Removing Elements from a Graphic The following procedure removes a specific graphic element from a graphic. To remove a graphic element from a graphic, do one of the following: Triple-tap the element you want to remove and then tap Delete. Drag the element until the location/size dialog box appears. Tap Delete. The Delete button appears. Tap Delete again. 75

76 7 Part 7: Configuring Elements (Editor only) Introduction In Facility Prime Editor, you use the Graphics Container Editor to add graphic elements to a container to compose a graphic. Each element has configuration properties that allow you to customize the element for your needs. Many elements also display point data from field panels; these elements require additional configuration to link them to the points from which the element will retrieve data. To help you select the best element for your needs, the elements are categorized in this guide according to their functions: Monitor Command Monitor and Command Alarm Group Circular Gauge Data Feed Gradient Indicator Critical Environments 3LvlLightCntrl ACH Hazard Sign Pressure Ball Vertical Gauge Point Table Space Sensor Vertical Indicator Analog Commander Binary Commander Display Button State Commander Analog Display Group Temperature, Humidity, Ventilation, Lights, Air Quality, Blinds Mini Temperature, Humidity, CO2, Pressure, Lights Point Label General Use Graphs Special Use Document FLN Device Image Link Commander Position Animation Rotation View Text Analytic Graph Bar Graph Charts Dynamic Plotter Line Graph Pie Graph Sample Graph Trend Plotter CCTV Location SVG 76

77 7 Monitor Elements Alarm Group Use the Alarm Group element to provide a visual indication of an alarm condition for any point in a selected group of up to five points. This element displays a red box and the word Alarm when one of the points in the group is in alarm. When no points are in alarm, the element is not visible. For this reason, the Alarm Group element is best used as an overlay on a background image such as a floor plan. To link points to this element: 1. Tap and then tap. The Point Selector appears. 2. In the Label box, type a name for the point. (The name will appear at the bottom of the Point Selector when you add the point to the list.) 3. Tap the network type. 4. Add the point details by doing one of the following: Tap Auto to select the point from the BACnet Browser or P2 Browser. For more information about the browsers, see Using the BACnet Browser on page 30 or Using the Siemens P2 Browser on page 37. Manually enter the point details. 5. Tap Add to add the point to the list. 6. To add additional points, tap the + to increment the counter, then repeat Steps 2 through Tap Done and then tap. 8. When you are finished configuring the element, tap. Circular Gauge The Circular Gauge provides a visual indication of normal operating range, alarm limits, setpoint, and current value. The Circular Gauge element links to two points, one for monitoring the current value and one for commanding the setpoint. Two styles of the gauge are available: Classic (above left) and Modern (above right). By default, the Classic style is displayed; a switch selects the Modern style. Classic style On the Classic style gauge, the green area indicates the normal range; the alarm range is shown in red. The blue needle shows the current value, as do the 77

78 7 numerals in the center of the gauge. The green needle indicates the setpoint, if one is configured. The Classic gauge shows a range of 100 units. The Base Offset sets the low end of the scale; the upper end of the scale is Base Offset The resolution of the scale (size of the units) is determined by the Scale Factor. The resolution can be set to hundredths (0.01), tenths (0.1), or ones (1). The examples below show the different Scale Factor settings. Scale Factor 0.01 Scale Factor 0.1 Scale Factor 1.0 Modern style On the Modern style gauge, only the minimum and maximum values of the scale are shown. The green area of the outer band indicates the normal range; the alarm range is shown in red. The thicker blue-green band indicates the current value of the monitor point, as do the large numerals in the center of the gauge. The innermost gray band indicates the value of the setpoint, as do the smaller numerals in the center of the gauge. The Modern style gauge can handle a larger range than the Classic style. The low and high ends of the range are defined by entering values in the Minimum and Maximum boxes, respectively. (The Base Offset and Scale Factor boxes are unavailable in the Modern gauge.) To configure this element: 1. Tap. The settings dialog box appears. The top of the settings dialog box shows the current settings; the lower area is for entering new settings. To see all the settings, swipe left across the settings area. 2. If you would like to configure a Modern style gauge, tap the Modern switch to enable it. 3. Tap the Low Limit box, tap to clear the box, and then type the low alarm limit in the box. 4. Tap the Set Point box, tap to clear the box, and then type the setpoint in the box. 5. Tap the High Limit box, tap to clear the box, and then type the high alarm limit in the box. 78

79 7 6. (Classic style only) Tap the Base Offset box, tap to clear the box, and then type the base offset in the box. Repeat for the Scale Factor box. Allowable Scale Factors are 0.01, 0.1, and (Modern style only) Tap the Minimum box, tap to clear the box, and then type a value for the low end of the range in the box. Tap the Maximum box, tap to clear the box, and then type a value for the high end of the range in the box. To link points to this element: 1. Tap. 2. Select the point you want to link. Tap Monitor to link the current-value point or Set Point to link the point for the setpoint. 3. Tap the network type. 4. Do one of the following: If the network type is: BACnet or P2 BACnet And you are linking the point by: Using the browser to select the point Manually entering the point details Then follow these steps: a. Tap. The browser appears. b. Tap the field panel containing the point you want to link. A listing of points in that field panel appears. c. Tap the point you want to link. a. In the Object Type box, tap to clear the box, tap the desired Object Type from the list, and then tap Save. b. In the Object Instance# box, tap to clear the box and then type an Object Instance number in the box. c. In the Property Identifier box, tap to clear the box, tap the desired Property Identifier from the list, and then tap Save. d. In the IP Address box, tap to clear the box and then type an IP Address in the box. Continued on next page 79

80 7 If the network type is: P2 5. Tap. And you are linking the point by: Manually entering the point details Then follow these steps: Enter the following data in the boxes: P2 Point Name P2 BLN Name P2 Panel Name P2 IP Address 6. Repeat Steps 2 through 5 to link the second point. 7. To allow users to command the high and low alarm limits, tap the Adv-Cmd switch to enable it. (Note that users can command the setpoint without enabling the Adv-Cmd switch.) 8. To make a copy of the element, tap. 9. When you are finished configuring the element, tap. A message appears asking if you want to transmit values. Tap Transmit to command the point s high and low alarm limits, value, and setpoint to the values in the associated fields; tap Cancel if you do not want to command the point. Data Feed Use the Data Feed element to link to an XML data feed for retrieving real-time data such as weather and news. In the initial state, the Data Feed element displays the value of one attribute of the feed that you specify when you configure the element. When tapped, the Data Feed element displays the full complement of attributes for that feed. The Data Feed element can be used in conjunction with a Position Animation element on the same graphic to display a different image based on the value of the Data Feed element. To do this, both elements must have the XML Data switch enabled and both must be assigned the same XML ID. This feature can be used with a weather feed, national security threat levels, or any other information passed via XML. For example, a Data Feed element could be linked to a weather feed and configured to display the attribute weather_description (cloudy, rain, snow, windy, and so on). The Position Animation element would then be configured so that the values cloudy, rain, snow, and windy are each associated with a different image that represent that condition. When the Data Feed element receives a change of value from the feed, it broadcasts that value to the Position Animation element on the same graphic, which displays the corresponding image. 80

81 7 Before using this element, complete these steps: 1. Ensure that the ReadPropertyMultiple Service is turned on for the FacilityPrime application in ipad Settings. 2. Obtain the URL for the RSS feed you want to link to the element. 3. Obtain the syntax for the attribute you want to display in the element (for example, temp_f, relative_humidity, and so on). You can do this by rightclicking the web page and selecting View Page Source. This will show you the XML code for the page. The attributes are shown in brackets (<>). To configure this element: 1. In the Enter Title dialog box, type a title for the element and then tap OK. Titles longer than 15 characters will be truncated. Note: To edit the title, tap and then tap. 2. Tap. 3. If you are using the Data Feed element with other XML elements on the same graphic (such as the Position Animation element), enable the XML Data switch and type the XML ID number in the XML ID box. 4. Tap. 5. In the Data URL box, type the path for the data feed using the following format: [URL]~[attribute] Where: [URL] is the URL for the RSS web page and [attribute] is the attribute you want the element to display in its initial state. 6. Tap and then tap. 81

82 7 Gradient Indicator The Gradient Indicator element is a segmented bar that can be configured to indicate by color a point s condition: normal (green), warning (yellow), or danger (red). The bar can be oriented vertically or horizontally. To configure this element: 1. (Optional) To change the orientation of the bar to horizontal, drag the element to display the location/size dialog box. Tap Size and change the width and height so that the width is larger than the height. Tap Resize. 2. Tap and then tap. 3. Define the range for the scale by typing the lower end of the range in the Min box and the upper end in the Max box. Define a range that is relevant for the point being monitored, which may not be the entire operating range of the device. For example, a temperature sensor may have an operating range of degrees F, but the relevant range for the application may be only degrees F. 4. In the Qty box, type the number of segments to display. 5. In the Warn box, select a percentage of the total range that represents the warning range. For example, if the total range is degrees F (50 degree span) and you want the warning range to begin at 80 degrees, the percentage would be 60%. 6. In the Danger box, select a percentage of the total range that represents the danger range. 7. If you want the danger (red) zone to appear at the bottom of the indicator, tap the Reverse switch to enable it. 8. Tap. To link a point to this element: 1. Tap. The Point Selector appears. 2. In the Label box, type a name for the point. (The name will appear at the bottom of the Point Selector when you add the point to the list.) 3. Tap the network type. 82

83 7 4. Add the point details by doing one of the following: Tap Auto to select the point from the BACnet Browser or P2 Browser. For more information about the browsers, see Using the BACnet Browser on page 30 or Using the Siemens P2 Browser on page 37. Manually enter the point details. 5. Tap Add to add the point to the list. 6. Tap Done and then tap. 7. When you are finished configuring the element, tap. Point Table The Point Table element enables you to set up an array of up to five points and monitor the status, current value, setpoint, and the difference between the current value and setpoint (delta). Each row in the table is linked to two points, one to display the current value of the point and the other to display the setpoint. A graphic can have up to six point tables. To configure this element: 1. Tap. 2. In the Table Title box, type a title for the table. 3. In the Table # box, type a number (1 through 6) for the table. To link points to the table: 1. Tap. The Point Selector appears. 2. In the Label box, type a name for the point pair. This is the name that will appear in the table. 3. Tap the network type. 4. Tap Monitor. 5. Add the point details by doing one of the following: Tap Auto to select the point from the BACnet Browser or P2 Browser. For more information about browsers, see Using the BACnet Browser on page 30 or Using the Siemens P2 Browser on page 37. Manually enter the point details. 83

84 7 6. Tap Add to add the point to the list. 7. Tap Setpoint. 8. Add the point details by doing one of the following: Tap Auto to select the point from the BACnet Browser or P2 Browser. For more information about browsers, see Using the BACnet Browser on page 30 or Using the Siemens P2 Browser on page 37. Manually enter the point details. 9. Tap Add to add the point to the list. 10. To add additional point pairs, tap the + to increment the counter, then repeat Steps 2 through Tap Done and then tap. 12. When you are finished configuring the element, tap. Space Sensor The Space Sensor element provides a graphical representation of a wall sensor. The Space Sensor element links to up to three points: one for monitoring the current value, one for commanding the setpoint, and a third auxiliary point that is linked to the large, blue button on the Space Sensor. The auxiliary point is a binary point, such as a light or occupancy switch. If a Space Sensor element is linked to a BACnet monitor point with units defined as either Degrees-Fahrenheit or Degrees-Celsius, the element will display a selector switch to allow users to choose the units they would prefer. To configure and link points to this element: 1. Tap. 2. (Optional) To enter a title, tap. In the Enter Title dialog box, type a title for the element and then tap OK. Titles longer than 12 characters will be truncated. 3. Select the type of point you are linking. Tap Mon to link the current-value point; STPT to link the point for the setpoint; and Aux to link a binary point to the blue button. 4. Tap the network type. 84

85 7 5. Do one of the following: If the network type is: BACnet or P2 BACnet P2 6. Tap. And you are linking the point by: Using the browser to select the point Manually entering the point details Manually entering the point details Then follow these steps: a. Tap. The browser appears. b. Tap the field panel containing the point you want to link. A listing of points in that field panel appears. c. Tap the point you want to link. a. In the Object Type box, tap to clear the box, tap the desired Object Type from the list, and then tap Save. b. In the Object Instance# box, tap to clear the box and then type an Object Instance number in the box. c. In the Property Identifier box, tap to clear the box, tap the desired Property Identifier from the list, and then tap Save. d. In the IP Address box, tap to clear the box and then type an IP Address in the box. Enter the following data in the boxes: P2 Point Name P2 BLN Name P2 Panel Name P2 IP Address 7. Repeat Steps 2 through 6 for the remaining points. 8. When you are finished linking points, tap. 85

86 7 Vertical Indicator The Vertical Indicator element is a vertical bar graph that represents the current value of a single point. 1. Tap. To configure this element: 2. In the Max Value box, type a number for the upper limit of the scale. 3. In the Increment Value box, type the increments for the scale. 4. If you want to turn off the vertical and horizontal axis lines, tap the Axis switch to disable the lines. 5. If you want to remove the shadows from the bars and line, tap the Shadow switch to disable it. 6. To set the color of the bar, tap. Scroll the list to select the color of the bar. Tap outside of the color dialog box to close it. To link a point to this element: 1. Tap. The Point Selector appears. 2. In the Label box, type a name for the point. This name will appear on the graphic, and it can be a different name than the one in the BAS. 3. Tap the network type. 4. Add the point details by doing one of the following: Tap Auto to select the point from the BACnet Browser or P2 Browser. For more information about browsers, see Using the BACnet Browser on page 30 or Using the Siemens P2 Browser on page 37. Manually enter the point details. 5. Tap Add to add the point to the list. 6. Tap Done and then tap. 7. When you are finished configuring the element, tap. 86

87 7 Command Elements Analog Commander Use this element to command an associated analog point, such as a temperature or humidity setpoint, valve or damper position, or fan speed. To configure and link a point to this element: 1. In the Enter Title dialog box, type a title for the element and then tap OK. Titles longer than 15 characters will display the first 6 characters and the last 7 characters. Note: To edit the title, tap and then tap. 2. Tap and then tap. 3. Tap the network type. 4. Do one of the following: If the network type is: BACnet or P2 BACnet And you are linking the point by: Using the browser to select the point Manually entering the point details Then follow these steps: a. Tap. The browser appears. b. Tap the field panel containing the point you want to link. A listing of points in that field panel appears. c. Tap the point you want to link. a. In the Object Type box, tap to clear the box, tap the desired Object Type from the list, and then tap Save. b. In the Object Instance# box, tap to clear the box and then type an Object Instance number in the box. c. In the Property Identifier box, tap to clear the box, tap the desired Property Identifier from the list, and then tap Save. d. In the IP Address box, tap to clear the box and then type an IP Address in the box. Continued on next page 87

88 7 If the network type is: P2 5. Tap. And you are linking the point by: Manually entering the point details Then follow these steps: Enter the following data in the boxes: P2 Point Name P2 BLN Name P2 Panel Name P2 IP Address 6. When you are finished configuring the element, tap. Binary Commander Use this element to command an associated binary point, such as a light or door lock. To configure and link a point to this element: 1. In the Enter Title dialog box, type a title for the element and then tap OK. Titles longer than 15 characters will display the first 6 characters and the last 7 characters. Note: To edit the title, tap and then tap. 2. Tap and then tap. 3. Tap the network type. 4. Do one of the following: If the network type is: BACnet or P2 BACnet And you are linking the point by: Using the browser to select the point Manually entering the point details Then follow these steps: a. Tap. The browser appears. b. Tap the field panel containing the point you want to link. A listing of points in that field panel appears. c. Tap the point you want to link. a. In the Object Type box, tap to clear the box, tap the desired Object Type from the list, and then tap Save. Continued on next page 88

89 7 If the network type is: P2 5. Tap. And you are linking the point by: Manually entering the point details Then follow these steps: b. In the Object Instance# box, tap to clear the box and then type an Object Instance number in the box. c. In the Property Identifier box, tap to clear the box, tap the desired Property Identifier from the list, and then tap Save. d. In the IP Address box, tap to clear the box and then type an IP Address in the box. Enter the following data in the boxes: P2 Point Name P2 BLN Name P2 Panel Name P2 IP Address 6. When you are finished configuring the element, tap. Display Button Use this element to create a push button for toggling on and off a binary point. Display Buttons are typically used for scene selection in which several points are commanded to specific values when the button is pressed. For example, in the Conference Room graphic below, the Scenes area contains four Display Buttons that correspond with four uses for the room: unoccupied, meeting, presentation, and reception. Occupants can select a single button, and the temperature, ventilation fan, and lighting setpoints will be adjusted to preset levels that make sense for that use. 89

90 7 Each Display Button is linked to two images, one representing the default or inactivated state and the other representing the selected or activated state. Any two images may be used; however, it is typical for the two images to be identical except for color to mimic the behavior of a hardware button. Each Display Button is linked to a single, binary point that controls the selection of the scene. The binary point may be a virtual point that sets the values of other points via programming in the field panel. If no virtual point is available, the Display Button has a Button Scene Editor that can be configured to work with Group elements used on the same graphic. The Button Scene Editor also allows you to configure a set of Display Buttons so that only one button can be active at a time. To configure this element: 1. Tap. 2. Tap Default and then tap DefaultImage.png. The image selector appears. 3. Scroll the list of images to select the image you want to use for the button s default, or inactivated state. If you know the name of the image, you can begin typing the name in the search box to scroll the list to images that begin with those letters. When you locate the image you want to use, tap Select. 4. Tap Selected and then tap SelectedImage.png. The image selector appears. 90

91 7 5. Scroll the list of images or use the search box to select the image you want to use for the button s selected, or activated state. When you have located the image you want to use, tap Select. To link a point to this element: 1. Tap Point. 2. Tap the network type. 3. Do one of the following: If the network type is: BACnet or P2 BACnet P2 And you are linking the point by: Using the browser to select the point Manually entering the point details Manually entering the point details Then follow these steps: a. Tap. The browser appears. b. Tap the field panel containing the point you want to link. A listing of points in that field panel appears. c. Tap the point you want to link. a. In the Object Type box, tap to clear the box, tap the desired Object Type from the list, and then tap Save. b. In the Object Instance# box, tap to clear the box and then type an Object Instance number in the box. c. In the Property Identifier box, tap to clear the box, tap the desired Property Identifier from the list, and then tap Save. d. In the IP Address box, tap to clear the box and then type an IP Address in the box. Enter the following data in the boxes: P2 Point Name P2 BLN Name P2 Panel Name P2 IP Address 91

92 7 4. To allow users to command the element without logging in, tap the Adv-Cmd switch to enable it. 5. Tap and then tap to save the configuration. To configure the Button Scene Editor: 1. Tap and then tap. The Button Scene Editor appears. 2. Under Button Grouping #, tap the switch to enable grouping and then type a group number in the box. The Grouping # can be thought of as a scene number; each scene is composed of one or more Group elements. You can have multiple scenes on a graphic, and each scene must have a unique Grouping #. 3. The remaining settings in the Button Scene Editor correspond to Group elements for temperature, humidity, lights, ventilation, air quality, and blinds. If the scene contains one of these Group elements, enable the element by tapping the switch below the element name. In the box next to the switch, type the setpoint you want to use for the element when the user selects the scene. For example, if the room is being used for a presentation, you could command the lights to 25% and the blinds to 0% to darken the room. 4. Tap Save. 5. When you are finished configuring the element, tap. State Commander Use this element to command BACnet multi-value points or P2 logical enumeration (LENUM) points. These point types have more than one possible state, such as Off, On-Low, On-Medium, On-High and so on. In the field panel, each state is assigned a number. If you are configuring a State Commander element offline, you must obtain the state numbers so you can enter them manually. If you are configuring the element online, you can import the states from the field panel. To configure and link a point to this element: 1. In the Enter Title dialog box, type a title for the element and then tap OK. Titles longer than 15 characters will display the first 6 characters and the last 7 characters. Note: To edit the title, tap and then tap. 2. Tap. 3. Tap the network type. 92

93 7 4. Do one of the following: If the network type is: BACnet or P2 BACnet P2 5. Tap. And you are linking the point by: Using the browser to select the point Manually entering the point details Manually entering the point details Then follow these steps: a. Tap. The browser appears. b. Tap the field panel containing the point you want to link. A listing of points in that field panel appears. c. Tap the point you want to link. a. In the Object Type box, tap to clear the box, tap the desired Object Type from the list, and then tap Save. b. In the Object Instance# box, tap to clear the box and then type an Object Instance number in the box. c. In the Property Identifier box, tap to clear the box, tap the desired Property Identifier from the list, and then tap Save. d. In the IP Address box, tap to clear the box and then type an IP Address in the box. Enter the following data in the boxes: P2 Point Name P2 BLN Name P2 Panel Name P2 IP Address 6. When you are finished configuring the element, tap. To configure states online: 1. Turn off Edit Mode. 2. Tap State. The State Commander dialog box appears. 3. Tap the State Edit switch to enable editing. 4. Tap Import. The states are imported from the field panel and appear in the State Commander dialog box. 93

94 7 To configure states offline: 1. Turn off Edit Mode. 2. Tap State. The State Commander dialog box appears. 3. Tap the State Edit switch to enable editing. 4. In the State Name box, type a name for the state. 5. In the Value box, type the number assigned to the state in the field panel. 6. Tap Add to add the state to the list. Repeat Steps 4 and 5 for each additional state. 7. When you are finished configuring states, tap outside the State Commander dialog box to close it. Monitor and Command Elements Analog Display Use the Analog Display element to display the value of an analog point and to command the point to a new value using + and - buttons. To link a point to this element: 1. Tap. 2. Tap the network type. 3. Do one of the following: If the network type is: BACnet or P2 And you are linking the point by: Using the browser to select the point Then follow these steps: a. Tap. The browser appears. b. Tap the field panel containing the point you want to link. A listing of points in that field panel appears. c. Tap the point you want to link. Continued on next page 94

95 7 If the network type is: BACnet P2 4. Tap. And you are linking the point by: Manually entering the point details Manually entering the point details Then follow these steps: a. In the Object Type box, tap to clear the box, tap the desired Object Type from the list, and then tap Save. b. In the Object Instance# box, tap to clear the box and then type an Object Instance number in the box. c. In the Property Identifier box, tap to clear the box, tap the desired Property Identifier from the list, and then tap Save. d. In the IP Address box, tap to clear the box and then type an IP Address in the box. Enter the following data in the boxes: P2 Point Name P2 BLN Name P2 Panel Name P2 IP Address 5. To allow users to command the setpoint, tap the Adv-Cmd switch to enable it. 6. When you are finished configuring the element, tap. Group Temperature, Humidity, Ventilation, Lights, Air Quality, and Blinds Group elements provide a simple user interface for displaying the setpoint and current value of a point along with a slider for setpoint adjustment. There are separate Group elements for temperature, humidity, ventilation, lights, air quality, and blinds. All of the Group elements are configured similarly. Each Group element links to up to three points: one for monitoring the current value, one for commanding the setpoint, and a third auxiliary point that is linked to an on/off button ( ), which appears between the + and buttons on the element (the button is hidden when no Aux point is linked to the element). If a Group Temperature element is linked to a BACnet monitor point with units defined as either Degrees-Fahrenheit or Degrees-Celsius, the element will display a selector switch to allow users to choose the units they would prefer. The 95

96 7 switch appears when the user taps the + or button to adjust the setpoint and then disappears. By default, the element displays a range of 55 through 90, which is appropriate for degrees Fahrenheit. You can change the range in ipad Settings for the Facility Prime application under Temperature Group Element. Group elements can be linked to Display Button elements to create scene selection graphics. See Display Button on page 89 for more information. To link points to a Group element: 1. Tap. 2. Select the point you want to link. Tap Mon to link the currentvalue point; STPT to link the point for the setpoint; and Aux to link a binary point to the button. 3. Tap the network type. 4. Do one of the following: If the network type is: BACnet or P2 BACnet And you are linking the point by: Using the browser to select the point Manually entering the point details Then follow these steps: a. Tap. The browser appears. b. Tap the field panel containing the point you want to link. A listing of points in that field panel appears. c. Tap the point you want to link. a. In the Object Type box, tap to clear the box, tap the desired Object Type from the list, and then tap Save. b. In the Object Instance# box, tap to clear the box and then type an Object Instance number in the box. c. In the Property Identifier box, tap to clear the box, tap the desired Property Identifier from the list, and then tap Save. Continued on next page 96

97 7 If the network type is: P2 5. Tap. And you are linking the point by: Manually entering the point details Then follow these steps: d. In the IP Address box, tap to clear the box and then type an IP Address in the box. Enter the following data in the boxes: P2 Point Name P2 BLN Name P2 Panel Name P2 IP Address 6. Repeat Steps 2 through 5 to link the second point. 7. To allow users to command the setpoint, tap the Adv-Cmd switch to enable it. 8. When you are finished configuring the element, tap. Mini Temperature, Humidity, CO2, Pressure, and Lights These small elements provide visual indication of current value and the ability to command the setpoint. Each element links to two points, one for monitoring the current value and one for commanding the setpoint. If only the monitor point is linked, the element will display the current value, but will not allow you to change the setpoint. NOTE: The Mini Light element is designed for analog lighting (dimmers). If you have an on/off switch to control, consider using the Display Button element instead. If you use the Mini Light element with an on/off switch, you will need to command the switch to 0 for off and 1 for on. To link these elements to points: 1. Tap. 2. Tap the type of point you are linking. 3. Tap the network type. 97

98 7 4. Do one of the following: If the network type is: BACnet or P2 BACnet P2 5. Tap. And you are linking the point by: Using the browser to select the point Manually entering the point details Manually entering the point details Then follow these steps: a. Tap. The browser appears. b. Tap the field panel containing the point you want to link. A listing of points in that field panel appears. c. Tap the point you want to link. a. In the Object Type box, tap to clear the box, tap the desired Object Type from the list, and then tap Save. b. In the Object Instance# box, tap to clear the box and then type an Object Instance number in the box. c. In the Property Identifier box, tap to clear the box, tap the desired Property Identifier from the list, and then tap Save. d. In the IP Address box, tap to clear the box and then type an IP Address in the box. Enter the following data in the boxes: P2 Point Name P2 BLN Name P2 Panel Name P2 IP Address 6. Repeat Steps 2 through 5 for the second point. 7. When you are finished linking points, tap. 98

99 7 Point Label Use this element to display any combination of the following: point name, description, value, units, status, state text, and priority. To link a point to this element: 1. Double-tap the element to display the configuration parameters. 2. Link the element to the point as follows: a. Tap the network type. b. Do one of the following: If the network type is: BACnet or P2 BACnet P2 And you are linking the point by: Using the browser to select the point Manually entering the point details Manually entering the point details Then follow these steps: a. Tap. The browser appears. b. Tap the field panel containing the point you want to link. A listing of points in that field panel appears. c. Tap the point you want to link. a. In the Object Type box, tap to clear the box, tap the desired Object Type from the list, and then tap Save. b. In the Object Instance# box, tap to clear the box and then type an Object Instance number in the box. c. In the Property Identifier box, tap to clear the box, tap the desired Property Identifier from the list, and then tap Save. d. In the IP Address box, tap to clear the box and then type an IP Address in the box. Enter the following data in the boxes: P2 Point Name P2 BLN Name P2 Panel Name P2 IP Address 99

100 7 c. Tap. d. To allow users to command the point, tap the Adv-Cmd switch to enable it. e. To make a copy of the element, tap. To format this element: 1. Tap. The formatting dialog box appears. 2. Select the properties you want to display for the point by tapping the corresponding switches to enable them. You can choose to display any combination of the following properties: point name, description, value, units, status, state text, and priority. Note that only properties that are defined for the point in the field panel will display. 3. To filter long point names so they are easier to read on the graphic, use the filter options as follows: Filter Option Prefix Suffix Description Removes the characters you type in the filter box when those characters appear at the beginning of the point name. Removes the characters you type in the filter box when those characters appear at the end of the point name. # Char Truncates the front end of the point name by displaying the last characters of the name according to the number you type in the filter box.. Removes the characters preceding the last dot (.) in the point name. Example Original point name: centralhs_fieldhouse_lights Filter text: centralhs_ Resulting point name: fieldhouse_lights Original point name: lights_fieldhouse_centralhs Filter text: centralhs Resulting point name: lights_fieldhouse Original point name: lights_fieldhouse_centralhs Filter text: 10 Resulting point name: lights_fieldhouse Original point name: centralhs_fieldhouse.lights Resulting point name: lights 100

101 7 4. To add a custom description in place of the description in the field panel, disable the Description switch, enable the Custom Description switch, and then type a description in the Custom Description box. Tap Set Data. 5. To apply these settings every time you add a Point Label element, tap Set As Defaults. 6. To set the order in which you want the properties to display, tap Field Order. The Field Order dialog box appears. Reorder the properties by dragging them to the desired positions. Tap Done. 7. When you are finished formatting this element, tap outside the formatting dialog box to close it. 8. Tap. Critical Environments Elements 3LvlLightCntrl (three-level light control) The 3LvlLightCntrl element is used for monitoring and commanding lighting in critical environments such as a laboratory and vivarium. The 3LvlLightCntrl element provides monitoring and commanding of three lights: red, day, and clean. To configure and link points to this element: 1. In the Enter Title dialog box, type a title for the element and then tap OK. Titles longer than 15 characters will display the first 6 characters and the last 7 characters. Note: To edit the title, tap and then tap. 2. Tap and then tap. 3. Do the following to link points to each light. You must link a command point to the light to enable the light to be commanded on or off. If a feedback point is defined in the field panel, you can also link that point to the light. a. Tap next to the light. b. Tap Command. c. Tap the network type. 101

102 7 d. Do one of the following: If the network type is: BACnet or P2 BACnet P2 e. Tap. And you are linking the point by: Using the browser to select the point Manually entering the point details Manually entering the point details Then follow these steps: a. Tap. The browser appears. b. Tap the field panel containing the point you want to link. A listing of points in that field panel appears. c. Tap the point you want to link. a. In the Object Type box, tap to clear the box, tap the desired Object Type from the list, and then tap Save. b. In the Object Instance# box, tap to clear the box and then type an Object Instance number in the box. c. In the Property Identifier box, tap to clear the box, tap the desired Property Identifier from the list, and then tap Save. d. In the IP Address box, tap to clear the box and then type an IP Address in the box. Enter the following data in the boxes: P2 Point Name P2 BLN Name P2 Panel Name P2 IP Address f. To link a monitor point, tap Monitor and then repeat Steps c through e. g. When you are finished linking points to a light, tap. 4. Tap Return. 102

103 7 ACH The ACH element provides graphical view and control for airflow (air changes per hour) in critical environments. The ACH element links to two points, one for monitoring the current value and one for commanding the setpoint. The current value is shown in the center of the circle. If only the monitor point is linked, the element will display the current value, but will not allow you to change the setpoint. If only the point for the setpoint is linked, the current value shown in the center of the element will always read zero, but you will be able to command the setpoint. To link points to this element: 1. Tap. 2. (Optional) To add a title to the element, tap. In the Enter Title dialog box, type a title and then tap OK. Titles longer than 15 characters will be truncated. 3. Tap the type of point you are linking. 4. Tap the network type. 5. Do one of the following: If the network type is: BACnet or P2 BACnet And you are linking the point by: Using the browser to select the point Manually entering the point details Then follow these steps: a. Tap. The browser appears. b. Tap the field panel containing the point you want to link. A listing of points in that field panel appears. c. Tap the point you want to link. a. In the Object Type box, tap to clear the box, tap the desired Object Type from the list, and then tap Save. b. In the Object Instance# box, tap to clear the box and then type an Object Instance number in the box. Continued on next page 103

104 7 If the network type is: P2 6. Tap. And you are linking the point by: Manually entering the point details Then follow these steps: c. In the Property Identifier box, tap to clear the box, tap the desired Property Identifier from the list, and then tap Save. d. In the IP Address box, tap to clear the box and then type an IP Address in the box. Enter the following data in the boxes: P2 Point Name P2 BLN Name P2 Panel Name P2 IP Address 7. Repeat Steps 3 through 6 for the second point. To set the setpoint and alarm limits (if a setpoint is linked): 1. Tap. 2. In the Set Point box, scroll the list or type a value to set the setpoint. 3. (Optional) If the point is alarmable, scroll the list or type values in the Low Limit and High Limit boxes to set the low and high alarm limits. 4. Tap Save. A message appears asking if you want to transmit the new values. 5. Tap Transmit. 6. When you are finished configuring the element, tap. Hazard Sign The Hazard Sign element is a graphical depiction of the National Fire Protection Association (NFPA) hazard identification system. For more information about this system, see the NFPA Web site at The element links to a virtual analog point. Depending on the point s value, the element will display one or more colors and numerical codes indicating the type and severity of each hazard present in the space. 104

105 7 To configure and link a point to this element: 1. Double-tap the element. 2. Tap the network type. 3. Do one of the following: If the network type is: BACnet or P2 BACnet P2 And you are linking the point by: Using the browser to select the point Manually entering the point details Manually entering the point details Then follow these steps: a. Tap. The browser appears. b. Tap the field panel containing the point you want to link. A listing of points in that field panel appears. c. Tap the point you want to link. a. In the Object Type box, tap to clear the box, tap the desired Object Type from the list, and then tap Save. b. In the Object Instance# box, tap to clear the box and then type an Object Instance number in the box. c. In the Property Identifier box, tap to clear the box, tap the desired Property Identifier from the list, and then tap Save. d. In the IP Address box, tap to clear the box and then type an IP Address in the box. Enter the following data in the boxes: P2 Point Name P2 BLN Name P2 Panel Name P2 IP Address 4. To make a copy of the element, tap. 5. When you are finished configuring the element, tap. 105

106 7 Pressure Ball Use the Pressure Ball element to display the current value of a room air pressure point and a visual indication of the state of pressurization (positive or negative). The arrows and the value in the lower left corner of the element indicate the current condition of the room. Arrows pointing inward indicate negative pressure; arrows pointing outward indicate positive pressure. The setpoint is indicated by a + or in the center ball. The Pressure Ball element links to two points, one for monitoring the current value and one for commanding the setpoint. If only the monitor point is linked, the element will display the current value, but will not allow you to change the setpoint. If only the point for the setpoint is linked, the current value shown in the lower left-hand corner of the element will always read zero, but you will be able to command the setpoint. To link points to this element: 1. Tap. 2. Tap the type of point you are linking. 3. Tap the network type. 4. Do one of the following: If the network type is: BACnet or P2 BACnet And you are linking the point by: Using the browser to select the point Manually entering the point details Then follow these steps: a. Tap. The browser appears. b. Tap the field panel containing the point you want to link. A listing of points in that field panel appears. c. Tap the point you want to link. a. In the Object Type box, tap to clear the box, tap the desired Object Type from the list, and then tap Save. b. In the Object Instance# box, tap to clear the box and then type an Object Instance number in the box. c. In the Property Identifier box, tap to clear the box, tap the desired Property Identifier from the list, and then tap Save. Continued on next page 106

107 7 If the network type is: P2 5. Tap. And you are linking the point by: Manually entering the point details Then follow these steps: d. In the IP Address box, tap to clear the box and then type an IP Address in the box.. Enter the following data in the boxes: P2 Point Name P2 BLN Name P2 Panel Name P2 IP Address 6. Repeat Steps 3 through 5 for the second point. 7. When you are finished linking points, tap. To set the setpoint and alarm limits (if a setpoint is linked): 1. Tap. 2. In the Set Point box, scroll the list or type a value to set the setpoint. 3. (Optional) If the point is alarmable, scroll the list or type values in the Low Limit and High Limit boxes to set the low and high alarm limits. 4. Tap Save. A message appears asking if you want to transmit the new values. 5. Tap Transmit. 6. When you are finished configuring the element, tap. Vertical Gauge The Vertical Gauge element provides a visual indication of normal operating range, alarm limits, setpoint, and current value. The Vertical Gauge links to two points, one for monitoring the current value and one for commanding the setpoint. The green area of the gauge indicates the normal range; the alarm range is shown in red. The blue bar shows the current value, as do the large numerals. The needle indicates the setpoint, if one is configured. The Vertical Gauge shows a range of 51 units: the center value, 25 units above the center value, and 25 units below the center value. The center value is determined by entering a Base Offset. To determine the Base Offset value, subtract the value you want in the center of the scale from zero. For example, if you want the center value to be 10, you will enter -10 in the Base Offset box. 107

108 7 The resolution of the scale (size of the units) is determined by the Scale Factor. The resolution can be set to thousandths (0.001), hundredths (0.01), tenths (0.1), ones (1), or tens (10). For example, if the center value is 0 and the increments are set to tenths (Scale Factor = 10), the range of the gauge will be -2.5 to 2.5. The examples below show the different Scale Factor settings with the Base Offset set to zero. Scale Factor 0.1 Scale Factor 1 Scale Factor 10 Scale Factor 100 Scale Factor 1000 A number of common, preset Base Offset and Scale combinations can be selected from a list or you can customize the scale by entering your own values. To configure this element: 1. Tap. The settings dialog box appears. The left side of the dialog box shows the current settings; the right side is for entering new settings. To see all the settings, swipe up across the new settings area. 2. Tap the Low Limit box, tap to clear the box, and then type the low alarm limit in the box. 3. Tap the Set Point box, tap to clear the box, and then type the setpoint in the box. 4. Tap the High Limit box, tap to clear the box, and then type the high alarm limit in the box. 5. For Base Offset and Scale Factor, do one of the following: Tap Base/Scale Selector and then tap a preset Base Offset/Scale combination from the list. Tap the Base Offset box, tap to clear the box, and then type the base offset in the box. Repeat for the Scale Factor box. Valid Scale Factors are 0.1, 1, 10, 100, and

109 7 To link points to this element: 1. Tap. 2. Select the point you want to link. Tap Monitor to link the current-value point or Set Point to link the point for the setpoint. 3. Tap the network type. 4. Do one of the following: If the network type is: BACnet or P2 BACnet P2 5. Tap. And you are linking the point by: Using the browser to select the point Manually entering the point details Manually entering the point details Then follow these steps: a. Tap. The browser appears. b. Tap the field panel containing the point you want to link. A listing of points in that field panel appears. c. Tap the point you want to link. a. In the Object Type box, tap to clear the box, tap the desired Object Type from the list, and then tap Save. b. In the Object Instance# box, tap to clear the box and then type an Object Instance number in the box. c. In the Property Identifier box, tap to clear the box, tap the desired Property Identifier from the list, and then tap Save. d. In the IP Address box, tap to clear the box and then type an IP Address in the box. Enter the following data in the boxes: P2 Point Name P2 BLN Name P2 Panel Name P2 IP Address 6. Repeat Steps 2 through 5 to link the second point. 109

110 7 General Use Elements 7. To allow users to command the high and low alarm limits, tap the Adv-Cmd switch to enable it. (Note that users can command the setpoint without enabling the Adv-Cmd switch.) 8. When you are finished configuring the element, tap. A message appears asking if you want to transmit values. Tap Transmit. Document Use the Document element to link a file to your graphic. For example, you could link asbuilt drawings, standard operating procedures, troubleshooting information, and so on. The Document element supports many file formats, including PDF, text (.txt), Microsoft Word (.doc), Microsoft Excel (.xls), and graphics (.png,.jpg). The file you want to link to your graphic must be located either on the ipad or on an FTP site to which to ipad has access. See Transferring Files between a Computer and the ipad on page 57 for instructions. You can also use the Document element to link to a URL, which enables you to display any web page including a page from a web cam. To configure this element: 1. (Optional) In the Enter Title dialog box, type a title for the element and then tap OK. Titles longer than 15 characters will display the first 6 characters and the last 7 characters. If the title is left blank, a button ( ) appears in place of the title. Note: To edit the title, tap and then tap. 2. Tap and then tap. 3. Do one of the following: If you are linking to a file on the ipad, type the document filename in the Document Path box. Tap. If you are linking to a file on an FTP site, type the path to the FTP site and document in the Document Path box. Tap. If you are linking to a URL, type the URL in the Document Path box. Tap. 4. When you are finished configuring the element, tap. To view the file or web page, turn off Edit Mode and reload the graphic by selecting it from the Menu. 110

111 7 FLN Device The FLN Device links to a Siemens FLN device and displays a secondary graphic representing the application in the device. You must create the secondary graphic as a template and name it the same as the device application number; for example, 2020 (for a P1 TEC VAV Cooling Only application) or 6596 (for a BACnet TEC Expanded IO application). A single template can then be linked to any number of FLN Device elements on your graphics. When a user taps the FLN Device on a graphic, the associated graphic template is displayed in a secondary window. For information about creating templates, see Creating Templates on page 53. In its initial state, the FLN device displays the current value of one subpoint from the FLN device. The default subpoint is AI4, which is typically the room sensor point. Before using this element, complete these steps: 1. If the FLN device is a BACnet device, import the device into the browser. See Using the BACnet Browser on page 30 for instructions. 2. Create a template. See Creating Templates on page 53. To link a TEC to this element: 1. Tap. 2. Tap FLN Dev. 3. Tap the network type. 4. Do one of the following: If the network type is: BACnet And you are linking the FLN device by: Using the browser to select the device Then follow these steps: a. Tap. The BACnet browser appears. b. Tap the FLN device you want to link. A listing of points in that FLN device appears. c. Tap the device object. Continued on next page 111

112 7 If the network type is: BACnet P2 5. Tap. And you are linking the FLN device by: Manually entering the device details Manually entering the device details Then follow these steps: a. In the Object Type box, tap to clear the box, tap the desired Object Type ( device ) from the list, and then tap Save. b. In the Device Instance# box, tap to clear the box and then type a Device Instance number in the box. c. In the Property Identifier box, tap to clear the box, tap the desired Property Identifier from the list, and then tap Save. d. In the IP Address box, tap to clear the box and then type an IP Address in the box. Use this format: [fieldpanelip]:[macaddress]:[network #] Enter the following data in the boxes: P2 Point Name in the following format: [TECname]:[anySubpoint] P2 BLN Name P2 Panel Name P2 IP Address To change the subpoint displayed in the element: 1. Tap Display. 2. Do one of the following: If the network type is: BACnet or P2 And you are linking the point by: Using the browser to select the point Then follow these steps: a. Tap. The browser appears. b. Tap the TEC containing the point you want to link. A listing of points in that TEC appears. c. Tap the point you want to link. Continued on next page 112

113 7 If the network type is: BACnet P2 And you are linking the point by: Manually entering the point details Manually entering the point details Then follow these steps: a. In the Object Type box, tap to clear the box, tap the desired Object Type from the list, and then tap Save. b. In the Object Instance# box, tap to clear the box and then type an Object Instance number in the box. c. In the Property Identifier box, tap to clear the box, tap the desired Property Identifier from the list, and then tap Save. d. In the IP Address box, tap to clear the box and then type an IP Address in the box. Enter the following data in the boxes: P2 Point Name P2 BLN Name P2 Panel Name P2 IP Address 3. Tap and then tap. Image Use the Image element to insert a background image into your graphic. See Adding Background Images on page 70 for instructions. Link Commander Use the Link Commander to add a link to an existing graphic. To configure this element: 1. (Optional) In the Enter Title dialog box, type a title for the element and then tap OK. Titles longer than 15 characters will be truncated. NOTE: To edit the title, tap and then tap. 2. Tap and then tap. 3. Tap Graphic Container. The list of available graphics appears. 4. Tap the graphic you want to link to and then tap. 5. When you are finished configuring the element, tap. 113

114 7 Position Animation Use the Position Animation element to create an animated graphic element that changes as a point s value changes. Position Animation elements are typically used to show motion corresponding to fan speeds and damper positioning, and status for doors (open/closed) and lights (on/off). For rotational movement, such as a fan, a series of images repeats at various speeds which correspond to the speeds of the device the image is representing. For positioning movement, such as a damper, individual images are associated with various positions corresponding to the positions of the device the image is representing. For example, an image showing a damper open 30% is displayed when the actual damper opens 30%. To use the Position Animation element you must have a series of up to 10.png or.jpg images on the ipad. Each image in the series represents the image in a different position, like frames of a filmstrip. (For binary points, only two images are needed: one for the on or open state and the other for the off or closed state.) The Position Animation element can also be used with the Data Feed element to display different images based on values received from the feed. For more information about this use, see Data Feed on page 80. To link points to this element: 1. Tap. 2. Tap Monitor to link the Monitor point. The Monitor point is the point represented by the animation. 3. Tap the network type. 4. Do one of the following: If the network type is: BACnet or P2 BACnet And you are linking the point by: Using the browser to select the point Manually entering the point details Then follow these steps: a. Tap. The browser appears. b. Tap the field panel containing the point you want to link. A list of points in that field panel appears. c. Tap the point you want to link. a. In the Object Type box, tap to clear the box, tap the desired Object Type from the list, and then tap Save. b. In the Object Instance# box, tap to clear the box and then type an Object Instance number in the box. Continued on next page 114

115 7 If the network type is: P2 5. Tap. And you are linking the point by: Manually entering the point details Then follow these steps: c. In the Property Identifier box, tap to clear the box, tap the desired Property Identifier from the list, and then tap Save. d. In the IP Address box, tap to clear the box and then type an IP Address in the box. Enter the following data in the boxes: P2 Point Name P2 BLN Name P2 Panel Name P2 IP Address 6. (Optional) Tap Set Point to link a point to command the setpoint. Repeat Steps 3 through 5. To configure the animation for an analog point: 1. Tap. The Value/Image Assignments dialog box appears. 2. Do one of the following: If all of the images in the series have the same filename plus an increment number that begins with 0 (for example, fan0.png, fan1.png, and so on), tap the Auto Fill Increment switch to enable it. Tap the Image Path #1 box, select the first image in the series from the list, and then tap Save. The remaining filenames are automatically added to the Value/Image Assignments dialog box. If the images in the series do not have the same filename plus an increment number, tap the Image Path #1 box, select the first image in the series from the list, and then tap Save. Add the remaining images in the same manner. 3. In the first column, enter the point value associated with each image. For example, suppose you have 10 images of a damper. Image 1 shows the damper closed, and each subsequent image shows the damper open in increments of roughly 10 degrees; the last image shows the damper fully open. If you assign Image 1 a value of 10, the image of the closed damper will display whenever the point is commanded to a value from 0 to 10. Image 2 shows the damper slightly open. If you assign Image 2 a value of 20, Image 2 will display whenever the point is commanded to 10.1 to 20, and so on. 115

116 7 4. To create continuous movement, such as a fan turning, tap the Loop switch at the bottom of the dialog box to enable it. A Time column appears between the Value and Image columns. The Time column indicates the duration of the loop; that is, the amount of time it takes to cycle through all the images in the series. In the Time column, for each value enter the cycle time in seconds. Enter -1 next to the value that indicates the equipment is stopped (typically value = 0). Larger time increments will produce slower animation, as shown in the table below: Value Time Image 0-1 Fan0 When the value is 0, the fan is stopped Fan1 With Time = -1, only the first image is displayed Fan2 When the value is 40, the fan is rotating 40 2 Fan3 at a moderate speed. With Time = 2, it 50 2 Fan4 takes 2 seconds to display all the 60 1 Fan5 images in the series Fan6 When the value is 100, the fan is Fan7 rotating quickly. With Time = 0.1, it Fan8 takes 0.1 seconds to display all the images in the series Fan9 5. Tap Save. 6. Tap. 7. Test the animation by turning off Edit Mode and selecting the graphic from the Menu to reload it. To configure the animation for a binary point: 1. Tap. The Value/Image Assignments dialog box appears. 2. Tap the Image Path #1 box, select the off or closed image from the list, and then tap Save. 3. Tap the Use Auto Fill Copy switch to enable it. 4. Tap the Image Path #2 box, select the on or open image from the list, and then tap Save. The remaining Image Path boxes are filled with the on or open image filename. 5. In the first column, enter a value of 0 for the off or closed image and a value of 1 is for the on or open image. You do not need to fill in values for the remaining rows. 116

117 7 Example 1: Rotation of a space 6. Tap Save. 7. Tap. 8. Test the animation by turning off Edit Mode and selecting the graphic from the Menu to reload it. Rotation View The Rotation View element enables you to create a graphic that can be rotated to display a 360 view of a space. It also enables a central image to be rotated 360. This is accomplished by dividing the graphic into eight frames. When you swipe to the left or right, the graphic appears to rotate as the next or previous frame is revealed. Other elements can be placed on the graphic and can be configured to remain in view while the graphic is rotated or to remain fixed to a particular frame and rotate out of view. Frame 0 Frame 1 Frame 2 Frame 3 Frame 4 Frame 5 Frame 6 Frame 7 117

118 7 Example 2: Rotation of a central image Frame 0 Frame 1 Frame 2 Frame 3 Frame 4 Frame 5 Frame 6 Frame 7 Images used in the Rotation View can be image files (in.png or.jpg format) or the images can be taken directly with the ipad camera within the element configuration. To configure this element using image files: 1. Tap and then tap File. A list of available image files appears. 2. Scroll the list to select the first image in the series (the image with the file naming ending in 0). Tap Select. 3. Tap and then tap Auto Scale Image to Full Screen. This turns on scaling and locks the images, which sends the images to the background and prevents them from being moved. Reload the graphic by selecting it from the Menu. 118

119 7 To configure this element using the ipad camera: 1. Tap and then tap Camera. The Rotation View Image Map dialog box appears. 2. In the Name box, type a name for the image series. Each image in the series will be saved with a file name that begins with this name and ends with a number (0 through 7). 3. Take a photo of each wall and corner of the room by pointing the ipad at the space and then tapping the corresponding square on the image map shown below. Note that the photo in position 0 will become the first photo that loads when the graphic is displayed. 0 = Front wall image 1 = Corner image 2 = Right side image 3 = Corner image 4 = Back wall image 5 = Corner image 6 = Left side image 7 = Corner image 4. When you have taken all eight photos, tap Done to save the images. 5. Tap and then tap Auto Scale Image to Full Screen. This turns on scaling and locks the images, which sends the images to the background and prevents them from being moved. Reload the graphic by selecting it from the Menu. To add other elements to the graphic: 1. Rotate the graphic so the frame to which you want to add an element is in view. To rotate the graphic, swipe your finger to the left or right. 2. Select the element you want to add from the Graphic Container Editor. 3. Move the element to the desired location on the graphic. 119

120 7 4. Tap on the element to configure it. The Rotation View button ( ) appears in the element configuration space. Rotation View button 5. Tap. The rotation assignment dialog box appears. 6. The rotation assignment dialog box shows the position (x,y coordinates) of the element in each of the eight frames of the Rotation View graphic. The topmost set of coordinates represents the frame that is currently displayed. 7. Position the element in each of the eight frames as follows: To hide the element on a frame, tap the Show button to disable it. (By default, all Show buttons are enabled.) To copy the coordinates of the current frame to another frame, tap the arrow (<---) under the Current column. To change the position of the element on a frame, do one of the following: Type new coordinates in the X and Y boxes. Manually position the element by dragging it to the desired position on each frame. 120

121 7 8. When you are finished setting coordinates in the rotation assignment dialog box, tap Store. To close the rotation assignment dialog box, tap anywhere outside of the dialog box. Text Use the Text element when you want to add static text to a graphic. To configure this element: 1. In the Enter Text dialog box, type the text you want to appear on the graphic and then tap OK. Note: To edit the text, tap. 2. Tap. The formatting dialog box appears. 3. Using the left-hand list, scroll to select the font. 4. Using the center list, scroll to select the color. 5. Using the right-hand list, scroll to select the vertical position of the text. 6. In the Font Size box, type the text size, or use the buttons to select a size. 7. Select the text style by tapping the corresponding switches to enable them. You can choose any combination of the following styles: bold, italic, 3D, or Arc. If you enable the Arc switch, set the arc size (radius) by typing a number 50 or greater in the Arc Size box, or use the buttons to select the arc. 8. Select the horizontal text position by tapping either L, C, or R. 9. When you finished configuring the element, tap outside of the formatting dialog box. 121

122 7 Graphs Facility Prime provides several graph elements for visualizing operating data. Most are designed around the mobile person with the ipad open for a short duration. Graphs displaying dynamic data, such as the Analytic Graph, Dynamic Plotter, and Line Graph, can hold up to 140 samples of data at a 5 second poll rate (about 10 minutes total). The graphs poll for data while the graphic is open. When the graphic is closed, the data is removed; it is not stored. Reopening the graphic restarts the polling process. Graphs such as the Bar Graph and Pie Graph show the current value of the points. The Trend Plotter is the only graph that displays trend data from a trend file in the field panel. The table below describes the graph elements and provides examples of how each graph could be used. Graph Description Example Analytic Graph Bar Graph Charts Line graph for displaying data for up to five points. Can also display static reference lines for comparison purposes. Displays the current value of multiple points as vertical bars. Scatter (line), bar, or pie chart that appears on the Charts tab. You can use the Analytic Graph to display data samples for outdoor air temperature, supply air temperature setpoint, supply air temperature, return air temperature, and average zone temperature setpoint to verify proper operation of the airhandling unit. You can also add reference lines to show the upper and lower limits. You can use the Bar Graph to compare demand measurement (kw) of multiple chillers. You can use the Charts element to display energy consumption of each major building subsystem (boiler, chiller, fan, pump, AHU, lighting, and so on) on a single pie chart. Continued on next page 122

123 7 Graph Description Example Dynamic Plotter, Trend Plotter Line Graph Pie Graph Sample Graph The Dynamic Plotter displays a dynamic graph of one or two points. The Trend Plotter displays a graph of trend log files for two points in a field panel. Displays a line graph showing trend data for up to five points. Pie chart for showing the relationship of parts to a whole. Displays a trend graph of data from a.csv file located on a network outside of the BAS. You can use the Dynamic Plotter to plot the actual room temperature and room temperature setpoint. You can use the Trend Plotter to plot BACnet trend log objects or P2 field panel trend files. You can use the Line Graph to display trend data of outdoor air temperature, supply air temperature setpoint, supply air temperature, return air temperature, and average zone temperature setpoint to verify proper operation of the airhandling unit. You can use the Pie Graph to display energy consumption of each major building subsystem (boiler, chiller, fan, pump, AHU, lighting, and so on) on a single pie chart. You can use the Sample Graph to display the trend.csv file of energy consumption data that was trended and exported to the.csv file. 123

124 7 Analytic Graph represented on the graph as follows: Use this element to create a line graph for displaying dynamic data for up to five points. In addition to displaying point data, the Analytic Graph can include up to four horizontal reference lines to aid in interpreting the data. For example, you could add a line representing average temperature so you can compare actual temperatures against the average. The x (horizontal) axis represents number of samples while the y (vertical) axis represents value. The points are Point 1 = Red Point 2 = Light blue Point 3 = Green Point 4 = Yellow Point 5 = Purple To link points to the graph: 1. Tap and then tap. The Point Selector appears. 2. In the Label box, type a name for the point. (The name will appear at the bottom of the Point Selector when you add the point to the list.) 3. Tap the network type. 4. Add the point details by doing one of the following: Tap Auto to select the point from the BACnet Browser or P2 Browser. For more information about browsers, see Using the BACnet Browser on page 30, or Using the Siemens P2 Browser on page 37. Manually enter the point details. 5. Tap Add to add the point to the list. 6. To add additional points, tap the + to increment the counter, then repeat Steps 2 through 5. Note that the first point added to the graph is Tap Done and then tap. 124

125 7 To configure the x and y axes: 1. Tap. The axis configuration dialog box appears. 2. Set the range for the x (horizontal) axis by entering values in the Xmin and Xmax boxes. Set the number of tick marks on the x-axis by entering a value in the Xticks box. Repeat for the y (vertical) axis by entering values in the Ymin, Ymax, and Yticks boxes. 3. Tap Save and then tap. To add reference lines to the graph: 1. Tap Eqn Data. The equation data dialog box appears. 2. In the Equation #1 box, enter an equation to configure the line. The format for entering equations is as follows: Equation Format Example Line Average Minimum Maximum value,color,thickness Where: value = placement of line of the vertical axis color = line color (HTML5 colors) thickness = point size of the line ~avg,in1,in2,in3~,color,thickness Where: in = the index numbers of the points linked to the element color = line color (HTML5 colors) thickness = point size of the line ~min,pt1,pt2,pt3~,color,thickness Where: in = the index numbers of the points linked to the element color = line color (HTML5 colors) thickness = point size of the line ~max,pt1,pt2,pt3~,color,thickness Where: in = the index numbers of the points linked to the element color = line color (HTML5 colors) thickness = point size of the line 65,blue,2 This equation places a 2 pt blue line at the 65 mark on the vertical axis ~avg,0,1,2~,blue,2 This equation averages the values of the three points and places a 2 pt blue line at that value on the vertical axis ~min,0,1,2~,blue,2 This equation finds the minimum value of the three points and places a 2 pt blue line at that value on the vertical axis ~max,0,1,2~,blue,2 This equation finds the maximum value of the three points and places a 2 pt blue line at that value on the vertical axis Continued on next page 125

126 7 Equation Format Example Math functions Math.abs(a) the absolute value of a 75+2*Math.sin(x),blue,12 This equation creates a Math.acos(a) arc cosine of a sine wave using a 12 pt Math.asin(a) arc sine of a blue line Math.atan(a) arc tangent of a Math.ceil(a) integer closest to a and not less than a Math.cos(a) cosine of a Math.exp(a) exponent of a Math.floor(a) integer closest to a, not greater than a Math.log(a) log of a base e Math.max(a,b) the maximum of a and b Math.min(a,b) the minimum of a and b Math.random() pseudorandom number 0 to 1 Math.round(a) integer closest to a Math.sin(a) sine of a Math.sqrt(a) square root of a Math.tan(a) tangent of a 3. Repeat Step 2 for up to three additional equations. 4. Tap Save and then tap. If the graph does not appear, recheck the equation syntax. To edit point labels: 1. Tap and then tap. The Point Selector appears. 2. Scroll the point list to the point label you want to change. 3. In the Label box, type the new label. 4. Tap Add. A message appears asking if you want to replace the point label. 5. Tap Replace. 126

127 7 6. Tap Done and then tap. 7. Tap. Bar Graph Use the Bar Graph to display the current values of multiple points. You can display the values as a single set of bars or as points on a single line. You can also show two sets of data on the same graph and display the values as two lines or as a set of bars and a line. To format the graph: 1. Tap. 2. In the boxes below the, enter the maximum value and the increment for the scale on the y (vertical) axis. 3. If you are creating a line chart, tap the Line switch to enable it. If you are creating a bar chart, leave the Line switch disabled. 4. If you are creating a comparison chart with two sets of data, do one of the following: To display all data sets as bars, leave both the Line and Comparison switches disabled. To display one data set as bars and the other as points on a line, tap the Comparison switch to enable it. To display each data set as points on separate lines, tap the Comparison switch to enable it and also tap the Line switch to enable it. 5. If you want to turn off the vertical and horizontal axis lines, tap the Axis switch to disable the lines. 6. If you want to remove the shadows from the bars and line, tap the Shadow switch to disable it. 7. To set the color of the bars and of the comparison line, tap. Scroll the list on the left to select the color of the bars (note that all bars will be the same color). Scroll the list on the right to select the color of the line. Tap Done. 127

128 7 To link points to the graph: NOTE: If you are making a comparison chart, the first half of the points you enter will be the first data set and the second half of the points will be the second data set. If you have an odd number of points, the odd point will be in the second data set. 1. Tap. The Point Selector appears. 2. In the Label box, type a name for the point. This name that will appear on the graph, and it can be a different name than the one in the BAS. 3. Tap the network type. 4. Add the point details by doing one of the following: Tap Auto to select the point from the BACnet Browser or P2 Browser. For more information about browsers, see Using the BACnet Browser on page 30 or Using the Siemens P2 Browser on page 37. Manually enter the point details. 5. Tap Add to add the point to the list. 6. To add additional points, tap the + to increment the counter, then repeat Steps 2 through Tap Done and then tap. 8. Tap. To edit point labels: 1. Tap and then tap. The Point Selector appears. 2. Scroll the point list to the point label you want to change. 3. In the Label box, type the new label. 4. Tap Add. A message appears asking if you want to replace the point label. 5. Tap Replace. 6. Tap Done and then tap. 7. Tap. 128

129 7 Charts Use this element to create a scatter (line), bar, or pie chart that you want to appear on the Charts tab. You create the chart in a graphic container as you would other graphics, but when you turn off Edit Mode, the chart is not visible on the graphic; instead, the chart appears in the Charts tab. To configure this element: 1. Tap. 2. In the Chart Title box, type a title for the chart. 3. In the box below the Chart Title box, type a number for this chart. The chart number determines the order in which the chart appears on the Charts tab. 4. Tap the type of chart you want to create (Scatter, Bar, or Pie). 5. Do one of the following: To display real-time values in your chart, tap Dynamic. To display data from a trend file in the BAS, tap Trend. To link points to the chart: 1. Tap. The Point Selector appears. 2. In the Label box, type a name for the point. This name will appear on the chart. 3. Tap the network type. 4. Add the point details by doing one of the following: Tap Auto to select the point from the BACnet Browser or P2 Browser. For more information about browsers, see Using the BACnet Browser on page 30, or Using the Siemens P2 Browser on page 37. If you are displaying trend data, tap Trend-Log points. Manually enter the point details. 5. Tap Add to add the point to the list. 6. To add additional points, tap the + to increment the counter, then repeat Steps 2 through Tap Done and then tap. 8. Tap. To format the chart: See Using the Charts Tab on page 25 for formatting instructions. 129

130 7 Dynamic Plotter, Trend Plotter Use the Dynamic Plotter to display a dynamic graph of one or two points. Use the Trend Plotter to display a graph of trend log files for two points in a field panel. 1. Tap. To link points to the element: 2. Tap Monitor to link the first point or trend log file. (You can select any point in the system to trend; it need not be a monitor point.) 3. Tap the network type. 4. Do one of the following: If the network type is: BACnet or P2 BACnet And you are linking the point by: Using the browser to select the point Manually entering the point details Then follow these steps: a. Tap. The browser appears. b. Tap the field panel containing the point you want to link. A listing of points in that field panel appears. c. Tap the point you want to link. a. In the Object Type box, tap to clear the box, tap the desired Object Type from the list, and then tap Save. b. In the Object Instance# box, tap to clear the box and then type an Object Instance number in the box. c. In the Property Identifier box, tap to clear the box, tap the desired Property Identifier from the list, and then tap Save. Continued on next page 130

131 7 If the network type is: P2 5. Tap. And you are linking the point by: Manually entering the point details Then follow these steps: d. In the IP Address box, tap to clear the box and then type an IP Address in the box. Enter the following data in the boxes: P2 Point Name P2 BLN Name P2 Panel Name P2 IP Address 6. (Optional) Tap Set Point to link the second point. (You can select any point in the system to trend; it need not be a setpoint.) Repeat Steps 3 through Tap. To format the element: See Dynamic Plotter, Trend Plotter on page 142 in Appendix B for instructions on how to format this element. Line Graph Use this element to create a line graph for displaying dynamic data for up to five points. The points are represented on the Line Graph as follows: Point 1 = Blue Point 2 = Red Point 3 = Green Point 4 = Light blue Point 5 = Pink The Line Graph is similar to the Analytic Graph except that the Analytic Graph can also display static reference lines. See Analytic Graph on page 124 for more information about the Analytic Graph. To format the graph: 1. Tap. 2. In the Max Value box, enter the maximum value for the scale on the y (vertical) axis. 131

132 7 3. In the Min Value box, enter the minimum value for the scale on the y (vertical) axis. To link points to the graph: 1. Tap. The Point Selector appears. 2. In the Label box, type a name for the point. (The name will appear at the bottom of the Point Selector when you add the point to the list.) 3. Tap the network type. 4. Add the point details by doing one of the following: Tap Auto to select the point from the BACnet Browser or P2 Browser. For more information about the browsers, see Using the BACnet Browser on page 30, or Using the Siemens P2 Browser on page 37. Manually enter the point details. 5. Tap Add to add the point to the list. 6. To add additional points, tap the + to increment the counter, then repeat Steps 2 through Tap Done and then tap. 8. When you are finished configuring the element, tap. Pie Graph Use the Pie Graph element to show the relationship of parts to a whole, such as energy consumption by submeter. To determine the size of each segment, Facility Prime totals the values of all points in the graph and then calculates the percentage of the total represented by each point. To link points to the graph: 1. Tap and then tap. The Point Selector appears. 2. In the Label box, type a name for the point. This name will appear on the graph, and it can be a different name than the one in the BAS. 3. Tap the network type. 132

133 7 4. Add the point details by doing one of the following: Tap Auto to select the point from the BACnet Browser or P2 Browser. For more information about the browsers, see Using the BACnet Browser on page 30, or Using the Siemens P2 Browser on page 37. Manually enter the point details. 5. Tap Add to add the point to the list. 6. To add additional points, tap the + to increment the counter, then repeat Steps 2 through Tap Done and then tap. 8. When you are finished configuring the element, tap. Sample Graph Use the Sample Graph element to create a trend graph of data from a.csv file located on a network outside of the BAS. For example, you could export trend data in.csv format from the Siemens Insight workstation and post the file to a server. By providing the path to the server, you can configure the Sample Graph element to retrieve the data and display it as a trend graph on a graphic. To configure this element: 1. Tap. 2. In the Path box, enter the path to the.csv file. 3. Tap and then tap. Special Use Elements CCTV FTP site. Use the CCTV element to display a photo in.jpg format from an IP-based camera on the same network as the ipad. The CCTV element can display photos only from cameras using the FTP protocol. The CCTV element polls the camera every 5 seconds and displays the latest image. In addition to displaying images from a CCTV camera, the CCTV element can also display images and documents from an To configure this element: 1. In the Path box, type the path to the file using this format: ftp://[ipaddress]/[filename] 133

134 7 If a username and password are required for the FTP site, use the following format: ftp://[username]:[password]@[ipaddress]/[folder]/[filename] 2. Tap. Location The Location element works with the Facility Prime Code Scanner to display a graphic and pinpoint a location on that graphic. When you configure the Location element, Facility Prime Editor assigns a numeric value to each location on the graphic (defined by x,y coordinates) you want to track. Each value is then encoded in a QR code, along with the name of the graphic. When a user scans the QR code, the graphic is displayed, and the Location element appears on the graphic at the x,y coordinates associated with the value encoded in the QR code. You can also link a BACnet virtual point to the Location element so that the value encoded in the QR code is written to the virtual point when the code is scanned. Using PPCL, the value in the virtual point can be used to trigger BAS functions, such as turning on lights or changing setpoints. The virtual point can also be trended to produce a historical record of the QR codes scanned. Following are examples of how the Location element might be used. Example 1: A maintenance technician scans a QR code posted outside a room to view a floor plan graphic showing the location of the room in relation to other areas of importance to the technician, such as the electrical closet, water main shut-off, and so on. Example 2: A maintenance technician scans a QR code posted on HVAC equipment to view a graphic showing the spaces controlled by the equipment. Example 3: A maintenance technician scans a QR code printed on a work order to view a graphic showing the equipment that needs to be serviced. To configure this element: 1. Move the Location element on the background image to the first position you want to track. 2. Tap and then tap. The Location GUI Editor appears. 3. In the New Location Value box, type a value that will represent this location. For example, if the location is Room 244, you could use 244 as the value. 4. Tap Add. The value appears in the list, along with the x,y coordinates of the Location element on the background image. 5. Tap outside of the Location GUI Editor to close it. 6. Tap. 134

135 7 7. Repeat Steps 1 through 6 for each additional location you want to track. 8. Create QR codes using the graphic name and the values you entered for the Location element. Post the QR codes where needed, such as outside of rooms or on equipment. To link the virtual point to this element (BACnet only): 1. Tap. 2. Do one of the following: If you are linking the point by: Using the browser to select the point Manually entering the point details Then follow these steps: a. Tap. The browser appears. b. Tap the field panel containing the point you want to link. A listing of points in that field panel appears. c. Tap the point you want to link. a. In the Object Type box, tap to clear the box, select the desired Object Type from the list, and then tap Save. b. In the Object Instance# box, tap to clear the box and then type an Object Instance number in the box. c. In the Property Identifier box, tap to clear the box, select the desired Property Identifier from the list, and then tap Save. d. In the IP Address box, tap to clear the box and then type an IP Address in the box. 3. Tap and then tap. SVG Use the SVG element to insert a.svg format background image into your graphic. See Adding Background Images on page 70 for instructions. 135

136 A Appendix A: APOGEE BAS and ipad Settings This appendix provides instructions for configuring the ipad to enable communications for the Facility Prime application. In addition to this appendix, also see Connecting to the BAS on page 15. Add the ipad to the APOGEE Network To add the ipad to the APOGEE network: 1. Verify that Wi-Fi communications is available on the APOGEE network. 2. For Siemens P2 networks, assign a panel name to the ipad and add it as a node on the P2 network. It is recommended that each ipad have a unique panel name. 3. To use the Command functions in Facility Prime or the Command and Edit functions in Facility Prime Editor, set up or obtain credentials for a BLN account with at least Command access rights (for commanding) or Edit access rights (for editing in Facility Prime Editor). Configure Facility Prime/Facility Prime Editor Settings on the ipad To configure Facility Prime/Facility Prime Editor settings on the ipad: 1. On the ipad, tap Settings. The ipad Settings dialog box appears. 2. In the left pane, scroll to the bottom and tap Facility Prime. The Facility Prime settings appear in the right pane. 3. Configure the settings according to the instructions in the table below. Area Setting Description INFORMATION Version This area shows the application version and build. Build PORTRAIT PANNING Portrait Panning When enabled, allows you to move the graphic with your finger when the ipad is in portrait orientation. The default state is disabled. WALL MOUNT USE Wall Mount Use Enable this switch if the ipad will be wall-mounted. Default to QR Login Enable this switch to configure Facility Prime to automatically show the QR code scanner on the User Account Verification dialog box. Continued on next page 136

137 A Area Setting Description ALARMS Visual Alarm Indications When enabled, the following happens when a point is in alarm: The navigation bar on the Graphics tab turns red when a point on the displayed graphic is in alarm. The Graphics tab icon displays the number of alarms on the active graphic. The bar above a point in List View turns from green to red. COMMUNICATIONS BACnet Device Instance # Enter the device instance number you assigned to the ipad. The default device instance number is 222. BACnet Port # BACnet uses an IP port number for communications. Port number is the standard port, but any port may be used. The port number setting in the ipad must match the port number in the field panel. Contact IT for help. Siemens P2 Panel Name Enter the panel name you assigned to the ipad. The default name is ipadpanel. Who-Is Low Range For BACnet networks, enter the default minimum device number to search when using the Who-Is discovery feature. Who-Is High Range For BACnet networks, enter the default maximum device number to search when using the Who-Is discovery feature. USER PREFERENCES Who-Is Network #: 0=Broadcast ReadPropertyMultiple Service Theme Sound After Login Show Fine Edit after Adjustment Fine Edit Hide Time For BACnet networks, enter the default network number to search when using the Who-Is discover feature. Entering zero (0) searches on all networks. When enabled, allows BACnet field panels to use the ReadPropertyMultiple service to read multiple points simultaneously. Newer BACnet panels support this service. If the network has legacy BACnet field panels that do not support this service, disable this switch. When disabled, some Facility Prime features are limited, such as the Point Label report feature. Tap the switch to enable an audible indication of successful login. (Editor only) Enables or disables the location/size dialog box that appears when you move an element on a page. (Editor only) The time in seconds that the location/size dialog box remains visible before hiding. Continued on next page 137

138 A Area Setting Description SLEEP MODE Keep Device Awake Tap the switch to enable this feature if you want to prevent the ipad from going to sleep while Facility Prime is active. USER AUTO LOGOUT GRAPHIC IMPORT / EXPORT FORMAT TEMPERATURE GROUP ELEMENT BACNET COMMAND DEFAULT PRIORITY SIEMENS P2 COMMAND DEFAULT PRIORITY HIERARCHY VIEW LICENSE & ATTRIBUTIONS Auto Logout Auto Logout Duration (min) Use XML Graphic Format Maximum Stpt Value Minimum Stpt Value BACnet Default Priority Hide BACnet Priority Selector P2 Default Priority Hide P2 Priority Selector Hierarchy Tree as Force Diagram License ReadMeOSS Tap the switch to enable this feature if you want Facility Prime to automatically log out the user after a specified number of minutes of inactivity. If you enabled Auto Logout, enter the number of minutes of inactivity after which Facility Prime will log out the user. Tap the switch to enable this feature if you want to import and export graphics in XML format. Enter the default maximum setpoint value for Temperature Group elements. Enter the default minimum setpoint value for Temperature Group elements. Sets the default BACnet command priority for all commandable elements. Users can select a different priority in the element if desired. Hides the Priority Edit switch in all commandable elements so that users cannot select a command priority when issuing commands. Sets the default Siemens P2 command priority for all commandable elements. Users can select a different priority in the element if desired. Hides the Priority Edit switch in all commandable elements so that users cannot select a command priority when issuing commands. When enabled, displays the Node Builder hierarchy as a hub-and-spoke diagram that can be stretched to reveal the subnodes. The default state is disabled, which displays the hierarchy as a tree diagram. Tap to view the end user license agreement. Tap to view the ReadMe file that includes credits for the licensing agreement. 138

139 B Appendix B: Element Quick Reference Following are descriptions of Facility Prime graphic elements and instructions for changing values and settings for elements that provide these capabilities. 3LvlLightCntrl (three-level light control) The 3LvlLightCntrl element is used for monitoring and commanding lighting in critical environments such as a laboratory and vivarium. The 3LvlLightCntrl element provides monitoring and commanding of three lights: red, day, and clean. To command this element: 1. Tap the title text. The Light Commander appears. 2. Tap the Command Mode switch to enable it. Three switches appear, one under each of the three lights. 3. Tap a light switch to turn a light on or off. 4. Tap Return to return to the graphic. ACH The ACH Element provides graphical view and control for airflow (air changes per hour) in critical environments. The value in the center of the element is the current value. You can change the setpoint, low alarm limit, and high alarm limit. To command this element: 1. Tap the element. The command dialog box appears. 2. Enter values in the Low Limit, Set Point, and/or High Limit boxes either by typing directly in the boxes or by scrolling to select the values. 3. Tap Save

140 B Analog Commander The Analog Commander appears as text on a graphic. It enables you to command an associated analog point, such as a temperature or humidity setpoint, valve or damper position, or fan speed. To command this element: 1. Tap the title text. The Analog Point Commander dialog box appears. 2. (Optional) If the element has a Priority Edit switch and you want to issue the command at a command priority level, tap Priority Edit and scroll the list to select the priority. 3. (Optional) In the Min Value and Max Value boxes, type the low and high alarm limits, respectively. 4. In the Point Value box, type or use the slider to enter the value to which you want to command the point. 5. Tap Command. The Confirm Command dialog box appears. 6. Tap Confirm to issue the command. If the command is accepted, a appears briefly over the element on the graphic. Analog Display The Analog Display element displays the value of an analog point and enables you to command the point to a new value using the + and - buttons. NOTE: Commanding may not be enabled on some Analog Display elements. To command this element: Tap the + and buttons to increase or decrease the value. Analytic Graph The Analytic Graph is a line graph that displays trend data for up to five points. In addition to displaying point data, the Analytic Graph may include up to four horizontal reference lines to aid in interpreting the data. The x (horizontal) axis represents number of samples while the y (vertical) axis represents value. 140

141 B Bar Graph The Bar Graph displays the current values of multiple points. It may display the values as a single set of bars or as points on a single line. Or, it may show two sets of data on the same graph and display the values as two lines or as a set of bars and a line. NOTE: The colors and styles of the graph shown here may differ from those shown on your graphics. Binary Commander The Binary Commander appears as text on a graphic. It enables you to command an associated binary point, such as a light, two-speed fan, or door lock. To command this element: 1. Tap the title text. The Binary Point Commander dialog box appears. 2. (Optional) If the element has a Priority Edit switch and you want to issue the command at a command priority level, tap Priority Edit and scroll the list to select the priority. 3. In the Point Value selector, tap Off or On. 4. Tap Command. The Confirm Command dialog box appears. 5. Tap Confirm to issue the command. If the command is accepted, a appears briefly over the element on the graphic. Circular Gauge The Circular Gauge provides a visual indication of normal operating range, alarm limits, setpoint, and current value. Two styles of the gauge are available: Classic (above left) and Modern (above right). Classic style On the Classic style gauge, the green area indicates the normal range; the alarm range is shown in red. The blue needle shows the current value, as do the numerals in the center of the gauge. The green needle indicates the setpoint, if one is configured. Modern style On the Modern style gauge, only the minimum and maximum values of the scale are shown. The green area of the outer band indicates the normal range; the alarm range is shown in red. The thicker blue-green band indicates the current value of the monitor point, as do the large numerals in the center of the gauge. The innermost gray band indicates the value of the setpoint, as do the smaller numerals in the center of the gauge. 141

142 B To command this element: 1. Tap the element. The command dialog box appears. 2. In the Set Point box, enter the value to which you want to command the setpoint. 3. Tap Next. A message appears asking if you want to transmit values. 4. Tap Transmit to command the point; tap Cancel if you do not want to command the point. Display Button Display Buttons can be text or icons that resemble push buttons. Tapping the button toggles on or off a binary point or selects a scene, which may trigger adjustments to temperature, ventilation, and lighting. Dynamic Plotter, Trend Plotter The Dynamic Plotter displays a dynamic graph of one or two points. The Trend Plotter displays a graph of trend log files for two points in a field panel. You can change the formatting of the plot, such as line styles and colors. You can also pause and restart the plot and pan and zoom within the plot area to examine the data in greater detail. To format the plot: 1. Tap. The format dialog box appears. 2. Tap the plot you want to format. (Tap Series #1 for the first point or Series #2 for the second point.) 3. Adjust the line thickness by moving the Line Width slider. 4. Change the line color by scrolling the list to select the color you want to represent the point data. 5. Select the line style for the point data (Solid, Dotted, or Dashed). 6. Tap the Gradient switch to enable or disable the gradient. 7. To change the format of the axes, tap the Advanced switch and then tap the buttons to configure the axes as follows: Y-Axis Start: Sets the starting value of the Y (vertical) axis. Y-Axis Range: Sets the range for the Y-axis. This will determine the upper limit for the scale. For example, if the Y-axis Start is -5 and the range is 105, then the upper limit for the Y-axis will be 100. Y-Interval: Sets the interval for the scale on the Y-axis. For example, if the Y-Interval is set to 5, then the scale will show 0, 5, 10, 15, and so on. 142

143 B Y-Ticks/Interval: Sets the number of tick marks that appear between the intervals. X-Interval: Sets the interval for the scale on the X-axis. For example, if the X-Interval is set to 50, then the scale will show 50, 100, 150, and so on. X-Ticks/Interval: Sets the number of tick marks that appear between the intervals. 8. Tap Save.0. To pause and restart the plot: Tap the button at the top left of the plot area. To pan the view within the plot area: Touch the plot and move it to the right or left. To zoom in and out of the plot area: Pinch or stretch the plot area with your fingers. FLN Device The FLN Device element represents a Siemens FLN device. When you tap the FLN Device element, a secondary graphic appears representing the application in the device. To dismiss the secondary graphic, tap. NOTE: You must wait for communication between the network and Facility Prime to be established before the FLN graphic will appear in the secondary window. When communication is established, the values on the graphic will update. Gradient Indicator The Gradient Indicator element is a segmented vertical bar that indicates by color a point s condition: normal (green), warning (yellow), or danger (red). 143

144 B Group Temperature, Humidity, Ventilation, Lights, Air Quality, and Blinds Group elements display the setpoint and current value of a point along with a slider for setpoint adjustment. There are separate Group elements for temperature, humidity, ventilation, lights, air quality, and blinds. Each Group element links to up to three points: one for monitoring the current value, one for commanding the setpoint, and a third auxiliary point that is linked to an on/off button ( ), which appears between the + and buttons on the element (the button may not be present). A Group Temperature element may display a selector switch for choosing the preferred units (degrees Fahrenheit or degrees Celcius). The switch appears when you tap the + or button to adjust the setpoint and then disappears. Group elements can be linked to Display Buttons so that when a Display Button is tapped, the Group element is set to a new value. To command Group elements: Tap the + and buttons to increase or decrease the value. If the present, tap it to toggle the associated point on or off. button is Line Graph The Line Graph element is a line graph displaying dynamic data for up to five points. Location The Location Element works with the Facility Prime Code Scanner to display a graphic and pinpoint a location on that graphic when you scan a QR code. 144

145 B Mini Temperature, Humidity, CO2, Pressure, and Lights These small elements provide visual indication of current value and the ability to command the setpoint. The value below the element is the current value. To command this element: 1. Tap the element. The command dialog box appears. 2. Enter values in the Low Limit, Set Point, and/or High Limit boxes either by typing directly in the boxes or by scrolling to select the values. 3. Tap Save.0. Pie Graph The Pie Graph element shows the relationship of parts to a whole, such as energy consumption by submeter. To determine the size of each segment, Facility Prime totals the values of all points in the graph and then calculates the percentage of the total represented by each point. Point Label The Point Label appears as text on a graphic. It typically displays the name and current value of a point, but may display any combination of the following properties: point name, description, value, units, status, state text, and priority. You can view a dynamic plot of the point s value, view point properties, and command the point to a new value. Note: Commanding may not be enabled on some Point Label elements. To view a dynamic plot of the point s value: Tap the title text and then tap Plot. The plot appears and begins displaying values. To view point properties: Tap the title text and then tap Report. The properties of the point appear. Scroll to see all of the properties. To command the point: 1. Tap the title text and then tap Command. The Analog Point Commander or Binary Point Commander dialog box appears. 145

146 B 2. Do one the following: Analog Points 1. (Optional) If the element has a Priority Edit switch and you want to issue the command at a command priority level, tap Priority Edit and scroll the list to select the priority. 2. (Optional) In the Min Value and Max Value boxes, type the low and high alarm limits, respectively. 3. In the Point Value box, type or use the slider to enter the value to which you want to command the point. 4. Tap Command. The Confirm Command dialog box appears. 5. Tap Confirm to issue the command. If the command is accepted, a appears briefly over the element on the graphic. Binary Points 1. (Optional) If the element has a Priority Edit switch and you want to issue the command at a command priority level, tap Priority Edit and scroll the list to select the priority. 2. In the Point Value selector, tap Off or On. 3. Tap Command. The Confirm Command dialog box appears. 4. Tap Confirm to issue the command. If the command is accepted, a appears briefly over the element on the graphic. Point Table The Point Table element is an array of up to five points that displays the status (green for normal and red for alarm), current value, setpoint, and the difference between the current value and setpoint (Delta) for each point. 146

147 B Pressure Ball The Pressure Ball element displays the current value of a room air pressure point and a visual indication of the state of pressurization (positive or negative). The arrows and the value in the lower left corner of the element indicate the current condition of the room. Arrows pointing inward indicate negative pressure; arrows pointing outward indicate positive pressure. The setpoint is indicated by a + or in the center ball. Due to differences in BACnet and Siemens P2 points, alarms in the Pressure Ball element are determined in different ways. For BACnet points, the current value is compared to the point s high and low alarm limits. If the current value is greater than the high alarm limit or less than the low alarm limit, the Pressure Ball displays an alarm condition. If the setpoint is negative, then the Pressure Ball displays a negative room alarm; if the setpoint is positive, the Pressure Ball displays a positive room alarm. For Siemens P2 points, there are no high and low alarm limits. Alarm conditions are determined by comparing the setpoint to the point s current value. The Pressure Ball indicates alarms for Siemens P2 points as follows: If the setpoint is: And the current value is: Then the alarm is: negative negative negative normal negative positive negative alarm positive positive positive normal positive negative positive alarm Note that you must have the Visual Alarm Indications switch enabled in ipad Settings for the Facility Prime application in order for alarms to display in Facility Prime graphics. To command this element: 1. Tap the Pressure Ball element. The command dialog box appears. 2. Enter values in the Low Limit, Set Point, and/or High Limit boxes either by typing directly in the boxes or by scrolling to select the values. 3. Tap Save

148 B Sample Graph The Sample Graph element is a trend graph of data from a.csv file located on a network outside of the BAS. The trend graph is divided into two views, an upper view and a lower view. The lower view shows all the trend samples in the file. When you tap an area on the lower view, the upper view zooms in to show the detail of the area you selected. Sample Graph showing all samples in upper and lower view Sample graph showing detail of selected area in upper view Space Sensor The Space Sensor element is a graphical representation of a wall sensor. The large numerals on the display of the sensor show the current value of the temperature point; the smaller numerals show the setpoint. The blue button on the Space Sensor may be linked to a binary point, such as a light or occupancy switch. Tapping the blue button toggles the state of the binary point (On or Off), which is indicated on the display to the left of the setpoint. A Space Sensor element may display a selector switch for choosing the preferred units (degrees Fahrenheit or degrees Celsius). 148

149 B State Commander The State Commander appears as text on a graphic. It enables you to command BACnet multi-value points or P2 logical enumeration (LENUM) points. These point types have more than one possible state, such as Off, On-Low, On-Medium, On- High and so on. To command this element: 1. Tap the title text. The State Commander dialog box appears. 2. (Optional) If the element has a Priority Edit switch and you want to issue the command at a command priority level, tap Priority Edit and scroll the list to select the priority. 3. Scroll the list of states and select the desired state. 4. Tap Command State. The Confirm Command dialog box appears. 5. Tap Confirm to issue the command. If the command is accepted, a appears briefly over the element on the graphic. Vertical Gauge The Vertical Gauge element provides a visual indication of normal operating range, alarm limits, setpoint, and current value. The green area of the gauge indicates the normal range; the alarm range is shown in red. The blue bar shows the current value, as do the large numerals. The needle indicates the setpoint, if one is configured. To command this element: 1. Tap the element. The command dialog box appears. (You can scroll the command dialog box to see all the values.) 2. In the Set Point box, enter the value to which you want to command the setpoint. 3. Tap Next. A message appears asking if you want to transmit values. 4. Tap Transmit to command the point; tap Cancel if you do not want to command the point. 149

150 B Vertical Indicator The Vertical Indicator element is a vertical bar graph that represents the current value of a single point. 150