FlexGateway Guide
Transcription
FlexGateway Guide
FLEXGATEWAY (FLEXVISOR) USER GUIDE VERSION 2.0 JULY 2015 AET Manufacturing Ltd, Unit 2707, The Center, 99 Queen’s Road Central, Hong Kong UK office +44 (0)1342 310400 / Hong Kong office +852 2575 218 / [email protected] flexiblespace.com Flexgateway Guide (Flexvisor) 2015 Table of Contents Section One – General Description ......................................................................................2 1.1 General ..........................................................................................................................2 Section Two - Project Description ........................................................................................3 2.0 Project Description .........................................................................................................3 2.1 Flexgateway Connected on Serial Port ...........................................................................3 2.2 Flexgateway Connected on mHipA .................................................................................4 Section Three - Flexgateway .................................................................................................6 3.1 Web Interface .................................................................................................................6 3.2 Password Protected Web Interface.................................................................................6 3.2 Navigation ......................................................................................................................8 3.3 Listview All Units.............................................................................................................9 3.4 Listview ........................................................................................................................ 10 3.5 Roomview..................................................................................................................... 11 3.5 CAM Unit xTU List view ................................................................................................ 13 3.6 CAM Unit Overview ...................................................................................................... 14 3.7 CAM Unit Configuration ................................................................................................ 15 3.8 Timer Settings .............................................................................................................. 16 3.9 Unit Events ................................................................................................................... 17 3.10 Messaging .................................................................................................................. 18 3.11 Unit Charts ................................................................................................................. 19 3.12 xTU Overview ............................................................................................................. 20 3.13 Configuration .............................................................................................................. 21 3.14 Customisation ............................................................................................................. 22 3.15 Roomview Designer ................................................................................................... 23 Appendix A ........................................................................................................................... 29 Quick Guide: New Floor Creation Guide (roomview designer) ............................................ 29 1|Page Flexgateway Guide (Flexvisor) 2015 Section One – General Description 1.1 General This document describes the functionality and scope of application of the Flexgateway. It is purpose is to give an overview of the Flexgateway. It contains a short introduction about installation and configuration of Flexgateway, but it is not a replacement for the installation manual. The screenshots of devices are representative. Final designs will depend upon the client’s final requirements. Features: ARM9 Processor 64MB RAM 200MHZ Flexbus Master Flexbus Slave RS422/485 Interface LAN USB Embedded Linux Integrated web server 2|Page Flexgateway Guide (Flexvisor) 2015 Section Two - Project Description 2.0 Project Description The Flexgateway is a device, which collects data from CAM Units over serial port or LAN interface. The CAM units can be connected directly over serial connection. The integrated web server provides web pages to visualise the state of the units and to configure the units. No additional Flexvisor software is needed. 2.1 Flexgateway Connected on Serial Port Figure 1 – CAM Installation with Flexgateway The example in Figure 1 shows us an installation with two CAM units. The Flexgateway is connected to the installation by serial port. All Flexfaces need to be connected to the Flexgateway which collects data from the units. 3|Page Flexgateway Guide (Flexvisor) 2015 2.2 Flexgateway Connected on mHipA Figure 2 – CAM Installation with mHipA and Flexgateway The example in Figure 2 shows an installation with two CAM units. The Flexgateway is connected to the installation Ethernet. Each Flexface needs 1 mHipA to be able to communicate with the Flexgateway. 4|Page Flexgateway Guide (Flexvisor) 2015 2.2.1 Typical installation with two or more floors Figure 3 – Typical Installation Figure 3 shows a typical installation over two floors. On every floor there are up to twenty four (24) CAM’s possible. Each CAM can handle up to twenty four (24) Master xTU’s. One network switch (by others) is necessary per floor, which collects data from the CAM units. Additionally there is the possibility to connect a Flexgateway – BMS to pass the CAM data to a BMS by Bacnet protocol 5|Page Flexgateway Guide (Flexvisor) 2015 Section Three - Flexgateway 3.1 Web Interface This chapter describes the web interface of the Flexgateway. Google Chrome browser is recommended for the best user experience. 3.2 Password Protected Web Interface To get access to the web interface it is necessary to insert a correct user name / password combination. Presently there are two different security levels available. 1. User-Level: This security level allows the operator to visualize standard values such as “actual zone temperature”, “actual zone humidity” etc. as well as changing the “zone temperature set point”. 2. Expert-Level: In addition to the above points, the operator is also permitted to change configuration settings of the CAM. The predefined usernames and passwords are shown in Figure 4. Figure 4 – User Definitions Username Password User Level user user User expert expert Admin 6|Page Flexgateway Guide (Flexvisor) 2015 Figure 5 – Login 7|Page Flexgateway Guide (Flexvisor) 2015 3.2 Navigation Figure 6 – Start Page The Flexgateway web interface is subdivided in two main navigation areas. On the left is shown a tree structure of your configuration and on the right the actual content with context dependent tabs. The tree helps to navigate through all your devices. Every root node represents a floor, followed by the CAM units and xTU’s. The tree shows limited information on the devices for easy reference, e.g. current temperature and the unit state. A warning icon appears when an alarm occurs. Its tooltip provides a quick way to view the alarm descriptions (Figure 7). Active xTU’s are represented with an animated fan icon. 8|Page Flexgateway Guide (Flexvisor) 2015 Figure 7 – Alarm Tooltip 3.3 Listview All Units Figure 8 – Listview All Units Clicking on the root node opens a list of all active Units in your configuration. This view allows the user to activate/deactivate all Units with one click or to set the Setpoint for all Units to the same value. The buttons on the lower left activate or deactivate all Units. A click on one of the buttons on the lower right opens a form dialog where you can modify the corresponding Setpoint (similar to Figure 16). 9|Page Flexgateway Guide (Flexvisor) 2015 This view should not be used to check the single values of the Units as with a high number of Units the update rate decreases rapidly. This should be done with the Listview grouped by floors (refer to section 3.4). 3.4 Listview Figure 9 – Listview To open a device’s configuration, double click on its tree node, or right click on the same node to open the context menu with the open option (Figure 10). With a single click on the small black arrow near each node, the sub tree can be expanded or collapsed. Figure 9 shows the Listview. The Listview is the default view when a double click is applied on a floor node. This list shows all connected CAM units on the selected floor and displays various values. Double clicking on a list entry will open the corresponding unit overview (described in Section 3.6). In this view it is possible to activate/deactivate and set the zone and humidity Setpoint for all units at once. To activate or deactivate all units on this floor, press the Buttons on the lower left. To set a new value for the Setpoint press the Button on the lower right and a form dialog appears (Similar to Figure 16). 10 | P a g e Flexgateway Guide (Flexvisor) 2015 Figure 10 – Context Menu 3.5 Roomview Figure 11 - Roomview 11 | P a g e Flexgateway Guide (Flexvisor) 2015 For each floor it is possible to configure a Roomview in the Roomview Designer. This view is available after uploading a background image and positioning the CAM units and xTU’s. The devices are represented by rounded rectangles. The colour and icon of the rectangle indicate a CAM or an xTU. xTU’s are again represented with animated fan icons if they are active. Clicking on an element will open the unit overview (described in Section 3.6) or the xTU overview, (described in Section 3.12). With the buttons on the top right corner it is possible to zoom in and out. When zooming out the appearance of the devices will change. The additional information will be hidden and only the icons will remain, however the information is still available in the tooltips. Figure 12 – Roomview Tooltip CAM Unit Symbol Zone set point Return air temperature CAM ID Inactive 12 | P a g e Flexgateway Guide (Flexvisor) 2015 xTU Symbol Set point Room temperature xTU ID CAM ID Inactive Animated icon when active 3.5 CAM Unit xTU List view Figure 13 - xTU List View The default unit view shows a list of all xTU’s and some important values. Double clicking on a row will open the xTU view, (described in Section 3.12). 13 | P a g e Flexgateway Guide (Flexvisor) 2015 3.6 CAM Unit Overview Figure 14 – Unit Overview The Unit tab provides all necessary information on the selected CAM unit. Changes of zone and humidity set points are applied on pressing the “Apply” Button. The buttons “Unit On”, “Unit Off”, “Alarm Ack” and “Alarm Reset” react immediately. 14 | P a g e Flexgateway Guide (Flexvisor) 2015 3.7 CAM Unit Configuration Figure 15 – Unit Configuration The unit configuration view shows additional settings for the selected unit. A variable can be modified by clicking on it. This will open a form dialog where you can change the value. With a click on the “apply” button the changes will be saved immediately, whereas a click on the “cancel” button will abort the current modification. Figure 16 – Change Value Dialog 15 | P a g e Flexgateway Guide (Flexvisor) 2015 3.8 Timer Settings Figure 17 – Unit Time Settings The Timer Settings View provides a simple interface to modify daily temperature automation. The view is divided into three parts: Day settings: When enabled it is possible to select on which days the timer settings will be applied. If days are not selected, the unit will remain off (timer off). It is possible to set four different timers for the selected days. To modify the settings, click on a specific value; this will open a form dialog (Figure 16 – Change Value Dialog). Exception days: Exception days will override the day settings, if day settings are enabled. Unselected days operate either in standard timer mode or in standard mode. Yearly Exceptions: When enabled it is possible to add up to eight (8) dates where the unit is off. This setting will override all other timer settings for the specified day. 16 | P a g e Flexgateway Guide (Flexvisor) 2015 3.9 Unit Events Figure 18 – Unit Event Log Each unit has its own event tab where all active alarms and the event log are displayed. When this tab is opened, all active alarms are listed. With the button in the top right corner it is possible to switch to the event log and vice versa. The Event Log shows all past and present events (60 entries / Unit) in chronological order; including information such as description, timestamp and event type. 17 | P a g e Flexgateway Guide (Flexvisor) 2015 3.10 Messaging Figure 19 – Message Recipients The messaging menu handles all tasks related to the messaging capabilities and SMS forwarding of Flexvisor. This is where the configuration of which recipients are to be informed of events occurring in the selected unit. Alternatively a recipient for all units can be added by checking the option “Add to all Units”. There are two messaging formats: Email, when the events of configured units must be sent via messaging system. SMS, when the events of configured units must be sent to mobile phones. It is possible to choose between three different notification types - “Events”, “Alive” and “Events & Alive”. Existing recipients can be selected in the recipient list and tested by sending a default test message. Removing a recipient will remove it from all registered units. 18 | P a g e Flexgateway Guide (Flexvisor) 2015 3.11 Unit Charts Figure 20 – Unit Charts The chart tab shows different charts on time based data for each CAM unit, for example, temperature changes over the previous eight days or twenty four hours. The chart data and time range can be changed with the selection boxes above the chart. Charts are available for “Zone Temperature”, “Zone Humidity” and “Supply Temperature”, each from the previous eight days or twenty four hours. 19 | P a g e Flexgateway Guide (Flexvisor) 2015 3.12 xTU Overview Figure 21 – xTU Overview The configuration menu shows information about the xTU and allows changing the set point and the fan speed. Both options are applied when pressing the “Apply” button. 20 | P a g e Flexgateway Guide (Flexvisor) 2015 3.13 Configuration 3.13.1 Network Configuration: Figure 22 – Remote Maintenance Network 3.13.1 UMTS Support: Figure 23 - Remote Maintenance UMTS 21 | P a g e Flexgateway Guide (Flexvisor) 2015 3.14 Customisation Figure 24 – Customise The customisation tab allows you to upload a custom start screen. This is done by clicking on the “Upload Startpage content” button. This will open an upload window similar to that in Figure 27. It also allows the user to upload a custom logo. The start page document has to be named “start.html” otherwise it will not be recognised. The page must start and end with an html div (<div>....</div>) tag. Custom html code can be inserted between this. Images can be uploaded from the path “resource/flexvisor/startpage/” or a suitable custom image. Permissible image extensions are .png, .jpg, .jpeg, .bmp, .gif. Figure 25 shows a sample of the current default start screen code. Figure 25 – Default Start Screen Code 22 | P a g e Flexgateway Guide (Flexvisor) 2015 3.15 Roomview Designer Figure 26 - Roomview Editor With the Roomview Designer it is possible to create or modify the roomview configuration, which stores information regarding names, IDs (and position for CAM and xTU) of the Zones, CAMs and xTUs. Using the main window’s toolbar it is possible to import or export the configuration file. If it is necessary to cancel all data you have entered, press the button “Empty configuration” and all existing elements will be deleted, but the configuration file will be only altered when the data is exported. Be aware, that when the configuration is cancelled and after that export it, all data in the configuration file will be deleted! Refer to Appendix: New Floor Creation Guide for further instructions. If an existing configuration that contains existing data is loaded, it will be displayed in a treeview in a hierarchical order. Each zone can contain units, and each unit has twenty four (24) xTUs. 23 | P a g e Flexgateway Guide (Flexvisor) 2015 It is also possible to create new zones by pressing the button “Create a new zone”. This action will bring up a dialog box, asking for the zone name Figure 27 – Entering a New Zone’s Name After a name is entered the Zone Editor window will be opened Figure 28 – Entering a New Zone’s Name 24 | P a g e Flexgateway Guide (Flexvisor) 2015 The grey background colour indicates that no background image has been loaded yet. After the button “Load background image” in the Zone Editor’s toolbar is clicked, a dialog box will pop up and request that a background image is loaded. Figure 29 – Loading a Background Image When the button “Choose a background image” is pressed, a dialog pops up that allows the choice of the file to be uploaded. Figure 30 – Choosing a Background Image After an image file has been uploaded, the image data will be stored in the configuration file, so even if the image is lost after uploading, it is still available via the configuration file. 25 | P a g e Flexgateway Guide (Flexvisor) 2015 Background image files can be in .png or .jpg format, and should be of sufficient size, so the symbols for CAM’s and XTUs can easily be placed on their locations according to the architectural plan without overlapping or requiring excessive space. After loading a background image the CAM’s and xTUs can be added to the new zone by pressing the button “Create a new unit”. This will bring up a dialog asking for a name and ID for the unit. Figure 31 – Creating a New Unit After entering a unit name and ID, new CAM unit and xTU symbols will be created. 26 | P a g e Flexgateway Guide (Flexvisor) 2015 Figure 32 - The CAM and its 24 xTUs The CAM and xTU symbols can now be moved around by moving the mouse over the symbol and pressing and holding the right mouse button. After the mouse button is released the symbol will stay in its new location, and the configuration data will be updated accordingly. A right click on a Unit opens a context menu with the option “Change xTU count”. If the button “Cancel” is pressed, all actions in the Zone Editor window will be ignored. By pressing “close” modifications are saved. After the altered configuration is exported, it will be saved in the configuration file and will become active in the roomview; otherwise all modifications will be lost after the roomview designer is closed. The Roomview in “Remote Maintenance” will now show the CAM’s and xTUs according to the altered configuration file. From the treeview it is possible to edit or delete each zone. This means that when a zone item in the tree is clicked with the right mouse button, the following context menu opens up. 27 | P a g e Flexgateway Guide (Flexvisor) 2015 Figure 33 - Context Menu for Zone “Designer” opens the Zone Editor window. With “Edit” it is possible to change the name of a Zone and “Delete” deletes the Zone and all its CAM units and xTU’s. It is also possible to delete single units in the same way, selecting a unit and clicking the right mouse button in the treeview opens another context menu: Figure 34 – Context Menu for Unit With “Delete” it is possible to delete a unit and all its xTU’s. Single xTU’s cannot be created or deleted. 28 | P a g e Flexgateway Guide (Flexvisor) 2015 Appendix A Quick Guide: New Floor Creation Guide (roomview designer) To access flexvisor, type the IP address, “XX.XX.XX.XXX” (without “ ”) and press enter. When prompted, input- username: expert // password: expert and submit. To access roomview designer, click the “roomview designer” tab. To create a new floor / building / zone, click roomview Designer. “Create new zone”. You will be prompted to include a zone name, enter a desired name and click “Execute” (apply / accept). The newly created room will now be automatically opened in “designer” mode where it can be edited. To import a floor layout, click “load background image”. Click “choose background image” and then select the desired image and then click “open”. To create a new CAM unit with fantile units click “create a new unit” (CAM unit?). There will be a prompt asking for a “Unit name” (CAM unit), “Unit ID” (CAM ID), and “xTU count”. (Note: currently it is advised to keep the number of xTU units as 24 and hide the unused xTU boxes at the bottom of the screen. These can be used at later time when there is an increase in the amount of fantiles). Click “Execute” to accept the changes. “Cancel” cancels all of the work done and closes the floor design without saving. “Close” saves and closes the current progress. The CAM unit is coloured in yellow and the ID is displayed under its name, fantile units are noted in green with “xtu_# / abc” (where # = xtu number and abc = CAM name) The boxes can now be moved around and positioned to where ever they are required (note: when fantiles are moved around on floor, the boxes would have to be adjusted manually to mirror the new placements) Right click the Floor name to be able to edit the name of the zone. Click “Execute” to accept the changes Right click individual CAM unit to be able to edit the “unit name” “unit ID” and “xTU count” (note: xTU count will not adjust in this menu. If the selected number was any other when the unit was created eg.20, the roomview designer menu will show 20 xTU units, but the roomview in remote maintenance will show all 24 units still.) To delete individual CAM / zone, right click the desired item and left click the delete option. “Export configuration file” save the current configuration “Empty configuration” delete/clear current configuration “Import template” imports a previously saved default “Import existing configuration file” imports the most recently saved configuration file. 29 | P a g e Distributed in the UK by