Echelon OpenLNS - Manual (Page 131)

OpenLNS Programmer's Reference 94
• The device’s network variables and message tags are
unbound;
• The device’s priority slot is set to zero.
• The device’s state is set to lcaStateCnfgOffline.
• The device’s use of network management authentication is
disabled.
• The device’s non-group receive timer to be set to 2,048 ms.
Other parts of the network image are not modified.
You cannot add devices to the AppDevices collection objects
contained in either the ALL or Discovered subsystems, as
write access to the app devices contained within these
pre-defined subsystems is limited. Devices may not be added
to, or deleted from, these subsystems. However, you can
create additional subsystems for your app devices with the
Add method of the Subsystems collection object.
Note: Do not read or write the State property of the AppDevice
in the same explicit transaction in which it is added or
commissioned.
Availability Local, full, and lightweight clients.
Syntax appDeviceObject = appDevicesColl.Add(deviceName,
deviceTemplateObject, channelObject, subnetObject)
Element Description
appDeviceObject The newly defined AppDevice
object.
appDevicesColl The AppDevices collection object.
deviceName A String containing the name of
the application device.
deviceTemplateObject DeviceTemplate object to be
associated with the device.
If you specify the
deviceTemplateObject parameter,
then you can also provide a
previously defined Channel object
as the channelObject parameter to
explicitly assign the device’s
channel.
A channelObject should always be
provided for multi-channel
networks with LonWorks routers
configured as repeaters.
If no channel is specified when the
device is created, the OpenLNS
Object Server will use automatic
channel determination to assign
the channel when the device is