FMS History Data Groups

FMS history data groups are used to send historical data to FMS. History data comes from the Station History data groups: "Hist - Station Daily" (HistStaD) for daily data and "Hist - Station Hourly" (HistStaH) for hourly data. The station number from FMS Configuration properties is used to determine the data group ordinal.

The Station History data groups consist of data elements that are created dynamically based on data read from the device in the "Hist - Config" (HistCfg) data group. History Config items include a type/instance number identifying the meter it applies to (see enumeration EMtrTypeInst in the device template file). They may also include an EFM item number (see enumeration EEfmItemHist in the device template file).

DEIDs are generated in one of three ways:

1. If the EFM Item number = 0, the item is not associated with an EFM item and the DEID is generated incrementally (e.g., E000, E001).

2. If the EFM Item number > 0 and all items in the file apply to a single meter, the DEID includes the EFM item number (e.g., H001 for EFM item number 1).

3. If the EFM Item number > 0 and the file represents multiple meters, the DEID includes the EFM item number and the meter type/instance to which it applies (e.g., H001-0212 for EFM item number 1, type/instance 212).

FMS history PV entries support a DEID that represents an efmItem (e.g., H001 is associated with history item efmItem="1") or an Emerson point tag. Units come from the native history data group, not from the device template file.

Also see DNP3 Emerson EIE Device Template File Properties.

History Data Groups Structure and Components

For more information about working with device template files, see Device Template Files.

Example

Click here to see an example of the data groups <FmsHistD niceName="FMS Daily History" baseOrd="1" maxCnt="24" ordLabel="Meter"> <dgElements/> <uccRecvParms type="string"> <SDate desc="Start date" required="true"/> <EDate desc="End date" required="false"/> </uccRecvParms> </FmsHistD>   <FmsHistH niceName="FMS Hourly History" baseOrd="1" maxCnt="24" ordLabel="Meter"> <dgElements/> <uccRecvParms type="string"> <SDate desc="Start date" required="true"/> <EDate desc="End date" required="false"/> </uccRecvParms> </FmsHistH>

Data Group Mapping

The mapping between Emerson and FMS items is contained in the fmsMaps/histItems section of the device template file. There are two options for data sources, EFM item or Emerson point tag. In either case, the type/instance number is used to determine if an item is relevant to the current meter type and number.

1. The value comes from a specific EFM item in the "Hist - Station" data groups. EFM items are matched to an item in the "Hist - Config" (HistCfg) data group.
   

Example

EFM items are matched to an item in the "Hist - Config" (HistCfg) data group.

2. The value comes from an Emerson point tag.
   

Example

Substitution strings in point tag names for meter number (%meter%) and station number (%station%) are supported, and are filled using values specified by the user in FMS Configuration data group.

In fmsMaps, point tags for device specific history items may contain wildcards. This is a concession made because GQ items are not associated with efmItems as they should be. For example, "Fluid Prop_101.C1_IN_USE" is the point tag for Methane for meter #3. The Type/Inst # is examined to make sure the field is associated with the current meter.

For more information, see EFM Data Items.

Mapping Non-EFM items into FMS History

For field devices without a type/instance defined in the Station History configuration, non-EFM items that resolve to mapped items in the DTF ("efmItem", "tag" or "deid") will be included in FMS History for any meter using that history segment.

Single-Meter and Multi-Meter Station Support

The DNP3Emerson sample DTFs support single-meter and multi-meter stations to send historical data to FMS from the Emerson FBx devices. The meter naming conventions are as follows:

• Single-meter stations — auto-created history DEIDs use the Hxxx format, where xxx is an EFM item ID.

• Multi-meter stations — the meter instance is appended: the Hxxx-yyyy format is used, where yyyy is a type/instance, one for each meter in the station, e.g., H004_0211 and H004_0212.

The DNP3Emerson sample DTFs use the efmItem attribute instead of the deid attribute for history items in the fmsMaps/histItems section of the device template file. This provides support for both single-meter and multi-meter stations.