Echelon OpenLNS - Manual (Page 97)

OpenLNS Programmer's Reference 60
Echelon recommends that you upgrade the device before
loading the application image. This will allow you to verify
that the upgrade completed successfully before you load the
application.
After a device has been successfully upgraded, and the device
application has been loaded (if necessary), you should
re-commission it with the Commission or CommissionEx
methods.
For more information on replacing devices, see the Replace
and ReplaceEx methods. For more information on loading
device applications, see the Load and LoadEx methods.
Note: In some cases, it may necessary to upgrade your
client’s Network Service Device when you change the
network interface it is using. Generally, OpenLNS will
perform this upgrade automatically, as soon as the system is
opened. However, you can prevent LNS from automatically
upgrading the Network Service Device by setting the Flags
property to lcaFlagsManualNsdUpgrade. By default, this
flag is not set. When the flag is set, you will need to manually
perform the upgrade by calling the Upgrade method on the
AppDevice object that represents your client’s Network
Service Device. There are several factors you will need to
consider when doing so. For more information, see the
Network Interfaces and Network Service Devices section in
Chapter 11 of the OpenLNS Programmer’s Guide.
Availability Local, full, and lightweight clients.
Syntax usObject = adObject.Upgrade dtObject, reserved
Element Description
usObject An UpgradeStatus object which contains
the status and results of the upgrade.
adObject The AppDevice object to be upgraded.
dtObject Optionally, the DeviceTemplate object
containing the new external interface.
reserved An Integer value reserved for future use.
Set to 0.
Added to API LNS Release 3.0.
UploadConfigProperties
Summary Uploads all configuration property values from a physical
device on the network into the associated AppDevice object
in the OpenLNS database.
A configuration property's value is obtained using the
GetDataPoint method of the ConfigProperty object. The
ConfigProperties collection containing all the configuration
properties on a device is accessed through the AppDevice
object 's Interface property (AppDevice.Interface). The