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

i.LON SmartServer 2.0 Programmer’s Reference 15-12
15.4.2 Using the Get Function on Modbus Data Points
You can use the Get function to retrieve the configuration of Modbus data points defined on the
SmartServer. The input parameters you supply to this function will include one or more <Item>
elements with a MOD_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 Modbus data point)
<Get xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<Item
xsi:type="MOD_Dp_Cfg">
<UCPTname>Net/Modbus Channel/LAE_LCD15_1/VirtFb/Alrm_1
</Item>
</iLonItem>
</Get>
Alternatively, you can specify one or more Modbus data point properties in the xSelect statement to
filter the items returned by the Get function, including the <UCPTname> to filter data points based on
their parent device.
Request (use an xSelect statement return all the Modbus data points on a specific device)
<Get 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_1")]
</xSelect>
</iLonItem>
</Get>
Response
<Get xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<UCPTfaultCount>0</UCPTfaultCount>
<Item
xsi:type="MOD_Dp_Cfg">
<UCPTname>Net/Modbus Channel/LAE_LCD15_1/VirtFb/T1_1</UCPTname>
<UCPTannotation>Dp_In_Out</UCPTannotation>
<UCPThidden>0</UCPThidden>
<UCPTlastUpdate>2008-04-02T12:15:22.020-07:00</UCPTlastUpdate>
<UCPTdescription>Temperature
1</UCPTdescription>
<UCPTuri>MOD_Dp_Cfg.htm</UCPTuri>
<UCPTformatDescription>#8000010128000000[4].UNVT_signed_long#dec</UCPTformatDescription>
<UCPTlength>2</UCPTlength>
<UCPTunit
field="">°C</UCPTunit>
<UCPThandle>0</UCPThandle>
<UCPTbaseType
LonFormat="UCPTbaseType">BT_SIGNED_LONG</UCPTbaseType>
<UCPTmodbusTable LonFormat="UCPTmodbusTable">MTT_HR</UCPTmodbusTable>
<UCPTstartAddress>0</UCPTstartAddress>
<UCPTstartBit>0</UCPTstartBit>
<UCPTbitLength>16</UCPTbitLength>
<UCPTdataOrdering
LonFormat="UCPTdataOrdering">DO_BIG_ENDIAN</UCPTdataOrdering>
<UCPTpollRate>20.0</UCPTpollRate>
</Item>
</iLonItem>
</Get>
The Get function returns an <Item> element for each Modbus data point referenced in the input
parameters you supplied to the function. The properties included within each <Item> element are
initially defined when the Modbus data point is added to the SmartServer. You can write to these data
point properties with the Set function. The following table describes these properties.
Property Description
<UCPTname> The name of the Modbus data point in the following format:
<network/channel/device/functionalblock/data point>. You can