Echelon LonScanner FX Protocol Analyzer User Manual

LonScanner™ FX Protocol Analyzer User’s Guide
078-0305-01B
Echelon, i.LON, LNS, LonMaker, LONMARK, LonTalk, LON WORKS, 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 Ech elon 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 SP ECIFICALLY DISCLAIMS A N Y IMPLIED WARR A N T Y O F M ER C H ANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
No part of this publication may be reproduced, stored in a retrieval s ystem, 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. Copyright © 1994, 2010 Echelon Corporation.
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 L LonScanner Protocol Analyzer connects to IP-852 (ISO/IEC 14908-4) and native
ONWORKS (ISO/IEC 14908-1) channels, collects packets from those channels,
L 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
ONWORKS platform and of general analysis for network communications.
L

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:
ONWORKS
®
networks. The
®
Runs on Microsoft
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.
Windows® 7, Windows Vista®, and Windows Server

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
describes how to configure the applications to monitor and manage control networks.
Introduction to the LONW
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 L are used for developing, installing, operating, and maintaining them.
IP-852 Channel User's Guide
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
ONWORKS networks and the tools and components that
(078-0345-01E). This manual
i
.LON SmartServer and use its
ORKS
Platform
(078-0312-01A). This manual provides
(078-0183-01B). This manual
LonScanner FX Protocol Analyzer User’s Guide iii
configuring the IP-852 channel with the Echelon L
ONWORKS/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.
LONM
®
ARK
Application Layer Interoperability Guidelines.
This manual describes design guidelines for developing applications for open interoperable L Web site,
LONW
ORKS
ONWORKS devices, and is available from the LONMARK
www.lonmark.org.
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 L
LONW
ONWORKS systems using the PCC-10 card.
ORKS
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.
LONW
ORKS
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).
LONW
ORKS
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) L
ONWORKS 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
ONWORKS platform.
the L
NodeBuilder® FX User’s Guide
how to develop a L
ShortStack FX User's Guide
ONWORKS device using the NodeBuilder tool.
to develop an application for a L
®
ShortStack
FX Micro Server. It describes the architecture of a
(078-0405-01A). This manual describes
(078-0365-01B). This manual describes how
ONWORKS device using Echelon’s
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 download from Adobe at:
www.adobe.com/products/acrobat/readstep2.html.
®
, which you can
iv
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
vi
1
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 1

Introduction

The LonScanner FX Protocol Analyzer is a software tool that you can use to monitor, analyze, and diagnose the behavior of L 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.
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.
ONWORKS networks. The
This manual refers to both IP-852 (ISO/IEC 14908-4) and L channels as channels, such as TP/FT-10 and PL-20 channels, as
IP-852 channels
. This manual refers to native ISO/IEC 14908-1
LONW

Software Requirements

To install and use the LonScanner software, your computer must meet the following minimum requirements:
®
Intel
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
Pentium® III 800 MHz processor

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:
ONWORKS/IP
ORKS
channels
.
a. Insert the Echelon LonScanner FX Protocol Analyzer CD into a CD-
ROM 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
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
B,
Appendix
Agreement
6. Enter your user name, organization and product serial number. Click Next
to continue.
7. If the L
prompt you to choose this path. You can change this setting as long as you have not previously installed any other Echelon or L 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 software from the Install Products dialog (see step SmartServer, 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
LonScanner FX Protocol Analyzer Software License
, on page 63.
ONWORKS path has not been set for your computer, a dialog opens to
i.
LON 100 Internet Server, i.LON 600 LONWORKS/IP Server, and
LonScanner FX Protocol Analyzer software license
ONMARK software. Click
®
Resource Editor
2). Drivers for the i.LON
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
Software
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.
on page 2. If you activated the LonScanner 3 software, the LonScanner
Installing the LonScanner

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 start the protocol analyzer.
LonScanner FX Protocol Analyzer User’s Guide 3
Figure 1 on page 4) appears each time you
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 5
Figure 2. LonScanner Transfer Activation Wizard
2. Click Next to continue. The main window opens, as shown in
Figure 3. LonScanner Transfer Activation Wizard Main Window
Figure 3.
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
ONWORKS channels with the protocol analyzer and analyzing the data that it
L 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 Continue Eval from the dialog), the Start-Up dialog opens, as shown in
Figure 1 on page 4. If the product is activated (or you click
Figure 4. Start-Up Dialog
Figure 4.
From the Start-Up dialog, you have two options to choose from:
Monitor a LonWorks Network Interface.
IP-852 or L
LonScanner FX Protocol Analyzer User’s Guide 7
ONWORKS channel through a local or remote LONWORKS
Select this option to monitor an
network interface. For more information, see
Channel
.
Monitoring a Network
Open an Existing Packet Log.
saved from a previous monitoring session. For more information, see
Select this option to view a packet log
Opening an Existing Packet Log

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 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 L Interfaces application (from the Windows Control Panel). If you are using an
ONWORKS/IP Server as your network interface, you must configure it
L with the L 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:
Figure 4, and then select the network interface that you plan to
i
.LON SmartServer, i.LON 100 Internet Server or an i.LON 600
ONWORKS Interfaces application before you can use it with the
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.
on page 9.
ONWORKS
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 L 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 L information.
No additional configuration is required to use an Echelon U10 or U20 USB Network Interface. For additional information about an
ONWORKS Interfaces application’s online help for more
ONWORKS Interfaces application should show the
i
.LON
8 Introduction to the LonScanner Protocol Analyzer
SmartServer, network interface see Appendix
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
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
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 the protocol analyzer to perform additional tasks, such as filtering incoming data or controlling the packet log.
i
.LON 600 LONWORKS/IP Server, PCC-10, or PCLTA-20/21
A,
Network Interfaces

Log Files Overview

on page 9.

Opening an Existing Packet Log

2,
Logging Data
, on page 15, for a description of how to use
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 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.
Figure 4 on page 7, and enter the log that you want to open in the File
, on page 59.
.
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
Overview
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.
section.
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
Log Files
Figure 5 on page 10.
LonScanner FX Protocol Analyzer User’s Guide 9
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
Logging Data
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
11.
page
, on page 15.
Using the LonScanner Window
2,
on
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
Menu Description
File Use the File menu to open new connections to local and remote
2 and 3 of this document, and the LonScanner online help.
Table 1. LonScanner Menus
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 11
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. 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.
Figure 6.
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.
2,
See Chapter
With LNS Turbo Edition Server installed, the protocol analyzer and the LonMaker
LonScanner FX Protocol Analyzer User’s Guide 13
Logging Data
Integration Tool (or any custom LNS application) can share a network
, on page 15, for more information.
interface (that is, each tool can use the network interface at the same time).
i
Network interface sharing applies to PCC-10, PCLTA-20/21,
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
i
computer with an LNS 3 Server if you use an
i.
Internet Server, or an 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 L 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”).
LON 600 LONWORKS/IP Server as the network interface.
.LON SmartServer, i.LON 100
ONWORKS channels. If you
.LON SmartServer,
The IP-852 interface operates differently from L interface of every device on a L 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).
ONWORKS channel receives every packet on the
LonScanner
Computer
ONWORKS channels. The layer 2
IP-852 Channel
IP-852 Device 2IP-852 Device 1
Figure 7. Using LonScanner to Monitor an IP-852 Channel
14 Introduction to the LonScanner Protocol Analyzer
2

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 15

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:
Select File Preferences to open the Preferences dialog, as shown in
1. 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
A
device filter
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.
that applies to all packets
that applies to packets sent to and from specific devices on
Start
The packet does not
pass the filter
requirements.
No
No
Does the packet pass the global
filter requirements?
Yes
Have any devices been defined
in the device filter?
Yes
Does the packet pass the device
filter requirements?
Yes
No
The packet passes the
filter 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 17
Loading...
+ 52 hidden pages