Documente Academic
Documente Profesional
Documente Cultură
BACnet
Application Guide
www.sbt.siemens.com
Restricted
Your feedback is important to us. If you have comments about this manual, please submit them
to: SBT_technical.editor.us.sbt@siemens.com
APOGEE is a registered trademark of Siemens Industry, Inc.
Tracer Summit is a trademark of The Trane Company
BACnet is a registered trademark of American Society of Heating, Refrigeration and Air Conditioning Engineers
(ASHRAE)
Insight for Minicomputers is a registered trademark of Siemens Industry, Inc.
Insight for Personal Computers is a registered trademark of Siemens Industry, Inc.
Country of Origin: US
Table of Contents
About this Application Guide ........................................................................................ I
Purpose and Intended Audience of this Guide .............................................................. II
How this Guide is Organized .......................................................................................... II
Suggested Reference Materials .................................................................................... III
Symbols ......................................................................................................................... III
Getting Help .................................................................................................................. IV
Where to Send Comments ............................................................................................ IV
Chapter 1Overview of Siemens BACnet Products and Solutions ................................. 7
Brief History of BACnet Implementation within APOGEE .............................................. 7
Architecture Overview of APOGEE BACnet System ..................................................... 14
BACnet Networks Overview ...................................................................................... 14
Panel Connections ..................................................................................................... 15
Routers....................................................................................................................... 15
Network Numbering .................................................................................................. 15
Some Basic BACnet Terminology ................................................................................. 15
BACnet/IP................................................................................................................... 16
BACnet Client/Server ................................................................................................. 16
User Datagram Protocol (UDP) .................................................................................. 16
Internet Protocol ....................................................................................................... 16
MS/TP Networks ........................................................................................................ 16
MS/TP Addressing ...................................................................................................... 17
Chapter 2BACnet Objects and Services ..................................................................... 19
Objects Theory ............................................................................................................. 19
Properties of Objects ................................................................................................. 20
The OBJECT_TYPE Property ..................................................................................... 21
Command Priority Properties.................................................................................. 22
BACnet Device ........................................................................................................... 29
Point-Like Objects ...................................................................................................... 31
Analog Input Object ................................................................................................ 32
Analog Output Object ............................................................................................. 33
Analog Value Object ................................................................................................ 35
Binary Input Object ................................................................................................. 36
Siemens Industry, Inc.
Table of Contents
Table of Contents
iii
Table of Contents
Table of Contents
Table of Contents
vi
Table of Contents
vii
Table of Contents
Table of Contents
ix
Table of Contents
Table of Contents
xi
Table of Contents
Using BACnet Calendar Days in an APOGEE BACnet Field Panel .......................... 305
Accessing a Calendar Object with the BACnet Object Browser ............................ 306
BACnet Scheduling Examples ..................................................................................... 307
BACnet Scheduling Example 1 ................................................................................. 307
BACnet Scheduling Example 2 ................................................................................. 309
BACnet Scheduling Example 3 ................................................................................. 310
BACnet Scheduling Example 4 ................................................................................. 310
BACnet Scheduling Example 5 ................................................................................. 311
Chapter 10BACnet Alarming ....................................................................................313
BACnet Alarming Overview ........................................................................................ 313
Transitional States ................................................................................................... 314
BACnet and APOGEE Alarming ................................................................................... 314
Alarm Messages ....................................................................................................... 316
Token Messages .................................................................................................... 318
Notification Classes.................................................................................................. 319
Upper Section Configuration ................................................................................. 320
Lower Section Configuration ................................................................................. 322
Event Enrollment ..................................................................................................... 324
Event Enrollment Object Types ............................................................................. 324
Event Enrollment Creation .................................................................................... 325
Alarm Enable/Disable .............................................................................................. 327
Floating Alarm Limits ............................................................................................... 327
System Messages ..................................................................................................... 327
Initials....................................................................................................................... 327
Alarm Acknowledgements ....................................................................................... 328
Get Event Information vs. Alarm Summary ............................................................. 328
Unknown BACnet Alarms ........................................................................................ 328
Life Safety Alarms .................................................................................................... 328
BACnet Text Messages............................................................................................. 329
Alarm Priority ........................................................................................................... 329
Alarm Messages ....................................................................................................... 330
BACnet Browser ......................................................................................................... 330
Point Objects............................................................................................................ 330
RENO Notification ...................................................................................................... 331
xii
Table of Contents
xiii
Table of Contents
Table of Contents
xv
Table of Contents
xvi
Major enhancements to the APOGEE software and hardware that have occurred
since then; for example firmware revisions 3.1 3.2.4.
New BACnet supported hardware products such as PXCs, TECs, and PTECs.
Network capacities, constraints and guidelines for device loading (regarding the
number of devices, network performance variables, etc.).
Optimal performance guidelines and settings have been added to this revision
of the guide.
It also provides information on symbols used, how to access help, and where to
direct comments about this guide.
II
Chapter 2, BACnet Objects and Services, describes BACnet Objects and Services
theory, and how the Insight application and the BACnet Browser are used to
access objects and their properties.
Chapter 5, BACnet Field Panel, describes the features and functions of the
APOGEE BACnet field panel as well as the firmware used to operate it.
Chapter 6, BACnet FLN Devices, describes the hardware and software features
of the Programmable TEC (PTEC) and its applications
Chapter 7, Insight BACnet Option, describes the Insight BACnet Option and the
changes to the Insight application since Revision 3.2
Table of Contents
Chapter 10, BACnet Trending, describes BACnet trending theory and trending in
an APOGEE Building Automation System.
Chapter 11, BACnet Tools, describes tools for analyzing BACnet communications
in an APOGEE Building Automation System.
The Glossary describes various terms and acronyms used in this application
guide.
Symbols
The following table lists the symbols used in this guide to draw your attention to
important information.
Notation
Symbol
Meaning
CAUTION:
Note
III
Notation
Symbol
Tip
Meaning
Suggests alternative methods or shortcuts that may not be
obvious, but can help the user better understand the capabilities of
the product.
Getting Help
For more information about regulated facilities, contact your local Siemens
representative.
IV
Table of Contents
Meeting BTL requirements for the field panel and the workstation.
Maintaining the support for LonWorks Field Level Network (FLN), P1 FLN,
Integration Drivers (currently on the PXC platform), Insight options, and
InfoCenter.
This has been accomplished over time starting in February 2006 with the
introduction of a BACnet MEC and MBC with Field Panel Firmware 3.0, and an
enhanced Insight BACnet Client and Server Option (see Product Announcement-638:
BACnet Field Panel Firmware Revision 3.0 and Insight Revision 3.7 BACnet Option),
along with Navigator Support (Commissioning Tool/Design Tool) and appropriate
training, documentation, and rollout. PA-638 introduced the following BACnet
capabilities on the APOGEE BAS:
Table 1: BACnet Features and Capabilities Introduced with Insight 3.7.
Protocol
Datalink
Communications
Description
Support by APOGEE
System?
BACnet/IP
Protocol
Datalink
Communications
Support by APOGEE
System?
Description
Ethernet
MS/TP
PTP
LonTalk
ARCnet
Table 2 shows a timeline of the additional features have been added to the Siemens
implementation of BACnet over the years. Hyperlinks to the Product
Announcements or Sales Releases posted on InfoLink have been added under the
Product Announcement or Sales Release Product Number column.
Table 2: Timeline of APOGEE Enhancements to Incorporate BACnet Features and Functions.
Date
Product
Announcement
or Sales
Release
Document
Number
Feb 2006
PA-638
Mar
2007
PA-638R2
Title
Enhancement Description
Date
Product
Announcement
or Sales
Release
Document
Number
Title
Enhancement Description
PA-651
TX-I/O Range
PA-668
Jul 2007
PA-664
Oct 2007
PA-669
MBC Pre-Retirement
Notice
Jul 2008
PS-700
Jul 2008
PA-702
Aug
2008
PA-704
Retirement of
Integration Drivers on
Open Processors
Platform
After September 30, 2008, the Open Processor and the Modular
Building Controller (MBC) went into retirement. This included all
Open Processor platform-based integration driver products. The
PXC Modular product line with TX-I/O replaced the MBC.
Jun 2009
PA-725
Sep 2009
PA-735
PXC Compact 36
Oct 2009
PA-736
Date
Product
Announcement
or Sales
Release
Document
Number
Title
Enhancement Description
Feb 2010
Sept
2010
10
PA-747
POA-001
Modular Equipment
Controller (MEC)
Date
Product
Announcement
or Sales
Release
Document
Number
Title
Enhancement Description
Product Line
Retirement Plan
Oct 2010
Jan 2011
SR-761
SR-773
APOGEE BACnet
Scalable Solution
Jan 2011
SR-771
Feb 2011
SR-770
Date
Product
Announcement
or Sales
Release
Document
Number
Title
Enhancement Description
POA-006
Dec 2011
SR-785
The BACnet Field Panel Web Server provides a Webbased Graphical User Interface compatible with BACnet
networks that is hosted directly from APOGEE Field
Panels. The Web Server allows remote access through an
intuitive Web-based user interface to monitor, control,
command and configure any Siemens building automation
system.
SR-790
Insight 3.12
July 2012
SR-789
DesigoTM CC Version 1
June
2013
SR-816
12
Date
Product
Announcement
or Sales
Release
Document
Number
Title
Enhancement Description
Aug
2013
SR-810
All V1.0 Service Releases and the LMU IT24 fix are
included
13
MS/TP is the preferred method of communications for use on BACnet FLNs. This
keeps the entire network native, or pure, BACnet.
Siemens BACnet field panels can support BACnet/IP, MS/TP ALN, and MS/TP
FLN all at the same time, but this is not recommended.
Siemens BACnet systems are not usually designed for MS/TP ALN support. MS/TP
ALNs:
14
Can provide field panel connectivity if IP addresses for use with BACnet/IP are
not available.
Are created and connected to the system through a BACnet/IP field panel.
Can have a maximum of 10 panels, including the panel connecting the ALN to
the BACnet/IP network. Only one MS/TP ALN is permitted per BACnet/IP ALN.
Panel Connections
BACnet ALN devices are wired using Ethernet network cables.
Routers
Routers connect networks of different types, or multiple subnets. In general,
routers:
Forward messages to the correct destination over the most efficient route.
A router that allows MS/TP device connection without a field panel is manufactured
by Cimetrics (model B6000).
Network Numbering
BACnet allows network numbers ranging from 1 to 65535.
15
BACnet/IP
BACnet messages can travel over networks that use the Internet Protocol (IP) by
using BACnet/IP. With BACnet/IP, the BACnet device is an IP device (IP node),
complete with its own IP address and IP protocol stack.
BACnet Client/Server
The terminology in BACnet systems differs from standard APOGEE.
The request and the response are addressed directly from one computer to
another computer.
Since the BACnet protocol itself guarantees delivery, TCP is not required.
BACnet uses UDP instead.
Datagrams are short messages. They might arrive out of order or go missing
without notice.
UDP manages how the sending computer disassembles a message into smaller
packets. It then transmits the packets across the network to another computer.
MS/TP Networks
Master-Slave/Token-Passing (MS/TP) uses a token to control access to a bus
network.
16
A master node can initiate the transmission of data when it holds the token.
Siemens Industry, Inc.
Slave nodes may transmit data in response to requests from master nodes.
In MS/TP systems with multiple masters, the token determines which master
can initiate transmissions.
APOGEE MS/TP slave nodes never hold the token. When a request that expects a
reply is sent to an MS/TP slave node, the master waits for the reply to be returned
before sending further communication.
Each PTEC/BTEC must have a unique user defined MAC address (subpoint 1) and
Device Object ID (instance number).
Applies to every device on the MS/TP network (third-party, etc.).
Siemens recommends thatSiemens MS/TP FLNs use 38400 as their baud rate for
best performance.
MS/TP Addressing
The BACnet MSTP specification theoretically allows up to 255 devices on the MSTP network.
The actual application of the BACnet MSTP addressing scheme is left up to the company
implementing it in their particular devices. In a Siemens MSTP FLN device:
MAC address (subpoint 1) range 0-127 can be used for slave or master
designated devices.
MAC address (subpoint 1) range 128-254 can be used for slave designated
devices only.
17
Objects Theory
Services Theory
Objects Theory
To standardize different systems from multiple of manufacturers, BACnet uses
objects. An object is a collection of information about a particular function that is
uniquely identified and is accessed over the communication medium in a
standardized way.
All information in a BACnet system is represented using objects. Standardized
objects make all of the devices within a BACnet system look alike. Examples of
objects are analog and binary inputs and outputs, schedules, control loops, alarms,
logical groupings of points that perform a specific function, software calculations,
and software processes.
Of course, a specific object can only exist for a manufacturers product if the product
has that function that the object represents. For example, you cannot write to the
schedule object of a BACnet device if the device has no schedule function.
19
Properties of Objects
All BACnet objects have a set of properties that are used to either get information
from the object, or give information and commands to the object. An objects
properties are often represented as a table with two columns. On the left is the
name or identifier for the property, and on the right is the propertys value.
Some properties are read only meaning that you can look at the property value, but
cannot change it. Some properties can be changed (written).
Standard objects can have both required properties and optional properties.
Vendors can also create non-standard objects and/or properties.
In the APOGEE Automation System, if a property exists in a BACnet field panel, then
the property may be accessed in one of three ways:
Through the BACnet Object Browseran Insight application feature in which the
properties are listed in tabular form where they can be read or written (if
applicable).
Through the Insight applications windows and dialog boxesif the property
needs to be read, written, or commanded for the application being used. Some
properties may be renamed. For example, the Object_Identifier property is
called the Instance Number in the Insight application.
A property of every BACnet object that is responsible for identifying the object is
called the Object_Identifier. The Object_Identifier is a numerical value that must be
unique within the BACnet device in which it resides. (Property names appear with
underbars in the BACnet specification.)
Each BACnet object also has an Object_Name property. The Object_Name is a string
of printable characters that also must be unique within the BACnet device in which it
resides.
To further assist a user in identifying and managing objects within a BACnet device,
each BACnet object has a Description property. It is a string of printable characters,
but does not have to be unique in the BACnet device.
20
Objects Theory
Object Type
Point-like
Binary Input
Binary Output
Binary Value
Analog Input
Analog Output
Analog Value
Multi-state Input
Multi-state Output
Multi-state Value
BitString Value
Accumulator
Integer Value
OctetString Value
CharacterString Value
DateTime Value
Time Value
DateTime Pattern
Date Value
Event Log
Notification Class
Scheduling/Logging
Schedule
Calendar
Trend Log
Trend Log Multiple
Control
Program
Siemens Industry, Inc.
Loop
Averaging
21
Access Door
Pulse Converter
Load Control
Life Safety
Life Safety Point
Group
Structured View
Command
Access User
Access Zone
Access Rights
Access Credential
Network Security
Device Level
Device
File
Each occurrence of an object within a device is marked by the Instance Number. For
example, if there are three Notification Class objects in a device, they will carry
Instance Numbers 1, 2, and 3, respectively. Some objects have the Instance Number
as a property. For example, in the Notification Class object, the value of its
Notification_Class property is its Instance Number. The Instance Number is part of
what makes up an objects Object_Identifier property. The relationship is:
Object_Identifier = Object_Type + Instance Number
22
Objects Theory
When multiple applications, each with a different priority, have active commands to
the object, the object decides which to accept based on the relative priorities of the
applications. As commands are set and released, the object will continuously reevaluate which command to use. Each commanding application must stay in its own
priority slot and not interfere with commands from other applications. If all
commands are released, the object will default to the value held in the mandatory
Relinquish_Default object property. Figure 5 shows an example of how the
Command Priority Array operates.
23
Slot
BACnet Names
Available
Available
Minimum On/Off
Available
Manual Operator
Available
10
Available
11
Available
12
Available
13
Available
14
Available
15
Available
16
Available
Relinquish Default
TEC APPLICATION
OPERATOR
SMOKE
EMERGENCY
PDL
BACnet commands do not provide enough information for CFR-11 logging. 1 As a result, the CFR-11
feature is not available in the BACnet field panel.
Title 21 CFR Part 11 of the Code of Federal Regulations deals with guidelines on electronic records and electronic signatures. Part
11, as it is commonly called, defines the criteria under which electronic records and electronic signatures are considered to be
trusworkthy, reliable and equivalent to paper records.
24
Objects Theory
The BACnet Command Priority Array dialog box (Figure 7) displays the current Text
and Abbreviated Text for each priority level.
The Edit button allows modification of the Priority Text and Abbreviated Text via
the Modify Priority Text dialog box (Figure 8).
25
After clicking OK in both dialog boxes, the BACnet Command Priority Array dialog
displays the updated priority text (Figure 9).
26
Objects Theory
Operation
The BACnet priority array operation can cause different operation at times when
compared to the proprietary APOGEE Automation System. The following scenario
illustrates the change:
Proprietary APOGEE Automation System:
1) The Scheduler application turns the lights off at the end of the workday. 2) A
maintenance technician uses the Insight workstation to command the lights ON. 3)
After performing service, the maintenance technician releases the command. 4) The
result is that the lights remain ON all night.
APOGEE BACnet Automation System:
1) The equipment scheduler turns the lights off at the end of the workday. 2) A
maintenance technician uses the Insight workstation to command the lights ON. 3)
After performing service, the maintenance technician releases the command,
returning control of the lights to the scheduler application, which turns the light
OFF. 4) The lights remain OFF until commanded ON by the scheduler the next
morning.
Another difference is that with APOGEE BACnet, unlike the proprietary APOGEE
Automation System, commands cannot be dropped if the priority of the command is
lower than the existing priority. The lower priority command must be properly
entered into the command priority table for implementation whenever the higher
priority command is released.
Another difference is that input points can be commanded when the object is out of
service. The APOGEE Automation System allows input commanding for virtual AI and
DI points and restricts it for physical AI and DI points, but allows it for TEC subpoints.
In BACnet, any point that is out of service can be commanded. Conversely, a physical
point must be out of service to be commanded.
Impact to HMI
The HMI must show which priority array entry is currently controlling the object. The
HMI must also allow configuration of the highest priority allowed, such that priority
levels used for life safety may be intentionally prohibited or allowed. See Point
Objects for exact details.
27
Impact to PPCL
PPCL, like all of the other BACnet APOGEE applications that commands points, has a
configurable default priority that is used for point commands and releases. Upon
saving a new PPCL program in the Program Editor application, the Save As dialog box
prompts the user to choose a priority level (Figure 10). The choices are established
in the users account. PPCL programs will use the PPCL default priority level for point
commands and releases if a priority is not specified in the statement. If a PPCL
Command Priority (default priority) is not selected when a new program is saved,
the PPCL value in the table (for example, BACnet priority level 16 if Table 4 were to
apply) is used as the default priority level for the whole program.
28
Objects Theory
BACnet Device
A BACnet Device is a collection of objects that represent the functions actually
present in a given real device. Figure 11 shows one example of how a group of
objects make up a field panel type of BACnet device. Although only one instance of
each kind of object is shown, a more typical field panel type of BACnet device might
have 16 DI and DO objects, two or three Schedule objects, etc.
Note that a BACnet Device contains something called a Device object. The properties
of this object are where information about the BACnet device resides. The
properties include the devices manufacturer and model number.
29
There is only one Device object in a BACnet Device. The Device objects
Object_Identifier property uniquely identifies the BACnet device on the
communications network. Therefore, the Object_Identifier number must be unique
on the network. The Device object also has an Object_Name property, which also
must be unique on the network. Table 5 shows the properties of the Device object
along with information about how they interface to the APOGEE Automation
System.
Table 5. BACnet Device Object Properties and How They Interface to APOGEE.
BACnet
Property_Identifier
APOGEE
Support
Read/Write
Access
Object_Identifier
Yes
Object_Name
Yes
Object_Type
Yes
System_Status
Yes
Vendor_Name
Yes
"Siemens BAU"
Vendor_Identifier
Yes
Model_Name
Yes
Firmware_Revision
Yes
Application_Software_Version
Yes
Location
Yes
Description
Yes
Protocol_Version
Yes
Protocol_Revision
Yes
Protocol_Services_Supported
Yes
Protocol_Object_Types
_Supported
Yes
Object_List
Yes
Max_APDU_Length_Accepted
Yes
1497
Segmentation_Supported
Yes
BACNET_SEGMENTATION_TYPE_BOTH
Max_Segments_Supported
Yes
32
VT_Classes_Supported
No
Active_VT_Sessions
No
Local_Time
Yes
Local_Date
Yes
UTC_Offset
No
30
Notes
Objects Theory
BACnet
Property_Identifier
APOGEE
Support
Read/Write
Access
Notes
UTC 2 time.
Daylight_Savings_Status
Yes
APDU_Segment_Timeout
Yes
3000
APDU_Timeout
Yes
3000
Number_Of_APDU_Retries
Yes
List_Of_Session_Keys
No
Time_Sync_Recipients
No
Max_Master
No
Max_Info_Frames
No
Device_Address_Binding
Yes
Database_Revision
Yes
Configuration_Files
Yes
Last_Restore_Time
Yes
Backup_Failure_Timeout
Yes
Active_COV_Subscriptions
Yes
Slave_Proxy_Table
No
Manual_Slave_Address_Binding
No
Auto_Slave_Discovery
No
Slave_Address_Binding
No
Profile_Name
No
Point-Like Objects
Table 3 lists the BACnet objects that resemble points in a building automation
system. As with all BACnet objects, point-like objects are just representations of a
BACnet devices points to other BACnet devices on the network. The points
structure inside of the manufacturers device may be entirely differentperhaps
representing the manufacturers proprietary and/or legacy software architecture.
The following are some of the highlights of the point-like objects.
2
(Wikipedia definition): Coordinated Universal Time (UTC) is the primary time standard by which the world regulates clocks and
time. It is one of several closely related successors to Greenwich Mean Time (GMT).
31
BACnet
Property_Identifier
APOGEE
Support
Access
Notes
Object_Identifier
Yes
Object_Name
Yes
Object_Type
Yes
Present_Value
Yes
REAL
Description
Yes
Limited to 16 characters.
Device_Type
Yes
Status_Flags
Yes
Event_State
Yes
Reliability
Yes
Out_Of_Service
Yes
Update_Interval
No
Units
Yes
Min_Pres_Value
No
Max_Pres_Value
No
Resolution
Yes
COV_Increment
Yes
Time_Delay
32
Alarm
Slope
W
COV Limit
Configurable
Objects Theory
BACnet
Property_Identifier
APOGEE
Support
Access
Notification Class
Alarm
High_Limit
Alarm
High Limit
Low_Limit
Alarm
Low Limit
Deadband
Alarm
Configurable
Limit_Enable
Alarm
Event_Enable
Alarm
Acked_Transitions
Alarm
Notify_Type
Alarm
Always = Alarm
Event_Time_Stamps
Alarm
Profile_Name
Notes
If alarming enabled, then to-offnormal, to-fault, and tonormal all set to TRUE.
No
The Present_Value property is the current value of the point. Note that the
Out_Of_Service property must be TRUE, before you can write a value into the
Present_Value property.
BACnet
Property_Identifier
APOGEE
Support
Access
Notes
Object_Identifier
Yes
Object_Name
Yes
Object_Type
Yes
Present_Value
Yes
REAL
Description
Yes
Limited to 16 characters.
Device_Type
Yes
Status_Flags
Yes
33
BACnet
Property_Identifier
APOGEE
Support
Access
Notes
Event_State
Yes
Reliability
Yes
Out_Of_Service
Yes
Always FALSE
Units
Yes
Min_Pres_Value
No
Max_Pres_Value
No
Resolution
Yes
Slope
Priority_Array
Yes
Relinquish_default
Yes
COV_Increment
Yes
COV Limit
Time_Delay
Alarm
Notification Class
Alarm
High_Limit
Alarm
High Limit
Low_Limit
Alarm
Low Limit
Deadband
Alarm
Configurable
Limit_Enable
Alarm
Event_Enable
Alarm
Acked_Transitions
Alarm
Notify_Type
Alarm
Event_Time_Stamps
Alarm
Profile_Name
Configurable
If alarming enabled, then to-offnormal, to-fault, and tonormal all set to TRUE.
No
The Present_Value property is the current value of the point. Since this is an output,
its Present_Value property is always writeable.
34
Objects Theory
BACnet
Property_Identifier
APOGEE
Support
Access
Notes
Object_Identifier
Yes
Object_Name
Yes
Object_Type
Yes
Present_Value
Yes
REAL
Description
Yes
Limited to 16 characters.
Status_Flags
Yes
Event_State
Yes
Reliability
Yes
Out_Of_Service
Yes
Always FALSE.
Units
Yes
Priority_Array
Yes
Relinquish_default
Yes
COV_Increment
Yes
COV Limit
Time_Delay
Alarm
Notification Class
Alarm
High_Limit
Alarm
High Limit
Low_Limit
Alarm
Low Limit
Deadband
Alarm
Configurable
Limit_Enable
Alarm
Event_Enable
Alarm
Configurable
If alarming enabled, then to-offnormal, to-fault, and tonormal all set to TRUE.
35
BACnet
Property_Identifier
APOGEE
Support
Access
Notes
Acked_Transitions
Alarm
Notify_Type
Alarm
Event_Time_Stamps
Alarm
Profile_Name
No
The Present_Value property is the current value of the point. Note that it should be
writeable if it is commandable or if Out_Of_Service is TRUE.
BACnet
Property_Identifier
APOGEE
Support
Access
Notes
Object_Identifier
Yes
Object_Name
Yes
Object_Type
Yes
Present_Value
Yes
Binary Value
Description
Yes
Limited to 16 characters.
Device_Type
Yes
Status_Flags
Yes
Event_State
Yes
Reliability
Yes
Out_Of_Service
Yes
Polarity
Yes
Normally Closed
Inactive_Text
Yes
Active_Text
Yes
36
Objects Theory
BACnet
Property_Identifier
APOGEE
Support
Change_Of_State_Time
No
Change_Of_State_Count
No
Time_Of_
State_Count_Reset
No
Elapsed_Active_Time
Yes
Time_Of_
Active_Time_Reset
Yes
Access
Notes
Totalization
Totalization_Reset_Time
Time_Delay
Alarm
Notification Class
Alarm
Alarm_Value
Alarm
Event_Enable
Alarm
Acked_Transitions
Alarm
Notify_Type
Alarm
Event_Time_Stamps
Alarm
Profile_Name
Configurable
W
Specifies what the Present_Value is when the point is in
Alarm.
W
If alarming enabled, then to-offnormal, to-fault, and tonormal all set to TRUE.
No
The Present_Value property is the current value of the point. Note that the
Out_Of_Service property must be TRUE for the Present_Value to be writeable. The
Polarity property indicates the relationship of the physical state of the input to the
logical state represented by the Present_Value property.
BACnet
Property_Identifier
APOGEE
Support
Access
Notes
Object_Identifier
Yes
Object_Name
Yes
Object_Type
Yes
Present_Value
Yes
Binary Value
37
BACnet
Property_Identifier
APOGEE
Support
Access
Description
Yes
Device_Type
Yes
Status_Flags
Yes
Event_State
Yes
Reliability
Yes
Out_Of_Service
Yes
Always FALSE.
Polarity
Yes
Inverted
Inactive_Text
Yes
Active_Text
Yes
Change_Of_State_Time
No
Change_Of_State_Count
No
Time_Of_
State_Count_Reset
No
Elapsed_Active_Time
Yes
Time_Of_
Active_Time_Reset
Yes
Minimum_Off_time
No
Minimum_On_time
No
Priority_Array
Yes
Relinquish_default
Yes
Notes
Limited to 16 characters.
Totalization
Totalization_Reset_Time
Time_Delay
Alarm
Notification Class
Alarm
Feedback_Value
Alarm
Event_Enable
Alarm
Acked_Transitions
Alarm
Notify_Type
Alarm
38
Proof Delay
W
Current value of the proof point for APOGEE proof points, set
equal to the Present_Value for points without proofing.
W
Objects Theory
BACnet
Property_Identifier
Event_Time_Stamps
APOGEE
Support
Access
Alarm
Profile_Name
Notes
Timestamps of the following event transitions,
TO_OFFNORMAL, TO_FAULT, TO_NORMAL.
No
The Present_Value property is the current value of the point. Since this is an output,
its Present_Value property is always writeable.
BACnet
Property_Identifier
APOGEE
Support
Access
Notes
Object_Identifier
Yes
Object_Name
Yes
Object_Type
Yes
Present_Value
Yes
Binary Value
Description
Yes
Limited to 16 characters.
Status_Flags
Yes
Event_State
Yes
Reliability
Yes
Out_Of_Service
Yes
Always FALSE.
Inactive_Text
Yes
Active_Text
Yes
Change_Of_State_Time
No
Change_Of_State_Count
No
Time_Of_
State_Count_Reset
No
39
BACnet
Property_Identifier
APOGEE
Support
Access
Notes
Elapsed_Active_Time
Yes
Time_Of_
Active_Time_Reset
Yes
Minimum_Off_time
No
Minimum_On_time
No
Priority_Array
Yes
Relinquish_default
Yes
Totalization
Totalization_Reset_Time
Time_Delay
Alarm
Notification Class
Alarm
Alarm_Value
Alarm
Event_Enable
Alarm
Acked_Transitions
Alarm
Notify_Type
Alarm
Event_Time_Stamps
Alarm
Profile_Name
Proof Delay
W
Specifies what the Present_Value is when the point is in
Alarm.
W
If alarming enabled, then to-offnormal, to-fault, and tonormal all set to TRUE.
No
The Present_Value property is the current value of the point. Note that it should be
writeable if it is commandable or if Out_Of_Service is TRUE.
A number of Binary Value object properties have a conformance code of O
(optional). Those with footnote number 6 relate to intrinsic reporting, which is one
of several methodologies used for alarming. The Siemens field panels support
intrinsic reporting and therefore have all of the O6 properties in all of their Binary
point-like objects. See Chapter 8-BACnet Alarming for more details.
40
Objects Theory
BACnet
Property_Identifier
APOGEE
Support
Access
Notes
Object_Identifier
Yes
Object_Name
Yes
Object_Type
Yes
Present_Value
Yes
Unsigned
Description
Yes
Limited to 16 characters.
Device_Type
Yes
Status_Flags
Yes
Event_State
Yes
Reliability
Yes
Out_Of_Service
Yes
Number_Of_States
Yes
State_Text
Yes
Priority_Array
Yes
Relinquish_default
Yes
Time_Delay
Alarm
Notification Class
Alarm
Feedback_Value
Alarm
Event_Enable
Alarm
Acked_Transitions
Alarm
Proof Delay
W
Current value of the proof point for APOGEE proof points, set
equal to the Present_Value for points without proofing.
W
41
BACnet
Property_Identifier
APOGEE
Support
Access
Notes
Notify_Type
Alarm
Event_Time_Stamps
Alarm
Profile_Name
No
The Present_Value property is the current value of the point. Since this is an output,
its Present_Value property has a Conformance Code of W meaning that it is always
writeable.
BACnet
Property_Identifier
APOGEE
Support
Access
Notes
Object_Identifier
Yes
Object_Name
Yes
Object_Type
Yes
Present_Value
Yes
Unsigned
Description
Yes
Limited to 16 characters.
Status_Flags
Yes
Event_State
Yes
Reliability
Yes
Out_Of_Service
Yes
Number_Of_States
Yes
State_Text
Yes
Priority_Array
Yes
42
Objects Theory
BACnet
Property_Identifier
Relinquish_default
APOGEE
Support
Access
Yes
Notes
For releasing the Present_Value when the Priority Array is
empty.
Time_Delay
Alarm
Notification Class
Alarm
Alarm_Values
Alarm
Fault_Values
Alarm
Event_Enable
Alarm
Acked_Transitions
Alarm
Notify_Type
Alarm
Event_Time_Stamps
Alarm
Profile_Name
Configurable
W
No
The Present_Value property is the current value of the point. Note that it should be
writeable if it is commandable or if Out_Of_Service is TRUE.
Calendar Object
Command Object
File Object
Schedule Object
Calendar Object
See Chapter 7-BACnet Scheduling for details.
Command Object
See Chapter 7-BACnet Scheduling for details.
43
File Object
This object is involved with the database uploads and downloads of an APOGEE field
panel. Table 14 shows the properties of the File object along with information about
how they interface to the APOGEE Automation System.
Table 14. BACnet File Object Properties and How They Interface to APOGEE.
BACnet
Property_Identifier
APOGEE
Support
Access
Notes
Object_Identifier
Yes
Object_Name
Yes
Object_Type
Yes
Description
Yes
Limited to 16 characters.
File_Type
Yes
File_Size
Yes
Modification_Date
Yes
Archive
Yes
Read_only
Yes
File_Access_Method
Yes
Record_Count
No
Profile_Name
No
Schedule Object
See Chapter 7-BACnet Scheduling for details.
44
Objects Theory
Then the navigation pane in the browser can be used to choose the desired BACnet
device (field panel). Choosing a BACnet device will cause its objects to display in the
navigation panel and the properties of that device to display on the right side of the
screen (assuming you select View Device Properties from the View selection). See
Figure 13.
45
Services Theory
This section is included to provide a greater understanding of how BACnet operates. Most of the
operation of BACnet services is behind the scenes and not visible to the user.
BACnet services are actions that a BACnet device takes to share data with another
BACnet device. Services are the means by which one BACnet device acquires
information from another device, commands another device to perform some
actions, or announces to one or more devices that some event has taken place.
BACnet is based on a Client-Server communications model, and these messages are
carried out by the server at the request of the client. Therefore, BACnet messages
are service requests. A client computer sends a service request to a server computer
that then performs the service and reports the result back to the client. Each service
request issued and service acknowledgment (reply) returned becomes a message
packet transferred over the network from the sending to the receiving device.
The BACnet message-passing and object access services are divided into five groups
or classes of Application Services:
46
Object Access ServicesProvide the means to read, modify and write properties,
as well as add and delete objects.
Services Theory
Virtual Terminal ServicesUsed by an operator to establish a bi-directional textbased connection with an application program executing in a remote device. In
effect, for the duration of a VT session established with the remote device, the
operator's device looks like a terminal connected to the remote application
program.
47
Services Supported
The APOGEE BACnet solution only supports the services listed in Table 15.
Table 15. Services Supported by the APOGEE BACnet Solution.
Service Name
ACKNOWLEDGE_ALARM
ADD_LIST_ELEMENT
ATOMIC_READ_FILE
ATOMIC_WRITE_FILE
CONFIRMED_COV_NOTIFICATION
CONFIRMED_EVENT_NOTIFICATION
CONFIRMED_PRIVATE_TRANSFER
CONFIRMED_TEXT_MESSAGE
CREATE_OBJECT
DELETE_OBJECT
DEVICE_COMMUNICATION_CONTROL
GET_ALARM_SUMMARY
GET_ENROLLMENT_SUMMARY
GET_EVENT_INFORMATION
I_AM
I_HAVE
READ_PROPERTY
READ_PROPERTY_MULTIPLE
READ_RANGE
REINITIALIZE_DEVICE
REMOVE_LIST_ELEMENT
SUBSCRIBE_COV
TIME_SYNCHRONIZATION
UNCONFIRMED_COV_NOTIFICATION
UNCONFIRMED_EVENT_NOTIFICATION
UNCONFIRMED_TEXT_MESSAGE
WHO_HAS
WHO_IS
WRITE_PROPERTY
WRITE_PROPERTY_MULTIPLE
48
Services Theory
Service Name
AUTHENTICATE
LIFE_SAFETY_OPERATION
READ_PROPERTY_CONDITIONAL
REQUEST_KEY
SUBSCRIBE_COV_PROPERTY
UNCONFIRMED_PRIVATE_TRANSFER
UTC_TIME_SYNCHRONIZATION
VT_CLOSE
VT_DATA
VT_OPEN
49
Interoperability
Certification
Insight Interoperability
Interoperability
BACnet Interoperability is the ability to integrate BACnet products made by different
manufacturers into a single system. Interoperability does not mean that installations
must have multiple vendors, just that the site can have multiple BACnet vendors if
desired. Many automation system users prefer the benefits of dealing with a single
vendor, and a system using the BACnet protocol in no way prevents this.
Note that Interoperability is not plug-and-play. You still have to make choices about
what functionality is needed. Also, BACnet interoperability does not address:
Configuration
51
Certification
BACnet is a registered trademark of ASHRAE. ASHRAE does not endorse, approve, or
test products for BACnet compliance. That is the responsibility of BACnet
International (formerly the BACnet Manufacturers Association and the BACnet
Interest Group - North America). To test manufacturers BACnet devices for
interoperability and certify the results, BACnet International (BI) established the
BACnet Testing Laboratories (BTL). The BTL logo is a trademark of BI. Products that
have been successfully tested by the BTL are eligible to display the BTL logo as part
of the listing process.
The main functions of the BTL are to:
Develop testing procedures and rules to certify that BACnet devices conform to
the BACnet standard so that the devices may carry the BTL certification mark
(Figure 15).
The APOGEE BACnet Field Panels are BACnet Testing Laboratories (BTL) certified and
listed BACnet Building Controllers (B-BC). They carry the BTL certification mark and
can meet specifications calling for native BACnet field panels. They provide
interoperability with third-party BACnet workstations.
Starting with Insight Revision 3.7 this version of Insight workstation with the
BACnet Option can be considered a native BACnet workstation. It has been
developed to conform to the BACnet Operator Workstation (B-OWS) test
specification. The BACnet Testing Laboratories has since added the B-AWS
designation, which stands for BACnet Advanced Workstation. As of Insight
Revision 3.11, Insight is B-AWS approved.
52
Certification
Specifying BACnet
Specifying BACnet is challenging because the protocol purposely defines more
functionality than any particular device will likely implement, and devices can vary
greatly in their implementation of BACnet and BACnet functionality. A document
called a Protocol Implementation and Conformance Statement (PICS) was devised to
disclose BACnet information such that vendors, customers, and consulting engineers
can understand the functionality implemented in a given device. From this
information they can determine realistic expectations for interoperability between
any given BACnet devices.
The original format of the PICS contained information about the devices
conformance class and support for functional groups. This format created some
confusion among its intended users and in 2001 it was replaced by a new approach
called BACnet Interoperability Building Blocks (BIBBs) that describes the devices
interoperability capabilities. BACnet Interoperability Building Blocks (BIBBs) are
defined in part of PICS. BIBBs are sets and groupings of functionality that can be
easily mapped from device-to-device, to determine the functionality that is likely
interoperable between devices. Both of these formats (PICS and BIBBs) are still used
today.
Consulting engineers, vendors, and customers can use a PICS to determine what
capabilities a BACnet device might have. The PICS may be used to determine what
functionality devices are capable of supporting and what functionality is
interoperable with other devices.
The PICS provides the following information about a BACnet device:
53
54
Certification
Description
DS-RP-A
DS-RP-B
DS-RPM-A
DS-RPM-B
DS-RPC-A
DS-RPC-B
DS-WP-A
DS-WP-B
DS-WPM-A
DS-WPM-B
55
Multiple
Figure 17 is an example Trending BIBB. Device B could be a BACnet field panel and
device A could be workstation that archives the trended data.
56
Certification
Data Sharing
Scheduling
Trending
Network Management
Device Management
Data Sharing
The Data Sharing IA defines monitoring and commanding of property values, COV
subscriptions, and object configuration. This functionality is similar to APOGEE
logical point operations:
Read/write property
COV (Change-of-Value)
Unsolicited COV
Scheduling
The Scheduling IA defines objects for calendars and scheduled commands for
predefined lists of object properties:
Schedulinginternal
Schedulingexternal
Trending
The Trending IA defines functionality for configuring trends and transferring trend
data over the network:
Network Management
Network management defines functionality for determining which devices are
present on a given network:
Siemens Industry, Inc.
57
Router configuration
Device Management
Device management defines functionality of some of the operational capabilities of
a device, including:
List manipulation
Text message
Time synchronization
Virtual terminal
BACnet supports two mechanisms for the generation of alarms and events:
Intrinsic Reportingthis relies on using properties that are part of, or "intrinsic"
to, the object that is being monitored for alarms or events.
58
B-AWS (Advanced Workstations), the target profile for APOGEE Insight and
Desigo CC
B-OWS (Operator Workstations), the previous target profile for APOGEE Insight,
prior to Revision 3.11.
B-BC (Building Controllers), the target profile for the APOGEE BACnet field
panels (PXC Compact, PXC Modular, and retired Open Processor and MEC)
B-AAC (Advanced Application Controllers) the target profile for the APOGEE PXC
Compact UEC
B-ASC (Application Specific Controllers), the target profile for the BACnet TEC
Figure 18 shows the functional relationship and hierarchy of the device types in a
building automation system. Included are the APOGEE Automation System devices.
59
BACnet Advanced
Workstation
AWS
BC
BC
BC
ASC
BACnet Application Specific
Controller
(B-ASC) Desigo PXC3 BACnet
ASC
ASC
BACnet Smart
Sensor/Actuator
60
B-BC Profile
Data Sharing
Supported
BIBBs
Description
DS-RP-A,B
DS-RPM-A,B
DS-WP-A,B
DS-WPM-B
AE-N-I-B
AE-ACK-B
AE-INFO-B
AE-ESUM-B
Scheduling
SCHED-E-B
Scheduling External, B
Trending
T-VTM-I-B
T-ATR-B
DM-DDB-A,B
DM-DOB-B
DM-DCC-B
DM-TS-B or DMUTC-B
DM-RD-B
DM-BR-B
In the Jargon of BIBBs, an A device is one who used the data (client) while the B device is the one who provides the data
(server).
61
B-AAC Profile
Data Sharing
Supported
BIBBs
Description
DS-RP-B
Read Property, B
DS-RPM-B
DS-WP-B
Write Property, B
DS-WPM-B
AE-N-I-B
AE-ACK-B
AE-INFO-B
Scheduling
SCHED-I-B
Scheduling Internal, B
DM-DDB-B
DM-DOB-B
DM-DCC-B
DM-TS-B or DMUTC-B
DM-RD-B
62
B-AAC Profile
Data Sharing
Supported
BIBBs
DS-RP-A,B
Description
Read Property, A and B
DS-RPM-A
DS-WP-A
Write Property, A
DS-WPM-A
DS-V-A
DS-M-A
AE-N-A
AE-ACK-A
AE-AS-A
AE-VM-A
AE-VN-A
Scheduling
SCHED-VM-A
Trending
T-V-A
Trending, View, A
DM-DDB-A,B
DM-DOB-B
DM-MTS-A
63
B-AAC Profile
Data Sharing
Supported
BIBBs
DS-RP-A,B
Description
Read Property, A and B
DS-RPM-A
DS-WP-A
Write Property, A
DS-WPM-A
DS-AV-A
DS-AM-A
AE-N-A
AE-ACK-A
AE-AS-A
AE-AVM-A
AE-AVN-A
Scheduling
SCHED-AVM-A
Trending
T-AVM-A
DM-DDB-A,B
DM-ANM-A
DM-ADM-A
DM-DOB-B
DM-DCC-A
DM-MTS-A
DM-OCD-A
DM-RD-A
DM-BR-A
64
Data Sharing
The APOGEE BACnet field panel accesses points (local and FLN) on the BACnet as
basic object types (analog, binary, multi-state). It supports basic BACnet read and
write services.
Interoperability is between ALN-class components, both APOGEE Automation
System and third-party. Examples of third-party equipment integration will be
covered in Chapter 3 under the section Examples of Third-Party Equipment
Integration, starting on page 82. Examples include integration to Sinamics G120 and
Vacon BT300 drives. The integration of third-party devices is the domain of the
Building Technologies Division integrated solutions team of Siemens Industry, Inc.
Also, interoperability does not include any BACnet FLN devices.
Through the APOGEE field panel HMI, you can specify panels (including third-party
panels) that are to be on your ALN for the purpose of point logs, commanding and
viewing. This limits the point log from becoming too big by limiting the number of
points included in the log. But, by using the encoded name or the device specific
name, various APOGEE BACnet field panel applications, like PPCL, can use points
from third-party panels. These points do not have to be specified to be on the
APOGEE BACnet field panels ALN.
Point Command
Point Log
Point Look
Point Release
65
Totalization Log
Services Supported
See Chapter 2BACnet Objects and Services.
Objects Supported
See Chapter 5APOGEE BACnet Field Panel.
The BACnet Properties common to all objects that can be accessed by these
services are:
Object_Identifier
Object_Name
Object_Type
Description
PPCL
PPCL in BACnet field panels supports monitoring and commanding of Present_Value,
Status, and Priority of points defined locally, over the ALN to other BACnet field
panels, and over the ALN to third-party devices.
TEC Subpoints
In a BACnet field panel, commanding a TEC point will cause it to unbundle and use
additional field panel memory. As with any other point, the Present_Value will be set
to the highest filled-in priority level.
When a TEC point is initially browsed, the Relinquish_Default property will contain
the current Present_Value of the point, and the Priority_Array property will initially
display as empty.
66
EEPROM points can only be written by commands with a priority higher (smaller
priority number) than OPERATOR. Therefore, EEPROM points cannot be commanded
by PPCL. If a remote third-party device commands an EEPROM point and the
command has a priority higher than OPERATOR, the command will be blocked. The
points Reliability property will display Unreliable because the Present Value and the
Relinquish_Default disagree.
Point Commanding
The panel uses BACnet services for point commands and polling. The
OUT_OF_SERVICE flag of the Status_Flags property is enabled for input points only.
System Messages
APOGEE BACnet field panels can generate system messages as a result of some
system event, such as PPCL run-time errors, logins, and logouts. These APOGEE
Automation System messages are made available to third-party devices via the
ConfirmedTextMessage service and the UnconfirmedTextMessage service. If a thirdparty device supports these services, it can receive APOGEE Automation System
messages. Likewise, since the APOGEE BACnet field panel supports these services,
messages from third-party devices can be displayed at the field panels HMI.
COVs
BACnet has a service called SubscribeCOV (see section 13.14 of the ANSI/ASHRAE
Standard 135-2012) to send notifications of changes of value (COV) that may occur
in a property of an object. The APOGEE BACnet field panel supports COV
subscriptions.
The field panel also has an Unsolicited COV Subscription feature that can be
configured to send COVs to a BACnet device even when the device does not ask for
(subscribe to) COVs. This feature can be used to send COVs to a third-party BACnet
device that lacks the SubscribeCOV mechanisms.
67
Scheduling
The APOGEE BACnet field panel allows BACnet clients (for example, workstations) to
use BACnet services to configure its Schedule and Calendar objects. It also allows
basic BACnet point-like objects in third-party devices to be used in scheduling.
Command Object
If a command is created for an APOGEE field panel, the Property ID is set to Present
value and disabled.
Trending
The APOGEE BACnet field panel allows BACnet clients (for example, workstations) to
use BACnet services for configuration and upload of trend logs. Also supported is the
use of BACnet objects (internal and external) in Point Logs. (This applies only to
BACnet devices on the same logical ALN.)
Dialout
Establish and terminate half-router connections for BACnet dialout support.
Proprietary Applications
Applications whose interfaces are not specified by BACnet (SSTO, PDL, PPCL, etc)
must be configured using the APOGEE-specific Confirmed Private Transfer function.
Allows clients to subscribe for device restart notifications. Support standard BACnet
device status indications.
68
Insight Interoperability
Foreign Device
An APOGEE BACnet field panel can act as a Foreign Device so it can join to a
BACnet/IP network through a BBMD (BACnet Broadcast Management Device). The
Insight Foreign Device Settings dialog box allows you to set up APOGEE BACnet field
panels as foreign devices, but not third-party field panels. For details about Foreign
Device, see Chapter 4-BACnet Communications.
BBMD
An APOGEE BACnet field panel can act as a BBMD (BACnet Broadcast Management
Device). This can be set up from the Insight workstation. For details about BBMDs
and how to set it up from the Insight workstation, see Chapter 4-BACnet
Communications.
Insight Interoperability
This section covers details about the Interoperability Areas of Insight with the
BACnet Option. It can serve to help you develop interface strategies to third-party BBC class controllers.
69
Point Names
When uploading points from third-party BACnet field panels, there are four ways in
which the names can be created:
The Insight BACnet option was introduced in March 2000 with Insight Revision 3.2 but this option only allowed communication with
third-party BACnet devices.
70
Insight Interoperability
The first, and recommended way, is to use encoded names that contain the Device
ID, Object Type, and Object Instance number in the name. For example, a Binary
Input with Instance Number 1 from Device 1200 would have a point name of
BAC_1200_BI_1.
The remaining choices use the object name with the device name or Instance
Number appended. Regardless of choice, APOGEE point names must be unique
system wide and be 30 characters or less.
Point Commanding
Out-of-Service will be enabled for third-party BACnet points.
Initials
When alarms are acknowledged by an Insight operator, the correct user initials will
be displayed. Alarms that are acknowledged by a third-party system will display BAC
at the Insight workstation. The initials SYS will be displayed at the Insight
workstation for alarms that do not require acknowledgements.
71
Alarm Acknowledgements
In BACnet, each one of the three state transitions (To-OffNormal, To-Fault, and ToNormal) can require a separate acknowledgement. If an operator acknowledges an
item in the alarm window from the Insight workstation, it will send up to three
acknowledgements to the BACnet device (software keeps track of how many
acknowledgements to send). A means to acknowledge a single transition is not
provided. Conversely, if a third-party workstation acknowledges only one state,
when three states require acknowledgement, the Insight application will not display
the alarm as acknowledged until all three states have been acknowledged.
Notification Class
The Insight software has a Notification Class dialog box where you can edit
Notification Classes for BACnet field panels. You can create/add/modify/remove
Notification Classes in third-party panels as well as APOGEE BACnet field panels. For
details about notification classes, see Chapter 8BACnet Alarming.
Insight Scheduling
Schedule and Calendar objects for Siemens BACnet panels are stored in the Insight
database. Therefore, these objects can be edited even if the Insight workstation is
not communicating with the panel (editing may be performed online or offline).
Schedule and Calendar objects for third-party BACnet devices are stored in the thirdparty devices only. Therefore, these objects can be edited only when the Insight
workstation is in communication with the device (editing must be performed online
only).
The Scheduler application in the Insight and Commissioning Tool software is used to
edit Schedule and Calendar objects in BACnet devices. This includes creating,
copying, viewing, modifying, and deleting these objects in both native Siemens
BACnet panels and third-party BACnet devices. The BACnet items are visible only if
the Insight BACnet Option is present.
Starting with Insight Version 3.11, the Scheduler application has been enhanced as
follows:
72
Insight Interoperability
New BACnet Schedule Properties Dialog Box. This new dialog box provides a
more streamlined method of editing BACnet schedules, which allows you to
focus on the most commonly-used features of BACnet schedules.
Showing or Hiding BACnet Schedules in the View Menu. The View menu has
been enhanced with a check box that enables you to show or hide BACnet
schedules.
Basic button added to the Advanced BACnet Schedule Properties dialog box.
The Advanced BACnet Schedule Properties dialog box has been enhanced with a
Basic button that allows you to go back to the BACnet Schedule Properties dialog
box.
73
Insight Trending
The Insight BACnet Option supports configuring and uploading (manual or COV
triggered) BACnet trend logs from APOGEE and third-party devices. However, you
cannot use it to create trend definitions in third-party BACnet panels. But, you can
establish Remote Trending with the following functionality:
BACnet Trend logs can record historical data for points on another device. The
storage location of trend log objects is not limited to the local panel.
P1 FLN points are owned by the panel and appear as Locally trended points,
whereas MS/TP FLN points are owned by their own MS/TP device and are
trended Remotely.
74
Insight Interoperability
Foreign Device
An Insight workstation can act as a Foreign Device so it can join to a BACnet/IP
network through a BBMD (BACnet Broadcast Management Device). For details about
Foreign Devices and how to set up the Insight workstation as a Foreign Device, see
Chapter 4BACnet Communications.
Cloaking
A BACnet field panel can be Cloakedremoved from the Insight System Profile tree.
This allows you to hide devices that you do not want displayed at the Insight
workstation and to keep the device discovery feature from constantly re-adding the
devices to an ALN. Only third-party devices can be cloaked.
BBMD
An Insight workstation can act as a BBMD on a BACnet network. For details about
BBMDs and how to set up the Insight workstation as a BBMD, see Chapter 4BACnet
Communications.
Although the Insight software provides an option to synchronize all BBMD tables, all of the devices in
the table must be APOGEE field panels or Insight workstations for the sync to work. All third-party
BBMDs must be edited manually.
75
Cross-Trunk
The Insight BACnet Client Option allows the Insight workstation and APOGEE
P2/Ethernet field panels to read and command point-like objects in the BACnet
devices (APOGEE 3.x field panels and third-party devices). Access in the other
direction is not available. That is, the BACnet devices cannot access points in the
APOGEE P2/Ethernet field panels (the Insight BACnet Server Option is required for
this). Thus, a BACnet device cannot subscribe to COVs from a point in an APOGEE
P2/Ethernet field panel.
DesigoTM CC
Released in July 2012, Desigo CC is a new management workstation that provides
optimized monitoring and control of integrated building automation (including
System ONE applications installed on PXC Modular or PXC Compact controllers) and
fire safety systems, and incorporates real-time video for event verification. Some of
the unique features of the Desigo CC management station are:
76
Single management station for building automation, fire safety, and video
cameras
DesigoTM CC
The server, the front-end processor, and the dedicated installed clients run on
Windows 7 64-bit or Windows Server 2008 R2. Web clients can use Microsoft
Internet Explorer web-browser Version 8 on Windows XP, or Version 9 or later on
Windows 7. The Windows desktop app can be downloaded to clients running
Windows XP or Windows 7.
Desigo CC enhances the power of Siemens APOGEE Building Automation System.
APOGEE, the most trusted brand in the market, has thousands of installations in
facilities all over the world. Desigo CC brings a new dimension to APOGEEs
capabilities, giving you a more intelligent level of integration, performance and
efficiency for your buildings core systems.
Desigo CC for APOGEE delivers centralized information and single control of building
automation, fire and security systems, helping you drive better outcomes.
Compatibility
Desigo CC is compatible with the following subsystems (see release notes for
details):
77
Desigo CC
Market Package 1 (MP1)
3.2.4
3.2.3a
3.2.2a
3.2a
3.1a
3.0.1a
3.2.4
3.2.3a
3.2.2a
3.2a
78
3.2.3a
3.2.2a
3.2.4
3.2.4
3.2.3a
PXC24.2-E.A, PXC24.2-ER.A
3.2.2a
PXC16.2-M.A, PXC16.2-MR.Ab
3.2a
PXC24.2-M.A, PXC24.2-MR.A
3.1a
DesigoTM CC
Desigo CC
Market Package 1 (MP1)
PXC16.2-EF.A, PXC16.2-ERF.Ab
PXC24.2-EF.A, PXC24.2-ERF.A
PXC Compact Series (PXCE)
3.2.4
PXC16-E.Ab, PXC16-ER.Ab
3.2.3a
PXC24-E.Ab, PXC24-ER.Ab
3.2.2a
3.2a
3.1a
3.0a
3.2
3.1a
3.0a
3.2a
1200EB (549-632)
3.1a
3.0a
1210EB (549-633)
Power MEC (MEFE)
3.2a
1200EFB (549-634)
3.1a
1210EFBb (549-635)
3.0a
Power MEC
3.1a
1200ELB (549-636)
3.0a
1210ELB (549-637)
a. Field panel Point Viewer/Editor, Program Viewer/Editor, Device Viewer/Editor, and Subpoint Viewer/Commander for
Desigo CC are not available in firmware revisions 3.2.3 and lower. Desigo CC Trend Log Object creation is not
supported in firmware revisions 3.2.3 and lower Field panel revisions 3.2.3 and lower should only be used with Desigo
CC on networks with 5 or more field panel controllers.
b. This model is discontinued.
Desigo CC Scheduling
The Desigo CC scheduler allows you to schedule events for management stations
and field panels at your facility. Scheduling is the process of creating and editing
commands, calendars, schedules, and time triggers. An event is simply a scheduled
system activity that involves equipment and spans a period of time, with a frequency
of repetition applied to it.
Scheduler consists of the following schedule types:
79
80
The XNET, the field network supporting MLX and XLS fire control panels, is
discussed in the XNET Integration Guide (A6V10376180).
The OPC network, supporting the connection with third-party OPC servers, is
discussed in the OPC Server Integration Guide (A6V10380501).
DesigoTM CC
More information can be found in the DesigoTM CC Engineering Manual Version 1.1
posted on InfoLink at:
http://iknow.us009.siemens.net/infolink/automation/DesigoCC/DesigoCC%20MP11.
htm.
Open Architecture
Desigo CC for APOGEE was developed to keep pace with changing technology in
modern facilities. APOGEE is an open system based around BACnet, and its flexible
enough to work with many other protocols with the addition of Desigo CC. Its open
architecture brings unrivaled control of critical building equipment and systems. It
supports a variety of open system protocols and IT standards, including:
Modbus
XNET
OnVIF
81
82
The APOGEE Automation System supports both BTL-listed and nonlisted BACnet
products. BTL-listed products have a higher likelihood of interoperability and
compatibility, but issues may still occur. Interoperability issues are often related to
the timing of communication packets, content of communication packets, and
variances in vendor implementation of the BACnet protocol; for example, alarm
notification and acknowledgement can be implemented multiple ways and still
comply with the BACnet standard.
BACnet Option for Insight Software This is an MLN level solution. It was
developed to provide workstation-to-workstation BACnet Ethernet or BACnet/IP
integration, or integration to devices supporting BACnet Ethernet or BACnet/IP.
The BACnet Client Option is used to monitor and command BACnet server
devices, such as APOGEE BACnet/IP field panels or third-party BACnet devices.
The BACnet Server Option is used to export proprietary APOGEE Automation
System information to third-party BACnet client applications, such as a
workstation software package.
Trane Driver This solution uses BACnet PTP (Point-to-Point), but is tailored
specifically for Trane equipment and cannot be used for integration with other
BACnet systems or devices.
BACnet PXC Modular, PXC Compact, and now retired MEC and Open Processor
The BACnet field panel supports BACnet as both a BACnet server and client,
but the main role of the building controller in the system is to provide data to
the workstation and other field panels; therefore, its primary role is as a BACnet
server device.
BACnet Solutions
For a complete list of BACnet solutions, refer to the Availability List, which is at this
location on InfoLink:
Siemens Industry, Inc.
83
Integration Needs
BACnet Solution
BACnet Ethernet or BACnet/IP integration for BACnet deviceseither APOGEE BACnet/IP field
panels, or third-party BACnet/IP or BACnet Ethernet devices.
BACnet field panelsAPOGEE BACnet field panels support BACnet/IP with Field Panel Firmware 3.0
and add BACnet MS/TP support with Field Panel Firmware 3.1, providing both BACnet client and
BACnet server capabilities, though the primary mission is as a BACnet server.
Trane BCU integration into the APOGEE Automation Systemusing BACnet PTP serial RS-232
connection.
Trane Driver
BACnet MS/TP and BACnet/IP Integration of controllers or devicesserial RS-485 into the APOGEE
Automation System. Support for BACnet MS/TP FLN is available using a BACnet MS/TP Driver on
Field Panel Firmware 3.2, or a third-party-router.
With Field Panel Firmware 3.1, the field panels support configurable FLN for P1 or BACnet MS/TP
directly.
84
Protocol Datalink
Communications
Description
BACnet/IP
MS/TP
Master Slave/Token
Passing over EIA-485
network
PTP
LonTalk
ARCnet
Zigbee
85
BACnet/IP
BACnet/IP was developed specifically for transporting BACnet messages between IP
devices (over TCP/IP). It is the preferred networking technology for BACnet.
BACnet/IP uses the IP address plus the UDP port address. BACnet/IP uses BACnet/IP
Broadcast Management Devices (BBMDs) to get messages through IS/IT routers. For
further details, see BACnet Broadcast Management Device (BBMD) in this chapter.
Figure 20 shows an example Ethernet BACnet/IP ALN configuration with two ALN
controllers. FLN buses can either be P1 or MS/TP:
P1 Three FLNs, 31, 31, and 30 devices per FLN, respectively; 4800 baud only.
MS/TP One FLN only (on Port 1), 96 FLN devices max.; 9600, 19200, 38900,
56800, 76800 baud rates available.
Master-Slave/Token-Passing
Master-Slave/Token-Passing (MS/TP) uses a token to control access to a bus
network. A master node can initiate the transmission of data when it holds the
token. Slave nodes may transmit data in response to requests from master nodes. In
MS/TP systems with multiple masters, the token determines which master can
initiate transmissions.
86
APOGEE MS/TP slave nodes never hold the token. So, a means is provided to allow
time for replies to be returned from slave devices. When a request that expects a
reply is sent to a MS/TP slave node, the master waits for the reply to be returned
before sending a request to another slave.
BACnet defines MS/TP for small networks with devices having lower speed
requirements; 1 Mbps or less over twisted pair wiring. MS/TP over EIA-485 provides
for small local networks that are up to 5,000 ft (1,524 m) long using shielded twisted
pair wiring.
With Firmware Revision 3.1 or later, BACnet MS/TP devices can be integrated into an
APOGEE Automation System directly. The driver communicates with Insight
software, other APOGEE field panels, and the BACnet MS/TP devices. See the
BACnet MS/TP section in this chapter.
For more information about the interaction and functionality between field panels and an
MS/TP FLN devices, see Chapter 6MS/TP Devices in the APOGEE BACnet ALN Field Panel Users
Manual (125-3020, January 2011).
LonTalk
LonTalk is the Echelon Corporations LAN technology. The Insight BACnet Option
cannot directly connect to a BACnet on a LonTalk network, but it can communicate
with such networks via BACnet third-party routers.
BACnet devices can utilize a LonTalk LAN to convey BACnet messages. This is
identical to the way that BACnet messages are transported by Ethernet, ARCNET,
and MS/TP. System designs, however, have steered away from BACnet messages on
LonTalk. BACnet is optimized more for applications related to field panels and
workstations. LonTalk, carrying proprietary LONMark messages, is the preferred
method for unitary controller products, terminal unit controllers, and smart
sensor/actuator applications.
CAUTION:
Although BACnet messages can be transported by LonTalk, this does not mean that native BACnet
devices can automatically communicate with any other device on a LonTalk network. BACnet devices
can only communicate with other BACnet devices. If a device on a LonTalk network uses Echelons
proprietary technology, for example, it will not be able to understand BACnet messages, which are
completely different.
As stated above, the Insight BACnet Option does not support direct connection to BACnet on a
LonTalk network.
87
Table 25 shows the BACnet layers and the equivalent OSI model layers.
88
BACnet Layers
Equivalent
OSI Layers
Application
N/A
Presentation
N/A
Session
N/A
Transport
Network
ISO 8802-2
(IEEE 802.2)
Type 1
Ethernet
ISO 8802-3
(IEEE 802.3)
Ethernet
ARCNET
MS/TP
PTP
EIA-485
EIA-232
Data Link
Lon Talk
Physical
89
On Insight versions prior to 3.11, the BACstac protocol was installed as a network protocol in network
settings. Installing the protocol on Insight versions after 3.11, follow the path: C:\Insight\BACstac and
then double-click the file bacstac.msi.
A new folder will be created: C:\ProgramFiles\Cimetrics\bacstac v6.0g
To make configuration changes to BACstac, double-click the file baccfg.bat located in the new
folder. A port table opens as shown below.
For more information about the OSI model, see the Networking Essentials for
APOGEE Application Guide (125-2011), posted on InfoLink.
In the application portions of the protocol, BACnet defines a typical device, objects
and information within a device, properties of the objects, and protocol services. For
detailed information on the BACnet protocol, refer to the BACnet Information Guide
(Copyright 2005 Siemens Building Technologies, Inc., P/N 153-912p10) and the online BACnet training modules available through Education Services (ES Online).
Insight Version
Cimetrics BACstac
Version
3.12
6.0-g
03/25/2010
125-3160-312
3.11
6.0-g
03/25/2010
125-3160-311
3.10
5.0-i
03/30/2009
125-3160-310
3.9.1
4.3-m
10/01/2007
125-3160-391
90
Figure 21. Native BACnet Devices Communicating Directly, All on the Same Network Type.
91
Figure 22. BACnet Devices on ARCNET and MS/TP LANs Communicating via BACnet Routers.
92
Figure 23. Native BACnet and Non-Native BACnet Devices Communicating through a Gateway.
BACnet Communications
BACnet/IP
BACnet messages can travel over networks that use the Internet Protocol (IP) by
using BACnet/IP. With BACnet/IP, the BACnet device is an IP device (IP node),
complete with its own IP address and IP protocol stack.
BACnet/IP devices communicate using BACnet messages wrapped in IP messages.
BACnet/IP messages can be unicast (point-to-point)from one device specifically to
another device, or broadcastfrom one device to many devices. Due to the
limitation of sending broadcast messages though IP routers, BBMDs (BACnet
Broadcast Management Devices) are used to send broadcast messages around IP
routers using a UNICAST message, which is a one-to-one IP message exchange.
A BACnet broadcast message can be:
Localon the same BACnet network as the source
Remoteon another BACnet network (but not its own)
Globalto all BACnet networks
93
Field panels configured for BACnet protocols on both the ALN and FLN act as
BACnet routers.
The logical group of devices in an ALN may span multiple physical network
segments.
The logical group of devices in an FLN may span multiple physical network
segments.
CAUTION:
More than one device set-up as a BBMD within a subnet will cause severe harm to the network, due to
redundant broadcast messages in the same subnet.
Sending data unprotected across a network poses a risk to the integrity of the system. Messages can be
hijacked via a Man in the Middle Attack and data intercepted, copied or modified. If the application
requires for data to be send across a Network the IT department responsible for the system shall be
involved to assess the risk and put measures in place to minimize such risk. Siemens Industry Inc
recommends the use of VLAN technology to protect data in transit. See Chapter 14 for further
information on cyber security.
94
An Insight workstation that acts as a BBMD for a subnet must have a fixed IP
address.
Every IP subnet with BACnet/IP devices must have a single BBMD so that
broadcasts from the BACnet/IP devices on one subnet can reach the BACnet/IP
devices on the other subnets.
Only 1 BBMD should be configured per IP subnet. If more than 1 BBMD is active on a subnet it will cause
the BACnet network to fail. If there is an existing network that is being integrated into, ask the third-party
technician, customer, or IT dept if a BBMD is already active on the network.
Each BBMD has a Broadcast Distribution Table, which lists all the BBMDs,
including itself, on the IP WAN. This table must be identical in all the BBMDs of a
particular IP WAN. This table also tells which broadcast method, one-hop or
two-hop, is to be used for each destination network.
There can be only one BBMD per IP subnet. Having more than one BBMD per IP
subnet will cause messages to be repeated in a loop.
One-Hop
Figure 24 shows the one-hop or directed broadcast method. Device A on Network 1
initiates a broadcast message that is received by the other BACnet devices and the
BBMD on Network 1. The BBMD sends the broadcast message to Network 2. The
message has a destination address which causes the IP router for Network 2 to
broadcast the message to all of the BACnet devices on that network.
95
Two-Hop
If the IP routers will not perform directed broadcasts, the two-hop or directed
unicast method, shown in Figure 25 must be used. Device A on Network 1 initiates a
broadcast message that is received by the other BACnet devices and the BBMD on
Network 1. The BBMD on Network 1 sends a directed unicast message to the BBMD
on Network 2. The Network 2 BBMD then broadcasts the message on its network.
96
97
Figure 26. BACnet Foreign Device receiving a Broadcast Message from a BACnet Network.
In addition,
Figure 27 shows that the BACnet foreign device workstation can send messages to a
BBMD with which it is registered, so they can be broadcasted.
Figure 27. BACnet Foreign Device Sending a Broadcast Message to a BACnet Network.
98
Manufacturer
Model
Number
Description
Cimetrics
BR2
Cimetrics
B6000
PolarSoft
FreeRange
Router
Dynamic Host Configuration Protocol (DHCP) is a network protocol that is used to configure devices which are connected to a
network (known as hosts) so that they can communicate on an IP (Internet Protocol) network. It involves clients and a server
operating in a client-server model. The DHCP server maintains a database of available IP addresses and configuration
information. When the server receives a request from a client, the DHCP server determines the network to which the DHCP
client is connected, and then allocates an IP address or prefix that is appropriate for the client, and sends configuration
information appropriate for that client. DHCP servers typically grant IP addresses to clients only for a limited time interval. DHCP
clients are responsible for renewing their IP address before that interval has expired, and must stop using the address once the
interval has expired, if they have not been able to renew it.
99
The BACnet Option supports communication with all BACnet devices regardless of networking
technology. However, the Insight workstation with the BACnet Option must be physically connected
to either a BACnet/IP network or a BACnet on Ethernet network.
BACnet Client
Figure 28 shows an Insight workstation with the BACnet Client Option connected to
a BACnet internetwork. When the Insight with the BACnet Client Option is enabled,
it allows viewing of third-party BACnet devices, and their points, on the BACnet
internetwork. The BACnet Client Option allows adding these BACnet devices to
BACnet ALNs connected to that particular Insight in System Profile. BACnet
networks, devices, and points are all imported into the Insight database. The BACnet
Client Option makes the BACnet network look like a ALN, and BACnet devices look
like field panels in the Insight workstation. Without having the BACnet Client Option
enabled, other Insight workstations can access these devices and points as if they
were APOGEE Automation System devices and points. The BACnet Client license
controls two things: reading BACnet points on a BACnet ALN, and commanding
BACnet points on a BACnet ALN.
BACnet Server
A BACnet Server is any Insight workstation connected to a P2/Ethernet ALN that has
points exported to a BACnet virtual network. The virtual network has a unique
network number that identifies the APOGEE and/or pre-APOGEE field panels to the
entire BACnet Internetwork.
100
Figure 29 shows an Insight workstation, with the BACnet Server Option, connected
to an APOGEE P2 ALN. The BACnet Server software is implemented as a Windows
service. It allows BACnet devices to read and command points residing in APOGEE
and pre-APOGEE field panels. This is because points residing in APOGEE and preAPOGEE field panels are represented as BACnet points in the BACnet virtual
network, accessible on the entire BACnet Internetwork. Likewise, APOGEE and preAPOGEE field panels are represented as BACnet devices on the BACnet virtual
network.
An Insight workstation with the BACnet Server option can only export the data of its own APOGEE
P2/Ethernet ALN (and ALN/P3) trunks. So, if there are multiple Insight systems, each with their own
APOGEE P2/Ethernet ALN (ALN/P3) trunks, then each of those Insight systems must have the BACnet
Server option enabled.
BACnet MS/TP
Firmware 3.1 or later was designed to create an extremely BACnet-compliant field
panel. Features include support for RS-485 MS/TP ALN and RS-485 MS/TP FLN.
Additionally, with firmware 3.2 or later, the PXC Modular controller can act as a
BACnet/IP ALN to BACnet MS/TP ALN router. This allows the customer to configure
BACnet networks for Ethernet and serial EIA-485 networks as needed (see Figure
33).
CAUTION:
Upgrading to Firmware 3.1 or later: Changes to the database will occur when upgrading BACnet
MS/TP devices that are currently integrated using the BACnet MS/TP Driver with Firmware Revision
3.0, due to point naming changes.
101
102
: Y
: 38400--: 14---
: 0--
: 60---
: 60---
Figure 30: Example HMI Command String for Setting MAC Address to Zero on BACnet Field
Panels for MS/TP Networks.
Set master devices at an address equal or lower than 127 and set slaves devices at
an address higher than 127. Master devices should be addressed starting with 1 and
number them sequentially without any gaps. This will make your network more
efficient.
If you set a slave BACnet TEC at an address lower than or equal to 127, then the only
way to change it back to a master is to go out to the device, connect with WCIS and
change it (you have to go to the device) - if you do it by using the address only, then
you can change it from the front end, by changing the address. Even though the
BACnet specification allows lower number (0-127) devices to be slaves, that is not
the best practice. Keep Masters addressed at 127 and below and Slaves at 128 and
above.
The max master setting should be left at the default of 127 for all of the Masters
devices except the last (highest numbered) Master on your FLN. (Some branches do
the highest two Master devices in case one Master device fails.) The setting for max
master should be one higher than the highest Master MAC address. This stops the
MS/TP network from "polling for master devices" higher than the max master all the
way up to 127 (which could affect performance).
103
If a customer's FLN network consists of only Siemens BACnet devices - we could set
all of the Siemens TECs/PTECs as slaves to get better performance. Setting the
devices as masters still has the advantage of making the TEC data available through
the BACnet Object Browser, so if there are just a few devices setting them all as
masters might still be preferable. Also, if all of the devices are slaves we should set
the first or second as master devices with a max master setting of 2 or 3 so that
polling for masters stops there and does not try to find each master up to 127. (This
does improve performance).
Point Pickup Modules (PPMs) should be addressed as the first devices on the FLN.
Since the PPMs, when set up as MASTER, support COV subscription (unlike our TECs)
they are quick to respond to changes and you can see them update on the graphics
faster than anything else.
For MS/TP network-numbering we are allowed to use network numbers up to
65534. If a panel has an Instance number in that range then we suggest using the
panel's instance number as the MS/TP network number for the connected FLN. Any
network numbers in the range and not currently in use are allowed, but numbering
by the panel's instance number lets you know immediately where the TEC is
attached to if you are looking at any reports that show the network numbers. If
there is another standard in place, then of course you should use that!
Wiring
When wiring an MS/TP network where P1 devices are being replaced by MS/TP
devices, the two allowable choices are to use the TSP wiring that exists at the
facility, or rewire using the three wire 1.5TSP. You will get much better performance
and you will be able to support a larger number of MS/TP devices with 1.5TSP
wiring. 1.5TSP is preferred.
When wiring with 1.5 TSP wiring, the plus and minus (White/Black typically) wiring
connects to all devices, the third wire (typically yellow) connects to all devices that
have a three wire input (some third-party devices have only plus and minus) at the S
pin or ? (equipotential ground) and at the field panel the yellow wire and a 100 ohm
PTC thermistor are attached to the S pin. The other side of the thermistor is
connected to earth ground. For devices that do not have the third wire connection
point the yellow wire should be wire nutted together so that the rest of the devices
further down the MS/TP network still have the same reference potential.
The last step in the wiring is to attach a 120 ohm resistor (End-of-Line Resistors) at
each end of the MS/TP network (both ends). They should be connected from plus to
minus at the device. This resistor knocks down the amplitude of the "bounce back"
signal to prevent it from interfering with the normal communication signal. These
"end-of-line" (EOL) resistors are not optional.
104
MS/TP uses an RS-485 wiring standard. In reality you will see performance issues if
you put more than 50 or so devices on an MS/TP FLN. This is not an electrical
limitation, it is a limitation of the amount of communication that occurs on an FLN
network (how much the devices talk). The more information that each device has to
communicate, the longer it takes. You can have up to 32 "unit loads" on an MS/TP
(RS-485) network. For Siemens FLN devices, our current TECs are rated at load.
Older versions may be full load or load. According to the RS-485 standard, this
means that in theory, our FLN could support an electrical load of 256 devices if they
were all load devices, but it would never work on a real job. Refer to Table 24 for
the practical limitations of the maximum number of MS/TP Devices per FLN Field
Panel.
If you are going to have more than 32 MS/TP devices on an FLN, you MUST use
either a PXC36 or a PXC Modular controller, and you must verify that the MS/TP
devices are NOT full load electrical devices. If the MS/TP devices are full load
electrical devices, or you are not sure, then you must also plan for 485 repeaters on
the FLN.
Third-Party Devices
If you are able to separate third-party devices on their own MS/TP FLN, then do so.
The issues will then be isolated to their FLN, and will not affect our devices. (Cost
may prohibit this option) A good example of this is ABB Drives. They do not support
Read Property Multiple (RPM), which means they are slow at sending data and can
slow down an MS/TP network. In reality it is unlikely that you will be able to do this
because of the additional costs involved.
Most third-party devices can be master only. ABB and a few others are exceptions as
they can be set as Master or Slave. All third-party devices should be set as masters
so that we can see and interact with them easily.
On an MS/TP network with other third-party vendors that need access to our TEC
data, all TECs should be set as masters.
If you have third-party devices that send out broadcasts frequently on the subnets
where the master devices reside, take the necessary steps to isolate the device or
stop it from constantly broadcasting.
If you put third-party devices on the same FLN as our master devices, make the
third-party devices the first devices on that FLN - 1, 2, 3, 4, etc. There are two
reasons for this setup:
If the third-party devices have a max master setting of 127, we may not be able
to change it (this happens often in the field). If you put our devices at a higher
105
address, and we use a lower max master setting, then it wouldn't matter if
theirs was set to 127.
It seems that the field panel is more tolerant when token passing to the thirdparty devices than when our TECs are talking to third-party devices. If you put
the third-party devices first then our TEC doesn't have to talk to it. The reason
is, the TECs have a very short timeout and will mark a device as failed if it does
not respond within the 40ms window. Field Panels wait longer.
Master or Slave
If the network is properly set up, having all slave devices will be slightly faster, but
probably not enough that it will make a significant difference to the end user.
Always set all MS/TP devices up as master devices, because that is the standard with
almost all of the third-party vendors. This would retain the ability to discover the
devices with the BACnet Object Browser or any third-party software, or devices that
are added to the network later. 50% of the field people use master devices, 50% use
slave devices.
The field panel node address on an RS-485 MS/TP ALN is selectable: 0 254
The field panel requires a unique BACnet Network ID for the ALN: 0 65534
106
Only PXC Modular and PXC Compact support 76800 baud rate. For more information, see Product
Announcement 700 - BACnet Field Panels on Firmware Revision 3.1.
The field panel ALN is a logical grouping of MS/TP nodes and IP nodes
In general, faster baud rates will increase performance on the network, so that
76.8Kbps will perform faster than 19.2Kbps, for example. However faster baud
rates do increase sensitivity to RS-485 wiring guidelines. Every device on the
network must support and be configured for the same baud rate.
If devices on the BACnet MS/TP network are master devices, then set the MAX
Master address equal to the highest address occupied with a physical device on
the network, and do not skip addresses.
Since Siemens devices resident on a BACnet MS/TP ALN are treated as field
panels to be backed up and monitored by APOGEE Insight, network traffic
between these devices and APOGEE Insight is heavy. This limits the number of
devices that may productively reside on a single BACnet MS/TP ALN network to
no more than 10 devices, depending on point counts and network activity.
Network performance may drop significantly as Siemens field panels are added
to the MS/TP ALN.
Note that additional BACnet MS/TP ALN networks may be added without
compromising network performance through an additional PXC Modular.
Third party BACnet MS/TP devices may be added to a BACnet MS/TP ALN. Note
that for best network performance, COV subscription should be supported and
used by the third-party devices.
107
There can only be a total of ten MS/TP ALN devices on an ALN, including the
router.
In May 2011, a Technical Support News article titled BACnet MS/TP ALN Limitations stated that
(BACnet) field panel firmware 3.1 and higher allows you to utilize BACnet MS/TP ALNs. When
using a BACnet MS/TP ALN, there are three requirements:
1.
PXC Modular or PXC Compact 36 are required to connect the BACnet/IP segment to the
BACnet MS/TP segment.
2.
3.
For example, if you have two PXC Modular and two PXC Compact 36 field panels, and each has
nine PXC compacts connected to the MS/TP ALN port, you would need to define four separate
ALNs in your System Profile.
108
Supports back-up and restore of database for Siemens field panel devices
All objects in device need updating, which creates additional network traffic vs.
FLN
Support for BACnet MS/TP FLN on a BACnet MS/TP ALN device is extremely
limited and not recommended due to performance considerations.
Supports Siemens BACnet TECs, but treated as MS/TP ALN level devices in
system, which means certain FLN functions are not supported: initial values,
global commands, drag and drop FLN reports.
A disadvantage for a TEC on an ALN is low performance due to more traffic. Better performance
can be gotten on a FLN.
The MS/TP FLN is similar to the APOGEE P1 FLN but has other unique features
Unlike P1, the field panel has a node address on the MS/TP FLN: 0 254 (128
254 are reserved for slave devices)
The field panel requires a unique BACnet Network ID for the FLN: 0 65534
109
110
In general, faster baud rates will increase performance on the BACnet MS/TP
network, so that 76.8Kbps will perform faster than 19.2Kbps, for example.
However faster baud rates do increase sensitivity to RS-485 wiring guidelines.
Every device on the network must support and be configured for the same baud
rate.
BACnet MS/TP devices resident on a BACnet MS/TP FLN are treated as FLN
devices with Point Teams automatically created in the field panel. The Point
Siemens BACnet TECs are supported by the field panel and APOGEE Insight with
initial values support, and drag and drop reports.
Field Panel
Number of
FLN Ports
Recommended Recommended
Number of TECs
Number of
per FLN for
TECs per Field
Typical
Panel for
Typical
Expected
Performance
Expected
Performance
Specified
Maximum
Number of
BACnet
MS/TP TECs
per FLN
32
32
32
50*
50*
96
* These numbers take into account the performance considerations in Table 25.
Performance Factor
Criteria
Impact to Performance
111
Performance Factor
Criteria
network.
Impact to Performance
address used on MS/TP FLN
network. Unused addresses
(including unused high addresses,
low addresses, or skipped
addresses) in token pass networks
waste bandwidth and creates
inefficient performance. Avoid
skipping addresses on MS/TP
networks and set Max Master in
field panel as described.
If MS/TP devices are set to slave
devices, be sure to set Max master
to 0.
112
Performance Factor
Criteria
Impact to Performance
update information.
In general, expect that BACnet MS/TP FLNs will perform slower than P1 FLNs
due to:
Increased communication requirements for BACnet MS/TP compared to P1
Lack of COV support in many BACnet MS/TP devices (including current
Siemens BACnet TECs)
Token passing when MS/TP devices configured as masters require
additional communication time
High volume of devices on single physical network which adds to
communication time.
Despite the significant increased speed of the BACnet MS/TP baud rate over the
P1 baud rate, the actual communication response is slower due to the factors
cited above.
There are adjustable parameters in BACnet MS/TP that can greatly influence the
performance of the network. These parameters include the following:
113
BACnet TEC Network performance optimized through auto point team creation
for each unique application
Max. of 99 devices on MS/TP FLN - based on 1/4 load SBT BACnet TEC devices
Alarms require virtual point residing in field panel, since BACnet TEC does not
support Notification Class
PXC Compact resident on BACnet MS/TP FLN will look like third-party device to
Insight
114
Proprietary objects and properties are not supported on BACnet MS/TP in 3.1
firmware, only supported in the BACnet MS/TP Driver
BACnet MS/TP ALN devices are extremely limited in BACnet MS/TP FLN support;
always use BACnet/IP for device managing BACnet MS/TP FLN as general rule.
In BACnet MS/TP mode, the driver allows a physical connection to FLN 1 only.
It can support up to 255 BACnet MS/TP devices, of which up to 126 of them
can be masters.
The actual number of BACnet MS/TP devices that the driver can support is
dependent on the devices themselves, the number of points per device,
and their electrical constraints.
In BACnet/IP mode, the driver communicates through the Ethernet port with
other BACnet/IP devices using FLN 6 as a virtual FLN. Theoretically, the driver
can support up to 255 BACnet/IP devices; however, the actual number of
BACnet/IP devices that he driver can support is dependent on the devices
themselves, the number of points per device and the electrical constraints.
115
Figure 33. Typical BACnet Driver and APOGEE Automation System Integration with BACnet MS/TP Devices
(Firmware Revision 2.x).
116
The BACnet Driver will not affect, in any way, the operating sequence or safeties as
factory-programmed into the BACnet system.
Systems integration brings the powerful facility control capabilities of the APOGEE
Automation System together with BACnet system. With the BACnet Driver, two
unique features are available that are NOT available with standard APOGEE
firmware 3.x:
1. Unique point names can be defined for BACnet points at the APOGEE Insight
workstation.
2. The APOGEE Insight workstation has ability to filter BACnet points used in
various Insight reports.
Integrating the BACnet points allows both systems to operate as a single system
providing marked advantages in the following:
117
Figure 34: Typical BACnet Driver System Configuration with BACnet MS/TP Devices (Firmware Revision 3.x).
118
Figure 35: Typical BACnet Driver System Configuration with BACnet/IP Devices (Firmware Revision 3.x).
Third-party BACnet devices and objects require that an application point map be
programmed in the driver. Third-party devices must support BACnet MS/TP protocol
as slave devices.
The major differences between the BACnet Driver and the 3.1 firmware with built-in
BACnet MS/TP support are as follows:
The Driver does not support auto point team creation, but rather relies on
Application Builder, part of Commissioning Tool so that the user must manually
create the applications. This allows the user to select and de-select points for
monitoring which can have a positive impact on performance, and allows the
user to change the point names to suit the user.
The Driver operates best when all devices on the MS/TP network are slave
devices, which allows the Driver to poll the devices fast and efficiently, and at
the same time cache information in memory to serve Insight and other clients
with the latest information about the devices quickly and efficiently.
119
Product Announcement 638R2 BACnet Field Panel Firmware Revision 3.0 and
Insight Revision 3.7 or later BACnet Option Product Announcement 700 - BACnet
Field Panels on Firmware Revision 3.1
BACnet TECs
The BACnet TEC communicates over the FLN trunk using the BACnet MS/TP
protocol. BACnet TECs should be configured as slave devices to ensure optimal
performance. For details on integrating BACnet TECs using the BACnet MS/TP Driver,
see:
Table 30 is a brief description of how the BACnet Field Panel revisions support FLN
devices. For more detail, refer to the Release Notes on the various firmware
revisions available from the hyperlinks on InfoLink for the various firmware revisions
are given below.
Table 30. BACnet Field Panel Revisions and FLN Functionality.
APOGEE F/W
Revision
120
Description
Rev. 2.6.2
(BACnet Early Edition)
Rev 3.0
Rev 3.1
APOGEE F/W
Revision
Rev 3.2
Description
Supports Algorithmic (Event Enrollment) Alarming for MS/TP FLN device points
and other off-node devices that do not support the BACnet Event Enrollment
object, such as certain third-party devices.
Supports PXC Compact 36, which can have up to 96 FLN devices on one RS-485
connection or split between two connections.
Per a Technical Support News article dated January 2013 titled
BACnet MS/TP Guidelines, MS/TP uses an RS-485 wiring standard.
In reality you will see performance issues if you put more than 50
or so devices on an MS/TP FLN. This is not an electrical limitation, it
is a limitation of the amount of communication that occurs on an
FLN network (how much the devices talk).
P1 FLN supports wireless field level network (WFLN) to allow use of wireless FLN
TECs.
3.2.2
3.2.3
This firmware version featured the first release of the Field Panel Web Server.
Other features and functionality enhancements included:
PXM10T/S
Firmware version 3.2.3 also supported the following new features and
functionality enhancements:
Facility To Go
121
APOGEE F/W
Revision
3.2.4
Description
This firmware version was the first to be designed and
tested and receive the BTL listing against the updated and
more stringent ANSI/ASHRAE Standard 135-2008. When the
APOGEE Field Panel Viewers and Editors files are uploaded
into the
panel, the following features and functionality are
supported:
Support for BACnet Create Trend Log service
Point Editor UI for Desigo CC
PPCL Editor UI for Desigo CC
TEC Editor UI for Desigo CC
TEC Subpoint Log, Commander, and Initial Values UI
for Desigo CC
BACnet TECs
When using a router, the BTEC looks like a third-party device, and all
communications are purely BACnet. When using a router in an APOGEE Automation
System, the BACnet MS/TP devices appear in System Profile as ALN/ALN third-party
devices.
One of the downsides of using a router in an APOGEE Automation System is that
virtual points must be created in the field panels to support alarms and trends. This
is because with a router, the points on the BTEC are only in its own database and not
in a field panel. The field panel only supports trend and alarms on points in its own
database. The solution is to create virtual points in a field panel. The virtual points
can then be trended and alarmed.
122
123
Figure 37. Insight with a Ethernet MLN, a Dedicated P2 ALN, and a BACnet ALN on Separate Networks.
One Insight workstation contains two network interface cards; one for connection
with the BACnet ALN and the other for connection with the MLN. The BACnet Option
must be configured as a BACnet Server for the third-party BACnet workstation to see
the P2 devices and points. The BACnet Option must be configured as a BACnet Client
for Insight to view the devices and points on the BACnet ALN.
Using 2 Network Interface Cards [NIC] can separate the ALN from the customers
network if separate Ethernet infrastructure is deployed. This will add a considerable
level of security for the end users network and should be recommended.
124
One Insight workstation contains one network interface card for connection with the
Ethernet LAN. The BACnet Option must be configured as a BACnet Server for the
third-party BACnet workstation to see the P2 devices and points. The BACnet Option
must also be configured as a BACnet Client for Insight to view the devices and points
on the BACnet ALN.
Connecting the BAS network directly to the corporate network of the end user poses
significant security risks is not recommended. If the network infrastructure
hardware needs to be shared a separate VLAN needs to be set up for the BAS.
125
Figure 39. Insight with a Remote AEM ALN and a BACnet ALN.
One Insight workstation contains one network interface card for connection with the
Ethernet LAN. The BACnet Option must be configured as a BACnet Server for the
third-party BACnet workstation to see the P2 devices and points. The BACnet Option
must be configured as a BACnet Client for Insight to view the devices and points on
the BACnet ALN.
126
Figure 40. Insight with APOGEE and Third-party BACnet Field Panels on Common Network.
127
One Insight workstation contains one network interface card for connection with the
Ethernet LAN. The BACnet Option must be configured as a BACnet Client for Insight
to view the APOGEE and BACnet third-party devices and points on the BACnet
network.
128
Figure 41. Insight with Routers Using BACnet Broadcast Management and Foreign Devices.
The Insight Database Server acting as a BBMD must have the BACnet Option. Its
Broadcast Distribution Table must contain the IP address of all of the BBMDs in the
BACnet network segment. The Foreign Device, Insight, and field panel are on
subnets without BBMDs, so each of these foreign devices must register with a BBMD
to receive broadcasts from the devices on all of the other subnets.
129
130
The APOGEE Automation System supports both one hop BBMDs and two hop
BBMDs simultaneously as follows:
If the entry in the BBMD table has a 32 bit mask (255.255.255.255) then that
specific entry in the table is two hop. The APOGEE Automation System forwards
messages to a two-hop BBMD, and expects that two-hop BBMD to rebroadcast
the message on its local subnet.
If the entry in the BBMD table has less than a 32-bit mask (255.255.0.0), then
that entry in the table is a one hop. The APOGEE Automation System sends a
directed broadcast directly to the one-hop BBMDs subnet, and expects the onehop BBMD to do nothing (no rebroadcast by the one-hop BBMD).
131
Since not all IP routers are configured to pass directed broadcasts, a BBMD may be
configured to send a directed message (UNICAST) to the BBMD on the remote
subnet, called two-hop distribution. This method then transmits the message using
the BACnet/IP broadcast address. The two hop method is the preferred method and
most universally applied.
Foreign Device
An APOGEE field panel can be defined as a Foreign Device by selecting the Foreign
Device button in the BACnet Field Panel Definition dialog box (brought up by clicking
on the desired field panel in the Insight System Profile application). The Foreign
Device Settings dialog box (Figure 43) allows activating the Foreign Device feature,
entering the BBMD port and address to which the field panel is registered, and the
time to live before re-registration is required.
132
Cross-Trunk Communications
The Insight BACnet Client Option allows Insight and APOGEE P2/Ethernet field panels
to read and command point-like objects in the BACnet devices (APOGEE 3.x field
panels and third-party devices). Access in the other direction is not available. That is,
the BACnet devices cannot access points in the APOGEE P2/Ethernet field panels
without using the Insight BACnet Server Option. Thus, a BACnet device cannot
subscribe to have COVs sent from a point in an APOGEE P2/Ethernet field panel.
Normally the Insight BACnet Server Option, which supports subscribing to COVs, is required if thirdparty BACnet network devices must access points on the APOGEE P2/Ethernet networks.
However, since APOGEE P2/Ethernet field panels can initiate actions in BACnet
devices, sending COVs from an APOGEE P2/Ethernet point can be duplicated by
commanding a BACnet point-like object to the value of the APOGEE P2/Ethernet
point. For example, assume it is desired to send the value of the physical outside air
temperature point, OAT, from an APOGEE P2/Ethernet PXC to a BACnet third-party
device (Figure 44). An Analog Value Object, VIRTUAL_LAO, is created in an APOGEE
BACnet 3.x PXC. A line of PPCL code in the APOGEE P2/Ethernet PXC sets the value of
VIRTUAL_LAO equal to the OAT value. Then, the APOGEE P2 Ethernet PXC sends the
points value to the BACnet device using conventional cross-trunk point command
mechanisms. (The value of VIRTUAL_LAO is ultimately determined by its Command
Priority Array.) To send this value to other devices on the BACnet network, COV
subscription is used between BACnet panels. (For more information, see BACnet
Network COVs section in this chapter.)
Figure 44. BACnet Receiving COVs from the APOGEE Automation System.
133
Figure 45 shows an example of how to command a BACnet point from the Insight
Scheduling Application. The name of a BACnet Analog Value Object point,
VIRTUAL_LAO, is entered into the Zones Command Table. When this point is
commanded, the Insight cross-trunk service sends the command to this point in the
BACnet 3.x PXC. PPCL code in the BACnet 3.x PXC sets a BACnet Command Object
Present Value equal to the value of VIRTUAL_LAO. The Command Object will then
execute its commands based on its new Present_Value.
CAUTION:
Watch for APOGEE Zone Command Table values of 0 (zero). The BACnet Command Object will not
accept 0 (zero) for its Preset_Value. The BACnet Command Object will not accept 0 for it
Present_Value. You may have to add 1 to the Virtual_LAO value in the BACnet panel PPCL code
(Figure 45).
See the SSTO section in Chapter 7BACnet Scheduling for an example of how to use
the APOGEE Zone mode sub-point to command mode PPCL in the BACnet 3.x PXC.
134
This feature is available only in SBT 3.x BACnet field panels. The Unsolicited COV
Subscription List dialog box (Figure 46) is accessed in the Insight workstation from
the Field Panel Definition dialog box by selecting the Unsolicited COV button. The
button is grayed out for third-party field panels. Communication is limited to BACnet
networks with the Insight BACnet Client Option. Use cross-trunk communication
(see the Cross-Trunk Communications section in this chapter) to send an APOGEE
P2/Ethernet devices COVs to a BACnet network device. With the Insight BACnet
Server Option, use BACnet Network Device registration for COVs.
COV recipients can be selected by name or Instance Number, in which case the COV
notification goes specifically to that recipient. Alternatively, a Global Broadcast can
be chosen in which case it will be sent to all BACnet devices on the network. If
Global Broadcast is chosen and there are IP routers on the network, the global
broadcast messages will go through the BBMDs to traverse the IP routers.
135
Trend collection tests conducted in the 2006 time frame at network data rates from
56K to 100 megabits per second have shown added network traffic to be less than
1% for all collections. Database downloads, database uploads, graphic updates, and
multiple alarm displays on graphics and in alarm windows have given similar results.
Thus, it is reasonable to expect that no burst traffic from an APOGEE BACnet system
will generate significant network traffic.
Average network traffic (normal steady state conditions) will be significantly less
than burst traffic.
Device Discovery
Discovery is a BACnet process that enables a device to find new devices on the
network. The discovery process involves broadcasting Who-Is messages and listening
to resulting I-Am messages (as well as other I-Ams from other processes and
applications). For example, an APOGEE BACnet field panel broadcasts an I-Am
message at startup (warm or cold) and anytime DHCP changes the IP address.
One way that the Insight workstation uses the device discovery is to enable it to
populate the ALNs in the System Profile. Insights device discovery puts devices on
specific ALNs based on criteria (filtering) established by entries in the BACnet
Connection Settings dialog box (Figure 47). The devices that are found can be from a
third-party or from Siemens.
136
137
Enable Device Discovery is defaulted to the disabled state because filter setups
should be done first before device discovery. The recommended workflow is as
follows:
1. Set up ALN filters using the Network Connection Settings dialog box. Filtering
means defining which BACnet devices are on each ALN. For example, devices
may be filtered by manufacturereach ALN will contain devices from one
particular manufactureror devices may be filtered by BACnet network number.
In engineering a BACnet system, a document should be created defining in which
ALN each device (field panel) resides. This can be a simple table or Excel
spreadsheet.
2. Enable Device Discovery and then Global Broadcast Who-Is. Insights Global
Table Services then starts processing I-Am responses and putting devices in the
proper ALN in the System Profile.
3. Use Cloaking to remove those field panels that shouldnt be seen in the System
Profile. Cloaking prevents discovery from re-adding the panels to System Profile.
Device Discovery may not put some BACnet devices anywhere due to peculiarities (or errors) in the
filtering scheme. It is recommended to set up a catch-all ALN for these orphan devices. This will help
avoid having lost devices and bring to light any filtering issues.
The catch-all ALN should have no restrictions (filtering) at all in the BACnet Connection Settings. The
Device Discovery process searches the ALNs with the most restrictive filtering criteria first when
attempting to put a newly discovered device onto a ALN. Then ALNs with fewer restrictions are
considered. If the new device does not fit in any ALN with restrictions, it will be placed in the catch-all
ALN.
138
Some third-party field panels may not respond to the Who-Is messages sent out
during device discovery. These devices can be added manually using the traditional
System Profile methods for adding a device to a ALN. Such devices will often need to
be added to APOGEE BACnet field panel address tables. Address tables are accessed
through the BACnet Address Table dialog box. To display the BACnet Address Table
dialog box, select BACnet Address Table on the System Menu.
Time Synchronization
The Insight software offers the option to synchronize the time of BACnet devices on
a ALN. Some low-capability BACnet devices need to be told the time on a periodic
basis. Also, if doing extensive trending, time synchronization is important when
comparing the trend results of one field panel to those of another field panel.
Time synchronization for BACnet is not broadcasted. It is sent specifically to those
devices on the ALN that have subscribed. The subscription list is called the Recipient
List, and time synchronization is sent to each device on the Recipient List. APOGEE
3.x field panels are subscribed by default.
Time synchronization occurs once a day at 2:00 A.M. (configurable) or can be forced
manually by clicking the Set Time button in the Building-Level Network Definition
dialog box (Figure 49).
The synchronization time comes from the clock of the Insight workstation to which
the ALN is assigned in the System Profile. In a system with multiple Insight
workstations, each with their own ALNs, Windows time synchronization mechanisms
must be used to synchronize all of the workstations and, thus, the whole system. For
example, the workstations can be synchronized to an atomic clock or to one
Windows server.
139
Time synchronization is set up for devices on an ALN through the Building Level
Network Definition Dialog box from System Profile. The Recipients button opens the
Time Synchronization Recipient List dialog box (Figure 50) in which three choices are
given for each device:
140
Do not Sync
141
System Configuration
Each physical segment is identified with a unique BACnet Network Number, 1
through 4. These are arbitrary numbers, unique job-wide, assigned by the person
configuring the BACnet routers.
Each BACnet device is user-assigned a BACnet Device ID (Device Instance Number)
that is unique job-wide. The BACnet Device Number can be 0 through 4,194,303 (222
1).
Although a BACnet device does not know its own network number, each BACnet
device is uniquely located by its BACnet Address:
BACnet Address = BACnet Network Number + MAC Address
142
The MAC Address is programmed into the network interface of each BACnet device.
Depending on the network technology, the MAC address may be user-configurable
or may be permanently set at the factory. The structure of the MAC address varies
based on the networking technology:
For BACnet/IP, the MAC address is the IP address + 2 bytes for the UDP port
(usually 47808). These 2 bytes equal 186.192 in decimal or BA.C0 in
hexadecimal. Therefore, the MAC address for a device in Subnet 3 can be
represented in decimal as 136.157.38.29.186.192, or in hexadecimal as
88.9D.26.1D.BA.C0. For a BACnet Field Panel, the BACnet MAC address is
displayed in the BACnet Field Panel Definition dialog box either in Decimal
(Figure 52) or Hexadecimal (Figure 53).
Figure 52. BACnet Field Panel Definition Dialog Box with Decimal MAC Address.
143
Figure 53. BACnet Field Panel Definition Dialog Box with Hexadecimal MAC Address.
There are three BBMDs on the BACnet/IP networkone on each IP subnet. On this
job the BACnet/IP segments have subnet masks of 255.255.255.0.
The BBMDs move BACnet broadcast messages through the IS department routers.
BBMDs are only used on BACnet/IP networks. The domain of the BBMD is a single
BACnet/IP network (network number). Therefore, hypothetically, if (in Figure 51)
BACnet Network No. 4 were BACnet/IP instead of Ethernet, its BBMDs would not be
in the BBMD table of Network No. 2 and vice versa.
BBMDs provide more functionality and expandability than multiple foreign devices
on a segment. Foreign devices each use bandwidth, so the more foreign devices, the
more bandwidth that is used. BBMDs are more efficient: One BBMD message occurs
instead of multiple foreign device messages. Also, additional devices hookup easily
(no foreign device setup).
144
The LocalNet Configuration Utility is located under Insight in the Windows Programs
menu (Figure 54). Full details of its use are covered in the Getting Started
documentation. After installing Insight software and rebooting, select both or either
of the BACnet Client and/or the BACnet Server.
145
The BACnet Server Option must be set up to export P2 (ALN) points to a BACnet
virtual network. The process to set up the virtual network is documented in the
Getting Started documentation. It is similar to choosing the network interface card
(NIC) on the computer through Windows Start, Settings, and Network Connections.
Working down from the Local Area Connection Status dialog box (Figure 55) through
the Local Area Connection Properties (Figure 56), the virtual network is added to the
Port Table in the Cimetrics BACstac Routing Edition v4.x Protocol Properties (Figure
57 and Figure 58). Unlike a physical network, a virtual network is not related to a
NIC. See the entry for Port ID 2 in Figure 57.
146
147
When selecting a Network Number for the Virtual Network, make sure to use a
number NOT used by any other BACnet Network on the job.
The Insight workstation must be rebooted to make the virtual network settings take effect.
When a BACnet device starts up, it typically does a global Who-Is broadcast to
discover the other devices on the network. A Who-Is expects to receive an I-Am
response (Device Instance Number + BACnet Address) from other devices. A BACnet
device also may do an I-Am on startup, to advertise its presence on the network.
After the global broadcasts, device communication is usually just device-to-device.
148
APOGEE BACnet Field Panel how it differs from traditional non-BACnet (Protocol 1 or 2)
field panel communication and data handling
HMI
Both the BACnet and APOGEE protocols have a function, the BACnet function (or version
of the function) is implemented.
APOGEE provides a function that the BACnet protocol does not support, the APOGEE
function is retained as long as it does not interfere with BACnet functionality.
This approach to BACnet implementation retains much of the APOGEE feature set while providing
100% compatibility with the BACnet protocol.
Table 31 below provides a comparison of the point and application differences between
APOGEE P2 and BACnet field panels.
Table 31: Comparison of the Point and Application Differences Between APOGEE P2 and BACnet Field
Panels.
System
APOGEE P2
(RS-485 or Ethernet)
Function
APOGEE BACnet
Names
30-character limit
Unique point names within devices are required.
Unique point names system-wide is not technically
required. (Insight DOES require uniqueness)
149
System
Function
APOGEE P2
(RS-485 or Ethernet)
APOGEE BACnet
Integrated BACnet
Device Names
Not supported
Alarming
Standard Alarming
BACnet Alarming
Enhanced Alarming
Notification Classes
Event Enrollment (3.2 or higher panel firmware)
No Enhanced Alarm functions with alarm prioritization or
escalation
Time delay and Deadband alarm characteristics are
standard features
Trending
Equipment
Scheduling
Scheduling accomplished
through zones and events
coordinated with PPCL.
Zone command table for
individual point
commanding.
Field panel
Field Panel
upload/download
Database
Upload/Download
150
In addition, BACnet Programmable TECs (PTECs) have been introduced since this guide was
last published (in 2007). BACnet Programmable Terminal Equipment Controllers (PTEC) are
application-specific equipment controllers designed to provide stand-alone Direct Digital
Control (DDC) for various types of HVAC terminal units. Table 32 lists the PTEC controllers
orderable at the time of this writing. For more information, refer to the BACnet
Programmable TEC (PTEC) User Manual, the BACnet Programmable TEC (PTEC) Technical
Reference or the BACnet Programmable TEC (PTEC) Configuration and Sizing Guidelines
documents hyperlinks to these documents posted on InfoLink.
151
Product No.
Firmware
Revision
BACnet PTEC
Terminal
Box/VAV
Controller
550-495P
VAV pressure
independent
6520, 6521,
6522, 6523,
6524, 6525,
6526, 6527
(6587)
BV40 Rev
2.0.0.19
BACnet PTEC
VAV with Series
Fan and 3-Stage
Electric Heat
Controller
550-492P
VAV pressure
independent
6557 (6599)
BH40 Rev
2.0.0.21
BACnet PTEC
Unit Conditioner
(Fan Coil)
Controller
550-496P
VAV pressure
dependent Fan
Coil Unit
6540, 6541,
BF40 Rev
6550, 6551,
2.0.0.19
6552, 6553, 6554
(6591)
BACnet PTEC
Unit Vent
Controller
BACnet PTEC
Heat Pump
Controller
BACnet PTEC
Extended
I/O Controller
BACnet PTEC
Dual Duct
Controller
550-493P
Unit Ventilator
BE40 Rev
2.0.0.20
550-490P
Multi-Stage
Compressor
6575, 6576,
6577, 6578, 6579
(6595)
6583, 6584
(6590)
550-491P
I/O Expansion
Module
6596
BI40 Rev
2.0.0.17
550-497P
550-498P
Electronic
Output
BACnet PTEC
Constant
Volume
Controllers
6565, 6566,
6567,
6568, 6569
BK40 Rev
2.0.0.20
The following table from a draft copy of the BACnet Network and Troubleshooting Manual 7
provides a quick reference for hardware supported by BACnet Firmware and the ALN and FLN
options supported by each type of hardware.
6
152
Table 33: Quick Reference for Hardware Supported by BACnet Firmware and the ALN and FLN Options.
Field Panel
PXC Compact 24
PXC Compact 16
ALN
BACnet/IP
FLN
Optional depending on model requires
FLN license
P1 or BACnet MS/TP (Configurable FLN:
controller supports either one P1 FLN or
one BACnet MS/TP FLN).
Supports up to 32 BACnet or P1 TECs
on single FLN network.
PXC Compact 36
BACnet MS/TP
BACnet/IP
BACnet MS/TP
PXC Modular
BACnet/IP and/or
BACnet MS/TP
BACnet/IP
Power MEC
BACnet/IP
BACnet/IP
Lon-Talk
CAUTION:
The Power MEC is now retired but is still sold on the repair parts (Rparts) program until
October 1, 2017. Refer to POA-001.
At the time of this writing, this manual is not yet published or posted anywhere on the Siemens Intranet.
153
The PXC Compact 36 includes (2) RS-485 connections which are marked B and A.
HMI prompt?
ALN
Connection
BACnet/IP
MS/TP ALN
MS/TP FLN
BACnet/IP
P1 FLN
(FLN2)
P1 FLN
(FLN1)
BACnet
MS/TP
ALN
FLN
S, H, F, C, A, M, M (System, Hardware,
Fieldpanels, Config, Aln, MS/TP, Modify)
Some of the BACnet controllers can reside on BACnet IP ALN, BACnet MS/TP ALN or BACnet
MS/TP FLN.
PXC-24
Number of
MS/TP FLN
Ports
Max Number of
MS/TP device
per FLN
Number of
MS/TP ALN
ports
Max Number of
MS/TP ALN
Devices per
ALN
PXC Modular
96
10
PXC Compact 36
96
10
32
Power MBC/Power
MEC
96
CAUTION:
The Power MBC and Power MEC is now both retired but both are still sold on the
repair parts (Rparts) program until October 1, 2015 (for the MBC) October 1, 2017 (for
the MEC). Refer to PA-669R and POA-001, respectively.
All Programmable TEC and BACnet TEC (Rev Bx20 series) are 1/8 load.
154
Point Teams
Where APOGEE and BACnet are incompatible, such as in network management and
scheduling, new generic BACnet applications replace their non-BACnet counterparts.
Table 35: APOGEE BACnet Firmware Revision Compatibility with Insight or Commissioning
Tool Versions.
Insight/Commissioning Tool Revision
3.12
3.11
3.11
BACnet Field
Panel Model
and Product
Number
PXC Modular Series
(PXME 8) PXC00E96.A, PXC100E96.A
3.10
3.10b,c
3.9.1c
3.9c
3.8.1
3.8
3.7
3.0.1
3.2.4
3.2.4
3.2.2
3.2.4
3.2
3.2.4
3.2.4
3.2.3
3.2.3
3.2
3.2.3
3.1
3.2.3
3.2.3
3.2.2
3.2.2
3.1
3.2.2
3.0.1
3.2.2b
3.2.2b
3.2
3.2
3.0.1
3.2
3.2d
3.2d
3.1
3.1
3.1
3.0.1
3.0.1
3.0.1
3.1
3.0.1
3.0.1
3.1
155
3.11c
3.11
BACnet Field
Panel Model
and Product
Number
3.10b,c
3.9.1c
3.9c
3.8.1
3.8
3.7
3.2.4
3.2.4
3.0
3.0
3.0
3.0
3.0
3.0
3.2
PXC Compact
9
Series (PXCE )
PXC36-E.A, PXC36EF.A
3.2.4
3.2.4
3.2.2
3.2.4
3.2.3
3.2.3
3.2
3.2.3
3.2.3
3.2.3
3.2.2
3.2.2
3.2.2
3.2.2
3.2.2
3.2
3.2
PXC Compact
Series (PAAC)
PXC24.2-UCM.A
3.2.4
3.2.4
3.2.3
3.2.3
3.2.2
3.2.2
PXC Compact
Series (PXCE)
PXC16.2-E.A,
PXC16.2-ER.Aa,
PXC24.2-E.A,
PXC24.2-ER.A
PXC16.2-M.A,
PXC16.2MR.Aa,
PXC24.2-M.A,
PXC24.2-MR.A
PXC16.2-EF.A,
PXC16.2ERF.Aa,
PXC24.2-EF.A,
PXC24.2-ERF.A
3.2.4
3.2.4
3.2.2
3.2.4
3.2.3
3.2.3
3.2
3.2.3
3.2.2
3.2.2
3.2
3.2.2
PXC Compact
Series (PXCE)
PXC16-E.Aa,
PXC16-ER.Aa
a
PXC24-E.A ,
PXC24-ER.Aa
MBC Power Open
Processor
ARCnet/IP ALNa
(562-040)
3.10
3.2
3.2d
3.2.4
3.2.4
3.2.3
3.2.3
3.2.3
3.2.2
3.2.2
3.2.2
3.2
3.2.4
3.2.4
3.1
3.2.3
3.2.3
3.2.2
3.2.2
3.2 d
3.2
3.2.2
3.2.4
3.2
3.2
3.2
3.2
3.1
3.1
3.1
3.1
3.1
3.2.4
3.2.4
3.2
3.2.4
3.2.4
3.2.3
3.2.3
3.1
3.2.3
3.2.3
3.2.2
3.2.2
3.0
3.2.2
3.2.2
3.0
3.2
3.2
3.2
3.2d
3.1
3.1
3.1
3.1
3.0
3.0
3.0
3.0
3.2
3.2
3.2
3.2
3.2
3.2
3.2d
3.1
3.1
3.1
3.1
3.1
3.0
3.0
3.0
3.0
3.1
3.0
3.1
3.0
3.0
156
3.11c
3.11
BACnet Field
Panel Model
and Product
Number
3.10
3.10b,c
3.9.1c
3.9c
3.8.1
3.8
3.7
3.0
3.0
3.0
Power MEC
3.2d
3.2d
Models:
3.1
3.0
3.1
(MCNE)
1100EB/1110EBa
(549-630, 549-631)
3.0
1210EBa (549-633)
Power MEC (MEFE)
1200EFB (549-634),
1210EFBa (549-635)
3.2
3.2
3.2
3.2
3.2
3.2d
3.2d
3.1
3.1
3.1
3.1
3.1
3.1
3.1
3.0
3.0
3.0
3.0
3.0
3.0
3.0
Power MEC
1200ELB (549-636),
a
1210ELB (549-637)
3.1
3.1
3.1
3.1
3.1
3.1
3.1
3.0
3.0
3.0
a.
b.
Insight and Commissioning Tool Revision 3.10 and earlier do not recognize the PMXT/S, UEC (in FLN
mode) or MS/TP PPM.
c.
d.
Insight and Commissioning Tool Revisions 3.9.1 and earlier do not recognize the HOA Upgrade Kit or
algorithmic alarming.
CAUTION:
The Power MEC is now retired but is still sold on the repair parts (Rparts) program until October 1,
2017. Refer to POA-001.
157
Troubleshooting Manual
3.2.4
Desigo CC support
Remote Notification
SNMP
Facility To Go
Web Server
PXM 10T/S
File System/AutoSave
Event Enrollment
Hand-Off-Auto (HOA)
MS/TP Routing
Remote Trending
P1BIM
DB Restore from
Flash
USB Support
Adapt
Wireless FLN
c)
10
3.2.3 a)
3.2.2 b)
3.2
3.1
3.0.1
a)
Firmware is designed for PXC Series controllers, the features attached to this firmware are for these
specific controllers only.
b)
Firmware is designed for PXC Series controllers, the features attached to this firmware are for these
specific controllers only.
c)
At the time of this writing, this manual is not yet published or posted anywhere on the Siemens Intranet.
158
159
Figure 60: PXC Compact Series Controllers (PXC-24 and PXC-36 Shown).
160
BTL Certification
The APOGEE BACnet field panels are BACnet Testing Laboratories (BTL) certified and
listed BACnet Building Controllers. They carry the BTL certification mark and can
meet specifications calling for native BACnet field panels. They provide
interoperability with third-party BACnet workstations.
161
Firmware
Object Basics
BACnet is based on Objects and Services. As an analogy, BACnets Objects with their
properties can be compared to APOGEEs logical points and their point attributes.
For more details about BACnet objects, see Chapter 2BACnet Objects and Services.
BACnet
Object
Supported
APOGEE
Non-BACnet
Equivalent
Notes
Accumulator
No
--
Analog Input
Yes
Physical points.
Analog Output
Yes
Physical LAO
Physical points.
Analog Value
Yes
Virtual points.
Averaging
No
--
Binary Input
Yes
Physical LDI
Physical points.
Binary Output
Yes
Physical points.
Binary Value
Yes
Virtual points.
Calendar
Yes
10
Command
Yes
11
Device
Yes
12
Event
Enrollment
Yes
--
13
File
Yes
--
14
Group
No
--
15
No
--
162
Firmware
BACnet
Object
Supported
APOGEE
Non-BACnet
Equivalent
Notes
16
No
--
17
Loop
No
--
18
Multistate Input
No
--
19
Multistate
Output
Yes
LFSSL, LFSSP,
LOOAL, LOOAP
20
Multistate Value
Yes
LENUM
21
Notification
Class
Yes
22
Program
No
--
23
Pulse Converter
No
--
24
Schedule
Yes
25
Trend Log
Yes
26
Access Door
No
27
Event Log
No
28
Load Control
No
29
Structured View
No
30
Trend Log
Multiple
No
31
Access Point
No
32
Access Zone
No
33
Access User
No
34
Access Rights
No
35
Access
Credential
No
36
Credential Data
No
163
BACnet
Object
Supported
APOGEE
Non-BACnet
Equivalent
Notes
37
CharacterString
Value
No
38
DateTime Value
No
39
Large Analog
Value
No
40
BitString Value
No
41
OctetString
Value
No
42
Time Value
Yes
43
Integer Value
No
44
Positive Integer
Value
No
45
Date Value
Yes
46
DateTime
Pattern
No
47
Time Pattern
Value
No
48
Date Pattern
Value
No
49
Network
Security
No
50
Global Group
Object
No
164
CRTIME
Panel-resident
points: MONTH and
DAYOFM
Firmware
Abbreviation
11
11
Object Type
Enumeration
AC
Accumulator Object
23
AI
00
AO
01
AV
02
AG
Averaging Object
18
BI
03
BO
04
BV
05
CA
Calendar Object
06
CO
Command Object
07
EE
09
FI
File Object
10
165
Abbreviation 11
Object Type
Enumeration
GR
Group Object
11
LP
21
LZ
22
LO
Loop Object
12
MI
13
MO
14
MV
19
NC
15
PR
Program Object
16
SC
Schedule Object
17
TL
20
Note that the Device Object Type, 08, cannot be specified in a fully encoded name.
The encoded name allows you to reference points that have name(s) greater than 30
characters, such as the device name and/or the object name could be longer than 30
characters.
For example, suppose you want to reference a point defined as:
Device Name: AdministrationBuildingChiller1 (this name has 31 characters)
Device Instance: 0004
Point Name: ReturnWaterTemperature (this name has 22 characters)
Point Type : Analog Input
Point Instance: 26
The encoded name would be: BAC_4_AI_26
Note the following about this example:
1. You cannot reference the point by its device name, because it is 31 characters.
2. You cannot reference the point by its 22 character point name because BACnet
names are not unique network wide. You need to know the specific device name
to ask for this specific point, and you cannot specify the device name because it
is too long.
3. This point must exist on a third-party device, since APOGEE BACnet only supports
30 character device names for APOGEE field panels.
4. In this example, you can only use the encoded name to reference the point.
166
Firmware
Field panel local and resident points (PPCL-generated, $LOC, SECNDS, etc.)
Auto unbundled points use the same Instance Number every time, in every panel,
such that encoded name references, like BAC_4_AI_26, can be used consistently.
Point-Like Objects
BACnet Implementation of APOGEE Logical Points
A number of BACnet objects function as point objects in the APOGEE BACnet system.
Table 39 shows a list of the APOGEE logical points and their similar BACnet objects.
Siemens Industry, Inc.
167
APOGEE
BACnet (Physical)
BACnet (Virtual)
LAO
Analog Output
Analog Value
LAI
Analog Input
Analog Value
LDO
Binary Output
Binary Value
LDI
Binary Input
Binary Value
LPACI
Analog Input
Analog Value
L2SL/L2SP
Binary Output
Binary Value
LFSSL/LFSSP
Multistate Output
Multistate Output
LOOAL/LOOAP
Multistate Output
Multistate Output
LENUM
Multistate Value
Multistate Value
Analog and Digital points are mapped to BACnet Analog and Binary, Input and
Output objects if the points are physical.
Analog and Digital points are mapped to BACnet Value objects if the primary (or
only) point are virtual, that is, the second pulsed points or the proof points
are ignored.
The Multistate points with proofs are mapped to Multistate Output objects
regardless of whether they are physical or virtual.
The Multistate points for LENUM are mapped to Multistate Value objects
regardless of whether they are physical or virtual.
TEC Subpoints
Bundled TEC subpoints have Command Priority Array support, just like a regular
point.
168
Firmware
Browsing
When a bundled point that has not yet been commanded is browsed with the HMI
or the Insight BACnet Browser, the initial priority array property is empty. The
Relinquish Default property contains the current Present_Value of the point.
Commanding
A bundled EEPROM-only TEC subpoint is commandable via the OPER slot of the
priority array only.
When a bundled point is commanded, the point will be unbundled, and the correct
priority array slot will be filled in with the commanded value. The system determines
if the point is one that changes only the EEPROM in the TEC. This EEPROM only point
command will fill the command priority slot requested. If the priority slot is OPER or
above (priority level 1 8), the command will burn the EEPROM. If the slot is below
OPER (priority level 9 16), then the point and priority array will be FAILed. Any time
the priority array is failed, the Relinquish Default will contain the actual value. The
Present_Value will be set to the highest priority slot, like any other point.
The above operation prevents applications, like PPCL or Scheduling, from constantly
changing the EEPROM value and exceeding the 10,000 re-burn limit on EEPROM.
Only OPERATOR commands can change the EEPROM value.
When a manually unbundled EEPROM only point is commanded, the priority array is
already present, so the correct slot is filled with the commanded value. From this
point, the operation is the same as commanding a bundled point, shown above.
Releasing
When a point that can be bundled is released, the following actions are possible:
If the point is an EEPROM-only point, it is not released, such that the Initial
Value remains in the device.
If the Command Priority Array is not empty, the highest priority slot is used to
command the point.
169
FLN Commands
HAND-OFF-AUTO Switches
The HAND-OFF-AUTO (H-O-A) switches on a MEC correspond to FLN 0, Drop 0. (The
backplane of the panel is considered FLN 0, Drop 0. Therefore, the HOA switches
only correspond to those fixed points on the backplane.) The status of H-O-A is
mapped to the OVERRIDDEN flag of the Status property of the related point-like
object.
The HAND mode of a point overrides the BACnet Command Priority Array. The slots
in the array may still be commanded, but will not have an effect until the HAND
condition is removed.
If the H-O-A switch is in the HAND position, OVERRIDDEN is set to TRUE and
subsequent FLN data COVs will be saved in Present Value only (no priority array
update). The priority array is considered to be out of sync with the state of the point.
This is acceptable because the BACnet field panel no longer has control of the point
the switch controls the point.
170
Firmware
TEC ToolReleasing
Releasing a bundled point at the TEC with a TEC tool releases slot 16 of the
associated Command Priority Array. If a higher slot for the point has a value, then
the point will be recommended to that value from the tool-entered value. To
eliminate this conflict, you can temporarily disconnect the TEC from the FLN
recognizing that any changes will be over-written when the TEC is reconnected to
the FLN. To make the tools change permanent, the Command Priority Array for that
point has to be cleared before reconnecting the FLN.
Relinquish Default
Downloads from the Insight workstation only contain the Relinquish Default, that is
the Command Priority Array is always empty. So, if you upload the field panels
database and then download it back to the field panel, the Command Priority Array
is lostonly the Relinquish Default is saved.
The Relinquish Default is honored for all point object types except BO (Binary
Output) and MSO (Multi-State Output). (These correspond to LDO, L2Sx, LFSSx and
LOOAx.) For these exceptions, the Relinquish Default corresponds to the physical
OFF state, that is if the point is inverted, then the Relinquish Default will be ON.
When the Relinquish Default is not honored, it is over-written with the actual value,
such that the Present Value and Priority Array are said to be in sync.
For P1 TECs, the Relinquish Default is not persistent for any TEC subpoint, because
the Relinquish Default is used to store changes in value from the TEC device. The Set
Initial Value prompt must be used to accomplish the Relinquish Default functionality
within the TEC. To set the TEC initial value, use the menu path: Application, Fln, Tec,
Initval, Command, Set. On start-up, this TEC initial value is read from EEPROM and
written to RAM.
The above paragraph is NOT true for BACnet MS/TP TECs.
171
Another difference is that input points can only be commanded when the object is
out of service. The APOGEE Automation System selectively restricts input
commanding for local points, but allows it for TEC subpoints. In BACnet, any point
that is out of service can be commanded. An input point must be out-of-service to
be commanded.
TEC subpoints shall use Out_Of_Service to allow input points to be commanded. You
must first command the input point Out_Of_Service before commanding the
Present_Value.
When the point is put back into service, the point is re-characterized, such that the
Present_Value (and Control Status) reflects the device value. This operation behaves
just like the value was just received from the physical I/O, such as update Trend,
update the Alarm state, and report a COV over the ALN if necessary.
Engineering Units
BACnet Engineering Units are pre-configured using the BACnet Engineering Units
enumeration. Free form user-entered text is not allowed.
A predefined BACnet text string is associated with each value of the BACnet
Engineering Units enumeration. The BACnet text strings are used for display in all
reports that display the free form engineering unit strings in the non-BACnet field
panels. The maximum length for this string is eight characters.
State Text
The APOGEE State Text table is used when configuring BACnet Point Objects. BACnet
default state text tables exist for APOGEE points that map to the BACnet
MultiStateOutput (MO) and MultiStateValue (MV) object types. You can only
command a point with state text values; if the state text values map to an APOGEE
State Text table.
Totalization
Totalization is available for the active state of LDIs, LDOs, L2SLs, and L2SPs. These
points map to BACnet Objects with elapsed time. All other totalization which is
supported in APOGEE non-BACnet field panels is not supported in the APOGEE
BACnet; that is, there is no totalization for analog points.
The two properties, Elapsed_Active_Time and Time_Of_Active_Time_Reset are
only available in point object's that have been configured as able to be totalized.
Totalization will be available in seconds only. Hours and minutes are not available.
172
Firmware
Pulse Accumulator
The APOGEE BACnet LPACI point is represented as an Analog Input (AI) object for
physical LPACI points, and Analog Value (AV), for virtual LPACI points.
In order to change the value of a physical LPACI, the associated BACnet object
must be placed out of service, which by definition disconnects the point from the
physical I/O. When the point is placed back into service, the counter will begin at
the Present_Value. So, LPACI points ignore counts received during Out-Of-Service
and restart at the current Present_Value.
In order to change the value of a virtual LPACI, the associated BACnet object can be
simply commanded.
Network Management
The BACnet protocol specifies one Device object in each BACnet Device. A Device
object is referenced by its Object_Identifier property, its Object_Name and its
Instance Number. Each of these must be unique throughout the BACnet
internetwork. This uniqueness allows identifying all of the devices on the BACnet
network.
Within an APOGEE BACnet system, a device on the network is identified by its
BACnet Device Instance Number, which also must be unique network wide. The
Instance Number relates to the Object_Identifier as follows:
Object_Identifier = Object_Type + Instance Number
When specifying a field panel name in Field Panel Application Programs, you can use
either the Device Instance ID (such as 9001) or the Device Specific Name (such as
Building1_Panel1).
173
A field panel that is already acting as a BBMD cannot register as a foreign device
with another BBMD.
Trending
In BACnet trending, all of the trend information resides in the Trend Log object. This
differs from APOGEE trending in which the trend information resides with the point
being trended. In BACnet trending:
The Trend Log object contains the ID of the point being trended, an array of all
of the data collected, Notification Class information about notifying a computer
to upload the data when the trend buffer fills, and much more.
174
Firmware
The BACnet Notification Class object, which directs the alarm to specific
destinations, such as workstations. The Notification Class object contains the
priority of the alarm.
For details about the BACnet Alarming application, see Chapter 8BACnet Alarming.
EventsSystem Messages
APOGEE BACnet field panels can generate system messages as a result of some
system event, such as PPCL errors, logins and logouts. These messages are made
available to third-party devices via the ConfirmedTextMessage service and the
UnconfirmedTextMessage service. If the third-party device supports these services,
it will be able to receive APOGEE Automation System messages. Since the APOGEE
BACnet field panel supports these services, messages from third-party devices can
be displayed at the HMI.
APOGEE BACnet field panels send system messages to the Notification Class Objects
associated with each message. You can configure each system message to associate
it with a Notification Class Instance Number between 0 and 255. The global database
for system messages is limited to Notification Class values between 1 and 250, in
accordance with the APOGEE limitation.
The standard APOGEE error messages can be displayed in the HMI (Figure 62). The
default Notification Class Instance Number of zero is assigned until the user assigns
another Instance Number. The YES and NO in the second column is for enabling dialout. Messages 1 and 2 can only be displayed locally (within the field panel from
which the messages originate).
175
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
(YES)
(YES)
(YES)
(YES)
(NO)
(NO)
(NO)
(NO)
(NO)
(NO)
(NO)
(NO)
(NO)
(NO)
(NO)
(NO)
(NO)
(NO)
(NO)
(NO)
(NO)
Scheduling
The Insight Scheduling application is replaced by BACnet objects as follows:
The BACnet Schedule object replaces the APOGEE Zone, Mode Schedule, and
Override Schedule.
The BACnet Command object replaces the APOGEE Command Table within the
Zone.
The BACnet Calendar object replaces the APOGEE calendar that is shared as
global data on the ALN.
176
Firmware
PPCL
PPCL in an APOGEE BACnet field panel has its own configurable priority that is used
for point commands and releases issued from the PPCL statements. You can specify
a command priority value or use the default PPCL value of 16.
The command priority value relates to the slots in the BACnet Command Priority
Array. For a full explanation, see the Command Priority Properties section of Chapter
2 BACnet Objects and Services.
The priority is entered as the Priority for Writing through the field panel HMI (Figure
63). In the Insight Program Editor, the priority is entered as the PPCL Command
Priority. For details, see the Program Editor section of Chapter 8Insight BACnet
Option.
For compatibility with the APOGEE Automation System, the field panel PPCL
application supports automatic conversion from APOGEE priority levels entered in
PPCL code to default BACnet Command priority array slots (Table 40).
Table 40. BACnet Command Priority Array Slots.
APOGEE Priority
OPER
08
SMOKE
10
EMER
12
PDL
14
PPCL, NONE
16
The field panel allows you to change the Default BACnet Command Priorities for
PPCL through SMOKE. For OPER, the value in the table should be used as the highest
priority slot available for commanding. That is, you can command at this priority and
lower.
A BACnet Command Priority value of 16 is used by PPCL as the default priority for
writing, if this attribute is not specified by the user at configuration time.
Points commanded from PPCL use the priority for writing value unless there is a
@priority indicator in the PPCL line of code. The @priority indicator maps to a slot
in the global Command Priority Table when commanding the point.
Command Priority Example 1:
10
ON(@OPER, FAN)
20
ON(LIGHTS)
For line 10, the Command Priority Table will be used to automatically map OPER to a
BACnet command priority number.
Siemens Industry, Inc.
177
Line 10 would set the FAN points priority array slot 11 = ON, and
The APOGEE BACnet field panel can discover other BACnet devices based on the
Device Name used in PPCL statements. Therefore, PPCL statements in APOGEE
BACnet field panels can use point names from other BACnet devices on the
Internetwork.
Alarming can be enabled and disabled via PPCL in BACnet field panels. The ENALM
and DISALM statements are used for these functions.
PPCL in BACnet field panels supports monitoring and commanding of Present_Value,
Status, and Priority of points defined locally, over the ALN to other BACnet field
panels, and over the ALN to third-party devices.
>Point, Application, Time, Message, Cancel, System, passWord, Bye? a
>Ppcl, flNdevice, Bacnet, Quit? p
>Log, Display, unReslv, Edit, Find, eNable, dIsable, Trace, Pdl, tUne, Quit? e
>Program name
: ahu1------------------------->Field panel
: ------>Priority For Writing
: ->Add, Modify, Copy, Delete, Look, Quit? a
>Line ? 10 on(SFAN)-------------------------------------------------------PPCL Line Added Program name: ahu1
>Add, Modify, Copy, Delete, Look, Quit? l
>First line number
: ------->Last line number
: -------08/14/2005 SUN
PPCL LOOK REPORT
23:25
------------------------------------------------------------------------------Search for <ahu1>
Line numbers <1 to 32767>
PPCL program <ahu1>
Field panel name <9033>
Priority For Writing <16>
Instance Number Block Start <30150>
Instance Number Block Size <200>
State Line Statement
------------------------------------------------------------------------------D
10
ON(SFAN)
178
Firmware
End of report
Figure 63. HMI Display for PPCL in an APOGEE BACnet Field Panel.
Resident Points
Each PPCL program has 26 resident points (e.g. SECNDS,SECND1,,SECND7,
$LOC1,,$LOC15) that are capable of being displayed by the HMI. Figure 64 shows
the 26 resident points that were created when the PPCL program myProgram was
created. Each of these subpoints is automatically assigned a BACnet Instance
Number.
>Point, Application, Time, Message, Cancel, System, passWord, Bye? a
>Ppcl, flNdevice, Quit? p
>Log, Display, unReslv, Edit, Find, eNable, dIsable, Trace, Pdl, tUne, Quit? e
>Program name
: myProgram-------------------->Field panel
: ------>Priority For Writing
: 16
>Add, Modify, Copy, Delete, Look, Quit? a
>Line ? c test------------------------------------------------------------Compiler syntax error
>Add, Modify, Copy, Delete, Look, Quit? >Point, Application, Time, Message, Cancel, System, passWord, Bye? p
>Log, Display, Command, Edit, Operation, Monitor, Alarm, Trend, Quit? l
>Point name
: myProgram:*-------------------------------03/28/2006 TUE
POINT LOG REPORT
15:22
------------------------------------------------------------------------------Search for <myProgram:*>
Point name
:Suffix (Description)
Value/State
Status Priority
------------------------------------------------------------------------------myProgram
:PPCL Address
9033
-NNONE
:SECNDS
0
-NNONE
:SECND1
0
-NNONE
:SECND2
0
-NNONE
:SECND3
:SECND4
:SECND5
:SECND6
0
0
0
0
-N-N-N-N-
NONE
NONE
NONE
NONE
:SECND7
:LOC1
:LOC2
:LOC3
0
0.0
0.0
0.0
-N-N-N-N-
NONE
NONE
NONE
NONE
:LOC4
:LOC5
:LOC6
:LOC7
0.0
0.0
0.0
0.0
-N-N-N-N-
NONE
NONE
NONE
NONE
:LOC8
:LOC9
:LOC10
:LOC11
0.0
0.0
0.0
0.0
-N-N-N-N-
NONE
NONE
NONE
NONE
:LOC12
:LOC13
:LOC14
0.0
0.0
0.0
-N-N-N-
NONE
NONE
NONE
179
:LOC15
0.0
-N-
NONE
:PDL
:TOTKW
0.0
0.0
-N-N-
NONE
NONE
End of report
Each PPCL program has an Instance Number range of 200. But, because there are
already 26 fixed resident points using Instance Numbers, you are limited to 174 userdefined local points (available for LOCAL statements). If you need more than that,
then you have to create a new PPCL program that gives you a new set of 200. That
is, 26 fixed and 174 user-defined local points.
You can display the Instance Number Block Start and Instance Number Block Size
(200) of a PPCL program (Figure 63). For example, the program ahu1 has the
Instance Number range from 30176 to 30350 available for user-entered local points
created using the DEFINE statement. Instance Numbers 30150 through 30175 are
used by the fixed resident points.
You can also display the Instance Number of a specific resident point. The resident
point is named as an APOGEE subpoint in the following colon-separated format:
PPCL Program Name: Resident Point Name
Figure 65 shows an example of displaying the Instance Number (and other data) of
the PDL resident point. In this case, the Instance Number Block Start for this
program is 50500, of which the 24th is the PDL resident point. So, the Instance
Number of the PDL is 50524.
>Point, Application, Time, Message, Cancel, System, passWord, Bye? p
>Log, Display, Command, Edit, Operation, Monitor, Alarm, Trend, Quit? e
>Add, Modify, Copy, Delete, Look, Quit? l
>Point name
: myProgram:pdl-----------------------------03/28/2006 TUE
POINT LOOK REPORT
15:23
------------------------------------------------------------------------------Search for <myProgram:pdl>
Field
Value
------------------------------------------------------------------------------Point system name
: myProgram:PDL
Instance Number
: 50524 (BAC_9033_AV_50524)
Point name
: myProgram:PDL
Point type
: LAO
Descriptor
:
Value
: 0.0
Condition
: -NPriority
: NONE
Analog representation
: Float
Number of decimal places
: 4
Engineering units
:
Access group(s)
: <all>
Alarmable
: NO
Device Instance Number
: 9033
Point address
: --- Virtual --COV limit
: 0.0
Relinquish Default
: 0.0
180
End of report
Firmware 3.2.4 also represents the introduction of a cross platform graphical user
interface, allowing for near identical interfaces between the BACnet Field Panel Web
Server, and the field panel editors that are utilized in Desigo CC. The reuse of these
graphical user interfaces provides continuity throughout Siemens systems and
reduces the potential learning curve associated with the introduction of our exciting
new next generation workstation DesigoTM CC.
181
Certifications
The following certifications have been obtained with APOGEE BACnet Field Panel
Firmware Revision 3.2.4:
All PXC Compact and PXC Modular Controllers loaded with 3.x firmware are
BTL Listed as B-BC devices
BACnet PXC 24 UEC (part # PXC24.2-UCM.A) is BTL listed as a B-AAC device
UL/CUL 916 PAZX/PAZX7 (Enclosed Energy Management)
UL864 UUKL for Smoke Control Equipment (except PXC 24 UEC)
C-Tick
CE Mark
WEEE Compliant
RoHS Compliant
o Remote Notification
If you are using Insight in addition to the Field Panel Web Server, you must use the
Insight Remote Notification application rather than the Web Server application. If you
migrate from a Web Server solution to a solution using Insight, you must reconfigure
Remote Notification to use the Insight application.
HMI
This section describes new functionality for the APOGEE BACnet Field Panel HMI,
which can be accessed through the serial port or by Telnet. The following
subsections contain summaries of changes to the text displays in the HMI. For
detailed instructions, see the latest revision of the APOGEE Field Panel Users
Manual (125-3000).
Application Summary
The following are summaries of the changes to the Application menu item.
Display
Application, A
Ppcl, flnDevice, Schedule, Quit?
Log, Display, Edit, Ssto, Override, eNable, dIsable,
Quit?
Deletions
Removed non-BACnet
Equipment scheduler
System Summary
The following are summaries of the changes to the System menu item.
Display
System, S
Diagnostics, Users, dAtes, deStination, Error_msgs,
Hardware, Text, Quit?
Priorities, Addresses, Quit? -
Display
Deletions
Removed old
Alarm Destination prompting
Additions
System, S
Diagnostics, Users, dAtes, Bacnet, Error_msgs,
Hardware, Text, Quit?
Priorities, Addresses, Quit? -
Priorities,
Display, Modify, Quit?
Addresses
Display, Add, dElete, Quit? M
183
FAN---------------------------------------------
01/14/2002 MON
POINT PRIORITY REPORT
07:43
--------------------------------------------------------------------------------Search for <FAN>
Point name
:Suffix (Description)
Value/State
Status Priority
--------------------------------------------------------------------------------fan (supply fan)
OFF
-NBN08
1. Manual Life Safety
--2. Automatic Life Safety
--3. BN03
--4. BN04
--5. Critical Equipment Control
--6. Minimum On/Off
--7. BN03
--8. Manual Operator (oper)
OFF
9. BN09
--10. BN10 (smoke)
ON
11. BN11
--12. BN12 (emer)
--13. BN13
--14. BN14
(pdl)
--15. BN15
--16. BN16 (sched & ppcl)
ON
Relinquish Default
OFF
End of report
184
12
The PPCL supported by the PTEC is a subset of the PPCL supported in the ALN field panel. For more information on the PPCL
rules and limitations on supported functions, refer to the BACnet Programmable TEC (PTEC) Tool User Manual.
185
Required Components
Software
Hardware
186
Eithernet cable
o Crossover cable required for direct connection to field panels.
13
Product No.
Application
Type
Application
No. 13
BACnet PTEC
Terminal
Box/VAV
Controller
550-495P
BACnet PTEC
VAV with
Series Fan and
3-Stage
Electric Heat
Controller
BACnet PTEC
Unit
Conditioner
(Fan Coil)
Controller
550-492P
VAV pressure
independent
6557 (6599)
BH40
Rev 2.0.0.21
550-496P
VAV pressure
dependant
6540, 6541
6550, 6551,
6552,
6553, 6554
(6591)
BF40
Rev 2.0.0.19
BACnet PTEC
Unit Vent
Controller
550-493P
Unit ventilator
6575, 6576,
6577,
6578, 6579
(6595)
BE40
Rev 2.0.0.25
BACnet PTEC
Heat Pump
Controller
BACnet PTEC
Extended
I/O Controller
550-490P
Multi-Stage
Compressor
6583, 6584
(6590)
BK40
Rev 2.0.0.20
550-491P
I/O Expansion
Module
6596
BI40
Rev 2.0.0.17
VAV pressure
independent
6520,
6521,6522,
6523, 6524,
6525,
6526, 6527
(6587)
Firmware
Revision
BV40
Rev 2.0.0.19
187
Controller
Type
Product No.
BACnet PTEC
Dual Duct
Controller
Application
No. 13
Firmware
Revision
Two Air
Velocity
Sensors
6565, 6566,
6567,
6568, 6569
BD40
Rev 2.0.0.1
550-498P
Electronic
Output
6560, 6562,
6563
BC40
Rev 2.0.0.20
550-494P
Floating or
Analog Output
6658 (6692)
BB50 Rev
2.0.5.6
550-497P
BACnet PTEC
Constant
Volume
Controllers
BACnet
Programmable
VAV with
Chilled Beam,
CO2-Based
Demand
Control
Ventilation,
Floating or
Analog Output
Application
Type
Device Profile
BACnet Application-Specific Controller (B-ASC)
BTL Tested
188
BIBB
DS-RP-B
Name
Data Sharing-ReadProperty-B
BTL
Tested
DS-RPM-B
Data Sharing-ReadPropertyMultiple-B
DS-WP-B
DM-DDB-B
DM-DOB-B
DM-DDC-B
Device Management-DeviceCommunicationControl-B
DM-RD-B
Device Management-ReinitializeDevice-B
DM-BR-B
DM-OCD-B
BACnet PTEC VAV with Series Fan and 3-Stage Electric Heat Controller
Device Profile
BACnet Application-Specific Controller (B-ASC)
BTL Tested
BIBB
Name
BTL
Tested
DS-RP-B
Data Sharing-ReadProperty-B
DS-RPM-B
Data Sharing-ReadPropertyMultiple-B
DS-WP-B
DM-DDB-B
189
Product
BIBB
Name
BTL
Tested
DM-DOB-B
DM-DDC-B
Device Management-DeviceCommunicationControl-B
Device Profile
BACnet Application-Specific Controller (B-ASC)
BTL Tested
190
BIBB
Name
BTL
Tested
DS-RP-B
Data Sharing-ReadProperty-B
DS-RPM-B
Data Sharing-ReadPropertyMultiple-B
DS-WP-B
DM-DDB-B
DM-DOB-B
DM-DDC-B
Device Management-DeviceCommunicationControl-B
DM-RD-B
Device Management-ReinitializeDevice-B
DM-BR-B
DM-OCD-B
Device Profile
BACnet Application-Specific Controller (B-ASC)
BTL Tested
BIBB
Name
BTL
Tested
DS-RP-B
Data Sharing-ReadProperty-B
DS-RPM-B
Data Sharing-ReadPropertyMultiple-B
DS-WP-B
DM-DDB-B
DM-DOB-B
DM-DDC-B
Device Management-DeviceCommunicationControl-B
Device Profile
BACnet Application-Specific Controller (B-ASC)
BTL Tested
BIBB
BACnet PTEC
Heat Pump
Controller
DS-RP-B
Data Sharing-ReadProperty-B
DS-RPM-B
Data Sharing-ReadPropertyMultiple-B
DS-WP-B
Name
BTL
Tested
191
Product
BIBB
Name
BTL
Tested
DM-DDB-B
DM-DOB-B
DM-DDC-B
Device Management-DeviceCommunicationControl-B
Device Profile
BACnet Application-Specific Controller (B-ASC)
BTL Tested
BIBB
BACnet PTEC
Extended I/O
Controller
DS-RP-B
Data Sharing-ReadProperty-B
DS-RPM-B
Data Sharing-ReadPropertyMultiple-B
DS-WP-B
DM-DDB-B
DM-DOB-B
DM-DDC-B
Device Management-DeviceCommunicationControl-B
DM-RD-B
Device Management-ReinitializeDevice-B
DM-BR-B
DM-OCD-B
192
Name
BTL
Tested
BTL Tested
BIBB
Name
BTL
Tested
Data Sharing-ReadProperty-B
DS-RPM-B
Data Sharing-ReadPropertyMultiple-B
DS-WP-B
DM-DDB-B
DM-DOB-B
DM-DDC-B
Device Management-DeviceCommunicationControl-B
DM-RD-B
Device Management-ReinitializeDevice-B
DM-BR-B
DM-OCD-B
Device Profile
BACnet Application-Specific Controller (B-ASC)
BTL Tested
BIBB
DS-RP-B
Name
Data Sharing-ReadProperty-B
BTL
Tested
193
Product
BIBB
Name
BTL
Tested
Controllers
DS-RPM-B
Data Sharing-ReadPropertyMultiple-B
DS-WP-B
DM-DDB-B
DM-DOB-B
DM-DDC-B
Device Management-DeviceCommunicationControl-B
DM-RD-B
Device Management-ReinitializeDevice-B
DM-BR-B
DM-OCD-B
194
BTL Tested
BIBB
DS-RP-B
BACnet
Programmable
VAV with Chilled
Beam, CO2-Based
Demand Control
Ventilation,
Floating or Analog
Output
Name
Data Sharing-ReadProperty-B
BTL
Tested
DS-RPM-B
Data Sharing-ReadPropertyMultiple-B
DS-WP-B
DM-DDB-B
DM-DOB-B
DM-DDC-B
Device Management-DeviceCommunicationControl-B
DM-RD-B
Device Management-ReinitializeDevice-B
DM-BR-B
DM-OCD-B
For more information on the PTEC product line, refer to the following PTEC
documents, which are posted on InfoLink:
195
196
197
The Web Server will automatically connect and display data from any BACnet/IP PXC
Modular or PXC Compact controller on the network that has the Web Services
enabled. In order to observe Graphics and Changes of Value (COVs) from a given
PXC panel requires a license to be purchased. As of firmware revision 3.2.5, the
license is only needed to receive COV data from the panel (needed for graphics). All
other features of the Web Server are available by default. Web pages are populated
via HTTP data services, with data from each controller and asocated BACnet MS/TP
or P1 Field Level Network (FLN) devices. The use of web services for communication
ensures that any web browser with ADOBE Flash is able to access the Field Panel
Web Server, and any smart phone loaded with the Facility-to-Go mobile application
is able to access and display near-real-time system values along with affording
convenient command/override capabilities via always-available smart phone access.
A Field Panel Web server can accommodate an unlimited number of user accounts
and simultaneous users. Each user account can be defined with customized levels of
privileges and access to the system.
The field panel Web Server User Interface software must be installed on at least one
PXC-36 or PXC Modular controller on each network. Any new client device (web
browser) accessing the system makes an initial connection to the controller where
the UI software files are installed, and can then access data from all controllers that
have the web services enabled.
The Launch Pad application is installed on the hard drive of a computer that is
connected to a BACnet network.
198
199
On a 100-base T or faster network, typical network usage will be less than 2%.
Short burst of traffic is possible, triggered by system events like alarms. These
messages can be configured as local broadcasts, global broadcasts, or directed with
confirmation. In addition to these event-triggered communications, periodic system
heartbeat messages between the BACnet devices (called e-ping) are relatively small
and do not contribute much to the occupied bandwidth.
Siemens BACnet Web Server communication begins with an initial connection to one
panel to upload the client application (approximately a 2 MB file). The client
application is then executed inside a Web browser as a Flash application. The client
application will then establish a connection to each Web Services-enabled BACnet
field panel to learn the configuration of the system. As a minimum, Change-Of-Value
(COV) subscriptions for system status points are created to every Web Servicesenabled field panel in the system and checked every 15 seconds as long as a user is
logged in. If the user opens a graphic with dynamic linked points, these points will be
added to the COV table in the controller where the points reside and also updated
every 15 seconds. If a user closes the graphic, the COV subscription for the points in
the graphic will be removed. If the user logs off or gets logged off then all COV
updates will stop.
200
BBMDs are only for BACnet UDP broadcast traffic and not required for Web
Server HTTP traffic.
BACnet Web Services rely on an encrypted user ID/password combination to
restrict access. A unique session ID cookie is created after a successful log-in
from a Web client and used throughout a session as authentication for every
Siemens Industry, Inc.
HTTP request sent to the panel. Without a valid session ID cookie, the panel
will discard incoming requests and not respond.
Only port 80 is required for accessing Web Services on field panels. Port 80
for access is fixed and cannot be changed.
Communication is though HTTP GET and POST messages. Most
communication between client and server is accomplished with POST
messages with XML data in the requests and responses.
FTP (port 21) and Telnet (port 23) can be used for configuration and
upgrading of field panels but is not required for operation and can be
disabled if required.
The Field Panel Web Server can be configured with a Public (Internet) IP
address which has the potential to allow unauthorized access. Siemens
Industry Inc recommends to use Private IP addresses only. If a Public
(Internet) IP address has to be used the IT department responsible for the
site has to be involved.
User accounts are customizable with varying privileges and levels of access. It
is strongly recommended to follow the least rights strategy and only assign
the users the necessary rights they need to perform their duties. There are
three default account IDs: LOW, MED, and HIGH with respective
default passwords LOW, MED, and HIGH. The default accounts cannot
be deleted. As these default logins are known, the default passwords need to
be changed during commissioning to avoid unauthorized access.
User IDs and passwords are not case sensitive and do not have a requirement
of different character types. User account names can be between 1 and 40
characters, user IDs can be between 1 and 4 characters and passwords can
be between 3 and 15 characters. All letters A through Z, and numbers 0
through 9 can be used. Do not use #, ?, or *. Only the user ID and password is
used for authentication.
User accounts need to be managed and kept current. If the access needs of a
user changes (move to a different position, leaving the organization) then the
change needs to be made immediately.
It is strongly advised that each user gets a separate user account (not one
username and password for all managers or site electricians).
BACnet field panels do not support SSL.
Cookies are used to store the users consent in the EULA. If cookies are not
enabled, the user has to acknowledge the EULA at every browser start and
log-in.
Login is accomplished by indicating the following for the Hostname,
Username, and Password:
o Hostname (Launch Pad only) enter the Name or IP address of the
PXC that is connected to the BACnet network
201
202
203
Figure 71: Example of a VPN Solution with a Cisco RV0xx Series 10/100 VPN Router.
Field Panel Web Server and Lauch Pad look nearly identical once the user is logged in.
Once logged in, the user has access to all information from all PXC panels that have
the web server application enabled and access rights, and a screen with a node table
will appear in the left window pane with the main menu window (see Figure 73).
Figure 74 Figure 78 show the various windows used for creating and editing Points,
Trends, Schedules, Notification Classes, and configuring panels, ALNs and FLNs, and
setting up e-mail recipients, users and user passwords.
204
205
206
Figure 75: Grouping for Creating/Editing Notification Class, Remote Recipient List,
SMTP Configuration.
207
Figure 76: Grouping for Creating/Editing Panel Configuration, ALN Node Table, and
Panel Time.
208
Figure 78: Grouping for Creating/Editing Users and Changes to User Password.
209
The BACnet Server Option can export proprietary protocol APOGEE point
information as BACnet objects, so that a third-party BACnet client system may
monitor and command APOGEE points, and monitor and acknowledge alarms within
APOGEE proprietary networks and field panels.
For details on how each of these options interface with a BACnet network, see
APOGEE Communication with BACnet in Chapter 4BACnet Communications. Also
see, the Insight 3.x Release Notes and Getting Started in the APOGEE Insight 3.x
Help.
211
Backward Compatibility
The addition of the BACnet option does not compromise APOGEE Automation
System functionality or backward compatibility. All applications relating to APOGEE
P2 ALN field panels, such as enhanced alarming, trending, point teams, scheduling,
SSTO, PPCL, backup/restore, etc. are supported. Other Insight options such as OPC
support, InfoCenter, specials, Fire/Security Workstation, RENO, and APOGEE GO are
also supported.
Alarms
This section covers how the Insight software supports BACnet from a user's
standpoint. For more detail about the operation of BACnet alarming, see Chapter
10BACnet Alarming.
Point Priority
The Point Priority column in the BACnet Command Priority Array Dialog Box displays
the BACnet point priority for BACnet points.
Initials
The BACnet client option always displays BAC as the initials when an alarm is
acknowledged. The correct user initials are displayed for alarms that are
acknowledged by the Insight workstation, but alarms that are acknowledged by a
foreign BACnet system display BAC. The initials SYS are displayed for alarms that do
not require acknowledgements (similar to previous revisions of Insight software).
Alarm Acks
In BACnet, an object keeps an ack required flag for each state separately. The three
states are To-OffNormal, To-Fault, and To-Normal. Each one of these states can
require a separate acknowledgement. If the user acknowledges an item in the
Insight alarm window, up to three acknowledgements are sent to the BACnet device
(the BACstac keeps track of how many need to be sent). There is no means to
acknowledge a single state. Conversely, if a third-party workstation acknowledges
only one state when three states require acknowledgement, the Insight workstation
will not display the alarm as acknowledged until all three states have been
acknowledged.
212
If the key is set to 1, then the Insight workstation will display alarms for Life
Safety Points, Life Safety Zones, Loops, etc.
If the key is 0 (the default), the Insight workstation will only show alarms for the
standard point types Binary Input, Binary Output, Binary Value, Analog Output,
Analog Input, Analog Value, Multistate Input, Multistate Output, Multistate
Value, Event Enrollment (BI, BO, BV, AO, AI, AV, MI, MO, MV, EE).
213
Alarm Priority
The alarm priority found in a point's Notification Class object has a value from 0 to
255. This alarm priority is mapped to the six APOGEE alarm levels (Table 41).
Table 41. BACnet Alarm Priority mapping to APOGEE.
1 31
A1 (life safety)
32 63
A2 (property safety)
64 95
A3 (supervisory)
96 127
A4 (trouble)
128 191
192 255
Alarms A1 through A6 display for BACnet points in all applications that display
priority. Table 42 shows example alarm displays.
Table 42. BACnet Alarm Displays.
Alarm Messages
BACnet supports sending an unlimited-sized text message with an alarm. The Insight
workstation truncates the message to 200 characters. These messages are
numbered and defined in the BACnet Field Panel Definition. Then, a message
number can be entered in a point definition. (These are the same messages that are
used for APOGEE enhanced alarms).
If the BACnet Field Panel Definition does not have any messages defined (only a
message #0), one can be defined for the point in the Point Editor (Alarm Type, Alarm
Properties), and the Insight alarm window will use that one. The message #0 triggers
the Insight workstation to look in its message database.
APOGEE GO
All applications that display point priority will display BACnet priority for BACnet
points.
214
Attribute Duplicator
The following BACnet properties (attributes) can be copied by the Attribute
Duplicator if the source and destination point are APOGEE BACnet points:
Notification Class
Relinquish Default
In Insight Revision 3.9.1, Deadband and Time Delay properties have been added to
the Properties to Copy section of the Attribute Duplicator screen for the selected
source BACnet point. See Figure 79.
If a BACnet point which supports intrinsic reporting is selected as the source point,
the Time Delay field can be copied to the relevant BACnet destination point, if
selected in the list of properties.
If an analog input or output BACnet point which supports intrinsic reporting is
selected as the source point, the Deadband field can be copied to the relevant
BACnet destination point, if selected in the list of properties.
215
216
Send a read property when you press Begin and the Insight application will
display the number of seconds it took for that device to respond and a
recommended time for the APDU timeout. If it takes longer than the BACnet
APDU timeout entered, The request timed out message displays for
that device.
View the setting that the Insight workstation has for each device in the Current
APDU Timeout column.
Set the ADPU timeout for a device in any row you select to the Suggested APDU
Timeout by pressing Set APDU Timeouts. If you select any rows that had an
error, they will be skipped and the APDU timeout will not be changed for that
device.
217
Figure 82. Viewing Device Object Properties with the Object Browser.
218
To use this application, you must have either Read-level access (which allows
viewing and browsing to any available devices and objects) or Configure-level access
(which allows writing properties, importing points, reinitializing devices, or using
device communication controls as needed) to the BACnet Object Browser. User
access level settings are configured through the User Accounts application.
A View Options dialog box that lets you select what properties you want
displayed by default (set in registry upon exiting).
There are 20 different view types. Each view can be printed and/or saved as a
.csv file. These views appear in the View box at the top of the screen based on
what is selected in the tree control and list control. For example, View Device
Properties is displayed in the View box (Figure 82).
Most of the simple data types as well as the complex data types can be edited.
The simple data types include strings, numbers, Boolean values, Bit strings,
times, and date ranges. The complex data types include Weekly Schedules,
Exception Schedules, Recipient Lists, Object Reference Lists, Action Lists and
Calendars. (You must have configure access to the Browser to use Write
Property.)
The browser has its own functional access level that can be set per user in the
User Accounts application. There are two levels:
Read accessThis lets you read/browse everything, but you cannot do write
properties, import points, reinitialize a device or use device communication
control commands.
Configure accessThis lets you do everything.
Display and edit proprietary properties. (Only the simple data types can be
editedunsigned, float, Boolean, string, and signed.)
219
Display proprietary objects in their own folder. (The write property cannot be
used.)
The ability to only edit existing objects. You cannot create new objects or delete
objects from the browser.
Some data types cannot be edited. The write property button will remain gray if
you are on a property that cannot be written by the browser.
Commander
When a BACnet point is selected from the object selector or typed in, the point
Commander dialog box changes slightly. Instead of the non-BACnet priority buttons,
you will see Set, Relinquish, and Advanced buttons and a drop-down list for BACnet
priority (Figure 83).
220
The drop-down list only contains priorities that the user has authorization to
command (based on their user account setup).
The Advanced button displays the current Command Priority Array. It is enabled
only for point types that can have a Command Priority Array. (AO, BO, MO, AV,
BV, MV). Also, the Relinquish button is enabled only for points with Command
Priority Arrays.
To command a point the user must select Set or Relinquish. If the point has a
Command Priority Array, then the priority slot displayed will be commanded or
relinquished. If the point does not have a Command Priority Array, the present
value of the point will be written.
Out of Service will be enabled for third-party BACnet points and APOGEE input
points only.
221
Alarm by command and ODSB are not supported in BACnet and will be grayed
out.
Clicking on the Advanced button displays the BACnet Command Priority Array
(Figure 84).
222
The current values for all the Command Priority Array slots are displayed.
Users can relinquish any priority level that they have access to (from user
account setup). Levels that the user does not have access to are grayed.
The actual relinquish happens after the point command (not when clicking OK
to this Command Priority Array dialog box).
Database Transfer
Progress Tab
In the Database Transfer dialog box, new BACnet databases have been added to the
Progress tab. To make room, the four SSTO databases have been combined into one
counter, and the TIU counter has been removed (there is only one TIU and only on
pre-APOGEE panels). The four counters at the bottom have been added for BACnet
(Figure 85).
With Insight 3.9.1 or later, the Database Transfer application has been enhanced to
upload and download BACnet FLN device information to a field panel that resides on
the BACnet/IP or BACnet MS/TP ALN.
Beginning with Insight 3.10, the Database Transfer application supports the individual upload
and download of Event Enrollment Objects for Siemens BACnet panels. For third-party panels,
Event Enrollment Objects can only be uploaded and downloaded through Atomic Backup and
Restore.
223
Log Tab
Support has been added to display information as BACnet databases are uploaded
and downloaded.
224
Object Types
Two new object types will be uploaded and represented as points. The Trend log
object will now get uploaded and represented as a virtual LDO. The Command object
will be uploaded as a LENUM point. This is for third-party panels only.
225
Dynamic Plotter
Dynamic Plotter supports BACnet points. With Insight Revision 3.9.1 and later, the
Dynamic Plotter supports plotting BACnet Trend Log Object data from multiple
devices.
Error Messages
The Message Destination Assignments selection on the System menu allows users to
display error message text. The Message Destination Assignments dialog box (Figure
87), has five entries for BACnet. You can control which alarm windows display these
messages in the ALN message pane of the alarm window. The BACnet message types
default to destination zero (0).
226
The BACnet ALN Sorting Options dialog box (Figure 88) provides three choices for
sort order. For each choice, you can also optionally display other fields. This setting
is saved per user in the Insight users account.
227
228
The Add Devices button displays the Object Selector, which shows cloaked
devices so you can uncloak them, if desired.
The same limits are enforced as in the Advanced Settings dialog box, which is
accessed from the Field Panel Definition dialog box via the Advanced Settings
button.
BACnet menu items are hidden if the Insight system does not have a BACnet
license.
BACnet Enable Device Discovery, under the Tools menu item, turns on and off
the automatic discovery of BACnet panels. A toolbar button also turns on and
off the automatic discovery of BACnet panels. See Chapter 4-BACnet
Communications for more details about device discovery.
Global Broadcast Who-Is, under the Tools menu item, is enabled for an Insight
system with a BACnet ALN or a BACnet ALN selected. Selecting this item sends a
Who-Is on the network. This feature works with device discovery to help
discover BACnet panels. There is also a toolbar button for this. See Chapter 4BACnet Communications for more details about device discovery.
BACnet Object Browser, under Tools menu item, is enabled when a BACnet
panel or ALN is selected that launches the BACnet Object Browser application. If
a specific panel is selected, only that panel is opened in the browser. If a ALN is
selected, then all panels are opened in the browser. (It takes longer to load all
panels.)
PX Compact is supported. The new panel type is called COMPACT and can be
added to any P2/P3, dialup, Ethernet, or BACnet ALN. The new panel cannot
have FLNs. There is a new icon for it.
Event Builder
Command Object
The Event Builder Application allows you to create, edit, and delete BACnet
Command Objects (Figure 90). This capability is limited to Command objects in
Siemens field panels. Editing a Command object is very similar to editing an APOGEE
Zone. See Chapter 9-BACnet Scheduling for details about the Command object.
229
230
Create action text entries. You must provide action text (it doesnt need to be
unique and it can be blank). It is the index that is the key.
Action text indexes cannot have gaps. You can only delete the last one in the
list. If you attempt to delete one in the middle of the list, only the commands
for that action index are deleted.
When selecting an action text item, you can add actions in the lower list control.
These actions are the commands to be executed when the Command object is
commanded to the value of the index in the action text list. For example, if a
user writes the Present Value property of the command object to 1, then all
commands in the Action List for the Warm Up action will be executed.
You can add modify, remove, move up, and move down actions.
Selecting Add at the bottom of the Event Builder BACnet Command Object
dialog box (Figure 90) displays the Edit Action dialog box (Figure 91) to enter a
command line in the Action List.
Selecting a BACnet point from the Object Selector will automatically fill in most
of the dialog box. If a point is selected, only the property ID, value, priority,
delay, and quit on failure setting must be filled in.
If you select a point that uses a state text table, its values are inserted into the
value drop-down list.
If you select more than one action and click Remove, an Are you sure
message displays.
If a single item is selected, it can be moved up or down in the list. This affects
the order in which commands are executed.
For a list of the most recently used items, select Command Objects from the
Definition menu.
231
Event Printer
BACnet loader messages and BACnet Text messages are printed at the event printer.
Global Commander
Global commanding of BACnet points is not supported. In the Logical point tab, if a
BACnet point is entered, an error message displays.
In Insight 3.9.1 or later, the Global Commander can support BACnet FLN devices on a
field panel residing on a BACnet/IP or BACnet MS/TP ALN. The following operations
are supported:
Graphics
The following enhancements are implemented for Insight graphics:
All controls and tool tips that display point priority will display the BACnet
priority for BACnet points.
Commanding points using analog bars will use the default operator priority
defined via System Profile.
Object Selector
Cloaked Panels
The Object Selector will not show cloaked panels. In Insight Revision 3.9.1 or later,
the Object Selector application is enhanced to include BACnet FLN devices.
PXC Compact
An icon was added for PXC Compact.
Point Details
Point Details displays the BACnet priority of a BACnet point. Also displayed are
Object ID, Notification class, Reliability, and the Event Enable flags. Finally, a button
in the dialog box allows you to quickly read another point.
Point Editor
Engineering Units
In BACnet, engineering units is an enumeration. This means users cannot type
anything they want. Users must select units from a list of defined units in the Select
Engineering Units dialog box (Figure 92).
Standard UnitThese units are grouped by category. The first drop-down box
has a list of categories (length, mass, volume, etc.). When you select a Category
of Units, the Units list on the right displays all the Units in that category.
Proprietary Unit You must enter an enumerated value. If you do not type in a
specified enumerated unit, an error message displays.
233
BACnet Data
The point dialog boxes in Point Editor contain Object Instance number, Notification
Class, Alarm Values, Relinquish Default, and the Event Enable flags, and Alarm
Message number (Figure 93). The Event Enable flags are only for Alarmable points.
The Point Editor dialog boxes include the following features and changes:
You cannot change the Instance number once a point has been saved. If 1 is
selected, the panel will assign a number and it will upload that information to
the Insight workstation. The Instance Number will display the next time the
point is opened.
Totalization is only supported on binary input and binary value points in BACnet
(LDI, LDO, L2SL, L2SP). The units are always seconds.
The Alarm Message # is the number of the enhanced alarm message number
that was defined in the Field Panel Definition dialog box in System Profile. Use 0
to indicate to use the alarm message as defined locally in the point editor. See
Chapter 10-BACnet Alarming for more details about the Alarm Message #.
Support for Deadband, Time Delay, Minimum On Time, and Minimum Off Time
BACnet Properties
Insight Revision 3.9.1 or later, four property fields are available for points created on
a BACnet field panel that is supporting intrinsic reporting:
234
These properties are included in the Alarm Characteristics section in the Point
window screen (Figure 93). These properties are viewable and can be edited on
third-party field panels as well as Siemens panels.
RENO Notification
In order to send RENO notification when a BACnet point goes into alarm, the
notification class must have checked Acknowledgement required for TOOFFNORMAL and/or TO-NORMAL. BACnet points can have notifications on
ALARM_PRIORITY 1 through 6.
235
Program Editor
PPCL is supported in APOGEE BACnet field panels. The Save As dialog box has
additional fields for BACnet (Figure 94).
If a BACnet field panel is selected, the fields in the BACnet Settings section become
enabled. PPCL Command Priority is the priority at which the PPCL program
commands points. The PPCL Command Priority defaults to the value defined through
System Profile.
Report Builder/Reports
Display BACnet Priority
All reports that display point priority display the BACnet priority (BN01 through
BN16). If no priority is present, NONE is displayed.
Reports
Application Log Report
In Insight Revision 3.9.1 or later, the Application Log can display BACnet MS/TP FLN
devices.
236
237
238
Log Purgedindicates a user purged all the data at the device by writing a 0 to
the record count property.
Time Changedindicates the local time of the device was changed. It is the
offset in seconds by which that the time changed.
In Insight Revision 3.9.1 and later, the Trend Data Detail Report includes filtering
options for local and remote trending. The Definition Filter provides the option to
filter by All, Local Trends, or Remote Trends.
Remote Trends only apply to BACnet points.
239
Scheduler
See Chapter 9-BACnet Scheduling for details.
Event Log
BACnet loader messages and BACnet Text messages are logged in the System
Activity log.
System Profile
BACnet MS/TP ALN Configuration
The Insight Revision 3.9.1 or later supports the ability to configure BACnet MS/TP
ALN devices from the BACnet Field Panel Definition dialog box. APOGEE BACnet field
panels, with Firmware Revision 3.1 or later, can reside on BACnet/IP or MS/TP
networks.
240
Only BACnet field panels with Firmware Revision 3.1 or later support this feature.
241
242
Once the BACnet FLN device is defined in the network, most fields in the dialog box
can be modified. The System Name field or the Application field, however, cannot be
edited. All other fields are editable. Since modifying fields does not change the
attributes in the device itself, these fields should be used only to correct errors in
defining the device.
If the device is no longer needed in the network, it can be deleted.
243
Figure 102. BACnet Command Priority Array Dialog Box in System Profile.
The operational features of the BACnet Command Priority Array dialog box include:
244
The Edit button displays a dialog box that allows you to change the long and/or
short version of the strings and select default priorities.
Changes to Text take effect next time the Insight application starts since they
are cached by applications.
Siemens Industry, Inc.
Default priorities are global data and should be replicated automatically to all
panels. The Insight applications that use them will read them the next time they
are started. (for example, Program Editor uses the PPCL priority).
The operational features of the BACnet Address Table dialog box include:
The list rejects duplicates. A duplicate is defined as having the same Device ID
and Object ID.
To erase an item in the list, select the items line and click Remove.
The Modify button displays the BACnet Address Table dialog box (Figure 104)
and allows you to modify some of the properties. You cannot modify the device
ID or Object ID settings. To modify these, you must delete the line and add a
new one.
This address table is a new database type in the field panel. Entries
added/removed will be sent to the field panel using replication.
When changes have been made and the Cancel button clicked, a prompt to save
the changes is displayed.
245
When Add is clicked, the BACnet Address Table Entry dialog box displays (Figure
104).
When using the BACnet Address Table Entry dialog box, note the following:
The
button displays the object selector. When a panel is selected in the
object selector, the name and address fields will be filled automatically.
When the Object ID checkbox is selected, it enables the fields to the right and
allows you to enter the object type and instance.
ALN Definition
The Building Level Network Definition dialog box for a BACnet ALN has changed
slightly (Figure 105). You can now specify the Instance Number for the Insight
workstation, whereas, in previous revisions this could be done only in the registry.
246
Figure 105. Building Level Network Definition Dialog Box with a BACnet ALN.
The operational features of the Building Level Network Definition dialog box include:
A change to the Instance Number that affects all ALNs on that Insight
workstation. You are issued a warning when making a change.
When Set Time is clicked, only the time for the panels in the recipients list are
set (synchronized). Any panels for which the Set Time operation fails will be
reported in a message box.
The Recipients button displays the Time Synchronization Recipient List dialog
box (Figure 106) that allows users to pick which panels will have their time
synchronized automatically every day or when the Set Time button is clicked. In
that dialog box, users can choose to send local time or UTC. The Change button
cycles between do not Sync, local time, and UTC time. You can multi-select so
you can change many at a time. See Time Synchronization in Chapter 4BACnet
Communications for more information.
247
248
If the Building Level Network Definition dialog box is closed when creating a
new ALN, a warning message box displays if any BACnet filters were not set up.
Click Yes to save the ALN anyway. Filtering is done in the BACnet Connection
Settings dialog box (Figure 107) that you can access by clicking the Settings
button. For more information, see Device Discovery in Chapter 4-BACnet
Communications.
The operational features of the BACnet Connection Settings dialog box include:
I-Am processingThis section handles how device discovery adds devices to the
ALN. Users can setup rules or filters on what devices should be added
automatically to this specific ALN. Users can specify a Device ID range, a vendor
ID, and/or a network number.
Process ID RegistrationThis section allows users to add a list of Process IDs (up
to 16) that the Insight application will register on the BACnet network.
Duplicate Process IDs are rejected.
The defaults are 0 and 600.
The Remove button removes the highlighted process ID from the list.
Changes to Process IDs take effect after the next reboot (the Async service
must restart).
249
intrasite. For details about the BACnet network number, see Chapter 4-BACnet
Communications.
BBMD SettingsThe BBMD Table button displays the BBMD edit dialog box,
which allows you to edit the Insight BBMD table. The dialog box is shown in the
Panel Definition section. You can only edit BBMD entries if the BBMD was
enabled in the Cimetrics network configuration application. For details, see
Chapter 4-BACnet Communications.
Panel Definition
The Field Panel Definition dialog box has been updated for BACnet field panels
(Figure 108).
250
The operational features of the BACnet Field Panel Definition dialog box include:
Panel type can now be MBC, MEC, Compact, Modular, and BACnet (other).
Other is for all third-party BACnet devices.
A Network # field has been added. Panels on multiple network numbers can
reside on the same ALN.
The Object name was added. This is an optional field that displays the BACnet
object name property as it appears in the device object. (This is not the
configured name that the Insight application uses when creating a device).
Several fields are read-only and will be filled in by device discovery. These
include: Vendor ID, Application SW Rev., Model Name, Vendor Name, Firmware
Rev, and Location.
The Site Name field was added. This is an optional field that allows you to define
which site the panel belongs to. The site name affects which discovery and
replication timers are used (intrasite or intersite).
The Status section contains a Cloaked check box. This feature is used to hide
panels on the BACnet network that a user does not wish to see through the
Insight workstation.
The Supports LON checkbox is only enabled for the MEC. The LON Settings
button displays the same LON settings as Version 3 MECs use.
If this is an APOGEE field panel and the ALN name configured at the panel is
different than the ALN name in the Insight workstation, a warning message
displays when there is a mismatch.
The Alarm Messages button displays the standard dialog box for editing
enhanced alarm messages. These messages are used in BACnet for standard
point alarms. For more details, see Chapter 10-BACnet Alarming.
251
252
Base Instance for FLN devicesOnly enabled for PXCs. This is the Instance
Number from which the APOGEE field panel will start creating points on FLN
devices. This value must be at least 10000.
COV Resubscribe and COV Poll RateValid for all panel types. The first is how
often to reregister for COVs. The second is how often to poll devices that dont
support COVs.
APDU Timeout and APDU RetriesBACstac settings to control how long the
Insight workstation will wait for a command to this field panel to be completed
before timing out and how many times to retry the command. Insight enforces a
minimum of 1 retry and 5-second timeout. APDU timeouts are also discussed in
Chapter 4BACnet Communications.
The operational features of the Unsolicited COV Subscription List dialog box include:
The ability to reject duplicate entries from the Unsolicited COV Subscription List.
A
button that displays the object selector and allows you to pick points or
panels.
A Remove button that is enabled after selecting an item in the list. When
Remove is clicked, the item is removed from the list.
A database that is also kept in the field panel. Changes made here should match
the list in the field panel.
253
A prompt to save changes when changes have been made and the Cancel
button is clicked.
254
The IP Address, UDP Port, and Broadcast Distribution Mask fields, which are
used for each BBMD device.
A
button to the right of the IP address field that allows you to select a field
panel and have its IP address entered automatically.
Siemens Industry, Inc.
A prompt to save changes when changes have been made and the Cancel
button is clicked.
This table is sent to the field panel and should match what is in its database.
An OK button that provides an option to sync all BBMD tables. If Sync All is
selected, the Insight software will try to send the table to all devices in the
table. All devices in the table must be APOGEE panels or Insight workstations for
the sync to work. All third-party BBMDs must be edited manually.
255
256
The Copy To button allows you to copy the selected notification class to other
devices. It copies by Instance Number. If that device already has a notification
class with that Instance Number, it will be deleted and replaced with this one. If
a notification class is copied that doesnt have an Instance Number, then it can
end up with different Instance Numbers in the devices to which it was copied.
Users can copy it to APOGEE field panels or third-party devices. Any errors
received during the copy operation will be displayed.
CAUTION:
Be careful using the Copy To feature. Instances of the same number in the destination
device can be overwritten. Verify what the Copy To operation is doing each time it is used.
257
The Instance Number must be unique within the device for Notification Classes.
If 1 is entered, the device will assign the Instance Number.
Modifying a notification class also displays the BACnet Notification Class dialog
box. The Instance Number cannot be changed when modifying a notification
class.
With a notification class selected, users can add, modify or remove a recipient.
258
See Chapter 10-BACnet Alarming for details about Notification class entries.
Cloaking
The concept of cloaking has been added for BACnet panels. Clicking the Cloaked
button in Status section of the BACnet Field Panel Definition dialog box, the panel is
removed from the system profile tree. This allows you to hide devices that you do
not want to appear at the Insight workstation and to keep device discovery from
constantly re-adding the devices to a ALN.
Siemens Industry, Inc.
259
FLN Devices
Device Instance range edit dialog boxes have been added to the TEC, LTEC, and UC
definition dialog boxes. Figure 118 shows the TEC Definition dialog box.
260
The instance range fields are only enabled for BACnet field panels. These are the
Instance Numbers that points on this FLN device will use.
Once the number of subpoints is saved, it cannot be changed. The TEC has to be
deleted and re-added to change it.
The default base is displayed as 1. As soon as the field panel assigns a value, it
will be uploaded to the Insight workstation and displayed. This cannot be set
manually. Only the number of subpoints can be set when creating a device. The
default and minimum value is 100.
Device Re-Initialization
If a BACnet device is selected in the tree and Coldstart/Re-Initialize on the Tools
menu is selected, the BACnet Re-Initialize Device dialog box (Figure 119) displays to
allow a warmstart or coldstart of the device.
261
An Are you sure message box displays before the command is sent.
Some devices require a password. An error displays if left blank and the device
requires a password. For APOGEE BACnet field panels, use the high account
password.
262
The operational features of the BACnet Device Communication Control dialog box
include:
Disable or Disable Initiation Only enable the Disable Duration Edit window.
Users can enter the number of minutes the device is to be disabled.
Some devices require a password. An error displays if it is left blank and the
device requires a password. For APOGEE panels, use the high account password.
Users must have Configure access to System Profile to issue this command.
The Add Devices button displays the Object Selector so that users can generate
a list of panels. This makes this function useful for power fail tests. The list
automatically removes duplicates. At least one panel must be in the list.
263
Time-of-Day Scheduling
APOGEE BACnet field panels support the PPCL-based Time-of-Day scheduling.
Trend Editor
Trend Definitions
Insight Revision 3.9.1 or later supports the ability to trend BACnet points in other
devices. In previous revisions of the Insight software, points could only be trended in
the field panels where they resided. With Insight Revision 3.9.1, you can trend
BACnet points with any BACnet device that supports trend definitions (Trend Log
Objects), regardless of where the BACnet points reside.
265
266
For BACnet points, the Conditional Trending and Enable Buffer full controls are
disabled.
Users provide an Object Name for a BACnet trend definition. The Object Name
must be unique within a panel.
The Instance Number must be unique within a device. Leave it set to 1 to have
the panel assign the instance automatically.
The Notification Threshold is the number of samples at which the device will
notify recipients that the buffer is getting full and needs to be collected. This
value should be less than the maximum samples at the device.
Stop when full is a flag that indicates whether the device will stop collecting data
when the buffer is full. It defaults to unchecked.
The start and stop date/time can be specified to only collect data for certain
dates or hours during the day. If any of the fields are wild carded in the start
date/time, then trending will start immediately, if any are wild carded in the
stop date/time, then trended will continue forever. There are buttons to display
a dialog box that edits the dates/times.
When modifying a BACnet trend definition, you cannot change the Instance
Number.
You can create trend definitions for points only in APOGEE BACnet panels. The COV
and Interval dialog boxes have a BACnet section that lists the properties of a Trend
Log object.
User Accounts
Siemens Industry Inc. strongly recommends that User Accounts are setup in a
secure way and are managed regularly and continuously throughout the BAS life.
There are several simple aspects to be considered when setting up User Accounts
that increase the security of the system, but not impede the access and usage of
the system:
There shall only be one or maximum two users with full Administrator rights
Each User shall have a separate account. Group accounts should not be used
(that is, one username and password for all electrical technicians).
Each User Account shall be setup with the least privileges required for the user
to perform the duties that are required of her/his position.
User Accounts shall be constantly managed and updated (privileges added and
removed as requirement changes, users added and removed as employees
responsibilities change they join or leave)
See also Chapter 14-User Accounts.
267
Command Priority
In the Edit Insight Account dialog box (Figure 126), there are sections for BACnet
Command Priority, Command Settings, and non-BACnet Command Priority defaults.
The Command Settings button displays the BACnet Command Priority Array dialog
box (Figure 127).
268
This allows selection of the BACnet priorities that the user is allowed to command or
relinquish. These settings are used by the Point Commander to allow/disallow
commanding and relinquishing certain priority levels.
Changes to these settings take effect next time the Insight workstation starts up. (Technically, the
changes take effect the next time the Point Commander starts. However, once Point Commander is
run, it really doesnt shutdown until the Insight workstation is shutdown).
The non-BACnet Command Priority section allows you to set the default priority of
any non-BACnet point that is commanded.
269
BACnet Export
BACnet Export, accessed from the Account menu, is a feature of the Insight BACnet
server that enables populating the BACnet virtual network with non-BACnet APOGEE
points in the Insight database server. The BACnet export dialog box displays a
warning if you attempt to export points with COV limits twice the slope or smaller.
These points display in an Export Results dialog box (Figure 129) and can be copied
to the clipboard. This feature was added for Anthem support, which may lead to
users exporting thousands of points. Too much COV traffic can be detrimental to a
P2 (RS-485) ALN.
270
The Export Results dialog box also warns users when they forget to make the BACnet
account or if no points are exported.
271
Calendars
Commands
Schedules
The interaction of the Schedule object, Calendar object and either Command objects or
database objects are what make a BACnet schedule function.
Comparison to APOGEE
The table below illustrates the scheduling differences between standard APOGEE and the
APOGEE with BACnet system:
Table 43: Comparison of Scheduling Differences Between APOGEE and APOGEE with BACnet.
APOGEE
Overrides
Exceptions
273
Command Object
Replacement Days
Scheduling Theory
In BACnet systems, LENUM points must start at 1. This is different than a proprietary LENUM point
which would normally start at 0.
The BACnet Scheduler will not recognize a state of 0 for LENUM points.
For example, a BACnet State Text Table would look like this:
1 VAC
2 OCC
This can be an issue because the PPCL programs we use are written to use the
proprietary State Text format:
0 VAC
1 OCC
To get around this disparity, the Command Object can be used to command a mode point to a value
recognized by the PPCL program. PPCL programs are written to monitor the status of a zones mode
point. Because BACnet Systems do not use zones, a virtual LAO (AV) point is created in its place.
The virtual LAO is substituted in the program for the zone mode point.
The Command Object containing the mode point is scheduled using a BACnet compliant state text
table. For example:
In the Command Objects Action List, when the Command Object is in OCC, the virtual mode points
value is commanded to 1.
274
The virtual mode point is monitored by the PPCL program. When its value changes to 1,
the program initiates occupied programming.
Siemens Industry, Inc.
the PPCL program changes to 0, and the program initiates unoccupied programming.
Step 1
Navigate to the DCOM Config Security Screen.
a) Follow the menu path Start Run.
b) Type DCOMCNFG and press Enter.
c) Expand the navigation tree:
Component Services Computers My Computer DCOM Config.
Step 2
Configure the Launch and Activation and Access Permissions.
a) In the Launch and Activations Permissions section, select the Customize radio button and click the
Edit button.
b) In the Group or Usernames section, click the Add button. Click Advanced, and then click Find
now.
c) Make sure Administrators, Administrator, System, and any Insight Users or Insight Group all have
access, and Everyone does not. Add to the group as necessary.
d) In the Permissions section of the Change Configuration Permission dialog box, check the check
boxes to allow access to both levels of access for allowed users.
e) Click OK.
f) Repeat these steps for Access permissions.
Step 3
Close DCOM Config.
a) Click OK.
b) Close the Component Service window.
It is not necessary to reboot the computer.
275
Step 4
Start or Cycle the DBCS Server Service.
a) Open the services. (services.msc on the run line)
b) Scroll to the Insight DBCS Server service.
c) Put it in Automatic, and start it.
d) If it is already running, restart it.
e) Verify that the Windows service (Insight BACnetClientSvc) is started.
f) Close the services window.
Step 5
Verify that Field Panel Communications are Ready.
a) Open System Profile and expand the tree.
b) Open the field panel properties and verify that the panel is ready.
Step 6
Use the Database Transfer Application to Upload the Panel Database to Insight.
a) Open the properties box of the field panel in System Profile and verify that the panel is ready.
b) Open the Database Transfer utility and perform an Upload All from the field panel to Insight.
BACnet Calendars
The BACnet Calendar Object is a list of date entries from which action can be initiated. The Calendar
Objects Present Value is evaluated as TRUE on any date that is in its Date List. On other dates the
Calendar Objects Present Value is FALSE.
In an APOGEE BACnet field panel, the instances where the Present Value of the Calendar Object is
checked includes:
Whenever the time in the device changes by an amount that may have an effect on the
calculation result.
At other times, as required, to maintain the correct value of the calendar through the normal
passage of time.
276
BACnet Calendars
Local Time: Synchronizes the selected device(s) on the BLN to your local time.
UTC: Synchronizes the selected device(s) on the BLN to the Universal Time Coordinated
(UTC). (UTC is also referred to as Greenwich Mean Time (GMT).)
Both: Allows you to send the Local Time and UTC to the selected device(s). This is the
default setting for devices added from the BACnet network.
Do not Sync: Does not synchronize the selected device(s). This is the default setting for
devices added from the System Profile application.
In most installations the Local Time option is selected.
If the current date is included in the calendars list of effective date, the calendar is
evaluated as true.
277
Calendar Name: Unique name for the calendar, e.g. National Holidays.
Calendar Instance: Auto-assigned by default.
Description: Optional field, up to 256 characters.
Present value: Read-only field that displays the current status of the calendar.
278
BACnet Calendars
Date: Specifies an exact date in the calendar. It is active on one day each year.
Week and Day: Specifies a month, week, and/or day, such as the last Thursday of November
(Thanksgiving). Wildcards are allowed.
279
The Command object can command a mix of data types (Analog and Binary). A Schedule
object can only command single object types.
Action Text: The state text table used by the Command Object can be imported or created in this
section.
280
Copy and paste functionality can be used to copy command information from one action
text object group to another. For example: copying the points from the VACANT Action
List and pasting them into the OCCUPIED Action List.
BACnet Schedules
The Import button can be used to populate the Action Text section with pre-defined state
text tables.
Action List: This section is used to add objects to individual Action Text states. Objects are added by
highlighting the Action Text state and then clicking the Add button on the bottom of the dialog box.
Objects are added to the state by selecting them in the Edit Action dialog box. Most information autopopulates when an object is selected from the database. The following information requires manual
entry:
Value Type: The value the object will be commanded to in this state.
Priority: The priority the object will be have when commanded in this state.
Delay: A time delay in seconds that will take place when the Command Object changes
state. If there are several items in the Action List, the time delay applies to each
individually, in order, from top to bottom.
Quit on Failure: Check this box if commands to the remaining objects should not be initiated
if this line's command fails.
If an object displays an instance number value of 4,194,303; it is not recognized by Insight. This is
often an indication that the object has not been downloaded to the field panel and lacks an instance
number.
BACnet Schedules
BACnet schedules are used to command objects at prescribed time intervals. Each BACnet field panel
holds its own calendar and schedule objects. A device can store and run multiple calendars and
schedules at the same time.
The BACnet schedule object contains a periodic schedule that can occur over a range of dates. The
dates are set up to change the value of one or more objects being controlled by the schedule. The
BACnet schedule object:
Has an exception schedule list for holidays, special events etc. A BACnet Exception has
the same effect on the schedule as an APOGEE Replacement Day. It removes and
replaces all schedules for the day on which it is used.
Integrates with the Calendar Object to ease programming of exception schedules that
affect large numbers of schedule objects.
Schedules are divided into days, of which there are two types: normal days within a week
and exception days.
Both types of days can specify scheduling events for either the full day or portions of a
day.
A priority mechanism defines which scheduled event is in control at any given time.
The current state of the Schedule object is represented by the value of its Present Value
property, which is normally calculated using the time/value pairs from the Weekly Schedule
and Exception Schedule properties. A default value is used when no schedules are in effect.
Siemens Industry, Inc.
281
If it is necessary to command a mixed group of object types, a Command Objects allows much
more flexibility.
Insight Rules
The BACnet Field Panel executes the schedule(s). Insight accesses the calendars and schedules
stored in the panel in order to permit editing.
If defined as the Mass Storage Device, Insight will store a copy of the calendars and
schedules for its devices (panels).
All points in a single BACnet schedule must be of the same type as the schedule itself
(either analog AO or binary BO points).
When a schedule directly executes a command, all points are commanded to the same
value.
To create a schedule, open the Scheduler application and from the main menu select:
BACnet > New > Schedule. The BACnet Schedule Properties dialog box displays.
282
BACnet Schedules
The BACnet Schedule Properties dialog box allows the user to configure a BACnet Schedule. The
dialog box has six main parts:
Schedule Identity: This section allows a user to name the schedule, provide an optional
description of its use, and identify the field panel that will support the schedule.
Schedule Objects: This section allows a user to add and/or remove objects. Objects are
listed by Device Number, Object Name, Object ID, and Property. The fields may be
configured in ascending or descending order.
The Add button allows the user to utilize the Object Selector to add an existing
BACnet Object to the schedule.
The Remove button deletes a selected item from the schedule.
Schedule Default: This section allows a user to enter a default value for the schedule and
select its command priority.
The Default Value will be used if no weekly schedule is in effect.
Checking the Null Value box disables the Default Value field. Objects in the Schedule
Objects field will use their own default values if not scheduled.
The Priority for Writing drop-down list allows the user to select the command
priority level. This is the priority that the system will use when writing object
properties during schedule processing.
Effective Period: This section allows a user to set a time period for the specific schedule
to be active.
The
The
The
Schedule Output: This section allows a user to define a weekly BACnet schedule for
selected days of the week.
The Add button displays the Schedule Entry dialog box. This allows a user to add
start and end times and a value to the selected BACnet weekday schedule.
The Modify button allows a user to modify the time and value entries for the
selected BACnet weekday schedule.
The Copy button allows a user to modify existing schedule entries and add them as
new schedule items.
The Remove button deletes one or more existing schedule output entries.
The Combine Days checkbox allows the user to combine schedules that have the
same Start Time, End Time, and Value, into a single line display.
Exceptions: This section allows a user to view scheduled exceptions with details such as
exception definition, start time, value, end time, and priority.
Exception schedules can be modified by double-clicking the schedule entry or
selecting it and clicking the Edit button.
Description
Default Value
Effective Period
The Current State section displays information useful for determining the status of the
schedule:
284
Present Value: Auto-populates with the value of the existing schedule. If the Out of
Service box is checked, the field is active and a value may be selected.
BACnet Schedules
Weekly Tab: This tab allows a user to define, modify or remove a weekly schedule for a
selected day of the week.
The Schedule section display is sorted in ascending order by time value. For example, a
time of 08:00 is the first line item in the list, then 17:00, and so forth.
285
Exception Tab: This tab allows a user to add, modify, or remove exception schedules from the
weekly BACnet schedule. It is divided into two separate panes of information:
286
Lower Section: Times and values for each exception schedule listing.
BACnet Schedules
Exceptions are used to modify an existing schedule. There are a number of reasons a user
may want to do this:
Apply a calendar to the schedule. The calendar must be in the panels database.
Create an exception particular to this schedule. The same options used when creating a
calendar:
Date
Date Range
Week and Day
Items Tab: This tab displays the objects controlled by the schedule. All functions in this tab are the
same as in the Schedule Objects section of the BACnet Schedule Properties dialog box.
287
BACnet Schedules
Existing Schedules can also be viewed through the Scheduler Application, accessible via the
Scheduling bar on the navigation pane on the left side of the Web Server screen. Choose the desired
panel to view any existing schedules. Schedules cannot be created, modified, or deleted via this view.
The following attributes of an existing schedule can be modified through the Schedule editor:
Description
Weekly schedule
Exception schedule
Write priority
The user can also create Calendar Objects to be used with the Schedule editor. The calendar
object created will be referenced by the Schedule Object. The user can also view, delete, and
modify existing Calendar Objects.
The following attributes of an existing Calendar Object can be modified through the Calendar
Editor:
Description
Date List
289
The user can also create Command Objects to be used with the Schedule editor. The
Command Object created will be referenced by the Schedule Object. The user can also view,
delete, and modify existing Command Objects.
The following attributes of an existing Command Object can be modified through the
Command Editor:
Description
Action
Action Text
For details on the description of the User Interface for Schedule/Command/Calendar Object
Editors, refer to the Field Panel Web Server User Guide.
1.
Existing schedule details can also be viewed via the Scheduler bar in the
navigation pane on the left side of the Web Server screen. Schedule details can
be viewed using Today, Day, Work Week, Week, or Month views. Use the buttons
at the top of the Schedule window to choose among the available views or to
advance to the next Schedule segment (day, work week, week, or month).
2.
The Schedule Object Editor allows the user to enable or disable an existing
schedule on a specific date, which adds or removes an override on that specific
date.
3.
Additional overrides can be made for a specific date to change the starting time,
ending time, and day span values of a schedule entry. The actual schedule
definition does not change; only the control values used by the schedule for the
specific date are changed.
4.
5.
When creating a weekly schedule, use the Add Multiple button to add a weekly
schedule to multiple days of the week.
Schedule Object
Creating a Schedule Object
1. Click the Schedule icon from the Create/Edit bar. The Object Editor window displays.
2. Click Select a Panel at the top of the left pane of the Object Editor window to display
available panels.
3. Select the desired panel by clicking the panel name in the left pane of the Object Editor
window.
4. Click the + button at the bottom left of the Object Editor window. The Schedule Editor
window displays a new schedule object.
5. Enter the new schedule object information (Object Name, Object Identifier, Description,
Effective Start and Stop dates/times, Write Priority, Default Value).
6. Click the Weekly Schedule, Exception Schedule, or Command Point Objects buttons to
access those windows.
7. Click Save. The Save button will be grayed out once the modifications are complete.
290
BACnet Schedules
291
292
BACnet Schedules
Choose Date, Date Range, WeeknDay, or Reference (to reference an existing Calendar
Object)
1.
Click the Edit Time Values button to add time values to the Exception Schedule.
Click the + sign at the bottom of the Edit Time Values window to add rows to the
Time/Values table.
293
1.
Click the value under the Priority column to change the exception priority. The Exception
priority is the priority in which exception schedules are executed. If there are more than
one exception schedules for the same time, the exception schedule with the higher
priority will be executed.
2.
Click the sign at the bottom left of the window to delete an Exception Schedule.
From within the Object Editor window, click the Command Point Objects button to open
the Edit Command Objects window.
2.
Click the + sign at the bottom left of the window to add a Command Object to the
Schedule Object.
Click the Object drop down to choose a reference objects or a Command Object.
2.
Click Select a Panel at the top of the left pane of the Object Editor window to display
available panels.
3.
Select the desired panel and the desired schedule object by clicking the panel name and
then the schedule object name.
294
BACnet Schedules
295
BACnet Schedules
Command Objects
Click the Command icon from the Create/Edit bar (hover over the Schedule icon to view
it).
2.
Click Select a Panel at the top of the left pane of the Object Editor window to display
available panels.
3.
Select the desired panel by clicking the panel name in the left pane of the Object Editor
window.
4.
Click the + button at the bottom left of the Object Editor window.
5.
Enter the new command object information (Object Name, Object Identifier,
Description).
6.
Click the + button at the bottom left of the Command Object Editor window to add an
action to the command object.
7.
Click the new action to add a title in the Action Title field, and to add point information.
8.
9.
Click each cell in the new row to add Point, Value, Priority, and Quit on Failure
information.
The Save button will be grayed out once the modifications are complete.
297
Calendar Objects
Click the Calendar icon from the Create/Edit bar (hover over the Schedule icon to
view it).
2.
Click Select a Panel at the top of the left pane of the Object Editor window to
display available panels.
3.
Select the desired panel by clicking the panel name in the left pane of the Object
Editor window.
4.
Click the + button at the bottom left of the Object Editor window.
299
5.
Enter the new calendar object information (Object Name, Object Identifier,
Description).
6.
Click the + button at the bottom left of the Calendar Object Editor window to
enter Date, Range, or WeeknDay information.
7.
Click Save.
The Save button will be grayed out once the modifications are complete.
Event Scheduling
BACnet objects cannot be included within an Insight Event. The closest method for
duplicating an Event with BACnet is to include the object IDs in the Action List of a
BACnet Command Object. The object IDs can be Command objects themselves and
can be considered similar to APOGEE zones.
300
BACnet Schedules
6000
5000
3000
4000
CAUTION:
BACnet does not support LENUM values less than 1. Therefore, the default State Text
Table ZONE_MODE for the zone names (e.g. ZONE1 in the above example) will need to be
changed to a custom LENUM so that all LENUM values are greater than 0.
301
The PPCL code shown above uses the modes of a LENUM point (point ZONE1) with a
custom State Text Table whose modes have the following values:
Mode State Name Value
VAC
OCC1
OCC2
OCC3
OCC4
OCC5
WARMUP
COOLDOWN
NIGHT_HTG
NIGHT_CLG
STOP_HTG
10
STOP_CLG
12
302
VAC
OCC1
OCC2
OCC3
OCC4
OCC5
WARMUP
COOLDOWN
NIGHT_HTG
NIGHT_CLG
10
STOP_HTG
11
STOP_CLG
12
BACnet Schedules
Figure 132 shows how to implement APOGEE Zone Mode control of BACnet Mode
PPCL. The mode sub-point value is written to a BACnet Analog Value Object point,
VIRTUAL_LAO, using PPCL within the APOGEE PXC or Insight Soft Controller. When
VIRTUAL_LAO is commanded, the Insight cross-trunk service sends the command to
this point in the BACnet device. The appropriate section of PPCL code in the BACnet
device is implemented based on the value of VIRTUAL_LAO.
Another way to use SSTO from the Soft Controller is to have the Zones Command
Table write to the Present Value of one or more BACnet Command Objects. The
Command Objects can then command those objects necessary to implement the
desired control strategy. For example, a Command Object can be set up for each of
the following Modes: OCC, WARMUP. COOLDOWN. See the Command Object
section for more details. For more details, see the Cross-Trunk Communications
section in Chapter 4BACnet Communications.
For more details as to how to bring APOGEE point commands over to BACnet
devices, see the Cross-Trunk Communications section in Chapter 4BACnet
Communications.
303
Schedule and Calendar objects for third-party BACnet devices are stored in the thirdparty devices only. Therefore, these objects can be edited only when the Insight
workstation is communicating with the device (editing must be performed online
only).
Object properties that are Arrays of the above simple data types (unsigned, real, enumerated
and Boolean) are not supported by Siemens BACnet field panels.
2.
The capability to write to remote devices is not required by the BACnet specification, but the
Siemens BACnet field panel supports commanding to outside devices. All BACnet devices,
regardless of vendor, will accept commands from a Siemens BACnet field panel.
CAUTION:
Siemens BACnet Field Panels Wildcard Limitations
NOTE:
Even though the BACnet Field Panel accepts an illogical or incomputable wildcard
combination entry, the field panel may not execute it at all or may not execute it in the
way the user intended.
Wildcarding an individual field (such as, Month) requires that the field be wild carded both in the
Start date and the End date.
If Month and Day are not <any>, then <any> for the year has to be in both the Start and End dates.
Thus, both dates with the year wild carded will provide the same date range every year.
When wildcarding an individual field, the Year field must be wild carded first before wildcarding
the Month; the Month must be wild carded before the Day can be wild carded.
If a specific year number is entered into the Year field, <any> cannot be put in the Month field. An
entry of <any> must go in the Year field if <any> is to be entered into the Month field. Therefore,
with <any> entered for both Month and Year, the Calendar object will be TRUE over the same
range of days for every month in every year.
A wildcard combination must have an obvious start date and stop date. In the following example, it
is clear that all dates from September 2, 2005 through June 7, 2006 are within the Start period.
Start September
2
2005
<any>
Stop
June
7
2006
<any>
However, if the years are changed to <any>, then both years can theoretically be the same (for
example, 2005), which would not make any sense. Therefore, this use of wildcarding violates the
rule of having an obvious start date and stop date.
304
BACnet Schedules
In PPCL
To use the BACnet calendar object in PPCL, simply inset the BACnet calendar object
name in the lines of PPCL code as if it were a point name. For example, you could
use the following line of code if you wanted to turn off the washroom exhaust fans
on the holidays listed in BACnet Calendar Instance 7 of Device Instance 15000:
IF (BAC_15000_CA_7) THEN OFF(BAC_4_BO_6)
In a Schedule
To use a BACnet calendar in a schedule, you list the calendar name as an Exception
Property for a schedule and then the Exception Schedule will be implemented on
the dates listed in the BACnet Calendar Properties. A BACnet Calendar should be
used for exception schedules that affect multiple Schedules, for example, a national
holiday. In this way, if the date must be modified, it only has to be modified in one
place; in the BACnet Calendar.
To list the Calendar name as an exception property:
1. From the BACnet Schedule Properties dialog box, choose the Exception tab.
2. Click the Add Exception button to display the Calendar Reference dialog box.
Siemens Industry, Inc.
305
4. Use the drop-down list box in the Calendar Reference dialog box to select the
desired calendar name. The example above displays the name Holiday
Calendar in the Calendar Reference section when the dialog box opens. The
following example shows Holiday-C96 after the Calendar Reference has been
changed.
If the calendar object has not yet been created, only the Instance Number must be entered
to act as a placeholder for the future calendar object.
307
The Weekly Schedule (Figure 135) starts at 00:00:00 and causes the Night Cooling
Action to occur, otherwise the Schedule Default (0) will take over at midnight and no
action will occur until 6:00:00, when Cool down begins. The Occupied (cooling)
action occurs at 8:00:00 and ends at 18:00:00 when Night Cooling reinstates.
308
The Exception Schedule comes from the Calendar object named Holiday Calendar.
This requires that the user update only this one Calendar object each year with the
new holiday dates. The Date List shows that fixed dates are entered for most of the
holidays while Date Ranges are entered for the Thanksgiving and Christmas holidays.
The List of Object Property References shows the three Command objects being
commanded by the Schedule object. Each Command object represents a building.
The Name and Description are use to detail how the Command object is
programmed and save the user some time viewing each. The Action List of each
Command object includes the supply fan object. Obviously, there is no Start Stop
Time Optimization implemented. If there was SSTO, the supply fan would be
controlled by SSTO PPCL as explained elsewhere in this section.
To do this, set up an exception schedule that defines the week (for example, 24
December 2005, 02 January 2006) and has one time entry (15:00=UNOCC).
309
To do this, set up an exception schedule that defines the week (for example, 24
December 2005, 02 January 2006) and has three entries (UNOCC with any time
between 00:00:00 and 7:59:59, and 9:00=OCC, and 15:00=UNOCC).
It is desired to have a week in which everyone arrives early (7:00), but leaves at the
time in the weekly schedule (leaving time may vary slightly from day-to-day).
To do this, set up an exception schedule with two entries (7:00=OCC, and NULL with
any time value between 8:00:01 and earliest possible UNOCC time in the weekly
schedule).
310
If 24 hour operation is not desired, a separate entry for each hour can be entered in
the Weekly Schedule. For example:
08:00:002
08:00:041
08:50:002
08:50:041
09:00:002
09:00:041
09:50:002
Siemens Industry, Inc.
311
09:50:041
Etc.
312
Much of the information in this chapter is taken from the Siemens Industry, Inc.
training course: BAU-6005, APOGEE Automation System with BACnet.
Transitional notifications
Notification Classes
Message IDs
Notification Classes: are defined in the panel. When assigned to an alarmable point they
add the following:
Transitions allowed
When the notifications are active, based upon days of the week and time
313
Transitional States
BACnet systems allow the selection of three specific alarm reporting events for a point. They
are referred to as Transitional States. Specifically:
To-OffNormal: The BACnet object has transitioned from its normal state to an alarm state.
To-Fault: The BACnet object has transitioned from its normal state to any state other than
alarm.
To-Normal: The BACnet object has transitioned from any other state back to normal.
A user may require acknowledgement of these events when they are set up in Point Editor.
Selecting all three events to be active for an alarm will cause it to function similar to
standard APOGEE alarming
314
315
Alarm Messages
BACnet alarm messages are created in System Profile in the BACnet Field Panel
dialog box, by clicking the Alarm Messages button.
316
Once the necessary messages have been created and saved to the panel, they can
be selected in the Alarm Characteristics section of the Point Editor application.
317
Token Messages
Token Messages are text strings, inserted in alarm messages, that generate a piece of
information to be included as part of the message.
If the correct strings are not used, the alarm message may print a partial message or no
message at all.
318
Notification Classes
Notification Classes are used in many BACnet applications including, Alarming, Trending,
and Event Enrollment. They contain a list of BACnet devices that receive alarms, alarm
acknowledgements and notifications when a point enters a specified condition. Specifically:
If a Notification Class is not assigned, only system messages are sent directly to
the mass storage device.
You can copy existing Notification Classes to other BACnet field panels using the
Copy To button.
Always copy in order from top to bottom.
319
List of Notification Classes in this Device: The upper section is used to name
and describe the Notification Class.
Priorities and acknowledgement requirements are specified here.
320
Ack required for To Normal transitions. Check this box to require an acknowledgement for
return to normal transitions.
Ack required for To Off-Normal transitions. Check this box to require an
acknowledgement for a transition from normal into alarm.
Insight maps the BACnet priorities to the six Insight alarm priority levels, A1 through
A6. Table 45 below identifies the specific ranges:
Table 45: Network Alarm Priorities in BACnet Versus Insight.
BACnet
Alarm
Priority
Range
0 31
32 63
64 95
Insight
Alarm
Priority
A1
A2
A3
Network
Priority
Life Safety
Message
Life Safety
Message
Critical
Equipment
Description
Notifications related to an immediate threat to life, safety, or health.
For example, fire detection or medical emergency.
Notifications related to an immediate threat to property.
For example, a forced entry or unlocked doors.
Notifications related to improper operation, monitoring failure
particular to Life Safety or Property Safety monitoring, or monetary loss.
321
BACnet
Alarm
Priority
Range
Insight
Alarm
Priority
Network
Priority
Description
Message
For example, fire sprinkler valve shut off, communication failure and
excessive energy use.
96 127
Critical
Equipment
Message
A4
128 191
A5
Urgent Message
For example, normal event logging or room temperature above
setpoint.
192 255
Normal
Message
A6
Recipient Section
The Recipient section allows the user to choose which specific device or devices will receive
the notification. Selections include:
Device Instance. Specify a single device by instance number.
Address. Specify a single device by MAC Address and Network Number.
Broadcast. Specify a receiving subnet or all subnets:
322
Transitions Section
A user can check or uncheck the boxes in this section to activate or deactivate Transitional
States for this notification class. If the site is using RENO, these boxes must be checked.
Period Section
Allows a user to select which hours within a day to send notifications to a device. All fields
must be populated (no Any indicators) or the period will default to 24/7.
Notifications Section
When checked, configures a device to issue confirmed alarm notifications. This means that
the device sending the alarm requires a response from the device receiving the alarm.
323
Event Enrollment
Event Enrollment is a BACnet application that allows a user to add alarm and event
reporting features to an object. It utilizes three separate areas of the database:
Points, Notification Classes, and Event Enrollment.
Event
Types
CHANGE OF STATE
COMMAND FAILURE
FLOATING LIMIT
OUT OF RANGE
Supported
Point Types
BI, BV, MV
BO, MO
AI, AO, AV
AI, AO, AV
Time Delay
Value
Time Delay
Time Delay
Deadband
Setpoint Reference
Time Delay
Low Limit
High Limit
Deadband
324
Change of Value
Change of Bitstring
Buffer Ready
Unsigned Range
Clicking the Event Enrollment button opens the Event Enrollment Objects dialog box. All
existing Event Enrollment objects will be displayed.
To add a new Event Enrollment object, click the Add button. The BACnet Event Enrollment
Properties dialog box opens. The following fields must be configured:
Device Name: The panel where the Event Enrollment Object will reside.
Name: A unique name for the Event Enrollment Object within the device.
Notify Type: A user can select Alarm or Event. Both options provide the same
configuration characteristics.
325
Event: Select for points normally considered non-alarmable, such as sensors like the
Outdoor Air Temperature.
Event Enable: A user can check or uncheck the boxes in this section to activate or
deactivate Transitional States for this Event Enrollment Object.
326
Object Property Reference: This section contains information on the reference point used
by the Event Enrollment Object. Clicking the Select Object button allows a user to select the
reference object.
Once a reference point is selected, the fields in this section auto-populate with
the objects information.
The fields in this section may also be manually populated. This is not
recommended.
Event Type and Parameters: This section allows the user to select the type of Event
Enrollment to configure. The specific parameters will vary based upon the type of
Event Enrollment selected.
Event Enrollment is the only way to make unbundled PTEC subpoints alarmable. It is also a
substitute for some Enhanced Alarming features.
Alarm Enable/Disable
Operator-initiated and PPCL-initiated alarm enable/disable are not available for
BACnet.
System Messages
Some examples of APOGEE Automation System events are PPCL run-time errors and
Logon/Logoff messages. The APOGEE Automation System messages are available to
third-party devices delivered using unconfirmed text message service.
Initials
When alarms are acknowledged by an Insight operator, the correct user initials will
be displayed. Alarms that are acknowledged by a third-party system will display BAC
at the Insight workstation. The initials SYS will be displayed at the Insight
workstation for alarms that do not require acknowledgements.
327
Alarm Acknowledgements
In BACnet, each one of the three state transitions (To-OffNormal, To-Fault, and ToNormal) can require a separate acknowledgement. If an operator acknowledges an
item in the alarm window from the Insight workstation, it will send up to three
acknowledgements to the BACnet device (software keeps track of how many
acknowledgements to send).
A means to acknowledge a single transition is not provided.
Binary Input
Binary Output
Binary Virtual
Analog Output
Analog Input
Analog Virtual
Multi-state Input
Multi-state Output
Multi-state Virtual
A registry key has been added to allow alarms for object types that are not
supported by the Insight application as points to be displayed. The key is called
ShowAlarmsForAllObjects and is under the client key.
If the key is set to 1, then the Insight application displays alarms for Life Safety
Points, Life Safety Zones, Loops, etc.
If the key is 0 (the default), the Insight application only shows alarms for the
standard point types (BI, BO, BV, AO, AI, AV, MI, MO, MV, EE).
Alarm Priority
The alarm priority found in a points Notification Class object has a value from 0 to
255. This alarm priority is mapped to the six APOGEE alarm levels (Table 47).
Table 47. BACnet Alarm Priority mapping to APOGEE.
1 - 31
A1 (life safety)
32 - 63
A2 (property safety)
64 - 95
A3 (supervisory)
96 - 127
A4 (trouble)
128 - 191
192 - 255
329
The A1-A6 alarm levels display for BACnet points in all applications that display
priority. Table 48 lists alarm display examples.
Table 48. BACnet Alarm Displays.
BACnet alarm level
Alarm Messages
Although BACnet supports sending an unlimited-sized text message with an alarm,
Insight truncates the message to 200 characters. These messages are numbered and
defined in the BACnet Field Panel Definition.
With Intrinsic Alarming, a message number can be entered in the alarmed point
definition. (These are the same messages that are used for APOGEE enhanced
alarms).
If the BACnet Field Panel Definition does not have any messages defined (only a
message #0), one can be defined for the point in the Point Editor (Alarm Type, Alarm
Properties), and the Insight alarm window will use that one. The message #0 triggers
Insight to look in its message database.
BACnet Browser
Point Objects
When viewing point objects with the BACnet Browser, each point type has
properties associated with intrinsic alarming. If the point is configured for alarms,
the properties are readable as a group. If the point is NOT alarmable, the properties
do not appear.
The Event_Enable property displays a points ability to send alarms as follows:
330
All three bits are TRUE if the point is alarmable AND alarms are enabled.
All three bits are FALSE if the point is alarmable AND alarms are disabled.
RENO Notification
The Event_Enable property may be edited within the BACnet Browser. Any change
to the Event_Enable bits will refresh the Browser display and will trigger a point
upload, but will not cause an annunciation.
RENO Notification
RENO notifications can be sent from BACnet points. BACnet points can have RENO
notifications on Alarm Priorities 1 through 6. To send a RENO notification when a
BACnet point goes into alarm, the appropriate Ack required choice for the desired
transition must be checked in the BACnet Notification Class dialog box.
RENO notification examples:
For a RENO notification of a TO-OFFNORMAL transition, Ack required for To OffNormal transitions must be checked.
APOGEE GO
APOGEE GO can display BACnet alarms like any other APOGEE alarms. However, it
does not provide any capability for setting up alarm functionality. For example,
Notification Class and Alarm Message dialog boxes are not accessible.
331
APOGEE
Point Type
LPACI
Physical or Virtual
APOGEE Point
BACnet
Point Type
Physical
Analog Input
Virtual
Analog Value
LENUM
N/A
Multistate Value
Physical
Binary Output
Virtual
Binary Value
N/A
Multistate Output
LDI
Physical
Binary Input
Virtual
Binary Value
Physical
Analog Output
Virtual
Analog Value
Physical
Analog Input
Virtual
Analog Value
LAO
LAI
Figure 138, Figure 139, and Figure 140 show Point Editor dialog boxes for points
respectively on a Siemens BACnet panel, a third-party BACnet panel, and a BTEC
team member point. The Related BACnet Objects group box contains the Event
Enrollment button to set up BACnet Event Enrollment Objects.
The Related BACnet Objects group does not display in the Point Editor dialog box for APOGEE points
(non-BACnet Points).
332
Figure 138. Example Siemens BACnet Panel Point Editor Dialog Box.
333
Figure 139. Example Third-Party BACnet Panel Point Editor Dialog Box.
334
Figure 140. Example BTEC Team Member Point Editor Dialog Box.
The Event Enrollment button opens the Event Enrollment Objects (EEO) dialog box
(Figure 141), which contains a list of all EEOs monitoring the point. The point being
monitored is listed in the Referenced Object column.
All the lines display the same Referenced Object the point being monitored.
335
Although all listed event enrollment objects refer to the same referenced object,
they may reside at different devices (all ALN devices that can be selected from the
Object Selector). For example, in Figure 141, Event Enrollment Objects (EEOs) in
devices C1BACALNCAB24_2124 and C1MS/TPALN100_2130, both reference point
C2124LAO (the Referenced Object). Although these two EEOs both use the out-ofrange Event Type, it is not necessary that they do so. Thus, different Event Types can
apply to the same referenced object.
Clicking the Add, View/Modify, or Copy buttons launches the BACnet Event
Enrollment Properties dialog box. (The user must have Configure/Edit access to
either the Point Editor or System Profile to do this.)
Adding, modifying, or removing a Change of Life Safety EEO is not allowed in the Insight Version 3.10
software.
336
The Add button opens a new, blank EEO editing dialog box where the
Referenced Object field is populated with the points name and is disabled.
The Modify button opens the same dialog box , which is populated with the
property values of the select EEO.
The Copy button opens the same dialog box and allows you to create a copy of
the selected EEO. The Instance # (number) of the copy will be blank or sent to 1, and its Name and Description fields will be blank. The value of all other fields
or properties will be identical to the original EEO.
The BACnet EEO Properties dialog defaults to the most meaningful choices for the
event type chosen. For a specified referenced object, the dialog box will default to
Present_Value for the referenced property.
The system will not verify that the notification class is defined, but an invalid Instance Number will
generate an error message. For example, a negative invalid Instance Number is invalid.
The Change of Life Safety Event Type is always disabled. The Insight application will display EEOs with
Change of Life Safety Event Type, but you can only view the EEO. However, you are not allowed to
create, modify, or delete it.
The BACnet Event Enrollment Object Properties dialog box will not restrict meaningless choices.
337
Before creating the EEO, you must know about EEO shadow points. When you create
an Event Enrollment object, Insight automatically creates a LENUM shadow point
with a name in the format BAC_<PANEL ID>_EE_<ID#. The shadow point exists only
in the Insight database, not in the field panel. However, the shadow point appears in
the object selector and can be brought up in the Point Editor (Figure 143). When
editing the EEO in the Point Editor, the Object field in the Reference Object and
Property group box will be disabled and preset to the points system name.
Use the procedure for associating controller alarm messages with EEOs:
1. Call up the Object Selector from the Point Editor. Make note of the last shadow
point name. For example, in Figure 143 it is BAC_2124_EE_6.
2. Create an Event Enrollment object using the field panel HMI rather than using
Insight. (You cannot configure or view the alarm message number associated
with an EEO at Insight.) The HMI prompts will include a prompt for an Alarm
Message number. This is where you enter the number of the alarm message you
want to appear in the Alarm Status box.
338
3. Again, call up the Object Selector from the Point Editor. Make note of the new
last shadow point name. For this example it should now be BAC_2124_EE_7. This
is the shadow point associated with the Event Enrollment Object.
4. Go into the Point Editor and make the shadow point BAC_2124_EE_7 alarmable.
(It does not matter what alarm message number is selected for the EEO. The
important thing is to make the shadow point alarmable.)
The alarm message that appears at Alarm Status is the one whose number was
entered when creating the EEO at the panel HMI.
Alarm Messages
Alarm messages are created by clicking the Alarm Messages button in the BACnet
Field Panel Definitions dialog box (Figure 14) and then creating/editing a message in
the Alarm Message Definition dialog box (Figure 15 and supporting text).
Recipient List
Create a Recent List for the selected Notification Class using the BACnet Destinations
dialog box (Figure 17 and Figure 18 and supporting text).
Field
User Configurable
BACnet EEO Property
Displayed Value
System Name
Part of Object_Identifier
Integer
Object_Name
EEO List,
Description
Description
Device Name
System Name
Instance #
Part of Object_Identifier
Integer
339
Field
User Configurable
BACnet EEO Property
Displayed Value
Name
Object_Name
Description
Description
Referenced
Object
Part of
Object_Property_Reference
Referenced
Property
Part of
Object_Property_Reference
Notification Class
Notification_Class
Event
Parameters
tabbed control
Event_Parameters
Event Type
Notify Type
Event Enable
The Configure Event Parameters dialog box (Figure 144) in the BACnet browser for
editing event parameters in shows how tabbed control is used to set up event
parameters based on a selected event type.
Figure 144. Example Configure Event Parameters Dialog Box.
The system will not verify that the notification class is defined, but an invalid Instance Number will
generate an error message. For example, a negative invalid Instance Number.
The Change of Life Safety Event Type is always disabled. The Insight application will display EEOs with
Change of Life Safety Event Type, but you can only view the EEO. However, you are not allowed to
create, modify, or delete it.
340
In Alarm Characteristics:
Enter the high and low alarm limit values (analog points only).
Select which types of transitions are to annunciate an alarm (TO NORMAL,
TO OFF-NORMAL, TO FAULT).
Enter the Alarm Message Number to be sent when an alarm occurs. Use 0
to indicate you want to use the alarm message defined locally in the Point
Editor.
Dynamic COV and Enhanced Alarms are not supported in BACnet.
341
Figure 146. Point Editor LAO Window Showing Notification Class Field.
Figure 147. Point Editor LENUM Window Showing Alarm Values Setting.
342
343
Alarm Messages
The Alarm Messages button displays the Alarm Message Definition dialog box.
Clicking the New button allows you to create a new message with a new ID number
(Figure 149). You can create up to 250 messages, and each message can have up to
200 characters (4 lines of 50 characters each).
Notification Classes
The Notification Classes button displays the Notification Classes dialog box. You can
create new Notification Class Instances by clicking the Add button, which displays
the BACnet Notification Class dialog box (Figure 150).
The name and descriptor of the Notification Class object can describe the group of
recipients of the alarms or the type of alarms that should use this Notification Class.
Alarm priorities in a points Notification Class object can each be assigned values
from 0 to 255. Table 51 shows how this alarm priority is mapped to the six APOGEE
alarm levels.
Table 51. BACnet Notification Class Alarm Priority Mapping.
344
1 - 31
A1 (life safety)
32 - 63
A2 (property safety)
64 - 95
A3 (supervisory)
96 - 127
A4 (trouble)
128 - 191
192 - 255
The BACnet Notification Class dialog box (Figure 150) also allows you to define
whether a certain alarm transition must be acknowledged. Check boxes are provided
for each transition type.
To send a RENO notification when a BACnet point goes into alarm, the appropriate Ack required
choice for the desired transition must be checked. For example, for a RENO notification of a TOOFFNORMAL transition, Ack required for To Off-Normal transitions must be checked.
Recipient List
Create a Recipient List for the selected Notification Class. In the Notification Class
dialog box, click the lower Add button to open the BACnet Destination dialog box
(Figure 151).
345
Figure 151. Recipient Creation using the BACnet Destinations Dialog Box.
346
Valid Days and PeriodUse these sections to coordinate the alarm destinations
based on day and time. For example, critical HVAC alarms can be programmed
to go to the HVAC workstation during regular business hours, and to the
Security workstation after hours and on weekends.
347
Figure 154. BACnet Alarm Color Selections on the Insight Definitions Dialog Box.
348
Cooling coil
The requirement is to apply alarms to the L2SL, LTD, SAT, and SSP points.
L2SL Point
A supply fan alarm must occur if the differential pressure proofing switch does not
close 60 seconds after the fan has been commanded to the ON state. In the Point
Editor, a L2SL point is created (Figure 156). BACnet-specific entries are made as
follows:
AddressesThe address of the digital output controlling the fan relay (0.0.25),
the address of the digital input proofing switch (0.0.1), and the value of 60 for
the Proof Delay seconds are entered.
Alarm TypeStandard Alarms is selected. The Alarm Properties button does not
need to be clicked because there are no entries to be made in this points
Standard Alarm Setup dialog box.
349
LTD Point
A low temperature alarm must occur if the low temperature detector switch
(freeze stat) trips. In the Point Editor, a LDI point is created as shown in Figure 157.
BACnet-specific entries are made as follows:
350
Alarm TypeStandard Alarms is selected. The Alarm Properties button does not
need to be clicked because there are no entries to be made in this points
Standard Alarm Setup dialog box.
Normal. Alarm Message #3 is to appear in the alarm banner. For details, see
Figure 163.
SAT Point
An alarm must occur if the supply air temperature is too low or too high. In the Point
Editor, a LAI point is created (Figure 158). BACnet-specific entries are made as
follows:
AddressThe address of the physical analog input (0.0.17) of the BACnet device,
is entered.
351
Alarm CharacteristicsHigh and Low Alarm Limits are set to 65 and 45F,
respectively (10 degrees above and below the setpoint of 55F). This
temperature is to be monitored closely, so alarms are to annunciate on all three
types of transitions. Alarm Message is set to #0 so that a Private Message,
entered in the Standard Alarm Setup dialog box (Figure 159), will be available
from the Insight alarm banner. Right click on the banner and select View Alarm
Message (Figure 160).
352
Figure 159. Example Standard Alarm Setup Dialog Box for SAT Point.
Figure 160. Example Alarm Banner and Message Box with Private Message Text.
353
SSP Point
An alarm must occur if the supply static pressure is too low or too high. In the Point
Editor, a LAI point is created as shown in Figure 161. BACnet-specific entries are
made as follows:
354
AddressThe address of the physical analog input (0.0.18) of the BACnet device,
is entered.
Alarm TypeStandard Alarms is selected. The Alarm Properties button does not
need to be clicked because there are no entries to be made in this points
Standard Alarm Setup dialog box.
Figure 161. Example Supply Air Static Pressure Analog Input Point.
Notification Class
The BACnet points in this air handling unit all use Notification Class Instance #1. The
Notification Class is set up in the Notification Classes dialog box (Figure 162).
Notification Class 1, named HVAC Maintenance, has the following priorities:
To Off-Normal160
To Fault130
To Normal200
To Fault has the highest priority because it has the lowest number. An
acknowledgement is required for all transitions that are annunciated.
355
The Recipient List for Notification Class #1 is set up such that Insight workstation
Device 15001, the HVAC Maintenance workstation, is the recipient of all transitions
during regular working hours (Monday through Friday from 6 A.M. to 6 P.M.). At
other times, the Security Guard workstation is the recipient of all transitions. This is
accomplished by the first three line entries in the Recipient List.
These messages are defined in the Alarm Message Definition dialog box (Figure 163)
this dialog box is accessed by clicking the Alarm Messages button on the BACnet
Field Panel dialog box in the System Profile application.
356
New messages are added by clicking the New button which opens the New Alarm
Message dialog box (Figure 164).
357
358
359
In an APOGEE BACnet field panel, the trended object (point) must reside in the same field panel as
the Trend Log object.
Each Trend Log object maintains an internal buffer that fills, or grows, as log records
are added. If the buffer becomes full, there are two options: the oldest record is
overwritten when a new record is added, or collection may be set to stop
(Stop_When_Full property set to TRUE). If logging stops when full, the Log_Enable
property will be set to FALSE (off). The buffer may be cleared by writing a zero to the
Record_Count property. Each record in the buffer has an implied SequenceNumber
which is equal to the value that the Total_Record_Count property has immediately
after the record is added. If the Total_Record_Count is incremented past 232 -1, then
it shall reset to 1.
Logging may be enabled and disabled (Log_Enable property) and at dates and times
specified (Start_Time and Stop_Time properties). Disabling the log overrides timed
operation. Trend Log enabling and disabling is recorded in the log buffer.
Notification is available to initiate automatic uploading of log records from the field
panel to the mass storage device (computer). If a computer or server is set as the
storage device for trends the security of the data needs to be discussed with the
customer and their IT staff. The data stored should be encrypted and the access to it
limited. Additionally a RAID system for recovery purposes should also be considered.
For security Siemens Industry Inc. strongly suggests to follow the security layed out
in ISA 62443.03.03 Level 2 for the protection of data in transit and data at rest to
prevent unauthorized access, theft or modification of trend data. See also Chapter
14. BACnet supports two ways to accomplish this: algorithmic or intrinsic
notification. APOGEE BACnet supports intrinsic reporting, which sends a new
notification to the computer when the Records_Since_Notification, the number of
records collected since the last notification (or startup), equals the
Notification_Threshold property value. The sequence number of the record that
triggered the notification is recorded in the Last_Notify_Record property. In
response to a notification, the subscriber (computer) initiates an upload of the new
records using a service called ReadRange. There is also a methodology for a
subscriber to detect a missed notification by analyzing parameters of the previous
and the current notification.
One of the properties of the Trend Log object is the identity (Instance Number) of a
Notification Class object. This object contains a Recipient List property that identifies
the devices (Insight workstations) that upload the trend data. Also identified are the
days and time range in which that device will upload the trend data. The Notification
Class object is in the same field panel as its related Trend Log object.
360
The acquisition of log records by remote devices has no effect upon the state of the
Trend Log object itself. This allows completely independent, but properly sequential,
access to its log records by all remote devices. Any remote device can independently
update its records at any time.
Table 52 shows the properties of the Trend Log Object as documented in the
ANSI/ASHRAE Standard 135-2004.
Table 52. Properties of the Trend Log Object Type.
Property Identifier
Conformance Code
Object_Identifier
BACnetObjectIdentifier
Object_Name
CharacterString
Object_Type
BACnetObjectType
Description
CharacterString
Log_Enable
BOOLEAN
Start_Time
BACnetDateTime
O1,2
Stop_Time
BACnetDateTime
O1,2
Log_DeviceObjectProperty
BACnetDeviceObjectPropertyReference
O1
Log_Interval
Unsigned
O1,2
COV_Resubscription_Interval
Unsigned
Client_COV_Increment
BACnetClientCOV
Stop_When_Full
BOOLEAN
Buffer_Size
Unsigned32
Log_Buffer
List of BACnetLogRecord
Record_Count
Unsigned32
Total_Record_Count
Unsigned32
Notification_Threshold
Unsigned32
O3
Records_Since_Notification
Unsigned32
O3
Last_Notify_Record
Unsigned32
O3
Event_State
BACnetEventState
Notification_Class
Unsigned
O3
Event_Enable
BACnetEventTransitionBits
O3
Acked_Transitions
BACnetEventTransitionBits
O3
Notify_Type
BACnetNotifyType
O3
Event_Time_Stamps
BACnetARRAY[3] of BACnetTimeStamp
O3
Profile_Name
CharacterString
These properties are required to be present if the monitored property is a BACnet property.
361
Property Identifier
2
3
Conformance Code
For more information about APOGEE trending and how to use trend data after it is
captured, see the APOGEE Trending Application Guide (125-1899).
APOGEE Non-BACnet
APOGEE BACnet
No trend trigger
362
For any particular APOGEE BACnet field panel, you can have up to five Trend Log
Objects for any specific BACnet point, wherever that point may reside. As part of
this, you can now create Trend Log Objects for a single point with the same sample
interval as long as those Trend Log Objects reside on multiple devices.
For example, panel A can have up to five Trend Log Objects for a BACnet point, and
panel B can also have up to five Trend Log Objects for that same point.
If you delete a BACnet point that has Trend Log Objects in other devices, those Trend Log Objects are
not deleted. Also, if you delete a device that has Trend Log Objects for points in other devices, those
points are not deletedthe points will continue to exist in the devices in which they reside.
The following applications have been updated to support Trend Log Objects in other
devices.
Dynamic Plotter
The Dynamic Plotter application has been updated to support plotting of BACnet
Trend Log Object data from multiple devices.
Report Builder/Viewer
The Panel Trend Data Detail and Trend Data Detail reports have been updated to
include filtering options for local and remote trending (Figure 168). In the Definition
Filter section, you can now specify if you want to filter by All, Local Trends, or
Remote Trends.
Remote Trends only apply to BACnet points.
363
In addition to the Panel Trend Data Detail and Trend Data Detail reports, the
following reports have been updated to support local and remote trending:
Trend Collection
Trend Definition
Trend Interval
Trend Sample
Trend Summary
364
365
When selecting BACnet points to trend, you can create trends in the device where
each point resides, or create trends in other devices.
Scheduling Trends
Although the Trend_Log object has its own Start/Stop Date/Time, it can still be
scheduled by the Scheduling application in the field panel. Using the Scheduling
application offers more flexibility than just using the Trend_Log times. For example,
Scheduling a trend allows programming different start and stop times for weekends,
holidays, etc. The Trend_Logs Start/Stop times are unchanging day after day.
366
To use the BACnet Scheduler to schedule when data will be trended, you must
schedule the log-enable property of an existing trend log object. To do this, follow
these steps:
1. From the Tools menu in System Profile, click BACnet Object Browser.
2. In the left pane choose the field panel and open the Trend Logs folder (Figure
173).
3. Choose the trend log to schedule. Note its Instance Number (the number in
parenthesis preceding the object name, for example (5)
00800003_TrendLog_6000). Double-clicking the desired object name will display
its properties in the right pane. The object-identifier property contains the words
trend-log- followed by the Instance Number (for example, trend-log-5).
4. Open the Scheduler. From the BACnet menu, click New, and then Schedule. In
the General tab (Figure 174), choose the device in which the schedule will exist.
Usually this the same device that has the trend log.
Schedule Name should describe details about the trend log being scheduled.
Data Type is BOOLEAN.
Default Value is the state in which the trend logs Log_Enable property will be
set if no command is given to it. False disables the trend log.
For the Effective Period, you usually enter the period in which you want the
trend log enabled, although sometimes you may want this to be the time in
which the trend log is disabled.
Siemens Industry, Inc.
367
5. In the Items tab (Figure 175), click Add to display the Item Properties dialog box.
DO NOT click Select Point.
Object TypeSelect trend-log from the drop down selections. The object-type
number is automatically entered.
Object InstanceEnter the Instance Number of the trend log you selected while
in the object browser.
Property IDSelect log-enable from the drop-down selections; the property ID
number is automatically entered.
Do not check the Array Index box. The output of this schedule is simple
BOOLEAN, not an array.
6. Click OK to close the Item Properties dialog box.
CAUTION:
If you want this schedule to command other items, their properties to be commanded must also
be a data type of BOOLEAN. For one BACnet schedule to command multiple properties with
mixed data types, a Command Object must be used. Put the one Command Object in the items
list and put the assorted data-type properties in the Command Object.
368
Note that in the BACnet Schedule Properties dialog box (Figure 176), the trend logs
Object Name does not appear. Its object name exists in the field panel, but is not
displayed.
To verify that the correct object name is scheduled, use the BACnet Object Browser.
Open the schedule named for the desired trend log. Double-click on the property
called list-of-object-property-references. The Object ID format will have the
Instance Number following the text TLOG and then the trend log name in
parenthesis, for example TLOG-5 (00800003_TrendLog_6000) (Figure 177).
369
Figure 177. BACnet Object Browser to Correlate Name of Scheduled Trend Log.
370
Setup Steps
Even though BACnet trending is based around the Trend_Log object, the Insight
Trending user interface for BACnet bases the trend on the point being trended. This
is the same as regular APOGEE trending. Therefore, when creating, modifying or
deleting a trend, you start by selecting the point being trended.
BACnet trends are setup like any APOGEE trendthrough the Trend Definition Editor
(Figure 179) in the Insight software or Commissioning Tool.
New trends can be created or existing trends can be opened (for viewing or
modification) or deleted by using the corresponding commands on the Trend menu
in the Trend Definition Editor window (Figure 180).
371
The Object Selector dialog box is used to select points for new trends or points that
are currently being trended (Figure 181 and Figure 182).
Figure 181. Object Selector Dialog Box Showing a Trended Points Group.
372
Figure 182. Object Selector Dialog Box Showing Points in a Trend Group.
Once a point is selected, the Trend Type is chosen for new point trends or is
displayed for existing point trends. See Figure 183 for Trend Type dialog box. A
BACnet point in an APOGEE field panel can have one COV and up to four interval
trend types. The trend wizard can be employed to set up a trend in an APOGEE
BACnet field panel.
After a trend type is chosen the COV (Figure 184) or the Interval (Figure 185)
Definition dialog box opens. Assuming a BACnet point was chosen for the trend, the
BACnet Settings section is enabled, but the Conditional Trending section and the
Enable Buffer Full Notification option are disabled. Trigger points are not
supported and the Trend_Log object has its own Notification Threshold for BACnet
trends in APOGEE BACnet field panels.
Siemens Industry, Inc.
373
For a BACnet trend definition, you must provide an Object Name. The Object Name
must be unique within a panel.
374
If you are entering the Object Name manually, consider using a naming format
that includes information about the trend and the point trended. The reason is
that the BACnet Object Browser only displays the trend log object name, type,
Instance Number, present value and status. Encoding trend details in the name
will make the object browser more convenient. For example, for the trend
described in Figure 185 use AHU1_SAT_I15m. I15m means interval, 15 minutes.
For the trend described in Figure 184 use AHU1_SAT_C1F. C1F means COV, 1F.
CAUTION:
You cannot create trend definitions in third-party BACnet panels.
375
Notification Class
The Notification Class object contains a list of what devices (Insight workstations)
are notified to upload a trend log buffer when it reaches its notification threshold. A
Notification Class is created for a Siemens field panel through the System Profile
application. Double-clicking on the desired field panel symbol opens the BACnet
Field Panel Definition window. See Figure 187 and note the Notification Classes
button.
376
The Notification Classes button displays the Notification Classes dialog box. New
Notification Class Instances can be created by clicking Add, which displays the
BACnet Notification Class dialog box (Figure 188).
The name and descriptor of the Notification Class object can be written to encode
the name of the group of recipients of the trend data or the type of trend data that
uses this Notification Class.
The Priority values relate to the BACnet events (transitions) that are generated by
the Trend_Log object. For APOGEE BACnet field panels, only the To Normal Priority
is used for trending. This transition occurs when a notification is triggeredthe value
of the Records_Since_Notification property becomes equal to or greater than the
value of the Notification_Threshold property. This number can be high (192 through
255) for trend data of low importance and lower (128 through 191) for important
trend data.
The Trend Log TO-FAULT transition is intended for failed COV subscription attempts, but since
APOGEE requires the Trended point, Trend Log and Notification Class to be in the same panel, COV
subscription is not used. The To Off-Normal Priority and the Ack field are in the Notification Class
object for when it is used for alarming (Notify_Type property is Alarm) and can be ignored for trend
notification.
377
Recipient List
The Recipient List defines what device (Insight workstation) is notified to upload a
trend log buffer when it reaches its notification threshold. Create a Recipient List for
the selected Notification Class by clicking the lower Add button in the Notification
Class dialog box to open the BACnet Destination dialog box (Figure 189).
378
Figure 189. Recipient Creation using the BACnet Destinations Dialog Box.
379
Valid Days and PeriodTo ensure unimpeded collection of trend data check all
days and select the <any> wildcard entry for the dates.
Create additional Notification Classes and Recipient Lists as required using the Add
button.
380
381
Obtaining BAS-o-matic
BAS-o-matic is a product of Cimetrics, Inc. A free version of the installation program
(demo version - no license or dongle required) is included with Insight Revision 3.7.
It is located on CD#3 as a zip file in a folder named BAS-o-matic. Alternatively, all
versionsincluding the demo versioncan also be downloaded from
www.Cimetrics.com. From the Cimetrics home page, use the following path to
download the installation program:
BACnet > Support Docs & Downloads > BACnet Installation Tools >
B5020 - BAS-o-matic v5.0 Protocol Analyzer (10 Files) > BAS-o-matic Demo
Version
Click the Download button
Siemens Industry, Inc.
383
The demonstration version has many features relative to capturing packets but,
unlike the fully featured versions, does not provide for interpretation and analysis of
the packets.
Connecting to a Network
When using a separate computer to run BAS-o-matic, a dumb hub or a switch that supports port
mirroring is needed to interface the BAS-o-matic computer to the network. When using the Insight
computer to run BAS-o-matic, no special network hookup is required.
Manufacturer
Cisco
3COM
Intel
Port mirroring
3. Plug the BAS-o-matic computer into the hub. Connect the hubs uplink port to
the main network using the jack that the Insight computer was connected to.
4. Make sure the network card in the BAS-o-matic computer is properly installed in
the operating system.
385
6. Run BAS-o-matic (the installation should have put an icon on the Windows
Desktop). Verify operation and network connection. Fully featured (non-demo)
versions should check for the hardware key, then startup. If a fully featured
version comes up in Demo Mode, then check the dongle and the license file for
problems.
7. Make sure the network interface card (NIC) is set as desired from the choices in
the drop-down list box in the opening window. This should default to the
network adapter of the computer in which BAS-o-matic is installed. In Figure
192, Intel PRO/1000 MT Network Connection - Packet Scheduler Miniport is
chosen.
5. Select the Display Invoke ID checkbox so that on displays. If you know that UDP
ports other than 47808 are being used for BACnet/IP on the network, enter them
as comma separated values in the Listen to Ports field. Click OK twice to close
the dialog boxes.
6. From the Rules tab (Figure 194), select Protocols & Direction in the left sidebar
under the Simple Rules heading. Clear the Enable Ethernet protocol rules box if
checked. Clear the Enable direction rules box if checked. Check the Enable IP
protocol rules box. In the Enable IP protocol rules section, select UDP in the
Description list. Verify that all other protocols are not selected. In the Action
group, click Capture.
387
Port RulesIf capturing a specific UDP port is desired, select Ports in the
navigation frame under Simple Rules.
Important:
If you are using port rules, BAS-o-matic will be unable to automatically reconstruct
segmented BACnet/IP messages; therefore, port rules should not be used unless necessary.
To use port rules, select the Enable port rules box. In the Action section, select
Capture. In the Add Record section, select Both, type 47808 in the field, and
click Add Port. Other UDP ports can be added as well.
7. Select the Packets tab. It should be empty.
8. From the File menu, select Start Capture. If BACnet traffic exists, the window in
the Packets tab should start filling with lines of information on each packet
detected.
9. Perform actions on the APOGEE and/or foreign systems to investigate the
problem under scrutiny.
10. After capturing data, select Stop Capture from the File menu.
11. From the File menu, select Save Packet Log As...
12. Save the log with a meaningful name and type: BAS-o-matic 5.0 Capture Files
(*.ncf).
BAS-o-matic should display a message box describing how many packets were
saved and to what file.
388
13. If more data needs to be captured, or it only occurs after a long time, check Auto
Saving on the Logging tab. Designate a directory where the log file should be
stored with Save logs to:. When you start your capture, data will be sent to a
default file in your designated directory each time 500 packets have been
received. After a capture, click Concatenate logs to make them into one large
file. Use a compression software application (such as WinZIP) to shrink the file
for distribution via e-mail.
14. Send the saved file(s) via e-mail to the Field Support group of the manufacturer
whose equipment is causing the problem.
389
5. Select the Display Invoke ID checkbox so that on displays. Click OK twice to close
the dialog boxes.
6. From the Rules tab, select Protocols & Direction in the left sidebar under the
Simple Rules heading. Select the Enable Ethernet protocol rules box.
7. Check IEEE802.3 in the Description list. In the Action group, click Capture.
This filter will capture all the BACnet/Ethernet packets and will filter away most
of the unwanted packets. This can be used in combination with other filtering
options to further enhance the capability.
8. Select the Packets tab. It should be empty.
9. From the File menu, select Start Capture. If BACnet on Ethernet traffic exists, the
window in the Packets tab should start filling with lines of information on each
packet detected.
10. Perform actions on the APOGEE and/or foreign systems to investigate the
problem under scrutiny.
11. After capturing data, select Stop Capture from the File menu.
12. From the File menu, select Save Packet Log As...
13. Save the log with a meaningful name and type BAS-o-matic 5.0 Capture Files
(*.ncf).
BAS-o-matic will display a message box describing how many packets were saved
and to what file.
14. If more data needs to be captured, or it only occurs after a long time, do the
following: check Auto Saving on the Logging tab. Designate a directory where
the log file should be stored with Save logs to:. When you start your capture,
data will be sent to a default file in your designated directory each time 500
packets have been received. After a capture, click Concatenate logs to make
them into one large file. Use a compression software application (such as
WinZIP) to shrink the file for distribution via e-mail.
15. Send the saved file(s) via e-mail to the Field Support group of the manufacturer
whose equipment is causing the problem.
For the Custom Solution BACnet MEC, Commissioning Tool allows import of point
information on a Microsoft Excel spreadsheet into the Point Editor. However,
importing spreadsheets is not available for use with third-party field panels.
The following sections explain the levels to which the Commissioning Tool
applications support APOGEE BACnet field panels.
Backup/Restore
HMI Transfer application provides capability to backup/restore APOGEE BACnet field
panels to the Commissioning Tool (job) database. This includes support for the
following BACnet-specific objects:
Calendar
Command
Notification Class
Schedule
Terminal Emulation
Terminal Emulation is available for operator interface with a field panel. A COM port
or a modem can be used for communication between a computer and a field panel.
391
Point Transfer
The Point Transfer (XPoint) application allows points to be transferred from the Job
database into a Microsoft Excel spreadsheet or from an Excel spreadsheet into the
Job database. In Excel, new points can be added or existing points can be modified,
and then the changes can be imported to the Job database.
Point Transfer provides limited support for APOGEE BACnet field panels. Only
APOGEE non-BACnet data is transferred to or from the Excel spreadsheet.
When transferring BACnet point data to Excel, you lose the BACnet-specific
parts of the point data (Instance Number, Notification Class, Annunciate flags,
etc.).
When transferring Excel point data to a BACnet panel in the Job database,
default values are inserted where possible. For example, Instance Numbers are
set to -1, and Notification Class is set to 0.
Therefore, it is necessary for the user to manually fill-in the missing BACnet-specific
data.
392
The Non-Field Panel Data Transfer application supports APOGEE BACnet field panels
but not third-party devices.
Point name
Point descriptor
Point type
Point address
Alarmable
Controller
Point Address
Present_Value
393
Some notes about the operation of the Multiple Device Configuration tool are:
394
The object selector will show cloaked devices so the user can uncloak them.
The same limits are enforced as in the Advanced Settings dialog box (accessed
through the BACnet Field Panel Definition dialog box).
I-Ams are added to the dialog box as they are received. The columns sort when the
heading is clicked. A Total Count box lists the total number of I-Ams received.
395
This feature is useful when running tests on other devices on the network and a
certain device or devices may interfere with those tests. For example, if certain
devices are communicating a lot, the network may be too noisy to test the
communication of other devices. This tool allows the user to quiet the noisy devices
for the time the tests have to be run.
The Insight Help message gives another example. A user can disable the
communications of a field panel on which a power fail test is to be run so that
alarms are not sent to Alarm Status.
When the testing is completed, the field panel communication can be manually
enabled or communications will automatically enable after the Disable duration time
has elapsed. Setting the time to 0 disables the timer and keeps the field panel
disabled until it is manually enabled.
CAUTION:
Use caution when disabling (entering a value of 0) the Disable duration timer. Device communication
will not be able to resume until manually enabled.
396
The BACnet Device Communication Control dialog box (Figure 198) is accessed from
the Tools menu in the System Profile application.
Give a suggestion for the best time to use the APDU timeout. The Suggested
APDU Timeout is calculated by adding four seconds to the largest Response
Time for a test ADPU issued by the Insight application.
Help test for APDU turnaround time, and show how slow some devices are
communicating on the BACnet network. This can be done by running multiple
tests, each with a reduced BACnet APDU timeout value. When a panel does not
respond (request timed out), the Current BACnet APDU Timeout value is less
than the turnaround time. Adjusting the BACnet APDU Timeout allows zeroing
in on the turnaround time.
397
The BACnet Communication Diagnostic tool allows you to test a single device or
select all BACnet panels in the database. Operation is as follows:
Press Begin. The device(s) are sent a request for the value of a read property.
If the Response Time and the Current APDU Timeout differ for a field panel, the
suggested timeout can replace the current timeout by highlighting the field
panel row and clicking the Set APDU Timeouts button. Multiple rows can be
highlighted and set with one click of the set button, but if a row with errors is
selected, it will be skipped and the APDU timeout will not be changed for that
device.
APDU Timeout and Retries are BACstac settings to control how long a command has
to complete before timing out and how many times to retry the command. The
Insight software enforces a minimum of 1 retry and 5 second timeout. These values
are set in the Advanced Settings of the BACnet Field Panel Definition. In the Insight
software, this dialog box appears in System Profile.
CAUTION:
Some third-party devices may have default timeout values that are way too long. For example,
anything over 30 seconds is too long and should not be required. If a panels turnaround time is slow
and a long timeout is required, it will slow the operation of the Insight application. Long turnaround
time issues for a panel must be resolved with the manufacturer.
The BACnet Communication Diagnostic dialog box (Figure 199) is accessed from the
Tools menu in the System Profile application.
398
CAUTION:
The timeouts in this tool are for Insight software only. A field panel has its own, single timeout value
and retry value that it uses when it requests data from other devices. These two values are read only
and can be accessed through the Object Browser by viewing the ADPU_Timeout and
Number_of_ADPU_Retries properties of the Device Object of the field panel. The APOGEE BACnet
field panel firmware sets these values to three seconds for timeouts and three retries
399
400
BBMDs.
This chapter will discuss each of these issues and provide recommendations for
each.
Port Usage
IT folks typically need to know BACnet/IP port usage so they can configure their
firewalls. The User Datagram Protocol (UPD) is set to 47808 by default but is
configurable. The Field Panel Users Manual will tell you how to change the port
from 47808 to another port.
The customers IT department may not want to use a common default port for security
reasons. However, will have to change every device on the network if 47808 is changed.
CAUTION:
The modification of network settings has an impact on the cyber security of the network.
It is necessary to discuss these modifications and their implications with the
customer/end user to ensure they understand the risks so that they are aware of the
risks and can manage them.
401
Port
Protocol
Used By
TCP
Ping/ICMP
23
TCP
Telnet
25
TCP
SMTP
53
TCP/DNS
All APOGEE
PCs/Ethernet
Field Panels
67/68
UDP
BootP/DHCP
69
UDP
TFTPD
80
TCP
Internet Explorer
100
402
Comments
135
TCP
RPC
137
UDP
NETBIOS
Datagram Service
Used by NetBIOS.
138
UDP
NETBIOS
Datagram Service
Used by NetBIOS.
Port Usage
Port
Protocol
Used By
Comments
139
TCP
NETBIOS Session
Service
Used by NetBIOS.
161
UDP
SNMP
162
UDP
SNMP
502
TCP/UDP
Modbus TCP
BCS/RPC event
notification
1200
through
5000
DCOM
ports
TCP/UDP
Insight DBCS
Service when
using Object
Selector
optimization,
TM
APOGEE GO
2050 and
2051
UDP
Rainbow
3001
TCP/UDP
Async Service
3002
TCP/UDP
Telnet
3389
TCP
Terminal Services
Terminal Services.
5033
TCP
Ethernet Field
Panels
5093
UDP
Rainbow
5099
TCP/UDP
Rainbow
5441
TCP
LSNIFF
5442
TCP
IPSNIFF, BACnet
stack
6775
through
6778
TCP
Objectivity/DB
6779 and
6780
TCP
Objectivity
5.2, 6.x, 7.x, 8.x, and 9.x (Insight 3.2 and later).
47808
TCP/UDP
BACnet
9999
TCP
Telnet
403
Port
Protocol
Used By
Comments
12001
12002
12003
12004
12005
TCP
Dialogic Board
47808
UDP
BACnet
Firewall Settings
Port
Type
Notes
161
UDP
162
UDP
1977
TCP
4897
TCP
PVSS00data.exe
4998
TCP
PVSS00event.exe
4999
TCP
7774
TCP
HDB access used for sending trend data to the client for display
7775
ARCHIVE_DEFAULT_PORT
From GMS_PLATFORM_APPL\HDB\Examples\BCM\
Communication\GMSClient\GmsClientResources.hxx
47808
UDP
You should add the ports as shown in Table 57 to Windows 7 Firewall on the Web
Server computer to allow access between the Web Server and its clients.
Table 57: Additional Desigo CC Firewall Port Settings on the Web Server Computer.
Firewall Settings
Port
404
Type
Notes
80
TCP
Standard HTTP port for all web clients, and the number assigned to the
default web site when IIS is installed. If this port is already in use, you
must specify a different port number.
443
TCP
Firewall Settings
Port
8000
Type
TCP
Notes
Windows Communication Foundation. The Desigo CC installation
program defaults to this port.
A Foreign Device
Use the following guidelines to determine the appropriate setup for your
installation.
Unicast, Broadcast
14
The information in this section is taken from a draft of the Network Setup and Troubleshooting Manual. At the time of this writing,
this manual is not yet published or posted anywhere on the Siemens Intranet.
405
BBMDs
Many IP routers prevent broadcast messages from being transmitted across a Wide
Area Network (WAN). The BACnet protocol uses broadcast messages called Who-Is
and I-Am to interrogate the network and determine what other BACnet devices exist
on the BACnet Internetwork. For these broadcast messages to be transmitted across
IP routers that block such messages, one device on each IP subnet must be set up as
a BBMD.
Each BBMD shall possess a table called a Broadcast Distribution Table (BDT) which
shall be the same in every BBMD in a given BACnet/IP network. If the BBMD has also
been designated to register foreign devices as described below, it shall also possess
a Foreign Device Table (FDT).
Set up only one BBMD for each IP subnet, and set up the Broadcast Distribution
Table with the IP addresses of all other BBMDs that you want the workstation to
work with. The Broadcast Distribution Tables must match the list of BACnet devices.
If this is already an operational BACnet network, BBMDs may have been set up by
the Network Administrator/Coordinator. Always consult with your Network
Administrator/Coordinator when setting up BBMDs. There must be only one BBMD
per IP subnet. This BBMD may be a workstation, Siemens field panel or a third-party
panel.
Each workstation that acts as a BBMD for a subnet requires a fixed IP address.
There are two ways that a BBMD may distribute broadcast messages to remote IP
subnets.
406
407
Figure notes:
1.
A field panel in IP Subnet 1 (10.0.0.x) initiates a broadcast message (such as WHO-IS) that is
received by the other BACnet device and the BBMD on the same subnet.
2.
The BBMD on IP Subnet 1 see the broadcast and sends a directed unicast message through the IP
routers to the BBMD on IP Subnet 2 (20.0.0.x) and IP Subnet 3 (30.0.0.x)
3.
The BBMDs of IP Subnet 2 and 3 then re-broadcast the message on its respective network.
If a new BBMD joins the network, the Insight workstation must be rebooted if its defined
as BBMD.
Figure 200: Illustration of a Two-Hop BBMD Network.
408
Foreign Device
BACnet devices can be configured as a foreign device if you do not allow the
Siemens field panel to be a BBMD on their network or if a third-party device is on a
different subnet and does not support the BBMD function but can be set up as a
foreign device.
Communicate broadcasted message ONLY with the BBMD to which they are
individually subscribed.
HMI
Prompt/Field
Option/Entry
Description
Node name
Alpha-numeric field
Object name of the panel, must be
unique on the entire system.
Site name
Alpha-numeric field
BACnet panels and Insight software on
same IP subnet should have the same
site name. The site name affects which
discovery and replication times are
used.
BLN name
Alpha-numeric field
This must be identical to the System
Name of the BACnet ALN in System
Profile.
DNS suffix
DHCP
DHCP is enabled
DHCP server is to assign the field
panels IP addresses.
DHCP is disabled
If using fixed IP addresses.
409
Prompt/Field
Option/Entry
Description
IP address
Numeric field
If DHCP = N, you are prompted for an IP
setting. Enter the IP setting.
If DHCP = Y, you are not prompted for
the IP setting.
Netmask
Numeric field
Gateway address
DNS 1
DNS 2
DNS 3
DNS 4
Telnet Enabled
Configure BACnet
410
Telnet is enabled
To allow remote HMI sessions via
Telnet and to enable FTP
Telnet is disabled
Remote HMI and FTP are blocked.
Numeric field.
Valid values are 0 through 4,194, 302,
must be unique on the entire BACnet
site.
Recommended values: 7000 to 7999
for Siemens panels.
Device Location
Alpha-numeric field
Specify a descriptive location so the
customer or other Siemens employee
can locate the device.
Device Description
Prompt/Field
Option/Entry
Description
UDP Port
No IP ALN.
411
Prompt/Field
Option/Entry
Description
ALN, BACnet MS/TP ALN or BACnet
MS/TP FLN or third-party network
number may be the same.
P1, MS/TP
412
Prompt/Field
Option/Entry
Description
use this address.
OK to coldstart (Y/N)
BACnet networks must have the Configure for BACnet Client checkbox
selected as shown in Figure 201 below..
The Configure for BACnet Server checkbox is only used if you are exporting
P1/P2 points as BACnet points to 3rd-party devices.
Selecting the BACnet Client option puts BACstac service dependencies in place.
These dependencies can prevent ASYNC, Loader, and other services from
starting if the laptop is used at a non-BACnet site.
Unchecking the option when leaving the BACnet site will prevent any conflicts.
413
414
In general, faster baud rates will increase performance on the network, so that
76.8Kbps will perform faster than 19.2Kbps, for example. However faster baud
rates do increase sensitivity to outside interference on RS-485 wiring. Every
device on the network must support and be configured for the same baud rate.
Since Siemens devices that reside on a BACnet MS/TP ALN are treated as field
panels to be backed up and monitored by the Insight workstation, network
traffic between these devices and the Insight workstation is heavy. This limits
the number of devices that may productively reside on a single BACnet MS/TP
ALN network to approximately 10 devices, depending on point counts and
network activity. Network performance may drop significantly if more than 10
Siemens field panels are added to the MS/TP ALN.
Additional BACnet MS/TP ALN networks, with different ALN Name, may be
added without compromising network performance through an additional PXC
Modular/PXC Compact 36.
Only PXC Modular with Firmware Revision 3.1 and later and PXC Compact 36
BACnet field panel support the BACnet/IP ALN to BACnet MS/TP ALN router
functions.
All BACnet MS/TP ALN devices on an ALN must be on the same physical MS/TP
segment.
For example, you have two PXC Modular and two PXC Compact 36 field panels on a
BACnet IP network. Each of those supervisory controllers has nine PXC Compact
16/24 connected to the MS/TP ALN port . In this case, you would need to define four
separate ALNs in System Profile.
Alnnode, Flnnode
Ok to coldstart (Y/N)
Option/Entry
Description
415
To modify BACnet device settings, type the following letters in sequence and
proceed with the steps:
HMI
Steps
Prompt/Field
Device Instance Number
Option/Entry
enter the device instance
number
(0 4,194,302)
Recommended values are between
7000 and 7999; must be unique
throughout the BACnet network.
Device Location
Device Description
OK to coldstart (Y/N)
416
Description
Example
>Point, Application, Time, Message, Cancel, System, passWord, Bye? s
>Diagnostics, Users, dSt, Bacnet, Error_msgs, Hardware, Text, Quit? h
>Fieldpanels, Ethernet, nodeNametable, Disks, Reportprinter, Licensemanager,
Quit? f
>Log, Display, Add, dElete, Modify, Config, Quit? c
>Hmi, Aln, deVice, db_fiLe, Fln, Names, Defaultlanguage, Quit? v
>Display, Modify, Quit? m
>Device Instance Number
13933--
>Device Location
>Device Description
ABSORPTION CHILLER-----------
10000--
30--
60--
Command successful
If the MS/TP ALN is already enabled, and the BACnet/IP ALN port is either disabled or not
present on this device, the following prompt is not displayed. Under these conditions,
continue this procedure with the following step (MS/TP ALN Baud Rate prompt).
417
Prompt/Field
Option/Entry
Description
Example
>MSTP ALN Network Number : 55-->MSTP ALN Node Address : 127
>MSTP ALN Baud Rate : 9600--->OK to coldstart (Y/N) : y
418
In general, faster baud rates will increase performance on the BACnet MS/TP
network, so that 76.8Kbps will perform faster than 19.2Kbps, for example.
However faster baud rates do increase sensitivity to RS-485 wiring guidelines.
Also a number of microprocessor UARTS of MS/TP device cannot accurately
produce 76800 baud signals. Devices using these microprocessors might list
76800 as supported but you may have network issue. 38.4KKbps is strongly
recommended for MS/TP network communication.
BACnet MS/TP devices resident on a BACnet MS/TP FLN are treated as FLN
devices with point teams automatically created in the field panel. Point teams
Siemens BACnet TECs are supported by the field panel and Insight workstation
with initial values support, and drag and drop reports.
In general, expect that BACnet MS/TP FLNs will perform slower than P1 FLNs
due to the following: increased communication requirements for BACnet MS/TP
compared to P1, lack of COV support in many BACnet MS/TP devices (including
BACnet TECs), token passing when MS/TP devices configured as masters require
additional communication time, and high volume of devices on single physical
network which adds to communication time. So despite the significant
increased speed of the BACnet MS/TP baud rate over the P1 baud rate, the
actual communication response is slower due to the factors cited above.
419
Benefits
You can more than 10 Siemens field panels reside on a MS/TP FLN whereas you
are limited to only10 Siemens field panels on a MS/TP ALN.
You want to replace a third-party controller that is on the FLN with a Siemens
BACnet field panel and use the same wiring.
With a MS/TP driver you can add a Siemens BACnet field panel on that FLN.
Disadvantages
You cannot edit the field panels database from the Insight workstation.
If the System Name for points in the child field panel is longer than 12
characters, then the parent panel will use the ObjectName_InstanceNumber as
the name.
Adding a BACnet MS/TP PXC Compact 16/24 or UEC to a MS/TP FLN Network
BACnet MS/TP PXC-16/24 controller is configured as an ALN node out of factory, opposed
to UEC is configured as a FLN node out of factory.
Prompt/Field
Alnnode, Flnnode
Ok to coldstart (Y/N)
420
Option/Entry
Description
HMI
Prompt/Field
Option/Entry
Description
Node name
Alpha-numeric field
Object name of the panel, must be
unique on the entire system.
Site name
Alpha-numeric field
BACnet panels and Insight software on
same IP subnet should have the same
site name. The site name affects which
discovery and replication times are
used.
BLN name
Alpha-numeric field
This must be identical to the System
Name of the BACnet ALN in System
Profile.
DNS suffix
DHCP
Telnet Enabled
Configure BACnet
DHCP is enabled
DHCP server is to assign the field
panels IP addresses.
DHCP is disabled
If using fixed IP addresses.
IP address
Numeric field
If DHCP = N, you are prompted for an IP
setting. Enter the IP setting.
If DHCP = Y, you are not prompted for
the IP setting.
Telnet is enabled
To allow remote HMI sessions via
Telnet and to enable FTP
Telnet is disabled
Remote HMI and FTP are blocked.
421
Prompt/Field
Option/Entry
Description
Numeric field.
Valid values are 0 through 4,194, 302,
must be unique on the entire BACnet
site.
Recommended values: 7000 to 7999
for Siemens panels.
Device Location
Alpha-numeric field
Specify a descriptive location so the
customer or other Siemens employee
can locate the device.
Device Description
422
Prompt/Field
Option/Entry
Description
of the BACnet/IP to BACnet MS/TP ALN
router. No other device on the BACnet
MS/TP ALN may have the same MAC
address. Other MS/TP FLNs or MS/TP
ALNs may use this address.
OK to coldstart (Y/N)
MAC Address For BACnet TECs (BTECs), the MAC address is also the value of
CTLR ADDRESS (Point 1).
MS/TP Device Instance Number See the ID field in the BACnet Properties
dialog box in WCIS.
Baud Rate See the Baud Rate drop-down list in the BACnet Properties dialog
box in WCIS.
MS/TP Node Type (slave or master) See the MS/TP Slave check box in the
BACnet Properties dialog box in WCIS.
Figure Figure 202 is an example of the BTEC information displayed in the WCIS
BACnet Properties dialog box:
423
424
This number should not be the same as the BACnet/IP Network Number or
any other network number on the site, including third-party network
numbers.
The Virtual BACnet network in the Cimetrics properties has a default network
number of 2. The network number cannot match any network number used
for the MS/TP FLN.
7. Leave the rest of the fields as default in the MS/TP FLN Settings dialog box and
click OK.
8. When the BACnet Field Panel Definition dialog box displays, click OK.
9. Click Yes when prompted with the following message:
The changes made to the panel definition will cause the field panel to coldstart.
Do you wish to proceed?
425
NOTE: Must be identical to the MS/TP device baud rate. See the Baud Rate
drop-down list in the BACnet Properties dialog box in WCIS.
NOTE: Must be a unique number. Valid values are 1 through 65534. This
number cannot be the same as the BACnet/IP Network Number or any other
Network Number on the site, including third-party network numbers.
NOTE: Field panel's MAC address. Leave it as 127, unless another device
on the network has a MAC address of 127.
Command successful
426
System Name and Name: Enter a descriptive name without any special
characters. It does not have to match the Name defined in Device Properties
in WCIS.
Application: Select 65535 for a BTEC; otherwise, enter a number from 10000
through 11999.
Device Instance: MS/TP Device Instance Number. For BTECs this is the value
from the ID field in WCIS.
Network Number: Enter the MS/TP Device Network Number. This number
must be identical to the Network Number defined in the MS/TP FLN Settings
dialog box in the procedure Configuring the FLN for MS/TP. Valid values are 1
through 65534. This number must not be same as the BACnet/IP Network
Number.
BACnet MAC Address: Enter the value for the Controller Address point
obtained from WCIS in the procedure Gathering Information from the BACnet
MS/TP Device. Enter the value as a decimal value.
MS/TP Node Type: Select the same MS/TP node type as you obtained from
WCIS in the procedure Gathering Information from the BACnet MS/TP Device.
Save Relinquish Defaults: Select this check box for a BTEC. Clear this check
box for third-party devices.
427
NOTE: Leave this field blank for BACnet TECs (BTECs). For thirdparty devices, valid values are 10000 to 11999
Descriptor:
428
NOTE: For BTECs, the MAC address is also the value of CTLR
ADDRESS (Point 1).
NOTE: For BTECs, set this field to YES. For third-party devices, set
this field to NO.
The Configuring the BACnet TECs procedure may be performed before Setting the
MS/TP Router Terminations through Configuring the MS/TP Router Settings (in the
case that the BACnet TECs are available before the MS/TP Router).
429
http://iknow.us.abatos.com/customsolutions/HVAC_main.asp
Beacon: https://inet.sbt.siemens.com/customsolutions/HVAC_main.asp
Cimetrics refers to the physical network numbers as DNET numbers. These DNET
numbers must be configured properly or communication cannot be established.
In addition, it is also necessary to know the UDP port number that is being used,
since this must be configured at both the router and at the Insight BACnet
workstation. This process assumes the Cimetrics router will be used in conjunction
with an Insight workstation. If it is used with another third-party system, you must
find the physical network number(s) the third-party system uses.
430
Physical Network number for the BACnet/IP network to which you intend
to connect the router. This is located in the Network Num column. This
number will be used as the Routers BACnet/IP DNET number.
The UPD Port number. This number will be used in the BACnet/IP
configuration of the B6000 Router. It is usually set to 47808.
To determine which physical network numbers and which UDP port number to use,
if the third-party BACnet vendors are present, then ask the following questions:
Which physical network numbers are being used for the BACnet/IP network?
Which physical network and virtual numbers they are using for other networks?
Do not use these network numbers in the routers configuration or for the Insight
BACnet workstations Cimetrics Setting.
Which UDP port they are using? The UPD port 47808 is the default, but
sometimes, other ports may be used.
The end of every segment must be terminated. The end of a segment is any FLN
connector with only one set of wires connected to it. The following are different
ways to terminate segment ends:
The MS/TP Router is terminated by placing the termination jumpers (see
Setting the Router Termination).
The recommended wiring is our standard ALN/FLN wiring, 24 gauge, Cat 5,
twisted, shielded pair, low capacitance (12.5 pF/ft.), available from Anixter.
See the Field Purchasing Guide for more information.
Terminate the last TEC with an ALN Trunk Terminator (Part Number 538664).
431
Terminate all FLN connectors that connect to an HSTIE by setting the Trunk
Termination Switch (inside the HSTIE enclosure) for that FLN connector to an
End of Line (EOL). Do not add an ALN Trunk Terminator. If there are two sets
of wires in one FLN connector, the Trunk Termination Switch should be set
to Normal (NRML).
HSTIEs are required if more than 31 of the older BACnet TECs are used. For
BACnet TECs sold after November 2005, a maximum of 50 TECs can be placed
on a single router without any HSTIE. Additional TECs can actually be used, but
over 50 is not recommended because change of values (COVs) will update
slowly.
To determine if the BACnet TECs are the type that allows more than 31 on a
segment, locate the chip labeled U16 on the board, which is about 1-inch above
terminations 7 and 8. If the TEC is the newer type, the marking MAX3085 is printed
on the chip. The older types of TECs have a series of numbers printed on them, but
not "MAX3085".
The E terminal of the power connector for all BACnet TECs must be connected
to earth ground. If the E terminal is not connected to earth ground, the BACnet
TECs could potentially lock up and stop communicating.
Connect the shield wire to every BACnet TEC and to the MS/TP Router.
432
Figure 205: Termination Jumper Placement inside the Cimetrics B6000 Router.
433
Select Internet Protocol (TCP/IP), and then click the Properties button.
3. Disable the ISA Firewall Client by right-clicking on the ISA Firewall Client icon in
the system tray in the lower right corner of the screen and selecting Disable.
4. Open Internet Explorer. Type http:// 192.168.88.89 in the Address box and press
ENTER.
5. The MS/TP Router prompts you for a User Name and Password. Type admin for
both the username and password.
434
Set the value of This Station (MAC), to a value from 1 through 127, that is
not equal to any of the ADDRESS (1) subpoints of any BACnet TECs. The
MS/TP Router is actually a node on the MS/TP network, similar to TECs. If
the MAC address of the MS/TP Router were the same as one of the
BACnet TECs, the network would not communicate properly and the
BACnet TECs would fail.
Set Max Master to 127. This sets the highest MAC address the MS/TP
Router can poll. As a general rule, this should be at least the value of the
highest TEC address on the network if it is not, the TECs cannot
communicate.
Set DNET to a unique value. This value must be different from the
following:
The DNET parameter on the BACnet/IP settings.
The Insight workstation's Cimetrics Network numbers (physical and
virtual).
The networks for any other router or Insight workstation.
Click Save.
435
The MS/TP Router configuration Web page can still be contacted from a computer
whose IP address is 192.168.88.90 by typing http://192.168.88.89 in the address
box of Internet Explorer. This method works even if the MS/TP router has been
configured with a different IP address. This is useful if the IP address of the MS/TP
Router is unknown.
http://iknow.us.abatos.com/customsolutions/HVAC_main.asp
From Beacon:
https://inet.sbt.siemens.com/customsolutions/HVAC_main.asp
3. Save TEC initial values using the backup feature in WCIS 2.1.4. Neither the MS/TP
Router nor the BACnet MS/TP Driver has the ability to back up or restore initial
values.
4. Click the Device drop-down menu. The WCIS software pauses and the mouse
pointer may change to an hour glass.
5. Click on Device Properties. Again, there may be a pause.
6. Set Object Name to a unique name (12-character limit).
7. Set the Object ID to a unique value from 0 to 4194303.
Object ID is not the MAC address; it is a higher-level address within the BACnet MS/TP
protocol (device instance number).
436
(Optional)
1. Configure the controller for MS/TP Master or Slave. To determine which to use,
consider the following:
-
Use Master if you will be referencing several of the BACnet TEC points in
PPCL. If you select Master, you can use the BACnet TEC point names in PPCL,
such as [ObjectName]Room Temp.
Use Slave if you are concerned with performance, specifically the rate at
which the BACnet TECs update. To use the BACnet TEC point names, such as
[ObjectName]Room Temp in PPCL, you must manually type the name in the
BACnet address table from System Profile or the field panel HMI, or use a
fully qualified BACnet object name, such as 70001_AI_4.
If the customer requests Metric Units, select the Metric Units check box.
2. Follow the procedures in the BACnet TEC startup document(s) for your
application. Those documents are available at.
http://iknow.us.abatos.com/customsolutions/HVAC_main.asp.
Exit Regedt32.
437
2. Once all the BACnet TECs have been configured, connect the MS/TP connector to
the MS/TP Router.
3. Open System Profile at the Insight workstation.
4. If there is not already one present, create a BACnet ALN.
5. Do one of the following:
-
If the TECs are configured for MS/TP master, click Enable BACnet Discovery
in System Profile, and then click Send Who Is.
If the TECs are configured for MS/TP Slave or you want to specify the System
Name of the TECs, manually add the BACnet TEC. To do this, drag-and-drop a
field panel on the ALN for each TEC.
6. Set the Device Instance Number equal to the TEC device instance number
(Object ID) in Configuring BACnet TEC, Step 11.
7. Assign a unique System Name and Name.
8. If you are not using BACnet Discovery, manually add a TEC. To do this, drag-anddrop a field panel on the ALN for each TEC.
-
Set the Device Instance Number equal to the TEC device instance number
(Object ID) in Configuring BACnet TEC, Step 11.
Installation
Wireshark can be installed on most Microsoft operating systems running Windows
XP, Windows Server 2003, Windows Vista, Windows 2008, Windows 7, and Windows
2008 R2.
You can download a copy of the latest Wireshark application from
http://www.wireshark.org/.
438
439
Netgear DS104
Netgear DS108
Netgear GS108NA
Netgear GS105?
440
Starting Wireshark
441
File. The File drop-down menu allows you to open, save, and export capture
files.
Capture. The Capture drop-down menu allows you to start and stop a capture,
as well as select a network interface where you want capture data to reside on.
2. Select the network card you want to capture data from by using the radio
buttons on the left side and then click the Start button.
442
443
1. To save the data packets, select Save-As from the File drop-down menu.
The Wireshark Save file as dialog box displays.
444
2. To save all the packets, select the All packets and Captured radio buttons in
the Packet Range section.
3. Navigate to the folder location where you want to save the captures, type in a
filename, and then click the Save button.
Display Filters
Display Filters are used to view only the packets that you want to see and hide the
packets you dont want to see. You do this by building a filter expression in the filter
toolbar.
445
Comparison Operators
Description
Wireshark syntax
English syntax
Equal
==
eq
Not equal
!=
ne
Greater than
>
gt
Less than
<
lt
>=
ge
<=
le
Wireshark syntax
English syntax
&&
and
or
Logical Operators
Description
And
Or
Not
not
Wireshark syntax
ip.addr
Source IP Address
ip.src
Destination IP Address
ip.dst
MS/TP.src
MS/TP.dst
bacnet
bacapp.objectType
bacapp.instance_number
bacapp.confirmed_service
446
Wireshark syntax
bacapp.unconfirmed_service
Value
Analog Input
Analog Output
Analog Value
Binary Input
Binary Output
Binary Value
Calendar
Command
Device
EventEnrollment
MultiState Input
13
MultiState Output
14
MultiState Value
19
Value
confirmedCOVNotification
confirmedEventEnrollment
SubscribeCOV
ReadProperty
12
ReadPropertyMultiple
14
Write Property
15
WritePropertyMultiple
16
ConfirmedPrivateTransfer
18
447
Value
I-Am
26
I-Have
27
unconfirmedCOVNotification
28
unconfirmedEventNotification
29
Who-Has
33
Who-Is
34
Building Filters
Building Display Filter Expression
You build a Display Filter by using the Filter Expression dialog box.
Displaying Statistics
This procedure allows you to display the statistics on all the packets you have
captured and statistics for any packets that meet the Display Filter criteria you have
defined.
To display the summary, select Summary from the Statistics drop-down menu.
Summary dialog box displays.
449
450
The Summary dialog box displays statistics of a total of 4.978 COVs per second
being sent.
451
The Summary dialog box displays statistics of a total of 2.703 alarms per
second being sent.
(ip.src == 192.168.1.125)
The Summary dialog box displays statistics of a total of 2.339 alarms per
second from IP address 192.168.1.125.
The Summary dialog box displays statistics of 1.967 alarms per second from
Binary Value 444.
The Summary dialog box displays statistics of 191.567 broadcasts per second
occurring on this subnet.
452
453
455
Passwords should not be shared with others. Ideally, passwords and usernames
should be immediately removed from the system if the user does not need access
anymore. At minimum, passwords need to be changed regularly so that users who
have changed job functions or have left the customers organization cannot continue
to access to the system software.
Our customers need to be educated and advised to create their own IT policy if they
do not have one. A Siemens minimum standard should be suggested if the customer,
for whatever reason, does not want to create their own IT policy. Password policies
must include certain standards, such as minimum complexity rules, and changing
passwords at fixed time intervals.
Usernames should be assigned to individual users so that they can be monitored
and/or held responsible for their action. Group identification should only be
permitted when it is absolutely necessary for the work to be performed.
Customers should be given the option to choose the level of security they would
like. Siemens recommends thatusers create the strongest practical password for
their personal access. However, if the user chooses to create a weaker password,
then his/her decision should be recorded. Some examples of procedures to create
weak, strong, and strongest passwords are:
User Accounts
Create a specific user account for each individual employee and provide that
info to the user (stronger).
Create a new and unique username and password and provide it only if and
when needed by the employee performing the work (strongest practical, and
recommended).
Passwords
456
Mixture of numbers, letters, capital letters and special characters longer than 8
characters (Chic@goCu&s@1908) = strongest.
Siemens Industry, Inc.
The Insight server is connected directly to the internet (weak security not
recommended).
The insight server is connected to the internet but the connection is controlled
and exclusively used for remote support (will be turned OFF or timed) (stronger
security).
The insight server and its BLN is not connected to the Internet (strongest
security).
Because Siemens Building Technologies personnel are the experts with our systems, we know the
problems and benefits better than most of our customers. It is our responsibility to use that
knowledge to protect our customers equipment and operations from cyber attacks. In the role of a
subject matter expert, field personnel are in the position to advise customers in regard to the cyber
security aspects of the Siemens BAS (Building Automation System). A recommendation based on the
customers application should be made and a decision regarding the adoption of this
recommendation should clearly be documented for future reference.
Remember, if a customers information is compromised by the use of the Siemens building control
system the damage to the customer and our reputation, as well as financial loss, can be immense.
15
Information in this section is taken from the white paper titled APOGEE Network Security, Rev.1, July 2004, which is posted on
InfoLink (http://iknow.us009.siemens.net/infolink/InfoLink.aspx?page=/infolink/Default.htm). This section just highlights the main
security features of APOGEE BAS networks, as discussed in detail in this publication.
457
The Management Level Network (MLN) level user accounts and passwords are not
contained in the Insight database, and the BLN level passwords are encrypted.
Communications to the database is over a proprietary protocol through a single
TCP/IP port. For an attacker to do anything more than corrupt or delete the
database would require in-depth knowledge of the databases proprietary structure.
To protect against data loss, the Insight Backup Utility allows authorized personnel
to schedule regular Insight backups. To further secure the backup, the Backup Utility
allows authorized personnel to direct the backup to be stored on another computer
on the enterprise network.
With the Insight Life Safety option, only UL Listed Insight Fire Workstations are permitted to
control the Fire Alarm System. These workstations are installed on a dedicated IP subnet and
broadcast domain isolated from the enterprise network. The communication protocol for the
fire panels is proprietary and does not support transfers of executable files such as those that
can contain viruses.
The RENO option allows the customer to configure an Insight workstation to send
email, phone, pager, and simple message service (SMS) notifications about Insight
alarms, failures and events. RENO does not allow personnel to make changes to the
Insight database other than stopping alarm notifications. A RENO user must enter a
valid Insight user ID and password to gain access to the system. The password is
encrypted and stored in the Insight database.
The Insight OPC Server option enables your OPC (OLE for Process Control) applications to
access your Insight database, using Microsoft DCOM security. DCOM provides security for
program access, program launch, user identity and connection policies.
16
The AEM Ethernet port and the APOGEE Ethernet field panel port are in
constant use by the Insight workstation. Should an attacker disable that port, a
message box in the System Profile application would announce the BLN failure.
The AEM is physically located in the field panel enclosure requiring key access.
APOGEE Ethernet field panels and the AEM200 allow users to access the MMI
using Telnet 16, but a valid user name and password is required.
Telnet is a network protocol used on the Internet or local area network to provide bidirectional interactive text-oriented
communication capability using a virtual terminal connection.
459
An open MMI session will automatically close after a timeout period if there is no activity
from the connected terminal. This decreases the window of opportunity for an
unauthorized user to take over an unattended terminal or, if Telnet, connect from
another computer into a field panel with an open session.
Since only one Telnet session can be open at a time this prevents an attacker
from opening a session while a legitimate user is in a session.
The Telnet feature for MMI sessions can be enabled or disabled individually per
APOGEE Ethernet field panel. To enable Telnet requires that the user have
privileges to use the Insight workstation. The APOGEE Ethernet field panel
preserves the Telnet enable /disable state even if it should cold boot.
Modems allow phone line communication between field panels and Insight
workstation or access to the field panel MMI. Modems include the following security
features:
The Modem port is limited to the Insight Autodial application or MMI dial-in,
and the MMI port is limited to dial-in MMI only; a valid user name and password
is required.
An open MMI session will automatically close after a timeout period if there is
no activity from the connected terminal. This decreases the window of
opportunity for an unauthorized user to take over an unattended remote
terminal.
460
Prohibiting the use of modems, except for Auto-Dial and RENO modems.
Prohibiting the use of the APOGEE Automation server for applications other
than the Building Automation System (i.e. word processing, emailing, etc.)
Run virus scanner and keep your virus scanner software up-to-date. The Insight
software will coexist with any reputable anti-virus software. To preserve the
performance of the Insight software, which is constantly accessing its database,
Siemens Building Technologies recommends scanning a copy or backup of the
database rather than the active database. Most anti-virus software can be setup to
exclude certain directories, such as the database directory.
Back up your system regularly especially critical data files. This allows you to
quickly recover any data damaged by viruses or other malicious programs.
Always keep your computers up-to-date with the latest operating system security
patches and service packs. If a technician is not available to regularly install security
patches and service packs, configure Windows Update service to automatically
download and install the latest Microsoft updates.
Use firewalls to protect your APOGEE Automation network. Hardware or software
firewalls protect your network by limiting access to your network. Also, use personal
TM
Always consider putting a critical sub-system on a Virtual Local Area (VLAN). Multiple
VLANs can be implemented on the same physical LAN. Thus, an APOGEE Automation
System on its own VLAN can be isolated from the rest of the network.
461
Does the responsible IT department have a cyber security standard and can that
be applied to the BAS and is that compliant with ISA 62443.03.03?
No The customer shall be advised on how they can adopt a standard
policy or how their policy can be hardened to be compliant with ISA
62443.03.03 Level 2.
Yes Their policy can be adopted for the BAS
Is the network hardware access limited to authorized personal (lock and Key) or
is easily accessible?
No The customer shall be advised on how to secure the network
hardware against tempering by putting them into secure locations or by
mounting them in a lockable enclosure.
Yes The access should be managed carefully to allow access when
needed.
Is the Insight server in a server room with access limited to authorized personal
only?
No It is recommended to keep access to the server limited. The customer
should be advised on lockable server enclosures, disabling of USB and other
ports for memory devices to prevent the introduction of malware.
Yes The access should be managed carefully to allow access when
needed.
Does the BAS need to send data across a public or corporate network (i.e. for
energy monitoring)
No No immediate action required but the requirement needs to be
monitored.
Yes Data should not be send across a public or corporate network without
protection. For a corporate network we recommend at minimum the setup
of a VLAN for the BAS to send data.
For sending information across a public network a secure and managed
VPN access system is recommended.
Does the BAS need to be accessed through a public network (remote access,
remote monitoring)?
No No immediate action required but the requirement needs to be
monitored.
Yes Access shall be provided via a managed VPN system. If possible the
connection should be turned off at the BAS side and only turned ON if the
connection is required for the amount of time required.
462
Has the collected historical trend data any value (FDA, Quality Assurance,
etc.).
Is the network connected to computers or servers that hold private
information?
Is there potential damage if the BAS is not operated within defined
parameters (i.e. high air pressure for a clean room, specific temperature
and humidity for a laboratory, etc.).
Is there any reason why data for the BAS needs to be transferred to and from a
memory device (i.e. USB stick)?
No all memory device ports on the insight server and clients should be
disabled to prevent introduction of malware.
Yes The memory device must be closely monitored.
Purchase a device specifically for this purpose
Label the device clearly for identification purposes
Secure all data on it via an encryption/Vault program
Format the device after every use and frequent
Run frequent virus checks on it to ensure it is clean.
Store the device security on the premises and do not allow it to be used for
any other purpose.
Is the BAS connected to a network that can connect to a server with Intellectual
Property [IP] information or personal information on it?
No: No immediate action required but the requirement needs to be
monitored.
Yes: Any BAS network activity should be run on a secure VLAN. The BAS
should not be connected to a server system with IP on it without strong
security measures. Using a VLAN to separate the network traffic has to be
an absolute minimum.
463
Glossary
This glossary describes various terms and acronyms used in this application guide.
For a comprehensive listing of building control terminology, see the Technical
Glossary of Building Controls Terminology and Acronyms (125-2185).
ASHRAE
American Society of Heating, Refrigerating and Air-Conditioning Engineers. An HVAC
industry organization for advancing the arts and sciences of heating, refrigeration,
air conditioning, and ventilation for the benefit of the public.
ALN
Automation Level Network. An RS-485 network for use by the APOGEE building level
controllers.
Communication trunk connecting Insight computers and field panels in a building control system.
You must have a ALN Account in order to access and perform operations at a field panel on a
specific ALN.
ANSI
American National Standards Institute.
ARCNET
Attached Resource Computer Network. Type of LAN that works like a token-ring
network, except that the connections between computers do not need to be in the
shape of a ring. ARCNET networks usually use Ethernet hardware.
B-BC
See BACnet Building Controller Profile.
B-OWS
See BACnet Operator Workstation Profile.
465
Glossary
BACnet
Data communication protocol for Building Automation and Control networks, based
on specifications detailed in ANSI/ASHRAE Standard 135. The first version of this
standard was published in 1995 as ANSI/ASHRAE Standard 135-1995. The latest
published version of this standard (published in 2012) is ANSI/ASHRAE Standard 1352012. BACnet allows devices from multiple manufacturers to communicate and work
together.
BACnet Device
A BACnet device is a microprocessor-based unit that uses the BACnet protocol for
interoperable communication.
BACnet Device ID
A number, between 0 and 222, assigned to a BACnet device by the person configuring
a BACnet network. This number must be unique per job (internetwork). Also called
Device Instance Number.
BACnet Internetwork
Two or more BACnet networks interconnected by routers.
The job (the whole BACnet network on a job). This includes all BACnet segments
regardless of media or protocol or networking technology (ARCNET, MS/TP, etc.).
466
Glossary
BACnet Router
A device that interconnects two or more BACnet networks to form a BACnet
internetwork. BACnet routers make use of BACnet network layer protocol messages
to maintain their routing tables. A router may, or may not, provide BACnet
application layer functionality.
BACnet Object
In a BACnet system a BACnet Object is a collection of information within a device
described by its properties. An object might represent information about a physical
input or output, or it may represent a logical grouping of points that perform some
function, such as a setpoint. Every object has an identifier (such as AI-1) that allows
the BACnet system to identify it. An object is similar to a data point, although it
contains additional information other than present value. It is only through its
properties that an object is monitored and controlled.
BACnet Network
A BACnet network is a set of devices that can communicate using the BACnet protocol.
467
Glossary
BBMD
See BACnet/IP Broadcast Management Device.
BIBB
See BACnet Interoperability Building Block.
BTL
See BACnet Testing Laboratories.
change-of-value (COV)
Method of sampling (trending) point values at a field panel. A COV is recorded when
the change in a point value is greater than the user-defined COV limit (analog points)
or when there is a change of state for a digital point.
Cloaking
A process which removes BACnet devices from ALNs in System Profile and prevents the Insight device discovery
process from re-adding the devices. In Insight, accessed through a check box in the BACnet Field Panel Definition
dialog box.
Datagram
A term used to describe data that is put into packets for network transport.
Device ID.
468
Glossary
Default method of name resolution for Windows 2000. The domain naming service
(DNS) allows computers on a domain to determine the Computer Name assigned to
an IP address or the IP address assigned to a computer name. Windows 2000 uses
Dynamic DNS where the name table for the domain is automatically updated as
computers join the network or become unavailable.
EPICS
See Electronic Protocol Implementation Conformance Statement.
Ethernet
Type of protocol developed by the IEEE (802.3) that maps to the Physical layer in
local area networks.
A combination wiring and signaling standard for networking. The IEEE standard
802.3 that defines the functions of the Logical Link Control sub-layer of the Data Link
layer in the OSI model. Also defined are the network operations of the Physical and
Data Link layers. Ethernet is the most popular form of local area network.
A high-speed LAN which runs on a variety of media-STP, coaxial cable, or fiber optics.
Foreign Device
See BACnet Foreign Device.
Group Object
The Group object type defines a standardized object whose properties represent a
collection of other objects and one or more of their properties. A group object is
used to simplify the exchange of information between BACnet Devices by providing
a shorthand way to specify all members of the group at once. A group may be
formed using any combination of object types
469
Glossary
Half-Router
In BACnet, a device that can participate as one partner in a point-to-point (PTP)
connection. Two half-routers form an active PTP connection and act as a single
router.
Instance Number
In BACnet, a number that uniquely identifies an object within a device or a device on
an internetwork. Device Objects are required to have an Instance Number that is
unique internetwork-wide. Instance numbers may range from 0 to 4194303. For
devices, see BACnet Device ID.
Internetwork
See BACnet Internetwork.
IP Address
Address that is assigned to every computer and all Ethernet ALN and BACnet
controllers. An IP address uniquely identifies a node on the network.
The 32-bit address used to identify a computer on a network using the IP protocol. A
4-octet number like 128.253.245.74. An IP address is separated into the network
address portion and the host portion.
470
Glossary
IPsec
(IP security)
(Internet Protocol security)
A standard for securing Internet Protocol communications by encrypting and/or
authenticating all IP packets. IPsec provides security at the network layer.
LonTalk
Echelon Corporations LAN technology. It is a specification for the Physical and Data
Link layers of their protocol architecture.
MS/TP
MS/TP (Master-Slave/Token-Passing) is an Electronics Industry Alliance (EIA)
standard for multipoint communicationscontrary to just point-to-point
communications like RS-232. MS/TP is also known as RS-485 or EIA-485.
"Native" BACnet
A phase that implies that whatever is being described only speaks and understands
BACnet.
471
Glossary
Network
Collection of Insight workstations, field panels, printers, and equipment controllers
that are electronically and physically connected to communicate with each other for
sharing building control data.
ONVIF
(Wikipedia definition): The Open Network Video Interface Forum (ONVIF) is a global and open
industry forum with the goal to facilitate the development and use of a global open standard for the
interface of physical IP-based security products. Or in other words, to create a standard for how IP
products within video surveillance and other physical security areas can communicate with each
other. ONVIF is an organization started in 2008 by Axis Communications, Bosch Security Systems
and Sony.
OPC
Open Platform Communications. OPC is a standard for industrial communications
that enables universal connectivity and interoperability. OPC technology is based on
Client/Server architecture and provides standards-based communication that allows
users to employ a "best of breed" solution for their projects. In essence, OPC is the
Modbus of the new century.
Point-to-Point (PTP)
Point-to-Point Protocol a protocol provided by an Internet Service Provider (ISP)
for connection to the Internet via a dial-up connection. PTP is faster, more reliable
and supports more functions than the comparable SLIP protocol. PTP also applies to
RS-232 (EIA-232) connections
Properties
The means by which objects are monitored and controlled. BACnet specifies 123
properties of objects. Three properties-Object-identifier, Object-name, and Objecttype-must be present in every object. BACnet also requires that certain objects
support specific additional properties. The type of object and the type of device in
which that object resides determine which properties are present. Some properties
can accept writes, and others can only be read.
472
Glossary
Router
Device used to connect networks using different architectures and protocols.
Routers determine the best path for sending data, and filter broadcast traffic to the
local segment.
A device that connects two LANs. Routers are similar to bridges, but provide
additional functions, such as message filtering and forwarding based on various
criteria. A router is a physical device that is used to pass messages on the network
level (network layer of the OSI model).
PXC Compact
The PXC Compact is a series of high-performance, Direct Digital Control (DDC),
programmable controllers. The controllers operate stand-alone or networked to
perform complex control, monitoring, and energy management functions without
relying on a higher-level processor. The Compact series communicates with an
Insight workstation and other APOGEE and pre-APOGEE field panels on a peer-topeer Automation Level Network (ALN).
PXC Modular
The PXC Modular is the newest ALN controller offering for the APOGEE Automation
System and is a global hardware platform. It has installation flexibility, a capability
for large point counts, and supports FLN devices. The Modular series communicates
with an Insight workstation and other APOGEE and pre-APOGEE field panels on a
peer-to-peer Automation Level Network (ALN), and with TX-I/O modules directly
through the TX-I/O self-forming bus.
473
Glossary
Services
How one BACnet device gets information from another device, commands a device
to perform certain actions (through its objects and properties, of course), or lets
other devices know that something has happened. The only service that is required
to be supported by all devices is the Read-property service. There are a total of 32
standard services.
SMTP
(Wikipedia definition): Simple Mail Transfer Protocol (SMTP) is an Internet standard for electronic
mail (e-mail) transmission across Internet Protocol (IP) networks. SMTP was first defined by RFC
821 (1982, eventually declared STD 10), and last updated by RFC 5321 (2008) which includes the
Extended SMTP (ESMTP) additions, and is the protocol in widespread use today.
SNMP
Simple Network Management Protocol. SNMP is an application layer protocol that
facilitates the exchange of management information between network devices. It is
part of the Transmission Control Protocol/Internet Protocol (TCP/IP) suite. SNMP
enables network administrators to manage network performance, find and solve
network problems, and plan for network growth.
Subnet
See Network.
Target
Target Reference
In BACnet scheduling, the BACnet Object Property Reference. That which is written
to by the BACnet schedule.
474
Glossary
TCP/IP
Transmission Control Protocol/Internet Protocol. TCP/IP is the de facto protocol
standard used by the Internet. Whereas IP deals only with packet transmission, TCP
enables two hosts to establish a connection and exchange streams of data. TCP
handles delivery and order of data streams.
UTC
(Wikipedia definition): Coordinated Universal Time (UTC) is the primary time
standard by which the world regulates clocks and time. It is one of several closely
related successors to Greenwich Mean Time (GMT).
Virtual network
The representation of P2 ALN devices and points as BACnet objects to the rest of the
BACnet internetwork. This is achieved by the Insight BACnet Server. Virtual network
is a BACstac term.
475
Index
Index
Add COV and Add Interval Definition Dialog
Boxes, 265
Additional Notification Classes and
Recipient Lists, 347
Advanced Settings Dialog Box, 252
Advantages for products residing on BACnet
MS/TP ALN, 108
Advantages for Products Residing on
BACnet MS/TP FLN, 113
Alarm Acknowledgements, 72, 328
Alarm Acks, 212
Alarm and Event Applications, 175
Alarm and Event Management, 58, 67
Alarm Enable/Disable, 327
Alarm Message Definition, 356
Alarm Messages, 214, 330, 339, 344
Alarm Notification Classes, 339
Alarm Notification Classes and Messages,
343
Alarm Priority, 214, 329
Alarm Priority Colors, 339, 348
Alarms, 212
Alarms, 175
Analog Input Object, 32
Analog Output Object, 33
Analog Value Object, 35
APOGEE BACnet Field Panel, 149
Using BACnet Calendar Days, 305
APOGEE BACnet Field Panel
Interoperability, 64
APOGEE GO, 214, 331
APOGEE Trending: Non-BACnet vs. BACnet,
362
Application Initial Values, 243
Application Initial Values Dialog Box, 264
Application Summary, 183
Attribute Duplicator, 215
476
Index
Index
Index
Operation, 27
Organization of Guide, II
Other Objects Supported by APOGEE
BACnet Field Panels, 43
Other System Profile BACnet Features, 229
Panel Configuration Report, 236
Panel Definition, 250
Panel Display Report, 237
Panel Point Definition Report, 237
Panel Trend Data Detail Report, 237
Panel Trend Definition Report, 238
Physical Network Configurations, 123
Point Alarm Setup, 340
Point Checkout Data, 393
Point Command Priority, 184
Point Commanding, 67, 71
Point Definition Report, 238
Point Details, 233
Point Editor, 233
Point Editor Event Enrollment, 331
Point Names, 70
Point Objects, 330
Point Priority, 212
Point Summary Report, 393
Point Transfer, 392
Point-Like Objects, 31, 70, 167
PPCL, 66, 177
Program Editor, 236
Progress Tab, 223
Properties of Objects, 20
Proprietary Applications, 68
Protocol Implementation and Conformance
Statement, 53
Pulse Accumulator, 173
Purpose of this Guide, II
PXC Compact, 232
PXC Compact Slope/Intercept, 235
PXC Compact Support, 232
Recipient List, 339, 378
Reference Materials, III
Releasing, 169
479
Index
481
www.sbt.siemens.com