Echelon OpenLNS User Manual

Page 311

Advertising
background image

OpenLNS Programmer's Reference

274

that specified by the application, and the program interface

in the device matches the previously defined program

interface for that program ID. This validation occurs to

prevent users from configuring a device incorrectly.
This validation, however, does require the transmission of a

large number of messages between OpenLNS and the device.

This can be very time consuming, particularly on slow media,

and can greatly increase the time required to commission the

devices on a network.

You can use this property to determine which validation

steps OpenLNS will perform when you are commissioning,

replacing or upgrading a device.

Availability

Local, full, and lightweight clients.

Syntax

validationOption = devTemplateObject.DeviceValidation

Element

Description

validationOption

The validation options used when

commissioning or replacing devices

that use this device template.
The valid settings for this property,

which are contained in the

ConstDeviceValidation

constant, are

as follows:
0 lcaDeviceValidationNormal
This is the default value. When this

value is used, all validation steps

will be performed.
In this case, the commission

procedure will validate that the

physical device has the same

external interface and program ID as

defined for the

AppDevice

object in

the OpenLNS database. It will also

validate that the device is on the

channel assigned to it in the

OpenLNS database.
If the physical device is not using the

same external interface or program

ID as defined for the

AppDevice

object in the database, the

commission will fail, and either the

NS, #59

lcaErrNsProgramIntfMismatch

or NS, #38

lcaErrNsProgramidMismatch

exceptions

will be thrown.

If the physical device is not on the

channel assigned to it in the

Advertising