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

i.LON SmartServer 2.0 Programmer’s Reference 16-10
Property Description
(AT_SECONDARY) addressing. Primary addressing is
preferred because it makes replacing M-Bus devices more
transparent. Each of these addressing methods is described
as follows:
ƒ Primary. The primary address is assigned by the
network management tool used to install the M-Bus
device (analogous to a L
ON W ORKS subnet/icon
address).
ƒ Secondary. The secondary address is burned into the
device at the factory (analogous to a L ON W ORKS
Neuron ID).
• <UCPTmbusPrimaryAddress>. The primary address must
be between 0 to 250.
• <UCPTmbusSecondaryAddress>. The secondary address
must be between 0 to 99,999,999.
16.2.3 Using the Set Function on M-Bus Devices
You can use the Set function to overwrite the configuration of an M-Bus device, or to create a new
M-Bus device. The input parameters you supply to the function will include one or more <Item>
elements. Each <Item> element includes a <UCPTname> property that specifies a unique M-Bus
device to be created or modified.
Each <Item> element may also include a series of properties that define the configuration of the new
(or modified) M-Bus device. This set of properties is the same whether you are creating a new M-Bus
device or modifying an existing M-Bus device.
• If you are modifying an existing M-Bus device, you must specify the <UCPThandle> property. In
addition, all other properties should be filled; otherwise the values stored in them are erased. The
previous section, Using the Get Function on M-Bus Devices, details the properties you can include
in the Set function.
You can set multiple M-Bus devices with a single Set message. However, you should not attempt to
create or write to more than 100 M-Bus devices with a single call to the Set function. The following
example demonstrates how to create a new M-Bus device.
Request (create a new M-Bus device on the SmartServer)
<Set 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 2</UCPTname>
</Item>
</iLonItem
</Set>
Response
<SetResponse xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<UCPTfaultCount>0</UCPTfaultCount>
<Item>
<UCPTname>Net/M-Bus Channel/M-Bus Device 2</UCPTname>
</Item>
</iLonItem>
</SetResponse>