ZENA™ Wireless Network Analyzer User's Guide: © 2006 Microchip Technology Inc. DS51606A
ZENA™ Wireless Network Analyzer User's Guide: © 2006 Microchip Technology Inc. DS51606A
ZENA™ Wireless Network Analyzer User's Guide: © 2006 Microchip Technology Inc. DS51606A
Network Analyzer
User’s Guide
• Microchip believes that its family of products is one of the most secure families of its kind on the market today, when used in the
intended manner and under normal conditions.
• There are dishonest and possibly illegal methods used to breach the code protection feature. All of these methods, to our
knowledge, require using the Microchip products in a manner outside the operating specifications contained in Microchip’s Data
Sheets. Most likely, the person doing so is engaged in theft of intellectual property.
• Microchip is willing to work with the customer who is concerned about the integrity of their code.
• Neither Microchip nor any other semiconductor manufacturer can guarantee the security of their code. Code protection does not
mean that we are guaranteeing the product as “unbreakable.”
Code protection is constantly evolving. We at Microchip are committed to continuously improving the code protection features of our
products. Attempts to break Microchip’s code protection feature may be a violation of the Digital Millennium Copyright Act. If such acts
allow unauthorized access to your software or other copyrighted work, you may have a right to sue for relief under that Act.
NOTICE TO CUSTOMERS
All documentation becomes dated, and this manual is no exception. Microchip tools and
documentation are constantly evolving to meet customer needs, so some actual dialogs
and/or tool descriptions may differ from those in this document. Please refer to our web site
(www.microchip.com) to obtain the latest documentation available.
Documents are identified with a “DS” number. This number is located on the bottom of each
page, in front of the page number. The numbering convention for the DS number is
“DSXXXXXA”, where “XXXXX” is the document number and “A” is the revision level of the
document.
For the most up-to-date information on development tools, see the MPLAB® IDE on-line help.
Select the Help menu, and then Topics to open a list of available on-line help files.
INTRODUCTION
This chapter contains general information that will be useful to know before using the
“ZENA™ Wireless Network Analyzer User’s Guide”. Items discussed in this chapter
include:
• Document Layout
• Conventions Used in this Guide
• Recommended Reading
• The Microchip Web Site
• Development Systems Customer Change Notification Service
• Customer Support
• Document Revision History
DOCUMENT LAYOUT
This document describes how to use the ZENA Wireless Network Analyzer as a devel-
opment tool to monitor and analyze wireless network traffic. The manual
layout is as follows:
• Chapter 1. ZENA Wireless Network Analyzer Overview – This chapter intro-
duces the ZENA Wireless Network Analyzer hardware and software, and briefly
describes their capabilities.
• Chapter 2. Getting Started – This chapter describes how to install the ZENA
software.
• Chapter 3. ZigBee™ Protocol Tools – This chapter describes how to use the
ZigBee protocol tools provided by ZENA software. Both basic and advance
monitoring techniques are shown.
DOCUMENTATION CONVENTIONS
Description Represents Examples
Arial font:
Italic characters Referenced books MPLAB® IDE User’s Guide
Emphasized text ...is the only compiler...
Initial caps A window the Output window
A dialog the Settings dialog
A menu selection select Enable Programmer
Quotes A field name in a window or “Save project before build”
dialog
Underlined, italic text with A menu path File>Save
right angle bracket
Bold characters A dialog button Click OK
A tab Click the Power tab
N‘Rnnnn A number in verilog format, 4‘b0010, 2‘hF1
where N is the total number of
digits, R is the radix and n is a
digit.
Text in angle brackets < > A key on the keyboard Press <Enter>, <F1>
Courier New font:
Plain Courier New Sample source code #define START
Filenames autoexec.bat
File paths c:\mcc18\h
Keywords _asm, _endasm, static
Command-line options -Opa+, -Opa-
Bit values 0, 1
Constants 0xFF, ‘A’
Italic Courier New A variable argument file.o, where file can be
any valid filename
Square brackets [ ] Optional arguments mcc18 [options] file
[options]
Curly brackets and pipe Choice of mutually exclusive errorlevel {0|1}
character: { | } arguments; an OR selection
Ellipses... Replaces repeated text var_name [,
var_name...]
Represents code supplied by void main (void)
user { ...
}
RECOMMENDED READING
This user’s guide describes how to use the ZENA Wireless Network Analyzer. Other
useful documents are listed below. The following Microchip documents are available
and recommended as supplemental reference resources.
Readme for ZENA Wireless Network Analyzer
For the latest information on using the ZENA Wireless Network Analyzer, read the
Readme_ZENA.txt file (an ASCII text file) in the ZENA software installation directory.
The Readme file contains update information and known issues that may not be
included in this user’s guide.
PICmicro® MCU Data Sheets and Family Reference Manuals
See the Microchip web site for complete and updated versions of device data sheets
and related device family reference manuals.
Microchip 8-Bit PIC® Microcontroller Solutions (DS39630)
This document provides an overview of the features and functionality of the 8-bit PIC
microcontroller product family. It highlights its powerful architecture, flexible memory
technologies and easy-to-use development tools.
Microchip Stack for the ZigBee™ Protocol (AN965)
This application note describes how you can use the Microchip Stack for the ZigBee
protocol to quickly build your application. To illustrate the usage of the Stack, working
demo applications are included.
ZigBee™ Protocol Specification
See the ZigBee protocol web site for the complete and most recent revisions of the
ZigBee protocol (http://www.zigbee.org).
PICDEM™ Z Demonstration Kit User’s Guide (DS51524)
The PICDEM Z Demonstration Kit is designed to allow developers to evaluate and
experiment with Microchip solutions for the ZigBee protocol. The PICDEM Z
Demonstration Kit provides two ZigBee protocol nodes to create a simple, two-node
network.
IEEE 802.15.4™ Specification
See the IEEE web site for the complete and most recent revisions of the IEEE 802.15.4
specification (http://www.ieee.org).
CUSTOMER SUPPORT
Users of Microchip products can receive assistance through several channels:
• Distributor or Representative
• Local Sales Office
• Field Application Engineer (FAE)
• Technical Support
• Development Systems Information Line
Customers should contact their distributor, representative or field application engineer
(FAE) for support. Local sales offices are also available to help customers. A listing of
sales offices and locations is included in the back of this document.
Technical support is available through the web site at: http://support.microchip.com.
NOTES:
Note: The ZENA Wireless Network Analyzer board does not have to be attached
to the computer to use the configuration tool or the playback functionality.
The ZENA Wireless Network Analyzer uses a USB mini-B cable to connect to the PC.
The ZENA analyzer is powered by the USB bus. A PCB trace antenna receives the
packets on the specified channel and sends the information over USB to the PC
computer using the HID standard class.
Using this window, you can specify the profile and endpoint structure that your
application is using. See Table 3-3 for configuration options.
CAUTION
It is critical for ZigBee protocol interoperability that this section be accurate.
This tab is used to configure the ZDO (ZigBee Device Object) and APS (Application
Sub-Support) stack layers. Many options on this tab are enabled or disabled based on
the “ZigBee Device Type” specified on the ZigBee Device tab.
Many of these options have a direct correlation to the amount of RAM or nonvolatile
memory required by the application. To view the associated cost in the status bar at the
bottom of the window, hold the mouse cursor over the appropriate edit box. This feature
only functions if the edit box is enabled. See Table 3-4 and Table 3-5 for ZDO and APS
option selections.
This tab is used to configure the NWK (Network) and MAC (Medium Access Controller)
Stack layers. Many options on this tab are enabled or disabled based on the “ZigBee
Device Type” specified on the ZigBee Device tab.
Many of these options have direct correlation to the amount of RAM or nonvolatile
memory required by the application. To view the associated cost in the status bar at the
bottom of the window, hold the mouse cursor over the appropriate edit box. This feature
only functions if the edit box is enabled. See Table 3-6 and Table 3-7 for NWK and MAC
option selections.
This tab is used to configure basic PICmicro MCU options (see Table 3-8).
Note: Many options, including endpoint specification, affect multiple output files.
Therefore, it is recommended not to mix and match files from different
ZENA analyzer sessions.
If the validity check passes, ZENA analyzer will prompt for an output directory for the
configuration files. These files are:
• zigbee.def – Provides basic definitions for Stack configuration.
• myZigBee.c – Provides all ROM initialization for the Stack, including
ZigBee protocol device descriptors.
• zLink.lkr – Project linker script.
Each of these files has a time and date stamp included in the file. Refer to AN965,
“Microchip Stack for the ZigBee™ Protocol” for more information about these files.
A blank Packet Sniffer window for displaying network messages will also open. If this
window is closed, it can be reopened, either by clicking on the Network Messages
button, or by selecting the View>Network Messages menu option.
The ZigBee™ Network Monitor window can be used to start and stop real-time network
analysis, save and load data, and configure the display of the messages.
Click the Play button or select the Operation>Start Sniffing/Playback menu option to
begin real-time monitoring. The received messages are then displayed on the Packet
Sniffer window. Figure 3-9 shows a typical sequence of a new node joining a ZigBee
protocol network.
Figure 3-10 shows a message being routed from the originator to the final destination
and an APS-level Acknowledge being routed back. Note that by using the ZENA
analyzer, we can see that the first message is being routed along the network tree,
while the Acknowledge is being routing more directly.
3.3.1.1 TIME-STAMPS
The displayed time-stamp is the time from the end of the previous message until the
end of the current message. The time-stamp is displayed in micro seconds, and can
represent up to 71 minutes before rolling over.
Note: If playback is currently in progress (the Start button is disabled and the
Stop button is enabled), a packet cannot be selected with a mouse click.
Select the desired playback speed using the “Speed” combo box. Available options
are:
Packet playback is especially useful when using the filter option and performing more
advanced network analysis.
The filter is useful for displaying only selected packets in the Packet Sniffer window. For
example, suppose we wish to see all beacons generated by our network. Set up the
filter as follows:
1. Clear all “MAC Commands” checkboxes except “MAC Beacon”.
2. Clear all “NWK Commands” checkboxes.
3. Check all “Source Address” and “Destination Address” entries.
4. Select the “AND” option.
5. Click Apply Filter.
The Packet Sniffer window will then display all beacon packets and hide all others.
Refer to Figure 3-14.
Note: If the “Source Address” and “Destination Address” areas are empty and are
needed for your desired filter, replay the network formation portion of the
data. If you will be working with a network that maintains the same struc-
ture, you may want to save a captured data file that contains the network
formation for populating these fields.
Note: Multiple packets can be selected for hiding by holding down the control key
while clicking each desired packet. A range of packets can be selected by
clicking on the first packet of the range, then holding down the shift key
while clicking on the last packet of the range. Each selected packet will be
outlined in red. When all desired packets have been selected, right click
and select Hide to hide all selected packets.
The hidden packets can be redisplayed by right clicking on the appropriate X Hidden
Packet(s) box in the Packet Sniffer window and clicking UnHide.
The NCD window can be used during both real-time network monitoring and packet
playback. If the “Clear NCD on Start” checkbox on the Network Monitor window is
checked, then the NCD window will be cleared when real-time monitoring is started. If
you want the nodes to be retained, uncheck this box.
Note: Due to heavy system loading during real-time monitoring, the NCD window
may not update properly during real-time monitoring, particularly if there is
a lot of network traffic and if “Auto Scroll” is enabled. For best results,
disable “Auto Scroll” if network traffic is heavy. The NCD window will update
properly during packet playback.
When a message travels from one device to another, the NCD window will display a
line from the source node to the destination node. If a device transmits a broadcast
message, the NCD window will display a circle around the source node.
Note: Some messages, such as MAC Acknowledges, do not contain any address
information. These messages are shown originating from the Unknown
node.
Nodes can be hidden by right clicking on the node and selecting Hide. A new node,
named “Hidden”, will be created and all lines that would normally be drawn to the
hidden nodes will be drawn to that node. To unhide all hidden nodes, right click on the
“Hidden” node and select Unhide All.
When a device joins the network, the parent-child relationship of that device is shown
by a silver line between the two devices. See Table 3-14 for NCD window controls.
Since there are no nodes on this channel, no beacons are received, and the ZigBee
protocol coordinator forms a network.
Next, a ZigBee protocol router tries to find a network to join. It also emits a beacon
request, which looks just like Figure 3-16, since the beacon request contains no source
address information. Now, the ZigBee protocol coordinator responds with a beacon.
Note that the ZENA analyzer can tell from the beacon that this device is a ZigBee
protocol coordinator, but it does not yet know its MAC address.
The ZigBee protocol router will now try to join the network by sending an Association
Request. The ZENA analyzer can tell from the Association Request what type of device
is trying to join the network.
Now the device has joined the network. This relationship can be seen by clicking Clear
All Message Lines to display only the network association lines.
Note: If you will be working with a network that maintains the same structure, you
may want to save a captured data file that contains the network formation.
You can play back this file to establish the devices on the network, and then
play back the various data files containing the network traffic you wish to
monitor.
The NCD window shows how the message went from device 00.04.A3.00.00.00.00.88
to device 00.04.A3.00.00.00.00.01, traveling through two other nodes.
This particular message requested an APS Acknowledge. Figure 3-23 shows the path
of the APS Acknowledge. The ZENA analyzer illustrates that the APS Acknowledge
followed a different route than the original message.
Load this floor plan as the NCD background by clicking the Select Bitmap button. The
NCD window can be resized after loading the background to match the proportions of
the bitmap.
When network formation is played back and displayed on the NCD window, the nodes
can be moved to the location on the bitmap that represents their physical location.
Repeating the above example, Figure 3-27 and Figure 3-28 show the application
message and APS Acknowledge as they are routed through the network.
02/16/06