LONMARK Resource Files, version 13.04

LonMark International
  {LONMARK International}
 

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.

     

    Echelon Resource Report Generator 3.13.15
    Copyright (C) 2001 - 2009 Echelon Corporation