2403 Walsh Avenue, Santa Clara, CA 95051-1302 Tel: +1/408.727.6600 Fax: +1/408.727.6622 CATC BTTracer™ Bluetooth™ Protocol Analyzer User’s Manual For Software Version 2.20 Manual Version 1.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Document Disclaimer The information contained in this document has been carefully checked and is believed to be reliable. However, no responsibility can be assumed for inaccuracies that may not have been detected. CATC reserves the right to revise the information presented in this document without notice or penalty.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Important Notice: To comply with FCC RF exposure requirements (sections 1.1307 and 1.310 of the Rules) only the antenna supplied by CATC must be used for this device. The antenna must be located at least 20 cm away from all persons. FCC Testing applies to FCC ID: KH7BT004APA-X. EU Conference Statement This equipment complies with the R&TT Directive 1999/5/EC.
CATC BTTracer Protocol Analyzer User’s Manual 4 SW Version 2.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 TABLE OF CONTENTS Chapter 1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Bluetooth™ Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 General Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Automation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 License Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Updating the Software License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Chapter 4 Software Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 The Main Display Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 Toolbar . . . . . . . . . . . . . .
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Follow Anonymity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 Advanced ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 Recording Options - Inquiry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 Recording Options - HCI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91 HCI Trace . .
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Viewing Packets in LMP and L2CAP Messages . . . . . . . . . . . . . . . . . . . . . . . . 134 Types of LMP and L2CAP Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134 Viewing L2CAP Channel Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 Viewing Protocol Messages and Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . 136 Viewing L2CAP Messages in Protocol Messages . . . . .
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Re-applying Encryption Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 Chapter 12 How to Contact CATC. . . . . . . . . . . . . . . . . . . . . . . 177 Chapter 13 Warranty and License . . . . . . . . . . . . . . . . . . . . . . . 177 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CATC BTTracer Protocol Analyzer User’s Manual viii SW Version 2.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 1. Overview The CATC BTTracer™ Protocol Analyzer is the top-of-the-line member of CATC's industry-leading line of high performance, Bluetooth protocol analyzers. Preceded by CATC’s Merlin™ and Merlin Mobile Analyzers, BTTracer has been designed using the same modular architecture that made its predecessors highly successful in the serial bus protocol analyzer market worldwide. 1.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 1.2 General Description The BTTracer Protocol Analyzer is designed as a stand-alone unit that can be easily configured and controlled by a portable or desktop PC connected via its USB port. BTTracer provides customers with the familiar ‘CATC Trace’ user interface that is the de facto industry standard for documenting the performance of high-speed serial protocols.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Sample Bluetooth Piconet with BTTracer Protocol Analyzer BTTracer provides on-the-fly detection of and triggering on such events as Packet Headers and Errors. Whether recording manually or with a specified trigger condition, BTTracer continuously records the bus data in a wrap-around fashion until manually stopped or until the Trigger Event is detected and a specified post-Trigger amount of bus data is recorded.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 user-defined set of trigger events. The unit can also be triggered by an externally supplied signal. An external DB-25 connector provides a path for externally supplied data or timing data to be recorded along with bus traffic. This DB-25 connector also provides a path for BTTracer to transmit externally two control, timing, or recovered signals for purposes of probing and use by other circuitry.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 To capture the data, the HCI Probe can be used respective 'Host to Controller' and 'Controller to Host' lines. When the recording of the IUT's HCI is enabled and the application starts a recording, the serial data is captured as incoming serial data. For this, up to two COM ports should be configured for each IUT. 1.5 Features General • Flexible design - reconfigurable hardware for future enhancements.
CATC • • BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Trace viewer software support for Microsoft Windows versions 98SE and later. Recording memory of 512 MB - enough to record thirty five minutes of high volume traffic and more than two days of low volume traffic. Display Options • Analyzes and displays a transaction-level view of piconet traffic with accurate time-stamps and frequency hop information.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 1.6 Specifications Package Dimensions: UPAS 2500H 12.2 x 12.2 x 3.5 inches (31.1 x 31.1 x 8.9 cm) Connectors: AC power connection external clock input (EXT CLK, BNC) host connection (USB, type ‘B’) data connector (Data In/Out, 25-pin DB) Weight: UPAS: 9.5 lbs. (4.
CATC BTTracer Protocol Analyzer User’s Manual 8 SW Version 2.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 2. Installation The BTTracer Protocol Analyzer components and software are easily installed and quickly ready to run on most Windows-based personal computer systems. You can begin making Bluetooth recordings after following these initial steps. 2.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 B Red Status indicator LED for UPAS (lights during initialization/power up of UPAS base unit. Blinks if a self-test fails). C Green REC (recording) LED (lights when the unit is recording). D Orange TRG (triggered) LED (lights when the unit triggers on an event). E Green SYNC (Synchronize) LED (Flashing indicates that the analyzer is tracking the defined slave or master device.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Wide Range AC Connector Module The power module is composed of: — Power on/off switch — Power socket — Enclosed 5x20 mm 2.0A 250 V fast acting glass fuse Warning For continued protection against fire, replace fuse only with the type and rating specified above. 2.4 Setting Up the Analyzer A UPAS can support up to two BTTracer probes. These modules will come factory-installed in the UPAS.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Once BTTracer has been recognized as a USB device, install the BTTracer software on the PC administering the analyzer. Step 1 Insert the BTTracer CD into the CD ROM drive of the PC that will be administering the Analyzer. Step 2 Follow Windows on-screen Plug-and-Play instructions for the automatic installation of the BTTracer Analyzer as a USB device on your analyzing PC (the required USB files are included on the BTTracer CD.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 To open a trace, Step 1 Select File > Open from the menu. A dialog box opens. Step 2 Select a file from the dialog box and click Open. A trace opens in the main viewing area. When traffic has been recorded, it will display here. Note The software may be used with or without the analyzer box.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 2.6 Recording Bluetooth 1.2 and 1.1 Traffic By default, BTTracer is configured to record in a mode compliant with the Bluetooth 1.1 specification. This mode is required if you are using BTTrainer to generate traffic (BTTrainer is compliant only with the Bluetooth 1.1 specification). To record traffic in a mode compliant with the Bluetooth 1.2 specification, perform the following steps.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 The menu opens and displays a checkbox next to the current mode. 2.7 Your First Bluetooth Recording After installing and launching the software, you can test BTTracer by creating an inquiry recording. In this test, BTTracer will issue a General Inquiry that asks local devices to identify themselves. BTTracer then records the responses.
CATC BTTracer Protocol Analyzer User’s Manual Step 3 SW Version 2.20 From the menu, select Setup > Recording Options. The Recording Options dialog opens with the Inquiry page displaying. Step 4 If desired, make any changes to the options, then click OK. Step 5 Click the button (i.e. not the down-arrow.) BTTracer starts to record the Bluetooth traffic immediately using the settings from the Piconet page in the Recording Options dialog.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 When the recording session is finished, the bus traffic is saved to the hard drive as a file named data.tfb or whatever name you assign as the default filename. While the file is being saved, you should see a brown progress bar at the bottom of the screen. When the bar turns white, it indicates that the data has been saved to disk. Step 6 To save a current recording for future reference, Select Save As under File on the Menu Bar.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 2.8 Installing the HCI Probe If you are planning to record HCI traffic from an Implementation Under Test (IUT), you will need to connect the provided HCI probe to the IUT. The HCI Probe is used for connecting the analyzer application running on the host machine to a single IUT. If more IUTs are to be monitored (up to three) additional HCI Probes should be used.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 • RS-232/Probe - Should be connected to the HCITrace Probe Cable or to the TTL to RS232 converter (depending whether the signal voltage in the IUT is TTL or RS-232). • COM A - Should be connected to one of the serial inputs of the 2-port RS232 to USB converter. • COM B - Should be connected to one of the other serial input of the 2-port RS232 to USB converter.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 HCITrace RS-232 Cable [b] to ‘Connector A’ in the 2-port RS232 to USB converter [d]. Step 4 Connect the connector marked with ‘COM B’ in the HCITrace RS-232 Cable [b] to ‘Connector B’ in the 2-port RS232 to USB converter [d]. Step 5 Connect the USB cable to the USB connector of the 2-port RS232 to USB converter [e].
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 RS232 to USB converter [d]. Step 3 Connect the connector marked with ‘COM B’ in the HCITrace RS-232 Cable [c] to ‘Connector B’ in the 2-port RS232 to USB converter [d]. Step 4 Connect the USB cable [not shown] to the USB connector of the 2-port RS232 to USB converter [d]. 2-port RS232 to USB converter The 2-port RS232 to USB converter [d] allows the user to connect two serial connectors to the host machine via a single USB connection.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 2.9 External Interface Breakout Board The External Interface Breakout Board is an accessory that allows standard, LV TTL signals to be channeled into the analyzer for triggering or out of the analyzer for use by an oscilloscope, logic analyzer or other device. Six ground pins and one 5-volt pin are provided. Drive strength for all outputs is about 30mA high (@2V) and 60 mA low (@0.5V). Inputs can handle 0 to 5.5V.
CATC BTTracer Protocol Analyzer User’s Manual Pin Note Signal Name Signal Description 16 TRG OUT Trigger Out 17 TRG IN 0 Trigger In 0 18 DATA 7 Data 7 19 DATA 5 Data 5 20 GND Ground 21 DATA 2 Data 2 22 DATA 0 Data 0 23 GND Ground 24 RSV Reserved 25 RSV Reserved SW Version 2.20 (*) Pins 4 and 17 have the same function: they allow external signals to be used to cause triggering or recording. Pins 3 and 16 are used to transmit output signals.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 and the bottom row is connected to +5V. The remaining holes are not connected. Use the rework area to insert custom components and wire-wrap their respective signal, power, and ground pins. External Recordable Signals Breakout Board Data 0-1: These pins let you define an 2 bit Data Pattern that can be recorded in a trace file.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 3. Updates BusEngine and Firmware updates often need to be performed when you update the BTTracer software. These updates can be performed automatically or manually. Both processes are described. 3.1 Update Files Update files are installed with the BTTracer software during the installation procedure and reside in the local directory of the analyzer application. During the update process, the files are taken from this location.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 showing your current versions and indicating what versions you need to install. Step 4 Click Yes. The Analyzer Setup window appears. Step 5 Click Update. When the update has finished, a message such as the following appears and tells you that the update is complete. The example below follows a BusEngine update.
CATC BTTracer Protocol Analyzer User’s Manual Step 6 SW Version 2.20 To complete the update, power cycle the analyzer (turn the unit off then back on). If you are running Windows 2000, the Analyzer will automatically reboot, and the following message will appear: Step 7 Click OK. In this instance, you do not need to power cycle the Analyzer (turn off then back on). Manual Updates If you prefer, you can manually update the Firmware, BT firmware and/or BusEngine through the 'Analyzer Setup' dialog.
CATC BTTracer Protocol Analyzer User’s Manual Step 2 SW Version 2.20 Select from the menu: Setup > Analyzer. The Analyzer Setup dialog box opens. Step 3 Select the one of the entity that you want to update from the list. Step 4 Click the Update button. The familiar Open File dialog box will open allowing you to select the proper file, as shown below: Step 5 Select the file to be updated, and select the Open button. At this time, the application would start the update process.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 you may need to cycle the analyzer's power to cause the program to take effect, or you may need to unplug and then reconnect the USB cable between the analyzer and the computer to cause the new firmware upgrade to take effect. 3.3 Software, Firmware, and BusEngine Versions The Readme.html file on the installation CD and on the installed directory on your hard drive. This file gives last-minute updates about the current release.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 3.4 Software Updates When a new software release is available, it is posted on the Support page of the CATC website at www.catc.com/support.html. The software is also available on CD from CATC. Updating from CD-ROM To update the software from CD-ROM, follow these steps: Step 1 Load the CD-ROM into the CD-ROM drive Step 2 Open Windows Explorer and double-click on autorun.exe. An install screen opens.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 3.5 License Information Licensing information for BTTracer can be viewed by selecting Display Information from the Help menu. The License window provides maintenance expiration and features data for BTTracer. Updating the Software License A License key is necessary to enable software maintenance. A license is granted with the purchase of an analyzer. Thereafter, you must renew your license if you wish to continue receiving support.
CATC BTTracer Protocol Analyzer User’s Manual 32 SW Version 2.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 4. Software Overview 4.1 The Main Display Windows While some of the analyzer’s Main Display window options are familiar, many contain options specific to the analyzer program. Table 1: Main Display Pull-Down Windows Menu Function File Open… Opens a file Close Closes the current file Save As… Saves all or a specified range of packets from the current file with a specified name Re-apply Encryption Settings ...
CATC BTTracer Protocol Analyzer User’s Manual Menu Connectors ... SW Version 2.20 Function Opens a dialog box for the output connectors on the back of the UPAS. There are two options: Default Configuration - Causes the analyzer to output a low voltage output signal for use by another device such as an oscilloscope. See “External Input Signals” on page 103 for further explanation. Output Radio Data - Causes the analyzer to output radio signals through External Output connectors.
CATC BTTracer Protocol Analyzer User’s Manual Menu SW Version 2.20 Function Timing Calculation Starts the calculator dialog for calculating various timing and bandwidth parameters in the recording file. Traffic Summary Details the number and type of packets were transferred during the recording, as well as message-level statistics. Search Go to trigger Positions the display to show the first packet that follows the trigger event. Go to Packet/Message/ Protocol ...
CATC BTTracer Protocol Analyzer User’s Manual Menu SW Version 2.20 Function Window New Window Switches display of the Tool Bar on or off. Cascade Displays all open windows in an overlapping arrangement. Tile Arranges multiple trace windows as a series of strips across the main display area or as a series of side-by-side tiles. Arrange Icons Arranges minimized windows at the bottom of the display. Windows Displays a list of open windows.
CATC BTTracer Protocol Analyzer User’s Manual Setup Record Options - presents options for setting up a recording. Setup Display Options - presents options for formatting the display. Start Recording - starts a recording. The down arrow gives you options for starting different types of recordings: recording piconet, inquiry recording, BTTrainer recording, or IUT:HCI recording. Stop Recording Start Recording Wizard - Opens an easy-to-use wizard for setting up and executing a recording.
CATC BTTracer Protocol Analyzer User’s Manual "Frequently Used" Toolbar Zoom In Zoom Out Wrap Show/Hide Channel 1 Traffic Show/Hide Channel 2 Traffic Show/Hide Duplicated Traffic Show/Hide Frequency Hops Show/Hide Nulls & Polls Show/Hide ID Packets Show/Hide Voice (SCO) Packets Show/Hide devices that were specified in the Display Options dialog box Show/Hide Unassociated Traffic Show/Hide HCI Traffic Complex Find Find Next 38 SW Version 2.
CATC BTTracer Protocol Analyzer User’s Manual Analysis Toolbar Display device list File Information Report Error Summary Timing Calculations Traffic Summary Display Bus Utilization graph Display Real-Time Statistics View Level Toolbar View Packet Level (Baseband) View HCI Traffic View/Hide LMP Message Level View/Hide L2CAP Message Level View/Hide SDP Message Protocol Level View/Hide SDP Transaction Protocol Level View/Hide TCS Protocol Level View/Hide RFCOMM Protocol Level 39 SW Version
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 View/Hide OBEX Protocol Level View/Hide OBEX Protocol Transaction Communications Level View AT Commands Protocol Level View/Hide HDLC Protocol View/Hide PPP View/Hide HCRP View/Hide AVCTP View/Hide AVDTP View/Hide BNEP Protocol View HID Protocol Layer View IP Protocol Layer View TCP Protocol Layer View UDP Protocol Layer View Profiles Toolbar Profile buttons decode the protocols associated with a particular profile.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Note: This toolbar is hidden on initial activation of the application. To display this toolbar, select View > Toolbars > Profiles from the menu. Decodes protocols for the GAP profile. Decodes protocols for the SDAP profile. Decodes protocols for the CIP profile. Decodes protocols for the GAVDP profile. Decodes protocols for the CTP profile. Decodes protocols for the INT profile. Decodes protocols for the SPP profile.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Decodes protocols for the A2DP profile. Decodes protocols for the BIP profile. Decodes protocols for the BIP profile. 4.3 Status Bar The Status Bar is located at the bottom of the main display window. Depending on the current activity, the bar can be divided into as many as four segments. The figure below demonstrates the various displays in the status bar.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 4 Analyzer is recording (only channel 1 is present). 5 Analyzer is synchronized to a piconet with the master device that has BD_Address 0083716355E. 6 Analyzer is connected to the host machine, but is not performing a thing. 7 Analyzer is connected to the host machine and is powering up. 8 Analyzer is recording on both channel 1 and channel 2.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 • When you click Stop before or after a Trigger Event, the Progress Bar adjusts accordingly to begin uploading the most recently recorded data. The Progress Bar fills with color in proportion to the specified size and actual rate at which the hardware is writing and reading the recording memory. However, the Progress Indicator is normalized to fill the space within the Status Bar.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Inquiring... - The system is performing an Bluetooth Inquiry Syncing to [XXX]... -- The system is attempting to synchronize to a piconet where the device with BD_Address XXX is the master. Synced to [XXX] - The system is synchronized to a piconet where the device with BD_Address XXX is the master.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 4.4 Tool Tips Throughout the application, tool tips provide useful information. To display a tool tip, position the mouse pointer over an item. The tool tip displays in a short moment if present. Tool tips can also be found over the Tool Bar and in areas of the packet view screen. 4.5 BTTracer Analyzer Keyboard Shortcuts Several frequently-used operations are bound to keyboard shortcuts.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 5. Recording Wizard Recording Wizard is an interactive utility that presents a series of user-friendly dialog boxes for setting up a recording session. Recording Wizard serves as an alternative method of configuring the Recording Options dialog box. When you are finished using the Wizard, you can view your settings in the Recording Options window.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 • Click Next to see the options for the three types of recordings that the Recording Wizard can make. The Wizard advances to the next screen which presents three options: • I want to establish a new piconet and have BTTracer record traffic on that piconet. This option causes BTTracer to perform an Inquiry so it can discover local devices and then establish a new piconet and record the piconet traffic.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 The following steps shows you how to configure BTTracer to record a new piconet. Step 1 From the screen shown in the previous screenshot, select the first option: I want to establish a new piconet and have BTTracer record traffic on that piconet, then press Next. The following screen displays. Step 2 Select Perform Inquiry Now, then press Next.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 The following screen will display. You will see two options: • I want to search for all Bluetooth devices within range This option will cause BTTracer to search for all Bluetooth devices that are in range and ready to transmit and receive data (i.e.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 within range, then press Next. The following screen will display. You will see two options: Step 4 In the text box, enter the length of time you want BTTracer to search for nearby devices. The default value is 11. If you do not sure what time value to enter, use the default value. Step 5 Press Next. Before the Inquiry, BTTracer tests the hardware connection. In the case of failure, the following screen will display.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 If BTTracer passes the hardware test, it will search for devices.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 If devices found, the Recording Wizard will display the following screen: Step 6 Press Next. The following window will display: Step 7 Select from the drop-down menu the hexadecimal address for your Master device. If you do not see your device’s address, you may type it into the text box yourself.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 The following window will display: Step 8 Select from the drop-down menu the hexadecimal address for your slave device into the box labeled Piconet Slave Address. If you do not see your slave’s address, you can type it into the box. Step 9 Press Next. The following screen will display. This screen displays the settings you selected.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 The Advanced button on the right will open the Recording Options dialog box shown below. This screen will show the settings you selected through the Recording Wizard have been applied to the Recording Options dialog. Step 10 Press Next to advance the Recording Wizard to the next screen. The following screen displays: BTTracer pages the Master and if specified in Step 8, the Slave devices.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 If BTTracer is unable to complete its pages, the following screen will display: If BTTracer is able to complete its pages, it will enter into a synchronizing state and then wait for you to create the piconet.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Once you have created the piconet, BTTracer will synchronize to the piconet and begin recording. During the recording, BTTracer will display the following screen: At the completion of the recording, BTTracer will display the following screen: You can repeat the recording by pressing the Repeat button. Step 11 To close the wizard, press the Close button.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 The wizard will close and your trace will display. 5.2 Recording an Existing Piconet Using Recording Wizard to record an existing piconet is similar to recording a new piconet. The main difference is that you will be asked if your Master device can support multiple slave devices and whether it can respond to pages once it has created a piconet with another device. Step 1 To start the Recording Wizard, press Recording Wizard from the menu.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 The Recording Wizard introductory page will open: Step 2 Press Next to advance to the next screen. You will see three choices: Step 3 Select the second option: I want BTTracer to record traffic on a piconet that has already been established. Step 4 Press Next.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 You will see two choices: Step 5 Select Perform Inquiry Now. You will see two choices: Step 6 Select the first option: I want BTTracer to search for all Bluetooth devices within range.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 If you want to limit the inquiry to a class of devices, select the second option and enter the hexadecimal value for the device class in the text box. Step 7 Press Next. The following screen will appear: Step 8 If you want to change the search duration, type in a new value into the text box. Otherwise, use the default value (20 seconds), then press Next.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 If BTTracer cannot detect other devices, the following message will display: If BTTracer passes the hardware test, it will then goes onto conduct a General Inquiry to locate local Bluetooth devices.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 If BTTracer finds Bluetooth devices, it will display the following message: Check the Device List to see if BTTracer found all of the devices in your piconet. If you feel that the list is incomplete, you can close this window and press the button marked Repeat. This will cause BTTracer to repeat the General Inquiry and recollect information on local Bluetooth devices. Step 9 Press Next to advance to the next screen.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Step 10 Select or type in the Master device’s address into the box next to the label Piconet Master Address. Step 11 Press Next. The following screen will display. This screen asks you which of the following two options apply to your Master device. For some devices, both options will apply. You can select either or both options.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 If you selected only the second option in Step 12 (=’Passive Sync & Record’), the following screen will display. This screen asks you for the address of the Page Target device -- which in this case is BTTracer. Since the devices in your piconet are not able to respond to inquiries, BTTracer will not be able to page the devices and join the piconet.
CATC BTTracer Protocol Analyzer User’s Manual Step 14 SW Version 2.20 Press Next BTTracer will then display your current settings. The Advanced button will open the Recording Options dialog box shown on page 55 and described in detail in Chapter 7. Step 15 Press Next to begin the recording. If the BTTracer hardware is not ready or connected or is in the process of booting up, the following information message box will display: Step 16 If the above information box opened, press OK to close it.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 The following dialog box will display: Step 17 Press Retry or Back to re-attempt the process. If the hardware failure described above do not occur, BTTracer will conduct an inquiry. The screen will show that BTTracer is going to attempt a recording in either ’Passive Sync & Record’ mode as shown below or in ’Sync & Record’ mode depending on the options you selected in Step 15.
CATC BTTracer Protocol Analyzer User’s Manual Step 18 SW Version 2.20 If you are recording in ’Passive Sync & Record’ mode, you will need to direct your Master device to attempt a connection to BTTracer. This will provide BTTracer with the information it needs to record the piconet. Once BTTracer has the information it needs, it will begin recording.
CATC BTTracer Protocol Analyzer User’s Manual Step 2 SW Version 2.20 Press Next to advance to the Recording Type screen. The following screen will display: Step 3 Select the third option: I am using Bluetooth Test Mode and want BTTracer to record traffic on my test piconet. Step 4 Press Next.
CATC BTTracer Protocol Analyzer User’s Manual Step 5 SW Version 2.20 Select the option Reduced-hopping mode, then press Next. The following screen will display: Step 6 Select the address for your piconet’s Master device from the drop-down menu. If you prefer, you can type in the address into the box. Step 7 Press Next. The following screen will display.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 The Advanced button will open the Recording Options dialog box. See Chapter 7 for details on the Recording Options dialog box. Step 8 Press Next to begin the recording. The following screen will display: Step 9 When the recording finishes, the following screen will display. You can repeat the recording by pressing the Repeat button. Step 10 To close the wizard, press Finish.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 5.4 Recording in Single Frequency Mode Step 1 In the Recording Type window, select the third radio button and click Next. Step 2 In the Frequency Hopping Mode, window select the Fixed-Frequency Mode radio button, enter the appropriate values in the text boxes, and click Next.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 your Master Device. Step 4 Press Next. Step 5 Press Next.
CATC BTTracer Protocol Analyzer User’s Manual device and begins recording. 74 SW Version 2.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 6. Recording Options While the Recording Wizard provides a "walk through" process for setting the recording options, you can get a more detailed view and set more parameters through the "Recording Options" dialog box. The Recording Options dialog box presents all of the settings needed to make a recording.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 'inquiry' page of the Recording Options. The recorded traffic would consist the transmitted packets as well as the responses received from Bluetooth devices in the area. As in the case of Piconet recording mode, when BTTrainer is active this mode is disabled as the system is monitoring the BTTrainer's activity. BTTrainer mode Configures BTTracer to record BTTrainer traffic. BTTracer is "forced" into this mode when the BTTrainer is activated.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 You see the Recording Options window. By default, the Piconet options page displays: You will need to set options for each of the Recording Options pages. Generally, it is best to begin with the General and Piconet pages where you can set the type of recording, and then move on to the Events and Actions pages where you can set triggering events. 6.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 the Stop button. Recording begins by clicking on the Tool Bar and ends when either the selected buffer size is filled or you press the Stop button. Manual Trigger A Manual Trigger recording is a one that is manually begun and ended. Recording is begun by pressing on the Tool Bar. Recording continues in a circular manner within the limits set by the buffer size.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Note The scale is not linear and affords more granularity in the smaller buffer sizes. Trigger Position The Trigger Position slide bar sets the amount of post-trigger recording that BTTracer will perform. It also allows adjustment of the location of the trigger within the defined buffer. You can adjust the Triggering Position between 1 and 99% post-Trigger.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 will be greyed out unless you have a second BTTracer probe installed in the right UPAS slot and the system is set to BT1.1 mode. Channel 1 and Channel 2 Each Channel represents a BTTracer probe. The checkboxes enable/disable the piconet options listed below them. For UPASs with only the left side BTTracer probe, the Channel 2 options will be greyed out and the checkbox for Channel 1 should be checked.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Frequency Hopping Stay with Basic Hopping - Configures the probe to use the Basic Hopping sequence as defined by the Bluetooth 1.1 specification. Follow AFH - Configures the probe to use the Adaptive Frequency Hopping sequence as defined by the Bluetooth 1.2 specification. Set... - Opens a dialog box for selecting the channels you would like BTTracer to use. LT_ADDr to Follow: Select devices to be followed.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Sequence The Hop Sequence menu presents the following three options: • 79 Hops Standard - This is the option used for most recordings. • Reduced Hop - Restricts BTTracer to five hop frequencies defined in the test mode specification of the Bluetooth Specification. When Reduced Hop or Single Frequency is selected, the Sync method is set to Test Mode and cannot be modified by the user.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 To the right of the Sync Method menu are two menus which let you select or enter address for the devices in the piconet: Master Address - Presents a drop-down list of Master devices found previously. You can also enter address values in this box. Page Target -- Presents a drop-down list of Page Target devices found previously. You can also enter address values in this box.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 blinking. Step 5 Establish connection between the Bluetooth devices under analysis. Step 6 When BTTracer senses Piconet traffic, the Green Sync light goes ON solid, recording starts and the status bar in the bottom of the analyzer screen shows activity. Recording may be stopped manually or when the recording buffer is filled.
CATC BTTracer Protocol Analyzer User’s Manual Step 8 SW Version 2.20 At the end of this sequence, the green Sync light will go on solid, recording will begin and activity will be displayed on the status bar in the bottom of the analyzer screen. Running "Passive Sync and Record" with Private Device Piconets Because private device networks do not allow other devices to join the network, BTTracer needs to temporarily assume the identity of a slave in the network in order to join that network.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 addresses for both your Master Device and Page Target. Step 4 Click OK at the bottom of the window to close the Recording Options dialog box. Step 5 Press the button found on BTTracer's toolbar. After approximately 20 seconds, the "SYNC" light on the front of BTTracer will begin to flash, meaning that BTTracer has acquired all the information it needs to fully synchronize with the piconet about to be established.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Show Paging Traffic Show Paging Traffic causes BTTracer to capture paging traffic between the Master and Page Target devices. This option is used only with Page Sync and Record Mode. Follow Anonymity Allows BTTracer to follow devices that are using anonymity mode. Anonymity mode is an addressing mode in which devices are assigned Bluetooth addresses based on a pseudo-random value. Anonymity mode is defined in the Bluetooth 1.2 specification.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Match Clock Rate Match Clock Rate is a useful option if the Master device’s clock is inaccurate. Match Clock Rate causes BTTracer to do a General Inquiry to determine the Page Target's clock rate prior to synchronizing to the piconet. If unchecked, BTTracer will begin piconet synchronization without first doing a General Inquiry. This option only works with Page Sync and Record mode.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Sync Window The Sync Window slide bar controls the amount of time that BTTracer should wait between receiving an Inquiry Response (which will cause the Sync LED to blink) and detecting Master-Slave piconet traffic (which will cause the Sync LED to turn solid.) A "Narrow" setting means that the wait time will be minimal, a "Wide" setting means it will be "maximal." The default is "Narrow" and this is suitable for most recordings.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Timeout (0-80 secs) Default value for Inquiry Timeout is 20 seconds. Correlation Value (33-64) This value tells BTTracer how many bits in the sync word of each received packet must be matched in order for BTTracer to consider the packet valid and start recording. This value specifies how long BTTracer should perform the Inquiry process for the General (unlimited) and Dedicated (limited) recording modes.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 6.6 Recording Options - HCI The HCI property page lets you include/exclude HCI traffic from the BTTrainer or Implementations Under Test (IUTs) into the trace. HCI traffic consists of commands and data that are sent from the host to the controller and events and data sent from the host to the controller. By default, this option is disabled - meaning that HCI traffic is not shown in the trace.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 To capture the data, the HCI Probe should be connected to the respective 'Host to Controller' and 'Controller to Host' lines. When the recording of the IUT's HCI is enabled and the application starts a recording, the serial data is captured as incoming serial data. For this, up to two COM ports should be configured for each IUT. Probe setup is described in Section 2.8, “Installing the HCI Probe” on page 18.
CATC BTTracer Protocol Analyzer User’s Manual Step 2 SW Version 2.20 From the menu, select Record > Recording Options. The Recording Options dialog box opens showing the HCI page. Step 3 Click Add ....
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 • Name - Symbolic name of the IUT given by the user, for easy identification. • Host => Controller Com port - The port that is used for the capturing of the down-link traffic. • Controller => Host Com port - The port that is used for the capturing of the up - link traffic. • Rate - the bits per second rate the com ports are configured for.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Controller -> Host - COM port used for monitoring the HCI traffic from the application to the bluetooth baseband. Host -> Controller - COM port used for monitoring the HCI traffic from the Bluetooth baseband (Controller) to the application (Host). Rate - Sets the maximum rate in bits per second (bps) that you want data to be transmitted through this port.
CATC BTTracer Protocol Analyzer User’s Manual Step 3 Click SW Version 2.20 to end the recording. When the recording session is finished, the bus traffic is saved to the hard drive as a file named data.tfb or whatever name you assign as the default filename. While the file is being saved, you should see a brown progress bar at the bottom of the screen. When the bar turns white, it indicates that the data has been saved to disk.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 • Click the Events tab on the Recording Options screen. You see the Event Groups window: The Event triggering and filtering options allow you to set event conditions for errors and/or a variety of packet characteristics. Clicking a check box causes further options to display in the right side of the window.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Filter Empty Slots If "Filter Empty Slots" is checked, BTTracer will exclude all empty time slots from a recording except for those that lie immediately in front of Bluetooth communications packets. These remaining empty packets are preserved to give timestamp and frequency hop reference data to the packets that follow.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Packet Type The Packet Type drop down menu lets you select the following packet types for filtering or triggering: NULL, POLL, FHS, DM1, DH1, HV1, HV2, HV3/EV3, DV, AUX1/PS, DM3, DH3, EV4, EV5, DM5, or DH5. Select “Don’t Care” if you want BTTracer to ignore this field. LT_ADDR (Logical Transport Address) The LT_ADDR is a three bit slave address.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 • Select Payload Headers under Event Groups. You see the Payload Headers window L_CH (Logical Channel) The "L_CH" drop down menu presents five options for setting conditions on the Logical Channel: • Don’t care • 00 Undefined • 01 L2CAP continue • 10 L2CAP start • 11 LMP message Select "Don’t care" if you do not want to set conditions on Logical Channel.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Flow works in conjunction with the Logical Channel (L_CH) menu - you select an option from the L_CH menu and then select an option under Flow. Select "Don’t care" if you do not want to set conditions on Flow control. Length (in bytes) Using both the drop down menu and the text box, you can set conditions based on data field length. The maximum length for a single slot packet is 29 bytes. The maximum length for multi-slot packets is 339 bytes.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 You see the Errors window: Use any combination of the listed packet/signaling/protocol errors as a Trigger. CRC Error A CRC error in the packet data payload of the previous data packet. HEC Error An HEC (header error check) error in the packet header for the previous Bluetooth data packet. FEC Error An uncorrectable FEC (Forward Error Correction) error in the packet header for the previous Bluetooth data packet.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Payload Length Error Indicates that the payload of a received Bluetooth data packet was either longer than expected, or that a Bluetooth data packet terminated before the expected end of the payload data. Sync Loss When set, indicates that a loss of piconet synchronization occurred during the frequency slot prior to this slot.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 • Input 1 (TRIG IN 1) - Selectable Edge triggered inputs. Will trigger on any edge it detects. Note that only Data1 - Data0 can be recorded into the trace. Breakout Board Data 7:0 (Edge Triggered) - Triggers on an 8-bit input pattern on any of the breakout board pins marked Data 0 through 7. Rear Panel BNC Connector (Edge Triggered) • Input 2 (EXT IN): Selectable Edge triggered inputs. Will trigger on any edge it detects. 6.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Action Buttons - Their Functions The Action buttons in the right side of the window provide the means of setting triggers, filters, and restarts. To set an action, you simply drag your mouse from an Event to an Action. As described further on, this movement will link the two via an arrow. Trigger The Trigger button enables event triggering. Filter In/Out The Filter In/Out button allows events to be filtered in or out of the recording.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Connecting Events to Counters To connect an event to a counter, click an Event button, then click one of the two counter buttons. The Counter will reposition itself immediately below the event. A line will the connect the counter to the Trigger button. This latter connection between the Counter button and the Trigger button occurs because counters always work in association with triggers. Counters act as assistants to triggers.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 This example reads "Trigger when Count1 has counted 5 Poll packets or Count2 has counted 10 errors." Blue Dot Menus Count1, Count2 and a few other buttons in the Actions window have blue dots in their top left-hand corners that indicate the presence of context-sensitive menus. These menus let you set the button’s values and/or operations. Click the left mouse button on a dot to open the menu.
CATC BTTracer Protocol Analyzer User’s Manual Step 2 SW Version 2.20 Click Change Counter Value You see the Input Counter Value menu Step 3 Enter an input value to tell the Analyzer how many times this event must occur before triggering the end of a recording Step 4 Click OK. Filter Out/In Blue Dot Menu The Filter Out/In button toggles between "Filter Out" and "Filter In". • Filter In records ONLY those packets related to the specified event.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 A menu similar to the one below will open. Your menu may say "Disable" instead of "Enable." Step 2 Select "Enable External Trigger Output" (or "Disable External Trigger Output" if that is the choice presented.) If you have chosen "Enable External Trigger Output", a small arrow will appear on the right side of the button. This arrow indicates that a condition has been set for creating an external output signal.
CATC BTTracer Protocol Analyzer User’s Manual Step 2 SW Version 2.20 Choose "External Trigger Form" A menu will appear with choices for "Pulse Low", "Pulse High", and "Toggle". Step 3 Choose an option not currently selected. The menu closes. Step 4 Reopen the menu. Note that your new selection is now checked. Elastic Arrow Elastic arrows allow you to associate Events, Counters, and Actions. To make an association, Step 1 Click the left mouse button on an Event button such as Hdr1 or Errors.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Event Sequencing If you drag your mouse from one event button to another, you will create a compound condition known as an Event Sequence. An event sequence is a condition that says "Trigger when you see the following sequence of packets." The example below may help to clarify. This example means "Trigger when you see a packet with an Null Header followed by a packet with a Poll Header.
CATC BTTracer Protocol Analyzer User’s Manual Step 3 SW Version 2.20 Click on the other event. The arrow should connect to the second button and the second button should instantly change locations to the center section of the window. 6.9 Saving Recording Options To complete your Recording Options settings, use the features at the bottom of the Recording Options screen. These features remain the same no matter which of the three Recording Options screens you are working in.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 OR Click on the Tool Bar. Your recording session can continue until it has finished naturally or you may need to stop manually by clicking on the Tool Bar, depending on how you set the Recording Options. To manually stop recording, Step 2 Select Stop under Record on the Menu Bar OR Click on the Tool Bar.
CATC BTTracer Protocol Analyzer User’s Manual 114 SW Version 2.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 7. Display Options Use the Display Options menu to specify the way CATC Trace information is displayed. From the Setup menu, select Display Options.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 7.1 General Display Options Use the General Display Options to specify the basic appearance of a Trace view. • • • • • Zoom Level: Adjustable in discrete increments from 10% to 200% percent. Enable Tips: Select to enable Tool Tips with explanation text to pop up when you position your cursor over various fields in the Trace View. Wrap: Causes packets to wrap within the window if their length exceeds the width of the window.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 7.2 Setting Color, Formatting, and Hiding Options Click the Color/Format/Hiding tab on the Display Options screen. Use this window to customize the colors and formats associated with each field in the Trace view. You can also use this window to hide fields within the trace.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 You can also customize the colors by using the options in the Custom tab. Changing Field Formats To change field formats, select an item under the Group and Color column. This action will enable the formats radio buttons on the right. The format types change with respect to the item selected under the Group and Color column.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Hiding Display Options To hide one or more fields in the trace, select the appropriate item from the Group and color column, click the checkbox marked Hidden, and click the Save button. You can also hide Sequences from a trace by selecting the desired options from the checkboxes. 7.3 Level Hiding Options The Level Hiding tab allows you to hide FISs, Idle Sequences and other types of traffic.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Hiding Packets, Messages, and Protocols The "Hide Packets and Transactions" box contains two grids of checkboxes for hiding whole packets, messages, protocols, and traffic from individual devices. The grids are labeled "Devices to Hide" and "Levels to Hide". Devices to Hide The "Devices to Hide" grid lets you hide traffic according to device address. The grid divides into columns which represent different devices.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 7.4 Saving Display Options To complete your display options settings, use the features at the bottom of the Display Options window. These features remain the same no matter which of the four Display Options windows you are working in. • • • • • • Click Save to save the currently specified display options for use in future sessions. Any file name can be specified, but you must use the .opt extension. If no extension is specified, .
CATC BTTracer Protocol Analyzer User’s Manual 122 SW Version 2.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 8. Reading a CATC Trace 8.1 Trace View Features • The BTTracer packet view display makes extensive use of color and graphics to fully document the captured traffic. • Packets are shown on separate rows, with their individual fields both labeled and color coded. • Packets are numbered (sequentially, as recorded), time-stamped, and highlighted to show the device status (master or slave).
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 You can define a unique Marker for each packet. To place a marker on a packet, Step 1 Left-click on Packet # for the packet you wish to mark. Step 2 Select Set Marker. You see the Edit Marker Comment window where you can enter a unique comment about this packet.: Step 3 Enter your comment. Step 4 Click OK. A marked packet is indicated by a vertical red bar along the left edge of the packet # block: 8.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 You see the Packet menu: To edit the Marker Comment, Step 2 Select Edit marker. You see the Edit marker comment window: Step 3 Edit the comment as desired. Step 4 Click OK. To clear a Marker, Step 5 Click Clear marker. The vertical red Marker bar disappears. 8.6 Expanded and Collapsed Data Formats The data field can be expanded to display greater detail or collapsed to a compact view.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Left-clicking a Field Arrow Many fields have small arrows in the top left corner. If you left-click this arrow, the field will toggle back and forth between collapsed and expanded views.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 If your Data Trace View is currently collapsed, you see the Expand Data menu: Note that you can choose to expand or collapse • Only the Data in the selected Data packet OR • Step 2 All Data Fields in the Trace View. Select the desired Expand Data or Collapse Data menu item. The Trace View is repositioned with the selected packet(s) adjusted in the format you have specified. 8.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 8.9 Menus in Clicked Fields You can display the following menu when you click in a field in a trace. 8.10 Hide Unassociated Traffic You can hide all traffic that is not associated with the current decode level by pressing the Hide Unassociated Traffic button on the Tool Bar. From the Tool Bar • First, click one or more decode buttons such as the View L2CAP Messages .
CATC BTTracer Protocol Analyzer User’s Manual 130 SW Version 2.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 9. Decoding Protocols 9.1 Introduction BTTracer can decode HCI, LMP and L2CAP messages, and RFCOMM, SDP, TCS, HDLC, PPP, OBEX, HCRP, BNEP, HID, IP, TCP, and UDP protocols. The default is packet level decoding, which means that baseband packets will be displayed when you first view a trace. If these packets are carrying LMP, L2CAP or other protocols, the protocols will display as undecoded fields such as the L2CAP packet below.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 9.3 Decoding and Viewing Higher Protocol Data Higher protocol data can be decoded two ways: by clicking a decode button on the toolbar or by selecting a decode command from a pull down menu.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Decoding Via the Display Options Dialog Box The Display Options dialog box has three options for issuing decode commands. To issue a command, Step 1 From the menu bar, select Setup>Decoding Options Step 2 Select the option for the desired level of decoding. Step 3 Click OK or Apply. 9.4 Tooltips Additional information about fields can be attained by positioning your mouse pointer over a field of interest.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 9.5 Viewing Packets in LMP and L2CAP Messages LMP and L2CAP Messages can be "opened" to reveal their constituent packets by double-clicking the first cell in of the message or clicking once on the small arrow on that same cell. The packets will then display below the message. The following screenshot shows an example of a message and its packets. Message Packets making up the message 9.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 view higher protocol data, you will need to decode the messages (shown in the next section). The decoded data will appear as new lines in the trace called "Protocol Messages." 9.7 Viewing L2CAP Channel Connections Once L2CAP messages have been decoded and displayed, you can check or change their L2CAP channel connections by opening the L2CAP Decoding Connections dialog box.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 9.8 Viewing Protocol Messages and Transactions By pressing a button such as or , you can cause BTTracer to decode the higher level protocol data contained within L2CAP messages and display them as packet-like rows called Protocol Messages. Protocol Messages have headers marked "protocol" and fields that vary in appearance and content depending on the type of protocol.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 • Left-click the small downward pointing arrow in the message/protocol header • Double-click a message/protocol header • Left-click the message/protocol header and choose "Expand Transaction" from the short-cut menu 9.9 Decoding via the Profiles Toolbar The Profiles toolbar presents buttons that represent profiles. The Profiles buttons do not represent an additional set of decodes; rather, they represent shortcuts for the existing decodes.
CATC BTTracer Protocol Analyzer User’s Manual Step 3 SW Version 2.20 Left-click the field marked "A." Left-click An Assignment menu will open for assigning, re-assigning, or un-assigning protocols to messages. This menu is context-sensitive and will vary in content depending on the protocols in the trace.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 The Decoding Assignments dialog box will open. A status message in the bottom left corner of the dialog box will indicate who assigned the protocol. Step 2 Click on one of the displayed assignments. If the protocol was assigned by BTTracer, the Assign buttons on the right will be grayed out and unavailable. If you want to change these assignments, you will have to use the pop-up menus described in the previous section.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Manually Assigning Protocols If a recording does not capture the beginning of a dialog between a Master and Slave devices, BTTracer may not have the L2CAP messages it needs to determine the correct protocol assignments. In this case, L2CAP messages will display an "N" in the Assignment field that means "Not Assigned." N=Protocol not assigned An L2CAP message without a protocol assignment for the higher protocol data.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Changing an OBEX Client or Server Status If the beginning sequence of traffic is not recorded in a trace, the client/server status of the transmitting devices will not be preserved in the trace. In this case, the OBEX Client/Server pop-up menu will become active and you will be able to change the assignment.
CATC BTTracer Protocol Analyzer User’s Manual 142 SW Version 2.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 10. Exporting Trace Data BTTracer has export commands that enable you to extract trace data to CSV, text and other file formats. This chapter describes the export process. Export commands are accessible through the menu: File > Export. The Export menu has five options: • Packets to Text (Packets View Format) ... • Packets to CSV Text ... • Audio Streams ... 10.
CATC BTTracer Analyzer User’s Manual Step 4 SW Version 2.20 Enter a name for the file and click OK. The file is then saved. Exported text files look like this: 10.2 Exporting Trace Data to a .CSV Format CATC’s BTTracer generates over a dozen performance metrics automatically for every trace and measures them in the Traffic Summary, Bus Utilization, and Timing Calculations dialogs. BTTracer also has the ability, however, to extract a far wider range of performance data to a Comma Separated Value (.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 of a .csv file opened in Microsoft Excel. 10.3 Exporting Audio Data BTTracer has an Export Audio Streams command that allows you to extract audio data from a trace and export it into a file. The command lets you narrow your selection to a particular stream direction (master to slave or slave to master), and to set the output file format and output sampling. Step 1 Select File > Export > Audio Streams from the menu.
CATC BTTracer Analyzer User’s Manual 146 SW Version 2.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 11. Other Features 11.1 Search The Search feature provides several options for searching through recorded traffic, allowing you to find specific packets based on triggering status, packet number, marking, or content. To view the Search options, • Click Search in the Menu bar. You see the Search drop-down menu: Go to Trigger To display a triggering event, select Go to Trigger under Search on the Menu bar.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Step 2 Enter the number of the packet, message or protocol you want to display. Step 3 Click OK. The Trace View repositions to show the packet at the top of your screen. Go to Marker To instruct the analyzer to display a marked packet, Step 1 Select Go to Marker under Search on the Menu Bar. You see a drop-down menu listing the marked packets in that Trace View: Step 2 Select the desired packet from the displayed list.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 You see the Go To drop-down menu: Step 2 Select the event you want to go to and enter the necessary information. Packet Types Select the type of packet you want to go to.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Header LT_Addr Select an Logical Transport Address from the list. DataLength Allows searching based on data length in bytes from the recording.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Lmp Opcode Select the Link Management Protocol Operational Code (Lmp Opcode) that you want to go to. L2Cap Signalling Command Select the type of L2Cap Signalling Command that you want to go to.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 L2Cap CID Select the L2Cap Channel ID (L2 Cap CID) that you want to go to. Error Moves trace view to next uncorrected error. Soft Bit Error Moves trace view to next soft (corrected) error. Loss of Sync Moves trace viewer to the next loss of sync. Find Find is a utility that allows you to conduct searches of one or more events within a trace.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 You see the User-Defined Find Events screen: The Find window divides into three areas: Left area -- Controls the search level, search direction and search origin. Find All - Extracts the results and place them in a separate trace. Search In Hidden - Searches all packets including packets that have been hidden. Center area -- Controls the event groups to be searched.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 In the screenshot shown above, for example, LT Address is selected. On the right, you see that only Address 1 is in bold. This indicates that only a single device was transmitting traffic in the displayed trace. Event Groups Event Groups are categories of events that can occur in a trace. Clicking on an Event Group will display a list of Event types on the right side of the Find window that occur within each Event Group.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Acknowledgments are easily seen in BTTracer traces because BTTracer adds an Ack’d field on data packets of the transmitting device. This means that you do not have to hunt through the trace to see if the packet was acknowledged. The following screenshot shows two examples of Acknowledgments. Implicit NACK - Packet 14577 is a data packet sent by the piconet Master device. Packet 14579 should have been a data packet with an acknowledgment.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Data Length Contains a list of all data lengths that occur in the trace. Data Pattern Searches for the next packet that has a specified data pattern.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Searching for Bit Patterns You search for a bit pattern by using the box labeled Bitmask. Enter one of the three following values: • X = 'Don't care,' • 0 = 'Match a 0', • 1 = 'Match a 1.' Example -- xxxxxx01 means 'Look for a data pattern where the first 6 bits can be any value but the last two bits must be 01.' Searching for Long Patterns You can search for long pattern sequences by entering patterns into multiple rows within the editor.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Intersection is used to search for all selected events: "Find x and y." Intersection lets you tell the analyzer to search the trace for any packet having all of the selected events. Exclusion is used to exclude selected traffic from the trace. Exclusion is used with Union and Intersection --i.e., you select Exclusion with Union or Intersection. • Exclusion + Union -- tells BTTracer to exclude packets with any of the specified events.
CATC BTTracer Protocol Analyzer User’s Manual Step 5 SW Version 2.20 Click OK. The search will then occur. Afterwards, the packets meeting the search criteria will display. Some Find Examples Search for all DM1 and Poll packets with an Active Member Address of 7. Step 1 From the Event Group, select Packet Types. Step 2 From the box on the right, select DM1 and Poll. Step 3 From the Event Group, select Header LT_Addr. Step 4 From the box on the right, select LT_Addr=7.
CATC BTTracer Protocol Analyzer User’s Manual Step 6 SW Version 2.20 Press OK. The trace will redisplay so that it excludes DM1s, Polls, or any packet with LT_Addr=7. Find Next To apply the previous Find parameters to the next search, • Select Find Next under Search on the Menu Bar OR Click on the Tool Bar. 11.2 Device List Device List describes devices discovered in a previous inquiry or was entered by the user.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Buttons Edit Device -- Opens a dialog box for editing the device settings in the Device List. Add New Device -- Opens a dialog box for adding new devices to the list. (You can also enter devices by performing an Inquiry.) This dialog box lets you enter information that will appear in the device list: device names, addresses, aliases, and comments. Remove Device -- Removes the selected device from the Device List. 11.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 The File Information report provides valuable information about how the recording was made, what the buffer settings were, what the trigger options were, and what version of all the analyzer hardware was used to make the recording. 11.5 Error Summary The Error Summary command opens the Traffic Summary dialog box and displays an error summary of the current trace file.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 You see the Timing and Bus Usage Calculator screen: To calculate bus usage and bit rate errors, Step 1 Enter the range of packets to be examined in the text boxes marked "From packet" and "To packet." Step 2 If you wish to limit your calculations to a single device, select the device’s address from the LT Address drop-down menu. Step 3 Click the "Calculate" button. At this point, bus usage will be calculated. 11.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 To open the Bus Utilization window, select Report >Bus Utilization or click the button marked . A window will open with graphs of Link Utilization, Data Throughput, and Packet Counts: Bus Utilization Buttons The Bus Utilization window has a row of buttons for changing the format of the displayed data and for exporting data: The buttons have the following functions: Save As - Saves the graphs as a bitmap file (*.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Graph Areas - Presents options for displaying additional graphs of data lengths, packet lengths, and percentage of bus utilized. Horizontal zoom in Horizontal zoom out View Settings Menu Clicking the View settings button causes a menu to open with options for formatting the display. • Orient Horizontally - changes the orientation of bus usage to horizontal. After selecting this option, the menu will say "Orient Vertically.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 • Fonts and Colors - Opens a dialog box for setting the colors and fonts used in the graphs: Graph Areas Menu The Graph Areas menu allows you to view different information in the Bus Utilization window. Step 1 Click the button. The Graph Areas menu opens. Step 2 Select the data you want to appear in the Graph Areas window.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 The following dialog box will open. It will display options for setting the title, data, color, and line type for the graph. 11.8 Traffic Summary The Traffic Summary dialog box displays a text summary of traffic captured in the current trace. To open the Traffic Summary window, press . The left pane displays a tree of the different protocol levels. Click the plus symbol (+) to expand the tree. The example above is fully expanded.
CATC BTTracer Protocol Analyzer User’s Manual To display the Real-Time Statistics window, click SW Version 2.20 in the Tool Bar. The Real Time Statistics window opens: In order to see a graph of traffic, you will need to start recording. After starting piconet activity, press to start the Real-Time statistics monitor. BTTracer will then synchronize to the piconet and stream data in real time to this window and presented in a format of your choice. To stop the monitor, press .
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 Graph Areas - Presents options for displaying additional graphs of data lengths, packet lengths, and percentage of bus utilized. Horizontal zoom in Start. Starts the Real-Time Monitor. Horizontal zoom out Stop Real-Time Monitoring. Reset. Resets the graphs. Real-Time Statistical Monitor Pop-up Menu If you right-click a graph in the Real-Time window, a pop-up menu will appear with options for changing the format of the display.
CATC BTTracer Protocol Analyzer User’s Manual • SW Version 2.20 Retransmissions - This graph shows the rate of retransmitted packets. In the Real-Time Statistics, a packet is evaluated as 'retransmitted' if at least one non-FHS seqn bit has already been received and if the previous sequence bit is the same as the current sequence bit.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 The following steps show how to configure BTTracer for encrypted traffic. Note Be sure to begin the following process prior to connecting your Slave device to the Master or BTTracer will not be able to capture the Link Key. Step 1 Select View >Device List The Device List appears. Step 2 Click in the row for the device of interest. Step 3 Click the Edit Devices button The following dialog box opens.
CATC BTTracer Protocol Analyzer User’s Manual Step 4 SW Version 2.20 Click the Setup ... button. The following dialog box opens: Step 5 Click the button marked New. The following dialog box appears. Step 6 Enter the appropriate Personal Identification Number (PIN) for the selected device to the box marked PIN Code. This PIN allows BTTracer to learn the Link Key. If you do not have the PIN, skip to Step 5. Note The PIN you provide should be the same used by the Slave.
CATC BTTracer Protocol Analyzer User’s Manual Step 2 SW Version 2.20 Click OK The changes you have made are applied and the information is displayed in the Slave Encryption Setup dialog box as shown previously. Step 3 Click OK. The Slave Encryption Setup dialog box closes. Within the Device List, you should see a "Yes" in the Security field for the selected device. 11.11 Re-applying Encryption Settings If you record a trace with the wrong encryption settings, the trace will not decrypt properly.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 command File > Re-apply Encryption Settings ... A Save As dialog box opens. Step 4 Enter a file name (or use the default) and click OK. The file is saved and the new settings are automatically applied. The new file opens automatically. The file should now be decrypted properly.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 trying to decrypt. Step 3 Click the Edit button. Step 4 The Set Encryption Options dialog box opens. Step 5 Enter the BD Address and Link Key. Step 6 Click OK. The dialog box closes. Step 7 Click Save. The dialog box closes and the traffic is decrypted according to your settings.
CATC BTTracer Protocol Analyzer User’s Manual 176 SW Version 2.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 How to Contact CATC Type of Service Call for technical support… Contact US and Canada: 1 (800) 909-2282 Worldwide: 1 (408) 727-6600 Fax your questions… Worldwide: 1 (408) 727-6622 Write a letter… Computer Access Technology Corp. Customer Support 2403 Walsh Avenue Santa Clara, CA 95051-1302 Send e-mail… support@CATC.com Visit CATC’s web site… http://www.CATC.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 altered by someone other than CATC, Products with missing or altered service tags or serial numbers, and Products for which CATC has not received payment in full.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 policy. If you chose not to have the Product repaired by CATC, you agree to pay CATC for the cost to return the Product to you and that CATC may require payment in advance of shipment. General Provisions THIS LIMITED WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS. YOU MAY HAVE ADDITIONAL RIGHTS THAT VARY BY JURISDICTION.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.20 or by email at: support@catc.com. Please include the transferring owner's name and address, the name and address of the new owner, the date of transfer, and the Product serial number.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.
CATC BTTracer Protocol Analyzer User’s Manual pattern 96, 101 searching by length 150 searching by pattern 156 transfer message 134 Debug file 79 Decoding 132 Description of Merlin 2 Device Bluetooth address 64 general search 52 search 50 search for Bluetooth 60 slave address 54 DH1, 2, 3 packet 99 Displaying information 123, 161 DM1 124 DM1, 2, 3 packet 99 Duration of search 60 DUT Recv/Xmit Freq 82 DV packet 99 SW Version 2.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.
CATC BTTracer Protocol Analyzer User’s Manual pulldown 33 veiw settings 165 Merlin configure encryption 170 description of 2 Message searching 147 Messages LMP, L2CAP 131, 134 transfer 134 Modes test, recording in 68 SW Version 2.
CATC BTTracer Protocol Analyzer User’s Manual SW Version 2.
CATC BTTracer Protocol Analyzer User’s Manual Statistics real-time 167 Status status bar 165 Status of Analyzer 44 Storage temperature 7 Summary error 162 traffic 167 Support, technical 177 Switches 7, 87 Sync and record 83, 84 loss error 103 loss of, searching 152 timeout, loss of 86 window 89 Synchronization, forced 86 Synchronize Piconet 54 Synchronized LED 7 SW Version 2.
CATC BTTracer Protocol Analyzer User’s Manual Z Zoom 45 187 SW Version 2.
