Best Practices and Troubleshooting Guide: Bacnet MS/TP Wiring and Link Performance
Best Practices and Troubleshooting Guide: Bacnet MS/TP Wiring and Link Performance
Best Practices and Troubleshooting Guide: Bacnet MS/TP Wiring and Link Performance
Troubleshooting Guide
Unit Controller
BACnet
Terminator
Tracer SC
SAFETY WARNING
Only qualified personnel should install and service the equipment. The installation, starting up, and servicing
of heating, ventilating, and air-conditioning equipment can be hazardous and requires specific knowledge and
training. Improperly installed, adjusted or altered equipment by an unqualified person could result in death or
serious injury. When working on the equipment, observe all precautions in the literature and on the tags,
stickers, and labels that are attached to the equipment.
WARNING
Proper Field Wiring and Grounding Required!
Failure to follow code could result in death or serious injury. All field wiring MUST be
performed by qualified personnel. Improperly installed and grounded field wiring poses FIRE
and ELECTROCUTION hazards. To avoid these hazards, you MUST follow requirements for field
wiring installation and grounding as described in NEC and your local/state electrical codes.
Failure to follow code could result in death or serious injury.
WARNING
Personal Protective Equipment (PPE) Required!
Installing/servicing this unit could result in exposure to electrical, mechanical and chemical
hazards.
• Before installing/servicing this unit, technicians MUST put on all PPE required for the work
being undertaken (Examples; cut resistant gloves/sleeves, butyl gloves, safety glasses, hard
hat/bump cap, fall protection, electrical PPE and arc flash clothing). ALWAYS refer to
appropriate Material Safety Data Sheets (MSDS)/Safety Data Sheets (SDS) and OSHA
guidelines for proper PPE.
• When working with or around hazardous chemicals, ALWAYS refer to the appropriate MSDS/
SDS and OSHA/GHS (Global Harmonized System of Classification and Labelling of
Chemicals) guidelines for information on allowable personal exposure levels, proper
respiratory protection and handling instructions.
• If there is a risk of energized electrical contact, arc, or flash, technicians MUST put on all PPE
in accordance with OSHA, NFPA 70E, or other country-specific requirements for arc flash
protection, PRIOR to servicing the unit. NEVER PERFORM ANY SWITCHING,
DISCONNECTING, OR VOLTAGE TESTING WITHOUT PROPER ELECTRICAL PPE AND ARC
FLASH CLOTHING. ENSURE ELECTRICAL METERS AND EQUIPMENT ARE PROPERLY RATED
FOR INTENDED VOLTAGE.
Failure to follow instructions could result in death or serious injury.
© 2016 Trane All rights reserved Proprietary and Confidential, Do Not Distribute Outside Trane BAS-SVX51D-EN
Introduction
Copyright
This document and the information in it are the property of Trane, and may not be used or
reproduced in whole or in part without written permission. Trane reserves the right to revise this
publication at any time, and to make changes to its content without obligation to notify any person
of such revision or change.
Trademarks
All trademarks referenced in this document are the trademarks of their respective owners.
Revision History
BAS-SVX51D-EN:
• Changed the Latency Timer to 2 Ms in step 4 c, “Set Up the USB Adapter and Serial Port,” p. 25.
• Updated the BACnet Device ID section.
BAS-SVX51C-EN:
• Additional information added on wire and network configuration for 2-wire and 3-wire
networks.
BAS-SVX51B-EN:
• Best practice added for 3-wire non-isolated devices.
• new information on using SerialSpy with Tracer SC.
BAS-SVX51D-EN Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane 3
Table of Contents
Summary List of Best Practices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Symptoms of Poor Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Common Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Before You Start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
How a BACnet MS/TP Link Works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Best Practices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Configuring and Wiring the BACnet MS/TP Link . . . . . . . . . . . . . . . . . . . . . . . . 9
Wire and Network Characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Understanding Non-isolated and Isolated MS/TP Device Types . . . . . . . . 9
Network Wiring Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2-Wire Mixed Device Networks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
3-Wire Mixed Device Networks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Network Wiring Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Setting the BACnet Device Addresses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Rotary Switch Values and BACnet Device ID . . . . . . . . . . . . . . . . . . . . . . 16
Setting Rotary Addresses on the Tracer SC System Controller . . . . . . . . . . 16
BACnet MS/TP Device ID Assignment . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Device ID Assignment for BACnet/IP Devices . . . . . . . . . . . . . . . . . . . . . . 17
Device ID Assignment for Base Tracer SCs . . . . . . . . . . . . . . . . . . . . . . . . 17
Device ID Assignment for Wireless Devices . . . . . . . . . . . . . . . . . . . . . . . 17
Customizing Device IDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Total Number of Trane and Non-Trane Devices on a BACnet Link . . . . . . . 21
Custom Programming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Custom Graphics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Controller Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Trane SerialSpy Protocol Analyzer Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Using SerialSpy With the Comm4 USB Adapter . . . . . . . . . . . . . . . . . . . . . . . 25
Set Up the USB Adapter and Serial Port . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Install and Start SerialSpy Protocol Analyzer Software . . . . . . . . . . . . . . 25
Use SerialSpy to Capture Link Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Evaluate the SerialSpy Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Total Communication Failure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Partial Communication Failure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Troubleshooting Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Divide and Conquer Troubleshooting Technique . . . . . . . . . . . . . . . . . . . . . . 38
Appendix A: Using SerialSpy with Tracer SC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Modes of Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
4 Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane BAS-SVX51D-EN
Capturing to SerialSpy by USB or IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Using Tracer SC SerialCapture to Capture to an SD Card . . . . . . . . . . . . 43
BAS-SVX51D-EN Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane 5
Summary List of Best Practices
Use the following summary list of best practices to quickly locate a specific topic that interests you.
Configuring and Wiring the BACnet MS/TP Link
1. “Do not mix isolated and non-isolated device types on a single link.,” p. 10
2. “BACnet wiring must use a daisy-chain configuration.,” p. 12
3. “Observe the maximum link length recommendation,” p. 12
4. “Use a Tracer BACnet terminator at each end of the link.,” p. 12
5. “Use the built-in terminator on the BCI-R when the BCI-R is the last node in the network.,” p. 13
6. “Maintain consistent wiring polarity between devices.,” p. 14
7. “Observe network cable and conductor termination best practices during installation.,” p. 14
8. “Avoid sharing 24 Vac power between unit controllers.,” p. 14
9. “Ensure that 24 Vac power supplies are consistently grounded.,” p. 14
10. “Meet requirements when adding zone sensor communication stubs to a Tracer UC400.,” p. 15
Setting the BACnet Device Addresses
11. “Set the rotary switch address on all unit controllers.,” p. 20
12. “Ensure no duplicate rotary switch addresses exist on a BACnet MS/TP link.,” p. 20
13. “Ensure no duplicate rotary switch addresses exist on a BACnet MS/TP link.,” p. 20
14. “Sequentially address BACnet MS/TP devices; leave no gaps.,” p. 20
Total Number of Trane and Non-Trane Devices on a BACnet Link
15. “Limit the quantity of devices on a link when there are both Trane and non-Trane devices on the link.,” p. 21
16. “Populate BACnet links evenly when 30+ devices are present.,” p. 22
17. “Take advantage of the new expanded communication options offered in Tracer SC 3.5 and higher.,” p. 22
18. “Place Trane Communicating Thermostats on a separate link.,” p. 23
Custom Programming
19. “Limit Tracer SC TGP2 run frequency.,” p. 23
20. “Use event triggered TGP2 to reduce execution frequency.,” p. 23
21. “Use Tracer SC System Applications for common calculations.,” p. 23
Custom Graphics
22. “Limit number of points displayed on a Tracer SC Custom Graphic.,” p. 23
Controller Software
23. “Update all UC400 controllers to Version 4.15 firmware (or higher).,” p. 24
24. “Update Tracer SC to Version 3.5 (or higher).,” p. 24
Tools
25. “Prop400 to update Tracer UC400 firmware on multiple devices.,” p. 24
26. “Trane SerialSpy Protocol Analyzer Software to troubleshoot communication links.,” p. 24
27. “High-performance volt meter.,” p. 24
6 Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane BAS-SVX51D-EN
Introduction
This guide is intended to help you in two ways; first, it contains the best practices for configuring
and wiring a BACnet MasterSlave/TokenPassing (MS/TP) link. If you follow these techniques and
best practices when the link is installed initially, you will have fewer problems with the link.
However, when you do have problems, this guide also contains methods for figuring out what the
problem is, where it is, and what you need to do to fix it.
Common Problems
The most frequently encountered problems that can cause poor performance, or non-
performance, on a BACnet MS/TP link are:
• There is an open circuit
• There is a short circuit
• The link is not configured using a daisy-chain topology
• The wire used for the link does not meet specifications
• There are too many devices on the link
• Tracer BACnet terminators are not installed at each end of the link
• The wiring polarity is reversed on the comm link
• The wiring polarity is reversed on the 24 Vac power wiring from the transformer to the devices
• There is a duplicate rotary switch address (duplicate rotary address on the unit controller)
• The rotary switch addresses for the devices are not between 1 and 127
• There are unit controllers that are not addressed (0,0,0 on the unit controller’s rotary switches)
BAS-SVX51D-EN Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane 7
Introduction
8 Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane BAS-SVX51D-EN
Best Practices
The following sections contain the best practices for various elements of the BACnet MS/TP link.
BAS-SVX51D-EN Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane 9
Best Practices
are acceptable, depending on the type and number of devices that are being connected together
on a MS/TP link.
Best
Practice Do not mix isolated and non-isolated device types on a single link.
Trane recommends that isolated and non-isolated device types are not mixed on a single link. Run
separate 2-wire and 3-wire MS/TP links. Figure 1 and Figure 2 describe the correct method to wire
each network type.
Note: End of link terminators have been omitted from the drawings. End of link terminators are
required.
10 Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane BAS-SVX51D-EN
Best Practices
24
VA
Unit Controllers
C
+
(Power Side)
(Each UC should be
Tracer BACnet terminator grounded to a good earth Tracer BACnet
ground.) terminator
12 Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane BAS-SVX51D-EN
Best Practices
• Connect the communication wire shield to the ground terminal of the link termination block at the
Tracer SC as shown in Figure 7. The Tracer SC provides the ground for the BACnet MS/TP link. This
is the only place on the link that the shield wire should be grounded.
• Tape back the shield at each of the Tracer BACnet terminators to prevent accidental contact with
metal components.
Note: If a Tracer UC400 is at the end of the link, the process is the same. The Tracer SC provides
the ground wherever it resides on the link.
• During installation, compile a set of as-built drawings or a map of the communication wire
layout. Sketches of the communication layout should feature the Tracer BACnet terminators.
• The Tracer BACnet Terminator is a powered device and it will not work without a power source.
Connect TBT power terminals to a 24 Vac/Vdc power supply.
Note: Some third-party devices have a network terminator built into the device. The use of the
terminator is usually controlled by a jumper or switch on the device itself. Verify that the
terminators on each device are disabled, so that only the TBT are biasing the network.
(Top view)
Best
Use the built-in terminator on the BCI-R when the BCI-R is the last node in the
Practice network.
The Trane BCI-R has a built in BACnet terminator. If a BCI-R is the last node on the network, this
terminator should be installed as shown in the BCI-R installation guide (RF-SVN03). For other BCI-
R devices that are not the last node on the link, verify that the terminator has not been wired to the
network.
14 Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane BAS-SVX51D-EN
Best Practices
Meet requirements when adding zone sensor communication stubs to a Tracer UC400.
Best
Practice The wire that runs from a zone sensor to a unit controller is commonly referred to as a
communication stub. Figure 8 shows an example of communication stub-wiring to a BACnet
device. The stub is not part of the BACnet link; it is a wire that runs from the Tracer UC400 IMC link
down to the zone sensor. Ensure that the zone sensor includes the optional communication
module.
Any or all of the Tracer UC400 unit controllers on a link can be wired with a communication stub.
Unlike LonTalk links, there is no limit on the number of Tracer UC400 unit controller communication
stubs. Polarity must be maintained and the length limit is 600 ft (183 m).
For ease of use, the wire for the communication stub can be the same as that used for BACnet
communication link wiring as described in “Configuring and Wiring the BACnet MS/TP Link,” p. 9.
Figure 8. Zone sensor communication stubs on Tracer UC400s
+ IM + IM
VDC VDC
BI LINK IMC BI LINK IMC
+
AI AI AI AI AI AI AI AI AI AI
P P P P
LINK IM LINK IM
TX TX
RX RX
SERVI SERVI
Zone sensors
BACnet Device ID
The BACnet Device ID uniquely identifies each BACnet device as a logical address. The valid range
of this address is 0 to 4194303. The logical address in an Internet Protocol (IP) network is the IP
address, which is four bytes in length and is typically written in the format of 192.168.1.125. Failure
to assign unique address to each device will result in communication errors.
16 Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane BAS-SVX51D-EN
Best Practices
Example: Figure 10, p. 19 provides an example of how the rotary switch address and BACnet
device IDs work together. The result is a unique BACnet Device ID for each device.
• In a three-story building, there is a Tracer SC installed on each floor.
– The rotary dial setting on the Tracer SC on the first floor is set to 001.
– The rotary dial setting on the Tracer SC on the second floor is set to 020.
– The rotary dial setting on the Tracer SC on the third floor is set to 300.
• Each Tracer SC has two BACnet links with two UC400 controllers wired to each link (four UC400s
total on each floor). The rotary dials on the UC400 controllers are set to 001 and 002.
18 Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane BAS-SVX51D-EN
Best Practices
Tracer SC
300
Link 2
Tracer SC
20
2nd Floor UC400 UC400 BACnet device IDs
001 002 202001 and 202002
Link 2
Tracer SC
1
1st Floor UC400 UC400 BACnet device IDs
001 002 12001 and 12002
Link 2
63 103
All devices regardless of manufacturer must have a rotary switch address. Third-party BACnet
devices will use a different method to set the address that is specific to the manufacturer. Consult
the appropriate documentation to determine how to set the address.
Best Ensure no duplicate rotary switch addresses exist on a BACnet MS/TP link.
Practice
All BACnet devices on the same MS/TP network must have a unique rotary switch address.
Best Sequentially address BACnet MS/TP devices; leave no gaps.
Practice
Important: When there are two links used on a Tracer SC, each link should start with controller
rotary address 1.
Sequential rotary addressing is very important for BACnet MS/TP links. The BACnet MS/TP
communications mechanism polls devices at each address between the lowest and the highest
address found. If a device rotary address is skipped, additional, unnecessary messages will be sent,
which will consume additional bandwidth.
Note: BACnet MS/TP controllers can be addressed independent of where they are located on a
link, as long as all devices wired on a link are addressed sequentially without gaps. For
example, a link of devices could be addressed “1, 3, 5, 2, 4, 6" where all addresses
sequentially from 1 to 6 exist despite their physical location. Conversely, addressing devices
“1, 3, 5, 7, 9, 11" would have 5 skipped addresses which would adversely impact link
performance unnecessarily.
When multiple Tracer SCs are used on a project, each Tracer SC must have its rotary switch address
set to a unique address, starting with 1. This is critical to avoid duplicate BACnet Device IDs on a site.
Note: Max Master is a MS/TP configuration property that may be used to define the highest rotary
switch address that is currently in use on the network. For most devices this value is fixed
at 127, which is the highest rotary switch address that may be set on the network. Some
third-party devices allow this value to be modified.
A situation can exist where a device is being added to the MS/TP network at a rotary switch address
that is higher than the Max Master value set in the device with the next highest rotary switch rotary
switch address. If this is the case, the token will not get passed to the new device until the Max
Master property of other device is increased equal to or greater than the rotary switch address of
the new device.
20 Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane BAS-SVX51D-EN
Best Practices
Take advantage of the new expanded communication options offered in Tracer SC 3.5
Best
Practice and higher.
Starting with Release 3.5, Tracer SC provides new communication options that allow for improved
performance, job layout options, and non-Trane integration. With these expanded communication
options, you can interact with a single Tracer SC to view and service all BACnet MS/TP devices, even
though the BACnet Unit Controller (UC) devices may be physically connected to other Tracer SCs.
Figure 12, p. 22 describes the method when a router is used.
Note: The maximum device count for a Tracer SC installation is determined by the Tracer SC
application license.
Use these communication options to plan and implement a solution that balances performance
and cost (both product and commissioning) for each job.
22 Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane BAS-SVX51D-EN
Best Practices
To learn more about the expanded communication options, refer to the Tracer SC System
Controller Installation and Setup Guide (BAS-SVX31).
Best
Practice Place Trane Communicating Thermostats on a separate link.
Trane Communicating Thermostats (TCTs) may have communication issues when mixed on a link
with Trane UC devices that use the 76,800 baud rate. To prevent this, place all TCTs on a separate
link with a baud rate of 76,800.
If the TCTs cannot be isolated on a separate link, reduce the baud rate of all devices on the mixed
network to 38,400 baud to eliminate this issue. Although the slower baud rate will affect the
bandwidth, in most cases the slower rate will have no significant effect on performance. Data
intensive operations such as harvesting trend logs will experience some slower performance.
Note: : The Tracer SC has a default baud rate at 76,800 baud. If using TCTs, the Tracer SC and all
MS/TP devices on the same physical MS/TP link must be set to the 38,400 baud rate.
Custom Programming
Best Limit Tracer SC TGP2 run frequency.
Practice
Very few supervisory control routines require calculations or updates more frequently than once
per minute - and often can be executed at a much slower rate (such as every 5, 10 or 15 minutes).
Tracer SC TGP2 routines that read values from controllers on BACnet MS/TP links will load the MS/
TP link with their requests and impact performance. Therefore, if it is possible to accomplish the
required control function without reading data directly from unit controllers, it will improve overall
performance. (See below for suggestions.) If it is necessary to read data from unit controllers in
TGP2, choose the slowest possible execution frequency to optimize performance.
Best Use event triggered TGP2 to reduce execution frequency.
Practice
Custom Graphics
Best Limit number of points displayed on a Tracer SC Custom Graphic.
Practice
Custom graphics with many point values from unit controllers on a BACnet MS/TP link will take
time to load and present the data on the screen. Use these data points wisely. If a graphic is loading
slower than desired, consider reducing the number of data points, or use multiple graphics to
distribute the data points. For example, instead of a single floor plan graphic with 40 space
temperature values, two floor plans (east wing and west wing) each with 20 space temperatures
will give better performance. In any case, Trane recommends an upper limit of 90 data points.
Controller Software
Best Update all UC400 controllers to Version 4.15 firmware (or higher).
Practice
The latest Tracer UC400 Firmware Version 4.15 (or higher) includes changes that improve BACnet
MS/TP performance. UC400 firmware is the same regardless of application (VAV, Field
Programmable, etc.). UC400 firmware can be updated with any of the following methods:
• Tracer TU direct connect (USB) - individual controller update
• Tracer TU Single Link connection - individual controller update
• Prop400 via Tracer SC connection - multiple controller update
Note: See the “Tools” section of this guide for details on service tools for BACnet MS/TP
controllers.
Best Update Tracer SC to Version 3.5 (or higher).
Practice
The latest Tracer SC software updates include improvements that affect the performance of the
BACnet MS/TP links. Ensure that you are running the latest Tracer SC software at the time of the
installation.
Tools
The following software and hardware tools are available to help you troubleshoot your BACnet MS/
TP link.
Best Prop400 to update Tracer UC400 firmware on multiple devices.
Practice
Use Prop400 to update Tracer UC400 firmware on multiple devices. Knowledge Center Wave
ID# wave60039 provides a link and instructions.
Best Trane SerialSpy Protocol Analyzer Software to troubleshoot communication links.
Practice
This software is available on the Controls Download page.
Best High-performance volt meter.
Practice
If possible, use a high-performance meter for best results.
24 Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane BAS-SVX51D-EN
Trane SerialSpy Protocol Analyzer Software
The SerialSpy Protocol Analyzer software was developed internally at Trane and is designed
specifically for troubleshooting communication links. The interface between the communication
link and the SerialSpy software is a USB adapter equipped with wires and alligator clips, which
allow you to tap into the link at the wire terminals of any device.
This section explains how to use SerialSpy with either the Rover Service Tool Comm4 USB Adapter
or the Tracer SC.
BAS-SVX51D-EN Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane 25
Trane SerialSpy Protocol Analyzer Software
3. From the Communications Port list, click the comm port to match that for the USB Serial
Adapter.
4. From the Baud Rate list, choose the baud rate for the MSTP link. Trane devices have a default
baud rate of 76800. Ensure that you choose the rate used by the controllers or you will not obtain
a quality screen capture.
• Blue lines — You will probably see a couple of lines in blue. These are diagnostics and are
normal every time you start SerialSpy. If the link has problems you will see lots of diagnostics
shown in blue. A typical 5-minute capture of a clean link has 85,000 messages with six blue
diagnostics. The error rate is incredibly low. The same link with a problem, such as a duplicate
address for example, has 9,000 blue diagnostics with 82,000 messages. Problems like these are
26 Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane BAS-SVX51D-EN
Trane SerialSpy Protocol Analyzer Software
not subtle or difficult to detect. Unless you are dealing with an intermittent problem, a 5-minute
capture is usually enough for troubleshooting.
• Gray lines/token passing — You should then see an orderly series of token passing
messages, which are gray. These should be error-free (uninterrupted by blue lines), and there
should be thousands of them every minute. You should be able to see every address on the link
passing the token along in order by address
• Black lines — There should be occasional larger messages in black if there is a Tracer SC or
other front end on the link. These are data requests or data writes.
• Capture button — Clicking this initiates a capture on the BACnet MS/TP link.
• Triggers button — Use this button to initiate or end a capture based on an event or
circumstance occurring on the link.
• Statistics button — Refer to “Statistics Summary,” p. 36 for details on how this button is used.
• Port button — Refer to “Trane SerialSpy Protocol Analyzer Software,” p. 25 for details on how
this button is used.
• Log button — The Log button allows you to continuously save a capture to a specified file
location.
• Save button — The Save button saves the current capture to a specified file. These saved files
can be emailed to Tech Support. Longer saved captures of an hour or more make very large files
that are difficult to email.
• Load button — The Load button allows you to open a previously saved capture file.
• Tail button — When you click the Tail button, you see a very fast scroll of messages flashing by.
When viewing the tail you can begin to get some notion of how fast the token is being passed
from device to device, and how many thousands of times this happens in just a few minutes. Click
the Tail button again to stop the scrolling and look more carefully at the messages.
• Show Diagnostics Only — To filter the messages, click the pull-down list and select Show
diagnostics only or Show data and diagnostics. Because of the continuous token-passing
activity on the link, diagnostics will often reveal a problem.
Figure 15. Typical SerialSpy output when connected to a link with a short circuit, short to ground, or reversed polarity
Once you know there is a physical problem with the link, you can use two tools to help locate the
problem:
• A voltmeter measuring dc volts
• The link LEDs on the Trane devices
You can use the “Divide and Conquer Troubleshooting Technique,” p. 38 to narrow the search for
a bad segment of wire. Table 8, p. 39 shows some particular characteristics that will identify specific
faults.
28 Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane BAS-SVX51D-EN
Trane SerialSpy Protocol Analyzer Software
30 Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane BAS-SVX51D-EN
Trane SerialSpy Protocol Analyzer Software
Duplicate Addresses
A common problem is two devices on the network set to the same rotary switch address. At first
glance, the SerialSpy capture looks pretty chaotic with lots of blue diagnostics (see Figure 19,
p. 33). However, on closer inspection, you can see that one particular message repeats, “Retry of
Token from 40 to 41”. This is much easier to see clearly if you select “Show Diagnostics Only” in
the list box (see Figure 20, p. 34). Inspection of the token passing messages around this error
reveals that the device addresses are in sequential order. However, the device at address 39 is not
present.
In this example you can see the token passing along normally until it reaches device 40. Since there
are two devices addressed 40, they both respond by passing the token. This triggers a “Retry”
diagnostic from SerialSpy. Now there are two tokens bouncing down the link and chaos ensues.
However, BACnet is pretty robust and recovers quickly...only to be derailed the next time the token
gets to address 40. This condition will not necessarily result in a comm down state at the Tracer
SC, but communication will be very slow on the link and the Tracer SC performance will suffer.
32 Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane BAS-SVX51D-EN
Trane SerialSpy Protocol Analyzer Software
34 Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane BAS-SVX51D-EN
Trane SerialSpy Protocol Analyzer Software
Statistics Summary
There are two ways to view and gather statistics; The first is to use the Statistics button, which is
useful for tracking stats during a live capture session. The second is to use the Stop button, which
will append the statistics to the end of the captured file. You should always use the Stop button at
the end of a session, particularly when you intend to send the file to Tech Support. The statistics
report contains the following information.
• Header — This is a summary of the link activity during the capture. The average frames and
bytes per second indicate general bandwidth utilization. The average time, in milliseconds,
required for the token to complete the circuit is the Token Rotation Time (TRT). TRT will increase
on a bigger, busier link and a very large value might indicate bandwidth saturation.
• Node — These are the addresses of the devices on the link.
• Nfrom — This is the number of messages from the device. You can see that where there is a
gap in the sequence, from device 3 to device 31 for example, device 3 has delivered about two
thousand more messages than the other devices. These are polling messages, seeking a device
in the gap. Polling adds to the communication overhead on the link, which is why sequential
device addresses are recommended.
• Nto — This is the number of messages to the device. Note that on a clean link like this one they
are pretty uniform from one device to another.
• FramesFrom — This is the number of data messages being sent (excluding token passing and
polling). The Tracer SC at address 0 is sending many more frames than any other device.
• BytesFrom — This is the number of data bytes sent from the device. The Tracer SC is sending
many more bytes than any other address. On this site only devices 31-71 have been installed
on the Tracer SC. Devices 1-3 and 50-59 have not been installed on the Tracer SC, and therefore
have much smaller values in this column.
• Usage% — This is the percentage of times that the device used the token to pass data. Again
the Tracer SC wins.
• TokenRetry — This is a typical clean link with very few retries. If there were duplicate
addresses, there would be a very large number at the duplicate address.
• TokenFail — This shows the number of times the device failed to pass the token to a polled
address.
• Token Min/Max/Avg — This is the time, in milliseconds, taken for the token to complete the
circuit of all devices on the BACnet MS/TP link.
36 Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane BAS-SVX51D-EN
Troubleshooting Options
Use Table 7, p. 37 to quickly identify the symptom and some possible causes, then refer to the best
practices section of this document for information on fixing the problem.
(a) In the UC400 and UC600 controller design, there is a female terminal connector that the MS/TP and IMC communication buss share. It is common to
miss-align the MS/TP connector and connect one line of the network to an IMC terminal.
BAS-SVX51D-EN Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane 37
Troubleshooting Options
38 Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane BAS-SVX51D-EN
Troubleshooting Options
9. If you see errors and diagnostics, there is an issue with the BACnet link on the inward side of
the broken link.
10. Reconnect the link and move to the device that is half-way back toward the Tracer SC.
11. Disconnect the wire going to the outward part of the link (away from the Tracer SC). Connect
the alligator clips from the USB Comm4 adapter to the plus (+) and minus (-) terminals on the
device and run a SerialSpy capture.
12. Repeat steps 4 and 5 until the trouble is isolated.
Table 8. Characteristics associated with specific problems on the BACnet MS/TP link
Condition Vdc LEDs Serial Spy
Normal Normal(a) Normal Normal
Two powered Trane BACnet terminators Min = .33 Tx = quick flash Clean token pass
Max = .60 Rx = almost solid on No (or few) blue diagnostics or errors (c)
Avg = .45
(refer to Note (b))
Min = .35 Normal Normal
Max = .60 Tx = quick flash Clean token pass
One powered Trane BACnet terminator
Avg = .45 Rx = almost solid on No (or few) blue diagnostics or errors(c)
(refer to Note (b))
Min = .003 Normal Normal
Max = .45 Tx = quick flash Clean token pass
Two unpowered Trane BACnet terminator
Avg = .21 Rx = almost solid on No (or few) blue diagnostics or errors(c)
(refer to Note (b))
Table 8. Characteristics associated with specific problems on the BACnet MS/TP link (continued)
Condition Vdc LEDs Serial Spy
Tx = weak solid on Junk during idle — framing errors
Dead Short across the comm link 0V
Rx = off or very weak Bad header, fast scrolling
(a) A properly terminated and powered link typically shows voltage measurements between .30 and .60 with an average voltage of .45
(b) These readings are typical for ordinary meters. Very good meters (Fluke) with Min/Max recording capability will detect very transitory spikes of much higher voltage
(c) There may be one blue diagnostic message every 10,000 lines (12-30 in a 3-5 min capture). This would still represent a normally functioning link.
40 Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane BAS-SVX51D-EN
Appendix A: Using SerialSpy with Tracer SC
Special software is available that allows a Tracer SC to function as a capture device. As discussed
earlier in “Using SerialSpy With the Comm4 USB Adapter,” p. 25, you can use a PC running Serial
Spy software and the Rover Comm4 adapter to capture BACnet MS/TP traffic on the link. This
special software allows you to use a Tracer SC rather than Rover comm 4 adapter. Instead of
connecting alligator clips from the Rover adapter to the MS/TP link, you can use the existing MS/
TP link connected to a second, spare Tracer SC running the special software.
Using the Tracer SC gives you the benefit of remote access to the link if the capturing SC is set up
with an IP address that is accessible remotely. When a customer complains of a problem on the link,
you could connect from wherever you are and start capturing, rather than driving to the job site
and connecting your Rover Comm4 hardware to the link.
The Tracer SC can also be used for very intermittent problems where a capture is needed for hours
or even days to find an infrequent problem. Rather than leaving a laptop on the job with serial spy
running all weekend, you could put a capturing SC on the job with an SD card installed to capture
for long periods of time. The files could later be analyzed with Serial Spy software.
Note: Your Tracer SC must be running version 3.0 or later. If it is not, you must update it before
continuing. Older versions of Tracer SC will ignore your attempts to install the capture
software.
Perform the following steps to install the enabling software:
1. Obtain the update file SerialCapture.scfw. This should normally be included with your
SerialSpy installation, or you can download it. Go to the Controls download page, click Tracer
SC, then Archived Downloads.
2. Use the Tracer TU File Transfer Wizard to upgrade your Tracer SC with SerialCapture.scfw.
After the file is uploaded to the Tracer SC, the Tracer SC will restart. It should show the normal
“UPd.” sequence on the 7-segment display during the updgrade, then go back to the dancing
dash.
3. Power down Tracer SC and change the rotary address to 998. Power up Tracer SC. The display
should now show “CAP”.
Note: The Tracer SC will not accept the new firmware if the rotary address is already set to 998.
Choose any other address when doing the firmware upgrade.
Modes of Operation
The SerialCapture software has four modes of operation:
• Normal Tracer SC operation
Tracer SC operates normally when it is powered up with the rotary switches set to any value
other than 998. Changing the rotary switches between their normal Tracer SC settings, and 998
allows use of Tracer SC as a “part-time” capture device. The seven-segment display will show
one of the following scenarios.
• Tracer SC capture (USB)
Tracer SC sends data and timing information to SerialSpy through a USB connection. To use
this mode of operation, your PC must have Tracer TU installed, or you must install the Tracer
TU drivers manually. While such a capture is in progress, the 7-segment display on the Tracer
SC will show “CAP-USB”.
• Tracer SC capture (IP)
BAS-SVX51D-EN Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane 41
Appendix A: Using SerialSpy with Tracer SC
Tracer SC sends data and timing information to SerialSpy through an IP connection. While such
a capture is in progress, the 7-segment display on the Tracer SC will show “CAP-IP”.
• Tracer SC capture (SD card)
Tracer SC writes data and timing information to an SD card. While such a capture is in progress,
the 7-segment display on the Tracer SC will show “CAP-FILE”. For more information on this
option, please read the section “Using Tracer SC SerialCapture to Capture to an SD Card,” which
follows later in this section.
A B
42 Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane BAS-SVX51D-EN
Appendix A: Using SerialSpy with Tracer SC
You may see a few initial lines labeled “JUNK”, until SerialSpy synchronizes with the link. If you
continue to see JUNK, and not TOKEN, POLL, or DATA, you may have SerialSpy set to the wrong
baud rate, or you may have the connection polarity reversed. If this happens, press Stop to stop
the capture. Correct the problem and try again.
10. When you have captured enough data, press the power button on the Tracer SC once.
11. Wait for the 7-segment display to go dark, indicating that power-down is complete. Then
remove the SD card.
Important: NEVER remove the SD card while the Tracer SC is powered up. Doing so may
cause the SD card to become corrupted.
12. Read and analyze the retrieved files.
You may use your PC to read the data files from the SD card.
a. Be sure to copy all of the files that are part of the capture.
b. To analyze the files, click the Load button on the SerialSpy toolbar, or File > Load…
The contents of the file are loaded just as if you were performing a live capture. You can
adjust the settings of the Trigger Configuration dialog and reload the file to analyze it with
different thresholds, and so on.
Note: If you need to e-mail the files, remember that some e-mail systems restrict the
maximum size of an e-mail attachment. This restriction may force you to e-mail each file
separately. In very restrictive systems, you may not be able to e-mail them at all.
44 Proprietary and Confidential © 2016 Trane, Do Not Distribute Outside Trane BAS-SVX51D-EN
Trane optimizes the performance of homes and buildings around the world. A business of Ingersoll Rand, the
leader in creating and sustaining safe, comfortable and energy efficient environments, Trane offers a broad
portfolio of advanced controls and HVAC systems, comprehensive building services, and parts. For more
information, visit www.Trane.com.
Trane has a policy of continuous product and product data improvement and reserves the right to change design and specifications without notice.