Viewing and Setting Datapoints

Viewing and Setting Datapoints

The Datapoint widget is available with SmartServer 2.5 and higher.

For SmartServer 3.3 and prior, see Testing Devices (Release 3.3 and Prior).

This page consists of the following sections:

Viewing Datapoint Values and Priorities

You can view datapoint values and priorities.  To view datapoint values and priorities, follow these steps:

  1. Open the SmartServer CMS.  Log into a CMS user account with read-only or read/write access to the Datapoints widget as described in Defining Users.

  2. Open the Datapoints widget.  

    image-20250220-020237.png


    The Datapoints widget displays the following information for each datapoint:
         Device – the device name
         Block name – the block name
         Block index – the block index
         Datapoint name – the datapoint name
         Value – the value of the datapoint
         Timestamp – the timestamp appears if log (not live) is specified for the source (source is specified using Set Filters)
         Preset – represents a specific native for a datapoint
         Actions – allow you to view value, edit value, export datapoint, view overrides, relinquish operations

  3. Set the Datapoints widget update interval in the upper right corner of the Datapoints widget.  

    image-20250220-020303.png


    The Datapoints widget update interval specifies how frequently the SmartServer fetches the current value for each displayed datapoint. The SmartServer has two sources for the current value.  One source is internal to the SmartServer, the other source is the edge device itself.  When the SmartServer fetches an updated value, it verifies the age of its locally stored value is less than the update interval.  If the locally stored value is older than the updated interval, the SmartServer requests a new value from the edge device that contains the datapoint.  These requests are called on-demand requests since they are independently scheduled from any periodic requests that are specified by datapont properties.

    For example, if the update interval is set to 30 seconds, the SmartServer will fetch the current value stored in the SmartServer every 30 seconds.  If the stored value is older than 30 seconds, the SmartServer will request the value from the edge device.

    Each update generates a SmartServer event that is included in the events per second (EPS) value displayed in the CMS dashboard.  For example, if the Datapoints widget is updating 25 datapoints every 30 seconds, the total EPS for the SmartServer will increase by 0.8.  Always keep the total EPS displayed in the CMS dashboard below 40 EPS.

    On-demand requests can add signficant load to slow communication channels such as LON power line channels.  To reduce loading on slow channel set the update interval to 0 or a value greater than 200 seconds.

    To change the update interval, click the update interval value, change the value, and then click anywhere else such as the white space next to the value to save the value.  To disable on-demand polling, set the update interval value to 0.

  4. Click the Expand button (image-20250220-020321.png) on the top right of the widget to view all the available information.

  5. Click the Sort button in a column heading to enable forward or reverse sorting for the column.

  6. To find a specific datapoint to view, click the Set Filters button (image-20250220-020341.png) and create a filter to find the datapoint as described in Customize the CMS Widgets Using Filters.  By default, the Datapoints widget displays live data for all provisioned devices.

  7. To view a datapoint value and priority with a more detailed view of the value, click the datapoint Action button (image-20250220-020359.png) for the datapoint and then click View Value.

    image-20250220-020429.png


    The datapoint value and priority is displayed.  The priority may be Normal which indicates a value with no priority overrides.  Or, the priority may be a value from 1 to 16 indicating an override of the normal value and any lower priority overrides.  The highest priority is 1 and the lowest is 16.

    image-20250220-020445.png

     

  8. Click Cancel to close the dialog.

Setting a Datapoint Value and Priority

You can set the value and priority for a datapoint.  To set the value and priority for a datapoint, follow these steps:

  1. Open the SmartServer CMS.  Log into a CMS user account with read/write access to the Datapoints widget as described in Defining Users.

  2. Open the Datapoints widget and verify the update interval as described in the previous section.

    image-20250220-020237.png

     

  3. Click the Expand button (image-20250220-020321.png) on the top right of the widget to view all the available information.

  4. Click the Sort button in a column heading to enable forward or reverse sorting for the column.

  5. To find a specific datapoint to update, click the Set Filters button (image-20250220-020341.png) and create a filter to find the datapoint as described in Customize the CMS Widgets Using Filters.  By default, the Datapoints widget displays live data for all provisioned devices.

  6. To set a datapoint value, click the value in the Datapoints widget and enter a new value.  The SmartServer updates the value at the Normal priority.

  7. To set a datapoint value and priority with a more detailed view of the value, click the datapoint Action button (image-20250220-020359.png) for the datapoint and then click Edit Value.

    image-20250220-020707.png


    The CMS displays the datapoint value and priority.

    image-20250220-020720.png

     

  8. Edit the datapoint priority and value.  The priority may be Normal which indicates a value with no priority overrides.  Or, the priority may be a value from 1 to 16 indicating an override of the normal value and any lower priority overrides.  The highest priority is 1 and the lowest is 16.  For BACnet devices, the 16 priorities map to the 16 BACnet overrides for BACnet devices supporting priority overrides.  Many BACnet devices that support priority overrides do not support updates to the Normal value.  For such devices, the SmartServer changes update to the Normal value to a priority 16 update.  If you save a datapoint value with a lower priority than the current priority initially shown in the Edit Value dialog, the new value will get stored in the datapoint priority array (see the Managing Overrides section), but the current value will not change, and the new value will not be sent to the edge device if the edge device does not support datapoint priority overrides.

  9. Click Save to send the updated value to the device and close the dialog.