The Space Dashboard is the second tab in the Dashboard App. The user can navigate here by clicking the tab or clicking in the whitespace of the Current Space Summary Card on the Overview Dashboard.
Once in the Space Dashboard, the user can select which Space to view using the drop-down.
The Space Dashboard contains several cards pertaining to the selected Space:
Shows details for the space – it's Design ACH, which AHU serves it, and the Volume of the Space. These details can be configured in the Space Configuration tab of the System Config App or by clicking the link in the card.
Shows the percentage of the time running at less than the Design ACH.
Shows the calculated kWh saved using the Space Volume, Actual ACH, Demand ACH, AHU Efficiencies, Actual Temperatures, and Temperature Setpoints. It is the energy saved by not cooling and re-heating outside air into the Space.
Shows the kWh saved converted to Tons CO2 Equivalent
Shows details about the Fume Hoods assigned to this Space. Each Fume Hood shows up as an entry and can be expanded to show more information. Fume Hoods can be added/removed through the BACnet Configuration Page by clicking the link.
Shows the Actual Temperature and Setpoints assigned to this Space. Temperature and Setpoints can be added/removed through the BACnet Configuration Page by clicking the link.
Shows the IAQ Parameters associated with this Space and their contamination percentage. The IAQ Parameters shown depend on the physical sensors ordered and present in the Sensor Pack. Percent Contamination is calculated based on the IAQ Setpoints configured in the Setpoints Configuration Page by clicking the link.
The Current IAQ value is the worst of all the contributing parameters and provides an at-a-glance feel for how the Space is performing.
The IAQ Contributors section shows how many, what contamination percentage, and actual value of each IAQ Parameter that is measured and greater than the Low Setpoint.
Any IAQ Parameters that either don’t have Setpoints configured or are calculated to be 0% are shown in the Other/Non-Contributors section.
Clicking on the Chart Icon in the upper-right corner will bring the user to the Demand History chart for this Space.
Shows a summary of all the airflow in and out of the Space and calculates the Ventilation Difference. Each value comes from a BACnet Point which can be added/removed through the BACnet Configuration page by clicking the link.
The Current ACH value shows the instantaneous ACH value, either from BACnet or calculated using the Space Volume and total Supply CFM.
Supply Valves shows the individual and total supply CFM, General Exhaust Valves shows the individual and total exhaust CFM, Fume Hood Exhausts shows the individual and total Fume Hood Exhaust CFM and Ventilation Difference is the total Supply CFM minus the sum of the General Exhausts and Fume Hood Exhausts.
Clicking the Chart Icon in the upper-right corner brings the user to the Demand History charts for this Space.
The Reduced Emissions Dashboard is the third tab in the Dashboard App. The user can navigate here by clicking the tab header, or by clicking the Reduced Emissions Card on the Overview Dashboard or the Space Dashboard.
In the Reduced Emissions Dashboard, the Historical Demand Summaries section is identical to the top row of cards in the Overview Dashboard. The 3 cards are the summaries across all Spaces for the selected Time Span:
Time At Low Demand
Shows the percentage of the time running at less than the Design ACH.
Reduced Emissions
Shows the calculated kWh saved using the Space Volume, Actual ACH, Demand ACH, AHU Efficiencies, Actual Temperatures, and Temperature Setpoints. It is the energy saved by not cooling and re-heating outside air into the Space.
Emissions Reduced Equivalent
Shows the kWh saved converted to Tons CO2 Equivalent
The bottom two-thirds of the page contain a Reduced Emissions Summary Card for each Space.
Each Space Summary Card contains information relating to the energy saved while not running at Design ACH.
The primary value is an at-a-glance percentage at which this Space is running below the Design ACH over the selected date span.
The Energy Saved section totals the Fan and Conditioning energy saved over the selected date span based on the parameters and configurations shown in the Parameters section.
The Instant Savings section shows the instantaneous or current savings and some of the parameters used to calculate the savings (the calculations also use the parameters and configurations shown in the Parameters section).
The Fan Savings uses the Current ACH and the Fan System Efficiency to calculate the savings. If the Current ACH is at or above the Design ACH, no savings are realized.
Similarly, the Conditioning Savings uses the Current ACH along with the Space Temperature Setpoint, the AHU Supply Setpoint, the Outdoor Temperature, and the Cooling/Heating Efficiencies to calculate the savings. If the Current ACH is at or above the Design ACH, no savings are realized.
The Parameters section shows the static parameters and configurations used to calculate the savings. These parameters can be modified in the Energy Savings configurator in the System Config App by clicking the link in the card.
The Contaminant History is the fourth tab in the Dashboard App. The user can navigate here by clicking the tab header.
Contaminant History allows the user to see historical trends in an easy-to-use format.
Initially this page is blank, waiting for the user to select a contaminant to view from the drop-down menu. The listed contaminants are the IAQ parameters ordered and present in the Sensor Pack.
The user may also select the date span for the data.
The user may change the options, which includes:
Rollup: performs the Fold function such that there’s one data point for each Interval.
Limit: the maximum number of points to show. Too high a number could cause slowdowns, while too low a number could prevent all points from showing.
Timeout: prevents the browser from hanging if too much data is requested.
Once a selection is made for the contaminant, date span, and options, the chart will populate with the data points. Each Space has a trend line making it easy to match it to the data. Clicking on a Space name at the top will hide that trend line in the chart.
The chart is interactive. The user can hover around to get the date/time and value under the cursor. Clicking will show a dialog that contains the date/time and the values for all the Spaces at that date/time. The top row of buttons on this dialog are discussed in the Chart Customization Documentation.
The Demand History is the fifth tab in the Dashboard App. There are a few ways for the user to navigate here, each showing a different set of points.
Clicking the Chart Icon in the upper-right corner of a Space Card in the Overview Dashboard - shows all the values/histories
Clicking the Chart Icon in the upper-right corner of the IAQ Card in the Space Dashboard – shows only the IAQ values/histories
Clicking the Chart Icon in the upper-right corner of the ACH Card in the Space Dashboard – shows only the ACH related values/histories (Space Supply/Exhaust, Fume Hood Exhausts, Space and Fume Hood Occupancies, and Fume Hood Sash Positions)
Clicking on the tab header directly – shows all the values/histories
If the user clicks on the tab header directly, the page may be empty waiting for the user to select the Space at the top of the page.
The user may also select the date span for the data.
The user may change the options, which includes:
Rollup: performs the Fold function such that there’s one data point for each Interval.
Limit: the maximum number of points to show. Too high a number could cause slowdowns, while too low a number could prevent all points from showing.
Timeout: prevents the browser from hanging if too much data is requested.
The page is split into sections of charts grouped together by function. The sections may be hidden depending on the context (derived from how the user got here – see the introduction).
The ACH Section provides an at-a-glance view of how the ventilation is performing over the selected Date/Time Span.
ACH Trend: either the exact value from the ACH BACnet Point, or a computed history based on the Space Volume and Supply Valves BACnet points if configured.
Contaminant Runtime Trends: these trends show up if there’s been a contaminant event within the selected Date/Time Span. They show the period in which that particular contaminant has exceeded the Low Setpoint.
Space Occupancy: shows the periods when the Space Occupancy BACnet point indicates occupancy if configured.
Supply Valves: shows the values (in cfm) from each Supply Valve BACnet point if configured.
Exhaust Valves: shows the values (in cfm) from each Exhaust Valve BACnet point if configured.
The Fume Hoods section shows an at-a-glance view of how the Fume Hoods within the Space are performing.
Occupancies: shows periods in which the Occupancy BACnet points if configured.
Exhaust, Face Velocity, and Sash Position: shows each of these values in one chart for each Fume Hood. These values come directly from the associated BACnet point if configured.
The IAQ section shows an at-a-glance view of how the Space is performing in terms of contaminant exposure. Each IAQ Parameter purchased and present in the Sensor Pack has history recorded here. If the Parameter has a Setpoint configured, it will show as a black line on the chart for that Parameter.
Spaces can be configured in the System Config app.
Space configuration shows a complete list of spaces. The following columns are present:
Name: A human readable space name.
Enabled: Set if the space should be analyzed.
Contamination Reference: Set if the space is a clean air reference. The system will use the source as a baseline. Only one contamination reference can be set per monitoring controller.
Panel Sources: A list of all channels in the panel which sample from the space. This field is read-only.
Volume: The volume of the space.
Design ACH: The design ACH of the space in unknown air. If the air is known to be clean, the ACH may be reduced.
AHU Reference: The AHU supplying the space. AHUs are created in the BACnet configuration tab
BACnet Instance Start: Each space contains several BACnet objects given at standard offsets from the BACnet Instance Start. BACnet Instance Start must be a multiple of 100. For example, if the BACnet Instance Start for a space is 400, the CO2 will have an object instance of 401, and the dew point will have an object instance of 403.
To Edit space configuration, highlight one or more space rows, and click the ‘Edit’ button
In some cases, there are multiple channels (faceplates or duct probes) in the same space. Initially, the system ships with one space per channel. To merge the spaces together:
Select multiple spaces (by holding ctrl, command, or shift while clicking multiple spaces).
Click the merge button in the action row.
The “New Space” dialog will open. Add a name for the new space. All other fields will be autogenerated based on the input spaces, edit them as desired
Click OK
Undo the Merge operation. Select a single space with multiple input channels. Note that all data associated with the space, such as Volume or BACnet points will be associated with only one of the split spaces.
Setpoints can be configured in the System Config app.
Setpoint configuration shows a list of spaces with associated setpoints. Each tracked contaminant will have a low and high threshold. At the low threshold and below, the contamination percentage will be 0%. The contamination percentage increases linearly to the high limit, where it will be 100%.
To edit setpoints, highlight one or more space rows, and click the ‘Edit’ button.
The BACnet tab in the System Config App allows the user to add and configure various BACnet points that are used in the dashboard and in calculating energy savings.
The BACnet Network button brings up a dialog in which the user can configure the BACnet Network, including Network Type (MS/TP or IP). Depending on Network Type, different fields are available.
For BACnet/IP, the Front and Back network connections can be configured via the Network Tab
(see System Config - Network documentation)
Network Type: IP or MS/TP
Device Name: The Name property of the Device object
Device Instance: The Instance number of the Device object
APDU Timeout: The amount of time in milliseconds between retransmissions of an APDU requiring acknowledgment for which no acknowledgment has been received
APDU Retries: The maximum number of times that an APDU shall be retransmitted
Connection: The specific RJ-45 network jack of the AntrumX Gateway (Front or Back)
Port: The UDP port, defaults to 47808 (0xBAC0)
BBMD Address: The address of the BBMD with which to register as a foreign device.
BBMD Port: The UDP port of the BBMD with which to register as a foreign device.
Baud: Baud rate
MAC: MAC address
Max Master: The highest allowable address for master nodes
Max Info Frame: The maximum number of information frames to send before passing the token
This page will likely start out blank, with no BACnet Points. The user will click on this button to add a new BACnet Point (or use Import, described later).
The user would first select the BACnet Point Type then fill out the rest of the fields. Note, depending on the Point Type, different fields may be shown.
Point Types:
ACH: Air Changes Per Hour, this point will be the current value for ACH of the Space
AHU Outside Temp: the actual outside temperature, at or near where the AHU draws in outside air
AHU Temp Setpoint: the temperature setpoint of the AHU, prior to the air being re-heated for a Space
Exhaust Flow: the air being removed from the Space in CFM, can have one or more of these points per Space
Fume Hood Exhaust Flow: the air being removed from this Fume Hood (in CFM), can only have one per Fume Hood
Fume Hood Occupancy: the occupancy status for this Fume Hood, can only have one per Fume Hood
Fume Hood Sash Position: the sash position for this Fume Hood (in % open), can only have one per Fume Hood
Fume Hood Face Velocity: the velocity of air passing through the sash opening (in feet/min), can only have one per Fume Hood
Occupancy: the occupancy status of the Space, can only have one per Space
Supply Flow: the flow of the air entering the Space (in CFM), can have one or more per Space
Space Temp: the current/actual temperature of this Space
Space Temp Setpoint: the temperature setpoint for this Space
If an AHU prefixed Type is selected, the user would either select an existing AHU to apply this point to, or type in the name of a new AHU. Since AHU points exist outside of the Space, the Space selection is not available.
If a Fume Hood prefixed Type is selected, the user would either select an existing Fume Hood to apply this point to, or type in the name of a new Fume Hood. Fume Hoods do exist within the Space, so the Space selection is required.
Occupancy Point Types have an additional Invert Raw Value field. When checked this inverts the value into an occupancy state. See the table below for examples.
|
Raw Value |
Occupancy (Invert Raw Value unchecked) |
Occupancy (Invert Raw Value checked) |
|
0 |
Unoccupied |
Occupied |
|
1+ |
Occupied |
Unoccupied |
The Enable History checkbox allows the user to choose which BACnet Points store history, which is useful for viewing past trends or tracking historical energy savings but requires availability in the Points License (which can be expanded). This is further discussed in the History section below.
Each Space/Fume Hood/AHU, Name, and Type combination must be unique. For instance, Space 307 must have only one Supply Point named Supply_1. The user may add another Supply Point to Space 307, but must name it a different name.
Fume Hood and ACH Points are required to be unique regardless of name. For example, FumeHood 307A may only have one Exhaust Flow Point.
If there is a conflict, the dialog will alert the user with a red Info Icon near the Type field.
The Edit button allows the user to edit the selected BACnet Point. The same dialog as the New BACnet Point dialog is used, with all the fields populated. Any field can be changed, with the same descriptions as above.
The Import button allows the user to batch import BACnet points using a CSV file. The import csv file format is somewhat rigid in it’s requirements, it must have the following columns exactly as shown:
spaceName: the name of the space associated with this BACnet Point, can be omitted for AHU Points only.
equipName: the name of the AHU or Fume Hood, as such it’s required for AHU and Fume Hood Points, omitted for all others.
name: the name of the BACnet Point, required.
type: the type of the BACnet Point, required and must be one of the items in the Type drop-down in the editor dialog: ACH, AHU Outside Temp, AHU Temp Setpoint, Exhaust Flow, Fume Hood Exhaust Flow, Fume Hood Occupancy, Fume Hood Sash Position, Fume Hood Face Velocity, Occupancy, Supply Flow, Space Temp, Space Temp Setpoint.
devInst: the BACnet device instance of the Point, required.
objInst: the BACnet object instance of the Point, required.
objType: the BACnet object type, one of: Analog Value, required and must be one of the items in the Object Type drop-down in the editor dialog: Analog Input, Analog Value, Binary Input, Binary Value.
rawInverted: place an ‘x’ in this field if the value is to be inverted based on the logic described in the Occupancy Point Type section, this is optional and only valid for Occupancy Point Types.
Here’s an example csv:
spaceName,equipName,name,type,devInst,objType,objInst,rawInverted
307,FumeHood 307A,Exhaust Flow,Fume Hood Exhaust Flow,31002,Analog Value,7,
307,FumeHood 307A,Occupancy,Fume Hood Occupancy,31002,Binary Value,0,x
307,,Temp,Space Temp,31001,Analog Value,1003,
307,,Temp Setpoint,Space Temp Setpoint,31001,Analog Value,1087,
The Enable History button allows the user to choose to save recorded history for the selected BACnet Point(s). History can be disabled for a BACnet Point by selecting the Point, clicking the Edit button, deselecting the Enable History checkbox, and clicking OK.
History for BACnet Points counts against the pool of points allocated by the license. This pool can be increased by purchasing an expansion license from Antrum.
History is used in various Cards and Charts in the Dashboard App, and allows the user to take full advantage of the AntrumEYE product, including seeing the energy savings allowed by AntrumEye. The minimum Points recommended for this Dashboard experience are: ACH or Exhaust and a configured Volume for each Space, Space Temp Setpoint for each Space, AHU Outside Temp (will fallback to local weather data, however internet connectivity is required), AHU Temp Setpoint. Each Space will have to have an AHU Reference assigned in the Spaces configuration tab of the System Config.
The Trash button allows the user to delete the selected BACnet Point(s). This action can be undone by using the Trash tab of the System Config App (see related documentation).
These 3 fields work together to give the user an idea of the current licensing state. The number of points without history (7) shows the user how many BACnet Points don’t have History enabled. The License Points Pool status (8) shows the user how many Points are remaining in the current License Pool – or said another way: how many more Points can have History enabled given the current license. In the example below, the user has one Point with History enabled, and can enable 5 more before needing to purchase and Upload an Expansion License.
If the user has maxed out the Points Pool, they may expand it using the Upload Expansion License button. Expansion Licenses can be purchased from Antrum, once purchased the license file can be selected using this button.
The Network tab of the System Config App allows the user to configure the network ports and how they connect to the Internet/LAN.
This lists the network parameters for the physical network ports present on the Gateway. The listed Front Connection refers to the physical network port that is the closest to the user, while the listed Back Connection refers to the physical network port that is the furthest from the user while facing the Gateway.
From the factory the Front is setup for a Static IP address and the Back is setup for DHCP, but the user can modify that here.
To edit a network port’s parameters, select the row and click Edit.
This dialog allows the user to configure the following parameters:
Mode: static or dhcp, depending on the selected mode, the rest of the fields may not be editable.
IP Address: if the mode is static, this is the static IP address that will be used for this network port. If it conflicts with the rest of the network (for instance a wrong subnet) in such a way that AntrumEYE is inaccessible, the user may have to factory reset the network parameters. This field is ignored if the Mode is DHCP.
Netmask: this is the standard IP subnet field (also known as the subnet mask), it basically defines the network subnet. This field is ignored if the Mode is DHCP.
Gateway: this defines the IP address of the network router. This field is ignored if the Mode is DHCP.
DNS: allows the user to specify one or more DNS addresses. If setting more than one DNS, use a comma separated list as shown in the screenshot. If the Mode is DHCP, the detected DNS will be added to what the user specifies here.
Prefer for Internet Traffic: check this box if this network port is to be used for internet traffic. This is useful if the user is configuring both ports, one for an isolated BACnet/IP network and the other for Internet/LAN network traffic. When this box is checked, this network is used for the default route.
The information presented is collected from the underlaying operating system. Clicking the Refresh button forces the view to re-collect and display the latest information.
To reset the network configuration to factory defaults, the user must turn power off to the Gateway, press and hold the Reset button on the side of the Gateway while powering on the Gateway, then release the button once the yellow Status LED is lit.
The Energy Savings tab of the System Config App allows the user to specify the heating and cooling efficiencies and the fan system efficiency. These numbers are used when calculating energy savings. Each row shows an AHU which is created through the BACnet Config tab, therefore this page may be empty until the user creates an AHU.
To edit the efficiencies of an AHU, click on the row and click the Edit button.
The Trash view shows BACnet points which have been deleted by a user.
To empty all records from the trash, click the Empty button
To restore the records to the database, select one or more rows and click Restore
The Log Export tab in the Support App allows the user to send detailed logs and data to Antrum for analysis when support is needed.
Click the Export Logs button to select a date span to export.
The export task will begin, as shown in the lower table.
When it completes, an archive will be available to download in the upper table.
Use the Download link in the row to download the archive to send to Antrum.
The archive will remain on the gateway until it is manually deleted using the Delete button.
The Service Life tab in the Support App allows the user the view the service life remaining for each sensor pack. When the service life expires, the sensor pack will not function again until it is calibrated.
This view works best from antrumeye.com, because the sensor packs for all connected panels will be shown.
All charts in AntrumEYE are interactive, allowing the user to tailor the data in a way that makes sense for them. These interactions include zooming, accessing data, downloading images, and customizing the look-and-feel of the charts themselves.
The chart can be zoomed in by a simple click-and-drag operation. Clicking and dragging horizontally will zoom in on the time axis:
Clicking and dragging vertically will zoom in on the value axis:
While zooming on the value axis will zoom only the selected chart, zooming on the time axis will zoom all charts.
Zooming out is done by left-clicking on the chart and clicking the Zoom Out button:
The Context Dialog can be accessed by left clicking in the chart to bring up this dialog, and allows the user to split the view, copy the raw data, download an image of the chart, or customize the chart.
For chart pages that are long enough that the user must scroll vertically to see all the charts, the dialog will show a button called Split. Clicking this button splits the page vertically allowing the user to scroll two halves independently. This can be useful to quickly compare values at the top and values at the bottom. The view may be reset by opening the context dialog again and clicking Unsplit.
The Copy Data As option allows the user to export the data into the clipboard buffer to be pasted into a different application. Clicking the drop-down shows a list of formats that can be exported.
Once a format is selected, a green button appears – click this button to export the data in the selected format into the copy/paste buffer for your Operating System.
The user can now paste the data into a different application.
The user may use the Download drop-down to download an SVG or PNG image of the charts – the result is like taking a screenshot. Once the user selects an image format, the image is downloaded through the browser.
The charts feature a powerful chart customization dialog that allows the user to change formatting, chart type, enabling/disabling/disabling trends, even moving trend lines to different charts. Clicking the Customize button in the context dialog will show a panel on the right-side of the page showing all the charts with all the trends.
Note: as shown in the screenshot, the chart page is made up of chart groups that contain one or more trend lines.
In the Customization Dialog, clicking the name of any trend line will show the formatting dialog where the user can change the trend name, color, stroke, opacity, or exclude the trend from the chart.
Clicking on a chart group header will allow the user to change the plot type, title, subtitle, legend, height, x-axis, and y-axis. These apply to all trends within this chart group.
Clicking on the circle next to the trend line name will enable or disable the trend in the chart group.
Clicking and dragging the hamburger icon on the far-right of a trend line will allow the user to re-order and change the combinations of trend lines within chart groups. For example, dragging the Occupancy into the same chart as the ACH to be viewed together.
At the bottom of the dialog, the user can close the dialog or revert the changes.
In AntrumEYE Apps contain views, which are a collection of visual elements. For instance, the Dashboard App contains 5 Views: Overview Dashboard, Space Dashboard, Reduced Emissions, Contaminant History, and Demand History. Each of these views contains various visual elements that together make up the view.
A View has some control features which are accessible by the 5 buttons on the far-right side of the page, after the tabs.
This button, in the left-half allows the user to see the Views, and the selected View within the App - this is just an alternative navigation method. The second half shows the Copy Link to View links.
The Copy Link to View allows the user to create a link to this View in this exact state, including any selected Date/Time Spans, Chart Formatting, etc.
The next button allows the user to Export this View’s data in various formats.
Cloning the View simply opens this view in a new tab in your browser.
Split View splits the current window horizontally, allowing the user to see two different Views next to each other. This can be useful for viewing a Chart View and a Configuration at the same time. Clicking the X (in the place of the Open Split View button) will close one of the splits and restore single-view mode.
Alerts are the mechanism in which the user is made aware of issues within the AntrumEYE system. When a problem occurs, a yellow banner will appear in the upper-right corner regardless of any App or View being shown. If there’s more than one problem, the banner will show the most recent problem.
The user may click on the banner to bring them to the Alerts View showing them all the active Alerts along with past Alerts that have since been silenced (automatically or manually).
In this View, the user can see some details about the Alert in the more column.
Alerts can come from many sources within the System, and are automatically cleared if that source determines the problem has been resolved. For instance, the controller may issue an Alert for no airflow on a specific channel. If that channel were to start getting airflow again, the controller would automatically silence that alert.
