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

i.LON SmartServer 2.0 Programmer’s Reference 14-48
o ST_LON_UNACK (Unacknowledged). The sending device sends out the network variable
update only once and does not expect any confirmation from the receiving device. This
message service type consumes the least amount of resources, but is the least reliable.
o ST_NUL (Unknown). The SmartServer selects the service type.
• The <UCPTservicePath> property is always set to //WebService[UCPTindex=0], where 0 is
referring to the LNS Server containing the LNS network database in which the source and target
network variables are stored.
• The <UCPTpropagate> property is set to 1 by default and cannot be modified with the Set
function.
The following example demonstrates how to use the Set function create a L ON W ORKS connection
between an internal SmartServer device and an external device connected to the SmartServer. When a
Write function is performed on the source data point in the Web connection (Building 2/Channel
1/iLON App/Digital Input 2/nvoClsValue_2), the updated value is propagated to the target data points
(Building 2/Channel 1/DIO-1/Digital Output[0]/DO_Digital_1) in the L
ON W ORKS connection.
Request
<Set xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<Item xsi:type="Dp_Ref">
<UCPTname>Building 2/Channel 1/iLON App/Digital Input 2/nvoClsValue_2</UCPTname>
<DataPoint dpType="Target">
<UCPTname>Building 2/Channel 1/DIO-1/Digital Output[0]/DO_Digital_1</UCPTname>
<UCPTserviceType xsi:type="string" LonFormat="UCPTserviceType">ST_LON_ACK
</UCPTserviceType>
<UCPTservicePath xsi:type="string">//WebService[UCPTindex=0]</UCPTservicePath>
<UCPTpriority>240</UCPTpriority>
</DataPoint>
</Item>
</iLonItem>
</Set>
Note: All L ON W ORKS connections created with the LNS Proxy Web service use subnet/node ID
addressing. This means that a message packet travels from the sending device to the destination device
using the 2-byte logical address of the destination device in the network. Overall, L
ON W ORKS
connections use the following connection options:
Service Type Acknowledged (the default), Repeated, or Unacknowledged. See the
previous section for specifying the service type in the <UCPTserviceType>
property.
Addressing Subnet/Node ID.
Priority Used if hub (source) network variable specifies priority.
Authentication Used if target network variable has authentication enabled.
Retry Count Calculated based on topology and service type.
Repeat Count Calculated based on topology and service type.
Repeat Timer Calculated based on topology and service type.
Receive Timer Calculated based on topology and service type.