LonWorks Import Module

The LonWorks Import Module lets your ION meter accept data from a LonWorks network.

Module icon

Overview

NOTE: The LonWorks Import Module is available only on certain meters (those with older firmware).

The module takes a LonWorks input network variable and converts it to an ION register. As discussed below, the input network variable must be one of the standard network variable types (SNVTs) as specified by the SNVT setup register.

The LonWorks Import Module, together with the LonWorks Export Module, allows an ION meter to be integrated into a LonWorks network. Once you have imported data from another LonWorks-compatible device and converted it to ION, you can manipulate the data using the advanced features of your meter, thus extending the capabilities of the LonWorks network. Additionally, you can expand the I/O capabilities of your meter by adding LonWorks-compatible I/O devices.

NOTE: The registers and settings available in this module depend on the device or node you are configuring, as well as its firmware and template versions. Not all registers or settings are available on all devices or the Virtual Processor, and labels may vary.

Inputs

The input is a network variable from a LonWorks network. Each LonWorks Import module has one network variable associated with it.

Setup registers

SNVT

This register defines Standard Network Variable Type (SNVT) that the module imports. It indicates to the LonWorks Network Manager what kind of data the module is expecting. In effect, it associates a unit with the value. For devices on a LonWorks network to be logically connected, they must use the same data type (i.e. the same SNVT).

By specifying a particular SNVT, you are implicitly defining the kind of data the module will be handling. For example, if a device on the LonWorks network delivers a network variable representing temperature, and this is the value you want to convert to an ION register, you must set this setup register to SNVT_temp_f. For a detailed description of each SNVT, refer to LonMark’s SNVT Master List, or visit LonMark’s website at www.LonMark.org (note however that the LonWorks Import module only supports those SNVTs listed in its SNVT setup register).

Output registers

Netvar

This numeric register contains the value of the input SNVT (see the SNVT setup register description) accepted by the module.

BindState

This register indicates that the input network variable imported by the module is bound to at least one other output network variable.

Event

All events produced by the module are written into this register. Events mark changes to the SNVT setup register, input links, and the state of the BindState output register. The following information is stored for each ION event: time stamp, event priority (in this module, all events have a pre-defined priority of 10), the event’s cause, the event’s effect, and conditions associated with the event’s cause and effect.

Responses to special conditions

The following table summarizes how the module behaves under different conditions.

ConditionResponse
Module is first createdIf the SNVT setup register is set to SNVT_not_used, Netvar will be set to zero. If the SNVT setup register is set to anything else, Netvar will be set to its exception value. *
The module’s network variable is not boundNetvar will be set to the network variable’s exception value. *
Output network variable was there but got deletedNetvar will remain at the last updated value.
On device power upNetvar will remain at the last updated value.
* Some SNVT types support a specific exception value; others will go to their minimum value to indicate an exception.

NOTE: If the network variable is bound, you cannot delete the LonWorks Import module. You must first unbind it using a LonWorks network manager.

Detailed module operation

The figure below illustrates the operation of a LonWorks Import module. The LonWorks device delivers its data to the network in the form of an output network variable. The ION meter contains a LonWorks Import module whose SNVT setup register has been set to match the SNVT of the network variable.

NOTE: If the network variable is bound, you cannot delete the LonWorks Import module. You must first unbind it using a LonWorks network manager tool.

The Network Manager recognizes the two devices and binds (performs the logical connection) between them. Thus, the data is imported from the LonWorks network, converted to an ION register and made available to the advanced features of the ION device.

You must create and configure all the LonWorks Import modules you plan to use before installing the device on the LonWorks Network. If you create any new LonWorks Import modules or you change their configuration, you will have to reinstall the device on the LonWorks Network for your changes to be detected.

Supported SNVTs

The ION7300-LONFT’s LonWorks Import and LonWorks Export modules support the following SNVTs:

Measurement

SNVT Name

Range

Resolution

SNVT #

Exception Value
 

SNVT_not_used

        

Current (integer)

SNVT_amp

-3,276.8 ..  3,276.7 A

0.1 A

1

-3,276.8 A

Current (float)

SNVT_amp_f

-1E38 ..  1E38 A

  

48

-1E38 A

Current [millie] (integer)

SNVT_amp_mil

-3,276.8 ..  3,276.7 mA

0.1 mA

2

-3,276.8 mA 

Phase/Rotation [degree] (integer)

SNVT_angle_deg

-359.98 ..  360.00 deg

0.02 deg

104

655.34 deg 

Phase/Rotation (float)

SNVT_angle_f

-1E38 ..  1E38 radians

  

49

-1E38 rads

Energy, thermal (float)

SNVT_btu_f

-1E38 ..  1E38 BTU

  

67

-1E38 BTU

Energy, thermal [kilo] (integer)

SNVT_btu_kilo

0 ..  65,535 kBTU

1 kBTU

5

0 kBTU

Energy, thermal [mega] (integer)

SNVT_btu_mega

0 ..  65,535 MBTU

1 MBTU

6

0 MBTU

Count, event (integer)

SNVT_count

0 ..  65,535 counts

1 count

8

0 counts

Count, event (float)

SNVT_count_f

-1E38 ..  1E38 counts

  

51

-1E38 counts

Count, incremental (integer)

SNVT_count_inc

-32,768 ..  32,767 counts

1 count

9

-32,768 counts

Count, incremental (float)

SNVT_count_inc_f

-1E38 ..  1E38 counts

  

52

-1E38 counts

Energy, electrical [kilo] (integer)

SNVT_elec_kwh

0 ..  65,535 kWh

1 kWh

13

0 kWh

Energy, electrical (integer)

SNVT_elec_whr

0 ..  65,53.5 Wh

0.1 Wh

14

0 Wh

Energy, electrical (float)

SNVT_elec_whr_f

0 ..  1E38 Wh

  

68

0 Wh

Flow (integer)

SNVT_flow

0 ..  65,534 l/s

1 l/s

15

65,535 l/s

Flow (float)

SNVT_flow_f

-1E38 ..  1E38 l/s

  

53

-1E38 l/s

Frequency (float)

SNVT_freq_f

-1E38 ..  1E38 Hz

  

75

-1E38 Hz

Frequency (integer)

SNVT_freq_hz

0 ..  6,553.5 Hz

0.1 Hz

76

0 Hz

Level, continuous (integer)

SNVT_lev_cont

0 ..  100%

0.50%

21

0%

Level.  continuous (float)

SNVT_lev_cont_f

0 ..  100%

  

55

0%

Level, discrete

SNVT_lev_disc

ST_OFF, ST_LOW .. ST_ON

¼ level

22

ST_NUL

Level, percent

SNVT_lev_percent

-163.84% ..  163.83%

0.005% or 50 ppm

81

163.84%

Power (integer)

SNVT_power

0 ..  6,553.5 W

0.1 W

27

0 W

Power (float)

SNVT_power_f

-1E38 ..  1E38 W

  

57

-1E38 W

Power [kilo] (integer)

SNVT_power_kilo

0 ..  6,553.5 kW

0.1 kW

28

0 kW

Pressure - absolute (float)

SNVT_press_f

0 ..  1E38 Pa

  

59

0 Pa

Pressure - gauge (integer)

SNVT_press_p

-32,768 ..  32,766 Pa

1 Pa

113

32,767 Pa

Power factor (integer)

SNVT_pwr_fact

-1.0 ..  1.0 

0.00005

98

-1

Power factor (float)

SNVT_pwr_fact_f

-1.0 ..  1.0

  

99

-1

Angular Velocity [RPM] (integer)

SNVT_rpm

0 ..  65,534 revs/min

1 rev/min

102

65,535 revs/min

Temperature (integer)

SNVT_temp

-274 ..  6279.5 °C

0.1 °C

39

-274 °C

Temperature (float)

SNVT_temp_f

-273.17 ..  1E38 °C

  

63

-273.17 °C

Temperature [HVAC] (integer)

SNVT_temp_p

-273.17 ..  327.66 °C

0.1 °C

105

327.67 °C

Time - elapsed (float)

SNVT_time_f

-1E38 ..  1E38 s

  

64

-1E38 s

Time - elapsed (integer)

SNVT_time_sec

0.0 ..  6,553.4 s

0.1 s

107

6,553.5 s

Voltage (integer)

SNVT_volt

-3,276.8 ..  3,276.7 V

0.1 V

44

-3,276.8 V

Voltage (float)

SNVT_volt_f

-1E38 ..  1E38 V

  

66

-1E38 V

Voltage [milli] (integer)

SNVT_volt_mil

-3,276.8 ..  3,276.7 mV

0.1 mV

47

-3,276.8 mV