1 using the list function on m bus data points, 2 using the get function on m bus data points, Using the list function on m-bus data points -12 – Echelon i.LON SmartServer 2.0 User Manual
Page 279: Using the get function on m-bus data points -12, Using the list function on m-bus data points, Using the get function on m-bus data points
i.LON SmartServer 2.0 Programmer’s Reference
16-12
16.4.1
Using the List Function on M-Bus Data Points
You can use the List function to retrieve a list of M-Bus data points on the SmartServer. The List
function takes an <iLonItem> element that has an xSelect statement with an MBS_Dp_Cfg type as its
input, as shown in the example below.
Request (return all the M-Bus data points on the SmartServer)
<List xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<xSelect>//Item[@xsi:type="MBS_Dp_Cfg"]</xSelect>
</iLonItem>
</List>
Alternatively, you can filter the M-Bus data points returned by the List function to those on a specific
device by including the <UCPTname>of the parent device in the xSelect statement, or you can filter
the M-Bus data points returned using the <UCPTname> and <UCPTlastUpdate> data point properties.
Request (use an xSelect statement to return all the M-Bus data points on a specific device)
<List xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<xSelect>//Item[@xsi:type="MBS_Dp_Cfg"][starts-with(UCPTname,"Net/M-Bus Channel/M-Bus Device")]
</xSelect>
</iLonItem>
</List>
Request (use an xSelect statement to return all the M-Bus data points that were updated after a
specific time)
<List xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<xSelect>//Item[@xsi:type="MBS_Dp_Cfg"][UCPTlastUpdate>"2008-03-31T00:00:00"]
</xSelect>
</iLonItem>
</List>
Request (return all the M-Bus data points of a specific type based on name)
<List xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<xSelect>//Item[@xsi:type="MBS_Dp_Cfg"][contains(UCPTname,"In")]</xSelect>
</iLonItem>
</List>
Response
<List xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<Item>
<UCPTname>Net/M-Bus Channel/M-Bus Device/Virtual Fb/In</UCPTname>
<UCPTannotation>Dp_In;xsi:type="MBS_Dp_Cfg"</UCPTannotation>
<UCPThidden>0</UCPThidden>
</Item>
</List>
16.4.2
Using the Get Function on M-Bus Data Points
You can use the Get function to retrieve the configuration of M-Bus data points defined on the
SmartServer. The input parameters you supply to this function will include one or more <Item>
elements with an MBS_Dp_Cfg type. Each <Item> element will include the <UCPTname> of each
Modbus data point whose configuration is to be returned by this function, as shown in the example
below.
Request (use an xSelect statement to return a specific
M-Bus data point)
<Get xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<Item
xsi:type="MBS_Dp_Cfg">
<UCPTname>Net/M-Bus Channel/M-Bus Device/Virtual Fb/In</UCPTname>
</Item>