Echelon LNS User Manual

Page 102

LNS Programmer's Guide

properties for that template were not uploaded after another device with the

same template was commissioned. The next step of this procedure describes how
you can upload the configuration properties for the template.

MySystem.StartTransaction

MyDevice.Commission()

Set MyInterface = MyDevice.Interface

If MyInterface.ConfigPropertiesAvailable Then

MyDevice.DownloadConfigProperties _

(lcaConfigPropOptLoadValues OR lcaConfigPropOptSetDefaults)

End If

MySystem.CommitTransaction()

For more information on other considerations you should make when
commissioning devices, see Commissioning Devices on page 121.

6. If

the

ConfigPropertiesAvailable property was set to False in Step 5, or if

you bypassed calling the DownloadConfigProperties() method in Step 5 to

preserve the configuration property values stored in the physical device, upload
the configuration property definitions into the LNS database with the
UploadConfigProperties() method. This will change the
ConfigPropertiesAvailable property on all devices using this template to
True (or False, depending on the device’s implementation).

Typically, you will also want to upload the values from the device and set the
defaults from the device by specifying the lcaConfigPropOptLoadValues and
lcaConfigPropOptSetDefaults options when you call the
UploadConfigProperties() method. Alternatively, you could update some or

all of the configuration property values using data points, and then call
UploadConfigurationProperties() with the
lcaConfigPropOptLoadValues, lcaConfigPropOptSetDefaults and
lcaConfigPropOptLoadUnknown options set to upload all values not

specifically set, and then set the defaults to the values defined for this device.

Note that for optimal performances, you should set all configuration property
values in a single transaction. For more information on these tasks, see

Application-specific Configuration Data on page 125.

7. Set

the

Priority and Location properties of the AppDevice object to their

desired values. Optionally, set any other properties of the AppDevice object as

described in Generic Configuration Data on page 125. You can perform this step

in the same transaction as when you commission the device.

8. Bring all the devices online by setting the State property of each AppDevice

object to lcaStateCnfgOnline.

9. Figure 5.4 references additional tasks you may need to perform when managing

the network you create with the ad hoc installation scenario, such as removing
devices, creating connections, and replacing devices. For details on how to

perform these tasks, see Other Device Management Operations on page 129.

NOTE: Depending on the system management mode, the changes you make to each

device may or may not be propagated to the physical device on the network as you invoke
each method. For more information on this, see the System Management Mode

Considerations section later in this chapter.