Module description

The gateway receives measured values from the station (south protocol). The station is responsible for the cyclical renewal of the measured values.

The cycling verification period is configurable (by default 30 seconds). A measured value is detected as not renewed when 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 protocols.

When the measured value is cycled again, its new value and its associated quality erase the non-renewal fault. The measured value is then sent with its new values. 

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

Renewal of measured values ok :

Renewal of measured values ok

Renewal of measured values 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

{
   "plugin_stack":{
      "name":"measured_values_cycling_check",
      "verification_period" :30
   }
}

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

The module uses the identification (attribute "PIVOTTM.GTIM.Identifier") of the data to obtain the context of the measured value in the module 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
• PIVOTTM.GTIM.MvTyp.q.Validity = "questionable"
• PIVOTTM.GTIM.MvTyp.q.Source = "substituted"
• PIVOTTM.GTIM.MvTyp.t.SecondSinceEpoch = timestamp of non-renewal detection
• PIVOTTM.GTIM.MvTyp.t.TimeQuality =  Quality of the timestamp of the gateway (optional). 
• PIVOTTM.GTIM.TmOrg = "substituted" 
• PIVOTTM.GTIM.TmValidity = Quality of the timestamp of the gateway
• PIVOTTM.GTIM.Cause.stVal = "3" (Spontaneous)

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

• The value valid is used for PIVOTTM.GTIM.TmValidity.stVal,
• PIVOTTM.GTIM.MvTyp.t.TimeQuality attribute are not used.