BACnet Controller Integration with NAE/NCE/ODS Technical Bulletin

BACnet Controller Integration with NAE/NCE/ODS Technical Bulletin
BACnet® Controller Integration with NAE/NCE/ODS Technical
Bulletin
Code No. LIT-1201531
Software Release 8.1
Issued February 2017
Refer to the QuickLIT website for the most up-to-date version of this document.
Introduction................................................................................................................................3
Summary of Changes................................................................................................................3
BACnet Controller Integration with NAE/NCE/ODS Overview...............................................3
BACnet Integration.............................................................................................................................3
BACnet Integration Object/Field Bus Integration Object................................................................5
Focus View............................................................................................................................................5
Diagnostics View...................................................................................................................................5
Engineering View..................................................................................................................................5
Summary View......................................................................................................................................6
Hardware View (Field Bus integration only)..........................................................................................6
BACnet Integration and Field Bus Integration Auto Discovery Filtering......................................6
BACnet Integration Auto Discovery Filters............................................................................................7
Field Bus Integration Auto Discovery Filters.........................................................................................8
BACnet Object Support......................................................................................................................8
Unique Device Object Identifiers...........................................................................................................9
Items in the Navigation Tree on the Metasys UI.............................................................................10
Commands..........................................................................................................................................11
Alarming..............................................................................................................................................14
Performance Considerations for Third-Party BACnet Devices....................................................14
Exposing NAE Data to M-Series Workstations..............................................................................15
Supported NAE Objects...................................................................................................................16
Exposing NAE Data as Standard BACnet Objects to Other BACnet Devices............................16
Poll Rate of Third-Party BACnet Devices.......................................................................................16
Configuring the NAE as a BACnet IP to MS/TP Router.................................................................16
Auto-Created States Text.................................................................................................................17
BACnet Integration Object — Detailed Procedures..............................................................20
Connecting to BACnet Devices.......................................................................................................20
Exposing BACnet Information.........................................................................................................20
Adding a BACnet Integration Object...............................................................................................21
Mapping BACnet IP Devices Using Auto Discovery......................................................................23
Manually Mapping BACnet IP Devices............................................................................................25
Mapping BACnet Field Points Using Auto Discovery...................................................................26
Mapping BACnet Field Points Manually.........................................................................................30
Using the Relearn Feature...............................................................................................................32
Using the Engineering View to View and Edit Device Attributes (BACnet Properties)..............32
Field Bus Integration Object — Detailed Procedures...........................................................35
Adding BACnet MS/TP (Field Bus) Integrations............................................................................35
Manually Adding BACnet MS/TP (Field Bus) Field Devices (Online or Offline)..........................36
Adding BACnet MS/TP Field Devices Online Using Auto Discovery...........................................39
Adding BACnet Devices to the BACnet and MSTP Integrations Using the Import Integration
Wizard................................................................................................................................................40
Adding Extensions to an Object......................................................................................................41
Adding a Trend Extension...................................................................................................................43
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
1
Adding a Totalization Extension..........................................................................................................44
Adding an Alarm Extension.................................................................................................................45
Adding a Load Extension....................................................................................................................46
Adding an Averaging Extension..........................................................................................................47
Deleting Extensions from an Object...............................................................................................47
Copying Extensions to a Field Device or Field Point (Offline Only)............................................48
Enabling the Routing Mode..............................................................................................................49
BACnet Routing Considerations............................................................................................49
Related Documentation...........................................................................................................50
Troubleshooting.......................................................................................................................51
BACnet System Integration Troubleshooting Guide ....................................................................51
Technical Bulletin
2
Introduction
This document describes how BACnet® controllers, both those from Johnson Controls and third-party suppliers, are
integrated through a Network Automation Engine (NAE) or Network Control Engine (NCE) in a Metasys® system
network. This capability provides two major functions:
•
•
First, as a BACnet workstation, the NAE/NCE allows the objects within BACnet controllers to integrate with the
Site Management Portal and the Ready Access Portal.
Second, as a BACnet building controller, the NAE/NCE provides supervisory control and monitoring functions
for objects integrated from connected BACnet controllers. BACnet controllers can integrate with an NAE/NCE
using either BACnet IP or Master-Slave/Token-Passing (MS/TP) communications.
This document also includes integration information about the Metasys Open Data Server (ODS), a BACnet Testing
Laboratories™ (BTL) Listed BACnet® Operator Workstation (OWS) that conforms to the B-OWS profile. You can
configure the ODS as either a BACnet Workstation, Site Manager Workstation, or a combination of both. The
workstation uses a Microsoft® operating system and SQL Server® database software to manage the collection and
presentation of large amounts of trend data, event messages, operator transactions, and system configuration data.
For details, refer to the ODS Commissioning Guide (LIT-12011944).
The functions provided by the NAE/NCE for BACnet controllers are similar to those provided to integrated N2 and
LonTalk® controllers. The major difference is that the NAE/NCE behaves as a BACnet gateway to the non-BACnet
controllers, converting their data into BACnet objects that reside within the NAE/NCE. For integrated BACnet
controllers, the NAE/NCE provides BACnet mapper objects, which supplement the standard BACnet object data of
the integrated controllers with additional attributes needed to perform the workstation and building controller functions
within the Metasys system. This document describes those additional attributes.
Note: The term NAE is used throughout this document to refer to both NAEs and NCEs, unless noted otherwise.
Summary of Changes
The following information is new or revised:
•
BACnet Object Support - Added new objects.
•
Commands - Updated the commands table and added additional commands.
Updated user interface screens and user selections for the new release.
•
BACnet Controller Integration with NAE/NCE/ODS Overview
As a BACnet integrator, the NAE monitors and supervises a network of BACnet devices and acts as a BACnet
operator workstation for all integrated controllers. The Site Management Portal UI of the NAE presents the data to
the operator using a web browser. Other BACnet devices on the network can read from and write to the BACnet
objects within the NAE, which acts as a BACnet building controller.
As a BACnet integrator, the ODS monitors and supervises a network of BACnet devices and acts as a BACnet
operator workstation for all integrated controllers. The Site Management Portal UI of the ODS presents the data to
the operator using a web browser.
BACnet Integration
The BACnet Integration feature manages the integration of BACnet enabled devices into the Metasys system. Figure
1 shows an example of this type of configuration. As shown, third-party BACnet devices can reside on the IP Network
and on the MS/TP Field Bus.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
3
Figure 1: BACnet System Integration Configuration Example
Two software objects in the NAE/NCE enable integration to BACnet controllers:
•
•
The BACnet Integration object supports the connection of BACnet IP devices.
The Field Bus Integration object supports the connection of BACnet MS/TP devices.
The NAE, with the Site Management Portal as its UI, serves as a BACnet workstation on which to view and command
standard BACnet objects in BACnet devices. The NAE maps the BACnet system data to create integrated objects
to use in Metasys system applications, and to use in features such as interlocking and demand limit/load rolling.
BACnet Integration for all NAEs on the Site is enabled in the Site object. Using the BACnet Integration and Field
Bus Integration objects in an NAE, you can map the desired BACnet devices and objects.
The MS/TP Field Bus includes everything needed for third-party MS/TP devices, so there is no distinction between
Field Equipment Controller (FEC) family devices, Advanced Application Field Equipment Controller (FAC) family
devices, and all other BACnet MS/TP devices. Do not use a separate BACnet Integration for MS/TP.
Notes:
•
Non-NAE BACnet devices that auto-discover the objects in an NAE, such as a third-party BACnet workstation,
identifies the mapper objects, not the actual BACnet objects in the field devices. The mapper objects have
all the same standard attribute values of the original objects of the integrated devices, except for the BACoid,
for which the mapper object has a unique number that is different from that of the original object. The Device
Objects themselves of the integrated devices do not have mapper objects. Thus, the non-NAE BACnet device
recognizes the NAE as a single device with a large collection of all the integrated standard objects that are
mapped from the integrated devices.
•
The non-NAE devices can recognize the original integrated devices and objects by enabling the BACnet IP
to MS/TP routing feature in the NAE. See the Configuring the NAE as a BACnet IP to MS/TP Router section.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
4
BACnet Integration Object/Field Bus Integration Object
Use the BACnet Integration object to configure the parameters for BACnet integration in the NAE that is monitoring
BACnet IP devices. In many instances, the BACnet Integration object is added to only one NAE in a site; however,
system flexibility allows BACnet Integration objects to be added to multiple NAEs in which the BACnet devices are
connected to the IP Network. For more information about the BACnet Integration object, including attributes and
commands, refer to the Object Help in the Metasys System Help.
Note: Be sure that each BACnet device is added to no more than one BACnet integration so that the BACnet
device is not overloaded.
Use the Field Bus Integration Object to connect BACnet MS/TP devices to an NAE. The NAE must have an available
RS-485 communication connection and the NCE must be a model MS-NCE256x-x to support this capability. The
NAE can also communicate using a remote field bus integration if the MS/TP devices are accessible through a
BACnet IP to MS/TP router. In this case, the router provides the RS-485 communication instead of the NAE.
The BACnet Integration object offers four views, while the Field Bus Integration object adds a fifth view:
•
Focus View
•
Diagnostics View
•
Engineering View
•
Summary View
•
Hardware View (Field Bus integration only)
Note: Only the focus view is available during offline configuration with the SCT.
Focus View
The focus view contains basic user data including the name of the object and the device name of the host NAE for
the BACnet integration object.
Diagnostics View
The diagnostics view displays BACnet protocol diagnostic properties for troubleshooting purposes. Users with
high-level privileges use this view.
Note: This view is not available during offline configuration with the SCT.
Engineering View
The engineering view of the BACnet Integration object allows scanning the entire IP network to discover and view
data in BACnet devices that are connected on the network, whereas the Field Bus object’s engineering view shows
the devices connected to the attached MS/TP bus. Advanced users (with the appropriate access authority) use this
view to see and change data in BACnet devices directly, whether or not the objects have been integrated to the
NAE. A user can then view and command many more BACnet devices than just those that have been integrated
and are visible in the Site Management Portal All Items navigation tree.
The engineering view contains the Integration Tree and Integration View panels. The Integration Tree panel contains
a list of known BACnet devices and their objects that are connected to the NAE. The Integration View panel displays
the details about the BACnet device or objects selected in the Integration Tree.
After you create a new BACnet Integration object or Field Bus Integration object, the Integration Tree is empty until
you add the BACnet devices either manually or by using auto discovery.
Note: This view is not available for offline configuration with the SCT.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
5
Summary View
The Summary view shows a list of all mapped devices and the current values of key data about each device.
Note: This view is not available for offline configuration with the SCT.
Hardware View (Field Bus integration only)
The hardware view shows that the NAE’s trunk number is used for the MS/TP bus, the selected baud rate, and the
BACnet network number for the trunk.
BACnet Integration and Field Bus Integration Auto Discovery Filtering
When you map BACnet IP devices or Field Bus integration devices using auto discovery, the list of devices may
become so long that it is difficult to find a device in the list. You can use a number of attributes in the Advanced
Focus view to filter your view and make the list more manageable. You can configure this filtering using a collection
of attributes located on the Advanced Focus view of the BACnet integration object or Field Bus Integration object.
When devices are discovered, the discovery list displays the devices previously mapped by default. Additional
devices are then added as they are discovered.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
6
BACnet Integration Auto Discovery Filters
•
•
Device Discovery Range – This attribute is a list of filters arranged so that a device that matches any of the list
entries displays in the Auto Discovery list. The default attribute value is no entries, which allows all reachable
devices to be discovered. Each list entry has the following parts:
- Broadcast Type – This entry filters the scope of the device discovery process at a BACnet network level.
This entry has three options:
• Local – Discovers devices only on the local BACnet IP network (network number zero [0] is defined by
BACnet as the local network).
• Remote – Discovers devices only on a particular BACnet network that must be specified.
• Global – Discovers devices on all BACnet networks that are reachable (network number 65535 is defined
by BACnet as the global broadcast network number).
- Network Number – The network number can only be entered when the Broadcast Type is set to Remote.
Enter the network number where Auto Discovery is performed.
- Device Instance Low Limit – Each BACnet device is required to have a unique instance number at a site.
The Device Instance Low Limit value specifies the lowest device instance number discovered on a network.
The range for this value is 1 to 4194302. A device with an instance number zero is not discovered when
using this filter.
- Device Instance High Limit – The Device Instance High Limit value specifies the highest device instance
number discovered on a network. The range for this value is 2 to 4194302 and must be at least one number
greater than the Device Instance Low Limit. A device cannot have an instance number higher than the range
limit.
Preserve Discovered Devices – This attribute determines whether devices discovered during a previous Auto
Discovery operation are preserved during subsequent Auto Discovery operations. If the attribute is set to True,
devices previously discovered are preserved. If the attribute is set to False, then devices previously discovered
are not preserved. By default, this attribute is set to True.
Set the attribute to True to collect an inclusive list of devices by performing discovery multiple times with different
filter settings.
•
•
•
Set the attribute to False to narrow the discovery list to the current filter settings.
Discover All As General BACnet Device – This attribute determines whether Johnson Controls® devices in
the FEC/FAC or NxE families appear in the discovery list. By default, this attribute is set to False, which omits
FEC/FAC and NxE devices, since these devices are normally tied into the system through either a Field Bus
integration or through an ADX/ADS/ODS as a site device.
Change this attribute to True to eliminate this filter and allow all BACnet devices to appear in the discovery list
regardless of their type. When this attribute changes, any previous discovery information clears, and Auto
Discovery must run again.
Note: If you change the attribute after running Auto Discovery, we recommend you restart the NxE when
configuration is complete.
Requested Vendor ID – The BACnet Vendor ID is a numerical value assigned to the vendor of the device. By
default, this attribute is empty (or at zero), allowing all vendors to be discovered. If a number other than zero is
entered, only devices with a matching vendor ID display in the discovery list. BACnet maintains a list of vendor
IDs at http://www.bacnet.org/.
Page Size – This attribute filter applies only to point object discovery within a single device, and limits the number
of displayed objects to a quantity within the display capability of the Site Management Portal (SMP) UI. When
the page size reaches the limit, click Restart on the object discovery list to move to the next page. If you click
Restart on the last page of the discovery list, the object discovery runs again and produces a new page 1. The
range of point objects displayed per page is 10 to 65,535.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
7
Field Bus Integration Auto Discovery Filters
Field Bus integrations are associated with a particular BACnet network number. During Auto Discovery, only devices
connected directly to that particular BACnet network are discovered. A device is classified as either a General BACnet
Device or as an JCI Family BACnet Device. General BACnet Devices are managed using standard BACnet services
and properties. JCI Family BACnet Devices are managed using proprietary BACnet services and include proprietary
properties in order to improve performance and to display additional details about the device and its objects. Devices
that are not JCI Family devices are always managed as General BACnet Devices.
•
•
Discover All As General BACnet Device – This attribute determines whether a Johnson Controls Device in
the FEC/FAC family is classified as a JCI BACnet Device or as a General BACnet Device. By default, this attribute
is set to False, and classifies FEC/FAC family devices as JCI BACnet Devices so that performance is optimized
and proprietary properties display. When this attribute changes, any previous discovery information clears and
Auto Discovery must run again.
Note: If you change the attribute after running Auto Discovery, we recommend you restart the NxE when
configuration is complete.
Requested Vendor ID – The BACnet Vendor ID is a numerical value assigned to the vendor of the device. By
default, this attribute is empty (or at zero), allowing all vendors to be discovered. If a number other than zero is
entered, only General BACnet Devices with matching vendor IDs display in the discovery list. JCI BACnet devices
always display on the discovery list. BACnet maintains a list of vendor IDs at http://www.bacnet.org/.
BACnet Object Support
The Metasys system integrates and exposes objects as standard BACnet object types. The user configures and
enables the BACnet Integration and Field Bus Integration feature in the NAE.
The Metasys system supports a subset of standard BACnet object types, but does not support integration of any
proprietary object types in other BACnet devices. Of the supported standard BACnet objects, only the required and
optional attributes are viewable for non-FEC Series controllers (referred to as General BACnet Device in this
document); proprietary attributes are not supported.
The following list of BACnet object types are both those supported in the NAE and Open Data Server (ODS) for
BACnet/Field Bus integration, and those exposed as BACnet objects to third-party BACnet devices that discover
the NAE. Refer to the Object Dictionary in online Help or the Network Engine Protocol Implementation Conformance
Statement Technical Bulletin (LIT-1201532) for further details on objects supported.
•
•
•
•
•
Accumulator
Analog Input (AI)
Analog Output (AO)
Analog Value (AV)
Averaging
•
•
•
•
•
•
•
•
Note: Averaging objects created in the NAE appear as extensions to the object that the average is associated
with. When exposed to a third-party BACnet device, the extension appears as its own BACnet Averaging
object.
Binary Input (BI)
Binary Output (BO)
Binary Value (BV)
Bitstring Value (ODS only)
Calendar
Character String Value
Command
Date Pattern Value (ODS only)
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
8
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Date Time Pattern Value (ODS only)
Date Time Value (ODS only)
Date Value (ODS only)
Device (only the NAE device object is exposed by the NAE)
Event Enrollment
Electric Demand Control
Electric Demand Monitoring
File
Generator Load Control
Group
Integer Value
Large Analog Value
Life Safety Point
Life Safety Zone
Load Control
Loop
Multistate Input (MI)
Multistate Output (MO)
Multistate Value (MV)
Notification Class (Notification)
Octet String Value (ODS only)
Positive Integer Value
•
•
•
•
•
Program (the Metasys Control System object qualifies as a BACnet Program object)
Pulse Converter
Schedule
Time Pattern Value (ODS only)
Time Value (ODS only)
Trend
•
Note: Trend objects created in the NAE appear as extensions to the object that the trend is associated with.
When exposed to a third-party BACnet device, the extension appears as its own BACnet Trend object.
Trend Log Multiple
In the NAE, all field points, including those on the N2 Bus, LONWORKS® trunk, and FEC/FAC Series devices on the
MS/TP Field Bus, are exposed as the corresponding BACnet object type (AI, AO, BI, BO, MSI, and MSO) to third-party
BACnet devices. However, the MS/TP devices and their objects are not exposed unless routing is enabled. For a
third-party BACnet workstation to read these objects from the NAE, you must enable the expose capability. This
requirement is true for all General BACnet Device controllers connected either through a local MS/TP Field Bus or
a remote field bus connection (IP).
See Enabling the Routing Mode.
Unique Device Object Identifiers
Each BACnet device object at a site must have a unique instance number and name. The BACnet device object
instance number and name are assigned in the field as part of the installation configuration. When assigning instance
numbers and names to device objects at a site, we recommend maintaining a list of devices and their assigned
BACnet device object unique instance numbers and names.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
9
Items in the Navigation Tree on the Metasys UI
When an object appears in the Navigation tree, it is called an integrated (mapped) BACnet object. The integrated
BACnet object has a new BACnet ID that is different from the ID of the object being mapped.
BACnet objects that appear in the Navigation tree on the Site Management Portal UI can be used as object references
to other objects on the Metasys site (for example, scheduling, trend study, and DL/LR), allowing the integrated object
to be referenced as any other Metasys system object.
Adding devices to the BACnet Integration object does not automatically add them to the Navigation tree. The following
rules apply when adding BACnet device objects and BACnet objects to the Navigation tree.
Add the:
•
•
BACnet IP device under the BACnet Integration object, or BACnet MS/TP device under the Field Bus Integration
object
folder (container) objects under the BACnet device to group BACnet objects within a BACnet device
Note: Adding folder objects is optional. For the easiest reference, put more important information points in the root
directory and other information points into folders.
•
BACnet objects directly under a BACnet device, or in folders under a BACnet device
When you select an integrated BACnet object from the navigation tree, the Focus view displays the BACnet properties
in an available panel of the UI.
While most of the properties are directly inherited from the actual BACnet object in the integrated device, the mapped
object in the NAE may have additional or different properties.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
10
Commands
Only those Metasys system commands that can be implemented by a standard BACnet service are supported on
an integrated BACnet object. Some BACnet objects support commands that are handled by writing to the remote
BACnet object’s properties.
The following table lists the commands that are available for each of the BACnet object types that are supported in
the NAE for BACnet/Field Bus integration.
Accumulator
Analog
Input (AI)
Analog
Output
(AO)
X
X
X
Analog
X
Value(AV)
BACnet
X
Character
String
Value
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
BACnet
EDC
X
X
BACnet
EDM
X
X
BACnet
GLC
X
X
BACnet
Integer
Value
X
X
X
X
X
X
BACnet
Positive
Integer
Value
X
X
X
X
X
X
Binary
Input (BI)
X
Binary
Output
(BO)
X
X
Binary
Value
(BV)
X
X
BitString X
1
Value
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
Shed
Rediscover Text
Strings
Restore Controller
States Text
Program Changes
Clear and Execute
Add Recipient and
Remove Recipient
Enable and Disable
Alarms
Preset Value
Route
Release All
Release
State N, or Set State
Adjust
Sync Field Device
Times
Reset Field Device
In and Out of Service
Temp Out of Service
Override/Override
Release
Temp Override
Command Name
Table 1: Command Name Table
11
Shed
Restore Controller States
Text
Program Changes
Rediscover Text Strings
Clear and Execute
Add Recipient and Remove
Recipient
Preset Value
Enable and Disable Alarms
Route
Release All
Release
State N, or Set State
Adjust
Reset Field Device
Sync Field Device Times
In and Out of Service
Temp Out of Service
Temp Override
Override/Override Release
Command Name
Table 1: Command Name Table
Calendar
Command
Date
Pattern
1
Value
X
X
X
X
X
X
X
Date Time X
Pattern
1
Value
X
X
X
X
Date Time X
1
Value
X
X
X
X
Date
1
Value
X
X
X
X
X
Device
X
X
X
Event
Enrollment
(EEO)
Group
Large
Analog
Value
X
X
X
X
X
X
Life
Safety
Point
(LSP)
X
X
Life
Safety
Zone
(LSZ)
X
X
Load
Control
X
Loop
X
Multi
-State
Input
(MSI)
Multi
-State
Output
(MSO)
X
X
X
X
X
X
X
X
X
X
X
X
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
X
X
X
X
12
Shed
X
X
X
X
X
X
X
Pulse
Converter
X
Schedule
X
X
Time
Pattern
1
Value
X
X
X
X
X
Time
1
Value
X
X
X
X
X
X
Trend
Log
Multiple
1
Restore Controller States
Text
Program Changes
X
Program
Trend
Rediscover Text Strings
Clear and Execute
X
Notification
Class
(NCO)
Octet
String
1
Value
Add Recipient and Remove
Recipient
X
Preset Value
Release All
X
Enable and Disable Alarms
Release
X
Route
State N, or Set State
Adjust
Reset Field Device
Sync Field Device Times
X
In and Out of Service
X
Temp Out of Service
Temp Override
Multi
-State
Value
(MSV)
Override/Override Release
Command Name
Table 1: Command Name Table
X
X
X
X
Applicable to ODS only.
Operation for most of these commands can be found in Metasys SMP Help (LIT-1201793). The following command
operations are unique to the BACnet integration:
•
•
Restore Controller States Text: For objects supporting the States Text attribute, if the User Selected States
Text attribute is true, the object's States Text is no longer synchronized with the States Text, Action Text,
Active/Inactive, or Shed Level Description property. Use the Restore Controller States Text to set User Selected
States Text to false. The field point's States Text attribute is then updated to match the remote object's States
Text property.
Note: If the dictionary cannot be updated to match the field device, the States Text Error Status attribute
indicates the cause of the error.
State N: The State N Command is used by the Command object to write the Present Value attribute by selecting
a state. The first state in the drop-down box indicates No Action, and the remainder of the states indicate an
Action from the Action array. If you choose to define your own custom enumeration set for this object, be sure
to enter No Action for the first entry.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
13
•
•
•
Add Recipient and Remove Recipient for the Notification Object: Use this command to add or remove the
parent supervisory device as a notification recipient for the selected Notification object.
Adjust: For the Loop object, the Adjust command writes the Setpoint attribute.
Out of Service and Temporary Out of Service: If you want to write and make reliable Present Value, first issue
an out of service or temporary out of service command to the input object, then issue the command to Present
Value. Objects that include this functionality include Accumulator, AI, BI, MSI, Pulse Converter, and Schedule
mappers.
Alarming
The NAE accepts alarms from BACnet devices if those devices have a Notification Class object with the NAE specified
as a recipient for the alarms, and if the sources of the alarms are mapped as integrated BACnet objects.
The remote BACnet device notification class object has a destination Process ID for each recipient entry. By default,
the NAE accepts alarms for all valid Process ID values. For each NAE, you can filter alarms and accept only those
matching specific Process IDs. The NAE device object contains an attribute under the BACnet section of the Focus
tab called Process Id List. Adding Process ID values to this attribute tells the NAE to only accept alarms matching
those Process IDs values. There are two special cases that tell the NAE to accept alarms for any Process ID: if the
list is empty (which is the default) or if the list contains a Process ID of 0.
You can also configure the NAE Notification Class objects to send alarms to remote BACnet devices. The Metasys
system audit trail then records the Alarm acknowledgments from the BACnet device.
Performance Considerations for Third-Party BACnet Devices
Network performance can degrade when you add third-party devices on the same IP network or MS/TP trunk if those
devices do not meet the Required recommendations in Table 2. Actual job experience has shown as few as five
devices can create significant performance issues; although other variables can affect performance, such as the
number of objects per device. To improve network performance, we recommend that third-party devices also meet
the Highly Desired recommendations in Table 2.
Table 2: Third-Party BACnet Device Performance Recommendations
MS/TP Trunk, IP Network, and BACnet Services
Recommendation
Devices On MS/TP Trunk
MS/TP Master Device
Required
At least 38,400 bps
Highly Desired
Application Layer Protocol Data Unit
(APDU) size 480 bytes
Desired
APDU size >200
Highly Desired
Segmentation on MS/TP
Desired
Segmentation on IP devices
Highly Desired
Minimum APDU size 1024
Highly Desired
Devices On IP Network
BACnet Services
Conform at a minimum to BACnet Version Required
1 Revision 4 specification
Device supports a minimum of a B-SA
profile (or a B-SS profile with a Device
Object instance)
Required
+ Read Property Multiple, Execute
Required
+ Subscribe COV, Execute
Highly Desired
+ Write Property Multiple, Execute
Highly Desired
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
14
Exposing NAE Data to M-Series Workstations
To allow the M-Series Workstation or third-party BACnet devices to interface to NAE devices, you must follow specific
guidelines when configuring the NAE.
All NAE objects that are exposed as BACnet standard objects can be accessed from other BACnet devices and the
M3 Workstation or M5 Workstation software.
Note: The NAE must be configured to expose General BACnet Device controllers to other third-party BACnet
devices, such as a workstation. For example, for an M-Series workstation to recognize the objects in an NAE
that are mapped from a TEC controller, the NAE device object’s BACnet Integrated Objects attribute in the
NAE network tab must be set to Include in Object List.
For information on configuring the NAE, refer to the Metasys System Help.
For M-Series Workstations, configure the NAE with the following considerations. These considerations may or may
not apply to other third-party BACnet devices. Consult the documentation for the third-party BACnet device for more
information.
•
•
•
•
•
•
•
•
Use ASCII text strings for BACnet Encoding Type in the Site object.
Make the NAE Item Reference as short as possible because the NAE Item Reference is used as the basis for
building up the BACnet OLE for Process Controls tag name in the M-Series Workstations.
Enable BACnet Intrinsic Alarming or set up Event Enrollment Alarming, including BACnet event notification
(Notification Class objects), in the NAE for all NAE objects that should report event messages to M-Alarm.
Do not set up a domain name for the NAE Device Object. Setting up a domain name causes name changes for
every NAE point object, making them unavailable to the M-Series Workstation.
For the standard M-Series workstations, use only supported enumeration sets, or the data does not appear
correctly. For the list of enumeration sets, refer to the Metasys® System Enumeration Sets Technical Bulletin
(LIT-12011361).
The safest alternative is to use the States set in the NAE for the attributes that need enumerations.
The generic integration object (GIO) is not a BACnet standard object. Do not use the GIO for NAE objects
accessed by other BACnet devices or the M-Series Workstation. Use standard analog and binary NAE objects
for interfacing points from the NAE to other BACnet devices or the M-Series Workstation.
If more than one NAE device is interfaced to the M5 Workstation or M3 Workstation, and if these interfaced NAE
devices need to exchange information between each other, the NAE devices must be set up as a Metasys system
site, with one NAE defined as the Site Director.
Table 3 details the versions of the NAE that the M-Series Workstation can interface. This table does not apply to
the M3 integral and M5i workstations available in Europe.
Table 3: Supported NAE Models and Firmware Revisions
Order Codes
Product Description
Firmware Version
MS-NAE5510-x
Metasys NAE with two N2 Buses
Release 1.0 or later
Metasys NAE with two N2 Buses and one
LONWORKS® bus
Release 1.1 or later
MS-NAE5511-x
MS-NAE5520-x
MS-NAE5521-x
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
15
Supported NAE Objects
Note: The M-Series Workstation Interface to the NAE supports access to the NAE objects listed in the following
table, with the exception of the Averaging object extension.
Table 4: Supported NAE Object
NAE Object
NAE Object
Analog Value (AV)
Binary Output
Binary Value (BV)
Multistate Input
Event Enrollment (EEO)
Multistate Output
Interlock
Notification Class
Multiple Command
1
1
1
2
1
Accumulator object
Trend Log object extension
Analog Output
1
1
2
Analog Input
Binary Input
1
2
Totalization object extension
2
Averaging object extension
With N2 or LONWORKS Hardware Tab (points can be interfaced from N2 devices as well as LONWORKS devices).
Object extensions appear as a separate object within third-party BACnet devices.
Objects from the following devices are not available to the M-Series Workstation:
•
•
•
•
NIE
ADS
ADX
ODS
Exposing NAE Data as Standard BACnet Objects to Other BACnet Devices
Observe the following considerations when configuring the NAE to third-party BACnet devices:
•
•
•
For BACnet Encoding Type in the Site object, specify a text string format that is supported by the other BACnet
Devices (either ISO 10646 [UTF-8}, ISO 10646 [UCS-2], or Microsoft® double-byte character sets [DBCS] code
page 932 [Japanese Shift JIS]). For older BACnet equipment, ANSI X3.4 [ASCII] is still supported.
Enable BACnet Intrinsic Alarming or set up Event Enrollment Alarming, including BACnet Notification Class
objects, in the NAE for all NAE objects that should report event messages to other BACnet workstations.
The Generic Integration Object (GIO) is not a BACnet standard object. Do not use the GIO for NAE objects
interfaced by BACnet devices. Use standard analog and binary NAE objects instead.
Poll Rate of Third-Party BACnet Devices
The device’s poll rate governs how frequently a third-party BACnet device communicates with the NAE. Too fast a
poll rate may adversely affect the performance of the NAE. To correct communication problems over the BACnet
device or frequent NAE resets, decrease the poll rate of the third-party BACnet device at that device.
Note: The NAE supports client Change of Value (COV) subscription, which reduces the need for polling. The remote
BACnet device must be capable of executing COV subscription to take advantage of this service.
Configuring the NAE as a BACnet IP to MS/TP Router
In its default configuration, third-party BACnet IP devices can only see the integrated BACnet objects of the NAE.
If the BACnet Routing mode is set to Enabled in the NAE, then other BACnet devices on the IP network are able to
communicate directly with BACnet MS/TP devices. For example, setting the BACnet Routing mode to Enabled allows
a manufacturer’s BACnet workstation to read proprietary BACnet objects and attributes of that manufacturer’s MS/TP
devices on the NAE’s field bus. See Enabling the Routing Mode.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
16
Auto-Created States Text
In addition to the standard enumeration sets (which define the text displayed for each state of a Binary and Multistate
object) shipped with the Metasys system, Auto-Created States Text can be automatically added when a non-Johnson
Controls device or select Johnson Controls-labeled BACnet device is discovered and added to an NAE/NCE. An
Auto-Created States Text can be automatically assigned to the States Text field of a mapped object.
The BACnet State_Text property is read when an online NAE/NCE discovers BACnet objects (BI, BO, BV, MSI,
MSO, and MSV), and when a user views the object. When the value of the integrated point's States Text attribute
is updated and the user-selected states attribute is false, the Metasys system checks to see if the BACnet State_Text
property associated with the object matches a standard enumeration set used with Metasys States Text. Existing
Auto-Created States Text are also checked.
If a match occurs, the Metasys system automatically assigns the matching States Text value to the object. If no
match occurs, the Metasys system automatically creates and assigns a new enumeration set. All new sets added
at each NAE/NCE are copied to the Site Director. New States Text added have the following limitations:
•
•
•
•
•
•
1,000 new enumeration sets maximum
260 Kb memory for all sets
For any multi-value BACnet object (MSI, MSO, MSV), the number of states can be between 2 and 500, with a
maximum of 60 characters for any one state. Using the Command window, you can only manually select from
the first 32 states.
Auto-Created States Text can only be automatically assigned to one object and cannot be edited using the
Metasys system.
Auto-Created States Text is saved in the Site Director, and cached in the other devices.
The Rediscover Text Strings device level command allows you to reset the States Text across an entire Metasys
supervisory device; specifically, an NxE or ADS/ADX/ODS. It rediscovers text strings from all the mapped BACnet
objects.
Table 5: Auto-Created Enumeration Sets Usage by Metasys Product
Metasys Product
Uses Auto-Created Enumeration
Sets
Makes Changes to Auto-Created
Enumeration Sets
Ready Access Portal
Yes
Yes
Metasys Advanced Reporting System Yes
with Energy Essentials
Yes
ADS/ADX/ODS
Yes
Yes
NAE, NCE
Yes
Yes
SCT, SCT Simulation
Yes
No
CCT
No
No
Auto-Created Enumeration Sets are not translatable and do not appear in the dictionary viewer tool. They are local
to the site where they are defined.
Important: When using Auto-Created Enumeration Sets, you must upload the Site Director first, then the NAE
where you mapped the object. If you download from SCT, download the Site Director first, and then
the NAE. You must do the procedure in this order, or the enumeration set text files do not match, and
the state values are not indicated correctly.
For Binary Values, Auto-Created States Text is indicated by an asterisk at the beginning of the States Text value,
as shown in Figure 2. For Multistate Variables, Auto-Created States Text is indicated by an asterisk at the beginning
of the States Text value, as shown in Figure 3.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
17
Important: If you edit an Auto-Created States Text value to choose a standard enumeration set, you lose the option
to reselect the Auto-Created Enumeration Set. To restore the Auto-Created Enumeration Set, you can
execute the Restore Controller States Text or use the Rediscover Text Strings supervisory device level
command to reset all of the mapped objects.
Figure 2: Auto-Created Text For Binary Value
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
18
Figure 3: Auto-Created Text for Multistate Variable Objects
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
19
BACnet Integration Object — Detailed Procedures
Connecting to BACnet Devices
To connect and integrate BACnet devices into the Metasys system, connect the BACnet devices to the same IP
network as the NAE used for the BACnet system integration.
The devices must have the same BACnet Network Address and BACnet IP Port number (UDP port) as assigned to
the NAE to which the device is to be integrated. These values can be seen in the NAE Focus tab.
Exposing BACnet Information
1. Log in to the NAE or open an archive database in the SCT.
2. Right-click the Site Object and select View. The Site View screen appears.
Figure 4: Site View Screen
3. On the right side of the Site View screen, click Advanced.
4. Click Edit on the left side of the Site View screen and scroll down to the BACnet section (Figure 5).
Note: The BACnet section is visible only when the Advanced option is selected.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
20
Figure 5: BACnet Section Enabled in Site View
5. Set the BACnet Site field to True and set the BACnet Encoding Type for the encoding used by the BACnet
devices.
Note: The default BACnet Encoding Type is ISO 10646 (USC-2). Many BACnet devices, including the N30
Supervisory Controller, use ASCII for the BACnet Encoding Type. When connecting to an N30 Network,
choose ANSI X3.4 (US_ASCII) for the BACnet Encoding Type. Many devices supplied in Japan use
Microsoft DBCS code page 932 (Japanese Shift JIS). If connecting to another BACnet device, verify the
BACnet Encoding Type with the manufacturer or supplier of the device. Selection of the wrong BACnet
Encoding Type can result in unaccepted entries of text at the BACnet device, such as failed BACnet
object descriptions and alarm acknowledgments from the Metasys system UI.
Note: The UTF-8 BACnet Encoding Type is also compatible with ASCII as long as extended characters (for
example, Çä╣ß ) are not used with ASCII devices.
6. Click Save. The NAE is now enabled to work with BACnet networks.
7. See Enabling the Routing Mode.
Adding a BACnet Integration Object
The following process is applicable to online configuration in the Site Management Portal UI or offline configuration
in the SCT. These procedures assume both an online configuration and a connection between the NAE and the
same network as the BACnet system or the integrating devices.
The SCT contains no Engineering or Diagnostics views, as these are online features. In addition, to use Auto
Discovery, the system must be online and connected to a BACnet network of devices.
Note: At startup of the NAE, the BACnet Integration binds with the BACnet OID and uses the IP address from that
bind. If you move a device to a different subnet, change the IP address of the device, or change the device's
BACnet OID, you must restart the NAE to bind the BACnet OID with the new IP address.
1. On the Insert menu, select Integration. The Insert Integration Wizard, Select Object Type screen appears.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
21
Figure 6: Insert Integration Wizard (Select Object Type)
2. Select BACnet and click Next. The Destination screen appears.
Figure 7: Insert Field Device Wizard (Destination)
3. Select the NAE to which to add the BACnet Integration object. After selecting the NAE, click Next. The Identifier
screen appears.
4. Enter a unique name for the BACnet network of devices to integrate and click Next. The Configuration screen
appears.
5. In most cases, accept the default Configuration parameters. (Refer to the BACnet Integration object in Metasys
SMP Help (LIT-1201793) for a complete definition of the parameters.) Click Next to accept the defaults. The
Summary screen appears.
6. To change anything, click Back. If the Summary looks acceptable, click Finish to create the BACnet Integration
object. At this time the user can add extensions to the new object.
7. Add extensions as desired and click Done when finished. The Wizard closes.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
22
Figure 8: Ethernet IP Datalink Integration
8. After adding a BACnet Integration object, map the BACnet devices on the network to the NAE. Verify that the
network address and port for this integration match the devices you are adding to this integration. See Figure 8.
Mapping BACnet IP Devices Using Auto Discovery
1. Select the BACnet Integration object within the NAE.
2. On the Insert menu, select Field Device. The Insert Field Device Wizard Destination, screen appears. Select
the BACnet Integration item and click Next. The Insert Field Device Wizard, Select Definition Mode screen
appears.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
23
Figure 9: Insert Field Device Wizard (Select Definition Mode)
Note: If no BACnet Integration object appears, follow the procedures in Adding a BACnet Integration Object.
3. Select Assisted and click the Invoke Auto Discovery bar. The Auto Detect Utility Wizard starts. If auto
discovery has not already been performed, it begins immediately. If the Auto Detect Utility Wizard does not
start automatically, click Restart.
Note: The NAE must be online with the devices on the BACnet IP network to use Auto Discovery.
When Auto Discovery is complete, a list of discovered devices appears.
Figure 10: Auto Detect Utility Screen
4. Select a device from the list to start the item creation process for that device.
5. Follow the wizard’s prompts. At the configuration screen of the BACnet device, the Instance Number, Name,
and Item Reference fields fill in automatically with the auto-discovered data from the BACnet device. The Item
Reference comes from the remote device BACnet Object Identifier, and the Name defaults to the BACnet
Object Name of the BACnet device object. The NAE Navigation Tree uses the Name. Change the Name field
manually, if desired, by clicking the edit button. The BACnet Object Name in the device is not changed.
6. Complete the Insert Field Device screens by accepting the defaults. The Add Extensions Wizard starts.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
24
7. Add extensions by clicking New for the desired extension and completing the wizard prompts that appear.
Note: Adding extensions to attributes of the BACnet device is uncommon, and most users do not need to do
this step.
8. When finished adding extensions, click Done. The Insert Field Points Wizard starts.
9. Go to Mapping BACnet Field Points Using Auto Discovery or Mapping BACnet Field Points Manually.
Manually Mapping BACnet IP Devices
1. Select the BACnet Integration object within the NAE.
2. On the Insert menu, select Field Device. The Insert Field Device Wizard, Destination screen appears. Select
the BACnet Integration item and click Next. The Insert Field Device Wizard, Select Definition Mode screen
appears (Figure 11).
Figure 11: Insert Field Device Wizard (Select Definition Mode)
Note: If no BACnet Integration object appears, follow the procedures in Adding a BACnet Integration Object.
3. Select Manual and click Next.
4. Follow the wizard’s prompts. At the configuration screen of the BACnet device:
•
•
Fill in the Instance Number manually.
Enter the Name field manually if the default data for the BACnet device is not satisfactory.
The NAE Navigation Tree uses the Name. Change the Name field manually, if desired, by clicking the Name
field. The BACnet Object Name in the device is not changed.
5. Complete the Insert Field Device screens by accepting the defaults. The Add Extensions Wizard starts.
6. Add extensions by clicking New for the desired extension and completing the wizard prompts that appear.
7. When finished adding extensions, click Done. The Insert Field Points Wizard starts.
Note: If no BACnet Integration object appears, follow the procedures in Adding a BACnet Integration Object.
8. Go to Mapping BACnet Field Points Using Auto Discovery or Mapping BACnet Field Points Manually.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
25
Mapping BACnet Field Points Using Auto Discovery
Once one or more BACnet devices are configured, add BACnet field points that are mapped to BACnet objects in
the BACnet device.
The NAE must be online with the devices on the BACnet IP network to use Auto Discovery. For mapping points
offline, see Mapping BACnet Field Points Manually.
1. On the Insert menu, select Field Points. The Insert Point Wizard, Destination screen appears.
Figure 12: Insert Point Wizard (Destination)
The Insert Field Points Wizard starts automatically after inserting a Field Device. Because it selects the newly
added device as the destination, the wizard opens to the Select Definition Mode screen bypassing the
Destination screen.
Add BACnet devices during the Mapping BACnet Field Points Using Auto Discovery procedure. To view the
selectable devices, click the plus sign next to the BACnet Integration object to open the list of mapped BACnet
devices.
2. Select the BACnet device to which objects are to be integrated and click Next. The Insert Point Wizard, Select
Definition Mode screen appears.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
26
Figure 13: Insert Point Wizard (Select Definition Mode)
3. Click Assisted and then click Invoke Auto Discovery. The Auto Detect Utility Wizard starts. If an auto discovery
has not already run, it begins immediately. If the Auto Detect Utility Wizard fails to start automatically, click
Restart.
When Auto Discovery finishes, a list of discovered BACnet objects appears. The fields automatically fill in with
the auto discovered data from the BACnet device. The Native Object Name is the BACnet Object Name in the
device.
Note: If the total number of discovered points exceeds the limit, then the returned discovery indicates Page 1
of X, where X is the total number of pages. A restart increments the page and displays the next set of
discovered points. Each completion of the point mapping process also increments the page. After the
last page, the point mapping process begins again at Page 1.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
27
Figure 14: Auto Detect Utility Screen
The Identifier derives from the remote device BACnet Object Identifier and indicates both the object type and
instance number. The Name defaults to the Native BACnet Object Name; you can change the Name field during
the configuration process if desired. The Name appears in the NAE navigation tree. The BACnet Object Name
in the device is unchanged. The Instance Number comes from the BACnet Object Identifier.
4. Close the window by clicking the X in the upper-right corner of the screen.
5. Click Next. The Assisted Identity/Configure screen appears. Use this screen to select which points to map
from the BACnet device.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
28
Figure 15: (Part 1 of 2) Insert Point Wizard (Assisted Identity/Configuration)
6. Select points individually by clicking on them. When an item is mapped, a check mark appears next to it, and
the right side of the screen displays a summary of the mapping items.
Note: Deselecting a folder in the tree does not deselect the objects under the folder. Use this feature if the
objects should appear directly under the controller in the NAE UI navigation tree.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
29
Figure 16: (Part 2 of 2) Insert Point Wizard (Assisted Identity/Configuration)
7. After selecting all the points to map, click Next. The Insert Point Wizard summary screen appears.
8. Review the Summary screen and click Finish.
Mapping BACnet Field Points Manually
After adding a BACnet device, add BACnet Field Points mapped to BACnet objects in the BACnet device, if desired.
1. On the Insert Menu, select Field Points. The Insert Point Wizard, Destination screen appears (Figure 12).
The Insert Field Points Wizard starts automatically after inserting a Field Device. Because it selects the newly
added device as the destination, the wizard opens to the Select Definition Mode screen, bypassing the Destination
screen.
2. Select the BACnet device from which to map the points and click Next. The Insert Point Wizard, Select Definition
Mode screen appears (see Figure 13).
Note: Add BACnet devices during the Mapping BACnet IP Devices Using Auto Discovery procedure in this
document. If the screen displays no selectable device, click the plus sign next to the BACnet Integration
object to open the list of mapped BACnet devices.
3. Select Manual Point Definition; the screen changes to the manual mode with a list of point object types to add.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
30
Figure 17: Insert Point Wizard (Select Definition Mode)
Distinguish the Manual Point Definition from the Assisted Point Definition by the list of steps on the left side
of the screen. The Manual Definition display adds a Data Source step and separates the Identify and Configure
steps.
4. Select the type of point to create and click Next. The remaining steps of the Insert Point Wizard - manual mode
are listed in the following table.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
31
Table 6: Insert Point Wizard - Manual Mode Screens
Screen
Purpose
Identifier
Allows entry of a unique name for each mapped field point.
Configure
Allows field point configuration. Click Advanced to see the BACnet object identifier. Be
sure to fill in the Instance Number on the Hardware tab of the Configuration Screen
and to match the configuration to the Instance Number of the BACnet Object Identifier
in the host BACnet device.
Summary
Provides a summary of the entered information. Click Back to make any corrections.
5. Click Finish.
Using the Relearn Feature
The Relearn feature uses Auto Discovery and requires that the NAE be online with the BACnet network to discover
Field Devices and Field Points.
1. Select the BACnet Integration object from the Navigation tree structure.
2. Click the Engineering tab and click the Relearn button that appears below the tab.
Figure 18: Engineering View with Relearn Button
Discovery begins automatically and finds all new BACnet devices on the network. After Discovery, the new
devices appear in the Integration Tree and in the Integration View.
3. When Discovery is complete, close the Auto Discovery box.
Using the Engineering View to View and Edit Device Attributes (BACnet
Properties)
When online with a BACnet device, use the Engineering view of the BACnet Integration object to View and Edit
Device Attributes (known as properties in BACnet terms). Act on these devices whether mapped to the Navigation
tree or not.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
32
1. Right-click the BACnet Integration object on the Navigation tree and select View. The BACnet Integration object
appears.
Figure 19: BACnet Integration Object
2. Click the Engineering tab, and navigate to either a field device or a field point in the Integration Tree.
3. Double-click the selected field device or field point. The Details screen for the selected field device or object
appears.
4. Click Edit. The editable fields from this screen appear in a box with a heavy line border.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
33
Figure 20: Edit Field Device or Field Point Properties
The BACnet device displays only the required and optional attributes of the BACnet point object. Vendor-specific
proprietary attributes do not appear.
For attributes that support a command priority, such as the Present Value of an Analog Output (AO), the BACnet
device displays the active value and priority. To change a value, enter an equal or higher priority. Clearing the
value at the specified priority releases this priority and displays the value for the next highest priority.
5. Make the desired changes and click Save.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
34
Field Bus Integration Object — Detailed Procedures
Adding BACnet MS/TP (Field Bus) Integrations
1. On the Insert menu, click Integration. The Insert Integration Wizard starts.
Figure 21: Insert Integration Wizard (Select Object Type)
2. Follow the prompts to configure the integration using the information in the following table.
Table 7: Insert Integration Wizard
Screen
Purpose
Object Type
Select the type of integration (Field Bus).
Destination
Select the NAE/NCE that connects to the integrating trunk.
Identifier
Type a unique name for the trunk. Each integration under a device requires a unique name.
By default, the name of the newly entered object has a number appended to keep it unique;
therefore, if adding a BACnet MS/TP trunk to a site for the first time, the default name is
1
Field Bus.
2
3
1
Configure
Configure information about the integration such as trunk number and a brief description.
Note: If BACnet routing is enabled for this NAE, the Network Address on the Hardware
tab must be unique from all other Field Bus network addresses on the site that also
enable BACnet routing.
Summary
View the basic parameters of the integration just added.
1
2
3
When selecting or adding a second BACnet MS/TP trunk, change the default trunk number (which is 1) on the Hardware
tab to 2 and change the Network Address to a value not already used on the NAE, typically one greater than the default
value.
Typically, use the default values for Baud Rate Selection and Network Address. Change the Network Address if the
activity at the site also includes integrating third-party BACnet networks into the NAE. If BACnet routing is enabled for
this NAE, the Network Address on the Hardware tab must be unique from all other network addresses on the site that
also enable BACnet routing.
Trunk numbers 1 and 2 are used for local BACnet MS/TP trunks. Trunks that communicate through the BACnet IP
connection to a BACnet IP to MS/TP router (which provides the MS/TP wiring connection) use higher trunk numbers
between 3 and 20. You must configure the router with an MS/TP network address number that is unique from all other
network address numbers on the site. You must set the BACnet network address of the field bus to match the BACnet
MS/TP network address number of the router. The BACnet IP network address of the router must match the BACnet IP
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
35
network address of the NxE. In addition, one or more BBMDs may be required to allow BACnet IP broadcast messages
to reach the router. For more information on field bus capacity and quantity limits, refer to the Metasys® SMP Help
(LIT-1201793).
3. Click Finish.
Manually Adding BACnet MS/TP (Field Bus) Field Devices (Online or Offline)
Use the Insert Field Device Wizard to manually add BACnet MS/TP (field bus) field devices, whether the system
is online or offline.
1. On the Insert menu, click Field Device. The Insert Field Device Wizard starts.
Figure 22: Insert Field Device Wizard (Destination Screen)
2. Select the trunk to which the field device is connected and click Next. The Insert Field Device Wizard Select
Definition Mode screen appears.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
36
Figure 23: Insert Field Device Wizard (Select Definition Mode Screen)
3. Click Manual. You are then prompted to select the class of device (JCI Family BACnet Device or General BACnet
Device).
Note: When using the SCT, the Assisted option appears dimmed because that method is unavailable when
the system is offline.
Figure 24: Insert Field Device Wizard (Select Definition Mode Screen, Manual Setting)
4. For JCI Family BACnet Device, select a BACnet MS/TP address for the new device. All BACnet MS/TP addresses
in the list are available because the address list updates each time a new controller object is created. After
choosing a BACnet MS/TP address, click Next. Auto Discovery is available only for online field devices. See the
Adding BACnet MS/TP Field Devices Online Using Auto Discovery section in this document.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
37
Note: When JCI Family BACnet Device is selected, you are prompted to enter the MAC Address, which is the
physical hardware address of the device as determined by its address switch settings. When General
BACnet Device is selected, you must enter the BACnet Instance number, which is determined by software
settings in the device. This value is entered on the Hardware tab of the Identifier screen of the Wizard.
5. Click Next. The Insert Field Device Wizard Identifier screen appears.
Figure 25: Insert Field Device Wizard (Identifier Screen)
6. Choose a unique name (within the parent object) for the new controller object and click Next. The Insert Field
Device Wizard Configure screen appears. The fields of the Configure screen have default data based on the
previous information entered. This information includes the object type and naming parameters of the new
controller just created.
Figure 26: Insert Field Device Wizard (Configure Screen)
When using the Manual Device Definition, the default name is always FD plus an incremental number for field
devices. The incremental number provides a suggested name that is unique within the context of the parent
object, in this case a BACnet MS/TP (field bus) integration.
7. Click Next. The Insert Field Device Wizard Summary screen appears.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
38
Figure 27: Insert Field Device (Summary Screen)
8. If satisfied with the Summary, click Finish (otherwise, click Back and correct any problems).
9. Add extensions to the newly created controller object, if needed. See Adding Extensions to an Object for more
information.
Adding BACnet MS/TP Field Devices Online Using Auto Discovery
When logged in to an NAE through the Metasys system, the user can automatically discover field devices. Do not
use the Auto Discovery process through the SCT. However, in the SCT, the user can upload devices discovered
on the network and added to the NAE database for archive and editing.
1. On the Insert menu, select Field Device. The Insert Field Device Wizard Destination screen appears.
2. Select the BACnet MS/TP trunk to map the field devices to and click Next. The Select Definition Mode screen
appears.
The Assisted Mode and Invoke Auto Discovery options are not available from the SCT. Upload any relevant
online-generated information to an archive database in the SCT.
Figure 28: Insert Field Device Wizard (Online Only Select Definition Mode Screen)
3. Click Invoke Auto Discovery. The Auto Detect Utility starts.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
39
4. After Auto Discovery is complete, select the device to map. If the device is already mapped, a notification message
appears. If the device is not mapped, the Insert Field Device Identifier screen appears.
5. Enter a unique identifier for the device and click Next. The Insert Field Device Wizard Configure screen
appears.
6. Click Next. The Insert Field Device Summary screen appears.
7. If the Summary is satisfactory, click Finish (otherwise, click Back and correct any problems). This action creates
the object and enables the process for adding extensions to the new controller object. See Adding Extensions
to an Object for more information.
8. After adding all discovered devices, use the SCT to upload the NAE database to an archive database in the
SCT.
Note: See Troubleshooting (BACnet Trend Logs cannot be discovered) if the auto discovery fails to find third-party
Trend Log objects.
Adding BACnet Devices to the BACnet and MSTP Integrations Using the
Import Integration Wizard
1. On the navigation tree, click the integration you want to add a device to.
2. On the Action menu, select Import Integration. The Open files screen appears.
3. Locate and select the import file that matches the integration. Then click Open. The Import Integration screen
appears.
Figure 29: Import Integration Screen
4. Click Go. The Import Integration starts.
5. After the Import Integration is complete, a notification message appears.
If the import file does not match the integration, an Alert notice appears.
Figure 30: Alert Notice
6. Click OK. Repeat this process for each device you want to add.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
40
Adding Extensions to an Object
Add trend, totalization, alarm, load, and averaging extensions to increase the functionality of a field device or field
point object.
After creating a field device object or a field point object, the Extension Wizard automatically starts (skip to Step
3).
1. Select an object.
2. On the Action menu, select Show Extensions. The Extension Wizard starts.
Figure 31: Extension Wizard
3. Click New in the row next to the desired type of extension. Follow the prompts on the Wizard that appears. See
Adding a Trend Extension, Adding a Totalization Extension, or Adding an Alarm Extension for more information.
4. Follow the prompts to configure the extension and click Finish when done. The Extension Wizard appears with
the new extension listed in the appropriate row.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
41
Figure 32: Extension Wizard With Extension Added
5. Click Done after adding the needed extensions. If the Extension Wizard launches automatically after creating
the new field device object, the Field Device Extension screen opens next.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
42
Figure 33: Field Device Extension Screen
6. Add field points under the newly created controller object by clicking New in the Field Points panel of the Field
Device Extension Wizard. See Manually Adding BACnet MS/TP (Field Bus) Field Devices (Online or Offline)
for instructions on adding BACnet MS/TP points.
Adding a Trend Extension
Adding trend extensions to objects allows the user to collect historical data for one or more attributes of an object.
Afterwards, view that data or forward the data to an ADS/ADX/ODS for long-term storage. Use Trend Study to view
Trend extensions from multiple items at the same time.
1. In the Extensions Wizard, click New in the Trend row. The Insert Trend Wizard Select Attribute screen
appears.
The trended attribute defaults to Present Value. To trend a different attribute, click other. The attribute list
appears.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
43
Figure 34: Insert Trend Wizard (Select Attribute Screen)
2. Select an attribute and follow the prompts in the Wizard to complete the addition of a Trend Extension.
3. Click Finish. The Extensions Wizard appears with the new attribute listed under Trend.
Adding a Totalization Extension
1. In the Extensions Wizard, click New in the Totalization row. The Insert Totalization Wizard Select Attribute
screen appears.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
44
Figure 35: Insert Totalization Wizard (Select Attribute Screen)
2. Select an object in the top of the screen and an attribute in the bottom and click Next.
Note: Click other to display a list of available attributes.
3. Select Totalization type from the available options on the right (if available).
4. Follow the prompts in the Wizard to complete the addition of a Totalization Extension.
5. Click Finish. The Extensions Wizard appears with the new attribute listed under Totalization.
Adding an Alarm Extension
Note: To add a BACnet intrinsic alarm, refer to the M-Series Workstation Interface to the NAE Application Note
(LIT-1201655).
1. In the Extensions Wizard, click New in the Alarm row. The Insert Alarm Wizard Select Attribute screen
appears.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
45
Figure 36: Insert Alarm Wizard (Select Attribute Screen)
2. Select an object to add the Alarm extension to in the top of the screen and an attribute in the bottom of the
screen and click Next.
Note: Click other to display a list of available attributes.
3. Follow the prompts in the Wizard to complete the addition of an Alarm Extension.
4. Click Finish. The Extensions Wizard appears with the new attribute listed under Alarm.
Adding a Load Extension
1. In the Extensions Wizard, click New in the Load row. The Insert Load Wizard Select Attribute screen appears.
2. Select an object to add the Load extension to in the top of the screen and an attribute in the bottom of the
screen and click Next.
Note: Click other to display a list of available attributes.
3. Follow the prompts in the Wizard to complete the addition of an Load Extension.
4. Click Finish. The Extensions Wizard appears with the new attribute listed under Load.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
46
Adding an Averaging Extension
1. In the Extensions Wizard, click New in the Averaging row. The Insert Averaging Wizard Select Attribute
screen appears.
Figure 37: Insert Averaging Wizard (Select Attribute Screen)
2. Select an object to add the Averaging extension to in the top of the screen and an attribute in the bottom of
the screen and click Next.
Note: Click other to display a list of available attributes.
3. Follow the prompts in the Wizard to complete the addition of an Averaging Extension.
4. Click Finish. The Extensions Wizard appears with the new attribute listed under Averaging.
Deleting Extensions from an Object
1. Select a field device or a field point that contains the extensions to delete.
2. On the Action menu, select Show Extensions. The Extension Wizard starts.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
47
Figure 38: Extension Wizard
3. Select the check boxes next to the extensions you want to delete.
4. Click Delete for each extension.
Clicking Delete in any extension row deletes only the checked extensions in that row. For example, in Figure
38, click both Resource Delete and Alarm Delete to delete both checked extensions.
5. Click Done when finished.
Copying Extensions to a Field Device or Field Point (Offline Only)
1. Select a field device or a field point that contains the extensions to copy.
2. On the Action menu, click Show Extensions. The Extension Wizard starts.
3. Select the check boxes for the extensions that you want to copy and click Copy Checked Extensions at the
bottom of the Wizard.
4. Click Done.
5. In the Navigation Tree, select the desired field device or field point destination.
6. On the Edit menu, click Paste. This adds the copied extensions to the selected field device or field point.
7. Drag the field device or field point to the Display frame (on the right) to verify that the new extensions are correct.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
48
Figure 39: Alarm and Resource Extensions Pasted into AHU-1
Enabling the Routing Mode
Normally, third-party BACnet field devices only view mapper objects in the NAE, which are representations of the
real BACnet objects in the third-party BACnet field devices. Because the objects are representations, no extra
network traffic is added to third-party BACnet field devices. Enable the routing mode at the NAE if you need to
communicate directly with the third-party BACnet field devices, such as when you are reprogramming from the third
party’s engineering workstation, to directly pass BACnet messages from the workstation through the NAE to the
third-party BACnet field devices.
BACnet Routing Considerations
BACnet routing is a technique by which data on one network data segment is passed to and from another network
data segment. In the case of the NAE, this BACnet routing occurs when data is passed from the IP side of the device
to the MS/TP side of the device.
If routing is disabled, the NAE provides an indirect (or proxy) method of obtaining the data on its MS/TP network
when a request is made from another device on the IP side of the device. With routing enabled, the NAE no longer
has to have detailed knowledge of the types of devices and services that reside on its MS/TP network–it simply
passes the data request from one link to the next and back again with as little interference as possible. This passing
of information benefits those third-party vendors that have the need to configure devices on the NAE’s MS/TP network
using proprietary tools from the IP network side.
Note: On a homogenous (or near-homogeneous) Johnson Controls network, typically you do not need to enable
routing.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
49
The routing function of the NAE is disabled by default. Routing can be enabled by setting the Routing Mode attribute
on the Network tab of the Device object view to Enable. You can disable routing by setting the Routing Mode attribute
to Disable. Restarting the NAE is not required when routing is enabled or disabled.
The Enable without Broadcasts setting of the Routing Mode attribute is used to reduce the network traffic caused
by enabling routing on an MS/TP network. If this option is used, it is difficult for third-party devices outside the network
to discover any devices on a routed network using this setting because they rely on broadcast data for discovery.
Because the data capacity of Ethernet IP is much higher than that of MS/TP, special care must be taken to avoid
overloading the MS/TP bus when routing is enabled.
All integrated points are visible in the NAE by default, including General BACnet Devices. A third-party device can
view the entire list of integrated points by requesting the Object List of the NAE. This request is part of the BACnet
communication protocol used to help discover objects on other BACnet devices.
If you want to have access to third-party integrated points within the NAE, there is a benefit to interfacing with mapped
MS/TP points in the NAE rather than directly with the objects in each MS/TP device. The NAE acts as a high-speed
proxy for all data requests within its domain, which ensures the best performance. This is the default behavior for
the NAE and eliminates the need for enabling routing on the NAE. Routing should only be enabled if existing third-party
tool configurations cannot support any other method.
When routing is enabled, device configurations must follow more strict setup rules, and configurations that may have
previously worked in non-routing situations may no longer work. The same setup rules apply for systems with routing
enabled and static IP networks.
Notes:
•
•
Once routing is enabled on the NAE, all device identifiers within each device must be unique across all routed
networks, and all network address numbers must be unique across all routed networks.
Be sure you have good reason before you enable routing. For example, if BACnet rules are not followed
when routing is enabled, performance and intermittent issues could result. Or, if a third-party device exists
or is added in the future, considerable work may be required to allow the device to work.
The BACnet Broadcast Receive Rate, BACnet Routed Messages Rate, MS/TP Broadcast Transmit Rate, MS/TP
Broadcast Receive Rate, and Net Routed Messages attributes allow you to diagnose an overloaded network.
Related Documentation
Table 8 lists documents related to Metasys system and BACnet® protocol.
Table 8: Related Documentation
For Information On
See Document
Installing the NAE
NAE55/NIE55 Installation Instructions (Part No. 24-10051-43)
Installing the NCE
NCE25 Installation Instructions (Part No. 24-10143-63)
Overview of BACnet and MS/TP Field Bus
Controllers
Metasys® System Field Equipment Controllers and Related
Products Product Bulletin (LIT-12011042)
Setting up Databases
Metasys® SCT Help (LIT-12011964)
Configuring the NAE and NCE
NAE Commissioning Guide (LIT-1201519)
Understanding the Metasys System
Metasys® System Configuration Guide (LIT-12011832)
Using the Metasys System and Metasys System
Supported Objects and Commands
Metasys® SMP Help (LIT-1201793)
NAE Protocol Implementation Conformance
NAE/NCE Protocol Implementation Conformance Statement
Statement (PICS)/BACnet Interoperability Building (LIT-1201532)
Blocks (BIBBs)
BACnet Information
American National Standards Institute/American Society of
Heating, Refrigerating, and Air-Conditioning Engineers
(ANSI/ASHRAE) Standard 135-2012 at protocol revision 12
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
50
Table 8: Related Documentation
For Information On
See Document
Supported Enumeration Sets When Using the
Metasys System with a Third-Party BACnet
Workstation or Controller
Metasys® System Enumeration Sets Technical Bulletin
(LIT-12011361)
Acronyms and Terms
Metasys System Extended Architecture Glossary Technical
Bulletin (LIT-1201612)
Remote Field Bus
MS/TP Communications Bus Technical Bulletin (LIT-12011034)
Open Data Server
ODS Commissioning Guide (LIT-12011944)
Troubleshooting
BACnet System Integration Troubleshooting Guide
Use the information in Table 9 to assist in diagnosing and solving possible BACnet System Integration problems.
Table 9: BACnet System Integration Troubleshooting Guide
Symptom
Cause
Solutions
Auto discovery fails to find all
devices.
—
Verify that the NAE Network Address and BACnet IP Port match
that of the integrating IP-based BACnet devices. In the NAE
Device object Focus view, select Advanced to view the BACnet
IP Port address.
If the BACnet device is on the MS/TP Field Bus, verify that the
Network Address defined under the Hardware tab of the MS/TP
Field Bus is correct.
Verify that no network devices have duplicated Object Identifiers.
In accordance with the BACnet specification, the BACnet Object
Identifier for each device on the entire network must be unique.
After performing a Relearn, view the Duplicate Device Identifiers
attribute of the BACnet Integration object (Diagnostic view).
Any duplicates found on the network are listed.
Verify that the BACnet Object Identifier of the NAE itself does
not conflict with that of the BACnet devices being integrated. The
NAE BACnet Object Identifier appears in the Focus view after
selecting Advanced.
If the BACnet device is on a different IP network segment from
any NAE, specify a a BACnet Broadcast Management Device
(BBMD) for its segment. Add the device IP address or host name
of a BBMD device in that segment to the third-party BBMD
attribute of the Site object and add all of the NAE BBMD devices
to the specified BBMD device.
Verify that the BACnet device supports the Who-Is BACnet
service. Auto discovery requires the support of this service.
A BACnet device goes offline and A change of the
fails to come back online.
BACnet device IP
address.
At startup of the NxE, the BACnet Integration binds with the
BACnet Object Identifier (OID) and uses the IP address from
that bind. If you move a device to a different subnet, or change
the IP address of the device, you must restart the NxE to bind
the OID with the new IP address.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
51
Table 9: BACnet System Integration Troubleshooting Guide
Symptom
Cause
Solutions
BACnet Trend Logs cannot be
discovered.
The third-party Trend
Log object does not
support BACnet
Logging Type
(property 197) and
returns an
Unknown_Property
error when read.
Manually add the third-party Trend Log object to show the trend
log attributes, and display the views and log data graph properly.
See Adding a Trend Extension.
Attempts to write string attributes Encoding type may be
(such as Description) or if alarm incorrect.
acknowledgments from the SMP
UI are not seen at the BACnet
device.
Verify that the BACnet Encoding Type specified in the Site
matches the encoding that the BACnet devices are using: ANSI
X3.4 (US_ASCII), ISO 10646 (UCS-20), or Microsoft DBCS Code
Page 932.
Time sync or UTC time sync
messages are not accepted.
The NAE/NIE accepts BACnet time sync messages only if no
Simple Network Time Protocol (SNTP) server is defined for
that NAE/NIE. If the device is a Site Director, do not enable
(leave blank) the Site Time Servers attribute of the Site object.
—
Note:
The UTF-8 BACnet Encoding Type is also compatible
with ASCII as long as extended characters (for example,
Ç, ä, ╣, and ß) are not used with ASCII devices.
or
If the device is not a Site Director, do not enable (leave blank)
the Device Time Servers attribute of the Site object.
or
If the Time sync or UTC time sync message does not contain a
specific time as required by BACnet (for example, message has
wild card values), it is not accepted.
Building Technologies & Solutions
507 E. Michigan Street, Milwaukee, WI 53202
Metasys® and Johnson Controls® are registered trademarks of Johnson Controls.
All other marks herein are the marks of their respective owners.© 2017 Johnson Controls
Published in U.S.A.
BACnet® Controller Integration with NAE/NCE/ODS Technical Bulletin
www.johnsoncontrols.com
52
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising