About the ADR Device

The ADR Device represents the connection to the target DRAS server through a unique participant account. Unlike most other drivers, the AdrDevice maps to a client configured in DRAS server. All devices under an AdrNetwork connect to the DRAS server with the REST URL configured in the device’s property sheet, as shown in Figure 7.

Figure 7. New AdrDevice configuration

Rest Url specifies the DRAS server connection to be used by this client.

As the “device-level” component in the ADR driver architecture, it is similar to most driver’s device components— see “Common network components” in the NiagaraAX Drivers Guide for general information.

The following ADR properties are available in the AdrDevice property sheet view:

Status

Status of connection to the target DRAS server with the configured client account. Possible status flags include:
- ok
  
  Normal communications, no other status flags
- disabled
  
  Enabled property is set to false, either directly or in the ADR Network. While disabled, polling stops.
- down
  
  Error communicating to the target server. If status was previously ok (without changing account configuration), this may mean the target 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 ADR Network. See Status disabled description above.
Fault Cause

This will be empty if the device is healthy. Otherwise, if status has fault, describes the cause.
Health

Contains properties describing the health of the device.
- Down
  
  True if device is down, false otherwise.
- Alarm
  
  True if device is in alarm state, false otherwise
- Last Ok Time
  
  A display-only value indicating when the device was last healthy.
- Last Fail Time
  
  A display-only value indicating when the device last failed
- Last Fail Cause
  
  A string property describing the cause for the last failure.
Alarm Source Info

Alarm source info under the ADR device has no significance in this driver.
Rest Url

HTTPs URL of the target DRAS server.
If the target server uses other than the standard HTTPs port number (port 443), then the port number must be included in the URL. For example, if the target server uses port 500, Rest Url should be: https:500//TargetServer.com/etc.)
User Name

User name for a unique client account configured in DRAS server.
Password

Password for the client account configured in DRAS Server.
Poll Frequency

Rate at which device sends a POLL request to the DRAS server to receive the event information. Configure the Normal, Slow, Fast poll frequencies in the ADR network’s poll scheduler as required.
Active Event

This value indicates the event in process. At any point in time, there is only one active event. The type of event information is determined by the DR program. Possible values are listed below:
- PRICE_ABSOLUTE
  
  Indicates price number, for example $0.25.
- PRICE_RELATIVE
  
  Indicates change in price, for example $-0.05.
- PRICE_MULTIPLE
  
  Indicates multiple of current price, for example 1.5
- LOAD_LEVEL
  
  Indicates amount of load based on an enumeration, for example moderate, high, etc.
- LOAD_AMOUNT
  
  Indicates fixed amount of load shed, for example 5 MW.
- LOAD_PERCENT
  
  Indicates percentage of load shed, for example 10%.
- LOAD_RELIABILITY
  
  A number signifying the reliability of the grid.
The event information shown above along with the operation Mode value [Op Mode Value] are modeled as control points under the active event. An event information point with the value “null” indicates that the active event does not carry information for that point.
Programs

This value indicates DR programs associated with the client account configured on the DRAS server
Last Poll Time

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

A comma separated string represinting the event information (Load/Pricing) belonging to active event. If there are no active events under the device, thi slot will be empty.
Achknowledgement URL

Each DR event received by the client must be acknowledged. The “restConfirm” interface is used as the Acknowledgement Url although communication to the DRAS server is primarily through the “rest2” interface. The Acknowledgement Url is set to a default value that is in accordance with the Rest Url slot. If required, you can edit the Acknowledgement Url. If the event is correctly acknowledged, the “Event confirmation” slot under Adr Event will read “SUCCESS”.
Enable Cache

A Boolean slot, this must be enabled if the event op mode schedules/event info instances are to be saved under the event component. When set to true, the schedule informatoin will be stored under the corresponding DR event component.
This cached information is used to update the “Active Event” slot when the device is down provided the “Work On Cache Enabled” property in the AdrNetwork is set to true.