eDNA Hint Filter¶

The foglamp-filter-ednahint filter allows hints to be added to assets within FogLAMP that will be used by the eDNA North plugin. These hints allow for individual configuration of specific assets within the EDNA plugin.

A EDNA hint filter may be added to either a south service or a north task. In a south service it will be adding data for just those assets that originate in that service. In a north task it causes EDNA hints to be added to all assets that the FogLAMP is sending to the upstream system, it would normally only be used in a north that was using the EDNA plugin, however it could be used in a north that is sending data to another FogLAMP that then forwards to EDNA.

To add an EDNA hints filter:

Click on the Applications add icon for your service or task.

Select the ednahint plugin from the list of available plugins.

Name your EDNA hint filter.

Click Next and you will be presented with the following configuration page

ednahint

Enter your EDNA Hints in the JSON editor shown. You may add multiple hints for multiple assets in a single filter instance. See EDNA Hint data.

Enable the filter and click on Done to activate it.

EDNA Hint data¶

EDNA Hints comprise of an asset name which the hint applies, the datapoints within the asset and then for each datapoint a JSON document that is the hint. A hint is a name/value pair: the name is the hint type and the value is the value of that hint.

The asset name may be expressed as a regular expression, in which case the hint is applied to all assets that match that regular expression.

The following hint are currently supported by eDNA North:

shortid: Specify the short ID to be used for the datapoint.

longid: Specify the long ID to be used for the datapoint.

extid: Specify the extended ID to be used for the datapoint.

description: Specify a description to add to the eDNA point. This is only used if FogLAMP is creating points in eDNA.

extDescription: The extended description to add to the eDNA point. This is only used if FogLAMP is creating points in eDNA.

units: The units to add to the eDNA point. This is only used if FogLAMP is creating points in eDNA.

history: Control if a point created in eDNA for a particular datapoint should be sent to the history service.

expiry: Set the history expiry for a point created in eDNA. This is expressed in days.

minPeriod: Set the minimum period between reporting a point to history.

deadband: Set the deadband limit for a point created in eDNA.

Note

All hint values should be expressed as a string in the JSON document created regardless of the value expressing a numeric or boolean.

In the example below we explicitly set the short id to use for the datapoint temperature on an asset pump1

{
    "pump1": {
        "temperature": {
            "shortid": "PMP1TEMP"
        }
    }
}

To apply a hint to all assets, the single hint definition can be used with a regular expression.

{
  ".*": {
      "temperature": { "description" : "Temperature Value" }
      }
}

Regular expressions may also be used to select subsets of assets, in the following case only assets with the prefix OPCUA will have the hint applied.

{
  "pump.*": {
      "temperature": { "description" : "Pump Coolant Temperature" }
      }
}

Multiple hints can be given for a single datapoint

{
  "pump1": {
      "temperature": {
           "shortid" : "PMP1TEMP",
           "longid" : "PUMP 1 TEMPERATURE",
           "extid" : "SLURRY PUMP 1 COOLANT TEMPERATURE",
           "description" : "Pump1 Coolant Temperature",
           "extDescription" : "Slurry Pump1 Coolant Temperature",
           "units" : "C",
           "history" : "true",
           "expiry" : "100",
           "deadband" : "0.5",
           "minPeriod": "60"
           }
      }
}

Likewise hints may be given for multiple datapoints within an asset

{
    "pump1": {
        "temperature": {
            "shortid": "PMP1TEMP",
            "description": "Pump1 Coolant Temperature"
        },
        "speed": {
            "shortid": "PMP1SPD"
        }
    }
}

And also multiple assets

{
    "pump1": {
        "temperature": {
            "shortid": "PMP1TEMP",
            "description": "Pump1 Coolant Temperature",
            "units": "C"
        },
        "speed": {
            "shortid": "PMP1SPD",
            "units": "RPM"
        }
    },
    "pump2": {
        "temperature": {
            "shortid": "PMP2TEMP",
            "description": "Pump2 Coolant Temperature"
        },
        "speed": {
            "shortid": "PMP2SPD",
            "units": "RPM"
        }
    }
}

Macro substitution¶

Simple macro substitution within the values of the hints based on the content of the reading can be done.

Let us assume we have a string based datapoint in our asset that gives the location of the asset. Macro $location$ replaced by the value of datapoint location.

{
     "motor4": {
                     "speed": {
                                     "description": "Speed at $location$",
                             }
                     ]
     }
}

Macro $ASSET$ will be replaced by asset name.

{
    ".*": {
        "temperature": {
            "description": "$ASSET$ Coolant temperature"
        }
    }
}

eDNA Hint Filter¶

EDNA Hint data¶

Macro substitution¶

See Also¶