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

i.LON SmartServer 2.0 Programmer’s Reference 16-1
16 M-Bus Driver
The following chapter describes how to manage M-Bus channels, devices, and data points on the
SmartServer.
16.1 M-Bus Channels
The following section describes how to use the List, Get, Set, and Delete functions on M-Bus channels.
16.1.1 Using the List Function on M-Bus Channels
You can use the List function to retrieve a list of M-Bus channels on the SmartServer. The List
function takes an <iLonItem> element that has an xSelect statement with an MBS_Channel_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_Channel_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</UCPTname>
<UCPTannotation>RS232;xsi:type="MBS_Channel_Cfg"</UCPTannotation>
<UCPThidden>0</UCPThidden>
</Item>
</iLonItem>
</List>
The List function returns a list of <Item> elements for each M-Bus channel defined on the
SmartServer. 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 M-Bus channel included in the
list. The next section describes the properties included in each of these elements.
16.1.2 Using the Get Function on M-Bus Channels
You can use the Get function to retrieve the configuration of an M-Bus channel defined on the
SmartServer. The input parameters you supply to this function will include one or more <Item>
elements with an MBS_Channel_Cfg type. Each <Item> element will include the <UCPTname> of
each channel 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_Channel_Cfg">
<UCPTname>Net/M-Bus Channel</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_Channel_Cfg">
<UCPTname>Net/M-Bus Channel</UCPTname>
<UCPTannotation>RS232</UCPTannotation>