About the DRAS Device

The DRAS device represents the client connection to DRAS server through a participant account. Unlike most other drivers, the DRAS device maps to a participant configured in DRAS server. All the devices under the DRAS network connect to the DRAS server with the REST URL configured in the network’s property sheet. As the “device-level” component in the DRAS driver architecture, it is similar to most driver’s device components— see “Common device components” in the NiagaraAX Drivers Guide for general information.

The following DRAS properties are available in the DrasDevice property sheet view:

• Status

  Status of connection to the DRAS server with the configured participant account. Possible status flags include:

  • ok

    Normal communications, no other status flags

  • disabled

    Enabled property is set to false, either directly or in DRAS Network. While status is disabled, while disabled ideally no subscription notification should happen.

  • Fault

    Typically, this a licensing issue.

  • down

    Error communicating to the DRAS server. If status was previously ok (without changing Participant account configuration), this may mean the server host is now unreachable, or the server program is not running.

• Enabled

  Either true (default) or false. Can be set directly or in parent DRAS Network. See Status disabled description above.

• Health

  Contains properties including timestamps of last “ok” time and last “fail” time, plus a string property describing last fail cause.

• Fault Cause

  If status has fault, describes the cause.

• Alarm Source Info

  Alarm source info under the DRAS device has no significance in this driver.

• User Name

  This is the user name of the participant account configured in DRAS server.

• Password

  This is the password of the participant account configured in DRAS Server. The DRAS device connects to DRAS server with this user name and password.

• Poll Frequency

  As per the poll frequency, the DRAS device sends a POLL request to the DRAS server to receive the event information. Configure the Normal, Slow, Fast poll frequencies in the DRAS network’s poll scheduler as required.

• Last Poll Time

  This display-only value indicates the time the last poll was made.

• Poll Wait Count

  This value indicates how many times the poll method can wait for the “Dras Server connection Timeout” to expire before the DrasDevice status is changed to “down”.

• Event Status

  This field represents the current event status of the DR Event received from the server. This can take one of the following values: NONE, FAR, NEAR, ACTIVE. These values are configurable on the DRAS.

• Operation Mode Value

  This field represents the current operation mode value of the DR event received from the server. This can take one of the following values: NORMAL, HIGH, MODERATE, SPECIAL. These values are configurable on the DRAS.