Echelon OpenLNS - Manual (Page 79)

OpenLNS Programmer's Reference 42
LoadEx
Summary Loads the application image specified by the AppImagePath
property into a device.
This method is the same as the
Load method except that it
provides additional options that you can choose from when
commissioning the device. For example, you can specify
options to upgrade the system image of the device if it is not
compatible with the application image being loaded (see the
description of the options element for more information).
See the
Load method for more general information on loading
application devices.
Availability Local, full, and lightweight clients.
Syntax appDeviceObject.LoadEx upgradeOption
Element Description
appDeviceObject The AppDevice object to load.
upgradeOption A Long value defining the option to be
used if the system image stored in the
device is incompatible with the
application image. The valid values for
this element, which are stored in the
ConstLoadOptions constant, are as
follows:
0 lcaLoadOptionsNone
Do not upgrade the system image. In
this case, the method works exactly as
the Load method does. If the device
requires a new system image to load the
new application in this case, the load
will fail and an exception will be
generated.
1 lcaLoadOptionsUpgradeSystemImage
OpenLNS supports upgrading the
following Neuron models provided that
the current firmware version installed
in the Neuron chip and the new
firmware version to be downloaded are
standard system images with versions
(and variants) in the listed ranges:
•
FT 5000 and Neuron 5000 (all
released versions up through
Version 19). Requires at least a
32K flash using a recognized flash
driver, or a 32K EEPROM.
• FT 3150 and 3150 (Versions 6–19).
Supports both 512 byte EEPROM
and 2K EEPROM system image