Tektronix BPA100 Series User Manual

User Manual
BPA100 Series Bluetooth Protocol Analyzer Software Version 2.3
071-1128-00
This document applies to firmware version 2.3 and above.
Check for regular BPA Series software updates at www.tektronix.com/bpa_software
www.tektronix.com
Copyright © Tektronix, Inc. All rights reserved. Licensed software products are owned by Tektronix or its suppliers and are protected by United States copyright laws and international treaty provisions.
Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013, or subparagra phs (c)(1) and (2) of the Commercial Computer Software -- Restricted Rights clause a t FAR 52. 227-19, as applicable.
Tektronix products are covered by U.S. and foreign patents, issued and pending. Information in this publ ication supercedes that in all previously published material. Spec ifications and price change privileges reserved.
Tektronix, Inc., P.O. Box 500, Beaverton, OR 97077
TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.

HARDWARE WARRANTY

Tektronix warrants that the products that it manufactures and sells will be free from defects in materials and workmanship for a period of three (3) years from the date of shipment. If a product proves defective during this warranty period, Tektronix, at its option, either will repair the defective product without charge for parts and labor, or will provide a replacement in exchange for the defective product.
In order to obtain service under this warranty, Customer must notify Tektronix of the defect before the expiration of the warranty period and make suitable arrangements for the performance of service . Customer shall be responsible for packaging and shippi ng the defective product to the service center designated by Tektronix, with shipping charges prepaid. Tektronix shall pay for the return of the product to Customer if the shipment is to a location within the country in which the Tektronix service center is located. Customer shall be responsible for paying all shipping charges, dut ies, taxes, and any other charges for products returned to any other locations.
This warranty shall not apply to any defect, failure or damage caused by improper use or improper or inadequate maintenance and care. Tektronix shall not be obligated to furnish service under this warranty a) to repair damage resulting from attempts by personnel other than Tektronix representatives to install, repair or service the product; b) to repair damage resulting from improper use or connection to incompa tible equipment; c) to repair any damage or malfunction caused by the use of non-Tektronix supplies; or d) to service a product that has been modified or integrated with other products when the effect of such modification or integra tion increases the time or difficulty of servicing the product.
THIS W ARRANTY IS GIVEN BY TEKTRONIX IN LIEU OF ANY OTHER WARRANTIES, EXPRESS OR IMPLIED. TEKTRONIX AND ITS VENDORS DISCLAIM ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. TEKTRONIX’ RESPONSIBILITY TO REPAIR OR REPLACE DEFECTIVE PRODUCTS IS THE SOLE AND EXCLUSIVE REMEDY PROVIDED TO THE CUSTOMER FOR BREACH OF THIS WARRANTY. TEKTRONIX AND ITS VENDORS WILL NOT BE LIABLE FOR ANY INDIRECT , SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES IRRESPECTIVE OF WHETHER TEKTRONIX OR THE VENDOR HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES.

SOFTWARE WARRANTY

Tektronix warrants that the media on which this software product is furnished and the encoding of the programs on the media will be free from defects in materials and workmanship for a period of three (3) months from the date of shipment. If a medium or encoding proves defe ctive during the warranty period, Tektronix will provide a replacement in exchange for the defective medium. Except as to the media on which this software product is furnished, this software product is provided “as is” without warranty of any kind, either express or implied. Tektronix does not warrant that the functions contained in this software product will meet Customer’s requirements or that the operation of the programs will be uninterrupted or error-free.
In order to obtain service under this warranty, Customer must notify Tektronix of the defect before the expiration of the warranty period. If Tektronix is unable to provide a replacement that is free from defects in materials and workmanship within a reasonable time thereafter, Customer may terminate the license for this software product and return this software product and any associated materials for credit or refund.
THIS W ARRANTY IS GIVEN BY TEKTRONIX IN LIEU OF ANY OTHER WARRANTIES, EXPRESS OR IMPLIED. TEKTRONIX AND ITS VENDORS DISCLAIM ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. TEKTRONIX’ RESPONSIBILITY TO REPLACE DEFECTIVE MEDIA OR REFUND CUSTOMER’S PAYMENT IS THE SOLE AND EXCLUSIVE REMEDY PROVIDED TO THE CUSTOMER FOR BREACH OF THIS WARRANTY . TEKTRONIX AND ITS VENDORS WILL NOT BE LIABLE FOR ANY INDIRECT , SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES IRRESPECTIVE OF WHETHER TEKTRONIX OR THE VENDOR HAS ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES.

Table of Contents

Operating Basics
General Safety Summary v...................................
Preface vii...................................................
Reference Documents vii.............................................
Contacting Tektronix viii.............................................
What’s New in Version 2.3 1--1..................................
Acquiring Piconet Packet Data 1--3..............................
Overview 1--3.......................................................
Collecting Data 1--4..................................................
Understanding the Data Acquisition Window 1--6..........................
Setting Up an Acquisition 1--11.........................................
Setting Up the Data Filter 1--20..........................................
Setting Up Triggers 1-- 21..............................................
Using the Synchronization Wizard 1--32...................................
Starting a Logging Session 1--33.........................................
Ending a Logging Session 1--33.........................................
Saving the Current Logging Session 1--33.................................
Using the HCI Terminal Application 1--33................................
Analyzing Piconet Packet Data 1--35..............................
Opening a Data File 1--35..............................................
Understanding the Data Analysis Window 1--36............................
Reference
Appendices
Glossary Index
Using Bookmarks 2--1................................................
Performing an Advanced Search 2--3....................................
Exporting Data 2--4..................................................
Generating Error Packet Data 2--6......................................
Understanding Decryption 2--18.........................................
Setting Up Encryption in the Bluetooth Neighborhood 2--20...................
Appendix A: Specifications A--1..................................
Appendix B: Accessories B--1...................................
Standard Accessories B--1.............................................
Optional Accessories B--1.............................................
Appendix C: Sample Scripts C--1.................................
HCI Terminal Scripts C--1.............................................
Appendix D: Trigger Loopback Test D--1..........................
BPA100 Series Bluetooth Protocol Analyzer User Manual
i
Table of Contents

List of Figures

Figure 1--1: The Bluetooth Protocol Analyzer data acquisition
window 1--6..................................................
Figure 1--2: Acquisition Setup dialog box 1--11......................
Figure 1--3: Acquisition window Sync Bar 1--13.....................
Figure 1--4: Select Master and Select Slave dialog boxes 1--14..........
Figure 1--5: Decryption dialog box 1--16............................
Figure 1--6: Drift compensation dialog box 1--18.....................
Figure 1--7: Data Filter set up dialog box 1--20......................
Figure 1--8: Low Level Trigger Setup dialog box 1--22................
Figure 1--9: Sequence Repeat dialog box 1--23.......................
Figure 1--10: Sequence Timeout dialog box 1--24....................
Figure 1--11: Packet Definition d ialog box 1--25.....................
Figure 1--12: Customize Pattern dialog box 1--25....................
Figure 1--13: Slot Information dialog box 1--28......................
Figure 1--14: Low-level trigger setup with completed trigger
sequence 1--29.................................................
Figure 1--15: High Level Trigger Setup dialog box 1--30..............
Figure 1--16: Pre-Post Trigger Buffer setup dialog box 1--31...........
Figure 1--17: Bluetooth Protocol Analyzer synchronization
wizard 1--32...................................................
Figure 1--18: The Bluetooth Protocol Analyzer data analysis
window 1--36..................................................
Figure 1--19: List view context-sensitive menu 1--45..................
Figure 2--1: Analysis window showing bookmarked packets 2--1......
Figure 2--2: Bookmarks dialog box 2--2...........................
Figure 2--3: Advanced Search dialog box 2--3......................
Figure 2--4: Export Data dialog box 2--5...........................
Figure 2--5: Error Packet Generator dialog box 2--7.................
Figure 2--6: Sequence Repeat dialog box 2--8.......................
Figure 2--7: Sequence Timeout dialog box 2--9.....................
Figure 2--8: Error Name dialog box 2--10...........................
Figure 2--9: Standard packet format 2--10..........................
Figure 2--10: Packet Definition dialog box 2--11.....................
Figure 2--11: Customize Pattern dialog b ox 2--12....................
ii
BPA100 Series Bluetooth Protocol Analyzer User Manual
Table of Contents
Figure 2--12: Slot Information dialog box 2--14......................
Figure 2--13: Error Packet Generator setup with completed
error generation sequence 2--15...................................
Figure 2--14: Analyzer display of generated error 2--17...............
Figure 2--15: Bluetooth Protocol Analyzer List view showing
paring process 2--18............................................
Figure 2--16: Acquisition Summary dialog box 2--19..................
BPA100 Series Bluetooth Protocol Analyzer User Manual
iii
Table of Contents

List of Tables

Table 1--1: Acquisition window menus and toolbar buttons 1--7......
Table 1--2: Analysis window menus and toolbar buttons 1--37.........
T able 1--3: Packet tabs 1--43.....................................
Table A--1: Air Probe characteristics A--1.........................
T able A--2: Environmental characteristics A--1.....................
Table A--3: Certifications and compliances A--2....................
Table A--4: Physical characteristics A--3...........................
iv
BPA100 Series Bluetooth Protocol Analyzer User Manual

General Safety Summary

Review the following safety precautions to avoid injury and prevent damage to this product or any products connected to it. To avoid potential hazards, use this product only as specified.
Only qualified personnel should perform service procedures.
ToAvoidFireor
Personal Injury
Symbols and Terms
Do Not Operate With Suspected Failures. If you suspect there is damage to this product, have it inspected by qualified service personnel.
Do Not Operate in Wet/Damp Conditions.
Do Not Operate in an Explosive Atmosphere.
Keep Product Surfaces Clean and Dry.
Terms in this Manual. These terms may appear in this manual:
WARNING. Warning statements identify conditions or practices that could result in injury or loss of life.
CAUTION. Caution statements identify conditions or practices that could result in damage to this product or other property.
Symbols on the Product. The following symbols may appear on the product:
CAUTION
Refer to Manual
BPA100 Series Bluetooth Protocol Analyzer User Manual
v
General Safety Summary
vi
BPA100 Series Bluetooth Protocol Analyzer User Manual

Preface

This manual provides operating information for the Tektronix BPA100 Se­ries Bluetooth Protocol Analyzer and is organized into the following sections:
H Operating Basics provides instructions for operating the current version of
the Tektronix Bluetooth Protocol Analyzer.
H Reference provides detailed information on acquiring and analyzing Piconet
packet data.
H Appendix A: Specifications provides hardware specifications and regulatory
statements.
H Appendix B: Accessories lists the standard accessories.
H Appendix C: Sample Scripts provides sample HCI scripts.
H Appendix D: Trigger Loopback Test provides test instructions on how to
verify the Trigger In and Trigger Out functions are are operating properly.
H Glossary explains the terms used in this manual.

Reference Documents

The following third-party reference documents provide additional information:
H HCI Terminal Guide (Digianswer #00-11-03) provides information about
using a HCI terminal as an interface with Bluetooth hardware.
H Bluetooth Revealed (Prentice Hall, Inc., ISBN 0-13-090294-2) provides
background on several areas including the basic technology, the Bluetooth specification with information about the protocol stack, Bluetooth profiles, and the future of the technology.
H Bluetooth 1.1: Connect without Cables (Prentice Hall, Inc.,
ISBN 0-13-066106-6) provides less background about the technology and more in-depth information about the protocol stack and other areas. This book provides many diagrams.
NOTE. Check for regular BPA Series software updates at www.tektronix.com/ bpa_software.
BPA100 Series Bluetooth Protocol Analyzer User Manual
vii
Preface

Contacting Tektronix

Phone 1-800-833-9200*
Address
Web site www.tektronix.com
Sales support 1-800-833-9200, select option 1*
Service support 1-800-833-9200, select option 2*
Technical support Email: techsupport@tektronix.com
* This phone number is toll free in North America. After office hours, please
leave a voice mail message.
Outside North America, contact a Tektronix sales office or distr ibutor; see the Tektronix web site for a list of offices.
Tektronix, Inc. Department or name (if known) 14200 SW Karl Braun Drive P.O. Box 500 Beaverton, OR 97077 USA
1-800-833-9200, select option 3*
6:00 a.m. -- 5:00 p.m. Pacific time
viii
BPA100 Series Bluetooth Protocol Analyzer User Manual
Operating Basics

What’s New in Version 2.3

The Tektronix Bluetooth Protocol Analyzer Application Software V2.3 upgrade adds several important capabilities to the BPA100 Series analyzers, including support for three new protocol layers. The new features supported in V2.3 are listed below:
H Support for New Protocol Layers. BNEP (Bluetooth Network Encapsulation
Protocol), AT (Hayes modem command set), and HID (Human Interface Device) protocols are decoded with a separate tab for each in the application windows. Along with the Hayes modem command set, V2.3 also supports some Bluetooth-specific AT commands for headset profile.
H Hardware Trigger In. This connector senses a TTL-level high or low (menu
programmable) signal as a trigger from another Bluetooth Protocol Analyzer, logic analyzer, oscilloscope, or other test equipment.
H Hardware Trigger Out. This connector outputs a pulse or TTL-level high or
low (menu programmable) signal to trigger a Bluetooth Protocol Analyzer, logic analyzer, oscilloscope, or other test equipment. This function allows you to count clocks after a trigger event for logic analysis synchronization. You can set the Trigger Out to accommodate any specified pattern in a sequence. When the pattern is matched, the signal is sent.
H Hardware Clock Out. This connector provides a LV-TTL square-wave signal
synchronized to the local Bluetooth clock. The output frequency is 1.6 kHz (625 s) with a 50% duty cycle. This signal is always present when the Air Probe is powered on. To verify the signal, connect an oscilloscope.
H Synchronization Wizard. This feature allows users with a minimal knowl-
edge of Bluetooth synchronization to easily synchronize to a Piconet. The wizard consists of a series of screens that provide the appropriate graphics, selections, operations (like device discovery), and other information to guide you through the synchronization setup process.
H Presynchronization Drift Compensation. This feature improves your chances
of synchronizing to a device with a highly drifting clock. By receiving more than one FHS packet for a particular device over several seconds, the analyzer can calculate the relative drift of the device under test and use this information to improve the success of synchronization.
H Application Programming Interface (API). Using this Tektronix client
software, you can control the Bluetooth Protocol Analyzer from a remote PC.
H Sniff, Hold, and Test Mode. This feature allows the Bluetooth Protocol
Analyzer to follow the Bluetooth Sniff and Hold power modes. It also
BPA100 Series Bluetooth Protocol Analyzer User Manual
1- 1
What’s New in Version 2.3
provides the capability of supporting Test Mode as a slave Device Under Test (DUT), so you can use the Bluetooth Protocol Analyzer in conjunction with any Bluetooth tester.
H L2CAP Connection Properties. This feature lists the current L2CAP
connection properties for all L2CAP connections. It also allows you to change the L2CAP connection type.
H RFCOMM Server Channel Assignments. This feature lists the current
RFCOMM channel assignments for all RFCOMM connections. It also allows you to manually assign various protocols for “Unknown” RFCOMM connections.
H Export to *.wav file. This feature supports a post-acquisition process that
scans captured Independent or Piconet mode audio data and creates a .wav file. You can play back the file on a PC using standard Windows audio players.
H Advanced Search. This feature provides new search capabilities based on
individual columns and Boolean parameters. Users can mark all packets that match the search criteria.
H Trigger Loopback Test. You can use this diagnostic test to verify that the
Trigger In and Trigger Out functions are operating properly.
Graphical User Interface (GUI) Enhancements:
H Low Level Trigger (LLT) and Error Packet Generation (EPG) setup has
been redesigned to be more intuitive.
H Show/Hide Packets and Show/Hide Columns selections have moved to
the Packet View Window. User settings affecting these features are now saved along with the data file and will be active when you reopen the data file.
H Double--clicking on a column title adjusts the column width to the
maximum length of the text appearing within that column.
H If a log file contains audio data, an audio icon appears in the log toolbar.
Audio data can then be exported as a .wav file and played back using a Windows Media player or similar tool.
H The Synchronization Statusbar has changed. It now contains one
indicator and the corresponding synchronization status message, only.
1- 2
BPA100 Series Bluetooth Protocol Analyzer User Manual

Acquiring Piconet Packet Data

This section introduces you to the basic operation of the Bluetooth Protocol Analyzer. This section contains information on the following topics:
H Monitoring overview
H Operating modes
H Collecting data
H Understanding the application window
H Using the menu and toolbars
H Setting up an acquisition
H Setting up the data filter
H Setting up triggers
H Using the synchronization wizard
H Starting and ending a logging session

Overview

H Saving a log session
H Using the HCI Terminal application
Using the Bluetooth Protocol Analyzer you can connect to and monitor the activity of a Bluetooth Piconet and log data containing all of the baseband packets transmitted between the participating Bluetooth devices.
Following data collection, you can display the contents of the files you saved during acquisition and use the analysis features of the Bluetooth Protocol Analyzer to further interpret the data. Detailed information on data analysis is provided in the Analyzing Piconet Packet Data section, beginning on page 1--35.
Additionally, the Bluetooth Protocol Analyzer has features that allow you to generate baseband packets containing known errors for testing purposes. Information on error packet generation can be found on page 2--6.
BPA100 Series Bluetooth Protocol Analyzer User Manual
1- 3
Acquiring Piconet Packet Data
Operating Mode
You can operate the Bluetooth Protocol Analyzer in either Independent or Piconet mode.
Independent Mode. Configured as an independent unit, the B luetooth Protocol Analyzer does not interact directly in the piconet. Instead, after synchronizing to the net, it passively monitors and logs all baseband packets transmitted between the master and the slaves comprising the Piconet. By using the advanced triggering and filter features, you can identify the data you want to log, and then analyze it following the session.
Piconet Mode. Configured as a participant in a piconet, the Bluetooth Protocol Analyzer uses a full-protocol stack and participates as the master or a slave in the Piconet.
As a master, the Bluetooth Protocol Analyzer logs all baseband packets between itself and the piconet slave device(s). When set up as a slave, it logs all packets between itself and the Piconet master as well as between the master and all other slave devices.
For information on how to configure the analyzer for independent or Piconet mode operation, see Logging Mode on page 1--12.

Collecting Data

With the Bluetooth Protocol Analyzer you can connect to and create a log containing all the baseband packets transmitted between Bluetooth devices in a Piconet. Using the analyzer features you can do the following:
H Operate as a member of a Piconet, as a stand-alone (independent) unit, or
independent with data decryption.
H Select the master or slave to which the Bluetooth Protocol Analyzer is
synchronized.
H Set the duration over which the Protocol Analyzer tries to synchronize to a
Piconet master.
H Capture all baseband packets transmitted within a Bluetooth Piconet,
including packets that are normally not visible to the host such as retrans­mitted packets. View the status of each packet and estimate the clock and hop frequency.
H Select specified hopping patterns: Europe/USA, Japan, France, or Spain.
H Transmit and receive on a single user-defined frequency .
H Set a correlation value.
1- 4
BPA100 Series Bluetooth Protocol Analyzer User Manual
Acquiring Piconet Packet Data
H Turn data whitening on and off.
H Output data to a log file or view as a real-time display.
H Start or stop a logging session manually.
H Enable data decryption in Independent mode.
H Display the paging sequence in Independent mode.
H Filter packets during data acquisition (prior to logging), such as ID, NULL,
POLL, and Access Error packets.
H Generate known errors for testing and debugging.
NOTE. When you use the Bluetooth Protocol Analyzer with Bluetooth Neighbor­hood, you must use the Piconet mode (working as a participant in a Piconet). When you use the Bluetooth Protocol Analyzer in the Independent mode (working as a passive listener), you cannot use it with Bluetooth Neighborhood.
BPA100 Series Bluetooth Protocol Analyzer User Manual
1- 5
Acquiring Piconet Packet Data

Understanding the Data Acquisition Window

Figure 1--1 shows the data acquisition window of the Bluetooth Protocol Analyzer. and identifies each of the functional areas. This is the window that displays when you log a data file. Note that when the data acquisition window is the active window, many of the toolbar buttons are disabled.
Menu Bar Toolbar
Statusbar Data Window
Figure 1- 1: The Bluetooth Protocol Analyzer data acquisition window
Menu Bar
Toolbars
1- 6
Session Info Bar
The Menu Bar hosts the data acquisition and analysis functional menus. The menus and menu selections vary depending on the current analyzer function. Table 1--1 lists the menus that are available during data acquisition.
The toolbar contains shortcut buttons for the major analyzer functions. Most toolbar buttons have corresponding menu selections in the Menu Bar. The
BPA100 Series Bluetooth Protocol Analyzer User Manual
Acquiring Piconet Packet Data
number and function of the available buttons varies, depending on the type of window you have open. Table 1--1 identifies the acquisition toolbar buttons and their functions.
Statusbar
The Statusbar provides useful information on the status of the Bluetooth Protocol Analyzer. View this area for information on the current log session.
Table 1- 1: Acquisition window menus and toolbar buttons
Menu Selection Function
File > Open Use Windows Explorer to
browse and open a previously saved log session.
Open Current Log Open a Tektronix Bluetooth
.tbpa log file located at the path specified in the System > Op­tions > Output tab.
Close Closeafile.
Save Save changes to the open data
file.
Save As Open the Save As dialog box to
saveafiletoaspecifiedloca­tion.
Search Files Search for a file. See the Online Help.
Export Export data to a comma sepa-
rated file (.csv)
Properties Display properties of the active
data file.
Acquisition Summary Display acquisition details of the
active data file.
Send To Send the active file as email to
the mail profile you specify.
Print Print the entire or partial con-
tents of the active data file.
Toolbar button
Additional information
See page 1--35.
See page 1--33.
See page 1--33.
See the Online Help.
See the Online Help.
Print Preview Display a sample view of the the
data file selected for printing.
Print Setup Define the margins and other
printer properties for printing data files.
Print Window Print the active window using
the Page Setup dialog box.
1, 2, 3... <List of recent files> Reopen a recently opened file.
BPA100 Series Bluetooth Protocol Analyzer User Manual
1- 7
Acquiring Piconet Packet Data
Table 1- 1: Acquisition window menus and toolbar buttons (Cont.)
Toolbar
Menu Additional information
Exit Quit the Bluetooth Protocol
System > Start Session Begin an acquisition (logging)
Stop Session End the current acquisition
Pause/Resume Click to suspend the current
Test Mode Enable/Disable Test Mode
Trigger Loopback Test Verify that the Trigger In and
System Properties Display BPA100 Series software
Tools > Access executable files set up
Options Define packet-type display
Default Return the factory default set-
Acquisition > Setup Define parameters for the next
FunctionSelection
Analyzer application
session using the criteria de­fined in the Acquisition > Setup dialog box.
session.
acquisition session. Click again to resume the session.
activation by a remote Bluetooth device.
Trigger Out functions are operat­ing properly.
and firmware versions and copyright information.
with the Tools tab of the System Options dialog box.
colors; define disk location for storing acquisition log files; identify executable files to be run from the System > Tools menu.
tings for the following: acquisi­tion setup, data files, pre- post-­trigger, error packet generation.
acquisition session.
button
Available with BPA105 Air Probe only.
Available with BPA105 Air Probe only.
Also displays the Bluetooth device address of the connected Air Probe.
See the Online Help.
See the Online Help.
See page 1--11.
1- 8
Data Filter Specify the packets you do not
want to acquire during the next acquisition session in the Data Filter dialog box. These settings become the default settings.
Enable Data Filter Activate/deactivate the Data
Filter dialog box settings.
BPA100 Series Bluetooth Protocol Analyzer User Manual
See page 1--20.
Acquiring Piconet Packet Data
Table 1- 1: Acquisition window menus and toolbar buttons (Cont.)
Toolbar
Menu Additional information
FunctionSelection
button
Pre- Post Trigger Buffer Set the number of packets
collected before and after a trigger event in the Pre- Post Trigger Buffer dialog box.
Low Level Trigger Define trigger events for the
next acquisition based on low­level trigger characteristics, such as FLOW, ARQN, hop frequen­cy, payload headers, etc.
Enable Low Level Trigger Enable/disable settings defined
in the Low Level Trigger Setup dialog box.
High Level Trigger Define the trigger events for the
next acquisition base on high­level trigger characteristics, such as RFCOMM and SDP proto­cols.
Enable High Level Trigger Enable/disable settings defined
in the High Level Trigger Setup dialog box.
Error Packet Generation Set error packet generation
sequences for testing and debugging, such as FLOW, ARQN, hopping frequency, payload headers, etc.
Enable Error Packet Generation Enable/disable settings defined
in the Error Packet Generator dialog box.
Sync Wizard Use the Sync Wizard to define
participants and synchronize to a Piconet.
Unless enabled, the post-trigger buffer size is limited only by the disk space available on your PC. See page 1--31 for additional information.
See page 1--21.
See page 1--30.
See page 2--6.
BPA100 Series Bluetooth Protocol Analyzer User Manual
1- 9
Acquiring Piconet Packet Data
Table 1- 1: Acquisition window menus and toolbar buttons (Cont.)
Toolbar
Menu Additional information
View > Toolbar Enable/disable the toolbar. See Figure 1--1 on page 1--6.
Statusbar Enable/disable the statusbar.
Sync Bar Enable/disable the synchroniza-
Session Info Bar Enable/disable the session
Show/Hide Packets Define which packets you want
FunctionSelection
tion information bar.
information bar.
to display in the List views.
button
Contains synchronization status indicator. See page 1--13.
Displays session time informa­tion and packet counts. See page 1--11.
See the Online Help.
Show/Hide Columns Define which columns you want
to display in the List views.
Format Columns Define the data format of the
displayed columns: decimal, hex, binary, ASCII.
Help > Help Topics Display the online help main
menu.
Help on Window Display the help topic for the
active window.
What’s This? Point to an element in the
display window and obtain a help topic.
Technical Support Access the Tektronix Bluetooth
Protocol Analyzer technical support Web site.
Customer Feedback Obtain a request for feedback
on the product support Web site.
About Tektronix Bluetooth Protocol Analyzer
Display Bluetooth Protocol Analyzer software version and copyright.
See the Online Help.
See the Online Help.
Download drivers and software updates. Obtain product-related technical information.
Send ideas for product improve­ment.
1- 10
BPA100 Series Bluetooth Protocol Analyzer User Manual
Acquiring Piconet Packet Data
Data Window
The data window displays information on the traffic you are currently logging (acquiring). Data windows are either acquisition windows (active during data collection) or analysis windows (active when you display the contents of a saved acquisition file). See Analyzing Piconet Packet Data beginning on page 1 --35 for more information on analysis windows.
Session Info Bar. At the bottom of the acquisition data window, the Session Info Bar displays the information listed below. See Figure 1--1 on page 1--6 for the location of the session info bar.
H Start time of an in-process acquisition session
H End time of the most recently completed acquisition session
H Number of baseband packets logged
H Logsizeinbytes
H Number of bytes received

Setting Up an Acquisition

Select Acquisition > Setup or click the shortcut button to display the Acquisition Setup dialog box. See Figure 1--2. Use this dialog box to configure the settings for a new logging session.
Figure 1- 2: Acquisition Setup dialog box
BPA100 Series Bluetooth Protocol Analyzer User Manual
1- 11
Acquiring Piconet Packet Data
Logging Mode
Before you start a new logging session, decide whether you will operate the Bluetooth Protocol Analyzer as an active member of a Piconet (either as a master or as a slave) or as a stand-alone unit that nonintrusively monitors data flowing across the Piconet.
Piconet Mode. Use this mode with the Bluetooth Neighborhood or HCI Terminal to set up the Bluetooth Protocol Analyzer as an active participant in the Piconet. When you start a logging session, the analyzer logs all baseband packets sent from and received by your computer, whether the Bluetooth Protocol Analyzer is acting as a slave or a master.
NOTE. You cannot operate the HCI Terminal application and Bluetooth Neighborhood simultaneously.
Independent Mode. Use this mode to set up the Bluetooth Protocol Analyzer as a stand-alone unit. When you select this mode, the analyzer displays the Sync Bar near the bottom of the acquisition window. See page 1--13 for additional information on the Sync Bar.
Select a synchronization mode:
H Sync to Piconet using master inquiry. In this mode, synchronization is
obtained by performing an inquiry and using the clock information returned by the master to set the clock of the Bluetooth Protocol Analyzer. You must identify a master in the Select Master dialog box. See Select Master or Slave on page 1--14.
In some Bluetooth devices, the clock drifts away when the device is not in connect mode; this synchronization mode can be troublesome if you want to monitor negotiations during the connect phase. The problem occurs because there are often several seconds of delay from the time the Bluetooth Protocol Analyzer obtains the master clock information until the master actually connects to the slave. Likewise, if the inquiry scan mode on the Bluetooth device is not implemented or is disabled during the connection, this mode cannot be used for synchronization. See Resync on page 1--19.
H Sync to Piconet using a fake connection response. This mode can be used
only during the connection phase, when the Piconet master connects to a new slave. The analyzer operates as if it were the slave unit selected in the Select Slave dialog box (see Figure 1--4 on page 1--14) and obtains the master clock information by initiating a new connection as if it were that slave. Immediately after the clock information is retrieved, the protocol analyzer stops transmitting, and the piconet master continues the connection attempt with the true slave. You must identify a slave in the Select Slave dialog box. See Select Master or Slave on page 1--14.
1- 12
BPA100 Series Bluetooth Protocol Analyzer User Manual
Acquiring Piconet Packet Data
NOTE. The HCI Terminal application provides user control of the Bluetooth Protocol Analyzer in piconet member mode. See the HCI Terminal topic on page 1--33.
H Sync to Piconet using slave inquiry. This mode can only be used during the
connection phase. The Bluetooth Protocol Analyzer listens for the clock information from the master (sent in the connection phase) to the new Piconet slave, and does not interfere with the Piconet in any way. In order to find the clock information on the right frequency, it is necessary to capture the slave clock. This is done by performing an inquiry to the slave. You must identify a slave in the Select Slave dialog box. See Select Master or Slave on page 1--14.
Sync Indication Bar. To activate the Sync Bar, select View > Sync Bar. When you use Independent mode as the logging mode, the Sync Bar appears at the bottom of the acquisition window. See Figure 1--3.
Figure 1- 3: Acquisition window Sync Bar
The Sync Bar contains the following indicators to verify the status of the analyzer connection to the Piconet:
H Gray. Indicates that the analyzer is in an idle state.
H Yellow. Indicates that the analyzer is waiting for an FHS packet from the
master or slave that is needed for synchronization. This indicator is accompanied by an explanatory message.
H Flashing Yellow. Indicates that the analyzer is synchronized to the master but
has not yet recorded any traffic. This indicator is accompanied by an explanatory message.
H Green. Indicates the analyzer is synchronized and acquiring data.
H Red. Indicates that a time-out occurred while waiting for traffic. For more
information on time-outs, see Acquisition Timeout on page 1--15.
BPA100 Series Bluetooth Protocol Analyzer User Manual
1- 13
Acquiring Piconet Packet Data
Select Master or Slave. Click the box (see Figure 1--2 on page 1--11) to open a Master or Slave dialog box and set up the options to discover and connect to a Bluetooth device within range. See Figure 1--4.
H Inquiry Time-out. Select how long the Bluetooth Protocol Analyzer performs
the inquiry process. The default time is 12 seconds. However, you can set the time from 2 to 60 seconds.
H Inquiry Access Code. Enter an inquiry access code (IAC); there are 64 IACs.
The default is the General IAC (GIAC), which is 0x9E8B33. The remaining 63 access codes are Dedicated IACs (DIACs). You can set any of the 64 IACs. Although the GIAC is normally used, you can use a DIAC in certain instances.
For example, a group of users might agree to set their devices to a specific DIAC to make their devices easier to discover in an environment with many Bluetooth devices.
H Discover. Click this button to carry out device discovery and display a list of
all active Bluetooth devices within range.
H Select. Click the device name you want to synchronize to; then click Select
and close the Select Master or Select Slave dialog box.
shortcut button in the Acquisition dialog
Figure 1- 4: Select Master and Select Slave dialog boxes
1- 14
BPA100 Series Bluetooth Protocol Analyzer User Manual
Acquiring Piconet Packet Data
Acquisition Time-out. The Bluetooth Protocol Analyzer invokes a synchroniza­tion time-out under the following conditions.
H Acquisition Setup Dialog Box Timeout. Click Acquisition > Setup.Inthe
Timeout (sec) field specify a number in the drop-down list box to limit the amount of time the analyzer will wait for traffic to start after synchronizing to a Piconet. If the analyzer is synchronized to a Piconet, and no traffic exists on the Piconet for too long a time period, clock drift between the analyzer and the master device may cause loss of synchronization.
H Loss of Piconet Synchronization Time-out. The Bluetooth Protocol Analyzer
will also time out if the analyzer cannot synchronize within a 41 second period. In this case, user intervention may be required. For example, you may have to move the undiscovered device closer to the analyzer or reorient the Bluetooth Protocol Analyzer Air Probe antenna, and then try again. In some cases, you may have to remove another source of radio interference.
NOTE. When you operate the Bluetooth Protocol Analyzer and Bluetooth Neighborhood together to participant in a Piconet, you must use Piconet mode.
When you operate the Bluetooth Protocol Analyzer in Independent Mode working as a passive listener, you cannot use Bluetooth Neighborhood.
BPA100 Series Bluetooth Protocol Analyzer User Manual
1- 15
Acquiring Piconet Packet Data
Enabling Decryption
Use the following procedure to set up the Bluetooth Protocol Analyzer to decrypt encrypted data transmitted between Piconet devices. See Understanding Decryption, on page 2--18, for additional information on the decryption process.
NOTE. This feature operates in Independent mode only.
1. In the menu bar, select Acquisition > Setup.
2. In the Acquisition Setup dialog box, check the Enable Decryption option
box to enable the feature.
3. Click the Decryption button to display the Decryption dialog box. See Figure 1--5.
1- 16
Figure 1- 5: Decryption dialog box
H Authentication. Use Authentication to decrypt encrypted data transactions
from bonded (paired) devices where a link key has been previously calculated. You must enter the Link Key, a 128-bit hexadecimal number, along with the master and slave Bluetooth device addresses of the devices for which decryption is desired.
H Pairing. Use Pairing for unbonded devices when the acquisition will record
the pairing process using PIN codes. In this case, you must enter the PIN code (optionally using an ASCII entry) used between the master and slave for authentication.
BPA100 Series Bluetooth Protocol Analyzer User Manual
Loading...
+ 86 hidden pages