Echelon i.LON SmartServer Technical Information Page 216

  • Download
  • Add to my manuals
  • Print
  • Page
    / 443
  • Table of contents
  • BOOKMARKS
  • Rated. / 5. Based on customer reviews
Page view 215
i.LON SmartServer 2.0 Programmer’s Reference
14-16
Property Description
Web service should be set to DDT_DYNAMIC. You cannot
use the Set function to modify this property
14.2.3
Using the Set Function on a LONWORKS Channel
You can use the Set function to overwrite the configuration of a channel, or to create a new channel.
The input parameters you supply to the function will include one or more <Item> elements. Each
<Item> element includes a <UCPTname> property that specifies a unique channel to be created or
modified.
Each <Item> element may also include a series of properties that define the configuration of the new
(or modified) channel. This set of properties is the same whether you are creating a new channel or
modifying an existing channel.
If you are creating a new channel, you only need to specify the <UCPTtransceiverId> property; all
other properties are optional.
If you are modifying an existing channel, you must specify the channel’s <UCPThandle>. If you
do not specify the handle, a new channel is created. All other properties must be filled; otherwise
the values stored in them are erased. The previous section,
Using the Get Function on a
L
ONWORKS Channel, details the properties you can include in the Set function.
You can set multiple channels with a single Set message. However, you should not attempt to create or
write to more than 100 channels with a single call to the Set function.
Request (create a new L
ONWORKS channel on the SmartServer)
<Set xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<Item xsi:type="LON_Channel_Cfg">
<UCPTname>MyNewNetwork/myNewChannel</UCPTname>
<UCPTannotation>TP</UCPTannotation>
<UCPTtransceiverId LonFormat="UCPTtransceiverId">TP_FT_10</UCPTtransceiverId>
</Item>
</iLonItem>
</Set>
Response
<SetResponse xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<UCPTfaultCount>0</UCPTfaultCount>
<Item>
<UCPTname>MyNewNetwork/myNewChannel</UCPTname>
</Item>
</iLonItem>
</SetResponse>
14.2.4
Using the Delete Function on a LONWORKS Channel
You can use the Delete function to delete a LONWORKS channel on the SmartServer or a channel in an
LNS network database via the LNS Proxy Web service. The Delete function takes an <Item> element
with a LON_Channel_Cfg type as its input. The <Item> element only needs to include the channel’s
<UCPTname> property in the Delete Request as demonstrated in the following code sample:
Request
<Delete xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<Item xsi:type="LON_Channel_Cfg">
<UCPTname>MyOldNetwork/MyOldChannel</UCPTname>
</Item>
</iLonItem>
Page view 215
1 2 ... 211 212 213 214 215 216 217 218 219 220 221 ... 442 443

Comments to this Manuals

No comments