Dsisdefaultformat – Echelon OpenLNS User Manual

Page 631

Advertising
background image

OpenLNS Programmer's Reference

594

was used for pre-LonMark resource

files.

nvObject

The

NetworkVariable

object to be acted

on.

Data Type

String.

Read/Write

Read/write.

Added to API

Prior to LNS Release 3.0.

DsIsDefaultFormat

Summary

Indicates whether the network variable is using its default

format

.

OpenLNS determines the default format to use for SNVT

network variables by reading the SNVT ID of the network

variable, and using it to locate the applicable entry for that

SNVT type in the standard resource files. OpenLNS then

reads the default type from the resource file.
OpenLNS determines the default type to use for UNVT

network variables on LonMark objects by reading the

Functional Profile Template of the LonMark object and

locating the applicable entry for the UNVT type in the

user-defined resource files, based on the NV members

contained within the FPT. Once this is done, it reads the

default type for the UNVT from the resource file entry.

UNVT network variables that are not on LonMark objects

default to the type "RAW."
If OpenLNS cannot read the format files, or if it is unable to

determine a network variable’s default format for any reason,

the format assigned to the network variable will be "RAW."
The

LdrfCatalogPath

of the

System

object must point to the

actual location of the LonMark Device Resource File catalog

for OpenLNS to read the format files.

You can change the format assigned to a network variable by

writing to its DsFormatType property. You can restore the

default format to a network variable at any time by writing

an empty string to the DsFormatType property. Once you

have done so, the DsIsDefaultFormat property will return

True.

Availability

Local, full, and lightweight clients.

Syntax

isDefault = nvObject.

DsIsDefaultFormat

Element

Description

isDefault

A Boolean value, which

depends on the

value returned by the DsFormatType

property.
TRUE. The DsFormatType property is

the same as the network

Advertising