Echelon OpenLNS - Manual (Page 68)

OpenLNS Programmer's Reference 31
lcaConfigPropOptLoadValues and
lcaConfigPropOptLoadUnknown download options when
you call DownloadConfigProperties. This will set any
unknown configuration properties in the AppDevice object in
the OpenLNS database to the default values, and then set all
configuration property information in the physical device on
the network to match the information stored in the OpenLNS
database. As a result, once the device has been
commissioned, it will contain current values for any
configuration properties that have been explicitly set, and
default values for any configuration properties that were
unknown before the download.
Note that by using the DownloadConfigProperties method as
described above, you will preserve the information stored in
the OpenLNS database for the AppDevice object, by
changing the configuration property information stored in
the physical device to match that stored in the OpenLNS
database. In some cases, you may want to do the opposite.
You may want to change the configuration property
information stored in the OpenLNS database for the
AppDevice object , to match the information stored in the
physical device on the network before commissioning. This
can usually be accomplished using the
UploadConfigProperties method, but you cannot use this
method until a device has been commissioned. If you are
commissioning a device for the first time and want to
preserve the configuration property information stored in the
physical device, not the information in the database, the
solution is to call the DownloadConfigProperties and use the
lcaConfigPropOptSetUnknown value as the download
option. All configuration property information in the
database will be set to unknown, but the configuration
property in the physical device will not be affected. Once the
device has been commissioned, you can use the
UploadConfigProperties method to set the configuration
property in the database to match the configuration property
information that had been stored in the device.
It is recommended that you use the same explicit transaction
to call DownloadConfigProperties and the Commission
method. Otherwise, this procedure will take longer, and
consume more network bandwidth, than it would when
performed within a transaction.
Do not read or write to the State property of an AppDevice or
Router in the same explicit transaction with this method.
In addition, you must set the InitialAuthenticationKey
property to the proper value before commissioning an
application device that has network management
authentication enabled, and has been previously
commissioned outside of LNS, or commissioned on a different
OpenLNS network. In these circumstances, OpenLNS will
not be able to communicate with the device or router without