Engine device object attributes - Metasys - LIT-12012116 - Server - Metasys UI - 7.0

Johnson Controls System Configuration Tool (JCT) Help

Brand
Metasys
Product name
Metasys UI
Document type
User Guide
Document number
LIT-12012116
Version
7.0
Revision date
2023-09-01
Language
English

The engine device object contains attributes common to many Metasys system objects. This section includes attributes of the Focus/Configuration tab and any other tab specific only to this object.

Note: In the Notes column, letters indicate the following: C - Configurable, D - Default Attribute for Display, N - Value Not Required, Q - BACnet Required, and W - Writable.
Table 1. Engine device object attributes - Focus/Configuration Tab

Attribute name

Notes

Description

Ack Forward Enable

C,W

Specifies whether all events acknowledged or discarded at a network engine are forwarded to the repository if an ADS Repository is configured. What is included are:
  • Events and BACnet intrinsic alarm notifications generated by the engine and acknowledged by a user logged into the engine.
  • BACnet intrinsic alarm notifications received by an engine that are acknowledged at a BACnet device and acknowledged by the engine without a user ID and forwarded to the repository.

Acknowledgments are not forwarded to an repository on a dial-up connection.

When you acknowledge BACnet event notifications, events are annotated with the source or device of the acknowledgment and your user name as who acknowledged the event. If an event notification from an engine is acknowledged at a third-party BACnet workstation, the event annotation at both the engine and the site include the source of the annotation. If, however, an event notification from a third-party device is acknowledged from a third-party workstation, any engine that also receives the event notification does not include a source for the acknowledgment. When that event acknowledgment is forwarded to the Site Director, the user is specified as MetasysSysAgent.

When this attribute is not enabled, events acknowledged at engines are:
  • not forwarded to the repository. All events must be acknowledged at the Site Director.
  • locally acknowledged at the engine. This acknowledgment includes sending a BACnet alarm acknowledgment for alarm notifications received by an engine.

Regardless of whether this attribute is enabled, when events are acknowledged or discarded at the Site Director, the Site Director attempts to forward the acknowledgment and discards it to the engine that initiated the event.

The Ack Forward Enable attribute must always be false on engines configured for validated environments, that is, whenever signatures are required when acknowledging events.

The behavior for Ack Forwarding is not well defined when an engine is configured both as a site device and as a BACnet integrated device at the same site. Although an engine can be configured both as a site device and as a BACnet integration device, this configuration is not recommended.

ADS Connection Type

C,N,W

Specifies whether the (defined in the ADS Repository attribute) is connected through a LAN or dial-up connection. If a value is specified, it overrides the value of the Default ADS Connection Type attribute. If no value is specified, the value of the Default ADS Connection Type attribute is used (Default ADS Connection Type is a site level setting sent to the site’s devices). ADS Connection Type is ignored if no is defined for this site.

ADS Delivery Time

C,N,W

Specifies the time of day when a connection should be established to the (determined by the ADS Repository attribute). A connection is attempted at a minimum of once a day at the specified time to deliver audit, alarm, and trend data to the . If a value is specified, it overrides the value of the Default ADS Delivery Time attribute. If no value is specified, the value of the Default ADS Delivery Time attribute is used (Default ADS Delivery Time is a site level setting sent out to the site’s devices). ADS Delivery Time is ignored if no is defined for this site.

ADS Priority Threshold

C,W

Specifies the priority of an event that triggers the engine to connect (dial or LAN connection) to the defined and delivers the event messages from the engine local event repository to the event repository without waiting for the ADS Delivery Time. The ADS Priority Threshold attribute is used for alarm and event management only.

For example, a value of 20 for this attribute means that any event having a priority of 20 or higher (events of higher alarm priority have lower alarm priority numbers) forces a connection to the and forwards event messages from the engine local event repository to the repository of the .

ADS Repository

C,N,W

Specifies the Repository device. This is the computer that receives all audit, alarm, and trend data from a network engine. Repository refers to the three files in the that store this data. If a value is specified, it overrides the value of the Default ADS Repository attribute of the site. If no value is specified, the value of the Default ADS Repository attribute is used (Default ADS Repository is a site level setting sent to the site’s devices). When you save a change to the ADS Repository value, no authentication between the network engine and the is required. This is normal operation.
Note: If the engine uses a dial-up connection to transmit data to the , then the ADS Repository must be the first IP address listed in the range specified when configuring the to Allow Incoming Connections (see External Modem Config section of the Communications tab).
The Default ADS Repository of the Site is intentionally left blank and must be updated by the user (online or offline). If the user does not populate the Default ADS value and leaves the Default ADS Repository value for all devices at 0.0.0.0, the does not receive any audit, alarm, or trend data. The SCT does not automatically populate the Default ADS Repository value because of the many different possibilities that could exist during archive creation, including multiple on a site or no for a site. In these cases, it is not immediately clear which should be the Default under the Site object.
Alarm Repository Size

C,W

Specifies the maximum number of alarms that can be maintained on the local device.
Alarm Snooze Time

C,W

Specifies the amount of time to delay after an operator temporarily ignores, or snoozes an alarm before re-announcing the alarm.

Align Intervals  

Specifies whether clock-aligned periodic time synchronization is enabled. If periodic time synchronization is enabled and the time synchronization interval is a factor of an hour or a day (that is, the value divides without remainder), then the beginning of the period specified for time synchronization aligns to the hour or day, respectively.

APDU Retries

C,W

Indicates the maximum number of times that an Application Layer Protocol Data Unit (APDU) (as specified by the BACnet device) is retransmitted. If the device does not perform retries, it is set to zero. If the value is greater than zero, a nonzero value appears in the APDU Timeout attribute. If you write the value of this attribute, you must reset the engine for the new settings to take effect. Recommended settings: high or medium sensitivity: 4; low sensitivity: 5.

Note: If you change the value of this attribute, you must reset the network engine for the new settings to take effect.
APDU Segment Timeout

C,W

Indicates the amount of time in milliseconds between retransmission of an APDU segment. Recommended settings: high sensitivity: 4000 ms; medium sensitivity: 10000 ms; low sensitivity: 20000 ms.

Note: If you change the value of this attribute, you must reset the network engine for the new settings to take effect.
APDU Timeout

C,W

Indicates the amount of time in milliseconds between retransmissions of an APDU requiring acknowledgment for which no acknowledgment has been received. Recommended settings: high sensitivity: 6000 ms; medium sensitivity: 10000 ms; low sensitivity: 20000 ms.

Note: If you change the value of this attribute, you must reset the network engine for the new settings to take effect.
Appl SW Version  

Identifies the version of the application software installed in the device. The content of this string is locally defined (date-and-time stamp, a programmer’s name, a host file version number, and so on).

Archive Date  

Indicates the date of the last successful archive of object instances. The value of this attribute is valid when a valid archive exists and during the archive download process. The value of this attribute is *.*.*.* at all other times.

Audit Action When Full

C,W

Specifies the operation of the audit trail feature when the audit repository is full. If the value is Stop, additional audit entries are discarded. If the value is Rollover, additional audit entries replace the oldest audit entries.

Audit Generate Alarm When Full

C,W

Specifies whether an alarm is generated when the audit repository is full.
Audit Repository Size

C,W

Specifies the maximum number of audit trail entries that can be maintained on the local device.
Backup And Restore State   Describes the current state of the engine during the BACnet backup or restore process. Possible values include Idle (normal operation), Start, Downloading, Provisioning, Staged, Activation, and Resetting.
Backup Fail Timeout

C,W

Specifies how long in seconds that the engine waits for the BACnet backup or restore process to complete before timing out and ending the process. Default is 120 seconds.
Backup Preparation Time   Specifies how long in seconds that the engine remains unresponsive after starting the BACnet backup procedure and before timing out and ending the process. Value is fixed at 60 seconds.
BACnet Communications Password

C,W

Provides password protection of BACnet services, such as DeviceCommunicationControl and ReinitializeDevice. Third-party workstations may use these services and must provide the password for the engine to execute the services. This attribute is user configurable if the BACnet Site attribute in the Site object is set to True. Specify a value for the BACnet Communication Password (maximum 20 characters) before using any BACnet services. This password is saved in encrypted form within the engine and within the engine's archive in SCT. Third-party workstations cannot read or write this password.

BACnet UDP Port

C,W

Specifies the UDP port number used to communicate with other BACnet devices over the IP network. This value allows multiple BACnet networks on a single IP network and prevents communication between the multiple BACnet networks.

If you write the value of this attribute, you must reset the engine for the new settings to take effect.

Note: If you write the value of this attribute, you must reset the engine for the new settings to take effect.
BIOS Version  

Specifies the BIOS version in the engine. The format of the basic input/output system (BIOS) version is <V><major release>.<minor release>. For example: V2.02. This attribute is present only for NxE engines at Release 9.0 and earlier that use a Windows Embedded operating system. It is blank or does not appear for newer engines.

For NAE55/NIE55, if the BIOS version is earlier than V2.02, update the BIOS using the BIOS Update Utility. This update significantly improves overall product performance. For information on the BIOS Update Utility, refer to the BIOS Update Utility Technical Bulletin (Part No. 24-10110-42).

Configuration Files   Identifies the files within the image of the engine that you can back up.
Database Revision  

Specifies a logical revision number for the device’s database. Database Revision is incremented when an object is created or deleted, an object name changes, or a restore is performed.

Device Object Identifier   Identifies a numeric code assigned to the engine. The identifier must be unique across the entire Metasys network. This attribute appears in the Focus and Configuration tabs.
Dial-up Audit Forwarding Threshold

C,W

Specifies the size limit of the audit repository (as a percent of the audit repository size) at which the network engine attempts to deliver audit entries to the when the engine has a dial-up connection. (For engines connected over a LAN, audit entries are delivered immediately.) This attribute applies only if is configured as the Site Director for the network engine. When this threshold is reached, all audits in the Local Audit Repository that have not been forwarded are forwarded to the defined ADS Repository. The default is 80%, and to ensure good performance, you should not change to a lesser number.

DST Status   Indicates whether daylight saving time is in effect (True) or not (False) at the device’s location.
Duplicate References  

Lists references that are duplicated in the system. Entries in this list are object references that exist on more than one device within the system.

Enable Application Generated Audits

C,W

Enables audits of system commands.
Note: If Display Object Generated Objects is set to true, these audits appear in the audit viewer of the engine or , increasing the number of audits generated.
Enabled Audit Level

C,W

Specifies which level of audit entries are added to the Audit Repository. Only audit entries of type Level 1 through (and including) the specified level are included. All other levels are not stored in the audit trail. Level 1 and Level 2 audit entries are always stored in the audit trail.

• Level 1 and 2 (1): Stores all user action and system error audit messages.

• Level 3 (2): Stores application audit messages in addition to Level 1 and 2 auditing.

• Level 4 (3): Stores system audit messages in addition to Level 3 auditing.

• Level 5 (4): Stores diagnostic audit messages in addition to Level 4 auditing.

Event Action When Full

C,W

Specifies the operation of the Alarm and Event Management feature when the event repository is full. If the value is Stop, additional event entries are discarded. If the value is Rollover, additional event entries replace the oldest event entries.

Firmware Version  

Represents the release of firmware installed in the main code section of the device. The first digit in the revision number is advanced on major releases. The second digit is advanced on minor releases. This attribute is in contrast to the Staged Firmware Version attribute, which indicates the engine's firmware version that is currently staged in the engine.

IEIEJ Function A List

C,W

Provides a list of structures with the following elements: Network Number, Device ID High Limit, and Device ID Low Limit. The first set of Who-Is messages is broadcast once the device reaches the Enable Field Commands phase of startup. At this time, a timer starts running that calls a method to send the Who-Is messages at the period specified by IEIEJ Function A Period.

IEIEJ Function A Period

C,W

Sets the period at which the IEIEJ Function A List sends the Who-Is message broadcasts. Clearing the value of this property disables the function A feature. Each destination is guaranteed to get a Who-Is message within the period specified by this property; however, if the list contains multiple destinations, the object attempts to spread out the Who-Is messages so that they are not all sent out at the same instant.

Internode Comm Timer

C,W

Controls the frequency of communication with remote Ethernet devices. This value is used by the Ethernet IP Datalink object. Among other communications, this attribute defines the frequency of the heartbeat to monitored devices (monitored at a rate of two times the Internode Comm Timer). Recommended settings: high sensitivity: 20 seconds; medium sensitivity: 120 seconds; low sensitivity: 240 seconds.

Note: If you change the value of this attribute, you must reset the network engine for the new settings to take effect.
Interval Offset

C,W

Specifies the offset, in minutes, from the beginning of the period defined for time synchronization until the actual time synchronization requests are set. Interval Offset has no effect when Align Intervals is False.

Is Validated

C

Enables the MVE feature at the engine, which includes re-authentication with electronic signature and required annotation when the user makes a change to the system, such as commanding an object, acknowledging an alarm, or changing the value of an attribute. This attribute can be set to True for MVE sites only. This attribute is writable only with the SCT and JCT, and is read-only online.

JCI Exception Schedule

C,W

Indicates how long exception schedules are kept after the exception date has expired. The default value is Auto Delete 31 days, which is the same behavior prior to this release. New options are Auto Delete 7 days and Manual Delete.

Note: The engine (using SCT, JCT, Metasys UI, or SMP) and FAC (at CCT) allows selections for Manual Delete, Auto Delete 31 days, and Auto Delete 7 days.
Note: Manual Delete is needed for locations like Japan where the local standards state that only the BACnet workstation can delete exception schedules.
Last Restart Reason  
Indicates the reasons for the last device restart. The possible reasons are:
  • UNKNOWN: The device cannot determine the cause of the last reset. This may occur due to a startup error, shutdown error, crash, or pushing the hardware reset button. The state is UNKNOWN if the device is powered without the battery or if the Device Manager service is stopped.
  • COLDSTART: A ReinitializeDevice request was received with a Reinitialized State of Device of COLDSTART or the device was made to COLDSTART through the user interface.
  • WARMSTART: A ReinitializeDevice request was received with a Reinitialized State of Device of WARMSTART or the device was made to WARMSTART by some other means. WARMSTART also occurs after a download from SCT.
  • DETECTED_POWER_LOST: The device detected that incoming power was lost. This state occurs as the result of a normal power down (with battery).
  • DETECTED_POWERED_OFF: The device detected that its power switch was turned off.
  • HARDWARE_WATCHDOG: The hardware watchdog timer reset the device.
  • SOFTWARE_WATCHDOG: The software watchdog timer reset the device. This state is reported when Device Manager cannot communicate with the control engine for any reason.
  • SUSPENDED: The device was suspended. How the device was suspended or what it means to be suspended is a local matter.
Last Restore Time   The time at which the engine was last restored. Clicking the down arrow exposes date and time details.
Local Date  

Indicates the date to the best of the device’s knowledge. The Date type is a series of four one-number elements.

The first number is the year (for example, 2005); the second number is the month (1..12, 1=January); the third is the day of month (1..31). To maintain compatibility with BACnet protocol, a fourth number contains the day of week (1=Monday). A value of FF * (asterisk) in any of the elements indicates the value is not specified.

Local Site Director

C,W

Specifies a resolvable host name or IP address of the Site Director. A host name may be specified only if a DNS server or other means of name resolution is available to the device. A Site Director may have more than one host name. The host name specified here must be resolvable to an IP address on the LAN or WAN on which the site’s devices exist.

The Local Site Director attribute is based on the Computer Name attribute, not the Name attribute. When you change the Site Director device’s Computer Name attribute, its Local Site Director attribute automatically changes to match its Computer Name. When you change a non-Site Director device’s Computer Name, its Local Site Director attribute remains unchanged.

Note: When you promote or demote a Site Director online in SMP, you may be prompted for the user credentials of the Site Director you specified. Enter these user credentials for validation before the promotion or demotion is permitted.

For information designating an engine as the Site Director, refer to the NAE Commissioning Guide (LIT-1201519) .

Local Time  

Indicates the time of day to the best of the device’s knowledge. The Time type is a series of four one-number elements. The first number is the hour (0..23); the second number is the minute (0..59); and the third number is the seconds (0..59). A fourth number has been added to maintain compatibility with BACnet protocol and contains the hundredths of second (0..99). A value of * (asterisk) for any number indicates the value is unspecified. This value would be used, for example, when the hundredths value is not important.

Location

C,W

Indicates the physical location of the device.
Max APDU Length

C

Indicates the maximum number of bytes that may be contained in a single, indivisible application layer protocol data unit.

Max Message Buffer

C,W

Specifies the largest piece of data that can be sent to a device at one time, excluding all communications headers. Some applications need to perform segmentation of data outside the communications system. This value is used to size the data in those situations.

Max Segments Accepted   Indicates the maximum number of segments of an APDU accepted by the device.
Model Name  

Indicates the device model, the hardware revision associated with the firmware, and the code file name used to download the device.

Network Address

C,W

Specifies the BACnet network address. A change to this attribute takes effect after the next engine restart (cold or warm). If you write the value of this attribute, you must reset the engine for the new settings to take effect.

Note: If you write the value of this attribute, you must reset the engine for the new settings to take effect.

OS Version

 

Indicates the version number of the operating system in use by the engine. This attribute is present only for engines that are running the Linux operating system.

Patch Configuration

C, W, A

A new attribute introduced in Metasys Release 13.0 that provides a mechanism to add and configure new attributes for future patch releases if required. It consists of two columns: Code and Details.

The Code column is used for indexing and identifying the new feature/attribute being added.

The Details column contains the parameters that are required for configuring the new feature. A total 50 codes can be used at a patch release with a range from, Code 0 to Code 49. At the next major Metasys release, new attributes will be introduced to replace the patch codes.

Note: For example, as part of a patch release of Metasys 13.0, the ability to set the watchdog timeout and the LON Recovery mechanism is provided. The functionality to set the watchdog timeout is assigned to "Code 0" with a string format of "timeout=x", while “Code 1” is assigned to enable the LON Recovery mechanism with a string format of "Enabled = True ", both of which are documented as part of patch release. In the field, an engine/server can be upgraded to the patch release using MUI/SMP/SCT.
Power Consecutive Sample

C,W

Specifies the number of consecutive AC line status samples (indicate a power loss) must be received before the device concludes that a power failure has occurred. When the device concludes that power has failed, the device begins an orderly shutdown process. The process used for determining whether a power failure has occurred protects the device from shutting down during short power failures or certain brownout conditions. Using default values, a power failure of less than 5 seconds does not prompt a device shutdown.

Note: If you change the Power Consecutive Sample value on a network engine with Metasys Release 9.0.7 firmware, you must restart the engine before the new setting takes effect. A restart is not necessary for engines that are running a different releases.
Power Sampling Interval

C,W

Specifies the period at which the AC line status is sampled to determine whether a power failure has occurred. This attribute is used in conjunction with the Power Consecutive Samples attribute.

Note: If you change the Power Sampling Interval value on a network engine with Metasys Release 9.0.7 firmware, you must restart the engine before the new setting takes effect. A restart is not necessary for engines that are running a different release.

Process ID List

C,W

Contains a list of unsigned 32-bit numbers used to compare the Process ID sent with the BACnet events. If the event Process ID is not found on this list, then the event is ignored. An empty list or a list containing only one entry with the value of zero allows all events to be processed.

Process Unmapped Objects Alarms   Specifies whether the engine should process alarms that originate from unmapped objects. This attribute applies only to the ODS and is fixed at False for all other devices.
Protocol Obj Support  

Indicates which standard BACnet object types the device’s protocol implementation supports.

This attribute is a bit string that uses the Object Type (Set 508). Each bit represents a BACnet object type in that set. For example, bit 0 represents the BACnet AI object type, whereas bit 17 represents the BACnet schedule object type. If the bit is true (1), the object type is supported. If the bit is false (0), the object type is not supported. The BACnet object types supported can vary between device models.

Protocol Revision   Indicates the minor revision level of the BACnet standard the device supports.
Protocol Ser Support  

Indicates which standard BACnet protocol services the device’s protocol implementation supports. For more information on the Protocol Implementation Conformance Statement (PICS) and BACnet Interoperability Building Blocks (BIBBs) of the engine. This object now supports both the BACnet UTCTimeSynchronization message and the BACnet TimeSynchronization message (non-UTC version). Third-party devices now have the ability to send the TimeSynchronization message to an engine.

This attribute is a bit string that uses the Protocol Ser Support (Set 136). Each bit represents a BACnet service in that set. For example, bit 0 represents the Acknowledge Alarm service, whereas bit 12 represents the Read Property service. If the bit is true (1), the service is supported. If the bit is false (0), the service is not supported.

Protocol Version  

Represents the BACnet protocol the device supports. Initial releases are Version 1; subsequent releases increase the number by one.

Restart Notification Recipients

C,W

Controls the restrictions on which devices, if any, are notified when a restart occurs. The value of this attribute is a list of BACnetRecipients. When the length of this list is empty, the device cannot send a device restart notification.

The default value of this property is a single entry representing a broadcast on the local network. If the list has one or more entry, the device sends a restart notification, but only to the devices or addresses listed.

Restore Preparation Time  

Specifies how long in seconds that the engine remains unresponsive after starting the BACnet restore procedure and before timing out and stopping the process. Value is fixed at 60 seconds.

Restore Completion Time  

Specifies how long in seconds that the engine remains unresponsive after ending the BACnet restore procedure and before timing out and stopping the process. Value is fixed at 600 seconds.

Segmentation  

Indicates if the device supports segmentation of messages and (if so) if it supports segmented transmission, reception, or both.

Site Director Online  

Indicates the communication status of this device with the Site Director. This value is kept current by a command sent by the Data Refresh COV Monitor task whenever the status changes. The COV Monitor task performs this check every 80 seconds. This attribute is triggered so it can be used for an alarm.

Staged Files  

List of staged files that are set for activation at a later time. For example, if the code and archive database are set for later activation, this field would read Code, Archive Database. If this attribute is empty, no files are currently staged. Possible values: Code, Archive Database, Security Database, HTTPS Certificates.

Staged Firmware Version

D

Indicates the engine firmware version that is staged for later activation. If this field is empty, no firmware files are currently staged. This attribute is in contrast to the Firmware Version attribute, which indicates the engine's firmware version that is currently active.

System Status

D

Reflects the current physical and logical state of the device.
Time of Device Restart   Indicates the time at which the device was restarted.
Time Synchronization Interval

C,W

Specifies the periodic interval, in minutes, at which TimeSynchronization and UTCTimeSynchronization requests are sent. When set to zero, then periodic time synchronization is disabled.

Time Zone

C,W

The current time zone in use at the location of the engine.

Unbound References  

Lists references that are not bound in the system. This attribute indicates that a process cannot find an object either because the device on which the object is located is offline, the object has been deleted, or the object reference is incorrect.

USB Port 1 Enabled

C,W

Specifies whether USB Port 1 on the SNE or SNC network engine is enabled. This attribute applies only to the SNE and SNC models. For enhanced security, the USB port is set to Disabled by default. Before using the USB port, change this attribute to Enabled.

USB Port 2 Enabled

C,W

Specifies whether USB Port 2 on the SNE or SNC network engine is enabled. This attribute applies only to the SNE and SNC models. For enhanced security, the USB port is set to Disabled by default. Before using the USB port, change this attribute to Enabled.

External LAN

C

Specifies whether External LAN is enabled with either a USB 1 or USB 2 value based on its physical connection.

You can change the configurations of the USB to Ethernet adapter in an offline database using USB Control and External LAN attributes.

UTC Time Synchronization Recipients

C,W

Lists one or more BACnet recipients to which the engine can issue a UTC Time Synchronization request. If the list is empty, the engine cannot send a UTC Time Synchronization request to a BACnet recipient. The attribute requires the following parameters that define each recipient: ID (Device ID), Address (IP Address, Network Number, UDP Port), and Broadcast (Broadcast Type, Network Number, UDP Port). Three broadcast types are available: local, remote, and global.

Vendor ID  

Distinguishes proprietary extensions to the protocol using a unique vendor identification code assigned by ASHRAE. The Johnson Controls Vendor ID is 5.

Vendor Name   Identifies the manufacturer of the device.

Version

 

Indicates the version number of the firmware image in the engine.

Note: The Communications tab is only present for older network engines that have gray exteriors. The tab has three different configurations: Serial Port Cable Config, Internal Modem Config, and External Modem Config. Each configuration has the same set of attributes that are described in this table.
Table 2. Engine device object attributes - Communications Tab

Attribute name

Flags

Initial value

Values/options/range

Allow Incoming Connections

C,W

True Whether the communications port is enabled to accept an incoming call from another device.
Baud Rate

C,W

115200 The configured baud rate set for the communications port.
Enabled

C,W

True Whether the communications port is enabled to initiate a call to another device.
Extra Initialization Commands

C,W

  An optional list of modem initialization commands, such as characters and symbols, necessary to establish a reliable connection.
Maximum Baud Rate

C,W

115200 The maximum configured baud rate set for the communications port.
Wait for Dial Tone Before Dialing

C,W

False Whether the network engine should wait for the dial tone before attempting to place a call.
Table 3. Engine device object attributes - Network tab

Attribute Name

Flags

Initial Value

Values/Options/Range

Allow Http

C,W

True

Available at network engines at Release 8.1 or later. It determines whether the operating system firewall in the network engine blocks incoming traffic over the HTTP port (port 80). If the attribute is set to True, all incoming traffic over port 80 at the network engine is allowed; if set to False, all incoming traffic over port 80 at the network engine is blocked. Changing this attribute does not interfere with NAE Update Tool operations.

You can set this attribute independently on each network engine, and can modify it using a schedule or other control action. You can configure a tailored summary to view the value of the attribute on all network engines at the site. You can also use the mass editing capability in SCT to modify the attribute across multiple devices.

To provide the highest level of security, it is recommended that you set this attribute to False. However, if the network engine is a Site Director and has one or more child engines reporting to it that have not been upgraded to Release 8.1 or later, set the attribute to True. For a list of the tools and utilities that require port 80, refer to the Allow Http section of the NAE Commissioning Guide (LIT-1201519).

Completion Domains

C,W

 

Specifies a domain name that is appended to the computer name of a network engine to help the engine broadcast over the building network. For example, if you specify a completion name of mycorp.com and the name of the network engine is NAE-1, the engine is identified on the network as NAE-1.mycorp.com. Use this attribute for network engines that have difficulty communicating with their site director.

If DHCP is enabled on the engine, the DHCP server populates the list of completion domains automatically. In this case, if you manually delete a domain from the list, it is readded when you save the change.

Note: Depending on the model of the network engine, the full list of configured completion domains may not appear under the drop-down box in View mode. In this case, switch to Edit mode to view the full list of completion domains.
Computer Name

C,W

 

Identifies the network engine to the Metasys network. Changing the Computer Name online breaks any existing references between the NAE object and other objects on the site, and may break the existing network connection to other devices on the network. We do not recommend changing the Computer Name online. Instead, change the Computer Name attribute offline with the SCT by right-clicking the NAE in the navigation tree and selecting Rename. Both the Computer Name and Name attributes are changed to the new name you select. The Item Reference then updates to show the new Computer Name.

Notes:

  • If you change the value of this attribute, a confirmation message appears informing you that the Engine must be reset before the new name can be applied.
  • The Computer Name must not consist of all numbers. For example, a computer name of N1234 is acceptable but 1234 is not.
DHCP Enabled

C,W

True

True = DHCP enabled; network engine requests IP address from DCHP server; if no server is present, APIPA addressing is used.

False = DHCP disabled; network engine uses a static IP address.

DNS Server IP Addresses

C,W

 

List of IP addresses.

Domain Name

C,W

 
Note: If you change the value of this attribute, the Engine automatically resets.

Ethernet 1 Speed

   

The current connection speed of the network engine on the first Ethernet port. Only SNC and SNE engines have this attribute. The attribute shows Not Connected if no connection is present.

Ethernet 2 Speed

   

The current connection speed of the network engine on the second Ethernet port. Only the SNC has two Ethernet ports and therefore has this attribute. The attribute shows Not Connected if no connection is present.

Ethernet MAC Address    

The MAC address of the network engine.

JCI IP Address

C,W

 

The currently assigned IP address of the network engine.

IP Mask

C,W

  The currently assigned IP mask of the network engine.
IP Router Address

C,W

  The currently assigned IP router that the network engine is using.
Obtain DNS Address Automatically

C,W

True (1)

Whether the DNS IP address is populated automatically.

External Ethernet MAC Address

C,W

00:00:00:00:00:00

The External Ethernet MAC address of the network engine.

External DHCP Enabled

C

False

True = External DHCP enabled; network engine requests IP address from DCHP server; if no server is present, APIPA addressing is used.

False = DHCP disabled; network engine uses a static IP address.

External JCI IP Address

C, W

0

The currently assigned External IP address of the network engine.

External IP Mask

C, W

0

The currently assigned External IP mask of the network engine.

External Obtain DNS address automatically

C

False

Whether the External DNS IP address is populated automatically.

External DNS server IP addresses

C

 

List of External DNS server IP addresses.

Routing Mode

C,W

Disabled The current state of the BACnet routing mode. Options are Disabled, Enabled, Enabled Without Broadcast.
IP Communication Mode    

The type of BACnet communication the device will use.

The options are Secure Connect Only Mode, Ethernet IP Only Mode, and Dual SC and IP Mode

Operational Certificate Satus     Displays information about the Operational Certificate that is used for BACnet Secure Connect communication. You can also obtain this information in the BACnet Management Dashboard in JCT or MUI.
Table 4. Engine device object attributes - Hardware tab

Attribute Name

Flags

Initial Value

Values/Options/Range

Note: The Hardware tab is present only for SNC network engines.

Application Class Set Version

 

64

Indicates the version of the application class set for the SNC.

Control Sequence In Test

C,W

0

Indicates the number assigned to the control sequence in testing mode.

Controller Number

 

999

Indicates the unique address of the field controller as set by the rotary switch block on the engine.

Device Model Class Set Version

 

65

Indicates the version of the device model class set for the SNC.

Pcode

 

Indicates the product code number of the SNC (for example, M4-SNC25150-0).

Startup OFF State Auto Release Time

C,W

0

Indicates the amount of time a BO is held in the OFF state at the priority set by the Startup OFF State Command Priority setting at field controller startup. This instance only applies to BO objects that have their Startup OFF State Enable parameter set to TRUE.

The default value is 0. A value of 0 disables this parameter. The range is 0 to 3600 seconds.

Startup OFF State Command Priority

C,W

9

Indicates the priority at which a BO is held in the OFF state for the Startup OFF State Auto Release Time at field controller startup. This instance only applies to BO objects that have their Startup OFF State Enable parameter set to TRUE.

The default value is 9. Priority 6 is not a valid selection. The range is 1 to 16.