Page tree
Skip to end of metadata
Go to start of metadata

SmartServer 3.1 and prior releases

For SmartServer 3.1 or prior, see Defining Datapoint Properties (Release 3.1) in the Documents Archive area. 

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:
#filetype,dla

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):

Parameter                              Description
ProtocolValid values are: LON, IAP, ModBus, and BACnet
Device TypeDevice 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.
Datapoint

Fully qualified name as derived from the XIF file including block name, index and datapoint name.
For example: LightSensor/0/nvoLightLevel or TempSensor/0/nvoTemperature

MonitoredYes or No
Monitoring MethodEvent Driven or Polled
Poll Interval

Polling interval for use by the protocol engine.

This parameter is used for all monitored datapoints (not just polled datapoints).

Publish IntervalPublishing 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.
Always – publishes data on every update.
A scalar value – specifies a minimum change from the last published value.

Initial ValueFor 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
Log Interval 2
Log Interval 3

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
Log Retention 2
Log Retention 3

Sets the data retention period (in seconds) for each of the three log intervals.
Log Min Delta TimeMinimum 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.
Always – logs data on every update.
A scalar value – specifies a minimum change from the last logged value.

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 DetailsAlarm description

High Warning
Low Warning

Sets high and low warning limits.

High Error
Low Error

Sets high and low error limits.
VisibleYes to show datapoints (default); No to hide datapoints. 
PresetsSets the presets name and value.
LocalizationSets the localization transformation rules.
LoggedYes 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

#filetype,dla
Protocol,Device Type,Datapoint,Monitored,Monitoring Method,Poll Interval,Publish Interval,Expected Update Interval,Publish Min Delta Time,Publish Min Delta Value,Initial Value,Provision Initial Value,Log Interval 1,Log Interval 2,Log Interval 3,Log Retention 1,Log Retention 2,Log Retention 3,Log Min Delta Time,Log Min Delta Value,Alarm Type Name,Alarm Details,High Warning,Low Warning,High Error,Low Error,Visible,Presets,Localization,Logged
lon,SC100-MP,Digital Input/0/nvoValue,Yes,Polled,150.0,,10.0,10.0,always,,,0.0,0.0,0.0,14,60,730,,,,,,,,,Yes,,,No
lon,6kEvbMultiSensor,Switch/1/nvoValue,Yes,Polled,150.0,,10.0,10.0,always,,,0.0,0.0,0.0,14,60,730,,,,,,,,,Yes,,,No
#filetype,dla
Protocol,Device Type,Datapoint,Monitored,Monitoring Method,Poll Interval,Publish Interval,Expected Update Interval,Publish Min Delta Time,Publish Min Delta Value,Initial Value,Provision Initial Value,Log Interval 1,Log Interval 2,Log Interval 3,Log Retention 1,Log Retention 2,Log Retention 3,Log Min Delta Time,Log Min Delta Value,Alarm Type Name,Alarm Details,High Warning,Low Warning,High Error,Low Error,Visible,Presets,Localization,Logged
modbus,ADAM-4150,DI/0/DI_1,Yes,Polled,2.0,,,,any,,,0.0,0.0,0.0,14,60,730,,,,,,,,,Yes,,,No
#filetype,dla
Protocol,Device Type,Datapoint,Monitored,Monitoring Method,Poll Interval,Publish Interval,Expected Update Interval,Publish Min Delta Time,Publish Min Delta Value,Initial Value,Provision Initial Value,Log Interval 1,Log Interval 2,Log Interval 3,Log Retention 1,Log Retention 2,Log Retention 3,Log Min Delta Time,Log Min Delta Value,Alarm Type Name,Alarm Details,High Warning,Low Warning,High Error,Low Error,Visible,Presets,Localization,Logged
bacnet,VT7200-1H1C-3,device/0/BI:29,Yes,Polled,150.0,10.0,10.0,always,,,0.0,0.0,0.0,14,60,730,,,,,,,,,Yes,,,No

With Presets

Presets column follows Visible:

#filetype,dla
Protocol,Device Type,Datapoint,Monitored,Monitoring Method,Poll Interval,Publish Interval,Expected Update Interval,Publish Min Delta Time,Publish Min Delta Value,Initial Value,Provision Initial Value,Log Interval 1,Log Interval 2,Log Interval 3,Log Retention 1,Log Retention 2,Log Retention 3,Log Min Delta Time,Log Min Delta Value,Alarm Type Name,Alarm Details,High Warning,Low Warning,High Error,Low Error,Visible,Presets,Localization,Logged
modbus,ADAM-4150,DI/0/DI_0,Yes,Polled,2.0,,,,any,,,0.0,0.0,0.0,14,60,730,,,,,,,,,Yes,"[{""name"":""on"",""value"":1},{""name"":""off"",""value"":0}]",,No

With Localization

Localization column follows Presets:

The Localization settings shown in the example below convert a Celsius datapoint value to degrees Fahrenheit with a precision of 1 decimal digit.


#filetype,dla
Protocol,Device Type,Datapoint,Monitored,Monitoring Method,Poll Interval,Publish Interval,Expected Update Interval,Publish Min Delta Time,Publish Min Delta Value,Initial Value,Provision Initial Value,Log Interval 1,Log Interval 2,Log Interval 3,Log Retention 1,Log Retention 2,Log Retention 3,Log Min Delta Time,Log Min Delta Value,Alarm Type Name,Alarm Details,High Warning,Low Warning,High Error,Low Error,Visible,Presets,Localization,Logged
bacnet,VT7200-1H1C-3,device/0/AV:7,Yes,Polled,150.0,,10.0,10.0,always,,,0.0,0.0,0.0,14,60,730,,,,,,,,,Yes,,"{""value"":{""unit"":""deg F"",""transformA"":1.8,""transformC"":32,""transformP"":1}}",No

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.


  • No labels