beautypg.com

Echelon i.LON SmartServer 2.0 User Manual

Page 142

background image

i.LON SmartServer 2.0 Programmer’s Reference

9-11

Property Description

SNVT_switch data point using either of the following statements:

ON
ON

If you are creating an event that is to occur sometime before or after

sunrise or sundown, specify in a LonFormat attribute whether the
offset specified in the property is to be added to or
subtracted from the calculated sunrise or sundown time. This
property can have one of the following values:

TD_POSITIVE: The offset specified in the

property is to be added to the calculated sunrise or sundown
time. For all time-of-day events, you must specify
TD_POSITIVE.

TD_NEGATIVE: The offset specified in the

property is to be subtracted from the calculated sunrise or
sundown time.

For example, to specify that an event is to occur 15 minutes before
sunrise, you would use the following code:

TD_NEGATIVE

Note: You can omit this property if you are creating a time-of-day
event.

If you are creating a sunrise or sundown event, specify a reference to

the data point information which is used as base time for this event.
The reference is written as xPath statement relative to the actual
element.

To create a sunrise event, you would use the following code:

../../DataPoint[UCPTnickName="Sunrise"]

To create a sundown event, you would use the following code:

../../DataPoint[UCPTnickName="Sunset"]

You can use this element to create a #LOCK or #UNLOCK event.
This element may have one of the following values:

ET_LOCK: Locks out lower priority events and prevents them

from writing to the data points in the Scheduler. Applications
with lower priorities can only override a data point value once
the Scheduler has executed an #UNLOCK event.

ET_UNLOCK: Enables lower priority events to write to the

data points in the Scheduler.

ET_NUL: This is the default, indicating that the event is based

on the time-of-day, or sunrise or sundown.

You need to specify this value in a LonFormat attribute that has the
following value: "UCPTeventType". For example, to create a
#LOCK event, you would use the following code:

ET_LOCK