beautypg.com

Unitsmultiplier, Interface, F interface o – Echelon OpenLNS User Manual

Page 408: N interface ob, Unitsmultiplier an

background image

OpenLNS Programmer's Reference

371

Data Type

Single.

Read/Write

Read only.

Added to API

LNS Release 3.0.

UnitsMultiplier

Summary

Determines how the scaled value of the data point or monitor

point will be unit-converted for display as a formatted value

when your application reads the

FormattedValue

propery

.

When your application reads the

FormattedValue

property of

a data point or monitor point, the OpenLNS Object Server

converts the scaled value of the data point or monitor point

so that it can be display as a formatted value.
To unit-convert the value, LNS first multiplies it by the value

in the

UnitsMultiplier

property. It then adds the value stored

in the

UnitsAdder

property. The resulting value will be

appropriate for the

units

that apply to this format

specification.
Different data formats for the same data type will be on

different scales. For example, the SNVT_temp_f data type

contains the temperature in degrees Celcius. In order to

display the temperature in Fahrenheit, you would have to

multiply the value by 1.8 (9/5), and then add 32.

Availability

Local, full, lightweight, and independent clients. Independent

clients can only access

FormatSpec

objects through monitor

points in permanent monitor sets.

Syntax

unitsMultiplier = fsObject.UnitsMultiplier

Element

Description

unitsMultiplier

The value to be multiplied.

fsObject

The

FormatSpec

object to be acted on.

Data Type

Single.

Read/Write

Read only.

Added to API

LNS Release 3.0.

Interface

An Interface object represents an application device’s external interface, which is

the logical

interface to a device. A device’s interface specifies the number and types of functional

blocks; number, types, directions, and connection attributes of network variables; and the

number of message tags.

The Interface object can be used both in the context of a particular

program (part of the

DeviceTemplate

object), a particular application device (part of the

AppDevice

object), or a particular network services device (contained within an

Interfaces

collection).
The Interface objects contained by an application device may be a device’s main interface, or

they may be custom interfaces that have been added to the device. The main interface of a

device can be accessed through the device’s

Interface

property. Main interfaces are static