Description, Devicespecificattribute – Echelon OpenLNS User Manual

Page 197

Advertising
background image

OpenLNS Programmer's Reference

160

Description

Summary

Stores description information about the

ConfigProperty

object

.

Availability

Local, full, lightweight, and independent clients. Note that

some collections are not available to Independent clients.

Syntax

stringValue = object.Description

Element

Description

stringValue

A string description of the

ConfigProperty

object.

object

The

ConfigProperty

object to be acted

on.

Data Type

String.

Read/Write

Read/write.

Added to API

This depends on the object used to access the property.

Generally, this property exists for the objects listed above as

soon as they are added to the API. See the applicable object

to determine what release it was introduced in.

DeviceSpecificAttribute

Summary

Reads or writes the the device-specific attribute of the

configuration property.

Many configuration properties contain a device-specific

attribute, which indicates that the value of the configuration

property can be changed without the network manger’s

knowledge. For example, the configuration property value

may be changed locally by the device itself, or remotely by

another device on the network. As a consequence, the value

of the device stored in the OpenLNS database may not be the

most current value. It is not possible for LNS to know

whether the value of a device-specific configuration property

stored in the device or in the OpenLNS database is the

current value.
Depending on the setting of the SourceOptions property, the

device-specific attribute affects how OpenLNS will read or

write the value of the configuration property when it is

accessed via a data point, or via the ConfigProperty object’s

GetRawValuesEx

and

SetRawValuesEx methods. It may also

affect what configuration property values are downloaded or

uploaded to the OpenLNS database when you call the

DownloadConfigProperties and UploadConfigProperties

methods.
Initially, the device-specific attribute is defined by the

programmatic interface of the device, in the device’s external

interface file or self-documentation. However, whether the

configuration property can or should be modified without the

knowledge of OpenLNS is often dependent on the

Advertising