Master.BinaryCounterGetFromPointNum (METH)¶
METHOD BinaryCounterGetFromPointNum : Error
Get the value of Binary Counter datapoint (DNP3 object group 20 “counters”) with given point number (0 .. MaxPointNum). Returns PointNotExistent, if a datapoint with the given point number doesnt exist, OK otherwise.
- InOut:
Scope
Name
Type
Comment
Return
BinaryCounterGetFromPointNumInput
pointNumberUINTPoint number.
Output
valueUDINTValue
flagsUSINT- Flags. Flag values are OR’d
- combinations of the following:
- DNPDEFS_DBAS_FLAG_ON_LINE - the point has been read
successfully
- DNPDEFS_DBAS_FLAG_RESTART - the field device that originated the
data object has been restarted. This device may be the deviced reporting this data object.
- DNPDEFS_DBAS_FLAG_COMM_LOST - the device reporting this data object
has lost communication with the originator of the data object
- DNPDEFS_DBAS_FLAG_REMOTE_FORCED - the state of the binary object
has been forced to its current state at the originating device
- DNPDEFS_DBAS_FLAG_LOCAL_FORCED - the state of the binary object
has been forced to its current state at the device reporting this data object
- DNPDEFS_DBAS_FLAG_CNTR_ROLLOVER - the accumulated value has exceeded
has exceeded its maximum and rolled over to zero. NOTE: This maximum value is not necessarily equal to (2^32-1) for 32 bit counters or (2^16-1) for 16 bit counters. It can be different for each counter instance. Technical Bulletin TB-2002-001 Counter Objects recommends “[Outstation] devices do not set the Rollover flag and that host(Master) devices ignore the Rollover flag”.
hasTimeStampBOOLHas a valid time stamp.
timeStampLDATE_AND_TIMETime stamp reported - valid if hasTimeStamp = TRUE, invalid otherwise.