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

i.LON SmartServer 2.0 Programmer’s Reference 14-27
To issue a network management command, you need to provide one or more elements with a
LON_Device_Cfg type. Each element needs to include the , ,
, and properties of the device upon which network management
commands are to be issued. In addition, you should provide any other properties whose values are to
be preserved (if you do not provide a property, the current value stored in it is erased). Particularly,
you should provide the properties when
appropriate; otherwise, the device may be decommissioned and set offline. Specific network
management commands require additional properties as described in the following sections that
describe how to use each command.
Note: Section 21.1.5, Commissioning External Devices in Visual Basic.NET, includes a C#
programming example demonstrating how to issue network management commands in the L
ON W ORKS
Device SOAP interface in order to commission unconfigured external L ON W ORKS devices. Section
21.2.5, Commissioning External Devices in Visual Basic.NET, includes a Visual Basic example
demonstrating how to do this.
ChangeApplicationStatus
You can use this command to set the device application online or offline. This command requires the
desired property, which may be APP_RUNNING (online) or
APP_STOPPED (offline).
If you are setting a device application offline, you should still provide the
property and set it to COMMISSIONED; otherwise, the commission status will be changed to
COMSTATE_NUL (never reached) and the device is decommissioned. The following example
demonstrates how to set a device application offline.
xsi:type="LON_Device_Cfg">
Net/LON/DIO-1
5
00a145791500
80000105288a0403
LonFormat="UCPTcommissionStatus">COMMISSIONED
APP_STOPPED
ChangeApplicationStatus
LonFormat="UCPTstatus">STATUS_REQUEST
ChangeCommissionStatus
You can use this command to commission or decommission a device. If you are commissioning a
device, you should also set the device application online using the ChangeApplicationStatus command.
If you are decommissioning a device, you need to provide the property and
set it to DECOMMISSIONED. The following example demonstrates how to commission a device and
set the device application online.
xsi:type="LON_Device_Cfg">
Net/LON/DIO-1
5
00a145791500
80000105288a0403
APP_RUNNING
LonFormat="UCPTcommissionStatus">COMMISSIONED
ChangeApplicationStatus
LonFormat="UCPTstatus">STATUS_REQUEST
ChangeCommissionStatus