1 using the list function on modbus data points, Using the list function on modbus data points -11, Using the list function on modbus data points – Echelon i.LON SmartServer 2.0 User Manual

Page 260

Advertising
background image

i.LON SmartServer 2.0 Programmer’s Reference

15-11

15.4.1

Using the List Function on Modbus Data Points

You can use the List function to retrieve a list of Modbus data points on the SmartServer. The List
function takes an <iLonItem> element that has an xSelect statement with a MOD_Dp_Cfg type as its
input, as shown in the example below.

Request (use an xSelect statement to return all the Modbus data points on the SmartServer)

<List xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<xSelect>//Item[@xsi:type="MOD_Dp_Cfg"]</xSelect>

</iLonItem>
</List>

Alternatively, you can filter the Modbus 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 Modbus data points returned using the <UCPTname> and <UCPTlastUpdate> data point
properties.

Request (use an xSelect statement to return all the Modbus data points on a specific device)

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

<xSelect>//Item[@xsi:type="MOD_Dp_Cfg"][starts-with(UCPTname,"Net/Modbus Channel/LAE_LCD15_2")]
</xSelect>

</iLonItem>
</List>

Request (use an xSelect statement to return all the Modbus 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="MOD_Dp_Cfg"][UCPTlastUpdate&gt;"2008-03-31T00:00:00"]
</xSelect>

</iLonItem>
</List>

Request (return all the Modbus 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="MOD_Dp_Cfg"][contains(UCPTname,"Alrm")]</xSelect>
</iLonItem>

</List>

Response

<List xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<Item>
<UCPTname>Net/Modbus

Channel/LAE_LCD15_1/VirtFb/Alrm_1</UCPTname>

<UCPTannotation>Dp_In_Out;xsi:type="MOD_Dp_Cfg"</UCPTannotation>
<UCPThidden>0</UCPThidden>
</Item>
<Item>
<UCPTname>Net/Modbus

Channel/LAE_LCD15_1/VirtFb/Alrm-Prb1_1</UCPTname>

<UCPTannotation>Dp_In_Out;xsi:type="MOD_Dp_Cfg"</UCPTannotation>
<UCPThidden>0</UCPThidden>
</Item>
<Item>
<UCPTname>Net/Modbus

Channel/LAE_LCD15_1/VirtFb/Alrm-Prb2_1</UCPTname>

<UCPTannotation>Dp_In_Out;xsi:type="MOD_Dp_Cfg"</UCPTannotation>
<UCPThidden>0</UCPThidden>
</Item>
<Item>
<UCPTname>Net/Modbus

Channel/LAE_LCD15_1/VirtFb/Alrm-Prb3_1</UCPTname>

<UCPTannotation>Dp_In_Out;xsi:type="MOD_Dp_Cfg"</UCPTannotation>
<UCPThidden>0</UCPThidden>
</Item>
</List>

Advertising