Echelon LNS - Manual (Page 137)

LNS Programmer's Guide 123
NOTE: As of LNS Turbo Edition, each DeviceTemplate object includes a
DeviceValidation property. The DeviceValidation property determines what
validation steps LNS will perform when you commission devices using that
DeviceTemplate. For more information on this, see the next section, Device Validation
Options.
Echelon recommends that you perform initial commissions only while the system
management mode is lcaMgmtModePropagateConfigUpdates. This allows LNS to
validate the device’s interface and channel, and to control the commissioning process.
Suppose many devices have been defined and commissioned while the system
management mode is set to lcaMgmtModeDeferConfigUpdates. When the system
management mode is set back to lcaMgmtModePropagateConfigUpdates, LNS will
immediately start commissioning all of these devices. This process may take a long time,
and the LNS application will be “locked out” during this process.
See the LNS Object Server Reference help file for details on the syntax required when you
call Commission() and CommissionEx().
Device Validation Options
When you commission a device, LNS will validate that the physical device has the same
external interface and program ID assigned to the AppDevice object in the LNS
database. It will also validate that the physical device is on the channel assigned to the
AppDevice object. If the physical device is not using the external interface or program
ID assigned to it in the database, the commission will fail, and either the NS#59
lcaErrNsProgramIntfMismatch or the NS#38 lcaErrNsProgramidMismatch
exceptions will be thrown. If the physical device is not on the channel assigned to it in
the database, the commission will fail and the NS#72 lcaErrNsWrongChannel
exception will be thrown.
As of LNS Turbo Edition, each DeviceTemplate object includes a DeviceValidation
property. This determines what validation steps LNS will perform when you commission
devices that use the DeviceTemplate. This will be useful if you are commissioning a
large number of devices that are on a slow channel, and you are confident that the
devices contain the correct program information and are installed on the correct channel.
If you want to reduce the time it takes to commission the device in this situation, you can
set the DeviceValidation property to any of the following values:
• lcaDeviceValidationNoChannelValidation: Do not validate the device’s
channel.
• lcaDeviceValidationNoProgramInterfaceValidation: Do not validate the
device’s program interface.
• lcaDeviceValidationNoProgramIDValidataion: Do not validate the
device’s program ID.
See the LNS Object Server Reference help file for more information on these options. The
default is for LNS to perform all validation steps. If you modify this property from the
default, you should be sure that the Channel and ProgramId properties of all
AppDevice objects using the device template have valid settings before commissioning
those devices. Failure to do so may cause improper configuration of the device, and may
make it impossible to communicate with the device.