beautypg.com

Echelon OpenLNS User Manual

Page 321

background image

OpenLNS Programmer's Reference

284

template.
The valid values for this property,

which are contained in the

ConstSelfDocConsistency constant, are

as follows:
0

lcaSelfDocConsistencyIdenticalOn

AllDevices
The self-documentation on devices

using the device template must be

identical. This is the most efficient, but

least flexible, setting of this property.

It is the default for all devices without a

LonMark standard program ID.
1

lcaSelfDocConsistencyStringsMay

DifferByDevice
The self-documentation on devices of

this type may include different

self-documentation strings, but must

use the same self-information data

format. This is the default for all

devices with a LonMark standard

program ID.
2

lcaSelfDocConsistencyStringsAnd

FormatMayDifferByDevice
The self-documentation on devices of

this type may include different

self-documentation strings, and may

use different self-documentation data

formats.
The more restrictive values

(lcaSelfDocConsistencyIdenticalOn

AllDevices 0 or

lcaSelfDocConsistencyStringsMay

DifferByDevice 1) allow OpenLNS to

assume higher degrees of

self-documentation consistency among

devices using this template, and cause

OpenLNS to operate more efficiently

when validating the program interface

of those devices while commissioning.

However, these settings may cause

problems if the device developer has

produced multiple devices that have the

same program ID, but use different

self-documentation strings or formats.
As a result, do not set this property to a