Echelon i.LON 100 e2 Internet Server User Manual

Page 57

Advertising
background image

i.

LON 100 Internet Server Programmer’s Reference

5-13

<UCPTdirection>DIR_OUT</UCPTdirection>
<UCPTvalueDef>

<OnValue>100.0 1</OnValue>

<OffValue>0.0 0</OffValue>

</UCPTvalueDef>
</NVL>
</iLONDataServer>


The DataServerGet function returns an element for each data point referenced in the <Data>
parameter you supplied to the function. The properties included within each element are

initially defined when the data point is added to the DataServer. You can write to them with
the DataServerSet function. Table 10 describes these properties.
For more information on the DataServerSet function, see DataServerSet on page 5-17.

Table 10 DataServerGet Output properties

Property Description

<UCPTindex>

The index number assigned to a data point must be in the range
0-32767. As mentioned earlier, you can use the DataServerSet

function to create a new NVC data point, or to modify an
existing NVL or NVC data point. If you do not specify an index

number in the <Data> parameter you supply to DataServerSet,

the function will create a new data point using the first available
index number.
If you specify an index number that is already being used, the

function will overwrite the configuration of the data point using
that index number with the settings defined in the <Data>

parameter.

<UCPTpointName>

The name of a data point can be a maximum of 31 characters

long, and must begin with the following prefixes:

• NVL_ for an NVL data point
• NVC_ for an NVC data point
Once you have added a data point to the Data Server, you can
not change its <UCPTpointName>. The <UCPTpointName>

property for all data points must be unique, and must not
contain any spaces.
Note: The names assigned to NVL data points in the Data

Server follow the naming convention NVL_[NAME], where
[NAME] represents the progammatic name assigned to the NV

when it was created with LONMAKER. You can determine the

progammatic name of a network variable in LONMAKER by
right-clicking it and selecting Properties.

<UCPTlocation>

An alphanumeric string of up to 128 characters that describes

the location of the data point. This field is user-defined, and may

be useful when organizing your data points by physical location
or device.

<UCPTdescription>

A description of the data point. This can be a maximum of 228
characters long.

Advertising