Module description

The gateway south service receives measured values from the station (south protocol). The station is responsible for the cyclical renewal of the measured values.cyclically according to a predefined period.

The The cycling verification period is configurable (30 seconds by default 30 seconds). A measured value is detected as not renewed when if it has not been received during the cycling verification period.

Following the detection of its non-renewal, it is positioned "questionable" and the "OldData" detail is positioned in the gateway and sent to the centers only once through the north protocolsservice.

When the a new measured value is cycled received again , its new value and its associated quality erase the non-renewal fault. The from the station, the measured value is then sent with its new valuesvalue with the corresponding quality and ts. 

It's the reception of the first message for a measured value that triggers the non-renewal monitoring functionality.Renewal of measured values ok

Measured values cycling OK:

Renewal of measured values okRenewal of measured

Measured values cycling failed:

Configuration

A number of parameters must be configured in the module. The configuration is transmitted by PowerConf. 

The module does not need the list of measured values, it only monitors the ones it receives. When a measured value is received for the first time the module triggers the monitoring of its non renewal. Only measured values with a cause of transmission of "cyclic" are monitored.

Format

Configuration JSON structure

{
   "plugincheck_stackperiod":{
      "namedescription":"measured_values_cycling_check check period in seconds.",
      "verification_period" :30"type":"string",
      "default":"30",
      "order":"1",
      "displayName":"Check period"
   }
}

Pivot model interaction

This module is designed to work on values measured in pivot format. The other types of information are not affected by this module. Outside the detection period of the non-renewal fault, the measured values pass through the module without modification.

Input

Filtering rules

R1: The measured values cycling check applies only after receiving a first measured value.

R2: The measured values cycling check applies only to measured values with a "cyclical" cause of transmission.

R3: Outside the scope defined by R1 and R2, readings are passed through without any check or change.

Data processing

Input

This filter plugin expects readings to be a pivot model measured values datapoints.

It The module uses the identification (attribute "PIVOTTM.GTIM.Identifier") of the data datapoint to obtain the context of the measured value in the module order to :

• Update the date of reception of the measured value,
• Know which measured value to read again in order to send the non-renewal message at the end of the timer.

The module uses the data PIVOTTM.GTIM.Cause.stVal (at "cyclic") to determine if the measured value is configured as cyclic. If it is, the module performs the monitoring processing, otherwise the message is ignored.

Output

In case of non-renewal detection, the last measured value received by the module is re-read and the following values are overwritten :

• PIVOTTM.GTIM.MvTyp.q.DetailQuality.oldData = True is set to "true"
• PIVOTTM.GTIM.MvTyp.q.Validity = is set to "questionable"
• PIVOTTM.GTIM.MvTyp.q.Source = is set to "substituted"
• PIVOTTM.GTIM.MvTyp.t.SecondSinceEpoch = timestamp of non-renewal detection is set to current gateway timestamp
• PIVOTTM.GTIM.MvTyp.t.TimeQuality =  Quality is set to the quality of the timestamp of the gateway (optional). 
• PIVOTTM.GTIM.TmOrg = is set to "substituted" 
• PIVOTTM.GTIM.TmValidity = Quality is set to to the quality of the timestamp of the gateway
• PIVOTTM.GTIM.Cause.stVal = is set to "3" (Spontaneous)

If it's impossible to obtain timestamp quality of the gateway from Fledge :

...