PAB

The PAB (Power Analysis Block) is a function available for NETIO devices that periodically evaluates sets of conditions. Based on these conditions, subsequent Rules can be executed. These conditions can consist of one or more of following variables:

• Current [mA]
• Energy [Wh]
• Load [W]
• Power Factor
• S0 pulses

Rules can then perform several actions described in section Rules. Every PAB is internally evaluated as having a discrete state which can be used as an input to a Rule mentioned above. State value is different for each type of PAB (described below). This state is also available in JSON protocol and therefore can be read externally.

There are two types of PABs available: RANGE & ZONES. Each type has different states and configuration options.

RANGE

True/False-based evaluation. Detects whether a monitored value lies in specified interval (range) for a period of time. PAB evaluates to TRUE or FALSE. Interval is specified by lower lowerBound and upper upperBound boundaries. PAB evaluates to TRUE if a variable defined in source lies within for a period of time defined in timeHysteresis.

Configuration Structure

Variable	Value	Description
type	RANGE	PAB type
source	OUTPUTS/x/(LOAD/CURRENT/POWER)	The monitored variable. x indicates input / output number.
timeHysteresis	int	[s] Monitored value must be present in defined interval for amount of time defined here. Eg: If the time hysteresis is equal to 5, monitored value must be within a defined interval for at least 5s. Only then it will be evaluated.
lowerBound	int	lower bound of the monitored value
upperBound	int	upper bound of the monitored value

Examples

Immediate evaluation

PAB evaluates to TRUE immediately as Output 1 Current value appears between 100 and 200 mA

{
  "type": "RANGE",
  "source": "OUTPUTS/1/CURRENT",
  "lowerBound": 100,
  "upperBound": 200,
  "timeHysteresis": 0
}

Evaluation with delay

PAB evaluates to TRUE when Output 1 Load is between 200 and 300 Watts for 5s.

{
  "type": "RANGE",
  "source": "OUTPUTS/1/CURRENT",
  "lowerBound": 200,
  "upperBound": 300,
  "timeHysteresis": 5
}

ZONES

Opposed from a previous type, ZONE-type PAB detects, whether a monitored variable finds itself in a specified zone. State of PAB indicates what zone number (index) is the measured variable currently in. Zones are defined by their thresholds (lower bounds) and there must be at least one threshold specified. Monitored value must be present in a defined interval for period of time defined in timeHysteresis.

Structure

Variable	Value	Description
type	ZONE	PAB type
source	OUTPUTS/x/(LOAD/CURRENT/POWER)	The monitored variable. x indicates input / output number.
timeHysteresis	int	[s] Monitored value must be present in defined interval for amount of time defined here. Eg: If the time hysteresis is equal to 5, monitored value must be within a defined interval for at least 5s. Only then it will be evaluated.
thresholds	list of integers	lower-bounds of individual zones intervals

Examples

PAB is evaluated according to the specified zones when the Output 2 Current value is in one of the zones for 10s. Zone numbers are as following:

• 0: 0 - 49 mA
• 1: 50 - 99 mA
• 2: 100 - 149 mA
• 3: 150 - 199 mA
• 4: 200+ mA

Eg: If the Current value is 130mA for at least 10s, PAB is evaluated as 2.

{
  "type": "ZONES",
  "source": "OUTPUTS/2/CURRENT",
  "thresholds": [
    50,
    100,
    150,
    200
  ],
  "timeHysteresis": 10
}

DAYLIGHT / SUNSET

Enables launching actions based on sunrise / sunset of current place.

Structure

Variable	Value	Description
type	DAYLIGHT	PAB type
latitude	50.0058144N OR -16.5237353	North/South coordinates
longitude	14.4129433E OR -73.8390597	East/West coordinates
altitude	Number of meters above sea level	8848
sunriseDelay	int [min]	Delay of PAB activation/deactivation to sunrise
sunsetDelay	int [min]	Delay of PAB activation/deactivation to sunset

Examples

PAB

{
  "type": "DAYLIGHT",
  "latitude": "50.0058144N",
  "longitude": "14.4129433E",
  "altitude":247,
  "sunriseDelay": 240,
  "sunsetDelay": -180
}

or

{
  "type": "DAYLIGHT",
  "latitude": 28.4162475,
  "longitude": -16.5237353,
  "altitude":247,
  "sunriseDelay": 240,
  "sunsetDelay": -180
}

RULE

{
  "conditions": {
    "PAB/DAYLIGHT_PAB/DAY": true
  },
  "actions": {
    "OUTPUTS/2/ACTION": "${COND_RESULT}"
  }
}