Polling Regime Data Types
- Last UpdatedAug 04, 2025
- 7 minute read
Note: The following data types are only recommended for experienced users who are familiar with the terminology and methods associated with the DNP 3.0 protocol.
|
Address |
Plant SCADA Type |
DNP3 Type |
Description |
|---|---|---|---|
|
PollPeriod |
LONG |
Adjust the Polling Period
|
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. |
|
EnablePoll |
INTEGER |
Returns if Polling enabled for reads No Object |
R/W Returns if the unit has polling enabled.A write of ‘0’ will turn polling off, ‘1’ will re-enable polling. 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. |
|
ReinitPollSequence |
DIGITAL |
Force the re-initialization of the Polls sequence. No Object |
W/O Writing a ‘1’ to this tag will force the driver to re-initialize the poll sequence of all devices. The poll sequence will restart from the Integrity poll when this command is received. 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. |
|
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 will force the driver to execute an Integrity 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. |
|
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. |
|
ForceClass1Poll |
DIGITAL |
Force an integrity poll Object 60 Variation 2 |
W/O. Writing a ‘1’ to this tag will force the driver to execute a poll for class 1 data from the device (in addition to the routine polling that it automatically undertakes). |
|
ForceClass2Poll |
DIGITAL |
Force an integrity poll Object 60 Variation 3 |
W/O. Writing a ‘1’ to this tag will force the driver to execute a poll for class 2 data from the device (in addition to the routine polling that it automatically undertakes). |
|
ForceClass3Poll |
DIGITAL |
Force an integrity poll Object 60 Variation 4 |
W/O. Writing a ‘1’ to this tag will force the driver to execute a poll for class 2 data from the device (in addition to the routine polling that it automatically undertakes). |
|
DisableUnsolicited |
DIGITAL |
Disable all Unsoliciteds Object 60 Variation 2 Object 60 Variation 3 Object 60 Variation 4 |
W/O. Writing a ‘1’ to this tag will instruct the unit not to broadcast any more unsolicited responses. It is W/O, as there is no way of determining if unsoliciteds were disabled before Plant SCADA startup. 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: This a Level 3 feature. |
|
EnableUnsolicited |
DIGITAL |
Enable all Unsoliciteds Object 60 Variation 2 Object 60 Variation 3 Object 60 Variation 4 |
W/O. Writing a ‘1’ to this tag will allow the unit to broadcast unsolicited responses. The Classes enabled are determined by the INI parameter [DNPR]AutoUnsolicitedEnableDefault or [<unit>] AutoUnsolicitedEnable. It is W/O, as there is no way of determining if unsoliciteds were enabled before Plant SCADA startup. 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: This a Level 3 feature. |
|
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 go –ve 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. |
|
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 go –ve 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. |
|
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 go –ve 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. |
|
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 go –ve 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. |
|
Polls |
INTEGER |
Count of all 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. |
|
FailedPolls |
INTEGER |
Count of all 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 (ie 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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
LateRefresh |
DIGITAL |
Late cache refresh for device No Object |
R/O Indicates when a device poll has been delayed, resulting in a late cache refresh.Refer to Citect.ini parameter DataLag for further details. 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. |
|
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 the [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. |
|
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. |
|
RTUStatus |
DIGITAL |
RTU Online status No Object |
R/O Internal online status of a unit. Of limited use as a tag on a unit as if the unit was offline, you could not read the tag anyway. This tag has been superceded by the UnitActiveState.X tags. 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. |
where:
-
n = Point index number (range from 0 to 2048)
-
R/O = read only
-
W/O = write only
-
R/W = read or write