Channel Attributes - Metasys - LIT-12011942 - Software Application - ODS Server - 10.1

Metasys Open Data Server Help

Brand
Metasys
Product name
ODS Server
Document type
User Guide
Document number
LIT-12011942
Version
10.1
Revision date
2019-10-14
Language
English

This object contains attributes common to many Metasys system objects. These common attributes are described in the Common Object Attributes section. This section includes attributes of the Focus/Configuration tab for this object. See the Object and Feature Tabs section for information on the attributes that appear on the other tabs of this object (for example, the Hardware and Options tab appear on point objects).

Note: In the Notes column, letters for the attributes indicate the following: C - Configurable, N - Value Not Required, W - Writable.
Table 1. Channel Attributes

Attribute Name

Notes

Initial Value

Values/Options/Range

Description

Acked Transitions

C,W

 

To Off Normal, To Fault, To Normal

Conveys three separate flags that each indicate if the most recent To Offnormal, To Fault, or To Normal event transitions have been acknowledged (if the transition requires acknowledgement). This attribute appears only in the Snapshot Focus view.

Channel Data Type

     

Specifies the data type of the channel object's present value.

Event Enable

C,W

 

To Off Normal, To Fault, To Normal

Conveys three flags that determine if notifications are enabled for To Offnormal, To Fault, and To Normal transitions. When a flag is set, this means that the corresponding transition causes notification to be sent to all enrolled devices. When a flag is cleared, this means that the corresponding transition is not reported. The object’s Event State continuously updates, regardless of the value of the Event Enable attribute. This attribute appears only in the Snapshot Focus view.

Event State

   

Normal, Fault

Determines whether an active event state is associated with this extension. The value is set to Normal when there is no intrinsic alarming defined for this object. If intrinsic alarming is enabled (Enable Intrinsic Alarms = True), then this value is either Normal or Fault (problem occurred with the object subscribing for Change of Value [COV]s). This attribute appears on the view when the site is defined as a BACnet site. This attribute appears only in the Snapshot Focus view.

Event Time Stamps

C,W

   

Conveys the times of the last event notifications for To Offnormal, To Fault, and To Normal events. Time stamps of type Time or Date have FF if no event notification of that type has generated since the object was created. This attribute appears only in the Snapshot Focus view.

Execution Delay

C,W

 

0 - 65535 milliseconds

Indicates an execution delay in milliseconds for each value that is specified in the List Of Object Property References. A value of zero indicates no delay. Once updated with a non-zero execution delay, the Channel object writes back to BACnet device.

JCI List of Object Prop Refs

C,W

   

Specifies a list of attributes that the Channel object controls. This attribute is the Johnson Controls version of the BACnet List of Object Property Reference attribute.

JCI Property References

C,W

   

Listing of Metasys objects (name, reference, attribute) that are referenced by the Channel object.

Note: The JCI Property References attribute references objects that are listed under the List of Prop Refs attribute of the Channel object. If any of the attributes under the List of Prop Refs attribute are deleted from the BACnet device, the corresponding object listed under the JCI Property References attribute are not deleted but instead show up as an invalid reference value, highlighted in red. As a workaround, manually remove the object from the JCI Property References list.

Last Priority

     

Indicates the most recent priority at which the BACnet device wrote to the Present Value of the Channel object.

List of Prop Refs

C,W

   

Specifies a list of attributes that the Channel object controls. This is a BACnet attribute.

Notification Class

C,W

1

 

Specifies the notification class used for handling and generating event notifications for this object. The Notification Class attribute implicitly refers to a Notification Class object that has a Notification Class property with the same value. If the class number references a non-existent Notification object, no Notification occurs.

When the Notification Class attribute is written online, the Notification Object Reference is updated to the Object Reference of the Notification Class object with that instance number, if found. If the Notification Class object for a Johnson Controls proprietary object is not found, the reference is left blank.

If both the Notification Object Reference and the Notification Class attributes are written simultaneously online (or both are configured and downloaded), the Notification Class attribute value is set to the value that was written to the Notification Object Reference, and the Notification Class value in the write message is ignored.

This attribute appears only in the Snapshot Focus view.

Notification Object Reference

C,W

 

Limited to Notification Class on the same device.

Specifies the Notification Class object used to route alarms for the object being configured (through tree selection). When the Notification Object Reference is written, the value of the Notification Class attribute is updated to reflect the referenced object’s instance number. The value of the Notification Object Reference attribute is restricted to Notification Class objects on the same device as the alarming object. Validation only occurs during a write, not during a create (the download does not fail). This attribute appears only in the Snapshot Focus view.

Notify Type

C,W

Events

 

Conveys if the notifications generated by the object are Events or Alarms. This attribute is required if the object supports intrinsic reporting. This attribute appears only in the Snapshot Focus view.

Object Identifier

     

Specifies the unique numeric code used by the BACnet device to identify the object.

Out of Service

C,W

   

Indicates whether the Channel object is currently Out of Service. When Out of Service is True, you can change the present value and reliability of the Channel object.

Profile Name

     

Specifies the name of the BACnet profile to which the Channel object uses.

Reliability

C,W

Reliable

Uses Reliability (Set 503).

Represents the reliability of the Present Value. If the Input Reference becomes unreliable, the trend extension monitoring the input becomes unreliable.

Remote Description

C, W

   

Describes the name of the channel as identified by the BACnet device.

Remote Reliability

     

Represents the reliability of the remote object's Present Value.

Status Flags

C,W

   

Indicates the general status of the object in BACnet terms and contains four independent states.

The four flags are:

In Alarm—False if the Event State attribute value is Normal; otherwise, the In Alarm flag is True. (Set only by BACnet Intrinsic Alarming.)

Fault—True (1) if the Reliability attribute is not reliable; otherwise, the Fault flag is False.

Overridden—Overridden flag is True if the Present Value is overridden from the hardware source level.

Out of Service—Out of Service flag is True if the Out of Service attribute value is True; otherwise, the Out of Service flag is False.

User Name is BACnet Obj Name

C, W

False

False, True

Controls whether the object’s User Name attribute is also the Object Name attribute. The Object Name attribute is not writable, so the only way to change the Object Name attribute is to edit the User Name attribute and set the User Name Is BACnet Obj Name attribute to True.

Write Status

   

Successful, Failed

Indicates the current status of the Channel object processing to the properties under the List of Object Property References. A status of Failed indicates the Channel object encountered a coercion failure, or received an error, reject, or abort for at least one of the writes.