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.
CATC Merlin Protocol Analyzer User’s Manual Version 1.0 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 Merlin Protocol Analyzer User’s Manual Version 1.0 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. EU Conference Statement This equipment complies with the R&TT Directive 1999/5/EC.
CATC Merlin Protocol Analyzer User’s Manual 4 Version 1.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 TABLE OF CONTENTS Chapter 1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Bluetooth™ Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 General Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Automation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Software License Updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Viewing licensing information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 BusEngine and Firmware UpdateUpdates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Automatic Updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Piconet Addresses (MSB -> LSB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 Other Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 Debug/Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 Recording Options - Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 Events Options . . . . . . . . . .
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 How to Decode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 Expanding Protocol Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 Changing Protocol Assignments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 Using the Decoding Assignments Dialog Box . . . . . . . . . . . . . . . . . . . 116 Removing User-Assigned Protocol Assignments . . . . . . . . . .
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. 1.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 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 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.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 user-defined set of trigger events. The unit can also be triggered by an externally supplied signal. An external DB-9 connector provides a path for externally supplied data or timing data to be recorded along with bus traffic. This DB-9 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 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. • One year warranty and hot-line customer support.
CATC 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 & sequencing.
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. (1.
CATC BTTracer Protocol Analyzer User’s Manual 8 Version 1.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 2. Quick 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.
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. Step 1 Select Recording Options under Setup on the Menu Bar.
CATC BTTracer Protocol Analyzer User’s Manual Step 2 Version 1.0 Select the Modes tab. 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.
CATC BTTracer Protocol Analyzer User’s Manual automatically completes, click Version 1.0 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. When the recording session is finished, the bus traffic is saved to the hard drive as a file named data.blt or whatever name you assign as the default filename.
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 • BTTracer software program installation CD and diskettes • Product documentation 3.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Figure 2: Rear Panel • Wide range AC connector module — 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.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Note The Analyzer is capable of supporting supply voltages between 100-volt and 240-volt, 50 Hz or 60 Hz, thus supporting all known supply voltages around the world. Step 2 Use the power switch located on the rear panel to turn the analyzer unit on and off. Note At power-on, the analyzer initializes itself in approximately ten seconds and performs an exhaustive self-diagnostic that lasts about five seconds.
CATC BTTracer Protocol Analyzer User’s Manual Pin Signal Name Signal Description 6 GND Ground 7 GND Ground 8 GND Ground 9 GND Ground Version 1.0 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. Both pins serve to transmit output signals when a trigger event occurs.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 G.P. OUT G.P. OUT needs to be enabled before it will output signalling. See “Blue Dot Menus for the Event Buttons” on page 88 for details on how to enable output signalling. If enabled, G.P. OUT will provide signalling each time a trigger event is detected by the Analyzer. G.P. OUT’s signalling can be set to three different formats - "Pulse High" provides a 16.66 ns (ground to +5V) signal, "Pulse Low" a 16.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 3.9 BTTracer Program Installation The CATC BTTracer software is provided on a CD and also on six 3½ inch diskettes. The software is also available on zip files at the CATC web site: http://www.catc.com/support.html If you are downloading the files from the CATC web site, you will be retrieving several zipped files. The first of these has an executable called install.exe. Double-click on this file and follow the on-screen instructions.
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.
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, Step 1 Click on the Tool Bar. After 20 seconds, Inquiry timeout occurs and the analyzer will upload the data and display the packets.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 4. Updates From time to time as modifications are made to BTTracer, it is necessary to update the Firmware and/or BusEngine for optimal performance. Updates can be performed two ways: either automatically or manually. This chapter describes both procedures. 4.1 Software, Firmware, and BusEngine Revisions The Readme.htm or Readme.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 4.2 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. To update the software, Step 1 In the About Merlin screen, verify which version of BTTracer Software you are currently running. Step 2 Find the latest released software version on the CATC website under Support. If you are running the latest version of the software, no further action is needed.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Step 1 From the Help menu, select Update License. Step 2 Type the path and filename to the license key or click the Browse button to map to the directory containing the license key. Step 3 Click Update Device. Viewing licensing information You can also view licensing information to see what version of the license you are running. From the Help menu, select Display License Information.
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.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Analyzer Setup screen. You can select only one item at this point. If both the BusEngine and the Firmware need to be updated, the update will complete for the first item and then return to the above screen so the second update can be performed. When the second update has finished, you will see the following message telling you that the update is complete. Step 5 Power cycle BTTracer to complete the update.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Updating the BusEngine The BusEngine core is the heart of the Merlin Analyzer. Using state-of-the-art PLD technology, it incorporates both the high speed recording engine and the configurable building blocks that implement data/state/error detections, triggering, capture filtering, external signal monitoring, and event counting and sequencing.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 power-on diagnostics are being run. 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. The Readme file informs you if this is necessary.
CATC BTTracer Protocol Analyzer User’s Manual 28 Version 1.
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.
CATC BTTracer Protocol Analyzer User’s Manual Menu Version 1.0 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. Timing Calculation Starts the calculator dialog for calculating various timing and bandwidth parameters in the recording file.
CATC BTTracer Protocol Analyzer User’s Manual Menu Version 1.0 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. Arrange Icons Arranges minimized windows at the bottom of the display. Windows Displays a list of open windows. Help Help Topics... Displays online help. Update License...
CATC BTTracer Protocol Analyzer User’s Manual Version 1.
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.
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): — Trigger? — Triggered! — Uploading After recording stops, — The flashing message changes to Uploading data–x% done (x% indicates the percentage completion of the data uploading process).
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 During uploading, this segment displays the percent of the upload process completed. Note If packets are filtered from the recording or data are truncated, the recording 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.
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 Ctrl+P Open file Print...
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. When you are finished using the Wizard, you can view your settings in the Recording Options window.
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. • Record traffic on a piconet that has already been established. This option lets BTTracer record traffic from an already established piconet.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 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 the Frequency Hopping Mode for your country, then press Next.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 The following screen displays. Step 3 Select Perform Inquiry Now, then press Next. Selecting Perform Inquiry Now will cause BTTracer to perform a General Inquiry and collect addresses and other details about local Bluetooth devices. If you already have address information for your Bluetooth devices you can choose Skip Inquiry. Choosing Skip Inquiry will cause the Recording Wizard to advance to Step 6.
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) • I want to search only for devices corresponding to the following (hexadecimal) DIAC: This option will cause BTTracer to search for the class of devices that you specify in the DIAC text box. DIAC stands for Device Inquiry Access Code.
CATC BTTracer Protocol Analyzer User’s Manual Step 6 Version 1.0 Press Next. 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.
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 • Show Devices Found - This button will cause a window to open and display details about the found devices.
CATC BTTracer Protocol Analyzer User’s Manual Step 7 Version 1.0 Press the button marked Show Devices Found. The following screen will display: Step 8 Click OK to close the window. Step 9 Press Next. The following window will display: Step 10 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 Version 1.0 The following window will display: Step 11 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 12 Press Next. The following screen will display. This screen displays the settings you selected.
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. Step 13 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 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.
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. Step 14 To close the wizard, press the Close button.
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. Step 1 To start the Recording Wizard, press Recording Wizard from the menu.
CATC BTTracer Protocol Analyzer User’s Manual 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. You will see four choices: Select the hop mode appropriate to your area. Step 5 Select the hop mode appropriate to your area, then press Next. 50 Version 1.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 You will see two choices: Step 6 Select Perform Inquiry Now. You will see two choices: Step 7 Select the first option: I want BTTracer to search for all Bluetooth devices within range. 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.
CATC BTTracer Protocol Analyzer User’s Manual Step 8 Version 1.0 Press Next. You will see two choices: Step 9 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. The PC-BTTracer hardware connection will be tested.
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.
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. This will cause BTTracer to repeat the General Inquiry and recollect information on local Bluetooth devices. Step 11 Press OK to close the Bluetooth Neighborhood window. Step 12 Press Next to advance to the next screen.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 next to the label Piconet Master Address. Step 14 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. They are not mutually exclusive: If the Master supports inquiries while in a connected state, select the first option.
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. 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 17 Version 1.0 Press Next 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. Step 18 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 19 If the above information box opened, press OK to close it.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 The following dialog box will display: Step 20 Press Retry or Back to re-attempt the process. 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 & 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 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. Step 22 When finished, press Close to close the Recording Wizard. 6.
CATC BTTracer Protocol Analyzer User’s Manual Step 2 Version 1.0 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 Version 1.0 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. This screen will show the current settings for the recording: The Advanced button will open the Recording Options dialog box.
CATC BTTracer Protocol Analyzer User’s Manual 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. 62 Version 1.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 6.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 Single-Frequency Mode radio button, enter the appropriate values in the text boxes, and click Next.
CATC BTTracer Protocol Analyzer User’s Manual 64 Version 1.
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.
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. Recording type The Recording Type box presents three options that allow you to set how BTTracer begins and ends a recording.
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. Buffer Size The Buffer Size box has a slide bar for adjusting the recording buffer size from 0.1 megabytes to 128 megabytes. The Recording Type option determines how this buffer is used.
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 Note When a Trigger occurs, recording continues until the post-Trigger amount of the buffer is filled. 7.
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.
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 Sync & Record is the preferred option and should be used whenever possible. If Page Sync & Record can not be used, then Sync & Record should be used.
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™ Specification. When Reduced Hop or Single Frequency is selected, the Sync method is set to Test Mode and cannot be modified by the user. • Single Frequency - Allows the the transmit and receive frequency ranges to be specified.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 Step 2 Have BTTracer perform a General Inquiry. You do this by selecting "General (Unlimited)" from the "Inquiry Recording" drop-down menu on the "Modes" tab in the "Recording Options" window, and then depressing the "REC" button found on BTTracer's toolbar.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 To perform a "Sync and Record", follow the steps below: Step 1 Turn on the Bluetooth™ devices under observation, and set up the 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. Step 2 In the Modes tab under Recording Options, enter the Master Device’s address. Step 3 Start BTTracer recording by pressing REC icon in the toolbar.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 piconet’s master device. Step 4 Make up an address for BTTracer and enter it into the Page Target address in the Modes tab in Recording Options. Make sure you do not select an address for any other local device. Step 5 Press the REC button on the toolbar in BTTracer to start a recording session. Step 6 If necessary, have Master "discover" BTTracer through a General Inquiry.
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).
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. Note GIAC - General Inquiry Access Code is hard-coded in the analyzer and does not require user selection.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 After sync is established, BTTracer will remain in sync as long as there is piconet traffic. 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. 7.
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. Additional Timeslot Filtering By default, BTTracer records frequency hop and timestamp information for all time slots in the Piconet under analysis, regardless of whether the time slot contained a Bluetooth™ packet.
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. Select “Don’t Care” if you want BTTracer to ignore this field. AM_ADDR (Active Member Address) The AM_ADDR is a three bit slave address.
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." Payload Headers Clicking "Payload Headers" causes a series of options to display on the right for setting conditions on payload headers.
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: • 0 • 1 • Don’t care 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.
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. HEC Error An HEC (header error check) error in the packet header for the previous Bluetooth™ data packet.
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™ data packet terminated before the expected end of the payload data.
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. The left section displays Event buttons such as Header buttons and Error buttons.
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. The right section has three permanent buttons for setting actions. These buttons are Trigger, Filter Out/In, and Restart. These buttons allow you to set actions such as triggering or filtering.
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. An arrow will appear that will join the Event to the Counter and then to a trigger.
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" statement. This statement reads "Trigger when Count1 OR Count2 has reached their specified values." This example reads "Trigger when Count1 has counted 5 Poll packets or Count2 has counted 10 FHS packets.
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. To set a Counter, Step 1 Click on the blue dot in the upper left corner of the Count button.
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. Filter Out/In Blue Dot Menu The Filter Out/In button toggles between "Filter Out" and "Filter In".
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, Step 1 Click the Blue Dot on an Event button such as Hdr1 or Errors. A menu similar to the one below will open. Your menu may say "Disable" instead of "Enable.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 To configure the output signal, Step 1 Click the blue dot on an Event button that has a small arrow attached to it like the one shown above. A Blue Dot Menu will open. "External Trigger Form" should be a choice available. If it is not, you will need to choose "Enable External Trigger" and then reopen the menu. Step 2 Choose "External Trigger Form" A menu will appear with choices for "Pulse Low", "Pulse High", and "Toggle".
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 The elastic arrow appears. Step 2 Drag the arrow to the desired Action button. Step 3 With the pointer over an Actions button, click again the left mouse button again. The arrow is replaced with a black line connecting the Event button to the Action button. Event Sequencing If you drag your mouse from one event button to another, you will create a compound condition known as an Event Sequence.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 To create an event sequence, perform the following steps: Step 1 Select two events from the Events window Step 2 Open the Actions window and click on one of the two Event buttons. An elastic arrow should appear. Step 3 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. 7.
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. • The Save as Default function is equivalent to the Save function, specifying the file name default.rec. Whenever you start up the Analyzer, it automatically loads the default.rec file if one exists.
CATC BTTracer Protocol Analyzer User’s Manual Click on the Tool Bar. You see the standard Save As screen. Step 4 Give the recording a unique name and save it to the appropriate directory. 93 Version 1.
CATC BTTracer Protocol Analyzer User’s Manual 94 Version 1.
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 OR • Click on the Tool Bar You see the Display Options window: The Display Options window always opens with the screen for the General tab displayed. 8.
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. You can also create and store your unique Display Options for future use. • Fonts: Allows field fonts and data fonts to be changed.
CATC BTTracer Protocol Analyzer User’s Manual Step 2 Version 1.0 Click Save... You see the Save As window. Step 3 Specify a filename (*.opt). Step 4 Click Save. 8.2 Color Display Options • Click the Colors tab on the Display Options screen. You see the Colors screen: Use this menu to customize the colors associated with each field in the Trace View. You can experiment with this option to achieve the color combination best suited to a particular graphic system.
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. • All packets are colored with a + color when there is no Trigger. Use the color buttons labeled + and - under the Packet # section of the Colors screen to select a Trigger color. To select or change a color, • Click the appropriate color button.
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. The number format changes in the respective location in the packet view window. You can also select the bit ordering to be displayed.
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. Hiding Fields The "Hide Fields" checkboxes allow individual fields to be hidden within a trace. Click the checkbox(es) of your choice to hide one or more fields.
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.) The row in which you place your checkmark determines whether you are hiding traffic going to or from a device.
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. • Click OK to apply any changes you have made to Display Options and close this dialog box. • Click Cancel to cancel any immediate changes you have made and exit the Display Options menu. • Click Apply to apply your changes.
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. • Packets are numbered (sequentially, as recorded), time-stamped, and highlighted to show the device status (master or slave). • Display formats can be named and saved for later use.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 You see the Packet menu: 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: 9.5 Edit or Clear Marker To clear or edit the comments associated with a packet marker, Step 1 Left-click on Packet # for the chosen packet.
CATC BTTracer Protocol Analyzer User’s Manual Step 2 Version 1.0 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. 9.6 Expanded and Collapsed Data Formats The data field can be expanded to display greater detail or collapsed to a compact view. The Expand/Collapse Data feature operates as a toggle. There are three ways to toggle between the two views.
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 • 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.
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. From the Tool Bar • Click to hide all Nulls and Polls. 9.9 Menus in Clicked Fields You can display the following menu when you click in a field in a trace. 9.
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. If these packets are carrying LMP, L2CAP or higher protocols, the protocols will display as undecoded fields such as the L2CAP packet below.
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. Undecoded higher protocol data 10.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 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, 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.
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. 10.
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 Header Payload 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. L2CAP Data-Transfer messages have a payload that may include RFCOMM, SDP, or TCS data.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 The following dialog box will open. Step 2 Click on a channel assignment and then look at the Connect 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. You can verify that BTTracer performed the assignments by looking at the text in the "Slave Channel" box in the lower left corner of the dialog box.
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. You can also expand the protocol by left-clicking the small downward pointing arrow on the protocol header.
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. Step 1 Click to display L2CAP messages. Note You need to view L2CAP Messages in order to have access to the "A" field that permits reassigning protocols.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 To open the Decoding Assignments dialog box and reassign a protocol, Step 1 Select from the menu 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. 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.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 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 Version 1.0 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. Decoding BNEP BNEP (Bluetooth Network Encapsulation Protocol) is a protocol that allows devices to encapsulate network protocols such as IP.
CATC BTTracer Protocol Analyzer User’s Manual 120 Version 1.
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, • 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 Version 1.0 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 Version 1.0 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 Header AM_Addr Select an Active Member Address from the list. DataLength Allows searching based on data length in bytes from the recording. 124 Version 1.
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.
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. Loss of Sync Moves trace viewer to the next loss of sync. Find Find is a utility within MBTTracerat allows you to conduct searches of one or more events within a trace.
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. 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 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. 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 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. 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 Data Length Contains a list of all data lengths that occur in the trace. 130 Version 1.
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: • 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.
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. You enter the pattern you want to match in the column marked Match, and enter the mask in the column marked Mask. The Mask column allows you to specify which bits you are searching for.
CATC BTTracer Protocol Analyzer User’s Manual Step 2 Select a search direction and origin. Step 3 Select one or more events from the Events Group box. Version 1.0 Your choices will affect options presented in the box on the right side of the screen. Step 4 If you have selected two or more criteria, then select either : • Union: Find all packets that match ANY of the specified events. An example would be to find packets with either X or Y.
CATC BTTracer Protocol Analyzer User’s Manual Step 6 Version 1.0 Press OK. 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. Step 1 Select Packet Types from the From the Event Group Step 2 Select DM1 and Poll from the box on the right. Step 3 Select Header AM_Addr from the Event Group. Step 4 Select AM_Addr=7 from the box on the right.
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. Step 1 Select Edit Comment under File on the Menu Bar. You see the Edit comment for trace file window: Step 2 Create, view, or edit the comment. Step 3 Click OK. 11.3 Reports The Report menu provides several reports to assist you in analyzing Bluetooth™ traffic recorded by the analyzer.
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. Error Summary The Error Summary command 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.
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, 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 AM Address drop-down menu. Step 3 Click the "Calculate" button. At this point, bus usage will be calculated.
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. At the bottom of the Traffic Summary window is a button marked "Textual Summary.
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™ Clock Frequency for each discovered device. The expected Bluetooth™ clock frequency is 3200 Hz +/- 250 PPM. 11.
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.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 have the PIN, skip to Step 5. Note The PIN you provide should be the same used by the Slave. For example, if your Slave device requires a PIN of "1234", then enter the same PIN in the dialog box shown above. Step 5 If you do not have the PIN, or if the Master and Slave have already agreed upon the Link Key, manually enter a Link Key as a 128 bit (sixteen byte) hex value into the box marked Current Link Key.
CATC BTTracer Protocol Analyzer User’s Manual 142 Version 1.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.0 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 144 Version 1.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.
CATC BTTracer Protocol Analyzer User’s Manual Installation basic 9 detailed 13 Merlin 18 Interpreting a trace 103 Intersection search 132 Introduction 1 Invalid packet type error 80 Version 1.
CATC BTTracer Protocol Analyzer User’s Manual Version 1.
CATC BTTracer Protocol Analyzer User’s Manual Piconet 3 recording 12 Saving display options 101 recording options 91 SDP Msg 110 Search 42 duration of 51 general 52 Search menu 29 Search options 56 Search results 53 Search type 40, 51 Searching by data pattern 131 complex 126 data length 124 for bit pattern 131 for bit patterns 131 for errors 126 Header AM_Addr 124 L2Cap CID 126 Lmp Opcode 125 packet types 123 recorded traffic 121 Security 139 SEQN condition 77 Sequence event 90 hop 68 Set marker 104 Setu
CATC BTTracer Protocol Analyzer User’s Manual Version 1.
CATC BTTracer Protocol Analyzer User’s Manual 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 U Unassociated traffic, hide 108 Union search 132 Updates automatic 24 firmware, BusEngine 23 software license 22 software, firmware, BusEngine 21 USB drivers, loading 18 V Values, changing counters 85 View menu 29 options 31 packets 112 W Warranty 143 Weight 7 Window menu 31 Wizard Piconet 46 W