Echelon LNS - Manual (Page 127)

LNS Programmer's Guide 113
Defining and Commissioning Devices
This section describes the steps you need to take when installing and configuring devices
on a network with the network installation scenarios described in Chapter 5 in detail.
This includes the following sections:
• Creating AppDevice Objects. One of the first steps you need to take when using
LNS to define and commission a device is to create an AppDevice object to
represent the device in the LNS database. This section describes how to do so.
• Neuron ID Assignment. LNS use a device’s Neuron ID to associate an AppDevice
object with a physical device on the network. In some cases, you may already
know the Neuron ID a device uses, and can set the property immediately. In
other cases, you might not. This section describes the different ways you can use
LNS to determine a device’s Neuron ID, and how to store the Neuron ID in the
LNS database.
• Loading Device Application Images. Before commissioning a device, you may
need to load the device’s application image. This section describes how to do so.
• Commissioning Devices. When you commission a device, LNS uses the device’s
Neuron ID to associate the AppDevice object in the LNS database with the
physical device on the network. There are many considerations you need to make
when commissioning devices. This section describes those considerations, and
describes when you should use the CommissionEx() method, which has been
added to LNS for Turbo Edition.
• Configuring Devices. Each device contains configuration properties that are
defined by the device’s interface. It is important to make sure that the
configuration property information stored in the LNS database matches the
configuration property information stored in the physical device on the network.
You can use the DownloadConfigProperties() and
UploadConfigProperties() methods to do so. This section describes the
considerations you should make when using those methods.
• Setting Devices Online. This section describes how to set a device online, and
provides guidelines you should be aware of when using LNS to change the state
of a device.
• Generally, you can add a device to connections on your network as soon as you
have created an AppDevice object for the device in the LNS database. However,
when using an add-hoc installation scenario in which either the device template
or channel is not specified when creating the device, device connections cannot be
created until the device has been commissioned. For more information on
connecting devices, see Connecting Devices on page 138.
Creating AppDevice Objects
One of the first steps you need to take when using LNS to define and commission a
device is to create an AppDevice object to represent the device in the LNS database. To
create an AppDevice, follow these steps:
1. Select or create the Subsystem object that will contain the new AppDevice. As
described in The LNS Programming Model on page 29, each Subsystem represents a