Commussionex, Commissionex – Echelon OpenLNS User Manual

Page 69

Advertising
background image

OpenLNS Programmer's Reference

32

knowing its authentication key, since the device has

authentication enabled. If the InitialAuthenticationKey is set

prior to commissioning the device or router, OpenLNS will

use this key to authenticate messages sent to the device or

router during the commissioning process.
See Chapters 5 and 6 of the OpenLNS Programmer’s Guide

for more information on the steps you should take when

installing devices on a network and commissioning those

devices.

Availability

Local, full, and lightweight clients.

Syntax

object.Commission

Element

Description

object

The

AppDevice

object to be

commissioned.

Added to API

Prior to LNS Release 3.0.

CommussionEx

Summary

Associates an

AppDevice

object with a physical device, and

loads the device’s network image. This method is the same as

the

Commission

method except that it provides additional

options that you can choose from when commissioning the

device (see the description of the options element for more

information).

Availability

Local, full, and lightweight clients.

Syntax

object.CommissionEx options

Element

Description

object

The

AppDevice

object to be commissioned.

options

A Long value indicating the options to be

used when commissioning the device. This

determines whether the changes caused by

the commission process will be applied to

the physical device if the

network

management mode

is set to

lcaMgmtModeDeferConfigUpdates (1).
The values for this element, which are

stored in the

ConstCommissionFlags

constant, are as follows:

0 lcaCommissionFlagNone
Updates the device as soon as the

network management mode is set to

lcaMgmtModePropagateConfigUpda

tes (0).
Use this option if you do not want the

device to be updated if the network

management mode property is set to

Advertising