beautypg.com

Echelon OpenLNS User Manual

Page 201

background image

OpenLNS Programmer's Reference

164

a SNVT_xxx type, it will be formatted as specified by the

format file.

2. If the ConfigProperty object’s type does not appear in the

Device Resource File Type and Format files, or if it

appears but is designated as a SNVT_xxx type, the

OpenLNS Server will check to see if it applies to a

standard network variable. If it does, it will be formatted

according to the SNVT format specification in

STANDARD.FMT.

3. As a third option, OpenLNS will use the Hex Byte String

format as the default. In this case, each byte of the raw

value assigned to the ConfigProperty object will be

displayed as two hexadecimal digits. For example, the

byte sequence 1,2,3,4 would be displayed as 01020304.

Overriding the Best-Guess Format
When you successfully write to this property, the new value

will be stored persistently in the OpenLNS database.

However, you can revert the property back to the default

value chosen by OpenLNS at any time by writing an empty

string or the exact name of the type (e.g. SCPTmaxFlow) to

it. There are several possible syntaxes you can use when

writing to this property if you want to override the best-guess

format:
1. A format name beginning with "SCPT" for standard type

formats or "UCPT" for user-defined type formats (e.g.,

"SCPTmaxFlow"). The Data Server will use the resource

file catalog specified using the LdrfCatalogPath property

to search for SCPT and UCPT formats. There may be

several different formats for the same network variable

type. For example, the LonMaker Integration Tool has

two alternate formats for the type SCPTmaxFlow, and

those formats are named SCPTmaxFlow#SI and

SCPTmaxFlow#US.

In OpenLNS, the default formats for types such as

SCPTmaxFlow are determined using the Windows

regional settings of the computer where the data is

formatted (on the computer housing the OpenLNS Server

for local and lightweight clients, or on the computer

running the application for full clients). To determine

the settings being used on a computer, open the Windows

Control Panel and double-click the Regional Options icon.

Select the Numbers tab. OpenLNS uses the value of the

Measurement System field (either U.S. or metric) on this

tab to determine the default format to use for types such

as SCPTmaxFlow. You can also specify a full format

name (e.g. SCPTmaxFlow #SI or SCPTmaxFlow#US) to

select a specific format for that type. For UNVTs, you

must always specify a fully-qualified format name.

2. In some cases, a format exists for a given SCPT or UCPT