SmartServer 3.1 and prior releases
You can create a DLA requirements file as a CSV file that lists initial value, logging, and alarming requirements for datapoints.
A DLA file contains the following embedded metadata tags, anywhere in the file, but typically in the first line:
A DLA file is categorized by its extension .dla or .csv (not case sensitive), and the #filetype tag equal to dla (not case sensitive) and is identified by its filename. Compound extensions such as .dla.csv can also be used.
This section consists of the following:
DLA File Parameters
A DLA file contains the following columns (headings are not case sensitive):
|Protocol||Valid values are: LON, IAP, ModBus, and BACnet|
|Device Type||Device type from XIF file (not required for IAP). The device type is defined by a DTD record. Keyed to the PID in the XIF files that are packaged in the DTD.|
Fully qualified name as derived from the XIF file including block name, index and datapoint name.
|Monitored||Yes or No|
|Monitoring Method||Event Driven or Polled|
Polling interval for use by the protocol engine.
This parameter is used for all monitored datapoints (not just polled datapoints).
|Publish Interval||Publishing interval for use by the protocol engine. Typically this is a multiple of the polling interval. If not a multiple, then the highest multiple that does not exceed the specified interval is used.|
Expected Update Interval
|Expected average number of seconds between updates. If 0, updates are not expected and included in traffic estimation. You can specify as a fractional value such as 0.5 seconds. Set this parameter to the Min Publish Interval value if the Expected Update Interval is blank and the Min Publish Interval is changed. This value is used for traffic estimation only and does not otherwise impact monitoring. |
Publish Min Delta Time
|Minimum number of seconds between published values. If 0, then there is no time throttle.|
Publish Min Delta Value
Valid values are:
Any – publishes data on any change.
|Initial Value||For inputs only. Specifies the initial value. If blank, then no initial value.|
|Provision Initial Value|
Yes to write the initial value to the device when the device is provisioned; No to not write the initial value to the device when the device is provisioned.
Log Interval 1
|Sets the data logging intervals. Typically a multiple of the polling interval. If not a multiple, then the highest multiple that does not exceed the specified interval is used.|
Log Retention 1
|Sets the data retention period (in seconds) for each of the three log intervals.|
|Log Min Delta Time||Minimum number of seconds between logged values. If 0, then there is no time throttle.|
|Log Min Delta Value|
Valid values are:
Any – logs data on any change.
|Alarm Type Name|
If defined, then it appears in the Alarm Type list.
Note: Alarm Name must be unique across all alarm types and across all device types for handling alarm assignments.
|Alarm Details||Alarm description|
|Sets high and low warning limits.|
|Sets high and low error limits.|
|Visible||Yes to show datapoints (default); No to hide datapoints.|
|Presets||Sets the presets name and value.|
|Localization||Sets the localization transformation rules.|
|Logged||Yes for logging; No for no logging.|
DLA File Examples
To use the examples below, copy the text from the example to a text only file (e.g., Windows Notepad) and save the file using the .dla extension. To view the contents in Excel, use the .dla.csv extension. (File extensions are not case sensitive.)
Without Presets and Localization
Presets column follows Visible:
Localization column follows Presets:
DLA File Validation
The schema.ini file may be used to perform simple data validation when creating a DLA file with Excel. The schema.ini file is available here.