Echelon LonScanner FX Protocol Analyzer User Manual

0 (0)

LonScanner™ FX Protocol

Analyzer User’s Guide

078-0305-01B

Echelon, i.LON, LNS, LonMaker, LONMARK, LonTalk, LONWORKS, Neuron, NodeBuilder, and the Echelon logo are trademarks of Echelon Corporation registered in the United States and other countries. LonScanner is a trademark of the Echelon Corporation.

Other brand and product names are trademarks or registered trademarks of their respective holders.

Neuron Chips and other OEM Products were not designed for use in equipment or systems, which involve danger to human health or safety, or a risk of property damage and Echelon assumes no responsibility or liability for use of the Neuron Chips in such applications.

Parts manufactured by vendors other than Echelon and referenced in this document have been described for illustrative purposes only, and may not have been tested by Echelon. It is the responsibility of the customer to determine the suitability of these parts for each application.

ECHELON MAKES AND YOU RECEIVE NO WARRANTIES OR CONDITIONS, EXPRESS, IMPLIED, STATUTORY OR IN ANY COMMUNICATION WITH YOU, AND ECHELON SPECIFICALLY DISCLAIMS ANY IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of Echelon Corporation.

Printed in the United States of America.

Echelon Corporation www.echelon.com

Welcome

The Echelon® LonScanner™ Protocol Analyzer is a software tool that you can use to monitor, analyze, and diagnose the behavior of LONWORKS® networks. The LonScanner Protocol Analyzer connects to IP-852 (ISO/IEC 14908-4) and native LONWORKS (ISO/IEC 14908-1) channels, collects packets from those channels, and stores information from the packets into log files. You can use the log files to inspect and interpret the collected packets.

You can monitor up to 10 channels at once with the protocol analyzer. You can view the logs created for each channel (called active logs) while the protocol analyzer is monitoring the channel and collecting packets, and you can take advantage of the filtering and statistical features that the tool provides to gather the information that you want. You can also view logs that you have saved to diagnose network problems that occurred when the log was created.

Audience

This document assumes that the reader has a good understanding of the LONWORKS platform and of general analysis for network communications.

What’s New for LonScanner FX

The LonScanner FX Protocol Analyzer is part of the LONWORKS 2.0 product family. The LonScanner FX Protocol Analyzer adds the following features to those provided by Release 3 of the LonScanner Protocol Analyzer:

•Runs on Microsoft® Windows® 7, Windows Vista®, and Windows Server 2008. The LonScanner FX Protocol Analyzer is designed for the 32-bit versions of Windows, but is compatible with the x64 Editions.

•Provides multiuser licensing options.

Related Documentation

The following manuals are available from the Echelon Web site (www.echelon.com/docs) for products that are commonly used with the LonScanner Protocol Analyzer:

•i.LON SmartServer 2.0 User's Guide (078-0345-01E). This manual describes how to configure the i.LON SmartServer and use its applications to monitor and manage control networks.

•Introduction to the LONWORKS Platform (078-0183-01B). This manual provides an introduction to the ISO/IEC 14908-1 (ANSI/CEA-709.1 and EN14908) Control Network Protocol, and provides a high-level introduction to LONWORKS networks and the tools and components that are used for developing, installing, operating, and maintaining them.

•IP-852 Channel User's Guide (078-0312-01A). This manual provides information you will need when creating an IP-852 channel with an i.LON SmartServer, i.LON 100 Internet Server, i.LON 600 LONWORKS/IP Server, or an LNS Server. This includes instructions you can follow when

LonScanner FX Protocol Analyzer User’s Guide

iii

configuring the IP-852 channel with the Echelon LONWORKS/IP Configuration Server, and guidelines to follow when using NAT, DNS, or DHCP on the IP-852 channel.

•LNS Programmer's Guide (078-0177-01F). This manual describes how to write LNS applications.

•LonMaker User's Guide (078-0333-01A). This manual describes how to use the LonMaker Integration Tool to design, commission, monitor and control, maintain, and manage a network.

•LONMARK® Application Layer Interoperability Guidelines. This manual describes design guidelines for developing applications for open interoperable LONWORKS devices, and is available from the LONMARK Web site, www.lonmark.org.

•LONWORKS PCC-10 PC Card User's Guide (078-0155-01B). This manual provides an overview of the PCC-10 card and software, including installation details and configuration options. For developers and end users of LONWORKS systems using the PCC-10 card.

•LONWORKS PCLTA-20 PCI LonTalk Adapter User's Guide (078-0179- 01C). This manual provides detailed technical specifications on the electrical and mechanical interfaces and operating environment characteristics for the PCLTA-20 adapter.

•LONWORKS PCLTA-21 PCI Interface User's Guide (078-0271-01A). This manual describes the mechanical characteristics and the hardware and software driver installation for the Echelon PCLTA-21 Interface (Models 74501, 74502, 74503, 74504, and 74505).

•LONWORKS USB Network Interface User's Guide (078-0296-01B). This manual describes how to install and use Echelon's U10 and U20 USB Network Interface products. The USB Network Interfaces are miniature, high performance network interfaces that provide network connection between USB-enabled PCs and Free Topology (TP/FT-10) or C-Band Power Line (PL-20C or PL-20N) LONWORKS channels. The interfaces are provided through a v1.1 and v2.0 compliant USB connection.

•Mini FX User’s Guide (078-0398-01A). This manual describes how to use the Mini FX Evaluation Kit. You can use the Mini kit to develop a prototype or production control system that requires networking, or to evaluate the development of applications for such control networks using the LONWORKS platform.

•NodeBuilder® FX User’s Guide (078-0405-01A). This manual describes how to develop a LONWORKS device using the NodeBuilder tool.

•ShortStack FX User's Guide (078-0365-01B). This manual describes how to develop an application for a LONWORKS device using Echelon’s ShortStack® FX Micro Server. It describes the architecture of a ShortStack device and how to develop a ShortStack device.

All of the Echelon documentation is available in Adobe® PDF format. To view the PDF files, you must have a current version of the Adobe Reader®, which you can download from Adobe at: www.adobe.com/products/acrobat/readstep2.html.

Table of Contents
Welcome.........................................................................................................	iii
Audience ........................................................................................................	iii
What’s New for LonScanner FX...................................................................	iii
Related Documentation ................................................................................	iii
Chapter 1. Introduction to the LonScanner Protocol Analyzer........................	1
Introduction....................................................................................................	2
Software Requirements .................................................................................	2
Installing the LonScanner Software.............................................................	2
Updating LonScanner 3.................................................................................	3
Activating the LonScanner Software............................................................	3
Transferring a LonScanner Activation ..................................................	5
Viewing Activation Status ......................................................................	7
Using the LonScanner Protocol Analyzer.....................................................	7
Monitoring a Network Channel..............................................................	8
Opening an Existing Packet Log ............................................................	9
Log Files Overview ..................................................................................	9
Using the LonScanner Window ............................................................	11
LonScanner Menus .........................................................................	11
LonScanner Toolbar........................................................................	12
LonScanner Status Bar ..................................................................	13
Using LonScanner with LNS Turbo Edition ..............................................	13
Chapter 2. Logging Data..................................................................................	15
Configuring the LonScanner Protocol Analyzer ........................................	16
Setting Logging Preferences .................................................................	16
Filtering Packets ...................................................................................	17
Configuring the Global and Device Filters....................................	18
Importing Filter Settings from a Channel ....................................	21
Saving Filter Settings for Later Use .............................................	21
Setting the Capture and Monitor Modes .............................................	22
Viewing Channel Statistics and Trend Graphs .........................................	22
Viewing General Statistics ...................................................................	23
Viewing Bandwidth Utilization by Packet Type .................................	24
Viewing Bandwidth Utilization History ..............................................	24
Viewing Error Rate History..................................................................	25
Setting Statistics Options .....................................................................	26
Using Names ................................................................................................	29
Importing Names...................................................................................	30
Importing Names from an LNS Database.....................................	30
Importing Names from a Local Names File ..................................	34
Importing Names from a Channel .................................................	35
Creating and Customizing Names .......................................................	36
Creating Group Names...................................................................	36
Creating Device Names ..................................................................	37
Creating Message Code Names......................................................	38
Creating Domain Names ................................................................	39
Managing Names Files..........................................................................	41
Chapter 3. Analyzing Packet Log Details .......................................................	43
Searching For Packet Log Entries ..............................................................	44
Searching By String ..............................................................................	44
LonScanner FX Protocol Analyzer User’s Guide	v

Searching By Log Number....................................................................	45
Bookmarking Packet Log Entries ...............................................................	45
Formatting the Packet Log..........................................................................	47
Selecting Data Fields ............................................................................	47
Formatting Data Field Columns ..........................................................	48
Color-Coding the Packet Log ................................................................	49
Printing Log Files ........................................................................................	50
Exporting Log Files......................................................................................	51
Chapter 4. Example Logs.................................................................................	53
Example Packet Logs...................................................................................	54
Sample 1: Channel without Assigned Names......................................	54
Sample 2: Channel with Names Imported from an LNS Database ...	55
Appendix A. Network Interfaces .....................................................................	59
Network Interfaces Overview......................................................................	60
PCC-10 and PCLTA-20/21 ....................................................................	61
Appendix B. LonScanner FX Software License Agreement ...........................	63

Introduction to the LonScanner Protocol Analyzer

This chapter introduces the LonScanner Protocol Analyzer. It describes how to install and activate the LonScanner software, and how to get started with the protocol analyzer.

LonScanner FX Protocol Analyzer User’s Guide

Introduction

The LonScanner FX Protocol Analyzer is a software tool that you can use to monitor, analyze, and diagnose the behavior of LONWORKS networks. The LonScanner FX Protocol Analyzer connects to IP-852 (ISO/IEC 14908-4) and native ISO/IEC 14908-1 channels, collects packets from those channels, and stores information from the packets into log files. You can use the log files to inspect and interpret the collected packets.

This manual refers to both IP-852 (ISO/IEC 14908-4) and LONWORKS/IP channels as IP-852 channels. This manual refers to native ISO/IEC 14908-1 channels, such as TP/FT-10 and PL-20 channels, as LONWORKS channels.

Software Requirements

To install and use the LonScanner software, your computer must meet the following minimum requirements:

•Intel® Pentium® III 800 MHz processor

•128 MB RAM

•32-bit version of Windows 7, Windows Vista, or Windows Server 2008

•10 MB of available hard-disk space

•1024x768 screen resolution

Installing the LonScanner Software

To install the LonScanner software:

1.Start the installation program for the LonScanner FX Protocol Analyzer by performing one of the following steps:

a.Insert the Echelon LonScanner FX Protocol Analyzer CD into a CDROM or DVD-ROM drive. If the installation does not automatically start after a few seconds, start the program manually. You can start the installation by clicking the Windows Start button, clicking Run, browsing to the setup application, and then clicking Open. The main LonScanner installation window opens.

b.Double-click the LonScannerFX.exe file that you downloaded from the Echelon Web site.

2.Click Install Products to continue. The Install Products window opens.

2	Introduction to the LonScanner Protocol Analyzer

3.Click LonScanner FX Protocol Analyzer to continue. The Welcome window opens.

4.Click Next to continue. The License Agreement window opens.

5.Read the terms of the LonScanner FX Protocol Analyzer software license agreement. If you agree to the terms of the license agreement, click I Accept the Terms in the License Agreement. The User window opens.

Note: The LonScanner software license is included in this document as Appendix B, LonScanner FX Protocol Analyzer Software License Agreement, on page 63.

6.Enter your user name, organization and product serial number. Click Next to continue.

7.If the LONWORKS path has not been set for your computer, a dialog opens to prompt you to choose this path. You can change this setting as long as you have not previously installed any other Echelon or LONMARK software. Click OK to select the path.

8.On the next dialog, click Install to begin the installation. When the installation has completed, a completion dialog appears.

You can also install the Adobe Reader or the NodeBuilder® Resource Editor software from the Install Products dialog (see step 2). Drivers for the i.LON SmartServer, i.LON 100 Internet Server, i.LON 600 LONWORKS/IP Server, and the U10 and U20 USB Network Interfaces are included with the main LonScanner software installation.

You can use the NodeBuilder Resource Editor to browse the network variable types available on your computer when configuring device names with the protocol analyzer, as described in Chapter 2, Logging Data, on page 15.

Updating LonScanner 3

You can install the LonScanner FX software over an existing LonScanner 3 installation by following the procedure described in Installing the LonScanner Software on page 2. If you activated the LonScanner 3 software, the LonScanner FX software will automatically be activated. If you used the LonScanner 3 LNS Turbo Edition, an LNS Turbo Server is still required to use the LonScanner FX software. If you had the LonScanner 3 Professional Edition, an LNS Turbo Server is not required, but can be used. If you had the LonScanner 3 Demo Edition, you will have a LonScanner FX Demo Edition.

Activating the LonScanner Software

After a successful installation, the protocol analyzer runs in demonstration mode until you activate it. When operating in demonstration mode, the LonScanner License Activation dialog (shown in Figure 1 on page 4) appears each time you start the protocol analyzer.

LonScanner FX Protocol Analyzer User’s Guide

Figure 1. LonScanner License Activation Dialog

To continue running in demonstration mode, click Continue Eval. When operating in demonstration mode, the protocol analyzer does not display every captured packet and displays only the first 20 packets of a saved or imported log file. After you activate the product, you will have access to all LonScanner features.

If you choose to operate in demonstration mode, the LonScanner License Activation dialog appears every time you open the protocol analyzer. You can also access the LonScanner License Activation dialog and activate the LonScanner software while running in demonstration mode by selecting Help → Activate Product → Activate.

To activate the protocol analyzer from the LonScanner License Activation dialog, select a product version from the list:

•Select Prepaid Professional Edition, Single User if you purchased a Model 33110-401 LonScanner FX Professional Edition with prepaid key. You must supply the serial number supplied with your prepaid edition for either of the prepaid editions.

•Select Prepaid Professional Edition, 5-Pack if you purchased a Model 33110-403 LonScanner FX Professional Edition with five prepaid keys. You must supply the serial number supplied with your prepaid edition for either of the prepaid editions. Repeat the activation process on up to five primary computers and up to five secondary computers.

4	Introduction to the LonScanner Protocol Analyzer

•Select Professional Edition Activation Key, Single User if you do not have a prepaid key, and you are ordering a single activation key. You can use this option to activate a LonScanner FX Demo Edition or to add an additional user for a LonScanner FX Professional Edition.

•Select Professional Edition Activation Key, 5-Pack if you do not have a prepaid key, and you are ordering a 5-pack with five activation keys. You must repeat the activation process on up to five primary computers and up to five secondary computers. You can use this option to either activate a LonScanner FX Demo Edition on up to five computers or to add up to five additional users for a LonScanner FX Professional Edition.

After you select a product version, click Copy Order Form to Clipboard. Paste the order form that is copied to an e-mail message or text editor document, fill in the blanks on the form, and then e-mail or fax the request to Echelon, using the e- mail address or fax number on the form. Echelon will process the request and send you an activation key.

After you receive the activation key, enter it in the Activation Key field, and click Activate to activate the software.

Transferring a LonScanner Activation

You can transfer your LonScanner activation to another computer. This process deactivates the protocol analyzer on your original computer, and then activates it on the new computer.

To transfer activation, perform the following steps:

1.Select Help → Activate Product → Transfer Activation. The Transfer Activation Wizard opens, as shown in Figure 2 on page 6.

LonScanner FX Protocol Analyzer User’s Guide

Echelon LonScanner FX Protocol Analyzer User Manual

Figure 2. LonScanner Transfer Activation Wizard

2. Click Next to continue. The main window opens, as shown in Figure 3.

Figure 3. LonScanner Transfer Activation Wizard Main Window 3. From the main window, you must perform all three steps:

6	Introduction to the LonScanner Protocol Analyzer

a.Step one must be performed on the target computer to which you want to transfer the activation.

b.Step two must be performed on the computer that currently contains the activation that you want to transfer. The LonScanner software on this computer will no longer be activated after the transfer is complete, and will run in demonstration mode.

c.Step three must be performed on the target computer to which you want to transfer the activation. This step completes the transfer.

See the LonScanner online help for more information about these steps.

Viewing Activation Status

You can access information about your LonScanner software at any time by selecting Help → About LonScanner Protocol Analyzer to open the About Echelon LonScanner Protocol Analyzer dialog. This dialog displays the version number and activation key of your LonScanner software. You can access additional activation information by selecting Help → Activate Product → Display Activation Status to open the Activation Status dialog.

Using the LonScanner Protocol Analyzer

After you install the LonScanner software, you can begin monitoring IP-852 and LONWORKS channels with the protocol analyzer and analyzing the data that it collects.

To start the protocol analyzer, select Programs → Echelon LonScanner Protocol Analyzer → LonScanner Protocol Analyzer from the Windows Start menu. If you have not yet activated the software, the LonScanner License Activation dialog opens, as shown in Figure 1 on page 4. If the product is activated (or you click Continue Eval from the dialog), the Start-Up dialog opens, as shown in Figure 4.

Figure 4. Start-Up Dialog

From the Start-Up dialog, you have two options to choose from:

•Monitor a LonWorks Network Interface. Select this option to monitor an IP-852 or LONWORKS channel through a local or remote LONWORKS

LonScanner FX Protocol Analyzer User’s Guide

network interface. For more information, see Monitoring a Network Channel.

•Open an Existing Packet Log. Select this option to view a packet log saved from a previous monitoring session. For more information, see

Opening an Existing Packet Log on page 9.

Monitoring a Network Channel

To monitor an IP-852 or LONWORKS channel, perform the following steps:

1.Select Monitor a LonWorks Network Interface on the Start-Up dialog shown in Figure 4, and then select the network interface that you plan to use from the Interface dropdown list box. This list box displays the available network interfaces for your computer.

To add a new network interface, click Add to open the LONWORKS Interfaces application (from the Windows Control Panel). If you are using an i.LON SmartServer, i.LON 100 Internet Server or an i.LON 600 LONWORKS/IP Server as your network interface, you must configure it with the LONWORKS Interfaces application before you can use it with the protocol analyzer.

From the LONWORKS Interfaces application, you can add a remote network interface (RNI), an IP-852 network interface, or a USB network interface:

•To add an RNI, click Add to open the Add Network Interface Wizard. On the first page of the wizard, enter a name for the network interface, and click Next. On the second page, select LonScanner as the Interface Type. Click Finish to add the network interface and close the wizard.

•To add an IP-852 network interface, click Add to open the Network Interface Add dialog. Enter a name for the network interface in the Name field, select (or enter) an IP address in the IP Address dropdown list box, enter the IP port in the IP Port field, select the appropriate channel timing type, and enter the authentication key (if the device uses authentication) in the MD5 Authentication Key field. Click OK to add the network interface and close the dialog.

•To add a USB network interface, plug an Echelon U10 or U20 network interface into to an available USB port on your computer. The LONWORKS Interfaces application should show the network interface automatically. Select the Show detached interfaces checkbox to show previously configured USB network interfaces that are not currently connected to your computer.

See the LONWORKS Interfaces application’s online help for more information.

No additional configuration is required to use an Echelon U10 or U20

USB Network Interface. For additional information about an i.LON

8	Introduction to the LonScanner Protocol Analyzer

SmartServer, i.LON 600 LONWORKS/IP Server, PCC-10, or PCLTA-20/21 network interface see Appendix A, Network Interfaces, on page 59.

2.Click OK to begin monitoring the selected channel. The main LonScanner window opens. A log entry is added to the Packet Log tab for each packet that the protocol analyzer receives from the channel. For an overview of the Packet Log tab and the rest of the main LonScanner window, see Log Files Overview on page 9.

3.To save the log file for later use, select File → Save Log As to open the Save As dialog. After you save the log file, you can re-open the log file at any time, as described in Opening an Existing Packet Log.

4.To monitor additional channels, select File → New Connection, or click New from the LonScanner toolbar. You can monitor up to 10 channels at the same time.

See Chapter 2, Logging Data, on page 15, for a description of how to use the protocol analyzer to perform additional tasks, such as filtering incoming data or controlling the packet log.

Opening an Existing Packet Log

To open a packet log saved from a previous LonScanner or LonManager Protocol Analyzer session, select Open an Existing Packet Log on the Start-Up dialog shown in Figure 4 on page 7, and enter the log that you want to open in the File Name field, or click the browse button to open the Open dialog. LonScanner log files have the .lsl extension, and LonManager log files have the .pal extension.

After you select a file, click OK to open the main LonScanner window. The log that you selected is displayed in the Packet Log tab. For an overview of the Packet Log tab and the rest of the main LonScanner window, see the Log Files Overview section.

You can open additional packet logs after you start the protocol analyzer by selecting File → Open Log or by clicking Open from the LonScanner toolbar.

Log Files Overview

When you begin monitoring a channel or open a saved log file with the protocol analyzer, the main LonScanner window opens, as shown in Figure 5 on page 10.

LonScanner FX Protocol Analyzer User’s Guide

Figure 5. Main LonScanner Window

The main window includes the following three main areas:

•The Packet Log tab comprises the majority of the main LonScanner window. The Packet Log tab contains a series of log entries, one for each packet that the protocol analyzer collects from the channel. The log entries are listed sequentially by timestamp. See the online help for descriptions of the data fields listed for each packet.

While you are actively monitoring a channel, you can also select the General Statistics, Packet Types, Bandwidth Utilization History, and Error Rate History tabs at the bottom of the window to view statistics collected from the channel during your log session. For more information on these tabs, and for information about how you can configure the protocol analyzer’s behavior during an active log session, see Chapter 2,

Logging Data, on page 15.

•The Packet Detail pane to the right of the Packet Log tab lists detailed information about the packet that is currently selected (if any) in the Packet Log. Click a packet in the Packet Log to select it and view its details in the Packet Detail pane. See the online help for descriptions of the data fields listed for each packet in the Packet Detail pane.

•The menus and toolbar at the top of the window allow you to determine how the protocol analyzer collects data from the channel and to organize and analyze the data after it has been collected. For an overview of the features provided by each menu, see Using the LonScanner Window on page 11.

10	Introduction to the LonScanner Protocol Analyzer

Using the LonScanner Window

This section provides a brief introduction to the features that you can access using the main LonScanner window. These features are described in more detail in later chapters, and in the LonScanner online help.

LonScanner Menus

Table 1 lists the LonScanner menus, and describes the functionality that is provided by each menu. For detailed descriptions of each menu option, see Chapters 2 and 3 of this document, and the LonScanner online help.

	Table 1. LonScanner Menus

Menu	Description

File	Use the File menu to open new connections to local and remote
	channels, and to open pre-existing log files. You can also use the
	File menu to print and export log files, and to set the general logging
	preferences that affect how the protocol analyzer creates and
	manages log files.

Edit	Use the Edit menu to search through log files, and to bookmark
	specified log entries as being of interest.

View	Use the View menu to format how the data in the Packet Log is
	displayed (including selecting which data fields are displayed in the
	Packet Log for each log entry, how each data field is formatted, and
	what color and font is used to display each log entry). You can also
	use the View menu to hide or display the LonScanner toolbar, status
	bar, and Packet Detail pane.

Names	Use the Names menu to import or edit device and network variable
	names for the channel that you are monitoring.

Filter	Use the Filter menu to create and activate LonScanner filters, which
	you can use to select which packets the protocol analyzer stores into
	a log file, and which ones it does not store.

Network	When you are actively monitoring a channel with the protocol
	analyzer, you can use the Network menu to enable and disable
	capture mode and monitor mode, and to clear all data from the
	currently selected log.

Statistics	When you are actively monitoring a channel with the protocol
	analyzer, you can use the Statistics menu to configure how the
	protocol analyzer gathers and displays network statistics.

Window	Use the Window menu to arrange the log files and windows that are
	currently open.

LonScanner FX Protocol Analyzer User’s Guide

Menu	Description

Help	Use the Help menu to access information about the version and
	activation status of the LonScanner software, and to access the
	LonScanner online help. You can also access the LonScanner
	Transfer Activation Wizard from this menu.

LonScanner Toolbar

The LonScanner toolbar provides quick access to commonly used menu options. The LonScanner toolbar is shown in Figure 6.

Figure 6. LonScanner Toolbar

You can click a button on the toolbar to use the feature provided by that button. Table 2 describes the buttons.

Table 2. LonScanner Toolbar Buttons

Button Description

Opens a new connection to a channel and starts a new Packet

Log.

Opens an existing log file.

Saves the log file currently displayed in the Packet Log tab.

Enables or disables the recording of packets into the current log file when LonScanner is actively monitoring a channel.

Enables or disables automatic scrolling of the Packet Log tab to the most recently collected packets when you are actively monitoring a channel and recording packets into a log file.

Enables or disables automatic refreshing of the Packet Log tab when you are actively monitoring a channel and recording packets into a log file. When disabled, you must manually refresh the Packet Log by clicking the Refresh button, or by selecting View → Refresh Display, to see the most recently collected packets in the Packet Log tab.

Adjusts the column widths of the Packet Log tab.

Refreshes the information shown in the Packet Log and Statistics tabs when you are actively monitoring a channel and recording packets into a log file.

12	Introduction to the LonScanner Protocol Analyzer

Clears all data from the log file currently shown in the Packet

Log tab.

Starts the LNS Names Import Wizard, which you can use to import device and network variable names from an LNS database.

Finds an occurrence of a string in the Packet Log tab.

Finds the next occurrence of a string in the Packet Log tab.

Creates a bookmark. You can use bookmarks to mark certain log entries as being of interest.

Scrolls the Packet Log tab to the next bookmarked packet.

Scrolls the Packet Log tab to the previous bookmarked packet.

Prints the log file currently displayed in the Packet Log tab.

LonScanner Status Bar

The Status Bar is at the bottom of the LonScanner Protocol Analyzer window. It provides the following information:

•A status message that provides a brief description of the currently selected menu items and buttons.

•The total number of packets recorded into log file.

•The number of packets that have been filtered.

•The logging state of the currently selected active log.

•Whether or not network interface sharing is enabled or disabled.

Using LonScanner with LNS Turbo Edition

If you plan to use LonScanner FX Professional Edition with LONWORKS channels, you do not need an LNS Turbo Edition Server. However, when used with the protocol analyzer, an LNS Turbo Edition Server provides several additional features, including importing device and network variable names, network interface sharing, and monitoring of IP-852 channels.

With an LNS Turbo Edition Server, you can import device and network variable names from an LNS network database into the current LonScanner active log. See Chapter 2, Logging Data, on page 15, for more information.

With LNS Turbo Edition Server installed, the protocol analyzer and the LonMaker Integration Tool (or any custom LNS application) can share a network

LonScanner FX Protocol Analyzer User’s Guide

interface (that is, each tool can use the network interface at the same time). Network interface sharing applies to PCC-10, PCLTA-20/21, i.LON SmartServer, i.LON 100 Internet Server, i.LON 600 LONWORKS/IP Server, and U10/U20 USB Network Interfaces.

You can also run the protocol analyzer and the LonMaker tool (or any custom LNS application) at the same time with the same network interface on a computer with an LNS 3 Server if you use an i.LON SmartServer, i.LON 100 Internet Server, or an i.LON 600 LONWORKS/IP Server as the network interface. In addition, you can import device and network variable names from your LNS database if you have an LNS 3 Server.

If you have an LNS Turbo Edition Server installed, you can use the protocol analyzer to monitor IP-852 channels, as well as LONWORKS channels. If you attempt to monitor an IP-852 channel without an LNS Turbo Edition Server installed, the LonScanner Protocol Analyzer issues an error message (“Failed to open channel via OpenLDV”).

The IP-852 interface operates differently from LONWORKS channels. The layer 2 interface of every device on a LONWORKS channel receives every packet on the channel. But, Echelon’s IP-852 devices and routers do not automatically forward packets to every other device and router on the channel. Instead, they selectively forward packets directly to the intended destination devices and routers on the channel. As a result, the protocol analyzer does not receive packets that are sent on an IP-852 channel from one device or router to another if the source or destination device is not the computer running the protocol analyzer.

Figure 7 demonstrates this behavior. In the figure, the protocol analyzer is monitoring an IP-852 channel that contains two devices (named “IP-852 Device 1” and “IP-852 Device 2”). The protocol analyzer receives only those packets sent between the IP-852 devices and the LonScanner computer (the network paths displayed in green). The protocol analyzer does not receive packets sent between IP Device 1 and IP Device 2 (the network path displayed in red).

LonScanner

Computer

IP-852 Channel

IP-852 Device 1		IP-852 Device 2

Figure 7. Using LonScanner to Monitor an IP-852 Channel

14	Introduction to the LonScanner Protocol Analyzer

Logging Data

This chapter describes how you can log packets with the protocol analyzer, and how you can view statistics related to those packets. The first part of this chapter describes how you can configure the behavior of the protocol analyzer while it monitors a channel and collects packets, including topics such as setting logging preferences, using the Capture and Auto-Scroll features, and filtering packets.

The second part of this chapter describes how to access statistics that are available when you monitor a channel with the protocol analyzer, including data related to bandwidth utilization, the types of packets traveling on the network, and other network statistics.

This chapter also describes how you can use names to identify the devices and network variables on the channel that you are monitoring.

LonScanner FX Protocol Analyzer User’s Guide

Configuring the LonScanner Protocol Analyzer

You can configure the behavior of the protocol analyzer while it monitors a channel, including:

•Setting logging preferences to control how the protocol analyzer collects and record packets from a channel.

•Filtering packets to select which packet types are written to the log file.

•Setting the capture and monitor modes to determine whether the packets collected from the channel are written to the log file, and whether the protocol analyzer automatically refreshes the Packet Log display as data is added to the log.

Setting Logging Preferences

You can use the LonScanner Preferences dialog to determine how the protocol analyzer collects and displays data during a monitoring session. To set logging preferences, perform the following steps:

1.Select File → Preferences to open the Preferences dialog, as shown in Figure 8.

Figure 8. LonScanner Preferences Dialog

2.Specify your preferences. See the online help for descriptions of the fields in this dialog.

3.Click OK to save your changes.

16	Logging Data

Filtering Packets

You can use filters to select the types of packets that are written to the log file. You can use two types of filters:

•A global filter that applies to all packets

•A device filter that applies to packets sent to and from specific devices on the network

When the protocol analyzer receives a packet from the channel, it uses the global and device filter to determine if the packet passes the filter requirements, as described in Figure 9.

Start

	No	Does the packet pass the global
	No	filter requirements?
		filter requirements?

Yes

	Have any devices been defined	No
	in the device filter?	No
	in the device filter?

Yes

The packet does not		Does the packet pass the device		The packet passes the
pass the filter	No	Does the packet pass the device	Yes	The packet passes the
pass the filter	No	filter requirements?	Yes	filter requirements.
requirements.		filter requirements?		filter requirements.
requirements.

Figure 9. Filtering Packets

Important: Each time you modify the filter settings for a channel, the protocol analyzer automatically saves those settings. Thus, every time you connect to a channel, the protocol analyzer uses the last set of filter settings defined for the channel.

LonScanner FX Protocol Analyzer User’s Guide

+ 52 hidden pages