Echelon LNS - Manual (Page 136)

LNS Programmer's Guide 122
was created. If a DeviceTemplate and Channel were specified, the
network address was assigned at that time.
• Extracts the external interface from the device, if no DeviceTemplate
object was specified when the AppDevice object was created. If a
DeviceTemplate object was specified, the commission process will
validate the DeviceTemplate object against the device interface on the
physical device.
• Sets all of the unbound address table and network variable configuration
table entries in the device to the unbound state.
• Downloads connection information for the device, if the device was added
to connections before it was commissioned.
• Sets the device’s non-group receive timer to a default value that is based
on the network topology.
• Sets or determines the device’s channel.
• Sets the device’s state to lcaStateCnfgOffline.
Using the Commission and Commission Ex Methods
The CommissionEx() method has been added to LNS for Turbo Edition. There is no
functional difference between the CommissionEx() and Commission() methods, other
than their behavior while the system management mode is set to
lcaMgmtModeDeferConfigUpdates.
If you invoke the Commission() method while the system management mode is set to
lcaMgmtModeDeferConfigUpdates, the physical device will not updated with the
configuration changes caused by the commission process until the system management
mode is set back to lcaMgmtModePropagateConfigUpdates. However, the
CommissionEx() method allows you to specify options that will cause the physical
devices to be updated if you are recommissioning a device while the system management
mode is set to lcaMgmtModeDeferConfigUpdates.
This is useful if there are a large number of configuration changes pending, and you need
to recommission a device without waiting for the rest of the changes to propagate to the
network. Recommissioning a device while the system management mode is set to
lcaMgmtModeDeferConfigUpdates updates the device with the configuration defined
for the device when the system management mode was last set to
lcaMgmtModeDeferConfigUpdates. This ensures that the network is configuration is
consistent. It is not possible to propagate updates to a device while the while the system
management mode is set to lcaMgmtModeDeferConfigUpdates if the device has never
been commissioned before, as this may introduce network inconsistencies.
When using either method to commission a device while the system management mode is
set to lcaMgmtModePropagateConfigUpdates, LNS will validate that the program
ID, channel and interface assigned to the device are valid. If you invoke the
Commission() method while the system management mode is set to
lcaMgmtModeDeferConfigUpdates, LNS will not perform these validation steps. In
contrast, the CommissionEx() method allows you to specify options to perform the
validation while the system management mode is set to
lcaMgmtModeDeferConfigUpdates.