Trane LNS Plug-Ins Version 1

4/27/2017 Trane
LNS Plugins Version 1.08
Trane LNS Plugins Version 1.09
© 2011 Trane. All rights reserved.
Plugin Installation
It is not necessary to have the Rover Service Tool software installed on your PC; if you do, Rover V7.1 SP9 is required.
The installation program will install all necessary files and create an import directory for the XIF files in
Lonworks/import/Trane.
Changes
General software changes
 Updated XIF files for Tracer LCIR DAC and SCC.
Plugin Installation
Changes
 LNS template plugin code was updated to fix checking against LNS version with regional settings
applied that use the comma ',' as the decimal symbol.
Plugin Installation
Changes
 Modified installation to support Rover V7.1 SP7
 Updated XIF files for Tracer ZN510/511, Tracer ZN520/521 and Tracer VV550/551.
https://home.ingerrand.com/sites/softwaredownloads/SiteAssets/Literature/LNS%20Plugins%201.09%20Readme.htm 1/14
4/27/2017 Trane LNS Plugins Version 1.08
ZN510/511
 A plugin was created to support the Tracer ZN510/511 Controller image 3.02.
 Corrected an issue where renaming the Tracer ZN510 controller would cause an invalid controller
configuration.
Plugin Installation
Changes
 Updated XIF files for Tracer ZN520/521 and Tracer ZN525.
ZN510/511
 The plugin was modified to support the Tracer ZN510/511 Controller.
 Corrected an issue where renaming the Tracer ZN510 controller would cause an invalid controller
configuration.
 Fixed the spelling of Receive Heartbeat in advanced configuration.
ZN520/521
 The plugin was modified to support the Tracer ZN520/521 Controller.

 Added a “Enable Fan Ramp Up” checkbox to cooling/heating frames on the Fan Tab. This feature is
only supported when using firmware 2.5 and up.
ZN524
 The plugin was modified to support the Tracer ZN524 Controller.
 Modified the plugin to allow Rover to disable/enable waterside economizer.
Plugin Installation
Changes
 Updated XIF files for Tracer ZN510/511, ZN517, ZN520/521, ZN524, and VV550/VV551.
AH540/541
 Plugin was modified.
MP501
MP580/581
ZN510/511
 Plugin was modified to support the Tracer ZN510 Controller which now supports flash download.
ZN517
ZN524
 Plugin was modified to support the Tracer ZN524 Controller which now adds the ability to disable
the Fan Status diagnostic.
Plugin Installation
Changes
 Updated XIF files for Tracer MP580, ZN517, VV550, ZN523, ZN524, ZN525 and ZN510.
ZN525
 A plugin was created to support the Tracer ZN525 Controller (Supported only in Europe)
ZN524
 A plugin was created to support the Tracer ZN524 Rev 3.0.0 Controller
Plugin Installation
It is not necessary to have the Rover Service Tool software installed on your PC; if you do, Rover V7.1 is required. The
installation program will install all necessary files and create an import directory for the XIF files in
Changes
 Modified installation to support Rover V7.1
Plugin Installation
It is not necessary to have the Rover Service Tool software installed on your PC; if you do, Rover V6.00 is required. The
installation program will install all necessary files and create an import directory for the XIF files in
Changes
 Converted all Help Documentation to HTMLHelp
LCIR
 The ReliaTel control will only allow a humidity setpoint set from 40% to 60%. This range has been
implemented into the Rover Plugin.
 The ReliaTel control will only allow a CO2 or Demand Control Ventilation setpoint set from 500ppm
to 1500ppm. This range has been implemented into the Rover Plugin.
VV550
 In the VV550 Plugin, a checkbox was added to the other tab in the configuration named “Enable
Electric Heat in Pressure Dependent Mode”.
 When the VV550 controller is configured for Ventilation Flow, the binary input is now configurable
for Occupancy.
 In the VV550 Plugin, Ventilation Setpoint and Ventilation Setpoint Standby are now limited to 120%
of the nominal airflow. Ventilation Setpoint Standby is now available for a Ventilation Flow
controller.
Contents
Product Overview
Configuration Properties (CPs) – Important!
Plugin Installation
Launching a Trane LNS plugin
Using Rover Configuration Files (RCF)
Networks with Trane Building Control Units (BCUs)
Using Help Files
Advanced Configuration (Timing Parameters)
Known Issues
Supported Devices
Product Overview
Trane LNS plugins are designed to run on a PC or laptop with LonMaker® 3.1 (SP3) or LonMaker Turbo (SP1), either of
which has been provided and installed by the user. Trane LNS plugins are compatible with LonMaker 3.1 (SP3) using an
LNS 3.0 (SP8) or an LNS 3.2 Turbo (SP2) database. The plugins are also compatible with LonMaker Turbo (SP1) using
an LNS 3.2 Turbo (SP2) database. The MP580/581 plugin is the one exception to this, and is compatible only with an
LNS 3.2 Turbo (SP2) database.
Trane LNS plugins are designed to work with the latest firmware for each controller. See supported devices at the end
of this document for a list of devices and supported program IDs.
Back to top
Configuration Properties (CPs) – Important!
Although many Trane XIF files contain default configuration property (CP) data, it is highly recommended that you
configure LonMaker to upload CP data from the device. Loading CP data from the LNS database or using default values
from the XIF file may change the device configuration, or in some cases may cause an incorrect configuration of the
existing device.
Back to top
Plugin Installation
It is not necessary to have the Rover Service Tool software installed on your PC; if you do, Rover 5 (SP10) is required.
PC Requirements:
 LonMaker 3.1 (SP3) or LonMaker 3.2 Turbo (SP1) installed
 LNS 3.1 (SP8) or LNS 3.2 Turbo (SP2) database installed
 Network interface card installed
To install the Trane LNS plugin:
1. Close LonMaker and any LNS applications that are running on your PC.
2. Run the TraneLNS_PlugIn.exe file.
3. Restart LonMaker.
4. Register the new plugins.
Back to top
Launching a Trane LNS Plugin
The following conditions must be met before a Trane LNS plugin can launch:
 The plugin must be registered with LonMaker.
 The LNS network must be Attached.
 The device must have a program ID listed in the supported devices.
 The device must be in a configured online, configured offline, or configured soft offline mode.
 LonMaker using LNS 3.2 Turbo (SP3) must be in an Onnet or Offnet mode.
 LonMaker using LNS 3.0 (SP8) must be in the Onnet mode.
Back to top
Using Rover Configuration Files (RCF)
A Rover configuration file (RCF) is a file that copies a configuration from one device to another using the same
configuration parameters. RCF files are supported in both the Trane Rover Service tool and in the Trane LNS plugins.
The save function is located in the configuration area of the plugin screen, which can be accessed by selecting the
Configuration button from the status screens. Once a configuration is saved, it can be used to restore a configuration to a
device in the event that a device must be replaced.
Note: Not all Trane devices support RCF files.
Back to top
Networks with Trane Building Control Units (BCUs)
Important! When using the LNS plugin on sites with a BCU as the network manager, the LNS database must be
recovered from the existing network to avoid corrupting the existing network.
Warning! Recovering a network with a BCU is unstable; therefore, it is not recommended and is not supported.
Procedures to recover a network, along with a corresponding system plugin, will be available in a future release.
Additionally, Echelon is adding support to aid in recovery. This will be incorporated into LNS 3.2 Turbo (SP3) with a
release date not yet determined.
Note: Location labels cannot contain special characters or periods. If you have devices that were previously saved this
way in Rover, rename them before recovering the network.
The following steps must be followed to avoid corrupting the existing network:
Note: These are shortened steps for recovering a network; only steps that will impact the recovery process are listed.
1. In LonMaker Turbo, click the LonMaker Default Options tab (Figure 1).
2. From the Options category list, select Configuration properties.
3. In the CP Value Source area, select Device from the New devices and Existing devices lists.
Figure 1. Recovering a network (steps 13)
Network_ recovery.jpg
5. Click the General tab.
6. Select the Show all options check box in the New network area.
7. Click Create Network; the Network wizard opens.
8. Select the Recover database check box, and then click Next.
9. In the Plugin Registration area, confirm that the plugins for the devices on the network are pending
registration. Click Next.
10. In the Domain Definition area, select 1 for the Domain length (bytes:), and in the Domain ID field enter
11.
11. Click Finish.
Note: Trane BCUs install LON devices on domain 11 (hex).
Trane uses the location labels to identify and give devices a name within Rover. LonMaker uses the location labels to
identify different subsystems. Because of this, it is recommended that all subsystems be placed on a single Microsoft®
Visio document.
When recovering a Trane network, a warning message might display at the end of the recovery process (Figure 2). In
most cases this is not cause for alarm and the message can be ignored.
Figure 2. Error message
Error_msg.jpg
Back to top
Using Help Files
Trane LNS plugins contain embedded help files that are specific to each plugin. To access the help files, click the Help
button located on the right side of the status area of the plugin, or from the bottom right side of the configuration area of
the plugin.
MP580 Status Plugin
The MP580 Status Plugin contains a different type of help system known as contextsensitive help, which provides topic
specific help. To access, select “What’s this?” from Help in the main menu. This will change the appearance of your
cursor. The “What’s this?” help is specific to each field. Click on a field within the MP580 status plugin and help for the
selected field appears.
Back to top
Advanced Configuration (Timing Parameters)
Advanced Configuration (timing parameters) are available in most Trane LNS Plugins but are not intuitive to find. To
access this function:
1. Open the Configuration editor of the LNS plugin (Figure 3).
2. Click the Setpoints tab.
3. In the Default Setpoints area, click in the left corner beneath the Unoccupied Heating field.
Figure 3. Advanced configuration (steps 13)
Advanced_CP.jpg
4. A warning message might appear; click Yes (Figure 4). The Advanced Configuration dialog box displays
(Figure 5).
Figure 4. Warning message
Warning_msg.jpg
Figure 5. Advanced configuration dialog box
CP_Screen.jpg
Back to top
Known Issues
Several technical issues have been identified and are addressed in this section. The following list contains a brief
description of each issue, followed by a recommended solution.
Issue
After recovering a network, devices display as uncommissioned/unable to propagate configuration properties (CPs).
Solution
This issue will be resolved in LNS 3.2 Turbo (SP 3).
Issue
A Plugin does not display when clicking on the device in LonMaker 3.1 (this does not affect LonMaker Turbo 3.2).
Solution
This occurs only in LonMaker 3.1 when a device is added and commissioned before the plugin is registered. After
registering the plugin, close the network and reopen it.
Note: The device must have the current program ID as listed in Table 1 for a plugin to launch.
Issue
Error message displays: NS #28, Subsystem; NS #6 Subsystem; NS #25/DB1.
Solution
One of the above error messages may display when adding and commissioning a device. These error messages do not
effect the function of the device or the plugin.
Issue
Error message displays: NS #24.
Solution
This message displays when selected Trane devices are added to the network while the network is unattached. To
prevent this from occurring, do the following:
1. In Microsoft Visio, select LonMaker from the main menu, and then click Network Properties.
2. Click the LonMaker options tab.
3. In the Options category, select Recovery.
4. Select the Set SCPT location value to subsystem path check box in the Subsystem Recovery Options area.
5. Click Apply, and then OK.
or
6. Follow steps 1 and 2 as described above.
7. In the Options category, select Configuration properties.
8. Select Device from both the New devices and Existing devices lists in the CP Value Source area.
Note: Do not perform the above procedures in LonMaker Turbo Designer; it will not solve the issue at hand.
Issue
Error message displays: Data Server #415
Solution
This message may display if a USB interface, in which the buffer size is set too low, is used when uploading from an
MP580/581. To prevent this, reset the buffers by doing the following:
1. From the Control panel in Microsoft Windows, select LonWorks Interface.
2. Click the USB tab.
3. Select an interface from the list and then click Properties. The Properties dialog box displays.
4. In the Application Buffers area, reset the Input and Output Count to 1; in Size, reset to 114. In the
Network Buffers area, reset the Input and Output Count to 1; in Size, reset to 255 (see Figure 6).
Figure 6. Example of correct buffer settings in a LonWorks interface
lon1.jpg
Issue
LonMaker becomes suspended after multiple plugins are installed. Plugin registration may end before completion.
Solution
When creating a new network, LonMaker defaults all unregistered plugins to pending status forcing it to register the
plugins upon network creation. Firsttime registration of multiple plugins may fail to register.
To prevent this from occurring, do the following:
1. In LonMaker Design Manager, click the New Network Options tab.
2. In the Plugins area, ensure that the Register new plugins check box is not selected.
Issue
The device name assigned during adding and commissioning of the device is not reflected in the Visio drawing name,
causing the plugin launch to fail.
Solution
1. Rightclick on the device graphic and select Device Properties.
2. In the Device Properties dialog box, verify that the name in the Device name field is the name that was
assigned to the device when it was created.
3. Click OK.
This updates the Visio drawing name, allowing for the plugin to launch.
Back to top
Supported Devices
Table 1. Supported
Devices Program ID
Device
MP501 90002A5209030402
MP503 90002A5208030401
ZN510/511 80002A5500030408
ZN510/511 80002A5500030407
ZN517 80002A550003040D
ZN520/521 80002A5500030406
ZN523 80002A5501030401
ZN524 80002A5503030403
ZN524 80002A5503030404
ZN524 80002A5503030405
ZN525 80002A5501030402
AH540/541 80002A560A030403
VV550 80002A5502030402
MP580/581 80002A5200030403
LCIR SCC 80002A550003040C
LCIR DAC 80002A560A030404
Back to top
™ ® The following are trademarks or registered trademarks of Trane: Rover and Trane.
™ ® The following are trademarks or registered trademarks of their respective companies or organizations:
LonMaker and LonWorks are from Echelon Corporation; Visio and Windows from Microsoft Corporation.

Trane LNS Plug-Ins Version 1

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Trane LNS Plug-Ins Version 1

Uploaded by

Copyright:

Available Formats

4/27/2017 Trane

You might also like