MICROCHIP ZENA User’s Guide

ZENA™ Wireless

Network Analyzer

User’s Guide

Note the following details of the code protection feature on Microchip devices:

• Microchip products meet the specification contained in their particular Microchip Data Sheet.

• 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.

Information contained in this publication regarding device applications and the like is provided only for your convenience and may be superseded by updates. It is your responsibility to ensure that your application meets with your specifications. MICROCHIP MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED, WRITTEN OR ORAL, STATUTORY OR OTHERWISE, RELATED TO THE INFORMATION, INCLUDING BUT NOT LIMITED TO ITS CONDITION, QUALITY, PERFORMANCE, MERCHANTABILITY OR FITNESS FOR PURPOSE. Microchip disclaims all liability arising from this information and its use. Use of Microchip devices in life support and/or safety applications is entirely at the buyer’s risk, and the buyer agrees to defend, indemnify and hold harmless Microchip from any and all damages, claims, suits, or expenses resulting from such use. No licenses are conveyed, implicitly or otherwise, under any Microchip intellectual property rights.

Trademarks

The Microchip name and logo, the Microchip logo, Accuron, dsPIC, K

EELOQ, microID, MPLAB, PIC, PICmicro, PICSTART,

PRO MATE, PowerSmart, rfPIC and SmartShunt are registered trademarks of Microchip Technology Incorporated in the U.S.A. and other countries.

AmpLab, FilterLab, Migratable Memory, MXDEV, MXLAB, SEEVAL, SmartSensor and The Embedded Control Solutions Company are registered trademarks of Microchip Technology Incorporated in the U.S.A.

Analog-for-the-Digital Age, Application Maestro, dsPICDEM, dsPICDEM.net, dsPICworks, ECAN, ECONOMONITOR, FanSense, FlexROM, fuzzyLAB, In-Circuit Serial Programming, ICSP, ICEPIC, Linear Active Thermistor, MPASM, MPLIB, MPLINK, MPSIM, PICkit, PICDEM, PICDEM.net, PICLAB, PICtail, PowerCal, PowerInfo, PowerMate, PowerTool, REAL ICE, rfLAB, rfPICDEM, Select Mode, Smart Serial, SmartTel, Total Endurance, UNI/O, WiperLock and Zena are trademarks of Microchip Technology Incorporated in the U.S.A. and other countries.

SQTP is a service mark of Microchip Technology Incorporated in the U.S.A.

All other trademarks mentioned herein are property of their respective companies.

Printed on recycled paper.

Microchip received ISO/TS-16949:2002 quality system certification for its worldwide headquarters, design and wafer fabrication facilities in Chandler and Tempe, Arizona and Mountain View, California in October 2003. The Company’s quality system processes and procedures are for its PICmicro devices, Serial EEPROMs, microperipherals, nonvolatile memory and analog products. In addition, Microchip’s quality system for the design and manufacture of development systems is ISO 9001:2000 certified.

8-bit MCUs, KEELOQ

code hopping

ZENA™ WIRELESS NETWORK

ANALYZER USER’S GUIDE

Preface ........................................................................................................................... 1

Chapter 1. ZENA Wireless Network Analyzer Overview

1.1 Introduction ..................................................................................................... 7

1.2 ZENA Wireless Network Analyzer Kit Contents ............................................. 7

1.3 ZENA Analyzer Overview ............................................................................... 7

Chapter 2. Getting Started

2.1 Introduction ..................................................................................................... 9

2.2 Installing ZENA Software ............................................................................... 9

Chapter 3. ZigBee™ Protocol Tools

3.1 Introduction ................................................................................................... 11

3.2 Microchip Stack Configuration Tool .............................................................. 11

3.3 Basic Network Monitoring ............................................................................. 23

3.4 Advanced Network Monitoring and Analysis ................................................ 34

Index ............................................................................................................................. 47

Worldwide Sales and Service .................................................................................... 50

ZENA™ Wireless Network Analyzer User’s Guide

NOTES:

ZENA™ WIRELESS NETWORK

ANALYZER USER’S GUIDE

Preface

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 Select the Help menu, and then Topics to open a list of available on-line help files.

INTRODUCTION

IDE on-line help.

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 development 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.

ZENA™ Wireless Network Analyzer User’s Guide

CONVENTIONS USED IN THIS GUIDE

This manual uses the following documentation conventions:

DOCUMENTATION CONVENTIONS

Description Represents Examples

Arial font:

Italic characters Referenced books MPLAB

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

dialog

Underlined, italic text with right angle bracket

Bold characters A dialog button Click OK

N‘Rnnnn A number in verilog format,

Text in angle brackets < > A key on the keyboard Press <Enter>, <F1>

Courier New font:

Plain Courier New Sample source code #define START

Italic Courier New A variable argument file.o, where file can be

Square brackets [ ] Optional arguments mcc18 [options] file

Curly brackets and pipe character: { | }

Ellipses... Replaces repeated text var_name [,

A menu path File>Save

A tab Click the Power tab

where N is the total number of digits, R is the radix and n is a digit.

Filenames autoexec.bat File paths c:\mcc18\h Keywords _asm, _endasm, static Command-line options -Opa+, -Opa- Bit values 0, 1 Constants 0xFF, ‘A’

Choice of mutually exclusive arguments; an OR selection

Represents code supplied by user

“Save project before build”

4‘b0010, 2‘hF1

any valid filename

[options] errorlevel {0|1}

var_name...] void main (void)

{ ... }

IDE User’s Guide

THE MICROCHIP WEB SITE

Microchip provides online support via our web site at www.microchip.com. This web site is used as a means to make files and information easily available to customers. Accessible by using your favorite Internet browser, the web site contains the following information:

• Product Support – Data sheets and errata, application notes and sample

programs, design resources, user’s guides and hardware support documents, latest software releases and archived software

• General Technical Support – Frequently Asked Questions (FAQs), technical

support requests, online discussion groups, Microchip consultant program member listing

• Business of Microchip – Product selector and ordering guides, latest Microchip

press releases, listing of seminars and events, listings of Microchip sales offices, distributors and factory representatives

DEVELOPMENT SYSTEMS CUSTOMER CHANGE NOTIFICATION SERVICE

Microchip’s customer notification service helps keep customers current on Microchip products. Subscribers will receive e-mail notification whenever there are changes, updates, revisions or errata related to a specified product family or development tool of interest.

To register, access the Microchip web site at www.microchip.com, click on Customer Change Notification and follow the registration instructions.

The Development Systems product group categories are:

• Compilers – The latest information on Microchip C compilers and other language

tools. These include the MPLAB and MPLAB ASM30 assemblers; MPLINK™ and MPLAB LINK30 object linkers; and MPLIB™ and MPLAB LIB30 object librarians.

• Emulators – The latest information on Microchip in-circuit emulators. This

includes the MPLAB ICE 2000 and MPLAB ICE 4000.

• In-Circuit Debuggers – The latest information on the Microchip in-circuit

debugger, MPLAB ICD 2.

• MPLAB

IDE – The latest information on Microchip MPLAB IDE, the Windows®

operating system Integrated Development Environment for development systems tools. This list is focused on the MPLAB IDE, MPLAB SIM simulator, MPLAB IDE project manager and general editing and debugging features.

• Programmers – The latest information on Microchip programmers. These

include the MPLAB PM3 and PRO MATE PICSTART

Plus and PICkit™ 1 development programmers.

C18 and MPLAB C30 C compilers; MPASM™

II device programmers and the

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.

DOCUMENT REVISION HISTORY

Revision A (April 2006)

• Initial Release of this Document.

Preface

ZENA™ Wireless Network Analyzer User’s Guide

NOTES:

ZENA™ WIRELESS NETWORK

ANALYZER USER’S GUIDE

Chapter 1. ZENA Wireless Network Analyzer Overview

1.1 INTRODUCTION

This chapter introduces the ZENA Wireless Network Analyzer hardware and software, and briefly describes their capabilities. The ZENA analyzer provides three main tools to develop IEEE 802.15.4 solutions quickly and efficiently with the free Microchip Stack for the ZigBee™ protocol. The ZENA analyzer enables developers to quickly modify and adapt the Microchip Stack for the ZigBee protocol to suit application requirements. The ZENA analyzer is also an IEEE 802.15.4 packet analyzer currently supporting the

2.4 GHz spectrum. The ZENA analyzer is capable of decoding ZigBee protocol v1.0 packets. The ZENA analyzer also provides ZigBee protocol network analysis support. The ZENA analyzer draws the network topology of the ZigBee protocol network as it is formed, allows users to watch packet transactions as they occur, record the packet transactions and play these packets back at variables speeds. These tools, combined, form a power tool in wireless development for the IEEE 802.15.4 protocol.

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.

1.2 ZENA WIRELESS NETWORK ANALYZER KIT CONTENTS

The ZENA Wireless Network Analyzer kit contains the following items:

• ZENA Wireless Network Analyzer

•USB mini-B cable

• ZENA Wireless Network Analyzer CD-ROM

1.3 ZENA ANALYZER OVERVIEW

The ZENA Wireless Network Analyzer board, seen in Figure 1-1, combines the PIC18LF2550 for full-speed, USB support with an IEEE 802.15.4 transceiver.

ZENA™ Wireless Network Analyzer User’s Guide

FIGURE 1-1: ZENA™ WIRELESS NETWORK ANALYZER BOARD

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.

Chapter 2. Getting Started

2.1 INTRODUCTION

This chapter describes how to install the ZENA Wireless Network Analyzer software.

2.2 INSTALLING ZENA SOFTWARE

Since the ZENA software can be used independently of the hardware, it is available from multiple sources, including the ZENA Wireless Network Analyzer CD-ROM and the installation for source files of AN965, “Microchip Stack for the ZigBee The version shipped with AN965, “Microchip Stack for the ZigBee version, which provides Stack configuration and packet playback capability, but does not allow real-time network monitoring with the ZENA Wireless Network Analyzer hardware. The full version is shipped with the ZENA Wireless Network Analyzer board.

If you are installing the software from the ZENA Wireless Network Analyzer CD-ROM, insert the CD-ROM into your computer’s CD-ROM drive. If the installation program does not start automatically, browse to the CD ROM directory and execute the ZENAvn.nn.exe program, where n.nn is the version number of the ZENA software. Follow the on-screen directions to install the ZENA software.

If you have installed the source code for one of the Microchip supported IEEE 802.15.4 protocols, the demo version of ZENA software is installed automatically in the root directory of the application source code. The demo version of ZENA software allows access to the Stack configuration and message playback features, but it will not communicate with the ZENA Wireless Network Analyzer hardware.

The ZENA Wireless Network Analyzer license agreement is presented. Read the agreement, then click I Accept to continue.

The ZENA Wireless Network Analyzer Readme file contains important information about the most recent release of the ZENA Wireless Network Analyzer, such as new features and known issues. The Readme file will change with each release.

Once the ZENA software is installed, use the desktop icon or Start Menu item to launch the ZENA software. The introductory screen appears as follows.

ZENA™ WIRELESS NETWORK

ANALYZER USER’S GUIDE

™ Protocol”.

™ Protocol” is a demo

FIGURE 2-1: ZENA™ SOFTWARE MAIN WINDOW

ZENA™ Wireless Network Analyzer User’s Guide

NOTES:

ZENA™ WIRELESS NETWORK

ANALYZER USER’S GUIDE

Chapter 3. ZigBee™ Protocol Tools

3.1 INTRODUCTION

This chapter describes how to use the ZigBee™ protocol tools provided by the ZENA Wireless Network Analyzer. Both basic and advance monitoring techniques are demonstrated.

3.2 MICROCHIP STACK CONFIGURATION TOOL

Microchip provides a freely available Stack as part of application note, AN965, “Microchip Stack for the ZigBee™ Protocol”. The application note and source code are

available for download from the Microchip web site (www.microchip.com). After you have reviewed the application note and studied the demonstration projects, you will be ready to start your own ZigBee protocol application.

The ZENA analyzer will greatly assist you with configuring the Microchip Stack by automatically generating a portion of the source code for your ZigBee protocol application. Be sure to refer to AN965, “Microchip Stack for the ZigBee™ Protocol” for details about each ZigBee protocol configuration option. Select ZigBee™ Tools>Stack Configuration from the main ZENA™ Software Stack Configuration window. The ZENA™ Software Stack Configuration – ZigBee™ Protocol window will be displayed. Using the tabbed dialog, you can select all of the options required for your ZigBee protocol application. ZENA software will automatically enable and disable certain options depending on the selections you have made.

ZENA™ Wireless Network Analyzer User’s Guide

3.2.1 Specifying ZigBee Protocol Device Information

Select the ZigBee Device tab.

FIGURE 3-1: ZENA™ SOFTWARE STACK CONFIGURATION WINDOW,

ZigBee™ DEVICE TAB

Using this window, you can configure the following items:

TABLE 3-1: ZigBee™ PROTOCOL DEVICE CONFIGURATION SELECTION

Configuration Option Description

MAC Address Each and every ZigBee protocol device must have its own, unique MAC address.

The Microchip OUI is provided as a default for development purposes only. Please see AN965, “Microchip Stack for the ZigBee™ Protocol” for additional information.

ZigBee Device Type ZigBee protocol defines three different types of devices. Select the device type of

your application.

IEEE Device Type Some ZigBee protocol devices have the option of selecting the IEEE device type.

Select the appropriate IEEE device type for your application.

ZDO/APS/NWK/MAC Defaults for Device Type

Transceiver Power Offers transceiver power selection. Selects how the transceiver is powered.

Power Source Offers power source selection. Selects your application’s power source.

Security This option is currently not supported by the Microchip Stack for ZigBee protocol.

Alternate PAN Coordinator This option is currently not supported by the Microchip Stack for ZigBee protocol.

Manufacturer Code (Hex) Each manufacturer of ZigBee protocol devices is assigned a manufacturer code by

When you change the device type, the ZENA™ analyzer will automatically set many options to their default settings unless you have altered them. If you have altered them and wish to restore them to their default values, click this button.

the ZigBee Alliance. Enter the four-digit hex value.

ZigBee™ Protocol Tools

3.2.2 Specifying Transceiver Information

Select the Transceiver tab.

FIGURE 3-2: ZENA™ SOFTWARE STACK CONFIGURATION WINDOW,

TRANSCEIVER TAB

Using this window, you can configure the following items:

TABLE 3-2: ZigBee™ PROTOCOL TRANSCEIVER CONFIGURATION SELECTION

Configuration Option Description

Transceiver Select one of the transceivers supported by the Stack.

Frequency Band This combo box shows the various available frequency bands of the selected transceiver. If

the transceiver supports only one frequency band, that frequency will be displayed and the combo box will be disabled.

(1)

Pin Assignments

PICDEM™ Z Pins Click this button to restore the pin assignments to the connections used by the PICDEM Z

Allowed Channels This area shows the channels that are supported by the selected frequency band. Selecting

Note 1: Ensure the pin exists on the target device. The application code is responsible for configuring the pin as a

digital input or output as appropriate.

This panel shows the required pins for the selected transceiver. The Stack allows you to change these pin connections to application-specific port pins.

Demonstration Board.

channels here will generate a label that can be used to specify the allowed channels for network formation and network discovery. Click Clear All to uncheck all channels, and click Select All to check all channels. Each channel can also be checked or unchecked individually by clicking on the checkbox that precedes the channel number.

+ 37 hidden pages

MICROCHIP ZENA User’s Guide

Table of Contents

Preface

INTRODUCTION

DOCUMENT LAYOUT

CONVENTIONS USED IN THIS GUIDE

RECOMMENDED READING

THE MICROCHIP WEB SITE

DEVELOPMENT SYSTEMS CUSTOMER CHANGE NOTIFICATION SERVICE

CUSTOMER SUPPORT

DOCUMENT REVISION HISTORY

Chapter 1. ZENA Wireless Network Analyzer Overview

1.1 INTRODUCTION

1.2 ZENA WIRELESS NETWORK ANALYZER KIT CONTENTS

1.3 ZENA ANALYZER OVERVIEW

FIGURE 1-1: ZENA™ WIRELESS NETWORK ANALYZER BOARD

Chapter 2. Getting Started

2.1 INTRODUCTION

2.2 INSTALLING ZENA SOFTWARE

FIGURE 2-1: ZENA™ SOFTWARE MAIN WINDOW

Chapter 3. ZigBee™ Protocol Tools

3.1 INTRODUCTION

3.2 MICROCHIP STACK CONFIGURATION TOOL

3.2.1 Specifying ZigBee Protocol Device Information

TABLE 3-1: ZigBee™ PROTOCOL DEVICE CONFIGURATION SELECTION

3.2.2 Specifying Transceiver Information

TABLE 3-2: ZigBee™ PROTOCOL TRANSCEIVER CONFIGURATION SELECTION