1. Manuals
  2. Brands
  3. CATC Manuals
  4. Measuring Instruments
  5. BT004APA-X
  6. User manual

CATC BT004APA-X User Manual

Bluetooth protocol analyzer
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
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 1.0
Manual Version 1.0
8 February, 2002

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the BT004APA-X and is the answer not in the manual?

Questions and answers

Summary of Contents for CATC BT004APA-X

  • Page 1 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 1.0 Manual Version 1.0 8 February, 2002...
  • Page 2 The end user of this product should be aware that any changes or modifications made to this equipment without the approval of CATC could result in the product not meeting the Class A limits, in which case the FCC could void the user's authority to...
  • Page 3 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.
  • Page 4 CATC Merlin Protocol Analyzer User’s Manual Version 1.0...

  • Page 5: Table Of Contents

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 ABLE OF ONTENTS Chapter 1 Overview ........1 Bluetooth™...
  • Page 6 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Software License Updates ......... . 22 Viewing licensing information .
  • Page 7 Saving Display Options ......... . . 101 Chapter 9 Reading a CATC Trace ..... . . 103 Trace View Features.
  • Page 8 Configuring Merlin for Encryption......140 Chapter 12 How to Contact CATC..... . . 143 Chapter 13 Warranty and License .

  • Page 9: Chapter 1 Overview

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 1. Overview The CATC BTTracer™ Protocol Analyzer is a member in CATC's industry-leading line of high performance, serial bus protocol analyzers. Preceded by CATC’s USB Chief™ and IEEE 1394 FireInspector™ Analyzers, BTTracer has been designed using the same modular software and hardware architecture that made its predecessors highly successful in the serial bus protocol analyzer market worldwide.

  • Page 10: 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.
  • Page 11 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 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.

  • Page 12: Automation

    Flexible design - reconfigurable hardware for future enhancements. • User friendly - the Graphical User Interface software of BTTracer Analyzer is designed to be consistent with the ‘CATC Trace’ using color and graphics to display Bluetooth™ traffic. • Radio Level Point of Observation and Capture - traffic capture at the Radio Level for comprehensive analysis.

  • Page 13: Physical Components

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 • Automatic tracking of whitened and non-whitened packets and traffic. • Free non-recording, view-only software available. • Power-on self-diagnostics. • Internal 100V to 240 V AC power supply. • Compliant with FCC class A requirements / meets all CE mark requirements.

  • Page 14: Bluetooth™ Busengine

    BTTracer Protocol Analyzer User’s Manual Version 1.0 Bluetooth™ BusEngine CATC’s BusEngine™ Technology is at the heart of the new BTTracer Analyzer. The revolutionary BusEngine core uses state-of-the-art EPLD technology and incorporates both the real-time recording engine and the configureable building blocks that implement data/state/error detection, triggering, capture filtering, external signal monitoring and event counting &...

  • Page 15: Specifications

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 1.5 Specifications Package Dimensions: 9.2 x 8.4 x 2.5 inches (23.4 x 21.3 x 6.4 cm) Connectors: AC power connection external clock input (EXT CLK, BNC) host connection (USB, type ‘B’) data connector (Data In/Out, 9-pin DB) Weight: 2.8 lbs.
  • Page 16 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0...

  • Page 17: Chapter 2 Quick Installation

    From the setup directory, run setup, and follow the on-screen Step 1 instructions to install the BTTracer application on the analyzing PC hard disk. To start the application, launch the CATC BTTracer Step 2 program from the Start Menu: Start>Programs>CATC>BTTracer.

  • Page 18: Your First Bluetooth™ Recording

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 2.3 Your First Bluetooth™ Recording After installing and launching the software, you can test BTTracer by creating a recording of a General Inquiry. In this test, BTTracer will issue a General Inquiry that asks local devices to identify themselves. BTTracer then records the responses.
  • Page 19 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Select the Modes tab. Step 2 The following dialog box will open showing factory default settings. BTTracer defaults to “General Inquiry.” For this recording, leave most of these settings unchanged. If you are recording a Hop Frequency that is not 79 Hops Standard, you will need to select the appropriate standard from the Hop Frequency menu below.
  • Page 20 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 automatically completes, click on the Tool Bar. After a few moments, the recording will terminate and the results will display. The screen should look like the sample recording below which shows the FHS packets generated during the Inquiry process.

  • Page 21: Chapter 3 Detailed Installation

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 3. Detailed Installation 3.1 System Components/Packing List • One stand-alone BTTracer Analyzer module • One Antenna • One External Interface Breakout Board with a 9-pin ribbon cable • One 6-foot (2-meter) USB cable •...

  • Page 22: Ac Power Source

    Data In/Out DB-9 (9-pin) external interface connector Do not open the BTTracer Analyzer enclosure. There are no Warning: operator servicable parts inside. Refer servicing to CATC. 3.3 BTTracer System Setup The BTTracer Analyzer is designed to work with either desktop or laptop computers equipped with a functional USB interface.

  • Page 23: External Interface Breakout Board

    LED illuminates during the power-on testing and turns off when testing is finished. If the diagnostics fail, the trigger LED blinks continuously, indicating a hardware failure. If this occurs, call CATC Customer Support for assistance. 3.5 External Interface Breakout Board...

  • Page 24: Breakout Board External Output Signalling Pins

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Signal Name Signal Description Ground Ground Ground Ground Table 2: External Interface Breakout Board Breakout Board External Output Signalling Pins The "TRG OUT" and "G.P. OUT" pins found on the Analyzer’s Breakout Board have similar functions.

  • Page 25: Prototype Rework Area

    3.8 Analyzer PC Requirements For an updated description of requirements, please refer to the readme file. If installing BTTracer software on a Windows NT 4.0 system, you will need a Note separate set of diskettes, which is available from CATC.
  • Page 26 Follow the installation instructions provided on your screen Step 4 to complete the installation of the driver. When Windows prompts you for a file, browse to the CATC floppy in the a: drive. Note Installing the BTTracer Application Program Run Setup.exe from the BTTracer CD or from the BTTracer floppy disk 1 of 6.
  • Page 27 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 3.10 BTTracer Program Startup You can start the BTTracer program from the Desktop or from the installed directory. The program always begins with its main screen active: The software may be used with or without the analyzer box. When used without an analyzer box attached to the computer, the program functions in a Trace Viewer mode to view, analyze, and print captured protocol traffic.

  • Page 28: Making A Recording

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 3.11 Making a Recording After installation, the software is configured to make a manual recording ("Manual Trigger") of General Inquiry traffic. To make your first recording of this traffic, Click on the Tool Bar.

  • Page 29: Chapter 4 Updates

    About Merlin details revisions of the following software and hardware: • Merlin Software Version • Merlin Firmware Version • BusEngine Version • Unit Serial Number When contacting CATC for technical support, please have available all the Note revisions reported in the About Merlin window.

  • Page 30: Software Updates

    Read the Readme file for important information on changes Step 10 in the release. 4.3 Software License Updates A license key is a file that CATC provides to you when you enter a maintenance agreement. You use this file when you make updates to your CATC software.

  • Page 31: Viewing Licensing Information

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 From the Help menu, select Update License. Step 1 Type the path and filename to the license key or click the Step 2 Browse button to map to the directory containing the license key.

  • Page 32: Automatic Updates

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Automatic Updates When BTTracer’s software is updated, the software may become incompatible with the BusEngine and Firmware. If a recording is attempted, BTTracer will display an error message and then automatically begin an update process for the BusEngine and Firmware. If you prefer, you can abort this update and undertake the steps manually as described later in this chapter.

  • Page 33: Manual Updates To Busengine And Firmware

    The Analyzer resets, performs self-diagnostics, and returns to service. The self-diagnostics should complete about five seconds after the trigger LED Note lights. If the diagnostics fail, the trigger LED blinks on and off continually, indicating faulty hardware. If this occurs, contact CATC for customer support.

  • Page 34: Updating The Busengine

    File name field. The most current Primary BusEngine file (BTTracer.rbf) was copied to your Note \CATC\BTTracer directory when you installed the program. Click Open. Step 2 It is not necessary to restart the Analyzer. Once updated, the Analyzer takes approximately 15 seconds to reinitialize, with Time Remaining displayed on the screen.

  • Page 35: Updating The Firmware

    If there is a hardware failure, the Trigger LED continues to blink after initialization is complete. If this occurs, contact CATC for customer support. Updating the Firmware Within a new software release, it may also be necessary to update the Analyzer’s firmware for proper operation.
  • Page 36 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0...

  • Page 37: Chapter 5 Software Overview

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 5. Software Overview 5.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 3: Main Display Pull-Down Windows...
  • Page 38 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Menu Function Report File Information Details such information about the recording as number of packets and triggering setup. Error Summary Displays an error summary of the current trace file and allows you to go to a specific packet, and save the error file to a uniquely named file.

  • Page 39: View Options

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Menu Function Window New Window Switches display of the Tool Bar on or off. Cascade Displays all open windows in an overlapping arrangement. Tile Displays all open windows in a side-by-side arrangement.
  • Page 40 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Setup Display Options Traffic Summary Start Recording View Packet Level (Baseband) Stop Recording View/Hide LMP Message Level Bluetooth Neighborhood View/Hide L2CAP Message Level Setup Encryption Options View/Hide SDP Message Protocol Level Recording Wizard...

  • Page 41: Status Bar

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 5.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.

  • Page 42: Recording Status

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Recording Status During recording activity, the current Recording Status is temporarily displayed in the next segment. When you activate the Record function, this segment flashes one of the following messages (depending on the selected Recording Options): —...

  • Page 43: Search Status

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 During uploading, this segment displays the percent of the upload process completed. If packets are filtered from the recording or data are truncated, the recording Note activity is reduced. In addition to showing activity, the third segment of the Status Bar will also display the radio signal strength in dBm received by the analyzer.
  • Page 44 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 5.5 BTTracer Analyzer Keyboard Shortcuts Several frequently-used operations are bound to keyboard shortcuts. Table 4: Keyboard Shortcuts Key Combination Operation Key Combination Operation Ctrl+O Open file Ctrl+P Print... Ctrl+Home Jump to First packet...

  • Page 45: Chapter 6 Recording Wizard

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 6. 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.

  • Page 46: Recording A Traffic On A New Piconet

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 The Wizard advances to the next screen which presents three options: • 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.
  • Page 47 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 The following steps shows you how to configure BTTracer to record a new piconet. From the screen shown in the previous screenshot, select the Step 1 first option: I want to establish a new piconet and have BTTracer record traffic on that piconet, then press Next.
  • Page 48 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 The following screen displays. Select Perform Inquiry Now, then press Next. Step 3 Selecting Perform Inquiry Now will cause BTTracer to perform a General Inquiry and collect addresses and other details about local Bluetooth devices.
  • Page 49 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 • 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., in Inquiry Scan Mode) •...
  • Page 50 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Press Next. Step 6 Before the Inquiry, BTTracer tests the hardware connection. In the case of failure, the following screen will display. Clicking OK will close the message box. If BTTracer passes the hardware test, it will search for devices. The...
  • Page 51 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 If no device is found, the Recording Wizard will display the following screen: If devices found, the Recording Wizard will display the following screen: Two buttons will display: • Repeat - This button will cause BTTracer to repeat the General Inquiry •...
  • Page 52 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Press the button marked Show Devices Found. Step 7 The following screen will display: Click OK to close the window. Step 8 Press Next. Step 9 The following window will display: Select from the drop-down menu the hexadecimal address for your Step 10 Master device.
  • Page 53 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 The following window will display: Select from the drop-down menu the hexadecimal address for your Step 11 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.
  • Page 54 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 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.
  • Page 55 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 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. During...
  • Page 56 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 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.

  • Page 57: Recording An Existing Piconet

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 The wizard will close and your trace will display. 6.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.
  • Page 58 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Press Next to advance to the next screen. Step 2 You will see three choices: Select the second option: I want BTTracer to record Step 3 traffic on a piconet that has already been established.
  • Page 59 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 You will see two choices: Select Perform Inquiry Now. Step 6 You will see two choices: Select the first option: I want BTTracer to search for all Step 7 Bluetooth devices within range.
  • Page 60 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Press Next. Step 8 You will see two choices: If you want to change the search duration, type in a new Step 9 value into the text box. Otherwise, use the default value (20 seconds), then press Next.
  • Page 61 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 If BTTracer passes the hardware test, it will then goes onto conduct a General Inquiry to locate local Bluetooth devices. If BTTracer finds Bluetooth devices, it will display the following message: To display a list of the discovered devices, press the button...
  • Page 62 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 marked Show Devices Found. A screen will display showing the devices that BTTracer discovered through the General Inquiry: If you feel that the list is incomplete, you can close this window and press the button marked Repeat.
  • Page 63 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 next to the label Piconet Master Address. Press Next. Step 14 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.
  • Page 64 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 If you selected only the second option in Step 15 (=’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.
  • Page 65 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Press Next Step 17 BTTracer will then display your current settings. The Advanced button will open the Recording Options dialog box shown on page 46 and described in detail in Chapter 7.
  • Page 66 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 The following dialog box will display: Press Retry or Back to re-attempt the process. Step 20 If the hardware failure described in Steps 20 and 21 do not occur, BTTracer will conduct an inquiry. The screen will show that BTTracer is going to attempt a recording in either ’Passive Sync &...

  • Page 67: Recording In Test Mode

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Once BTTracer has the information it needs, it will begin recording. The following screen will display: The recording will end following a trigger event or when you press Stop Recording button on the screen shown above or when you press the button on the toolbar.
  • Page 68 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Press Next to advance to the Recording Type screen. Step 2 The following screen will display: Select the third option: I am using Bluetooth Test Mode Step 3 and want BTTracer to record traffic on my test piconet.
  • Page 69 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Select the option Reduced-hopping mode, then press Next. Step 5 The following screen will display: Select the address for your piconet’s Master device from the Step 6 drop-down menu. If you prefer, you can type in the address into the box.
  • Page 70 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Press Next to begin the recording. Step 8 The following screen will display: When the recording finishes, the following screen will Step 9 display. You can repeat the recording by pressing the Repeat button.

  • Page 71: Recording In Single Frequency Mode

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 6.4 Recording in Single Frequency Mode In the Recording Type window, select the third radio button Step 1 and click Next. In the Frequency Hopping Mode, window select the Step 2 Single-Frequency Mode radio button, enter the appropriate...
  • Page 72 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0...

  • Page 73: Chapter 7 Recording Options

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 7. Recording Options The Recording Options dialog box lets you configure BTTracer for recording Bluetooth™ data. This dialog box offers an alternative to the Recording Wizard described in the previous chapter. At the top of the Recording Options dialog box are four tabs that provide access to dialog boxes called General, Modes, Events, and Actions.

  • Page 74: Recording Options - General

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 • General • Modes • Events • Actions 7.1 Recording Options - General The General tab is displayed by default when the Recording Options dialog box is oppened. It is shown in the previous illustration. The General tab display four boxes marked Recording Type, Buffer Size, Trigger Position, and Options.

  • Page 75: Options

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Options The Options box contains two options: Beep When Trigger Occurs Will cause the PC to beep when a trigger event has occurred. Save External Interface Signals Will enable BTTracer to record input signals from a breakout board as fields in a trace.

  • Page 76: Recording Options - Modes

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 • 95% post-triggering: 0.8MB pre-trigger, 15.2MB post-trigger • 75% post-triggering: 4MB pre-trigger, 12MB post-trigger • 50% post-triggering: 8MB pre-trigger, 8MB post-trigger • 25% post-triggering: 12MB pre-trigger, 4MB post-trigger • 5% post-triggering: 15.2MB pre-trigger, 0.8MB post-trigger...

  • Page 77: Recording Mode

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Recording Mode To record Bluetooth™ traffic, the BTTracer analyzer needs to synchronize to the piconet under observation. BTTracer does not participate in the piconet and behaves as a passive listener. It needs, however, to communicate briefly with the devices in the piconet to learn the Master clock and frequency hopping sequence.

  • Page 78: Piconet Recording

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Piconet Recording The "Piconet Recording" option presents three choices for recording piconet traffic: Sync and Record, Passive Sync & Record, and Page Sync & Record. A Help button next to the menu briefly explains these options.

  • Page 79: Sync Methods

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 • 79 Hops Standard • 23 Hops Japan • 23 Hops Spain • 23 Hops France • Reduced Hop - Restricts BTTracer to five hop frequencies defined in the test mode specification of the Bluetooth™...
  • Page 80 After the General Inquiry completes, as indicated by the automatic Step 3 uploading and displaying of a CATC trace (approximately 20 seconds), reselect the "Modes" tab in the "Recording Options". At this point, the addresses of all Bluetooth™ devices that were in range will be listed in the pull-down windows in the "Piconet...
  • Page 81 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 To perform a "Sync and Record", follow the steps below: Turn on the Bluetooth™ devices under observation, and set up the Step 1 master device so it is ready to respond to Inquiry scan. For a typical recording, ensure that the Master and Slave device(s) are not yet connected.
  • Page 82 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 piconet’s master device. Make up an address for BTTracer and enter it into the Page Target Step 4 address in the Modes tab in Recording Options. Make sure you do not select an address for any other local device.

  • Page 83: Force Re-Synchronization

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 slave. Force Re-synchronization "Force Re-Synchronization" forces BTTracer to re-synchronize at the beginning of each "Page Sync & Record," "Passive Sync & Record," or "Sync & Record" operation. By default, "Force Re-Synchronization" is disabled (i.e., unchecked).

  • Page 84: Other Parameters

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Record. • DIAC LAP- Device Inquiry Access Code. Used for Device Inquiry. • Swap - The "swap" button swaps the addresses between the Master Addr and Page Target text boxes. This button will allow addresses to be swapped even if the boxes are grayed out.

  • Page 85: Debug/Test

    Debug/Test Enable CATC debug file Checking this box enables the creation of a file that can be used by CATC Support to aid in debugging. This option should always be disabled unless you are requested to enable it by CATC personnel.
  • Page 86 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 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.
  • Page 87 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 • Select Packet Headers under Event Groups. You see the Packet Headers window: 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, DV, AUX1, DM3, DH3, 1100, 1101, DM5, or DH5.
  • Page 88 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 or Flow changes the value of this field from zero to one. For example, if SEQN is checked, the event condition becomes "SEQN=1 AND ARQN=0 AND Flow=0. To cause BTTracer to ignore this set of check boxes, choose "don't care."...
  • Page 89 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 • 01 L2CAP continue • 10 L2CAP start • 11 LMP message Select "Don’t care" if you do not want to set conditions on Logical Channel. Flow Three "radio buttons" are presented for setting conditions based on Flow control: •...
  • Page 90 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 • Select Errors under Event Groups. 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 Bluetooth™ data packet.

  • Page 91: Payload Length Error

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Header Length Error Indicates that a received Bluetooth™ data packet was terminated before all bits of the packet header were received. Payload Length Error Indicates that the payload of a received Bluetooth™ data packet was either longer than expected, or that a Bluetooth™...

  • Page 92: Recording Options - Actions

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 7.4 Recording Options - Actions The Actions screen allows you to specify the type of action that BTTracer should perform when it encounters the events specified in the Events window. Actions Window Layout The Actions window divides into three sections: a left, a center, and a right section.

  • Page 93: Action Buttons - Their Functions

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 This center section can also hold Event buttons such as Errors and Payload Hdr1. Event buttons in this section are used to create triggers based on a sequence of Events. Event Sequencing is explained later in the chapter.
  • Page 94 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 The Actions window showing a condition based on a Poll packet and a counter. This condition reads "Trigger after the 21st Poll packet." Connecting Events to Counters To connect an event to a counter, click an Event button, then click one of the two counter buttons.

  • Page 95: Blue Dot Menus

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 The following example reads "Trigger after any combination of 5 Poll packets and FHS packets have occurred." Linking Two Events to Two or More Counters - If an Event is linked to Count1 and a second event is linked to Count2, it creates an "or"...
  • Page 96 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Counters Blue Dot Menu The Count1 and Count2 blue dot menus allow the value of their counters to be changed. The value you specify here tells BTTracer how many instances of an event must take place before a trigger occurs. The counter can be set between 1 and 65,535.
  • Page 97 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 As an example, look at the specifications set in the following screen: Counter 1 has been set to trigger four events after 15 occurrences. But the Counter does not count 15 occurrences for EACH event. It counts ALL events as they happen to occur until it reaches a total of 15 and then triggers.
  • Page 98 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Blue Dot Menus for the Event Buttons The Errors button and the first Headers button (marked "Hdr1") have the same Blue Dot menus. These menus allow BTTracer to trigger external output. To enable or disable external trigger output, Click the Blue Dot on an Event button such as Hdr1 or Errors.
  • Page 99 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 To configure the output signal, Click the blue dot on an Event button that has a small arrow Step 1 attached to it like the one shown above. A Blue Dot Menu will open. "External Trigger Form" should be a choice available.
  • Page 100 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 The elastic arrow appears. Drag the arrow to the desired Action button. Step 2 With the pointer over an Actions button, click again the left Step 3 mouse button again. The arrow is replaced with a black line connecting the Event button to the Action button.

  • Page 101: Saving Recording Options

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 To create an event sequence, perform the following steps: Select two events from the Events window Step 1 Open the Actions window and click on one of the two Event Step 2 buttons.

  • Page 102: Recording Bluetooth Traffic

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 though use of the .rec is recommended; if no extension is specified, .rec is added by default. • Click Load to load a previously saved *.rec file, thus restoring a previous set of Recording Options.
  • Page 103 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Click on the Tool Bar. You see the standard Save As screen. Give the recording a unique name and save it to the Step 4 appropriate directory.
  • Page 104 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0...

  • Page 105: Chapter 8 Display Options

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 8. Display Options Use the Display Options menu to specify the way CATC Trace information is displayed. To open the Display Options menu, • Select Display Options under Setup on the Menu Bar •...

  • Page 106: Trace Viewing Level

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 • Wrap: Inhibits carriage returns in packets when they exceed the width of the window. • Trace Viewing Level: Enables different levels of transaction to be displayed. • Display Configuration Name: A Comment field associated with the *.opt file containing the current Display Options values.

  • Page 107: Color Display Options

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Click Save... Step 2 You see the Save As window. Specify a filename (*.opt). Step 3 Click Save. Step 4 8.2 Color Display Options • Click the Colors tab on the Display Options screen.
  • Page 108 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 • The packet that causes the Trigger and all the packets before it are colored with the - color. • The packet that follows a Trigger is colored with the + color.

  • Page 109: Formats Display Options

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 8.3 Formats Display Options • Click the Formats tab on the Display Options screen. You see the Formats window: Select a number format corresponding to the column labels along the top of the screen for each number field that labels the rows along the left of the screen.

  • Page 110: Hiding

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 8.4 Hiding • Click the Hiding tab on the Display Options screen. You see the Hiding window: Use the Hiding window to hide various fields, packets, messages, and protocols from the Trace View screen. You can modify these settings at will to display a specific area of a Trace.

  • Page 111: Saving Display Options

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Columns labeled "0" through "7" and "All" represent the Active Member Address of a device. By checking one of the boxes in a column, you hide the traffic of the selected device (or traffic from all devices if you have selected All.)
  • Page 112 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 • The Save as Default function is equivalent to the Save function, specifying the file name default.opt. Whenever you start up the analyzer, it automatically loads the default.opt file if one exists.

  • Page 113: Chapter 9 Reading A Catc Trace

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 9. Reading a CATC Trace 9.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.

  • Page 114: Tooltips

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Packet:# Packet/Event Number Channel Access Code Trail Access Code Trailer of the Sync word Addr Active Member Address DM1 Packet Type Flow ACL Link Flow Control Arqn Acknowledgment Indication Flag Seqn Sequential Numbering...

  • Page 115: Edit Or Clear Marker

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 You see the Packet menu: Select Set Marker. Step 2 You see the Edit Marker Comment window where you can enter a unique comment about this packet.: Enter your comment. Step 3 Click OK.

  • Page 116: Expanded And Collapsed Data Formats

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Select Edit marker. Step 2 You see the Edit marker comment window: Edit the comment as desired. Step 3 Click OK. Step 4 To clear a Marker, Click Clear marker. Step 5 The vertical red Marker bar disappears.

  • Page 117: Hide Frequency Hops

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 If your Data Trace View is currently expanded, you see the Collapse Data menu: If your Data Trace View is currently collapsed, you see the Expand Data menu: Note that you can choose to expand or collapse •...

  • Page 118: Hide Nulls And Polls

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 From the Tool Bar • Click to hide all Hop packets. 9.8 Hide Nulls and Polls You can hide Nulls and Polls from a trace by pressing the Hide Nulls and Polls button on the Tool Bar.

  • Page 119: Chapter 10 Decoding Higher Protocols

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 10. Decoding Higher Protocols 10.1 Introduction BTTracer can decode LMP and L2CAP messages, and RFCOMM, SDP, TCS, HDLC, PPP, and OBEX protocols. The default is packet level decoding, which means that baseband packets will be displayed when you first view a trace.

  • Page 120: Decoding And Viewing Higher Protocol Data

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 the action, and the device performing the action. If the message is carrying higher protocol data such as RFCOMM, TCS, OBEX or SDP data, the message displays this data in an undecoded format that can be decoded later.

  • Page 121: Decoding Via The Display Options Dialog Box

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Decoding Via the Display Options Dialog Box The Display Options dialog box has three options for issuing decode commands. To issue a command, From the menu bar, select Setup>Decoding Options Step 1 Select the option for the desired level of decoding.

  • Page 122: Tooltips

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 10.4 Tooltips Additional information about fields can be attained by positioning your mouse pointer over a field of interest. A tooltip will appear that will provide details about the field. In some cases, there can be a considerable amount of information available.

  • Page 123: Viewing L2Cap Channel Connections

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Each message has the same basic message header but differs in its payload. LMP Signalling Message Payload Header L2CAP Signalling Message Payload Header L2CAP Data Transfer Message Header Payload LMP and L2CAP Signalling messages have payloads of commands for establishing LMP and L2CAP channels.

  • Page 124: Viewing Protocol Messages And Transactions

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 The following dialog box will open. Click on a channel assignment and then look at the Connect Step 2 and Disconnect buttons on the far right of the dialog box. If the Connect and Disconnect buttons are grayed-out, it means that BTTracer made the channel assignments using data in the trace.

  • Page 125: Viewing L2Cap Messages In Protocol Messages

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 a response. For example, if you press BTTracer will locate SDP requests and responses between a Master and Slave device summarize their data. Viewing L2CAP Messages in Protocol Messages If the protocol heading is double-clicked, the L2CAP data-transfer messages that make up the protocol will display below the protocol.

  • Page 126: Changing Protocol Assignments

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 10.9 Changing Protocol Assignments If a sequence of messages is assigned the wrong protocol, errors will display. To change or remove a protocol assignment, you will need to access the Assignment menu and issue an Add Assignment command.

  • Page 127: Removing User-Assigned Protocol Assignments

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 To open the Decoding Assignments dialog box and reassign a protocol, Select from the menu Step 1 View>Decoding assignments 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.

  • Page 128: Manually Assigning Protocols

    OBEX client or OBEX server. To view an OBEX message’s client/server status, Open an OBEX trace file such as the sample file Step 1 "OBEXsample.blt" in C:\Program files\CATC\BTTracer. Press , and to hide Hops, NAKs, and unassociated Step 2 traffic.

  • Page 129: Changing An Obex Client Or Server Status

    If the decode file is not read at initialization, BTTracer will display the data in an undecoded format. For more information on BNEP decoding, see a supplemental document on BNEP in the support directory on the CATC web site: http://www.catc.com/products/support/sup_BTTracerbluetooth.html Decoding HID HID (Human Interface Device) is a profile associated with traffic from devices such as a mouse or a keyboard.
  • Page 130 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0...

  • Page 131: Chapter 11 Other Features

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 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, •...

  • Page 132: Go To Marker

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Enter the number of the packet, message or protocol you want to Step 2 display. Click OK. Step 3 The Trace View repositions to show the packet at the top of your screen.
  • Page 133 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 You see the Go To drop-down menu: Select the event you want to go to and enter the necessary Step 2 information. Packet Types Select the type of packet you want to go to.
  • Page 134 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Header AM_Addr Select an Active Member Address from the list. DataLength Allows searching based on data length in bytes from the recording.
  • Page 135 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 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.

  • Page 136: Error

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 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.
  • Page 137 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 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.

  • Page 138: Event Groups

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 In the screenshot shown above, for example, AM 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.
  • Page 139 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 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.
  • Page 140 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Data Length Contains a list of all data lengths that occur in the trace.
  • Page 141 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Data Pattern Searches for the next packet that has a specified data pattern. Searching for Bit Patterns You search for a bit pattern by using the box labeled Bitmask. Enter one of the three following values: •...

  • Page 142: Union, Intersection, And Exclusion

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Example - If you enter xxxxxx01 into row 0 and 11xxxxxx into row 4, it means 'Look for the pattern xxxxxx01 xxxxxxxx xxxxxxxx xxxxxxxx 11xxxxxx.' Searching for Hexadecimal Patterns The columns marked Match and Mask allow you to specify a pattern in hex.
  • Page 143 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Select a search direction and origin. Step 2 Select one or more events from the Events Group box. Step 3 Your choices will affect options presented in the box on the right side of the screen.

  • Page 144: Find Next

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Press OK. Step 6 The trace should reposition to the first DM1 or Poll packet that has an Active Member address of 7. Exclude all DM1 and Poll Packets with Active Member Addresses of 7.

  • Page 145: Edit Comment

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 11.2 Edit Comment You can create, view, or edit the 100-character comment field associated with each Trace file. Select Edit Comment under File on the Menu Bar. Step 1 You see the Edit comment for trace file window: Create, view, or edit the comment.

  • Page 146: Error Summary

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 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.

  • Page 147: Traffic Summary

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 You see the Timing and Bus Usage Calculator screen: To calculate bus usage and bit rate errors, Enter the range of packets to be examined in the text boxes Step 1 marked "From packet" and "To packet."...
  • Page 148 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 The second section is scrollable: click on an item below one of the headings to display scroll arrows. The arrows will allow you to scroll through the packets or transactions within that section. As you scroll, the trace will simultaneously jump to the packet or transaction that is listed.

  • Page 149: Bt Neighborhood

    CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 11.4 BT Neighborhood The BT Neighborhood status box displays information about known Bluetooth™ devices. This command is accessible through the View menu in the menu bar. Three types of data are displayed: Device Address, Class of Device (COD), and the Bluetooth™...
  • Page 150 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 and allow BTTracer to discover the Link Key on its own. Once BTTracer has the Link Key, it can capture the rest of what it needs by listening to the Master and Slave devices as they negotiate for the Encryption Key.
  • Page 151 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 have the PIN, skip to Step 5. The PIN you provide should be the same used by the Slave. For example, if your Note Slave device requires a PIN of "1234", then enter the same PIN in the dialog box shown above.
  • Page 152 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0...

  • Page 153: Chapter 12 How To Contact Catc

    CATC shall not be liable for damage to other property caused by any defects in this product, damages based upon inconvenience, loss of use of the product, loss of time or data, commercial loss, or any other damages,...
  • Page 154 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0...

  • Page 155: Index

    CAC 104 API 4 Calculations, timing 136 Application installation 9, 18 Capturing a trace 20 Architecture of Piconet 3 CATC Technical Support 143 Arqn 104 Certification 7 ARQN condition 77 Changing trace view 96 AT 110 Channel connections, L2CAP 113...
  • Page 156 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 data 7, 15 creating files 96 physical 7, 15 formats 99 Correlation Value 74 general 95 Counters hiding 100 connecting events 84 saving 101 value 85, 86 Displaying information 103, 135 Counting buttons 83...
  • Page 157 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Explicit NACK 128 L2Cap CID 126 External Lmp Opcode 125 input signals 75, 81 marker 122 interface 15 packet types 123 trigger form 89 packet/Message/Protocol 121 Groups, events 75 Features 4 FEC Error 80...
  • Page 158 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Installation editing and clearing 105 basic 9 searching 122 detailed 13 setting 104 Merlin 18 Master Interpreting a trace 103 address 73 Intersection search 132 and slave 128 Introduction 1 device, syncing to 34...
  • Page 159 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Operating temperature 7 addresses 73 Options established devices 71 general display 95 master address 54 general recording 63 private device 72 name 10 recordiing 68 Piconet recording 68 recording 11, 45, 49...
  • Page 160 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Piconet 3 recording 12 Radio strength 35 Saving Reading a trace 103 display options 101 Record inquiry 67 recording options 91 Record menu 29 SDP Msg 110 Recording Search 42 a trace 20...
  • Page 161 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Size of buffer 65 display colors 97 Skip inquiry 50 display formats 99 Slave device, address 44 general display 95 Slave switch 73 hiding display 100 Snapshot 10, 64 recording events 75...
  • Page 162 CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Trail 104 Transfer message, data 112 TRG OUT 16 Trigger event 64 external form 89 LED 7 position 10, 65 post triggering 66 recording, manual 64 Type of recording 64 Unassociated traffic, hide 108...

This manual is also suitable for:

Bttracer

Table of Contents