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

i.LON SmartServer 2.0 Programmer’s Reference 16-6
16.2 M-Bus Devices
The following section describes how to use the List, Get, Set, and Delete functions on M-Bus devices.
16.2.1 Using the List Function on M-Bus Devices
You can use the List function to retrieve a list of M-Bus devices on the SmartServer. The List function
takes an <iLonItem> element that has an xSelect statement with an MBS_Device_Cfg type as its input,
as shown in the example below.
Request
<List xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<xSelect>//Item[@xsi:type="MBS_Device_Cfg"]</xSelect>
</iLonItem>
</List>
Response
<List xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<UCPTfaultCount>0</UCPTfaultCount>
<UCPTcurrentConfig>4.0</UCPTcurrentConfig>
<Item>
<UCPTname>Net/M-Bus
Channel/M-Bus Device</UCPTname>
<UCPTannotation>App;xsi:type="MBS_Device_Cfg"</UCPTannotation>
<UCPThidden>0</UCPThidden>
</Item>
</iLonItem>
</List>
You could use the list of <Item> elements returned by this function as input for the Get function. The
Get function would then return the configuration of each device included in the list. The next section
describes the properties included in each of these elements.
16.2.2 Using the Get Function on M-Bus Devices
You can use the Get function to retrieve the configuration of an M-Bus device defined on the
SmartServer. The input parameters you supply to this function will include one or more <Item>
elements with an MBS_Device_Cfg type. Each <Item> element will include the <UCPTname> of
each device whose configuration is to be returned by this function, as shown in the example below.
Request
<Get xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<Item
xsi:type="MBS_Device_Cfg">
<UCPTname>Net/M-Bus Channel/M-Bus Device</UCPTname>
</Item>
</iLonItem>
</Get>
Response
<Get xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<UCPTfaultCount>0</UCPTfaultCount>
<Item
xsi:type="MBS_Device_Cfg">
<UCPTname>Net/M-Bus Channel/M-Bus Device</UCPTname>
<UCPTannotation>App</UCPTannotation>
<UCPThidden>0</UCPThidden>
<UCPTlastUpdate>2008-04-02T14:47:25.970-07:00</UCPTlastUpdate>
<UCPTuri>MBS_Device_Cfg.htm</UCPTuri>
<UCPThandle>0</UCPThandle>
<UCPTspeed
LonFormat="UCPTspeed">MS_2400</UCPTspeed>
<UCPTmbusFcbEnable>1</UCPTmbusFcbEnable>
<UCPTmbusFcvEnable>1</UCPTmbusFcvEnable>
<UCPTmbusMode
LonFormat="UCPTmbusMode">MD_MODE1</UCPTmbusMode>