Creating and Configuring Alarms Tutorial Guide
Creating and Configuring Alarms Tutorial Guide
Introduction
1 About This Guide ........................................................... 9
1.1 Purpose of This Guide ................................................................. 11
1.2 How This Guide is Organized ...................................................... 12
1.3 Typographical Conventions ......................................................... 13
Tutorial
3 Our Case Study ........................................................... 21
3.1 University X ................................................................................. 23
3.2 Requirements and Specifications ................................................ 26
3.2.1 Devices Used for This Case Study ............................................. 26
3.2.2 Software Used in This Tutorial ................................................... 26
3.2.3 Specifications ........................................................................... 26
3.3 Focus of This Tutorial .................................................................. 27
3.3.1 Pre-existing Project Database Folder and Programs .................. 27
3.3.2 Pre-existing Project Database Objects ...................................... 30
3.3.3 Pre-existing WorkStation for Projects User Accounts ................. 31
Topics
Purpose of This Guide
How This Guide is Organized
Typographical Conventions
1 About This Guide
1.1 Purpose of This Guide
Introduction
The Introduction part contains information on the purpose of this guide, how this
guide is organized, where to find more information, and information on regulatory
notices.
Tutorial
The Tutorial part contains a step-by-step description of how to carry out different
tasks. If you want more information, see WebHelp or the corresponding Building
Operation Guide.
The Tutorial part includes a case study for a fictional customer called University X.
You can decide if you want to follow the example or use the described procedures
as reference information. The case study in this tutorial is an example of a typical
way of configuring Building Operation for a customer. When reading through this
tutorial, you might not have access to the devices, programs, and other files that
are needed for the fictional customer University X. However, the purpose of having
a case study is to see the procedures put in context, so you see how the
procedures could be used when configuring Building Operation, devices, or
programs for your customer.
Note
The programs and files that are used for the fictional customer University X are
intended for training purposes only.
Tip
Helps you understand the benefits and capabilities of the product.
Note
Provides you with supplementary information.
Important
Alerts you to supplementary information that is essential to the completion of a
task.
Caution
Alerts you to a condition that can cause loss of data.
Warning
Alerts you to a condition that can cause product damage or physical harm.
Bold texts:
User interface items, such as property names and buttons, are written in bold, for
example "On the File menu, select New."
Example texts:
All the example related information is indicated by blue lines and bullets.
Topics
Where to Find Additional Information
Regulatory Notices
2 Additional Information
2.1 Where to Find Additional Information
UL 916 Listed products for the Unites States and Canada, Open
Class Energy Management Equipment.
Industry Canada
ICES-003
This is a Class B digital device that meets all requirements of the Canadian
Interference Causing Equipment Regulations.
Topics
University X
Requirements and Specifications
Focus of This Tutorial
3 Our Case Study
3.1 University X
3.1 University X
We are going to install Building Operation as the building management system for
University X. The university is a campus of buildings for which heating and cooling
are supplied from a Central Plant with an underground distribution system. The
case study focuses on the renovation of the Central Plant and the expansion of the
School of Business.
Note
The programs and files that are used for the fictional customer University X are
intended for training purposes only.
3.2.3 Specifications
You find specifications in the Building Operation datasheets for Enterprise Server,
WorkStation, Project Configuration Server, PS-24V Power Supply, Automation
Server, and I/O Module Family.
The Automation Server called CPlant AS controls the Cooling Plant and Heating
Plant.
CPlant AS has the following folder structure:
Topics
Logging on to WorkStation for Projects
Opening a Project
Creating a Category
Creating an Out of Range Alarm
Creating a Change of State Alarm
Creating a Filtered Alarm View
4 Creating Categories, Alarms, and Alarm Views
Our Example
To ensure that operators have an organized method for handling alarms, the
university requires that the Alarm Views display alarms based on a category, such
as temperature or status.
In this chapter, you first log on to WorkStation for Projects on the off-site computer
and open the University X Project. You then create alarm categories for the Central
Plant temperature alarms and status alarms. You also create out of range alarms
that are triggered when a temperature exceeds or falls below the defined high and
low levels. You create change of state alarms that are triggered when a digital
program variable indicates plant failure or a specific piece of equipment fails, such
as the chiller. In order to display the alarms by category, you create Alarm Views for
temperature alarms and status alarms in the Heating Plant and the Cooling Plant.
Note
The first time you log on to WorkStation for Projects you need to use
the administrator user account to create a project user account. For
more information, see the Creating a Project Configuration Server
User Account topic on WebHelp.
2. In the Password box, type the password. In this example, type “Pete.”
Continued on next page
3. In the Server box, select the hypertext transfer protocol you want to use and
then enter a server name or an IP address. In this example, click HTTPS
and then enter localhost.
4. Select Remember me to have WorkStation for Projects remember your
settings.
5. Click Log on.
To open a project
1. In WorkStation for Projects, in the WorkStation for Projects - Projects
view, select the project that you want to open. In this example, select
University X Project.
To create a category
1. In WorkStation, on the Tools menu, click Control Panel.
2. On the Control Panel toolbar, select the server. In this example, select
University X ES1.
3. Click Categories.
4. Click the Categories tab, and then click the Add category button .
Continued on next page
5. In the Name box, type the name of the new category. In this example, type
“Cooling Plant Temps.”
In our example, repeat the procedure to create categories for the Cooling Plant and
the Heating Plant. Use the following properties:
Cooling Plant
• Name: Cooling Plant Statuses
• Description: Associate all cooling plant status objects to this category
Heating Plant
• Name: Heating Plant Temps
• Description: Associate all heating plant temperature objects to this category
• Name: Heating Plant Statuses
• Description: Associate all heating plant status objects to this category
4. In the Name box, type a name for the alarm. In this example, type
“CdwsTempCV Alarm.”
5. In the Description box, type a description for the alarm. In this example,
type “Generates an alarm based upon the defined ranges for the Condenser
Water Supply Temperature CV.”
6. Click Next.
Continued on next page
7. In the Upper limit box, enter an upper limit for the alarm. In this example,
enter 48 °C (118 °F).
8. In the Lower limit box, enter a lower limit for the alarm. In this example,
enter 15 °C (59 °F).
9. In the Deadband box, enter a deadband for the alarm. In this example,
enter 1 °C (2 °F).
10. In the Monitored variable box, enter the variable that the alarm monitors.
In this example, enter ...University X ES1/Servers/CPlant AS/Cooling
Application/Programs/Calibrations/CdwsTempCV.
11. Click the Set unit button to enter or change the unit of measure for the
alarm limits and deadband.
Note
• If the monitored value has a unit of measurement defined, the
alarm limits and deadband are assigned that unit by default.
12. Select the unit of measure. In this example, ensure that the unit selected is
°C (°F).
17. In the Messages area, in the Above upper limit message box, type the
message to display when the alarm exceeds the upper limit. In this
example, type “The condenser water supply temperature is above alarm limit.”
18. In the Below lower limit message box, type the message to display when
the alarm falls below the lower limit. In this example, type “The condenser
water supply temperature is below alarm limit.”
19. In the Reset message box, type the message to display when the alarm is
reset. In this example, type “The condenser water supply temperature has
returned to normal.”
20. In the Priorities area, in the Above upper limit priority box, enter the
priority for the upper limit of the alarm state. In this example, enter 2.
21. In the Below lower limit priority box, enter the priority for the lower limit of
the alarm state. In this example, enter 2.
22. In the Reset priority box, enter the priority for the reset state. In this
example, enter 10.
23. Under Category and Alerts, in the Category box, enter a category for the
alarm. In this example, enter ...University X ES1/Servers/CPlant
AS/System/Alarm Control Panel/Alarm
Handling/Categories/Cooling Plant Temps.
24. Select the Flashing alert check box to make the alarm flash in the Alarms
pane and Alarm Views when it is triggered. In this example, select the check
box.
Continued on next page
25. Select the Audible alert check box to make the alarm sound when it is
triggered. In this example, select the check box.
28. Under Required user action, select the check boxes for Comment,
Cause note, and Action note to force the user to act on the listed actions.
In this example, select the Comment check box for When disabling an
alarm, When disabling the event log, When rejecting an
assignment, and When releasing an assignment.
31. In the Select Object dialog box, select the object you want to attach to the
alarm. In this example, select ...University X ES1/Servers/CPlant
AS/Graphics/Cooling Plant Graphic.
32. Click Select.
33. On the Attachment page, in the Display on alarm column, select the
check box to automatically open the attachment when the alarm is triggered.
In this example, select the check box.
In our example, repeat the procedure to create out of range alarms for the Cooling
Plant and the Heating Plant.
Component Setting
Deadband 2 °C (4 °F)
Alarm delay 60
Reset delay 60
Flashing alert No
Audible alert No
Continued
Component Setting
Component Setting
Deadband 2 °C (4 °F)
Alarm delay 60
Reset delay 60
Above upper limit message The hot water return temperature is above
alarm limit
Below lower limit message The hot water return temperature is below
alarm limit
Flashing alert No
Audible alert No
Continued
Component Setting
Component Setting
Deadband 2 °C (4 °F)
Alarm delay 60
Reset delay 60
Above upper limit message The hot water supply temperature is above
alarm limit
Below lower limit message The hot water supply temperature is below
alarm limit
Continued
Component Setting
Flashing alert No
Audible alert No
4. In the Name box, type a name for the alarm. In this example, type
“PlantAlarm.”
5. In the Description box, type a description for the alarm. In this example,
type “Generates an alarm based upon the status of the PlantAlarm variable.”
6. Click Next.
Continued on next page
7. Select the state of the monitored variable that triggers the alarm:
• Click True to trigger the alarm when the monitored variable is equal to
True.
• Click False to trigger the alarm when the monitored variable is equal to
False.
In this example, click True.
8. In the Monitored variable box, enter the variable that the alarm monitors.
In this example, enter ...University X ES1/Servers/CPlant AS/Cooling
Application/Programs/PlantAlarms/PlantAlarm.
9. Under Time delay and shunt variable, in the Alarm delay box, enter the
time delay. In this example, enter 0.
10. In the Reset delay box, enter the time delay. In this example, enter 3.
Continued on next page
11. In the Shunt variable box, enter the shunt variable. In this example,
enter ...University X ES/Server/CPlant AS/Cooling
Application/Programs/PlantStart/PlantEnable.
14. In the Reset message box, type the message to display when the alarm is
reset. In this example, type “Cooling Plant returned to normal.”
15. In the Alarm priority box, enter the priority for the alarm state. In this
example, enter 1.
16. In the Reset priority box, enter the priority for the reset state. In this
example, enter 10.
17. Under Category and Alerts, in the Category box, enter a category for the
alarm. In this example, enter ...University X ES1/Servers/CPlant
AS/System/Alarm Control Panel/Alarm
Handling/Categories/Cooling Plant Statuses.
18. Select the Flashing alert check box to make the alarm flash in the Alarms
pane and Alarm Views when it is triggered. In this example, select the check
box.
19. Select the Audible alert check box to make the alarm sound when it is
triggered. In this example, select the check box.
22. Under Required user actions, select the check boxes for Comment,
Cause note, and Action note to specify how the user should respond to
the listed actions. In this example, select the Comment check box for
When hiding an alarm, When disabling an alarm, When disabling
the event log, When assigning an assignment, When rejecting an
assignment, and When releasing an assignment.
25. In the Select Object dialog box, select the object you want to attach to the
alarm. In this example, select ...University X ES1/Servers/CPlant
AS/Graphics/Cooling Plant Graphic and ...University X ES1/Central
Plant Bldg/Cooling Plant/Chiller Status Trend Log List.
26. Click Select.
27. Click Create.
In our example, repeat the procedure to create two more change of state alarms
for the Heating Plant and the Cooling Plant.
Component Setting
Name PlantAlarm
Alarm delay 0
Continued
Component Setting
Reset delay 3
Same priority No
Alarm priority 1
Reset priority 10
Audible alert No
Component Setting
Name ChlrAlarm
Continued
Component Setting
Alarm delay 5
Reset delay 5
Alarm priority 1
Flashing alert No
Audible alert No
4. In the Name box, type a name for the Alarm View. In this example, type
“Temp and Status Alarm View.”
5. In the Description box, type a description for the Alarm View. In this
example, type “Shows Cooling Plant temperature and status alarms.”
6. Click Create.
7. In the System Tree pane, select the Alarm View you created.
8. On the Actions menu, click Edit Alarm Filter to filter the Alarm View.
Continued on next page
9. Click the Add condition button and select a condition type. In this
example, select Category.
10. Type the condition for the filter. In this example, type “Cooling Plant
Temps.”
11. Click the Add row button to add another condition of the same type. In
this example, add another condition.
12. Type the condition for the filter. In this example, type “Cooling Plant
Statuses.”
Tip
• You can add different condition types by clicking the Add
In this example, repeat the procedure to create an Alarm View for the Heating
Plant:
• Location: ...University X ES1/Central Plant Bldg/Heating Plant
Topics
Selecting the Schneider Electric E-mail Server for E-mail
Notifications
Creating an E-mail Notification
Summary
5 Creating and Configuring Email Notifications
Our Example
The university requires certain types of alarms to be sent to all HVAC system
managers and operators. The university’s IT department created a group email
address to send these alarms to.
In this chapter, you create email notifications and configure the University X ES1
server to use the Schneider Electric SMTP server to send the notifications.
Note
• Any available SMTP server can be used to send E-mail notifications. For more
information, see the Selecting and Specifying an E-mail Server for E-mail
Notifications topic on WebHelp.
5. In the Sender E-mail box, type a sender address for the E-mail messages
that are generated by this server. The sender E-mail address is the receiver of
replies. In this example, type “[email protected].”
6. In the Maximum queue size box, enter the maximum number of E-mail
messages that is allowed in the queue. In this example, enter 30.
7. In the Maximum retry count box, enter the number of attempts to send an
E-mail message that are performed before cancelling the E-mail message.
In this example, enter 5.
8. In the Retry time box, enter the number of minutes between each attempt.
In this example, enter 30.
9. In the Host box, confirm that the Schneider Electric E-mail Server address is
smtpservice.tac.com.
10. In the Port box, confirm that the port number is 25.
Continued on next page
4. In the Name box, type a name for the notification. In this example, type
“Cooling Plant E-mail Notification.”
5. In the Description box, type a description for the notification. In this
example, type “Sends E-mail for Cooling Plant temperature and status alarms
to HVAC operators and managers.”
6. Click Next.
Continued on next page
8. In the E-mail address box, type the E-mail address of the recipient of the E-
mail messages. In this example, type “[email protected].”
9. In the Subject box, type the subject of the E-mail message. In this
example, type “Cooling Plant Alarm.”
10. In the Text box, type the notification message, which can include substitution
codes. For more information, see the Substitution Codes for Notifications
topic on WebHelp. In this example, keep the default text.
Continued on next page
11. Click the Add condition button and select the condition type that is to
generate the E-mail notification. In this example, select Category.
12. Type the condition for the E-mail notification. In this example, type “Cooling
Plant Temps.”
13. Click the Add row button to add another condition of the same type. In
this example, add another condition.
14. Type the condition for the E-mail notification. In this example, type “Cooling
Plant Statuses.”
Tip
• You can add different condition types by clicking the Add
In this example, repeat the procedure to create an E-mail notification for the
Heating Plant. Use the following settings:
• Location: ...University X ES1/Application/Notifications
• Name: Heating Plant E-mail Notification
• Description: Sends E-mail for Heating Plant temperature and status alarms
to HVAC operators and managers
• E-mail address: [email protected]
• Subject: Heating Plant Alarm
• Text: Keep the default text
• Add notification conditions:
– Condition type: Category
– Condition: Heating Plant Temps
– Condition: Heating Plant Statuses
5.3 Summary
You have now created out-of-range alarms for the condenser water supply and
various Cooling and Heating Plant temperatures that are triggered when
temperatures exceed or fall below the defined limits. You have also created change-
of-state alarms that are triggered when if the plants fail or when a particular piece of
equipment, such as the chiller, fails.
Additionally, you associated graphics to the alarms so that they are available
immediately and defined the text that is displayed in the Alarm View when a
particular alarm is tripped.
You associated these alarms to alarm categories, which enabled you to create
Alarm Views that are filtered based upon the category type. You also used these
categories to ensure that all temperature and status alarms in the Heating Plant and
Cooling Plant are sent by email to the University X HVAC operators and managers.
You used WorkStation for Projects to create and configure the alarms off site (at the
Schneider Electric office).
04-15021-01-en
July 2014