Echelon LNS - Manual (Page 102)

LNS Programmer's Guide 88
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.