Data Groups
With few exceptions, data groups must be defined in a device template file (DTF) in order for them to be available for use on a remote device. Which data groups are defined by a device template file depends on protocol, device type, and unique configuration.
CygNet distributes sample device template files for its EIEs, each of which typically serves one or more hardware models along with applicable firmware. Therefore, the data groups described below are only those data groups defined by CygNet in sample device template file(s). Your template(s) might not include some of the data groups described below. Device template files exist to enable users to customize device configurations; however, CygNet is not responsible for changes made by users.
For information about data group definitions and device template files, see Device Template Files.
For more information about data group dependencies, see Data Group Dependencies.
Notes:
- Certain device template files (FbNet_ACP_TD.dtf, FbNet_ACP_V4_RTU5000.dtf, FbNet_CBM_Pod.dtf, FbNet_CBM_WellHead_RTU5000.dtf, and FbNet_CBM_WellHead_TD.dtf) can be extended to include additional operational codes (Opcodes) and to read/write specific portions of the Comm Control data structure, which consists of hundreds of items. Comm Control data groups (msgType="ComCtrl") are structures with constituent data group elements that represent items (for instance, item="analog_scale.sample_hi"). Item names must match those defined in the device’s Comm Control data structure. All Comm Control data groups issue the same Opcode. Other Opcodes can be handled generically through the default data groups. In this case, data must match that prescribed by the Opcode specified.
-
When point processing is performed on history data groups, only closed records will be published and processed to points. If a device has leading timestamped records and returns the current, open record, point processing will not be performed for that record, even though there is data in the DDS transaction. The point record will be updated only when that record is closed. This is to avoid a situation where a point has multiple entries with the same timestamp, since an open record may be still updating values with each new poll, but each update will have the same timestamp. For example, say you start polling for a daily history record at 8:00am, you’ll get the first value at 8:00am, then if you poll every five minutes, you’ll get new values throughout the day at the exact same timestamp. A history record is basically an array of data with a timestamp and values where the values have different process variables for each incremental poll. The timestamp won’t get written until the record is closed, which happens at the end of the time period, in this case, a day.
-
Best practice recommends that you do not perform UDC and point processing on FMS data groups. The DEIDs specified in FMS data groups are generic and use the eFMS enumeration to identify the CygNet-defined FMS items referenced in the device template file. No polling is done on these data groups — all data is coming from the native data groups. Points should be mapped to the native data groups since that is the data group that is actually processing the device data. While point processing may work on the FMS data groups, it is not supported, not tested, not consistent across EIEs, and is not recommended practice.
FB Net EIE Data Groups
Browse by letter: [A] [B] [C] [D] [E] [F] [G] [M] [P] [R] [T] [V]
| Data Group Type | Usage Notes |
|---|---|
|
"Additional Control Data" |
|
|
AddCtlParm |
"Additional Control Parameters" |
|
AddParm |
"Additional Parameters" |
|
AlmData |
"Alarm Data" |
|
AlmFcuData |
"Alarm FCU Data" |
|
AlmFcuParm |
"Alarm FCU Parameters" |
|
AlmNotify |
"Alarm Notify" |
|
AlmParm |
"Alarm Parameters" |
|
AnlgScale |
"Analog Scaling Factors" |
|
"Basic Poll - Well" |
|
|
BasicPoll |
"Basic Poll" |
|
BasicSFC |
"Basic Poll - SFC" |
|
"Change Log" |
|
|
"Command Message" |
|
|
Comm |
"Comm Struct" |
|
"Control" |
|
|
Control |
"Control Struct" |
|
CtlParm |
"Control Parameters" |
|
"Date/Time" |
|
|
"Event Log" |
|
|
The "FCU Modbus Setup (code 20)" data group requires you to select a device type and Modbus address, to define the data and registers, and to set up Modbus communication options. This must be configured on the device during device installation. |
|
|
"Trend - FCU" |
|
|
"Gas Measurement Config" enables the use of default AGA-3 and AGA-7 configuration data for CygNet-based calculations if no device configuration is available. See Change Log and FMS Legacy Configuration Data. |
|
|
"Gas Parameters" |
|
|
"Gas Parms" |
|
|
GasVol |
"Gas Volume Save" |
|
GmrCfgSend |
"FMS Legacy Config Send Data" is used to send modified measurement data to the field device. This data group is required only if you plan to use FMS and want to perform this specific task. See also FMS Legacy Config Send Data Group. |
|
"FMS Legacy Configuration Data" See Change Log and FMS Legacy Events Data. |
|
|
"FMS Legacy Events Data" depends on Change Log. Specify date ranges on a per-data group basis within the device editor. For more information, see Selecting Date and Time. |
|
|
"FMS Legacy History Data" See FMS Legacy Configuration Data. Specify date ranges on a per-data group basis within the device editor. For more information, see Selecting Date and Time. |
|
|
"Motor Saver" |
|
|
MvtParms |
"MVT Parms" |
|
The "Plunger Control (Additional)" data group is only available with 6.42+ firmware. It provides historization data (arrival timestamp and runtime) for plungers. |
|
|
PlgTimer |
"Plunger Timers" |
|
PlungerCtl |
"Plunger Control" |
|
PressOver |
"Pressure Overrides" |
|
"Remote Shutin" |
|
|
RtuMpParm |
"RTU Mp Parameters" |
|
"Trend - RTU" |
|
|
"Trend - Configurable" |
|
|
"Trend - GMR (No FCU)" |
|
|
"Trend - Flowing" |
|
|
"Trend - POD" |
|
|
"Trend - RTU" |
|
|
"Trend - Wellhead" |
|
|
"Version" |


