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

i.LON SmartServer 2.0 Programmer’s Reference 14-28
<UCPTstatus LonFormat="UCPTstatus">STATUS_REQUEST</UCPTstatus>
</Command>
</Item>
</iLonItem>
</Set>
ImageDownload
You can use the ImageDownload command to download an application image file (.apb extension)
stored on the SmartServer flash disk to the device. When using the ImageDownload command, you
must specify the desired <UCPTurlImage> of the application image file to be downloaded to the
device. If the device interface of the device being loaded has changed, you can include the
<UCPTurlTemplate>
property and set it to the full path of the external interface file (.XIF extension)
or device template (.XML extension) on the SmartServer flash disk, and then use the GetTemplate
command to activate the new device interface on the SmartServer. The following example
demonstrates how to download an application to a device and activate a new device interface file on
the SmartServer.
<Set xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<Item
xsi:type="LON_Device_Cfg">
<UCPTname>Net/LON/AI-1</UCPTname>
<UCPThandle>3</UCPThandle>
<UCPTuniqueId>000256654500</UCPTuniqueId>
<UCPTprogramId>80000105188a0403</UCPTprogramId>
<UCPTapplicationStatus
LonFormat="UCPTapplicationStatus">APP_RUNNING</UCPTapplicationStatus>
<UCPTcommissionStatus LonFormat="UCPTcommissionStatus">COMMISSIONED</UCPTcommissionStatus>
<UCPTurlImage>/root/lonWorks/import/Echelon/LonPoint/Version3/ai-10v3.apb</UCPTurlImage>
<UCPTurlTemplate>/root/lonWorks/Import/Echelon/LonPoint/Version3/ai-10v3.xif</UCPTurlTemplate
>
<Command>
<UCPTcommand>ImageDownload</UCPTcommand>
<UCPTstatus
LonFormat="UCPTstatus">STATUS_REQUESTUCPTstatus>
</Command>
<Command>
<UCPTcommand>GetTemplate</UCPTcommand>
<UCPTstatus
LonFormat="UCPTstatus">STATUS_REQUEST</UCPTstatus>
</Command>
</Item>
</iLonItem>
</Set>
GetTemplate
You can use the GetTemplate command to activate a new device interface on the SmartServer. When
using the GetTemplate command, you must specify the device’s <UCPTurlTemplate>
property and set
it to the full path of the external interface file (.XIF extension) or device template (.XML extension) on
the SmartServer flash disk. The following example demonstrates how to activate a new device
interface file on the SmartServer.
<Set xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<Item
xsi:type="LON_Device_Cfg">
<UCPTname>Net/LON/AI-1</UCPTname>
<UCPThandle>3</UCPThandle>
<UCPTuniqueId>000256654500</UCPTuniqueId>
<UCPTprogramId>80000105188a0403</UCPTprogramId>
<UCPTapplicationStatus
LonFormat="UCPTapplicationStatus">APP_RUNNING</UCPTapplicationStatus>
<UCPTcommissionStatus LonFormat="UCPTcommissionStatus">COMMISSIONED</UCPTcommissionStatus>
<UCPTurlTemplate>/root/lonWorks/Import/Echelon/LonPoint/Version3/ai-10v3.xif</UCPTurlTemplate
>
<Command>
<UCPTcommand>GetTemplate</UCPTcommand>
<UCPTstatus
LonFormat="UCPTstatus">STATUS_REQUEST</UCPTstatus>
</Command>
</Item>
</iLonItem>
</Set>