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

BinaryCounterGetFromPointNum

Error

Input

pointNumber

UINT

Point number.

Output

value

UDINT

Value

flags

USINT

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”.

hasTimeStamp

BOOL

Has a valid time stamp.

timeStamp

LDATE_AND_TIME

Time stamp reported - valid if hasTimeStamp = TRUE, invalid otherwise.