Echelon i.LON SmartServer 2.0 User Manual
Page 229
i.LON SmartServer 2.0 Programmer’s Reference
14-29
Reset
You can use the Reset command to stop a device application, terminate all incoming and outgoing
messages, set all temporary settings to their initial values, and then restart the device application. The
following example demonstrates how to reset a device.
<Set xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<Item
xsi:type="LON_Device_Cfg">
<UCPTname>Net/LON/DIO-1</UCPTname>
<UCPThandle>5</UCPThandle>
<UCPTuniqueId>00a145791500</UCPTuniqueId>
<UCPTprogramId>80000105288a0403</UCPTprogramId>
<UCPTapplicationStatus
LonFormat="UCPTapplicationStatus">APP_RUNNING</UCPTapplicationStatus>
<UCPTcommissionStatus
LonFormat="UCPTcommissionStatus">COMMISSIONED</UCPTcommissionStatus>
<Command>
<UCPTcommand>Reset</UCPTcommand>
<UCPTstatus
LonFormat="UCPTstatus">STATUS_REQUEST</UCPTstatus>
</Command>
</Item>
</iLonItem>
</Set>
Wink
You can use the Wink command to identify a L
ON
W
ORKS
device on the network and verify that it is
communicating properly. A device that supports the Wink command generates an
application-dependent audio or visual feedback such as a beep or a flashing service LED when winked.
When using the Wink command, you should provide the <UCPTcommissionStatus and
<UCPTapplicationStatus> properties; otherwise, the device will be decommissioned and set offline.
The following example demonstrates how to wink a device.
<Set xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<Item
xsi:type="LON_Device_Cfg">
<UCPTname>Net/LON/DIO-1</UCPTname>
<UCPThandle>5</UCPThandle>
<UCPTuniqueId>00a145791500</UCPTuniqueId>
<UCPTprogramId>80000105288a0403</UCPTprogramId>
<UCPTapplicationStatus
LonFormat="UCPTapplicationStatus">APP_RUNNING</UCPTapplicationStatus>
<UCPTcommissionStatus
LonFormat="UCPTcommissionStatus">COMMISSIONED</UCPTcommissionStatus>
<Command>
<UCPTcommand>Wink</UCPTcommand>
<UCPTstatus
LonFormat="UCPTstatus">STATUS_REQUEST</UCPTstatus>
</Command>
</Item>
</iLonItem>
</Set>
FetchProgID
You can use the FetchProgID command to retrieves the <UCPTprogramId> property of the device.
Note that this command is not required when a network is synchronized with an LNS network
database. This is because the Get function automatically fetches the program ID, if needed. The
following example demonstrates how to retrieve the program ID of a device:
<Set xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<Item
xsi:type="LON_Device_Cfg">
<UCPTname>Net/LON/DIO-1</UCPTname>
<UCPThandle>5</UCPThandle>
<UCPTuniqueId>00a145791500</UCPTuniqueId>
<Command>
<UCPTcommand>FetchProgID</UCPTcommand>
<UCPTstatus
LonFormat="UCPTstatus">STATUS_REQUEST</UCPTstatus>
</Command>
</Item>
</iLonItem>
</Set>