Enhanced configuration property management, Online database validation and backup – Echelon LNS User Manual

Page 30

Advertising
background image

LNS Programmer's Guide

16

LNS Turbo Edition also includes a new option (lcaReplaceFlagPropagateUpdates)

for the ReplaceEx() method, which you can use to replace an AppDevice or Router. If
you call the Replace() method, or if you call the ReplaceEx() method without

specifying the lcaReplaceFlagPropagateUpdates option, on a device while the
system management mode is set to lcaMgmtModeDeferConfigUpdates, the physical

devices will not be updated with configuration changes caused by the replace process
until the system management mode is set back to
lcaMgmtModePropagateConfigUpdates. You can now use the ReplaceEx() method

with the lcaReplaceFlagPropagateUpdates option to replace devices while the
system management mode is still set to lcaMgmtModeDeferConfigUpdates. This may

be useful if there are configuration changes pending for a large number of devices, and
you want to replace a device without waiting for all of those changes to be applied. A
similar option is also provided for use with the new CommissionEx() method, which you

can use to re-commission a device while the system management mode is set to
lcaMgmtModeDeferConfigUpdates.

Finally the OnSystemMgmtModeChangeEvent event has been added to the
ObjectServer object. Once an application registers for this event, it will be fired each

time the system management mode changes.

For more information on the features described in this section, see Chapter 6, Defining,

Commissioning and Connecting Devices.

Enhanced Configuration Property Management

Several properties have been added to the ConfigProperty object that will allow your

application to better identify the source and configuration of a ConfigProperty object.

For example, in some cases the value stored in the LNS database for a configuration

property may not match the actual value of the configuration property in the physical
device on the network. To help you make this determination, the ValueStatus has been

added to the ConfigProperty object. The ValueStatus property indicates whether or

not the value currently stored in the LNS database for a configuration property matches

the value stored in the physical device on the network.

Two additional properties, the DeviceSpecificAttribute and ConstantAttribute

properties, have been added to the ConfigProperty object. These properties allow you

to read and write the device-specific and constant attributes of the configuration property

with your LNS application.

For more information on these configuration property attributes, see the Configuration

Property Flags section of version 3.3 of the LonMark Application-Layer Interoperability
Guidelines
. For more information on configuration properties in this document, and for

information on how you might want to use configuration properties within an LNS

application, see Using Configuration Properties In a Monitor and Control Application on
page 233.

Online Database Validation and Backup

LNS Turbo Edition features two new ways to help you maintain your LNS network

databases: online backup and database validation. You can perform database validations
using the LNS Database Validation Tool, or by calling the Validate() method on a
Network object. When you perform a database validation, LNS will process the contents

Advertising