Virtual Units - Polling Regime Data Types

Unit<x>.PollPeriod

LONG

Adjust the Polling Period

No Object

R/W.

If the Citect.ini parameter 'EnablePollPeriodWrites' is set to TRUE (1), then this tag can be used to adjust the Event Polling Period.

This tag can be used to display the current Event Polling Period regardless of the state of 'EnablePollPeriodWrites'.

This address does not relate to I/O data internal to the device, but relates to data internal to the driver, or an action to be performed by the driver.

Unit<x>.EnablePoll

INTEGER

Returns if Polling enabled for reads

No Object

R/W.

Returns if the unit has enabled polling. A write of '0' will turn polling off, '1' will re-enable polling.

Note: The driver schedules regular integrity/event poll intervals from the time the unit comes online. When the polling is re-enabled, the next integrity/event poll executes at the next regular poll time.

For example, if the unit EventPollPeriod is set to 60 sec and the unit comes online at 1.00.00 AM, the polls schedule at 1.01.00, 1.02.00, etc. If the polling gets disabled at 1.00.30 and re-enabled at 1.00.45, the next poll happens at 1.01.00, but if polling gets disabled at 1.01.20, the next polling happens at 1.02.00.

This address does not relate to I/O data internal to the device, but relates to data internal to the driver, or an action to be performed by the driver.

Unit<x>.ForceIntegrityPoll

DIGITAL

Force an integrity poll

Object 60 Variation 1

Object 60 Variation 2

Object 60 Variation 3

Object 60 Variation 4

W/O.

Writing a '1' to this tag forces the driver to execute an Integrity poll of the device (in addition to the routine polling that it automatically undertakes).

Note: When the forced integrity poll is completed, the driver checks the next scheduled regular integrity/event poll time. If the time until the next scheduled poll time is less than 33% of the unit EventPollPeriod, the driver increases the next scheduled integrity/event poll time by the EventPollPeriod value.

This address does not relate to I/O data internal to the device, but relates to data internal to the driver, or an action to be performed by the driver.

Unit<x>.ForceEventPoll

DIGITAL

Force an integrity poll

Object 60 Variation 2

Object 60 Variation 3

Object 60 Variation 4

W/O.

Writing a '1' to this tag will force the driver to execute an Event poll of the device (in addition to the routine polling that it automatically undertakes).

This address does not relate to I/O data internal to the device, but relates to data internal to the driver, or an action to be performed by the driver.

Unit<x>.TimeToNextPoll

LONG

Time to go to next Integrity poll

No Object

R/O Seconds.

Will count down from the set Integrity poll time, and may become negative if the Integrity poll has been delayed.

This address does not relate to I/O data internal to the device, but relates to data internal to the driver, or an action to be performed by the driver.

Unit<x>
.TimeToNextClass1Poll

LONG

Time to go to next class 1 poll

No Object

R/O Seconds.

Will count down from the set class 1 poll time and may become negative if the class 1 poll has been delayed. This address does not relate to I/O data internal to the device, but relates to data internal to the driver, or an action to be performed by the driver.

Unit<x>
.TimeToNextClass2Poll

LONG

Time to go to next class 1 poll

No Object

R/O Seconds.

Will count down from the set class 2 poll time and may become negative if the class 2 poll has been delayed.

This address does not relate to I/O data internal to the device, but relates to data internal to the driver, or an action to be performed by the driver.

Unit<x>
.TimeToNextClass3Poll

LONG

Time to go to next class 1 poll

No Object

R/O Seconds.

Will count down from the set class 3 poll time and may become negative if the class 3 poll has been delayed.

This address does not relate to I/O data internal to the device, but relates to data internal to the driver, or an action to be performed by the driver.

Unit<x>.Polls

INTEGER

Count of successful polls (Forced and periodic).

No Object

R/W.

Count of successful Integrity, Event, class 1, class 2 and class 3 polls of the device. Write '1' to reset counter.

This address does not relate to I/O data internal to the device, but relates to data internal to the driver, or an action to be performed by the driver.

Unit<x>.FailedPolls

INTEGER

Count of unsuccessful polls (Forced and periodic).

No Object

R/W.

Count of unsuccessful Integrity, Event, class 1, class 2 and class 3 polls of the device (i.e. incomplete full timeout sequence). Write '1' to reset counter.

This address does not relate to I/O data internal to the device, but relates to data internal to the driver, or an action to be performed by the driver.

Note that this counter is incremented only after the poll message and the following retry requests have timed out. The number of retry requests is configured using the "Retry" parameter.

Unit<x>.Ipolls

INTEGER

Count of successful Integrity polls (Forced and periodic).

No Object

R/W.

Count of successful Integrity polls of the device. Write '1' to reset counter.

This address does not relate to I/O data internal to the device, but relates to data internal to the driver, or an action to be performed by the driver.

Unit<x>.FailedIPolls

INTEGER

Count of unsuccessful integrity polls (Forced and periodic).

No Object

R/W.

Count of unsuccessful Integrity polls of the device (i.e. failure of full timeout sequence). Write '1' to reset counter.

This address does not relate to I/O data internal to the device, but relates to data internal to the driver, or an action to be performed by the driver.

Note that this counter is incremented only after the poll message and the following retry requests have timed out. The number of retry requests is configured using the "Retry" parameter.

Unit<x>.Epolls

INTEGER

Count of successful Event polls (Forced and periodic).

No Object

R/W.

Count of successful Event polls of the device. Write '1' to reset counter.

This address does not relate to I/O data internal to the device, but relates to data internal to the driver, or an action to be performed by the driver.

Unit<x>.FailedEpolls

INTEGER

Count of unsuccessful Event polls (Forced and periodic).

No Object

R/W.

Count of unsuccessful Event polls of the device (i.e. failure of full timeout sequence). Write '1' to reset counter.

This address does not relate to I/O data internal to the device, but relates to data internal to the driver, or an action to be performed by the driver.

Note that this counter is incremented only after the poll message and the following retry requests have timed out. The number of retry requests is configured using the "Retry" parameter.

Unit<x>.UnsolicitedRxd

INTEGER

Count of Unsoliciteds received.

No Object

R/W

Count of valid Unsolicited Responses received by the device. Write '1' to reset counter.

This address does not relate to I/O data internal to the device, but relates to data internal to the driver, or an action to be performed by the driver.

Unit<x>
.RequestEventRefresh

INTEGER

Force Event Refresh for device

No Object

R/W.

Writing 1 will cause the unit to refresh all event data the next integrity poll. A read reads this state.

Note: This value will be set if [DNPR]RefreshEventsOnStartup=1 was set.

This address does not relate to I/O data internal to the device, but relates to data internal to the driver, or an action to be performed by the driver.

Unit<x>.RTUEvents

LONG

RTU Events received

No Object

R/O.

RTU events PER PORT received from the field device.

This address does not relate to I/O data internal to the device, but relates to data internal to the driver, or an action to be performed by the driver.