Other device management operations, Testing devices and detecting device failures – Echelon LNS User Manual
Page 143
LNS Programmer's Guide
129
Note: If you are using an explicit transaction to install and configure a device, you must
commit the transaction before setting the device online. For more information on
transactions, see Using Transactions and Sessions on page 65. If you are installing
multiple devices at once, you should first install and configure all the devices, and then
set them online. This prevents the devices from attempting to communicate on a
partially installed network.
Other Device Management Operations
This section describes tasks you may need to perform when managing the devices you
have installed on your network. This includes the following:
• Testing Devices and Detecting Device Failures
Testing Devices and Detecting Device Failures
To test the current functionality and state of a device, call the Test() method on the
appropriate AppDevice object. LNS will then perform a series of tests on the device, in
this order:
1. LNS will verify that it can address the device by its Neuron ID. If this test fails, it
indicates either a problem with the device (the device either is powered off, detached
from the network, or defective), a problem with the channel (physical problem or too
much network traffic), or a problem with an intervening router (overloaded, offline,
powered off, detached from the network, or defective).
2. LNS will compare the network address retrieved from the device with the network
address stored in the LNS database for the device. A mismatch indicates a problem
with the device. It could also indicate that the device has been configured by an LNS
application using a different network database or by a non-LNS network tool.
3. LNS will verify that it can communicate with the device using the subnet/node
address assigned to the device in the LNS database. Failure to communicate using
subnet/node addressing may indicate a problem with the configuration of one or more
routers on the network. This could occur if one or more routers on the network has
been configured using a different network or by a non-LNS network tool.
4. LNS will verify that only one device on the network is using the network address
specified for the device. Multiple devices with the same network address may
indicate that a configured device was moved to this network from another one.
5. LNS will validate the device’s program ID, and the device’s authentication setting.
When an application device is tested, the details and results of the test are contained in
the LastTestInfo property of the AppDevice that was tested. When a router is tested,
the results can be found in the LastTestInfo property of the router’s RouterSide
objects. This property contains a TestInfo object that contains properties that will