Echelon i.LON SmartServer 2.0 User Manual

Page 197

Advertising
background image

i.LON SmartServer 2.0 Programmer’s Reference

13-9

<UCPTcompValue

LonFormat="">2</UCPTcompValue>

<Rule>
<UCPTindex>0</UCPTindex>
<UCPTinputPath>DataPointFormat[UCPTnickName="nviScene"]</UCPTinputPath>
<UCPTinputFieldName>scene_number</UCPTinputFieldName>
<UCPToutputPath>DataPointFormat[UCPTnickName="nvoSwitch"]</UCPToutputPath>
<UCPTcompFunction

LonFormat="UCPTcompFunction">FN_NUL</UCPTcompFunction>

<UCPTmultiplier>0</UCPTmultiplier>
<UCPTconstant

LonFormat="">100.0

1</UCPTconstant>

</Rule>
</Case>

Each case rule is defined by a <Rule> element. The following table describes the properties that
should be filled in within each <Rule> element to define each case rule.

Property Description

<UCPTindex>

The index number of the case rule.

NOTE: If more than one case rule attempts to assign a value to the
same data point or data point field, the case rule listed last in the
XML file (i.e. the one with the highest index number) takes
precedence.

<UCPTinputPath>

A reference to the <UCPTnickName> property of the input data
point. The value of this data point will be compared to the
<UCPTcompValue> selected for the case rule using the
comparison function defined by the <UCPTcompFunction>
property.

If the result of the comparison is True, the case rule will modify the
value of the input data point using the operations determined by the
<UCPTmultiplier> and <UCPTconstant> properties, and assign the
resulting value to the output data point specified in the
<UCPToutputPath> property.

<UCPTinputValue>

If the input point has a structured data type and you need to
evaluate a field within the structure, you need to specify that field
in this property.

You do not need to specify this property if you are evaluating a
scalar data point or a structured data point as a whole.

<UCPToutputPath>

A reference to the <UCPTnickName> property of the output data
point in which the value calculated by this case rule is to be stored.

<UCPToutputValue>

If the output point has a structured data type and you are writing to
a field within the structure, you need to specify that field in this
property.

You do not need to specify this property if you are writing to a
scalar data point or a structured data point as a whole.

<UCPTcompFunction>

<UCPTcompValue>

If you are evaluating a data point in the case rule, specify the
<UCPTcompFunction> and <UCPTcompValue> properties.

If you are not evaluating a data point in the rule, specify FN_NUL
for <UCPTcompFunction>. You do not need to specify a
<UCPTcompValue> property in this case.

The <UCPTcompValue> selected must use the same value format

Advertising