4 using the delete function on virtual devices, 3 virtual functional blocks, Using the delete function on virtual devices -7 – Echelon i.LON SmartServer 2.0 User Manual

Page 290: Virtual functional blocks -7, Virtual functional blocks, Using the delete function on virtual devices

Advertising
background image

i.LON SmartServer 2.0 Programmer’s Reference

17-7

<UCPTname>Net/Virtual

Channel/Virtual

Device</UCPTname>

</Item>
</iLonItem
</Set>

Response

<SetResponse xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<UCPTfaultCount>0</UCPTfaultCount>

<Item>

<UCPTname>Net/Virtual

Channel/Virtual

Device</UCPTname>

</Item>

</iLonItem>
</SetResponse>

17.2.4

Using the Delete Function on Virtual Devices

You can use the Delete function to delete a Virtual device on the SmartServer. The Delete function
takes an <Item> element with a Virtual_Device_Cfg type as its input. The <Item> element only needs
to include the device’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="Virtual_Device_Cfg">

<UCPTname>Net/Virtual Channel 1/Virtual Device</UCPTname>

</Item>

</iLonItem>
</Delete>

Response

<DeleteResponse xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem >

<UCPTfaultCount>0</UCPTfaultCount>

<Item>

<UCPTname>Net/Virtual Channel 1/Virtual Device</UCPTname>

</Item>
</iLonItem>
</Delete>

17.3

Virtual Functional Blocks

Before you can add data points to a Virtual device, you need to use the Set function to create a virtual
functional block under the Virtual device. This virtual functional block is used to encapsulate the
virtual data points and enable the Virtual driver to adhere to the network hierarchy naming convention.
The Set function takes an <Item> element with a Virtual_Fb_Cfg type as its input, as shown in the
example below.

Request (add a virtual functional block to a Virtual device)

<Set xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<Item

xsi:type="Virtual_Fb_Cfg">

<UCPTname>Net/Virtual Channel 1/Virtual Device/VirtFb</UCPTname>

</Item>
</iLonItem>
</Set>

Response

<SetResponse xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<UCPTfaultCount>0</UCPTfaultCount>

<Item>

<UCPTname>Net/Virtual Channel 1/Virtual Device/VirtFb</UCPTname>

</Item>

Advertising