Echelon i.LON SmartServer 2.0 - Manual (Page 294)

i.LON SmartServer 2.0 Programmer’s Reference 17-11
Property Description
#<manufacturer ID>[scope selector].<type name>[#format] .
This determines many factors about the Virtual data point,
including the type of values it takes and its base type. If you do
not set this property, it is set to RAW_HEX and the Virtual data
point uses raw hex values.
Specifies the size (in bytes) of the Virtual data point.
Specifies whether the Modbus data point is an input data point
(DIR_IN), output data point (DIR_OUT), or undefined
(DIR_NUL).
The handle assigned to the Virtual data point assigned by the
SmartServer. When you use the Set function to modify the
configuration of an existing Virtual data point, you must specify
the data point’s handle. If you do not specify the handle, a new
Virtual device is created. You cannot use the Set function to
modify the handle assigned to the Virtual data point.
The frequency in which the SmartServer’s internal data server
polls the Virtual data point. The recommended minimum poll
rate is 30 seconds; the maximum poll rate is 1 second.
Polling for Virtual data points is disabled (0 seconds) by default.
Note: The actual poll rate is determined by calculating the least
common denominator of all the poll rates set for the data point
from the applications to which it has been added.
17.4.3 Using the Set Function on Virtual Data Points
You can use the Set function to overwrite the configuration of a Virtual data point, or to create a new
Virtual data point. The input parameters you supply to the function will include one or more
elements. Each element includes a property that specifies a unique Virtual data
point to be created or modified.
Each element may also include a series of properties that define the configuration of the new
(or modified) Virtual data point. This set of properties is the same whether you are creating a new
Virtual data point or modifying an existing Virtual data point.
• If you are creating a new Virtual data point, you should specify the
property; all other properties are optional.
• If you are modifying an existing Virtual data point, you must specify the property.
In addition, all other properties should be filled; otherwise the values stored in them are erased.
The previous section, Using the Get Function on Virtual Data Points, details the properties you
can include in the Set function.
You can set multiple Virtual data points with a single Set message. However, you should not attempt
to create or write to more than 100 Virtual data points with a single call to the Set function. The
following example demonstrates how to create a new Virtual data point.
Request (add a Virtual data point to a Virtual device)
xsi:type="Virtual_Dp_Cfg">
Net/VirtCh/iLON System/VirtFb/virt_switch