BACnet/IP systems Desigo Control Point Engineering A6V11604297_en--_e 2020-04-30 Smart Infrastructure
Edition notice Edition notice Technical specifications and availability subject to change without notice. This document may not be reproduced, disseminated to third parties or processed and its contents may not be used or disclosed without express permission. Non-compliance shall result in compensation for damages. All rights, including those resulting from a successful patent application and registration of a utility model or design patent, are reserved.
Copyright Copyright This document may be duplicated and distributed only with the express permission of Siemens, and may be passed only to authorized persons or companies with the required technical knowledge.
Trademarks Trademarks The trademarks used in this document are listed together with their legal owners in this section. The use of these trademarks is subject to international and national statutory provisions. Desigo® and Desigo® CC™ are registered trademarks of Siemens Schweiz AG. BACnet is a trademark of American National Standard (ANSI/ASHRAE 135-1995). Chrome and the Chrome logo are trademarks of Google LLC. Firefox is a registered trademark of Mozilla Foundation.
Table of Contents 1 About this document ............................................................................................................................. 10 1.1 Scope .......................................................................................................................................................... 10 1.2 Target reader ............................................................................................................................................... 10 1.
4.2.5 Editing a slideshow kiosk ................................................................................................................48 4.2.6 Removing a kiosk ............................................................................................................................51 4.2.7 Logging out of a kiosk .....................................................................................................................51 4.3 Engineering notations .................................
8.10 Special characters do not display in graphic file names ........................................................................... 192 8.11 The color of a graphical component may display incorrectly if the component was copied ..................... 192 Index ............................................................................................................................................................
| 196 A6V11604297_en--_e
Cybersecurity disclaimer Cybersecurity disclaimer Siemens provides a portfolio of products, solutions, systems and services that includes security functions that support the secure operation of plants, systems, machines and networks. In the field of Building Technologies, this includes building automation and control, fire safety, security management as well as physical security systems.
1 About this document Scope 1 About this document 1.1 Scope This manual provides advanced procedures for using Desigo Control Point. It contains the following sections: Commissioning This section outlines topics that are not included in the Desigo Control Point Operation Manual (A6V11211557).
About this document Terms 1 1.3 Terms Term Definition ABT-SSA Setup & Service Application included in Desigo Control Point. Mainly intended for commissioning, service and other more advanced tasks. Also provides a generic data point list to operate all supported BACnet objects and properties of the assigned devices. automation station Primarily controls equipment and plants.
Commissioning 2 Default connection 2 Commissioning NOTICE Changes to the Desigo Control Point device configuration are saved in nonvolatile memory every 30 minutes and whenever you log out of the device. ● ● Save and log out to immediately save changes to the device configuration. Changes to the device configuration are lost if a power cycle occurs within 30 minutes of the change and before you have logged out. 2.
Commissioning 2 Setup wizard 2.3 Setup wizard The Setup wizard displays when you log in to any Desigo Control Point device with the status Unconfigured or Download Required. The Desigo Control Point device restarts at the end of this procedure to save your configuration settings in non-volatile memory. Using the Setup wizard 1. Use the tables in this section to complete the Setup wizard. 2. At the final pane of the Setup wizard, click Save to complete the commissioning.
2 Commissioning Setup wizard Network settings fields Figure 2: Commissioning wizard, Network settings. Setting Description DHCP check box Select to use dynamic IP addressing. Otherwise, complete the IP address, Subnet mask and Router fields to use a fixed IP address. MAC Address (Information only) MAC address of the device. SNMP check box If selected, SNMP monitoring is active. Read community string Community string that allows reading information from a device.
Commissioning 2 Discover and assign devices Application fields Figure 3: Commissioning wizard, Application fields. Setting Description Application template description If the device contains multiple applications, select the Application type from the drop-down list. Active system language User interface language for the application. Default: The language selected on the login page. Object naming convention Only Hierarchical, standard names (default) applies for Desigo Control Point.
2 Commissioning Subscribing to the time master 2.5 Subscribing to the time master The Desigo Control Point device time can be set or obtained from a time master. Complete this procedure to identify a time master for the Desigo Control Point device. If a time master is not being used, see the Settings section of the Desigo Touch Panel Clients Commissioning Manual (A6V11604303) to set the device time. Note The Desigo Control Point device cannot be a time master. 1. Select 2.
Commissioning Operating and monitoring features 2 2.8 Operating and monitoring features Use the workflow in this section to set up user accounts, add email recipients, and configure network and alarm settings in the application.
2 Commissioning Operating and monitoring features NOTICE Corporate network restrictions may prevent you from using the configuration settings outlined in this section. Please clarify the network security policies at each site. 1. Select > > SMTP settings to display the SMTP settings from the project database. 2. Use the information in the following table to update the settings and then click Apply. The Test connection dialog box displays. 3.
Commissioning 2 Operating and monitoring features Setting Description FTP server The IP address or DNS name of the FTP server that stores off-loaded data. For example, ftps://Host. User name The user name of an account that is allowed to access the FTP server. For example, Administrator. Password and Confirm password Type and confirm a password that complies with the password policy for your site. For security, the actual characters do not display in these fields.
Commissioning 2 Operating and monitoring features 2.8.6 Configuring Alarms settings This section configures the following settings for Alarms: Setting Description Alarm polling How often the database is checked for any objects with an active alarm state, an acknowledgerequired state, or a reset-required state. Alarm history ● By default, the database is polled every two seconds.
Commissioning 2 Operating and monitoring features Setting Description Weekly Monday Tuesday Wednesday Thursday Friday Saturday Sunday – Monthly Week 1 (Days 1-7) Monday Tuesday Wednesday Thursday Friday Saturday Sunday Week 2 (Days 8-14) Week 3 (Days 15-21) Week 4 (Days 22-28) Week 5 (Days 29-31) Time Displayed in the format selected by the currently logged in user. The default setting is 22:00 or 10:00 PM. ● Field 1: Hours ● Field 2: Minutes Table 7: Configure alarm history dialog box.
2 Commissioning Operating and monitoring features 4. Use the Table Alarm filter dialog box to make selections in the second dialog box. 5. Click Apply to save your selections. Setting Description Name Name of the alarm routing configuration. Default: Alarm routing If a configuration is saved with the default name, subsequent default names are Alarm routing n. Email subject The email subject line for the routed alarm.
Commissioning 2 Operating and monitoring features Table 10: Alarm filter dialog box. Editing an alarm routing This procedure modifies an existing alarm routing. Alarms is selected in the core function pane. 1. Select > > Configure alarm routing > . The Edit alarm routings dialog box displays the settings for each schedule. 2. Select an alarm routing from the drop-down list and select Edit. 3. Make the necessary changes in the Configure alarm routing dialog box and select Next. 4.
Commissioning 2 Operating and monitoring features Purging an alarm routing This procedure removes an alarm routing from the database. Alarms is selected in the core function pane. 1. Select > > Configure alarm routing > . The Purge alarm routings dialog box displays all alarm routings. 2. Select the alarm routing(s) to be removed and select Remove. 3. Select Apply to complete the removal. 2.8.
Commissioning 2 Operating and monitoring features Setting Description Automatically integrate newly assigned devices ● If selected, data points are automatically integrated as soon as the automation station is assigned to the Desigo Control Point device. ● If cleared, you must manually integrate data points for newly-assigned devices. ● If selected, data points from an assigned device are automatically integrated if there is a change in the device type or the BACnet database revision number.
2 Commissioning Operating and monitoring features 2.8.9.1 Uploading documents Use this procedure to upload documents to the Desigo Control Point device and determine where the documents are available in the building hierarchy. Uploading documents 1. Navigate to the building hierarchy location where the document will be used. 2. Select > > Online file management > . 3. Click Choose file, navigate to the document location on your local computer and click Open. 4. Enter a Resource name.
Data point integration 3 Data point integration user interface 3 Data point integration The Data point integration function displays under > Tools for all core functions that a user role is allowed to access. Data points from the devices being monitored must be integrated to the Desigo Control Point device. The Desigo Control Point device determines the total number of data points that can be integrated. For BACnet devices and systems all data points are integrated by default. 3.
Data point integration 3 Data point integration user interface ⑨ Status Indicates whether the objects from the device have been integrated to the Desigo Control Point device for monitoring. See the following Table Status indications for more information. ⑩ Filled Percent of the Desigo Control Point device capacity used by this device. ⑪ Template Does not apply for BACnet devices and systems. ⑫ Cache / Advanced ● Select Cache to load data points into the Desigo Control Point device memory.
Data point integration 3 Advanced integration functions 3.2 Advanced integration functions Use the Advanced integration functions to manually add or remove BACnet objects from the Desigo Control Point device. (See ④ and ⑤ in the following figure.) 1 2 3 4 5a 5b 6 ① Device name ② Applied template Does not apply for BACnet devices and systems. ③ Reset change button 5c 7 Apply button Applies your changes and closes the Advanced integration function.
Data point integration 3 Advanced integration functions ⓑ Clear the check box to manually remove a data point from integration. ⓒ The Source column indicates if a data point was added by the template, manually added or manually removed for integration. ⑥ Provided filter text Does not apply for BACnet devices and systems. ⑦ Tags column Displays semantic tags that are applied during data point integration. Does not apply for BACnet devices and systems.
Data point integration Advanced integration functions 3 Example The filter coil and netObjectAccess >= 5 has been applied in the following figure. In this case, objects are only included if they have both the tag coil and netObjectAccess >= 5.
3 Data point integration Advanced integration functions The filter equipRef->navName == “Cooling coil” has been applied in the following figure.
Data point integration 3 Resolving errors related to data point integration 3.3 Resolving errors related to data point integration Complete this procedure if a cache or integration error occurs. 1. Manually remove the device in ABT-SSA: – Select > Setup & Service > Assigned devices. – Select Assigned devices in the work area and click – – Click for the device with the error. Click Delete to confirm the action. to open Edit mode. 2.
4 Graphic features Plant view Tools 4 Graphic features 4.1 Plant view Tools The Plant view core function provides custom graphical views of the current control within your facility. Graphics available for viewing in the Plant view are based on the type of binding applied to the graphic the context of where the user is in the navigation. For example, a room segment graphic with relative binding will be available for all room segments at the same relative position in the building hierarchy.
Graphic features 4 Plant view Tools User interface ① Root icon and breadcrumb navigation Click to navigate to the top of the hierarchy for all devices being monitored. Graphics at this level are designed to encompass an entire project and display data from multiple sites. For example, a dashboard graphic that displays data for all fire sensors in a project.
4 Graphic features Plant view Tools Enabled graphics and kiosks Graphics and kiosks with an active thumbnail image or an active generic logo can be viewed by room users. A generic logo displays if a graphic does not have a thumbnail image. ④ Click the thumbnail image, the graphic name or to display a graphic or kiosk.
Graphic features 4 Plant view Tools (Optional) Adding graphic components 1. Drag-and-drop graphic components from the COMPONENTS pane. 2. Drag-and-drop the appropriate data point from the EQUIPMENTS pane onto the component. 3. (Optional) Right-click the component and select TOOLS > RELATIVIZE. Select the binding options to create a relative reference and click APPLY. (Optional) Adding smart labels 1. Drag-and-drop a numeric point from the EQUIPMENTS pane. 2.
Graphic features 4 Plant view Tools 4.1.3 Removing a graphic The process for removing a graphic is context-sensitive. ● You can display a list of graphics in the Plant view and select one or more graphics to remove. ● You can remove the graphic you are currently viewing. Removing a graphic ⚫ Do one of the following: – Select > > Configure graphics > in the Plant view to display a list of graphics. Select the graphic(s) to remove, click Remove and then click Apply.
Graphic features Plant view Tools 4 Exporting graphics for sharing across jobs Use this procedure to export your custom graphics for use on another Desigo Control Point device. Create a graphic that contains all of the custom components to be used elsewhere. 1. Select > > Export files. 2. Select Graphics or Models. 3. Select the desired graphic(s) or model(s) in the dialog box and click Next. The dialog box displays a list of the files selected for export. 4. Click Export to generate the *.
4 Graphic features Plant view Tools 4.1.7 Enable / disable graphics and kiosks Room users can only view graphics and kiosks that have been enabled in the Desigo Control Point device. The model of Desigo Control Point device determines the total number of graphics and kiosks that can be enabled. 1. Select > > Enable/disable graphics & kiosks. The Enable/disable graphics & kiosks dialog box indicates how many graphics and kiosks are enabled. 2.
Graphic features 4 Plant view Tools 4.1.8 Defining graphics as a startup page Graphics that are defined as a startup page are the default view for a particular level of the building hierarchy. This feature helps to maintain relative references if you are using hyperlinks to navigate between graphics. 1. Select > > Define startup page. The Define startup page dialog box displays all graphics in the application. 2. Select the graphic(s) to define as a startup page in the Not startup pages section. 3.
4 Graphic features Kiosk graphics 4.2 Kiosk graphics A PXM... touch panel may be used to display kiosk graphics. A kiosk displays graphics in a controlled manner that prevents users from accessing information and system features outside the scope of the controlled display. ● An activated kiosk displays graphics in full-screen mode. ● Exiting full-screen mode requires a special touch sequence and user authentication. ● Thumbnail images are currently not supported for kiosk graphics.
Graphic features 4 Kiosk graphics 4.2.2 Designing interactive graphics This section outlines the recommended layout to optimize user experience during room operation. As a security measure to prevent malware attacks, Web browsers do not allow the display to change to full-screen mode without user interaction. Using a different layout may cause the icon to display, which indicates that a tap or click is required to authorize full-screen mode.
4 Graphic features Kiosk graphics 1 2 3 4 5 6 ① Interactive kiosk Only one graphic can be assigned to an interactive kiosk. This graphic displays when a user navigates to the kiosk. Navigating to the kiosk and navigating to the graphic assigned to the kiosk appear the same to the user; however It is only possible to enter or exit full-screen mode from the kiosk. ② Starting graphic If graphics with hyperlinks are used, a starting graphic should be assigned to the kiosk to optimize user experience.
Graphic features 4 Kiosk graphics 4.2.3 Workflow for configuring a kiosk presentation Workflow step 1 Configuring a user account for the kiosk operator [➙ 45] 2 Configuring interactive graphics [➙ 45] or Configuring a slideshow of graphics [➙ 46] 3 Activating a kiosk presentation [➙ 47] Configuring a user account for the kiosk operator This procedure configures a user account for the kiosk operator that does not automatically log out and is limited to running the kiosk. 1.
Graphic features 4 Kiosk graphics 4. Select > > Enable/disable graphics & kiosks. 5. Select the new kiosk in the Disabled graphics & kiosks section, click Apply to enable it and then click Close. The interactive graphic kiosk is enabled for viewing. Configuring a slideshow of graphics A slideshow of graphics can be assigned one graphic or multiple graphics to be displayed in sequence.
Graphic features Kiosk graphics 4 Activating a kiosk presentation CAUTION Always activate the kiosk while logged in with the kiosk user account. Activating the kiosk while logged in with an advanced user account, such as an administrator or engineer, allows the kiosk operator to access non-kiosk system functions. NOTICE User accounts with limited access cannot log in if the previous user logged out from the ABT Setup & Service Assistant (SSA).
4 Graphic features Kiosk graphics ① Name Type a new name to rename the kiosk graphic. ② KIOSK ON filter Modify the KIOSK ON filter to change the equip or site where the components bind to display values and states. ③ Select graphic Select the interactive graphic to display for this kiosk. ④ Select target Select the equip or site where the components bind to display values and states. 4.2.
Graphic features Kiosk graphics 4 Editing kiosk properties ① Name Type a new name to rename the kiosk graphic. ② KIOSK ON filter Modify the KIOSK ON filter to change the equip or site where the components bind to display values and states. Adding slides ① Select the graphic to display in the slideshow. ② The equip or site where the components bind to display values and states. ③ The number of seconds each slide displays. ④ The position of the current graphic in the slideshow sequence.
4 Graphic features Kiosk graphics Editing slides ① The graphic name. ② The equip or site where the components bind to display values and states. ③ The number of seconds each slide displays. ④ The position of the current graphic in the slideshow sequence. ⑤ Fields for editing the next slide in the slideshow.
Graphic features Kiosk graphics 4 Removing slides 1. Select the slide(s) to remove from the slideshow. 2. Click Remove and OK to confirm the removal. 4.2.6 Removing a kiosk 1. Select > > Configure kiosks > Remove . The Remove kiosks dialog box displays all kiosks in the application. 2. Select the kiosk(s) to remove and click Remove. 3. Click Remove to confirm the removal. 4.2.
Graphic features 4 Engineering notations 2. Enter the User name and password of the user account that activated the kiosk session to log out and end the kiosk session. The Log in screen displays, and any user can log in. NOTICE Do the following if you do not know which user account activated the kiosk session: ● Tap Cancel on the Log out screen. An error may display. ● ● Swipe down to display the URL bar and tap to display ABT-SSA. Select Log out from the User management menu.
Graphic features 4 Engineering notations 3. In the top section of the dialog box, select the equipment to which an engineering notation is being added. 4. In the middle section of the dialog box, select the data point(s) to which an engineering notation is being added. 5. Type the engineering notation in the engNotation key value field and click Apply. 6. Display the magic bubbles to verify the engineering notations.
4 Graphic features Engineering notations Editing an engineering notation 1. Open the List view and navigate to the level of the building hierarchy where the equipment and/or data points with an engineering notation reside. 2. Select > > Edit engineering notation > . All engineering notation tags at the selected location in the building hierarchy are displayed. 3. Edit the tag information and click Apply. Removing an engineering notation 1.
Graphics Builder 5 Overview 5 Graphics Builder Graphics Builder is the graphic design tool for Desigo Control Point. 5.1 Overview This section provides an overview of the Graphics Builder user interface and terms and concepts that are important for understanding how to use the program. User interface 1 2 3 6 ① Builder pane Provides tools for building graphics or displays information about the current graphic.
Graphics Builder 5 ③ Overview Command bar and MENU flyout Contain basic tools, such as copy, paste, save, open and drawing shapes. The MENU flyout also provides SAVE AS GRAPHIC . Command bar and MENU icons [➙ 57] ④ Currently not used. ⑤ PREVIEW button Click to preview the current graphic. Animated components are active and objects that depend on the context display.
Graphics Builder 5 Overview Command bar and MENU icons The command bar and MENU flyout contain basic tools, such as copy, paste, save, open, and drawing shapes. Indicator Name Key combination Description NEW GRAPHIC – Opens an empty graphic page. OPEN GRAPHIC – Opens graphics from the current project. SAVE GRAPHIC CTRL+S Saves and publishes the current graphic. SAVE AS GRAPHIC Only available in the MENU flyout. Saves a copy of the current graphic with a different name.
Graphics Builder 5 Overview Data point binding Data point binding refers to the type of connection between a graphic component and an integrated data point. Graphics Builder uses the following types of data point binding: ● Absolute binding is a fixed connection to a point ID or equip ID that is unique to a specific database. – An absolute binding always fetches data from a specific instance of a point in this database.
Graphics Builder Overview 5 Relative by navName binding Relative by navName binding has a query that contains an equipRef and a navName. For example: equipRef==$id and (point or shadowPoint) and navName=="Outside air temperature" Figure 5: Example of navName in a binding query. ● ● ● The binding query works on any equipment where the structure of the building hierarchy and the navName naming convention are a match.
5 Graphics Builder Overview How semantic tags create structure in the system Desigo Control Point uses a semantic tagging model, which is based on the open source Project Haystack model. Rather than object instance numbers or proprietary data point names, a semantic tagging model uses standardized, descriptive metadata to categorize and interpret data point information. The Haystack tags site, equip and point create a basic hierarchy in Desigo Control Point.
Graphics Builder Overview ③ 5 point or shadowPoint Every data point in the system has a point or shadowPoint tag. Point or shadowPoint objects are not structured and have references to a parent equip or site object. In this example, Valve is an analog output point and has a parent equip reference (equipRef) to Cooling coil. Each data point also has one of the following tags to classify its type: ● cmd, which classifies a data point as an output, AO/BO, command, or actuator.
Graphics Builder 5 Overview ① Describing the relative position of a point or equip in the hierarchy References in relative bindings always start at lower levels of the building hierarchy and link to higher levels. For example, references link from a point (or shadowPoint) to an equip to a site to the Desigo Control Point device at the Root . ② Dynamic structure Relative bindings create a structure that is used to dynamically identify a point or equip.
Graphics Builder 5 Overview Binding query Type of binding Description baUniqueId Fixed for a specific application on a specific system device. ● Query stays constant within a device unless the application structure is changed. ● Useful for one-time solutions. semantic tags Can be reused with similar applications and other system devices. Query can be used across systems and is extensible by individual libraries. shortName Can be reused with similar applications and other system devices.
Graphics Builder 5 Overview Configuring the binding options 1. In the Plant view, display the graphic that will use Relative by navName binding. 2. Select > > Configure graphics > . Graphics Builder opens the graphic in a new tab. 3. Do the following for each component and smart label in the graphic: – Select the item, right-click and select TOOLS > RELATIVIZE. The Component binding options dialog box displays.
Graphics Builder 5 Overview Creating site and Root level graphics This section outlines tips for creating graphics that reside at the site level of the building hierarchy or at the Root, which is the top of the hierarchy for all devices being monitored. ● site level graphics display data for an entire facility. For example, a graphic that displays the occupied status of all conference rooms in a building or closely-related buildings.
Graphics Builder 5 Overview GRAPHIC ON Result site This graphic can be opened for viewing on any site. site and navName=="your site name 1" or navName=="your site name 2" This graphic can be opened for viewing on either of the specified sites, which are known to have the same or similar structures in the building hierarchy. Table 16: Modifying the GRAPHIC ON. Figure 6: Modifying the GRAPHIC ON.
Graphics Builder 5 Overview ● The $id can be manually removed and replaced with a specific navName. – Binding defined by navName instead of the $id variable is not affected by where the graphic is opened for viewing. – GRAPHIC ON can then be set to any place in the project structure where it is convenient for this graphic to appear, including the special topLevel tag that identifies the Binding query Root level.
5 Graphics Builder Overview Reusing graphics on other devices Reusing graphics on other Desigo Control Point devices Graphics with relative binding can be reused on other Desigo Control Point devices that have the same or similar applications. ● Relative by Tags binding is recommended for all supported standard applications because semantic tags are automatically applied during data point integration. ● Always use semantic tags that follow the Haystack conventions when creating relativized graphics.
Graphics Builder 5 Overview 3. Do the following for each component and smart label in the graphic: – Select a component or smart label, right-click and select TOOLS > RELATIVIZE. The Component binding options dialog box displays. – In the Top Equip section, select the building hierarchy location where the graphic will be used. By default, the object on which you opened this graphic is selected. Another object can be manually selected, if necessary.
5 Graphics Builder Pane tools 5.2 Pane tools The Builder pane displays on the left side of the Graphics Builder and contains the following tools for building robust graphics: ● PROPERTIES [➙ 70] Used to view, edit, add or remove any object, or modify the properties of a graphic component. ● COMPONENTS [➙ 74] Provides components for dashboard graphics and HTML elements and images for physical components. ● LAYERS [➙ 132] Displays a hierarchical structure for all the components in a graphic.
Graphics Builder 5 Pane tools BASIC PROPERTIES Use the BASIC PROPERTIES to modify the graphic name or change the appearance of the selected component. This section outlines the properties that are common to all components. See the COMPONENTS tools [➙ 74] and HTML COMPONENTS [➙ 101] sections for information on specific components. General properties ● Component icon and Name field (not labeled) The name of the currently-selected graphic component.
5 Graphics Builder Pane tools BORDER Adds a border to the selected component. ● Enter a point value in the WIDTH field and select a line TYPE from the drop-down list. ● Select ● Select ● Click the COLOR field to open the palette. Select a color and click the COLOR field again to save your selection. ● Use the RADIUS field to change the appearance of the corners of the selected component. to change all borders at once. , or to change individual sections of the border.
Graphics Builder 5 Pane tools ADVANCED PROPERTIES Use the ADVANCED PROPERTIES section to add, edit and remove tags for the selected component. ① binding property A string tag that displays binding information for the selected component. Data point binding [➙ 58] ② 1 ● For components with absolute binding, the ID for a specific data point in the database is displayed. For example, id == @20a3572b-28b7e002. ● For components with relative binding, a query string is displayed.
Graphics Builder 5 Pane tools 5.2.2 COMPONENTS The ● ● ● ● ● ● COMPONENTS pane provides the following tools for creating graphics: Components that are mainly used for dashboard graphics. For example, tools to create charts and gauges, embed graphics, display a motion jpeg and create custom interfaces with the RactiveJS library. COMPONENTS tools [➙ 74] Components to add HTML elements. HTML COMPONENTS [➙ 101] Components that simplify the configuration of bar, circle, half-circle, and icon gauges.
Graphics Builder 5 Pane tools Indicator Name Description ITEM RENDERER Renders a list of models based on a query from a virtual point. Example Used in the Sample Room Segment graphic. (Lights and blinds are rendered with an Item renderer.) KIOSK This is a basic component for custom programming only. See the Desigo Control Point kiosk tools, which provide the standard workflow for creating kiosks with robust functionality.
Graphics Builder 5 Pane tools Workflow step More information 1 Create trend(s) for Historical (his) charts. See Trends tools in the Desigo Control Point Operation Manual (A6V11211557). 2 Create the dashboard component. See TIMER [➙ 99] to set a refresh interval. ● Drag-and-drop a chart from COMPONENTS > AM CHARTS onto the work area. ● (Optional) Drag-and-drop from the COMPONENTS > COMPONENTS pane onto the work area to set a refresh interval for the chart data.
Graphics Builder Pane tools 5 Area chart Displays historical data (his) for up to ten points. 1 2 3 4 5 Figure 7: Area chart example. ① Main Title ② Chart Scrollbar ③ Side Title ④ Chart Cursor ⑤ Legend Setting Description Chart type Historical is the only option. Number of points Number of points to display in the chart. Maximum is 10. Timer (Optional) Select a timer to set a refresh interval for the chart data. Legend Select to display a legend below the chart.
5 Graphics Builder Pane tools Column chart Displays historical data (his) or current values (curVal) for up to ten points. Values can be displayed in either vertical or horizontal bars. 1 2 3 4 5 Figure 8: Column chart example. ① Main Title ② Y Axis Max ③ Side Title ④ Show Background ⑤ Y Axis Min Field Description Chart type Select Current Val or Historical. Number of points Number of points to display in the chart. Maximum is 10.
Graphics Builder Pane tools 5 Column layered chart Displays historical data (his) for exactly two points. Values can be displayed in either vertical or horizontal bars. 1 2 Figure 9: Column layered example. ① Main Title ② Side Title Setting Description Chart type Historical is the only option. Number of points Number of points to display in the chart. Must be exactly 2. Timer (Optional) Select a timer to set a refresh interval for the chart data.
5 Graphics Builder Pane tools Column line chart Displays historical data (his) for exactly two points. One value is displayed in vertical bars, and one value is displayed as a line graph. 1 2 3 4 5 6 Figure 10: Column line example. ① Main Title ② Chart Scrollbar ③ Side Title ④ Show Background ⑤ Chart Cursor ⑥ Legend Setting Description Chart type Historical is the only option. Number of points Number of points to display in the chart. Maximum is 10.
Graphics Builder Pane tools 5 Column stacked chart Displays historical data (his) for up to ten points. Values are displayed in vertical bars. 1 2 3 4 Figure 11: Column stacked example. ① Main Title ② Chart Scrollbar ③ Side Title ④ Legend Setting Description Chart type Historical is the only option. Number of points Number of points to display in the chart. Maximum is 10. Timer (Optional) Select a timer to set a refresh interval for the chart data.
5 Graphics Builder Pane tools Line chart Displays historical data (his) for up to ten points. 1 2 3 4 5 6 Figure 12: Line chart example. ① Main Title ② Chart Scrollbar ③ Side Title ④ Show Background ⑤ Chart Cursor ⑥ Legend Setting Description Chart type Historical is the only option. Number of points Number of points to display in the chart. Maximum is 10. Timer (Optional) Select a timer to set a refresh interval for the chart data.
Graphics Builder Pane tools 5 Pie chart Displays current values (curVal) for up to ten points. 1 2 3 4 5 Figure 13: Pie and Donut chart examples. ① Main Title ② Chart Cursor ③ Legend ④ Animate Slice ⑤ Show Background Field Description Chart type Current Val is the only option. Number of points Number of points to display in the chart. Maximum is 10. Timer (Optional) Select a timer to set a refresh interval for the chart data. Legend Select to display a legend below the chart.
5 Graphics Builder Pane tools Field Description Chart Cursor Select to display the data point value when scrolling over the chart. Animate Slice Select to pull out an individual slice of the pie chart when it is clicked. Main Title Show Background Title shown at top of chart, if left blank it does not display a title. Select to make the background opaque and display a frame around the chart.
Graphics Builder 5 Pane tools Configure Dashboard Component Points Prerequisites ● ● Data points for the chart are available in the VIRTUAL POINTS pane. The Num Points field in the Configure Dashboard Comp dialog box reflects the number of data points to display in the chart. Data points for curVal charts are selected from a drop-down list of VIRTUAL POINTS that are associated with the graphic. If the desired data point is not in the list, drag-and-drop numeric points from the chart.
5 Graphics Builder Pane tools 5. Click at the bottom of the VIRTUAL POINTS pane to add a new virtual point. 6. Name the virtual point (if desired) and click 7. Click A . for the new virtual point and select ADD PROPERTY. string tag is added. 8. Name the property query and click . 9. Select the value for the query property (initially named NULL), change it to readAll(site) and click 86 | 196 .
Graphics Builder Pane tools 10. Drag-and-drop the new virtual point onto the 5 DATA GRID to bind it to the component. 11. Click PREVIEW in the upper right corner to display the data.
Graphics Builder 5 Pane tools GAUGE A GAUGE displays the current value of a virtual point in a gauge format. Configuring a GAUGE This procedure uses the PROPERTIES, COMPONENTS, VIRTUAL POINTS and EQUIPMENTS panes. 1. From the COMPONENTS > COMPONENTS pane, drag-and-drop 2. (Optional) Select the new GAUGE and use the BASIC GAUGE onto the work area. PROPERTIES to modify the appearance of the gauge. Working with gauges [➙ 167] 3.
Graphics Builder Pane tools 5 AM|GAUGE An AM|GAUGE displays the current value (curVal) of a virtual point in a gauge format. This component is typically used in combination with a PROGRAM and a GROUP. Configuring an AM|GAUGE 1. Drag-and-drop 2. Drag-and-drop a from COMPONENTS > COMPONENTS onto the work area. numeric point from EQUIPMENTS onto the work area to create a smart label for the gauge. 3.
Graphics Builder 5 Pane tools 5. (Optional) Select the gauge and use the BASIC PROPERTIES to modify the End value, Start value or Title . BASIC PROPERTIES [➙ 71] 6. Click PREVIEW in the upper right corner to display the gauge updating with the current value. GRAPHIC INCLUDE GRAPHIC INCLUDE creates a frame that embeds a graphic into another graphic. For an example, see the FIN Include Program in the PROGRAMS pane of the Sample room segment graphic.
Graphics Builder Pane tools 3. Click PREVIEW in the upper right corner to display the A6V11604297_en--_e 5 GRAPHIC INCLUDE.
5 Graphics Builder Pane tools GROUP Groups are typically used to hold components together for making models. Graphics Builder provides two options for holding components together: ● Using GROUP in the COMPONENTS > COMPONENTS pane. ● Selecting CREATE GROUP from the right-click menu. Creating a group with the GROUP component This procedure uses the COMPONENTS and LAYERS panes. 1. Drag the desired components onto the work area. 2.
Graphics Builder 5 Pane tools Creating a group through the right-click menu This procedure uses the COMPONENTS pane. 1. Drag-and-drop the desired components onto the work area. 2. Use the mouse to select the components, right click and select CREATE GROUP. The components are grouped together and move as a single unit. BASIC IMAGE BASIC IMAGE adds an image to a graphic. Configuring a BASIC IMAGE This procedure uses the 1. From the PROPERTIES and COMPONENTS panes.
Graphics Builder 5 Pane tools 4. Click PREVIEW in the upper right corner to display the BASIC IMAGE. ITEM RENDERER ITEM RENDERER uses a program to query for points or equipment in the currently selected location of the building structure. For each point or equipment found, the ITEM RENDERER renders and binds a graphic component, such as a fan or light, and displays the correct number of components.
Graphics Builder 5 Pane tools 3. Select the new MJPEG component. 4. Do the following in the BASIC PROPERTIES pane: a. Paste the URL of the MJPEG image stream in the Source field. b. (Optional) Enter a value in the Delay (Ms) field to set the update interval of the image. 5. Click PREVIEW in the upper right corner to display the image stream in the MJPEG component. MODEL LOADER The MODEL LOADER creates a custom model that can be reused.
5 Graphics Builder Pane tools b. Use the mouse to select the components, right-click and select CREATE GROUP. 2. In the BASIC PROPERTIES pane, enter a name in the field and click SAVE. 3. To use the model, locate it in the COMPONENTS > MODELS pane and drag-and-drop it onto the work area.
Graphics Builder 5 Pane tools Editing a model Note Editing a model creates a new copy of it. You cannot update and save an existing model, and you are not prevented from assigning the same name to multiple models. 1. Select VIEW ASSETS in the command bar. The IMPORT dialog box displays all models and images stored in the device. 2. Select the model you want to edit and click IMPORT. The model is added to the work area. 3. Right-click on the model, select UNGROUP and make the desired edits. 4.
5 Graphics Builder Pane tools 1. From the 2. In the BASIC COMPONENTS > COMPONENTS pane, drag-and-drop onto the work area. PROPERTIES pane, expand RACTIVE EDITOR and click OPEN EDITOR. The RACTIVE EDITOR dialog box displays. 3. Go to the FIN Stack online documentation Web site (https://finproducts.atlassian.net/wiki/spaces/FINStack/pages/91603570/GB+Ractive) and select a custom interface. 4.
Graphics Builder 5 Pane tools TIMER The TIMER generates an event at specified intervals. This component is generally used for timing programs. For example, it sets a delay for a program to start or an interval for a program to refresh and continue running. Configuring a TIMER This procedure uses the 1. From the PROPERTIES, COMPONENTS and COMPONENTS > COMPONENTS pane, drag-and-drop PROGRAMS panes. onto the work area and then select it. 2.
5 Graphics Builder Pane tools 7. Click SAVE to save the program and close the PROGRAM EDITOR. The program runs or refreshes at the specified interval. To use a Timer on a Program 1. Click in the PROGRAMS 2. Click in the upper right corner of the PROGRAM EDITOR dialog box. 3. Click at the top of the PROGRAMS VARS pane. 4. Click Settings pane to edit the program. for the new variable and then do the following. a. Type timer in the filter field. b.
Graphics Builder Pane tools 5 HTML COMPONENTS CAUTION Minimize links to external URLs. Linking to external URLs, such as Favorites, Web cams and external Web services poses a security risk. ● ● Indicator URLs shall only direct to secure services, such as Web servers hosted by devices in the building automation control network.
5 Graphics Builder Pane tools ANCHOR The ANCHOR component creates a link to a URL. This is the HTML hyperlink element (). The following table outlines attributes of the ANCHOR component that can be modified in the BASIC PROPERTIES pane. The minimum requirement is an href value. For more information on this element or its attributes, visit https://www.w3schools.com/tags/tag_a.asp.
Graphics Builder Pane tools Shape Target 5 Shape of the link Used with the Coords attribute to specify the shape of a link. Not supported in HTML5. Options are: ● default (Default) ● rect ● circle ● poly Where to open the linked document Options are: ● _blank (Default) ● _parent ● _self ● _top ● Framename Note: Select _top for PXM… devices.
5 Graphics Builder Pane tools 104 | 196 A6V11604297_en--_e
Graphics Builder Pane tools 5 BUTTON The BUTTON component is typically used to start an action within a graphic. This is the HTML button element (
5 Graphics Builder Pane tools Type Button type Specifies the type of button. Options are: ● button, a clickable button ● reset, resets the form data to initial values ● submit, submits form data Default: No selection Value Initial value Specifies an initial value for the button in a form. Default: Field is blank Table 33: BUTTON attributes. Creating a button that displays a JavaScript alert dialog box and switches the button’s text This procedure uses the 1.
Graphics Builder Pane tools 5 H-RULE The H-RULE component is a separating line used to define a thematic break in a graphic. This is the HTML horizontal-rule element (
). The following table outlines attributes of the H-RULE component that can be modified in the BASIC PROPERTIES pane. For more information on this element or its attributes, visit https://www.w3schools.com/tags/tag_hr.asp. Attributes Description Color Color picker Color of the H-RULE component.5 Graphics Builder Pane tools ismap Image map Specifies that the image is part of a server-side image-map. Switch OFF if the image is not part of an image map. Switch ON if the image is part of an image map. Default: OFF longdesc Long description A URL to a detailed description of an image. Default: Field is blank. src Source The URL of an image. Default: Field is blank. usemap Use map Specifies an image as a client-side image-map. Default: Field is blank.
Graphics Builder Pane tools 5 Using the VIEW ASSETS tool ⚫ Do one of the following to import an image: – Drag-and-drop it from your local computer onto the work area – Use VIEW ASSETS in the toolbar to select an image from the database. The fileRef property in the ADVANCED PROPERTIES pane references the image file. INCLUDE The INCLUDE component embeds a Web page into a graphic by setting the src attribute to the Web site’s address. This is the HTML iframe element (
