[R_BG] Read binary group

Function block R_BG links a group manager object that controls the continuous acquisition of group data (present value/status flag pairs) from multiple data points for a specific group data tag.

R_BG links a group manager object that controls the continuous acquisition of group data (present value/status flag pairs) from multiple data points for a specific group data tag. In addition, the group manager object triggers a configured evaluation function that calculated the resulting value. R_BG periodically reads the evaluated results at a preconfigured interval. A read can also be triggered by an external source.

R_BG can be configured to supply multiple (up to four) evaluated, resulting values based on the selectable evaluation functions. At least one evaluation function must be configured.

Proprietary objects are necessary for the grouping infrastructure: A group manager object and one or more group member objects. Individual member data points are grouped and referenced via the group member objects and the data is acquired and forwarded by the group member object to the group manager object.

Functioning

Compatible data points:

  • Binary input [BI]
  • Binary output [BO]
  • Binary, calculated value [BCalcVal]
  • Binary configuration value [BCnfVal]
  • Binary process value [BPrcVal]

Required properties of group data points:

  • Present value
  • Status flag
Pins

Input

Description

Data type

Default value
Value range

Interval

Read interval

Configurable polling time that specifies how often the calculated results are read.
Value 0 disables the timer. In this case, a read of the evaluated results can be triggered from an external source with [ImpRead].
If the pin has value -1s, the firmware triggers reading of the evaluated result. The firmware triggers reading when the evaluated result is updated again. (If evaluation function "Last updated" is parameterized, the interval is set to -1s).

Time

15s_0ms

ImpRead

Impulse for read

Linkable pin that allows an external source to provide a digital pulse to initiate reading.
As [ImpRead] can be interconnected, readings of multiple function blocks can be synchronized for acquisition in a chart.
Note
If [Interval] = -1s, then [ImpRead] is disabled.

Boolean

0

EvlFnct1…EvlFnct4

Evaluation function 1…Evaluation function 4

[EvlFnct1] determines the type of procedure performed on the valid, present values from the acquired group data with a common [GrpTag].
[EvlFnct1] belongs to one of four input sets, where each has [EvlFnctX] and [ValInX]. Typically, the application engineer sets this in the programming editor and it cannot be changed during runtime.
The functionality from [EvlFnct2]...[EvlFnct4] is the same as [EvlFnct1].

Integer

32767

5: Count of values
The number of valid values that match the condition on [ValIn1]. The result is provided at the output [Cnt1].
6: AND
The logical operation AND for all valid values.
7: OR
The logical operation OR for all valid values
10: Last updated
Searches the last updated value among the valid values.

ValIn1…ValIn4

Value input 1…Value input 4

Configurable parameter for the evaluation function that sets a marching value for the common data of the given [GrpTag].
It is only used, if [EvlFnct1] is set to 5 (CountOfVal).
[Valln1] belongs to one of four input sets, where each has [EvlFnctX], [ValInX]. Typically, the application engineer sets this in the programming editor and it cannot be changed during runtime.
The functionality from [ValIn2]...[ValIn4] is the same as [ValIn1].

Boolean

0

GrpTag

Grouping tag

Specifies the specific group data (present value, status flags) that the function block acquires and evaluates.
The system provides predefined and customizable tags. Typically, the application engineer sets [GrpTag] in the programming editor and it cannot be changed during runtime. A tag that matches the data type of the function block must be set.

Double Word

0

BaObjRef

BA-Object reference
Link between function block and BACnet object.

Structure

---

BaObjRef
> DeviceID

Device identifier
[DeviceID] includes object type and object instance in one ID.
Identifies the device object: local or remote. A local device object can also be identified by value 16#3FFFFF.

Double Word

16#3FFFFF

BaObjRef
> ObjectID

Object identifier
[ObjectID] includes object type and object instance in one ID.
Identifies the object on a device.

Double Word

16#3FFFFF

BaObjRef
> ItemID

Item identifier
[ItemID] represents an index in a view node object that references the BACnet object.
[ObjectID] and [ItemID] together define an indirect reference to the BACnet object.
Value -1 indicates a direct interface.

Integer

-1

 

Output

Description

Data type

Default value
Value range

Val1...Val4

Value 1...Value 4

Boolean

0

The evaluated, resulting value based on the evaluation function selected in [EvlFnct1].

[Val1] belongs to one of four output sets where each contains [ValX], [DstbX], [CntX] and [UpdIndX].

[Val1] indicates:

  • 0, if no present values in the acquired group data for the given [GrpTag] were valid. [Dstb1] = 1.
  • 0 if [EvlFnct1] remains on the default value. [Dstb1] = 1.
  • The last valid value if [Dstb1] = 0.

The functionality of [Val2]...[Val4] is the same as [VaI1].

Cnt1…Cnt4

Count 1…Count 4

Integer

0

The evaluated, resulting value based on the CountOfVal evaluation function selected in [EvlFnct1].

[Cnt1] belongs to one of four output sets where each contains [ValX], [DstbX], [CntX], and [UpdIndX].

[Cnt1] provides:

  • The number of valid, present values from the common group data that match the selection of 1 or 0 at [ValIn1].
  • 0, if no present values in the acquired group data for the given [GrpTag] were valid. [Dstb1] = 1.
  • The last valid value if [Dstb1] = 1.

The functionality of [Cnt2]...[Cnt4] is the same as [Cnt1].

Dstb1...Dstb4

Disturbance 1...Disturbance 4

[Dstb1] indicates whether the result of the evaluation select on [EvlFnct1] is valid.

[Dstb1] belongs to one of five output sets where each contains [ValX], [DstbX], [CntX] and [UpdIndX].

[Dstb1] = 0 if at least on value is valid in the acquired group data.

[Dstb1] = 1 if no value is valid in the acquired group data.

The functionality of [Dstb2]...[Dstb4] is the same as [Dstb1].

Boolean

0

UpdInd1...UpdInd4

Update indication 1...Update indication 4

Boolean

0

[UpdInd1] Indicates that at least one of the values in the evaluation was updated with a new or the same value.

[UpdInd1] is set to 1 only if [Dstb1] = 0.

The functionality of [UpdInd1] and [UpdInd1] is the same as [UpdInd1].

Note
[UpdInd1] does not support evaluation function 'CountOfVal'.

NumVals

Number of valid values

Number of valid, present values acquired for a specific [GrpTag].

Integer

0

NumMbrs

Number of aggregated members

Number of present values acquired for a specific [GrpTag], typically equal to the number of group member objects addressed by the group manager for a specific group.

Integer

0

ErrCode

Error code indication

Integer

0: No error

= 0 - No error
> 0 - XFB error codes