Echelon LonScanner FX Protocol Analyzer User Manual

LonScanner™ FX Protocol Analyzer User’s Guide078-0305-01B

4 Introduction to the LonScanner Protocol Analyzer Figure 1. LonScanner License Activation Dialog To continue running in demonstration mode, click C

LonScanner FX Protocol Analyzer User’s Guide 5 • Select Professional Edition Activation Key, Single User if you do not have a prepaid key, a

6 Introduction to the LonScanner Protocol Analyzer Figure 2. LonScanner Transfer Activation Wizard 2. Click Next to continue. The main window open

LonScanner FX Protocol Analyzer User’s Guide 7 a. Step one must be performed on the target computer to which you want to transfer the activa

8 Introduction to the LonScanner Protocol Analyzer network interface. For more information, see Monitoring a Network Channel. • Open an Existing Pac

LonScanner FX Protocol Analyzer User’s Guide 9 SmartServer, i.LON 600 LONWORKS/IP Server, PCC-10, or PCLTA-20/21 network interface see Append

10 Introduction to the LonScanner Protocol Analyzer Figure 5. Main LonScanner Window The main window includes the following three main areas: • The

LonScanner FX Protocol Analyzer User’s Guide 11 Using the LonScanner Window This section provides a brief introduction to the features that y

12 Introduction to the LonScanner Protocol Analyzer Menu Description Help Use the Help menu to access information about the version and activation

LonScanner FX Protocol Analyzer User’s Guide 13 Clears all data from the log file currently shown in the Packet Log tab. Starts the LNS Na

Echelon, i.LON, LNS, LonMaker, LONMARK, LonTalk, LONWORKS, Neuron, NodeBuilder, and the Echelon logo are trademarks of Echelon Corporation registered

14 Introduction to the LonScanner Protocol Analyzer interface (that is, each tool can use the network interface at the same time). Network interface

LonScanner FX Protocol Analyzer User’s Guide 15 2 Logging Data This chapter describes how you can log packets with the protocol analyzer, an

16 Logging Data Configuring the LonScanner Protocol Analyzer You can configure the behavior of the protocol analyzer while it monitors a channel, inc

LonScanner FX Protocol Analyzer User’s Guide 17 Filtering Packets You can use filters to select the types of packets that are written to the

18 Logging Data You can also filter packets with a custom filter file. To create and use a custom filter file, modify the LsCustomFilter.cpp file in

LonScanner FX Protocol Analyzer User’s Guide 19 it in the Device Filters list, and then click one of the buttons at the bottom of the Device

20 Logging Data Figure 11. Global Filter Dialog 6. Under Mode, select Capture packets that pass the global and device filters to write packets that

LonScanner FX Protocol Analyzer User’s Guide 21 9. Click OK to save your changes and return to the Device Filter dialog. 10. Click OK on the

22 Logging Data Setting the Capture and Monitor Modes You can use the Capture and Monitor modes to control whether the packets collected from the cha

LonScanner FX Protocol Analyzer User’s Guide 23 Note: The data displayed on the statistics tabs is calculated based on the packets that pass

LonScanner FX Protocol Analyzer User’s Guide iii Welcome The Echelon® LonScanner™ Protocol Analyzer is a software tool that you can use to mon

24 Logging Data Viewing Bandwidth Utilization by Packet Type Select the Packet Types tab to view a breakdown of the packet types collected from the m

LonScanner FX Protocol Analyzer User’s Guide 25 Figure 14 shows a bandwidth utilization trend graph with example data. Figure 14. Bandwidth

26 Logging Data Figure 15. Error Rate History Tab The Err Rate History tab includes two timestamps: the timestamp for the oldest and the newest upd

LonScanner FX Protocol Analyzer User’s Guide 27 Figure 16. General Tab 2. Configure the settings on the General tab. These settings determ

28 Logging Data Bandwidth Utilization chart, whether logarithmic scaling should be used for the chart, and the colors that are used to display the ch

LonScanner FX Protocol Analyzer User’s Guide 29 Figure 19. Channel Type Dialog 9. Select the channel type and bandwidth utilization options

30 Logging Data Names are not included in the packets sent over the network, nor are they saved in log files. However, you can use names to identify

LonScanner FX Protocol Analyzer User’s Guide 31 Figure 20. LNS Names Import Wizard – Page One 2. Select the LNS database that contains the

32 Logging Data Figure 21. LNS Names Import Wizard – Page Two 3. Select the subsystem (or subsystems) that contains the names that you want to impo

LonScanner FX Protocol Analyzer User’s Guide 33 Figure 22. LNS Names Import Wizard – Page Three 4. As the names are imported, it is possibl

iv 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-8

34 Logging Data Figure 23. LNS Names Import Wizard – Page Four 5. Select a format for device and network variable names. Examples for each option

LonScanner FX Protocol Analyzer User’s Guide 35 1. Select Names → Import from Names File. A dialog opens to remind you that names that you

36 Logging Data Creating and Customizing Names You can use the Names menu to create your own names, or to customize the names that you already create

LonScanner FX Protocol Analyzer User’s Guide 37 4. Enter the group ID for the group in the Group Number field, and enter the name for the gr

38 Logging Data Figure 28. New Device Data Dialog 3. Enter the device’s name in the Device Name field, and then fill in the rest of the fields in t

LonScanner FX Protocol Analyzer User’s Guide 39 Figure 29. Edit Message Codes Dialog 2. The Edit Message Codes dialog lists all currently d

40 Logging Data Figure 31. Select Domain Dialog 2. The Select Domain dialog lists the domain names that are currently defined in your network. To

LonScanner FX Protocol Analyzer User’s Guide 41 Managing Names Files You can save names that you have created, edited, or imported for later

LonScanner FX Protocol Analyzer User’s Guide 43 3 Analyzing Packet Log Details This chapter describes how to organize and analyze the data s

LonScanner FX Protocol Analyzer User’s Guide v Table of Contents Welcome...

44 Analyzing Packet Log Details Searching For Packet Log Entries You can quickly search a packet log to find a specific packet, even if your log file

LonScanner FX Protocol Analyzer User’s Guide 45 The LonScanner toolbar also includes buttons you can use to find a string, and to move to th

46 Analyzing Packet Log Details To use bookmarks, perform the following steps: 1. Right-click the log entry in the Packet Log tab and click Toggle B

LonScanner FX Protocol Analyzer User’s Guide 47 1. Select Edit → Bookmarks to open the Bookmarks dialog, as shown in Figure 36. Figure 36.

48 Analyzing Packet Log Details Figure 37. Select Columns Dialog 2. The fields that are currently displayed in the Packet Log are listed in the Vis

LonScanner FX Protocol Analyzer User’s Guide 49 Figure 38. Format Columns Dialog 2. The dialog defaults to the Packet Number tab, which you

50 Analyzing Packet Log Details Figure 39. Colors Dialog 2. To enable transaction color-coding, select the Color Code Transactions checkbox. When

LonScanner FX Protocol Analyzer User’s Guide 51 Figure 40. Print Selection Dialog 2. Select the packets that you want to print and click OK

52 Analyzing Packet Log Details each log entry is written to the output file as a single line of plain ASCII text, followed by an end-of-line termina

LonScanner FX Protocol Analyzer User’s Guide 53 4 Example Logs This chapter describes the example log files that are included with the L

vi Searching By Log Number ... 45 Bookmarking Packet Log Entries ...

54 Example Logs Example Packet Logs Two example logs are included with the LonScanner software. One of the example log files is taken from a channel

LonScanner FX Protocol Analyzer User’s Guide 55 variable. In this example, the network variable index is 6. At packet 13, device 1/2 respon

56 Example Logs Figure 44. Example Log File Two – Packet 13 Selected In Figure 44, packet 13 is selected in the Packet Log. At packet number 13, de

LonScanner FX Protocol Analyzer User’s Guide 57 Figure 45. Example Log File Two – Packet 24 Selected At packet number 22, device DI-1 is sen

LonScanner FX Protocol Analyzer User’s Guide 59 A Network Interfaces This appendix lists the Echelon network interfaces that you can use wit

60 Network Interfaces Network Interfaces Overview You can use any of the following Echelon network interfaces with the LonScanner FX Protocol Analyze

LonScanner FX Protocol Analyzer User’s Guide 61 See the IP-852 Channel User's Guide (078-0312-01A) for more information about creating a

62 Network Interfaces 2. Select the network interface that you want to configure in the Device Selected dropdown list box. 3. For the NI Applicatio

LonScanner FX Protocol Analyzer User’s Guide 63 B LonScanner FX Protocol Analyzer Software License Agreement To successfully install the Lon

LonScanner FX Protocol Analyzer User’s Guide 1 1 Introduction to the LonScanner Protocol Analyzer This chapter introduces the LonScanner Pr

64 LonScanner FX Protocol Analyzer Software License Agreement LONSCANNER™ FX PROTOCOL ANALYZER NOTICE This is a legal agreement between you and Ech

LonScanner FX Protocol Analyzer User’s Guide 65 • “You(r)” means Licensee, i.e. the company, entity or individual who has rightfully acquir

66 LonScanner FX Protocol Analyzer Software License Agreement (e) except for the limited rights granted above, distribute, rent, loan, lease, transf

LonScanner FX Protocol Analyzer User’s Guide 67 DAMAGES, LOSSES, COSTS OR EXPENSES OF ANY KIND ARISING FROM THE SUPPLY OR USE OF THE LICENSED

68 LonScanner FX Protocol Analyzer Software License Agreement GENERAL This Agreement shall not be governed by the 1980 U.N. Convention on Contracts

www.echelon.com

2 Introduction to the LonScanner Protocol Analyzer Introduction The LonScanner FX Protocol Analyzer is a software tool that you can use to monitor, a

LonScanner FX Protocol Analyzer User’s Guide 3 3. Click LonScanner FX Protocol Analyzer to continue. The Welcome window opens. 4. Click Ne