This section applies to SmartServer release 3.1 or prior.

You can create, view, and edit monitoring, logging, and alarming properties for datapoints.  You can use the Datapoint Properties widget to define the datapoint properties, you can export the datapoint property definitions to a datapoint logging and alarming (DLA) file with a .dla extension, and you can import the DLA file to other SmartServers. You can also manually create a DLA file.

Users with Administrator, Owner, Controller, or Tenant roles can use the Datapoint Properties widget to create and modify datapoint properties where they have the Administrator, Owner, Controller, or Tenant roles.  


For SmartServer 3.2 and higher, see Defining Datapoint Properties.

This section consists of the following:

Note: Click the fullscreen icon (  ) for a better view of this widget. 

Displaying Datapoint Properties

Viewing Unconfigured Datapoints

To show the unconfigured datapoints, click the action icon () on the Device Properties widget and select Show Unconfigured Datapoints.

The unconfigured datapoints appear on the Datapoint Properties widget displaying the following:

Each heading has a forward/reverse sort icon. When clicked, the datapoint list is sorted in forward or reverse order by the selected heading.

Hiding Unconfigured Datapoints

To hide the unconfigured datapoints, click the action icon () on the Device Properties widget and select Hide Unconfigured Datapoints.

The unconfigured datapoints no longer appear.

Setting Filters

You can set filters on the Device Properties widget to refine information that is displayed.

  1. To set a filter, click the Set Filter button () on the Datapoint Properties widget.



    The Set Filters view appears.



  2. Enter the search criteria. 

    Click the plus sign ( ) to add filters.



  3. Click APPLY FILTERS.

    The results below show the block name filter results for "joystick".



    The remove filters () icon clears the filter settings.

Editing Datapoint Properties

  1. To edit datapoint properties, click the action button () and then select Edit.



    The Edit Datapoint Properties view appears.



Go to the following sections to edit datapoint properties: INFO, MONITORING AND LOGGING CONFIGURATION, ALARM TYPE CONFIGURATIONPRESET DEFINITIONS, or LOCALIZATION.

Note: Using presets and localization in datapoints is optional. A datapoint can have presets only, localization only, both presets and localization, or neither. When both presets and localization are used, the presets map are typically configured based on the localization value. Therefore, when an update is received, the value needs to be localized first before mapping to a preset string. And, when a preset string is entered, the map value needs to be transformed using the revert transformation rule to get the native value. 

Editing Datapoint Properties Information

  1. From the INFO tab, edit datapoint properties as needed including the following:



  2. Click UPDATE.

Editing Monitoring and Logging Configuration

  1. From the MONITORING AND LOGGING CONFIGURATION tab, set the parameters as needed including the following:

    Note: The Total Monitoring Traffic Indicator above the Datapoint Properties widget displays an estimate of the expected monitoring events per second (EPS) based on the current monitoring configuration. For optimal system operations, keep this number below 40 EPS on a quad core SmartServer IoT (Revision F or later), or 20 EPS on a dual core SmartServer IoT (Revisions A through E).


    A scalar value specifies that a datapoint value will not be published if the difference between the new value and the last published value is less than the minimum publish delta value. When enabled, this is a datapoint delta, value-based throttle that does not throttle or otherwise limit periodic updates based on a configured publish interval. 

    A scalar value specifies that a datapoint update will not be logged if the difference between the new value and the last logged value is less than the Log Minimum Delta Value. When enabled, this is a datapoint delta, value-based throttle. Log entries are not throttled based on value if the Log Minimum Delta Value is not Any Change or Always, unspecified, or equal to 0.  

    For example, if a datapoint is polled every 10 seconds and the multiple is 6, the datapoint value is logged at least every 60 seconds. If the multiple value is 0, the datapoint value is not logged for this log level. Any positive value specifies that the datapoint is logged for this log level. 

  2. Click UPDATE to return to the Datapoint Properties widget.

Editing Datapoint Value Alarm Conditions

  1. From the ALARM TYPE CONFIGURATION tab, edit the parameters as needed including the following:



  2. Click UPDATE to return to the Datapoint Properties widget.

Using Preset Definitions

From the PRESET DEFINITION tab, you can create, edit, and remove preset definitions.

Creating a Preset Definition

  1. From the PRESET DEFINITION tab, click the add () icon.



  2. Enter the preset name, value, and state. (Presets are based on the local values.)

  3. Click SAVE.

    The preset definition appears on the Edit Datapoint Properties view.



  4. Click UPDATE to return to the Datapoint Properties widget.

  5. Refresh your browser window (F5 in many browsers) to display the updated preset definition.

Editing a Preset Definition

  1. To edit an existing preset definition, click the action icon () for the desired preset definition and select the Edit preset menu option.



    The Edit preset view appears.



  2. Edit the preset definition as needed.

  3. Click SAVE.

  4. Click UPDATE to return to the Datapoint Properties widget.

  5. Refresh your browser window (F5 in many browsers) to display the updated preset definition.

Copying a Preset Definition

  1. To copy an existing preset definition, click the action icon () for the desired preset definition and select the Copy preset menu option.



    The Copy preset view appears.



  2. Edit the preset definition as needed.

  3. Click SAVE.

  4. Click UPDATE to return to the Datapoint Properties widget.

  5. Refresh your browser window (F5 in many browsers) to display the updated preset definition.

Removing a Preset Definition

From the PRESET DEFINITION tab, click the action icon () for the desired preset definition and select Remove preset.

The preset definition is automatically removed.

To remove multiple preset definitions, follow these steps:

  1. Click the checkmark for preset definitions to be removed (the checkmarks change from blue to yellow).

  2. Click the delete () button.

  3. Click UPDATE to return to the Datapoint Properties widget.

  4. Refresh your browser window (F5 in many browsers) to display the updated preset definition.

Using Localization Settings

You can set the localization transformation rules to be used by a datapoint through the Edit Datapoint Properties view, setting the multiplier, exponent, offset, and units fields to get the native value. Any simple data type, as well as any field in a structure or union, can be transformed.  After adding of changing any rules, click Update and then refresh your browser window (F5 in many browsers) to display the updated localization rules.

The transformation value = ( input value [raw value] *  multiplier *  10^exponent ) + offset



Exponent has two purposes:

  1. Controls 10^exponent
  2. Defines the number of decimal places that transformed value will show

Consider, for example, a device reports temperature as 22 degrees Celsius and you want to show the temperature as Fahrenheit. The number of decimal places you want to see in the Datapoint Browser widget determines the values used for the localization transform.

To clear any localization transformation rules, click the delete () button, click UPDATE, and then refresh your browser window (F5 in many browsers) to display the updated rules.

Copying Datapoint Properties

  1. To copy a datapoint property, click the action icon () on the Datapoint Properties widget and select Copy.



  2. Select the datapoint you wish to copy.



  3. Click COPY.

Clearing Datapoint Properties

Clearing a Selected Datapoint Property

  1. To clear the monitoring, logging, and alarming properties of a selected datapoint property, click the action icon () on the Datapoint Properties widget and select Clear.



  2. Confirm the clear operation by clicking OK on the Confirmation box.

Clearing Selected Datapoint Properties

  1. To clear the monitoring, logging, and alarming properties of selected datapoint properties, click the checkmark for the datapoint properties to clear.
    The checkmark changes from blue to yellow.



  2. Click the action icon () on the Datapoint Properties widget and select Clear Selected Datapoint Properties.



  3. Confirm the clear operation by clicking OK on the Confirmation box.

Clearing All Datapoint Properties

  1. To clear the monitoring, logging, and alarming properties of all datapoint properties, click the action icon () on the Datapoint Properties widget and select Clear All Datapoint Properties.



  2. Confirm the clear operation by clicking OK on the Confirmation box.

Exporting Datapoint Properties

Exporting a Selected Datapoint Property

To export datapoint properties for a single datapoint, click the action icon () on the Datapoint Properties widget for the datapoint and select Export.

The CMS exports the datapoint properties to a DLA file.

Exporting Selected Datapoint Properties

  1. To export multiple datapoint properties, click the checkmark for the datapoints to be exported.
    The checkmark changes from blue to yellow.



  2. Click the action icon () on the Device Properties widget and select Export Selected Datapoint Properties.



    The CMS exports the selected datapoint properties to a DLA file.

Exporting All Datapoint Properties

To export all datapoint properties, click the action icon () on the Datapoint Properties widget and select Export All Datapoint Properties.

The CMS exports all of the datapoint properties to a DLA file.

Importing Datapoint Properties

  1. To import datapoint properties, click the action icon () on the Datapoint Properties widget and select Import Datapoint Properties.



  2. Select the DLA file to be imported from your computer by clicking on the DROP FILE HERE area or by placing the file in that area.



  3. Click IMPORT FILE.



    A message appears indicating that the file was loaded.

Enabling/Disabling Use of Localization

The Use Localization option is not available with SmartServer 2.8 and higher.

By default, the SmartServer IoT is configured to use localization.

To disable this option, go to the Global Settings button () on the main page.

Click the Global Settings button () and select the Use Localization action (which appears in yellow when enabled) from the dropdown list. 

To re-enable localization, click the Global Settings button () and select the Use Localization action (which appears in blue when disabled) from the dropdown list.


Creating a DLA File

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

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.

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
PolledYes if polled; No if event-driven.
Poll IntervalPolling interval for use by the protocol engine.
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

(this parameter uses underscores)

Minimum number of seconds between published values. If 0, then there is no time throttle.

Publish Min Delta Value

(this parameter does not use underscores)

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.

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 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.

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.

The following table summarizes the changes from the DLA file implemented in SmartServer IoT 2.4 to SmartServer IoT 2.5. Fields shown as "N/A" for 2.4 are newly added in SmartServer IoT 2.5. Fields shown with different names are renamed from the listed SmartServer IoT 2.4 name.  

DLA file
(in 2.4)
DLA file (in 2.5)
Polled == YES

DLA file (in 2.5)
Polled == NO

Poll Interval

 Poll Interval

N/A

Publish Interval

Publish Interval

N/A

Publish Min_Delta_TimeN/AMin Publish Interval
N/AN/AExpected Update Interval

Publish Min Delta Value

Publish Min Delta Value

Publish Min Delta Value

Initial Value

Initial Value

Initial Value

Log Interval 1

Log 1 Expected Interval

 Log 1 Expected Interval

Log Interval 2

Log 2 Expected Interval

 Log 2 Expected Interval

Log Interval 3

Log 3 Expected Interval

 Log 3 Expected Interval

N/ALog 1 MultipleN/A
N/ALog 2 MultipleN/A
N/ALog 3 MultipleN/A
N/ALog 1 Min Interval 
(calculated from Log 1 Multiple * Publish Interval)
Log 1 Min Interval
N/ALog 2 Min Interval 
(calculated from Log 2 Multiple * Publish Interval)
Log 2 Min Interval
N/ALog 3 Min Interval 
(calculated from Log 3 Multiple * Publish Interval)
Log 3 Min Interval

Log Retention 1

Log 1 Retention Period 

Log 1 Retention Period 

Log Retention 2

Log 2 Retention Period  

Log 2 Retention Period  

Log Retention 3

Log 3 Retention Period

Log 3 Retention Period 

Log Min Delta Time

N/A

 N/A

Log Min Delta Value

Log Min Delta ValueLog Min Delta Value

DLA File Examples

Without Presets and Localization

#filetype,dla
Protocol,Device Type,Datapoint,Polled,Poll Interval,Publish Interval,Publish Min_Delta_Time,Initial Value,Log Interval 1,Log Interval 2,Log Interval 3,Log Retention 1,Log Retention 2,Log Retention 3,Log Min Delta Time,Alarm Name,High Warning,Low Warning,High Error,Low Error
LON,NcMultiSensorExample,LightSensor/0/nvoLuxLevel,Yes,10,5,0,Any,10,20,30,10,20,30,0,Always,CustomAlarm,8,4,6,3
LON,NcMultiSensorExample,TempSensor/0/nvoTemperature,Yes,10,5,0,Change,10,20,30,10,20,30,0,Always,CustomAlarm,8,4,6,3
#filetype,dla
Protocol,Device Type,Datapoint,Polled,Poll Interval,Publish Interval,Publish Min_Delta_Time,Initial Value,Log Interval 1,Log Interval 2,Log Interval 3,Log Retention 1,Log Retention 2,Log Retention 3,Log Min Delta Time,Alarm Name,High Warning,Low Warning,High Error,Low Error
modbus,PowerLogic 820 Series Digital Power Meter RTU,block/0/Voltage_A-N,Yes,30,30,1,,10,100,1000,300,3000,30000,1,Default_voltA_N,1000,10,2000,0

With Presets

Presets column follows Visible:

#filetype,dla
lon,GMRTpm,device/0/nvo[0],Yes,60,60,,always,,60,0,0,4,60,730,,always,,,,,,Yes,"{ name:""OCCUPIED"", value:69.8 },{ name:""UNOCCUPIED"", value:60.8 }"
lon,GMRTpm,device/0/nvo[1],Yes,60,60,,always,,60,0,0,4,60,730,,always,,,,,,Yes,"{ name:""ON"", value:22.0 },{ name:""OFF"", value:99.7 }"


The following example shows the datapoint type as a structure:

#filetype,dla
lon,GMRTpm,device/0/nvo[0],Yes,60,60,,always,,60,0,0,4,60,730,,always,,,,,,Yes,"{ name:""ON"", value:{value: 100, state: 1}},{name:""OFF"" value:{value: 25, state: 1}}"

With Localization

Localization column follows Presets:

#filetype,dla
lon,GMRTpm,device/0/nvo[1],Yes,60,60,,always,,60,0,0,4,60,730,,always,,,,,,Yes,,"{ value:{transformA: 18, transformB:-1, transformC: 32, unit:””deg F””}"

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.