|
|
Standard.* files:
|
|
This file is the standard type file,
containing Standard Network Variable Types (SNVTs), Standard
Configuration Property Types (SCPTs), and the enumeration types that
support them. This file was created and is maintained by LonMark
International. Contact LonMark International at +1-408-938-5266, at
www.lonmark.org, or at 550 Meridian Ave, San Jose CA 95126, USA. To
install these resource files, please visit this page.
|
Standard Network Variable
Types (SNVTs)
|
Standard Configuration Property
Types (SCPTs)
|
Standard Functional Profile
Templates (SFPTs)
|
Standard Enumeration
Types
|
LONWORKS® devices typically exchange data using
network variables. Network
variables greatly simplify the tasks of designing LONWORKS application
programs for interoperability with multiple vendors’ products. A
network
variable is any data item (temperature, a switch value, or an
actuator position
setting) that a particular device application program expects to get
from other
devices on the network (an input network variable) or
expects to make available
to other devices on the network (an output network variable).
When the application program has a changed value for an output
network
variable it simply passes the new value to the device firmware. Via a
process that
takes place during network design and installation called binding,
the device
firmware is configured to know the logical address of the other
devices or group
of devices in the network expecting that network variable, and it
assembles and
sends the appropriate packets to these devices. Similarly, when the
device
firmware receives an updated value for an input network variable
required by its
application program, it passes the data to the application program.
The binding
process thus creates logical connections between an output
network variable in
one device and an input network variable in another device or group
of devices.
Connections may be thought of as “virtual wires.”
Every network variable has a type that defines the units,
scaling, and structure of
the data contained within the network variable. Network variables
must be the
same type to be connected. This prevents common installation errors
from
occurring such as a pressure output being connected to a temperature
input. Type
translators are available to convert network variables of one type to
another type.
This document defines standard network-variable types (SNVTs,
pronounced
sniv-its) that define commonly used types. Alternatively,
manufacturers may
define their own user network-variable types (UNVTs,
pronounced you-niv-its).
Network variables are used for operational communication between LONWORKS
devices. Besides this type of communication, most devices also
require
customization for a specific system application. Configuration
properties
provide a standard mechanism that can be used by network tools to
download
customization data to a LONWORKS
device. This document also defines a
standard set of configuration property types; these are called standard
configuration-property types (SCPTs, pronounced skip-its).
Manufacturers may
also define their own configuration property types; these are called user
configuration-property types (UCPTs, pronounced you-keep-its).
SCPTs are
defined for a wide range of configuration properties used in many
kinds of
functional profiles, such as hysteresis bands, default values,
minimum and
maximum limits, gain settings, and delay times. SCPTs are to be used
wherever
applicable. In situations where there is not an appropriate SCPT
available,
manufacturers may define UCPTs for configuring their devices, but
these must
be documented in manufacturer-specific resource files.
Each SNVT and SCPT is a scalar or structure type. A scalar type
represents a
single value that is a fixed-point number, floating-point number, or
enumeration.
A structure is a set of one or more scalar values, embedded
structures, arrays,
and/or unions. Each scalar type may define a minimum and maximum
range,
called the valid range.
|
Type
|
Maximum Valid Range
|
|
Enumeration
|
-128 .. 127
|
|
Signed Short
|
-128 .. 127
|
|
Unsigned Short
|
0 .. 255
|
|
Unsigned Char
|
0 .. 255
|
|
Signed Long
|
-32,768 .. 32,767
|
|
Unsigned Long
|
0 .. 65,535
|
|
Signed Quad
|
-2,147,483,648 .. 2,147,483,647
|
|
Unsigned Quad
|
0 .. 4,294,967,295
|
|
Single-Precision Floating Point
|
-3.402823466E+38 .. 3.402823466E+38
|
|
Double-Precision Floating Point
|
-1.7976931348623157E+308 ..
1.7976931348623157E+308
|
The representation for floating-point types is ANSI/IEEE 754:
Single-precision
floating point valuess have 1 sign bit, 8 exponent bits, and
23 mantissa bits, for a total of 32 bits. The single-precision
floating-point
data type is compatible with the float_type defined by Neuron C.Double-precision
floating point values have 1 sign bit, 11 exponent bits, and
52 mantissa bits, for a total of 64 bits.
The representation for enumeration types is a single byte
representing a value
from an enumeration list. Standard enumeration types are defined in a
separate
enumeration master list.
Functional profiles are used
to define the functional behavior of SNVTs and
SCPTs. Functional profiles define mandatory and optional network
variables and
configuration properties, and the type to be used for each.
Functional profiles
may define a simple function such as a sensor or actuator, or may
define a more
complex function such as a space comfort controller or scheduler.
Many
standard functional profiles are defined at www.lonmark.org/profiles;
manufacturers may
also define manufacturer-specific functional profiles.
Resource files provide a standard mechanism to document
types and profiles for
use by network tools. The LONMARK
standard resource file set defines SNVTs,
SCPTs, standard enumeration types, and standard functional profiles.
This
document defines the SNVT, SCPT, and enumeration types contained in
the
standard resource file set. Functional profile documents available at
www.lonmark.org/profiles
define the standard functional profiles defined in the
LONMARK standard
resource file set. |
| |
This report
was generated Tue Dec 14 13:04:00 2009
to document the LONMARK Resource Files version 13.04.
To install these resource files, please visit this page.
|
|