Bacnet Point Manager

This is the default view for the Points extension (or Points folder) under any BacnetDevice, and works similarly to the way other point managers work, which support online point discovery. Refer to the Niagara Drivers Guide for general details.

Discovered pane

By default, the Discovered table for BACnet objects lists the single BACnet device object at top, and other objects underneath, with each object initially occupying a single row.

Figure 168.   Discovered BACnet points showing present values
Image

To open this view, expand Config > Drivers > BacnetNetwork > Bacnet Device and double-click on the Points Folder.

To sort objects click on any column header. To group like type objects together, sort by Object ID (BACnet object type).

To select other properties (apart from Present_Value) as a candidate to proxy, click the plus (+) icon to expand the object.

Discovered pane

Column Description
Object Name Displays the name of the discovered BACnet object. This name is unique within this specific device.
Object ID Displays the identifier for the discovered BACnet object. This number is a combination of BACnet object type and instance number (unique within the object type).
Property ID Reports the Property ID for the discovered BACnet object. By default, all objects that have a Present_Value property are listed with this value on top. BACnet objects without a Present_Value property (for example, a device object or trend log object) show another property as the top Property ID.Typically, present value is the most useful piece of data from any BACnet object. However, you can expand any discovered object to see all its properties as children in the Discovered pane, where each one is a separate proxy point candidate. Additionally, properties that are arrays are further expandable.
Index Reports a number that points to a value in an array, if selected, otherwise this column cell is blank. For example, if you expand a priority-type object, such as object type binaryOutput, and expand again on its property array, each child row displays with a unique index number (1-16).
 NOTE: Use this to proxy a point to write to only one specific level of the Priority_Array property of the target BACnet object (instead of accessing all levels, by proxy of only the default presentValue property). This may be useful in your control scheme, if you have a number of possible sources in the station you wish to evaluate (on a priority basis), to write to one BACnet priority level (only) in the target BACnet object. 
Value Reports the static value of the associated property, captured when the system retrieved the object list (or, for any non-default properties, when you expanded the top property).

Discovered values display showing any descriptors associated with the BACnet object’s related properties (Units, Active_Text, Inactive_Text, and so on).

Description Reports any available character string Description for the BACnet object. In many cases, this value may be blank.

Database pane

The Database table contains existing BACnet proxy points, where each appears as a row in the table. Each proxy point represents one data item from a specific BACnet object in that device.

Figure 169.   Database shows Bacnet proxy points in the station
Image

To sort points, click on any column header. Often, this is useful to sort by Object ID (BACnet object type) or, perhaps, by name.

If you created BacnetPointFolders under a device’s Points container, use the All Descendents tool to view all proxy points in the device from the main (root) Device Points Manager. For details, refer to the Drivers Guide.

Column Description
Path Reports the station path to the proxy point.
Name Reports the name for the BACnet proxy point. If you added the point from a discover (selecting the default presentValue property), and did not edit Object Name, this name is identical to the BACnet object’s name. As needed, you can edit this value.
Type Reports the type of point that the proxy is based upon (BooleanWritable, NumericPoint, etc.).
Out Reports the current out value, including any point facets. This defaults to the single (configured) property value along with status for the proxy point. Since BACnet supports its own native status in addition to the Framework’s status, you can edit point facets to poll for additional properties, such as the native status Flags and/or priority array levels.
Enabled Reports if the proxy point is currently enabled for communication.
Object ID Reports the Object Id property of the proxied BACnet object, which is a combination of BACnet object type and instance number (unique within that type). In this column, these two properties appear separated by a colon (:), using descriptors for type. For example:
  • analogInput:3
  • multiStateValue:3
  • binaryOutput:3
Property ID Reports the BACnet property name proxied by the point. For example Present Value or Event State, depending on the selection.
 NOTE: Do not change the Property ID on an existing BACnet proxy point. Changing it may produce undesirable results, especially if a different control point type would apply. Instead, make a new proxy point. 
Index
Provides a numeric index into the property array. Applies only to an arrayed property, such as Priority Array, otherwise it defaults -1 for no index.
Tuning Policy Name Displays the name of the network’s tuning policy component assigned to the point.
Data Type Displays the ASN (Abstract Syntax Notation) data type for the property (ENUMERATED, REAL, and so on).
Read Identifies the read-only read status of the proxy extension, which is typically either Polled, COV, or unsubscribed, depending on a number of factors. If a read error occurs, other descriptive text may appear instead.
Write Identifies the read-only write status of the proxy extension, which is typically read only if the proxy point is not writable or, if it is a writable point type, either writable or ok (the last write occurred within the effective tuning policy period). Or, if a write operation failed, the write status provides some descriptive text.

For example, If you create a writable point for a read-only object (say, a NumericWritable for presentValue of an Analog_Input object), and attempt to write to it, the write status may show: Property:Write Access Denied. If the error is actually a BACnet Error, then this colon-separated format will contain the Error Class and Error Code returned by the device.

Device Facets Reports the learned facets from the source BACnet object.
Facets Reports the facets in use by the parent proxy point.
Conversion Identifies the conversion used between device facets and point facets (typically Default).
Read Value Reports the last value read from device, and expressed in device facets.
Write Value Reports the last value written using device facets. (Applies to writable types only.)
Fault Cause Displays the reason why the object is unable to connect the device.

Buttons

  • New Folder creates a new folder for devices. Each such folder provides its own set of manager views.
  • New creates a new device record in the database.
  • Edit opens the device’s database record for updating.
  • Discover runs a discover job to locate installed devices, which appear in the Discovered pane. This view has a standard appearance that is similar to all Device Manager views.
  • Cancel ends the current discovery job.
  • Add inserts into the database a record for the discovered and selected object.
  • Match associates a discovered device with a record that is already in the database.
  • TagIt associates metadata, such as location or unique configuration with the object.

Bacnet Point Manager actions

Two actions are available in this view. These actions are on the proxy extension itself, and not the parent control point.

Figure 170.   Actions for any Bacnet ProxyExt
Image

These actions are briefly described as follows:

  • Force Read results in an immediate poll of the source BACnet object’s property.
  • Force Write attempts to write from the Framework to the BACnet object’s property. If the property is read-only (or otherwise protected by the BACnet device), the system displays an error in the Write Status property.

Manager menu

These actions are available on the BacnetDeviceFolder Manager menu.

Menu item Description
New Folder Creates a new folder (same function as the New Folder button).
All Descendents Expands the selected folder to reveal all subordinate objects.
New Creates a new device record in the database.
Edit Opens the Edit window for updating the selected record.
Learn Mode Controls the discovery of devices and adding them to the database.
Discover Initiates a discovery job (same as clicking the Discover button).
Cancel Stops the current job.
Add Opens an Add window with properties to configure before adding the selected record(s) in the Discovery pane to the database.
Quick Add Adds the selected record(s) in the Discovery pane to the database.
Match Opens a window with properties to configure before matching the discovered record with a record in the database.
Quick Match Matches the selected record with its sister record that is already in the database.
Tag Mode Opens a Tag Dictionary pane for managing metadata tags. The Niagara Tagging Guide documents tag.
TagIt Associates an item of metadata, such as location or unique configuration, with the object.