Operators Manual

Compass
Web Interface
User Guide
COMPASS WEB INTERFACE USER GUIDE
Welcome to Compass
Welcome to Compass, Alerton’s operator workstation software for building automation systems.
Compass is your command and control center for facility operations — from HVAC equipment to irrigation,
lighting, security, and more. Here, you can view and command site equipment and systems with unprecedented
flexibility and power.
© Honeywell LT-UG-CMPSWEB Rev. 03 | Revised May 2015 2

New in Compass
New features and enhancements in this version of Compass include the following.
New features
Feature Description
Localization support: Compass Web User Added localization support for the web user interface for languages that use UTF-8
Interface encoding. Tested languages include: Portuguese, French, UK English, French Canadian/
English, and Spanish. Includes localization of numbers, date, and time formats.
OmniZoom OmniZoom is turned ON by default and can be turned OFF by editing the
system.properties file located in the Compass folder. The setting is
omniZoom={true|false} in {InstallationFolder}\System\Lib\system.properties
Extend solid-color background of displays The extension fills the web user interface content window with the solid-color
and templates background specified for the display or template, eliminating any unfilled gray areas to
the right and below the display or template.
Show/Hide data point tooltips Tooltips that show up when the mouse-pointer hovers over a data point on displays/
templates can now be turned ON and OFF. Default is Hide(OFF) but the user can Show
(ON) the tooltips by clicking a button control located with Login/Logout and Change
Password. This control is only for the current browser tab session. Tooltips are OFF by
default when a new browser session or a new browser tab is opened.
BV points supported in OmniGraphics OmniGraphics can now depict binary states with colors for Active, Inactive, and NULL.
Compass menu now auto-closes The Compass menu in the web user interface now auto-closes when the user clicks
anywhere outside of the menu.
Enhancements
Feature Enhancements
Alarms • User-configured alarm messages display in alarm pop-up

• Alarm Handler recipient defaults include Return-to-Normal events
• System Activity logging of Email/Pager PROCID edits
• Alarm Acknowledge All behavior in pop-up and history
• Display selection in Alarm Configuration
• Formatting errors in Alarm Configuration
• System Activity logging of Alarm Configuration edits

Feature Enhancements
DataViewer/Trendlogs • Units defined in Trendlog setup display correctly in DataViewer

• Trendlog interval setting persistence when editing
• Changing time frame in DataViewer no longer locks up browser
• Companion logs saved when Energy Log is primary log(SQL only)
Schedules • Scheduled Point/Zone Search consistency in sorting and filtering

• Schedule Editor uses Compass Primary Workstation time and date
Workstation • Object Scanner – Network Scan functionality

• Client-Server Authentication ON by default, cannot change
• TLS/SSL (HTTPS) enabled ON by default
• Option to use SQL server certificate
• VisualLogic Installation and Toolkit table formatting
• Compass Startup no longer fails upon initialization
• General System Setup Add-in Report
Wireless Commissioning Reporting Tool • Application button available in the web user interface. The wireless network status
page lists the AZW-5000 devices and Wireless Temperature Sensors (WTS) in your
system and presents real-time data that helps you gauge the effectiveness of the wire-
less network. View live data, view snapshots, and compare data sets side-by-side.
Web User Interface Displays and Dialogs • Improved display performance and BACnet operations
• Support apostrophe character in display items’ custom units
• Can now view array index elements in web user interface
• Display missing object/property values in web user interface
• Context menu on Alerton/Standard zone object template
• Support R/W of gateway strings for BCM-FPCS & BCM-TUX
• All times and dates based on Compass Primary Workstation
SSL ON by Default • SSL is now turned ON in Compass by default(Tools>General System

Setup>Configure SSL)
• For users who buy SSL certificates: On the Configure SSL tab, set the Fully Qualified
Domain Name field to your full domain name to avoid receiving SSL warnings when
you attempt to access Compass. Add your full domain name because the SSL certifi-
cate you bought is bound to your full domain name. For example, add “Compass-
Server.dealername.com” rather than just“CompassServer.”
• Updated SSL information including selecting SSL options and working with SSL
certificates. See the Compass Dealer Guide (LT-DG-CMPSWKSTN1.3) for more
information.

Getting started
The Compass interface is made up of a header, a tool bar, the content display area, and a footer. When displayed
in a web browser, the content will dynamically fill the available screen space. If you prefer static display sizes with
scroll bars, set the omnizoom property to false in the bactalk.ini file (located in the Compass root installation direc-
tory).
Header
The header includes branding information (a dealer logo and/or a customer logo) and the user name or the user
currently logged in.
Tool bar
The tool bar is a set of icons on the left side of the page. Click the icons to navigate data displays, use Compass
tools, and to show or hide controls. Alarms icons on the tool bar show the number of unacknowledged alarms,
acknowledged alarms, and unacknowledged alarms that have returned to normal.
Navigation tree
The navigation tree presents system zones and devices in a graphical tree. You can set up the tree to reflect
system configuration in different views. For example, you could list devices by floors in a building or by network
number.
Access the navigation tree by clicking the Navigation icon in the left navigation panel.
The navigation tree’s appearance is configured by entering data in a spreadsheet file on the Compass
workstation. See the Compass workstation documentation for more information.
Tools menu
The Tools menu gives you access to Compass features such as schedules, trendlogs, and alarms.
NOTE: The Tools menu is only available in a browser launched from a primary workstation.
Access the Tools menu by clicking the Tools icon in the left navigation panel.
Feature buttons
Feature buttons provide quick access to such Compass features as Alarm History, Top Display, DataViewer, and
User Sessions. Open the feature buttons panel by clicking the icon in the left navigation panel.

Alarm notification
Three colored dots represent the number of alarms in three states: active unacknowledged (red), active
acknowledged (yellow), and unacknowledged returned to normal (blue).
Content area
The content area is the main working area where data displays, alarms, and trendlogs are shown. You can
interact with some items on data displays. Tooltips appear when the mouse hovers over an object on the screen.
They can describe the function of objects or present current data for control points.
To increase the viewable area, click the Show/Hide Controls at the bottom of the Tool bar. Click the icon again
to restore the controls.
Three colored dots represent the number of alarms in three states: active unacknowledged (red), active
acknowledged (yellow), and unacknowledged returned to normal (blue).

Printing
You can print a Compass screen by clicking the printer icon at the top left of some screens or by using the browser
Print function.
TASK
1. Click the Print icon or select Print from the browser menu.
2. Check the browser print settings and ensure that printing of background colors and images is turned on.
Some images and colors will not print if this is not enabled.
3. Click Print.

About alarms
Alarms monitor data points in the BACtalk system for conditions you specify, and then generate alarm messages
when one of those conditions is met.
Three components make up a Compass alarm:
• The monitored property, which is the status or value that the alarm watches for an alarm state.
• The alarm setup (in BACnet, technically known as an event-enrollment object), which is saved in a global or
building controller. It watches the monitored point to generate an alarm.
• The alarm handler (in BACnet, technically known as a notification class object), which determines what
operator workstations, pagers, remote sites, and email accounts are notified when an alarm occurs.

Alarm notifications
Compass displays the number of alarms and notifies you when new alarms occur.
NOTE: For notifications to work properly, your web browser must allow pop-ups. Also, in Mozilla Firefox the
Raise or lower windows feature must be enabled. See Firefox documentation for instructions.
Alarm notifications for new alarms

The Alarm Notifications window appears if an alarm occurs when you are working in Compass. It also appears
at start-up if an alarm has occurred since Compass was closed.
Click a column heading to sort the list. Click the heading again to change the sort order (ascending or
descending).
Click Acknowledge or Acknowledge All to acknowledge alarms.
To toggle audio notifications ON or OFF, click the audio icon.
Alarm notifications when working in Compass

When Compass is running in a visible window (not minimized), it indicates active unacknowledged alarms in the
browser title bar and all alarms in the left navigation area.
In the title bar at the top of the browser window the number of active, unacknowledged alarms is shown in
parentheses before the title of the web page. For example, “(1)Compass - Mozilla Firefox” indicates one active
unacknowledged alarm.

Left navigation area - colored dots represent the number of alarms in three states: active unacknowledged (red),
active acknowledged (yellow), and unacknowledged returned to normal (blue). Clicking one of these indicators
opens the Alarm History for that type of alarm.
descending).
Alarm notifications when Compass is minimized

You can configure Compass to notify you of new alarms when it is running in a minimized window. Alarm
notifications will pop up as they occur. Turn notifications on or off by editing your user profile.
When you get a pop-up notification, you can view the current alarm, view other alarms, or cancel the notification.
descending).

Viewing alarm history
Alarm History shows critical information about the alarms that have occurred in your system. You can view all
alarms or specific types of alarms (for example, high limit) for the date range you specify.
Opening alarm history

You can open the Alarm History by:
• Clicking the Alarm History button at on the feature button menu
• Clicking an alarm notification button on the Tools menu
• Clicking
NOTE: Alarm indicators are visible only if you have sufficient user privileges.
Using filter options

Click Filter Options to expand and collapse the filter area. Filter Options lets you select alarms on these criteria:
• Time range
• Alarm status
• Alarm state
• Monitored point (available when Alarm History is opened from a data display context menu)
Select or type the criteria you are using to filter and then click Update.
Viewing alarms
The alarm list shows all current alarms that meet the criteria selected in Filter Options. By default, they are
sorted by the date and time that they occurred. Sort the list by clicking the Date/Time or User column headings.
Navigate to additional pages in the list using the page number icons at the lower right.
NOTE: Alarm indicators are visible only if you have sufficient user privileges.

Creating a new alarm
When working in the web interface on a Compass workstation, you can create new alarms using the context menu.
NOTE: The alarm handler for the new alarm must be created at a Compass workstation before you can create alarms
in the web interface.
TASK
1. From a data display, right-click a point, select Alarms and then click Configure.
STEP RESULT: The Point Alarms window appears.
2. Click Add Alarm.
STEP RESULT: The Add New Alarm - Select Alarm Type dialog box appears.
3. Select the type of alarm (analog or floating limit) you want to create.
4. Select a host device.
5. Select an alarm handler or create one. See Creating an alarm handler.
6. Type an alarm description.
7. If you are creating a floating limit alarm, select the setpoint device, type, and instance. For example,
Production AC Unit, Analog Output, 1.
8. Enter the offsets, deadband, and delay.
9. Select the notifications to send.
10. Type the messages you want to send for High Limit, Low Limit, Off Normal, Fault, and Normal conditions.
11. If you want to include a link in the alarm notification, select Display a link in the alarm message and
then type a URL or select a data display.
12. Click SAVE.

Editing alarms
TASK
1. From a data display, right-click a point and then select Alarms.
STEP RESULT: The Point Alarms window appears.
2. Select an alarm and then click Edit Selected Alarm.
STEP RESULT: The Edit Alarm Configuration dialog box opens.
3. Type a description and select an alarm handler.
4. Change the alarm parameters: High Limit, Low Limit, Deadband, and Delay.
5. Select the notifications to send when an alarm occurs.
6. Type the text for High Limit, Low Limit, Off Normal, Fault, and Normal alarm messages.
7. If you want to include a link, select Display a link in the alarm message.
a To include a URL, select URL and then type the URL.
b To link to a display, select Workstation Display, select Display, and then select a display from the drop-
down list.
c To link to a device template, select Workstation Display, select Template, and then select a template from
the drop-down list.
8. Click SAVE.

Deleting an alarm
TASK
1. Right-click the point.
2. From the context menu, select Alarms and the click Configure.
3. Select the alarm by checking the box at the left.
4. Click Delete Selected Alarm.

Adding an alarm recipient
TASK
1. From a data display, right-click the point you want to add an alarm recipient for.
2. From the context menu, select Alarms and then click Configure. If an alarm has not been created for this
point, you will be prompted to create a new alarm.
3. Select the alarm and then click Edit Selected Alarm.
4. Click Edit.
5. Click the + button at the top of the Recipients area.
6. Select the type of recipient - workstation, email, or pager.
7. Configure a workstation recipient.
Field Description
Workstation Select the workstation you want to receive

the alarm notification.
Log into alarm history Record the alarm in the alarm history log.
Annunciate if... Require a user to acknowledge the alarm.
Print Send the alarm to the primary workstation’s

default printer.
Handled Events Select the events that will trigger an alarm.
Activity Time Period Select the days and times that the recipient
will receive alarm notifications.
8. Configure an email recipient.
Field Description
Email Type a label for the email recipient.
Description Type the text that appears in recipient lists.
Email address Type the email address where the alarm

notification will be sent.
Email through workstation Select the workstation that will process the
email.

9. Configure a pager recipient.
Field Description
Pager Compass generates this value by appending

a unique ID to the description.
Description Type a description for the pager - “Weekend

Pager” for example.
Phone Number Use numbers and spaces. To specify the

baud rate, add a forward slash and the baud
rate at the end of the phone number. For
example, “/2400”. This can help resolve
connection problems.
Alphanumeric Pager When selected, Compass sends an

alphanumeric alarm description to the
pager.
Pager ID Type the pager identifier that the paging

service uses to route the message.
Numeric Message If the page is not alphanumeric, type a

numeric message.
Dial Out Through Select the controller at the local site that will
dial out the alarm. This controller must have
a modem and must have Supports Alerton
Process IDs selected on the Capabilities tab
in Device Manager.

Removing an alarm recipient
Use caution when removing alarm recipients that belong to multiple alarm handlers. Doing so may prevent the
other handler from sending a notification.
TASK
1. Right-click the point you want to remove the alarm from.
2. From the context menu, select Alarms and then click Configure.
3. Select the alarm by clicking the box at the left.
4. Click Edit Selected Alarm.
5. In the Alarm Handler field, click Edit.
6. Select a recipient by clicking it and then click Remove.

About host devices
A host device supervises, stores, and runs automation features (alarms, trendlogs, schedules, and so on).
Once automation features are created in Compass, they are downloaded to a host device where they run locally.
If the connection to the operator workstation is lost, or is temporary in the first place, the host device continues to
run the automation features.
Ascent Control Modules (ACMs), Global controllers (BCMs), and expandable controllers (VLXs) function as host
devices. When selecting a host device, choose the one nearest to the device that hosts the relevant data point.

About alarm handlers
Each alarm in Envision for BACtalk has an alarm handler assigned to it.
The alarm handler determines which devices are notified when an alarm occurs.These devices are called alarm
recipients. Alarm recipients can include one or more of the following:
• An operator workstation
• A pager
• An email account
The alarm handler maintains a list of recipient profiles. Each recipient profile determines the type (off-normal,
fault, normal) of alarm the recipient accepts and the actions the recipient carries out.
When you set up an alarm handler, you can select existing recipient profiles or set up new ones. Once you
create a profile, any alarm handler can use it, and multiple profiles can be set up for a single recipient. Alarm
handlers are saved to the Envision for BACtalk server and to the host device.

Creating an alarm handler
TASK
1. While creating or editing an alarm, open the Alarm Handler drop-down menu.
2. Select Create New Alarm Handler.
3. Type a description. This will appear in lists of alarm handlers.
4. Add recipients.
5. Select whether to require acknowledge for alarms, faults, and return to normal.
6. Click SAVE.

Editing alarm handler configuration
TASK
1. From the Compass primary workstation, right-click the point associated with the alarm.
2. Select Alarms and then click Configure.
3. On the POINT ALARMS page, select the alarm by clicking the check box next to it and then click Edit
Selected Alarm.
4. Click the Edit button next to the Alarm Handler field.
Field Description
Host Device Read-only field that lists the alarm handler.
Description The name shown in lists of alarm handlers.
Recipients The workstation, pagers, and/or email

addresses that will be notified when an
alarm occurs.
Acknowledge Popup Messages The events that must be acknowledged.

Editing an alarm recipient
TASK
2. From the context menu, select Alarms and then click Configure.
3. Select the alarm by clicking the check box next to it.
4. Click Edit Selected Alarm.
5. In the Alarm Handler field, click Edit.
6. Select the recipient by clicking it and then click Edit.
7. Configure a workstation recipient.
Field Description
Workstation Select the workstation you want to receive

the alarm notification.
Log into alarm history Record the alarm in the alarm history log.
Annunciate if... Require a user to acknowledge the alarm.
Print Send the alarm to the primary workstation’s

default printer.
8. Configure an email recipient.
Field Description
Email Type a label for the email recipient.
Description Type the text that appears in recipient lists.
Email address Type the email address where the alarm

notification will be sent.
Email through workstation Select the workstation that will process the
email.

9. Configure a pager recipient.
Field Description
Pager Compass generates this value by appending

a unique ID to the description.
Description Type a description for the pager - “Weekend

Pager” for example.
Phone Number Use numbers and spaces. To specify the

baud rate, add a forward slash and the baud
rate at the end of the phone number. For
example, “/2400”. This can help resolve
connection problems.
Alphanumeric Pager When selected, Compass sends an

alphanumeric alarm description to the
pager.
Pager ID Type the pager identifier that the paging

service uses to route the message.
Numeric Message If the page is not alphanumeric, type a

numeric message.
Dial Out Through Select the controller at the local site that will
dial out the alarm. This controller must have
a modem and must have Supports Alerton
Process IDs selected on the Capabilities tab
in Device Manager.

Schedules
Use schedules to plan building operations based on the time of day, holidays, and special events.
Schedules can control zones and binary objects (ON or OFF) that support the priority-array property. A schedule
set, which you assign to one or more points or zones, consists of three components: work week, holiday, and
event.
• The work week schedule component controls day-to-day operations.
• The holiday schedule component controls days when a facility is typically unoccupied.
• The event schedule component controls time periods outside normal occupied times.
The holiday schedule overrides the work week schedule, and the event schedule overrides the holiday and work
week schedules.
You can view schedules by searching or by using the context menus.

Creating a schedule
The process of creating a new schedule starts from the context menu of the point you want to schedule.
TASK
1. On a graphical display, right-click the point.
2. From the context menu, select Schedules and then click Add Point Schedule or Add Zone Schedule.
3. Select, copy, or create Work Week, Holiday, and Event schedule components.

Editing a schedule time block
When viewing schedules from a Compass workstation, you can make changes to existing time blocks.
TASK
1. When viewing a schedule, click a time block label.
STEP RESULT: The time block editor — Edit Work Week, Edit Event Timeblock, or Edit Holiday Timeblock — appears.
2. Type start and end times.
ADDITIONAL INFORMATION: NOTE: Time formats are configured at the Compass primary workstation. See Compass
workstation Help for details.
3. Select the days that the time block will be effective.
4. Click OK.

Changing schedule components for a point
TASK
2. From the context menu, select Point Schedule.
3. Expand the Selected Schedule Components area.
4. Use the drop-down menus to select or copy schedule components for the point.
STEP RESULT: The selected schedule components are reflected in the schedule display.
5. Click Save Schedule.

Editing the work week
You can add a weekly time block to a schedule using a web browser on a Compass workstation.
TASK
1. Right-click a point and then select Zone Schedule or Point Schedule.
2. Click Edit Work Week or drag the button to the desired time slot.
STEP RESULT: The Set Work Week window appears.
3. Type start and end times.
4. Select the days of the week the time block is effective.
5. Click OK.

Adding a holiday
To set your system OFF for an entire day, add a holiday to the schedule.
TASK
1. From a display, right-click a point and then select Zone Schedule or Point Schedule.
2. Click Add Holiday or drag the button to the desired day.
STEP RESULT: The Add Holiday Timeblock window appears.
3. Click the calendar icon and select a date for the holiday. If the holiday spans multiple days, select Repeat
and then select an end date.
4. Click OK.

Adding an event
You can add events to a schedule using a web browser on a Compass workstation.
TASK
1. Right-click a point and then select Zone Schedule or Point Schedule.
2. Click Add Event or drag the button to the desired time slot.
STEP RESULT: The Add Event Timeblock window appears.
3. Select Command ON or Command OFF.

4. Click the calendar icon and select a date for the event. If the event occurs on multiple days, select Repeat
and then select an end date.
5. Select All Day or type start and end times. Type times in hh:mm AM/PM format: for example, 12:00 PM.
6. Click OK.

Viewing points and zones controlled by a schedule
You can see a list of points and zones that are controlled by a schedule.
TASK
1. From a schedule page, click See controlled points and zones.
2. Click the tabs at the top of the list to see the points and zones controlled by the schedule.

Viewing a list of scheduled points and zones
You can quickly view a list of scheduled points and zones.
TASK
1. From the feature button menu, select SCHEDULE POINTS/ZONES.
2. Type part of an object name or object description and then click Search. To list all scheduled points/
zones, leave the field blank.
3. To view the schedule for a point or zone, select it and then click View Schedule.

Removing a schedule from a point
TASK
2. From the context menu, select Schedules and then click Point Schedule.
3. Expand the Selected Schedule Components area.
4. Click Unschedule Point/Zone.

Setting the work week start time
You can change the start time displayed on the schedule editor. This is useful if your work day starts at a time other
than 8:00 AM.
TASK
1. Open profile.ini in the rep/job folder.
2. In the Schedules section set the DefaultWeeklyTimeblockStartTime entry to the time you want the work
day to begin.
ADDITIONAL INFORMATION: Valid time formats include: 4:00am, 4am, 12:00 p, and 23:00.
3. Wait five minutes or restart Compass.
ADDITIONAL INFORMATION: NOTE: This value is also used to set the scrollbar position in the Week and Day schedule
view.

About DataViewer
DataViewer presents up to ten trendlogs and/or energy logs in an interactive graphical interface. Use it by setting
a date and time, selecting logs, and then viewing the data in the summary and main charts.
Control area
Use the control area to select time frames, select logs, and load data. Once you have selected the data you
want, you can collapse the control area to maximize the space available for the charts.To collapse the control
area, click the arrow on the border between the areas. Click the arrow again to expand the control area.
Set Date/Time
This is where you select the time frame for the data that is retrieved and how much of that data is displayed on
the charts. When the date/time range is set to Current/Current, the DataViewer refreshes data based on the
shortest sample interval of all logs in view.
Select Trendlogs and Energy Logs
You can select up to ten logs to display by clicking the selection button.

Load Data
Once you set a time frame and select the logs you want to view, click Load Data to retrieve data from the
Compass primary workstation. Use Load Data to retrieve fresh data or when you have selected different logs.
Chart area
The chart area is where trendlog data is displayed. It is made up of a summary chart and a main chart.
Summary chart
The summary chart shows data for the entire selected date/time range. It shows only the principal trendlog or
energy log and is less detailed than the main chart.
Main chart
The main chart shows a subset of the data shown on the summary chart. It is more detailed than the summary
chart and can be set to show minimum and maximum values for individual logs.

About trendlogs and energy logs

Trendlogs and energy logs help you troubleshoot problem areas and identify critical operating trends in your
system. For example, you might log the temperature in a room to see if the system is keeping it within desired
setpoints. Energy logs help you analyze energy demand and consumption.
When you set up a log at the Compass operator workstation, you instruct a host device to sample values from a
property at regular intervals. You can log points from a controller other than the device that hosts the trendlog/
energy log, but this will increase network traffic.

Viewing trendlog and energy log data
DataViewer shows data in two charts: the summary chart and the main chart. Trendlog/energy log data is repre-
sented on the charts by colored lines. The amount of data shown on the charts depends on which view you have
selected. Open DataViewer by clicking the feature button in the Feature Button panel.
Using the summary chart

The summary chart shows data for the principal log retrieved from the Compass primary workstation. Only the
principal log is represented on the summary chart.
Use the panning arrows to pan forward and back.
A shaded area on the summary chart indicates the time frame of the data shown in the main chart. You can click
and drag this highlighted area to pan through data.
Using the main chart

The main chart shows a subset of the data shown on the summary chart in greater detail. You can zoom in on
specific areas of the chart and then pan forward and backward through the data. All selected trendlogs are
represented on the main chart
Chart range
The chart range at the top of the main chart shows the beginning and end dates and times for the data shown.
Legend
The chart legend, located below the summary chart, shows the date/time and trendlog values based on the
location of the cursor in the main chart. Log names/descriptions and values are shown in their associated colors.
The legend shows blank values until the cursor moves onto the main chart. Then it shows the date/time and
values as the cursor moves across the chart. Small dots appear on the lines in the main chart to indicate the
date/time being shown.
When the cursor is moved off of the main chart, the legend shows the values that were shown at the time the
cursor was moved off.
Using the tabular view

Click View as Table to display log data in tabular view. The table shows one column for the time stamp and one
column for each selected log. You can add or remove logs.

Click a column heading to sort the data. Click the column heading again to change the sort order (ascending
versus descending).
Click View as Graph to switch to graphical view.

Setting the time frame
Use the Time Frame area to set the date and time range for data to be retrieved and displayed. The range is shown
just above the main chart. The view you select determines the beginning time for the range of data retrieved from
the primary workstation.
Set to Current Date/Time
This button sets the End Date and End Time to the present date/time on the Compass primary workstation and
then retrieves data based on the view and trendlogs or energy logs selected. When the date/time range is set to
the current date and time, the fields read “Current”. When displaying the current date and time, DataViewer will
automatically refresh data based on the shortest sample interval of all logs in the viewer.
Select Date and Time
You can accept the default date and time or specify a different date and/or time.
To specify a date and/or time
1) Use the date picker or type the date of the latest data you want to retrieve from the primary workstation.
2) Type an end time and then select AM or PM.
3) Click Load Data.

Selecting logs to view
Select a primary trendlog/energy log and, optionally, companion logs to show in the charts. Logs for which the user
does not have sufficient privileges are not listed.
Primary log
The primary trendlog/energy log will appear in the summary chart and the main chart.
TASK
1. Click the DataViewer icon in the footer.
STEP RESULT: The Log Selection dialog box appears.
NOTE: You can also open DataViewer from context menus, but you cannot edit the primary log if you do so.
2. (Optional) Adjust the value of the Max Logs to Display field.
3. Type part of a log name or description and then click Search. Leave this field blank to retrieve all logs.
4. If the search returns more logs than the number set in the Max Logs to Display field, a message appears.
Refine your search criteria or increase the value in the Max Logs to Display field.
5. If you are using a touchscreen device, tap the selector arrow to display the list of logs. Select a log and
then click OK.
6. Viewer retrieves data for the selected log and displays it in the charts. If the prim
Companion logs
Companion trendlogs and energy logs appear only in the main chart and can be toggled ON or OFF. Companion
logs are associated with a primary log only for the duration of the DataViewer session unless you save the
selection.
TASK
1. Click the selection button.
2. Type part of a log name or description and then click Search. You can search without typing search
criteria, but this will return all logs and the list might be large. If the search returns more logs than the
number set in the Max Logs to Display field, a message appears. Refine your search criteria or increase
the Max Logs to Display value.
3. If you are using a touchscreen device, tap the selector arrow to display the list of logs. Select a log and
then click OK. To add additional companion logs, click the selection button and either select a log from
the list or perform another search.
4. Click Load Data. DataViewer retrieves data for the selected log(s) and displays it in the main chart.
5. To remove a companion log from the main chart, clear the selection check box next to it.
ADDITIONAL INFORMATION: NOTE: Companion log selections are retained when you exit DataViewer. The next time
you open the primary log, the companion logs will also open.

Changing colors
TASK
1. Click the colored button to the left of the log name. The Color Selection dialog box appears.
2. Select a color and then click OK.
3. Click Load Data.
Secondary Y-axis
If a companion log is measured on a scale or in units different from the primary log, you can display the
companion log data on a secondary Y-axis.
The secondary Y-axis appears on the right side of the main chart.To show a secondary Y-axis, select the 2nd Y
Axis check box to the right of the log description and then click Load Data. When data for a log is shown on the
secondary Y-axis, a corresponding color swatch appears next to the axis. This helps you know which axis a log
is shown on.

Panning and zooming
Navigate the data by panning through the summary and main charts and by zooming in on the main chart.
Panning
Use the panning arrows to move backward and forward through the data. The panning buttons on the main chart
will only be enabled when the main chart is zoomed in. You can also pan through data by clicking the shaded
area in the summary chart and dragging it left or right.
Main chart panning
You can only pan across the main chart after you have zoomed in.When you click a panning arrow next to the
main chart, DataViewer moves the selected data by 25% of the selected date/time range. Selected data is
shown as a shaded area in the summary chart. When you are zoomed in, the date/time range shown in the main
chart is represented as a darker shaded area within the shaded area on the summary chart.
Summary chart panning
When you click a panning arrow next to the summary chart, DataViewer moves the selected date/time range
according to the view you have selected. Compass updates the Date and Time fields to indicate the date/time
range being viewed. When you pan left across the summary chart, the date/time range is updated and auto
refresh is disabled. When you pan to the far right of the summary chart, Compass sets the date/time range to
current/current and enables auto refresh.
If you are in this view: DataViewer shifts:
2-Hour 10 minutes
Day 2 hours
Week One day

If you are in this view: DataViewer shifts:
Month One week
Zooming
Select a subset of data to view by clicking and dragging in the main chart. The main chart will refresh to show the
range of data selected. The axis labels on the chart will reflect the values of the zoomed view.
Horizontal zooming
Zoom in on a date/time range by clicking and dragging in the main chart to define a new date/time range.When
you zoom in horizontally, the summary chart shows the zoomed-in time frame as a dark area in the context of the
currently selected view.You can zoom in multiple times. To return to the original view, double-click the main chart
or click the zoom out icon.
On a touchscreen device, use standard touchscreen actions to zoom.
Vertical zooming
Zoom in on a subset of data by clicking the desired starting point and dragging your mouse up or down to the
desired end point.You can zoom in multiple times. To return to the original view, double-click the main chart or
click the zoom out icon. On a touchscreen device, use standard touchscreen actions to zoom.

Creating a trendlog
TASK
1. From a data display, right-click the point you want to log.
2. From the context menu, select DataViewer and then click Add Trendlog.
3. Accept or change the default trendlog configuration settings. The trendlog handler and trendlog
instance are generated and assigned automatically when you save the trendlog.

Create Trendlog dialog box
Create and configure a new trendlog.
Field Description
Log Description The text that appears in lists of trendlogs. Use a consistent naming convention for all
trendlogs.
Run Trendlogs Indefinitely Clear this check box to select a time frame for the trendlog. Clear it to enter start and
end times for the trendlog.
Trend Interval The number of seconds between samples. If the monitored point is not on the host
device, then the minimum interval is 5 seconds. If the monitored point is on the host
device, then the minimum interval is 1.
Notification Threshold The number of samples to collect before notifying the trendlog handler.
Buffer Size The amount of disc space to set aside for this trendlog.
Display Settings — Units The text that appears after the value (degrees, watts, or hours, for example).
Display Settings — Decimal Places The number of digits shown after the decimal point.
Host Information (read only) The device where the trendlog data will be stored, the device that will route trendlog
notifications, and the trendlog instance assigned by Compass.
Archive Settings — Auto Archive Period Sets how often trendlog data is archived.
Archive Settings — Replace previously Replaces (in the case of csv files) or appends (in the case of mdb files) the data from the
archived logs from the same period same time period.
Archive Settings — Remove all but the most Purges old data and defines how many periods to retain.
recent x periods from the log when
archiving
Archive Settings — Archive all entries in log Archives all data in the database, not just data from the period selected in Archive
when archiving period.
Archive Settings — Archive formats Sets the format of the archive file. You can select both formats.
Database Settings — Samples The maximum number of samples to store in the database. The oldest samples will be
deleted as new samples are added.
Database Settings — Compress database Stores only samples that are different from the previous sample. This helps minimize
samples the size of the database. Samples gathered before this feature is activated will be
unaffected.

Viewing trendlog configuration
TASK
2. On the context menu, select DataViewer and then click Edit Trendlog.

Editing a trendlog
TASK

Edit Trendlog dialog box
Descriptions of the fields on the Edit Trendlog dialog box.
Field Description
Log Description The text that appears in lists of trendlogs. Use a consistent naming convention for all
trendlogs.
Run Trendlogs Indefinitely Clear this check box to select a time frame for the trendlog. Clear it to enter start and
end times for the trendlog.
Trend Interval The number of seconds between samples. If the monitored point and the is not on the
host device, then the minimum interval is 5 seconds. If the monitored point is on the
host device, then the minimum interval is 1.
Notification Threshold The number of samples to collect before notifying the trendlog handler.
Buffer Size The amount of disc space to set aside for this trendlog.
Display Settings — Units The text that appears after the value (degrees, watts, or hours, for example).
Display Settings — Decimal Places The number of digits shown after the decimal point.
Host Information (read only) The device where the trendlog data will be stored, the device that will route trendlog
notifications, and the trendlog instance assigned by Compass.
Archive Settings — Auto Archive Period Sets how often trendlog data is archived.
Archive Settings — Replace previously Replaces (in the case of csv files) or appends (in the case of mdb files) the data from the
archived logs from the same period same time period.
Archive Settings — Remove all but the most Purges old data and defines how many periods to retain.
recent x periods from the log when
archiving
Archive Settings — Archive all entries in log Archives all data in the database, not just data from the period selected in Archive
when archiving period.
Archive Settings — Archive formats Sets the format of the archive file. You can select both formats.
Database Settings — Samples The maximum number of samples to store in the database. The oldest samples will be
deleted as new samples are added.
Database Settings — Compress database Stores only samples that are different from the previous sample. This helps minimize
samples the size of the database. Samples gathered before this feature is activated will be
unaffected.

Deleting a trendlog
TASK
1. From a data display, right-click the point associated with the trendlog you want to delete.
3. Click Delete.

DataViewer tools
Use the tools above the main chart to enable or disable min/max values, copy a URL, enable or disable tool tips and
to export data.
Show Min-Max Values

The line that represents trendlog/energy log data on the main chart is an average value. When Show Min-Max
Values is selected, the minimum and maximum values are displayed as shadows below and above the log’s line
in the main chart. This is not selected by default.
Copy URL to Clipboard

If you want to link to a particular view or embed a view in a graphic display, copy the URL to your computer's
clipboard. Then paste it into an email, embed it on a graphic display, or paste the URL into a web browser and
bookmark it.
On devices with pointer, click the Copy URL icon, ensure the URL is highlighted, and then click OK.
On touchscreen devices, tap the URL icon, long press the edit field, and then tap Copy.
Export log data

If you want to view log data in another program, you can export the data to a comma separated value (CSV) file
that can be edited in a spreadsheet application such as Microsoft Excel. Select the logs and time frame you want

to export and then click the export icon.
If you select a large data set that will take a long time to export, Compass asks you to confirm the operation. To
reduce the time required to export data, select a view that will return less data.
NOTE: The Export function is not available on touchscreen devices.
Toggle tool tips

Tool tips appear in pop-up boxes when you hover over a control. This feature is off by default. Click the icon to
enable tool tips.

For touchscreen users
When viewed on a touchscreen device, the DataViewer interface has a few differences from the PC interface:
• No tooltips: Tooltips are not supported on touchscreen devices.
• No data export: data export is not supported on mobile devices.

About data displays and templates

Data displays give general system information and help users navigate to other displays and templates.
Data displays can present specific operating data from a device. This job is typically left to device templates and
object templates, primarily as a matter of saving work. Why create 50 separate displays for similar devices when
you can do the same job with a single device template?
Device templates are powerful because a single device template can present operating data from any number of
similar BACnet devices.
Object templates are similar to device templates. Use them when you want to view the same properties in any
number of objects.

Editing displays and templates

If you started the Compass web interface from a workstation, you can initiate an editing session for the display
you are currently viewing.
TASK
1. Open the display you want to edit.
2. From the Tools menu, click Edit Current Display.
3. Use the Data Display Editor to create or change displays and templates. For detailed instructions on
editing displays, see the Display Developer’s Guide or, from the Data Display Editor Help menu, click Edit
Mode Help.

Changing data on displays
While viewing a data display, you can change current values. Changing values requires sufficient user privileges.
TASK
1. Use the cursor to select the point value.
2. Type a new value and then press Enter.
STEP RESULT: The Change Notes window may appear. Requiring change notes is set in General System Setup on the
Compass primary workstation.
3. Type the reason for the change. The comment will be logged in the User Activity Log.
ADDITIONAL INFORMATION: NOTE: If you change a schedule point description, the new description will not appear in
search results until you restart Compass or manually rebuild the search index from the primary workstation.

About the navigation tree
The navigation tree is the primary navigation tool in the Compass web interface. It appears at the left of the display
area and gives users a road map of the system.
The navigation tree is created by editing spreadsheet files located in the config/navtree folder of the rep/job. A
template file (navtree.xslx) is included as part of the Compass installation.
To control access to the system, you can create trees for specific users and groups. User- and group-specific
trees are appended to the standard tree.
Compass loads the navigation tree on startup, so when you edit one you must restart Compass before the
changes are visible in the interface.
Pinning the navigation tree

Clicking the pin icon in the upper right corner of the navigation tree will cause it to remain visible while you work
in the display area. The display area will automatically be resized to accommodate the tree.

Creating a navigation tree
The navigation tree appears at the left of data displays and templates. It provides a visual aid for navigating your
system. You create navigation trees by placing a spreadsheet file in a navtree folder on the primary workstation.
You open the navigation tree by clicking the navigation tree icon in the left tool bar.
TASK
1. Use a spreadsheet program to open NavTree.xlsx. The file is located in the navtree folder in the rep/job
(typically C:\Alerton\Compass\<version>\<rep>\<job>\config\navtree\).
2. Type labels in the Node Label column. Use descriptive terms like “Admin Building”, “Floor 1”, and so on.
Do not use dollar signs ($) in node labels. Ensure node names are unique at any given level (do not create
two “Room 110” entries on “Floor 1”, for example).
3. Type backslashes (\) in front of the node labels to assign hierarchy. A label with no backslash is a first-level
node; a single backslash indicates a second-level node; two slashes indicate a third-level node; and so on.
Each backslash will cause the node label to be indented on the navigation tree.
4. In the Target Display column, type the file names of the displays or templates that will open when a user
clicks the node. Add paths for files that are not in the current <rep>/<job>/displays folder.
ADDITIONAL INFORMATION: Leaving this field blank makes the node a text-only label; nothing happens when a user
clicks it.
5. For nodes that target templates, type device instances in the Device Instance column. When a user clicks
the node, the template opens with data from the specified device.
6. Type a User Security level (0 to 10) for each node. A user must have security privileges equal to or greater
than this value to open the node. For information about security levels, see the Compass Installation and
Operation Guide.
Creating user- and group-specific navigation trees
TASK
1. Open navtree.xlsx and save it with a filename in the format navtree-<user ID or group ID>.xlsx. For example
to create a custom navigation tree for the Technicians group, you would save the file as navtree-techni-
cians.xlsx. File names are not case sensitive.
2. Edit the spreadsheet entries to create the custom navigation.
STEP RESULT: Next time Compass starts up, it will add the user- and group-specific navigation trees to the standard
navigation tree based on user ID. The user-specific tree is at the top, then the tree(s) for any groups that the user
belongs to, and then the standard navigation tree.

Troubleshooting navigation trees
Check that the spreadsheet program has not converted a node entry to a URL. URLs in the spreadsheet may
cause the navigation tree to malfunction.
Check the navtree.log log file for error messages. The log is created when Compass imports the spreadsheet(s)
and is located in the <rep/job>/config folder.

About system tools

Use system tools to perform administrative functions such as changing passwords, viewing system activity, and
managing user sessions.

Changing your password
Changing your password regularly helps ensure system security. Passwords are case sensitive and cannot be longer
than 20 alphanumeric characters. Use robust password policies to ensure data and systems are protected.
TASK
1. Click your user ID in the upper right corner of the screen, and then select Change Password.
2. Type your current password.
3. Type your new password twice.
STEP RESULT: Compass validates your password as you type and displays a green check mark next to the field when
the password meets requirements.
4. Click SAVE.

Viewing system activity

The System Activity monitor shows events that happen in the Compass system. It shows what has changed,
when it changed, and who changed it. It also shows user comments if any were entered.
TASK
1. Open the Feature Dashboard by
• Clicking the Feature Dashboard icon in the left navigation pane and then clicking SYSTEM ACTIVITY.
• Selecting System Activity from a context menu on a display.
STEP RESULT: The system monitor lists the most recent events. If you opened the monitor from a context menu, the
By Point field identifies the point you navigated from and only events for that point are shown.
2. If you want to see events from a particular time, enter a date/time range and then click Update. To return
to default values, click Clear Filter.
ADDITIONAL INFORMATION: You can show and hide the filter controls by clicking the Filter Options label.
3. Sort the list by clicking the column headings.

Managing user sessions

The USER SESSION MANAGER helps you monitor user activity and end unneeded sessions. The list includes
columns for: User (the user ID of each user logged in), Host (the IP address of the session), Idle Time (how long
the user session has been idle), and Activity (the most recent actions taken by the user).
TASK
1. Click the Feature Dashboard icon in the left navigation pane.
2. Click the USER SESSIONS feature button.

STEP RESULT: Compass shows a list of current user sessions.
3. Select Enable Auto Refresh to have Compass periodically load the latest user session data. To manually
refresh data, click Refresh.
4. Sort the list by clicking a column heading.
5. To end a user session, select it and then click Force Logout.
STEP RESULT: Compass asks you to confirm the action.
6. Click OK.

Monitoring wireless networks
The wireless network status page lists the AZW-5000 devices and Wireless Temperature Sensors (WTS) in your
system and presents real-time data that helps you gauge the effectiveness of the wireless network. Three tabs at the
top of the page allow you to view live data, view snapshots, and compare data sets side-by-side.
TASK
1. Open the Feature Dashboard.
2. Click Wireless.
STEP RESULT: The WIRELESS COMMISSIONING REPORTING TOOL opens.
Viewing live data and creating snapshots
The Live Data tab lists the wireless devices connected to the system.
TASK
1. Select the Live Data tab.
2. Click Select devices to view.
3. Select All Devices or set a range of device numbers.
4. Click Update. Sort the data by clicking the column headings.
5. To create a snapshot, click Create Snapshot.
Viewing snapshots
Snapshots capture system data at a point in time and are useful for analyzing network performance over time.
TASK
1. Select the Snapshot tab.
STEP RESULT: The Snapshot Manager list the available snapshots.
2. Click the column headings to sort the list.
Comparing data sets
Compare two snapshots or compare a snapshot with live date.

TASK
1. Select the Compare tab.
2. Click Data sets to compare.
3. Select snapshots or live data from the drop-down lists. Sort the list by clicking the column headings.

Operators Manual

Caricato da

Informazioni sul documento

Titolo originale

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

Operators Manual

Caricato da

Copyright:

Formati disponibili

Compass

© Honeywell LT-UG-CMPSWEB Rev. 03 | Revised May 2015 2

Alarms • User-configured alarm messages display in alarm pop-up

© Honeywell LT-UG-CMPSWEB Rev. 03 | Revised May 2015 3

DataViewer/Trendlogs • Units defined in Trendlog setup display correctly in DataViewer

Schedules • Scheduled Point/Zone Search consistency in sorting and filtering

Workstation • Object Scanner – Network Scan functionality

SSL ON by Default • SSL is now turned ON in Compass by default(Tools>General System

© Honeywell LT-UG-CMPSWEB Rev. 03 | Revised May 2015 4

© Honeywell LT-UG-CMPSWEB Rev. 03 | Revised May 2015 5

© Honeywell LT-UG-CMPSWEB Rev. 03 | Revised May 2015 6

© Honeywell LT-UG-CMPSWEB Rev. 03 | Revised May 2015 7

© Honeywell LT-UG-CMPSWEB Rev. 03 | Revised May 2015 8

Alarm notifications for new alarms

Alarm notifications when working in Compass

© Honeywell LT-UG-CMPSWEB Rev. 03 | Revised May 2015 9

Alarm notifications when Compass is minimized

© Honeywell LT-UG-CMPSWEB Rev. 03 | Revised May 2015 10

Viewing alarm history

Opening alarm history

Using filter options

© Honeywell LT-UG-CMPSWEB Rev. 03 | Revised May 2015 11

Creating a new alarm

© Honeywell LT-UG-CMPSWEB Rev. 03 | Revised May 2015 12

© Honeywell LT-UG-CMPSWEB Rev. 03 | Revised May 2015 13

© Honeywell LT-UG-CMPSWEB Rev. 03 | Revised May 2015 14

Adding an alarm recipient

Workstation Select the workstation you want to receive

Annunciate if... Require a user to acknowledge the alarm.

Print Send the alarm to the primary workstation’s

Handled Events Select the events that will trigger an alarm.

8. Configure an email recipient.

Email Type a label for the email recipient.

Description Type the text that appears in recipient lists.

Email address Type the email address where the alarm

Handled Events Select the events that will trigger an alarm.

© Honeywell LT-UG-CMPSWEB Rev. 03 | Revised May 2015 15

9. Configure a pager recipient.

Pager Compass generates this value by appending

Description Type a description for the pager - “Weekend

Phone Number Use numbers and spaces. To specify the

Alphanumeric Pager When selected, Compass sends an

Pager ID Type the pager identifier that the paging

Numeric Message If the page is not alphanumeric, type a

Handled Events Select the events that will trigger an alarm.

© Honeywell LT-UG-CMPSWEB Rev. 03 | Revised May 2015 16

Removing an alarm recipient

© Honeywell LT-UG-CMPSWEB Rev. 03 | Revised May 2015 17

About host devices

© Honeywell LT-UG-CMPSWEB Rev. 03 | Revised May 2015 18

About alarm handlers

© Honeywell LT-UG-CMPSWEB Rev. 03 | Revised May 2015 19

Creating an alarm handler

© Honeywell LT-UG-CMPSWEB Rev. 03 | Revised May 2015 20

Editing alarm handler configuration

Host Device Read-only field that lists the alarm handler.

Description The name shown in lists of alarm handlers.

Recipients The workstation, pagers, and/or email

Acknowledge Popup Messages The events that must be acknowledged.

© Honeywell LT-UG-CMPSWEB Rev. 03 | Revised May 2015 21

Editing an alarm recipient

Workstation Select the workstation you want to receive

Annunciate if... Require a user to acknowledge the alarm.