2403 Walsh Avenue, Santa Clara, CA 95051-1302 Tel: +1/408.727.6600 Fax: +1/408.727.6622 CATC™ Merlin Mobile™ 1.00 Bluetooth™ Protocol Analyzer User’s Manual Document Revision 1.
CATC MERLIN MOBILE 1.00 User’s Manual CATC Merlin Mobile 1.00 Bluetooth Protocol Analyzer User’s Manual, Document Revision 1.00-DRAFT DRAFT DRAFT Part number: 730-0032-00 Copyright DRAFT Copyright © 2002, Computer Access Technology Corporation (CATC). Protected as an unpublished work. All Rights Reserved. This document may be printed and reproduced without additional permission, but all copies should contain this copyright notice.
CATC MERLIN MOBILE 1.00 User’s Manual Conformance Statements DRAFT CONFORMANCE STATEMENTS DRAFT This device complies with part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) This device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation.
CATC MERLIN MOBILE 1.00 User’s Manual References REFERENCES DRAFT Bluetooth SIG. Bluetooth Specification, Version 1.1, Volume 1. 22 February 2001. Bluetooth SIG. Bluetooth Specification, Version 1.1, Volume 2. 22 February 2001.
DRAFT CATC MERLIN MOBILE 1.00 User’s Manual Table Of Contents DRAFT TABLE OF CONTENTS DRAFT DRAFT Conformance Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .iii FCC Conformance Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii EU Conformance Statement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii References. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DRAFT CATC MERLIN MOBILE 1.00 User’s Manual Table Of Contents DRAFT 3 Merlin Mobile User Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 Application Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12 Toolbars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DRAFT CATC MERLIN MOBILE 1.00 User’s Manual Table Of Contents DRAFT DRAFT DRAFT Count1 and Count2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 Event to Event Sequencing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Saving Recording Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Loading Recording Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
DRAFT CATC MERLIN MOBILE 1.00 User’s Manual Table Of Contents DRAFT Go to Marker. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63 Go To . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63 Find . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .64 Find Next . . . . . . . . . . . . . . . . . . . . . . . . . . .
DRAFT CATC MERLIN MOBILE 1.00 User’s Manual Table Of Contents DRAFT DRAFT DRAFT DRAFT DRAFT Packets in Range (x to y) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 Traffic Summary Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 Traffic Summary Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 Traffic Summary View Options. . . . . . . . . . . . . . . . . . . . . . . . .
DRAFT CATC MERLIN MOBILE 1.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 1 User’s Manual Merlin Mobile Overview DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT CHAPTER 1: MERLIN MOBILE OVERVIEW The CATC™ Merlin Mobile™ Bluetooth™ Protocol Analyzer blends powerful piconet traffic recording and analysis abilities with compact, easily transportable PC Card technology. Merlin Mobile is a development and test tool for products using the Bluetooth wireless technology.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 1 User’s Manual Merlin Mobile Overview DRAFT 1.2 The Merlin Mobile Analyzer System Components The Merlin Mobile analyzer package includes the following items: • One Merlin Mobile analyzer unit • Merlin Mobile software program installation CD • Product documentation including on-line Help DRAFT DRAFT 1.3 The Merlin Mobile Analyzer Unit DRAFT 1.
DRAFT CATC MERLIN MOBILE 1.
DRAFT CATC MERLIN MOBILE 1.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 2 User’s Manual Getting Started DRAFT CHAPTER 2: GETTING STARTED DRAFT This chapter describes how to install Merlin Mobile and its software, how to start Merlin Mobile, and how to set up the analyzer unit. DRAFT 2.1 Installing Merlin Mobile DRAFT Merlin Mobile can be installed on any PC or laptop computer that uses the Windows 98 SE, Windows Me, Windows 2000, or Windows XP operating system and has a functioning PC Card slot.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 2 User’s Manual Getting Started DRAFT 2.2 Starting and Stopping Merlin Mobile DRAFT 2.2.1 Starting the Application Use one of the following procedures to start the Merlin Mobile application: • Select Start > Programs > CATC > CATC Merlin Mobile from the Windows taskbar. • In Windows Explorer or My Computer, navigate to the directory that contains Merlin Mobile, then double-click on the MerlinMobile.exe icon. DRAFT DRAFT 2.2.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 2 User’s Manual Getting Started DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT external signal monitoring, and event counting and sequencing. Both the BusEngine program and the firmware that manage the internal microcontroller are fully field-upgradeable. The most current BusEngine file and firmware file are included with the Merlin Mobile installation software and are automatically installed when the software is installed. 2.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 2 User’s Manual Getting Started DRAFT Step 11 Step 12 Step 13 Step 14 Step 15 Install from a directory on the computer’s hard drive: Browse or enter the path to the Disk 1 directory of the Merlin Mobile installation, then click OK. The Install from Disk window will close. Select CATC Merlin Mobile Bluetooth Protocol Analyzer from the list of devices in the Upgrade Device Driver Wizard and click Next. Click Next to install the driver.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 2 User’s Manual Getting Started DRAFT 2.5.3 Updating the Driver on Windows Me DRAFT DRAFT Step 1 Step 2 Step 3 DRAFT Step 4 DRAFT Step 5 DRAFT DRAFT Step 6 Step 7 Step 8 DRAFT Step 9 Step 10 DRAFT 2.5.4 Updating the Driver on Windows XP Step 1 DRAFT Step 2 Step 3 DRAFT Step 4 DRAFT DRAFT Select Start > Settings > Control Panel from the desktop taskbar, then double-click on System Properties in the Control Panel window.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 2 User’s Manual Getting Started DRAFT Step 6 Step 7 Step 8 Step 9 Step 10 Step 11 Step 12 Choose “Install from a list or specific location.” Choose “Don’t search” then click Have Disk. Enter or browse to the location of the driver and click OK. Select CATC Merlin Mobile Bluetooth Protocol Analyzer from the list and click Next. The driver will install. Click Finish.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 3 User’s Manual Merlin Mobile User Interface DRAFT DRAFT CHAPTER 3: MERLIN MOBILE USER INTERFACE DRAFT This chapter introduces you to the Merlin Mobile application’s user interface. It describes the elements of the application window, as well as the commands available via the menus, toolbars, and keyboard shortcuts. DRAFT 3.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 3 User’s Manual Merlin Mobile User Interface DRAFT • Display area: The display area is the main part of the application window. When files are open, they are shown in the display area and the name of the active file is shown on the title bar. Each file is contained in its own window within the display area. • Status bar: The status bar is located at the bottom of the application window.
DRAFT CATC MERLIN MOBILE 1.
DRAFT CATC MERLIN MOBILE 1.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 3 User’s Manual Merlin Mobile User Interface DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT used to access many of the operations supplied on the menus. When you position the mouse cursor over a toolbar button, a tool tip describing the button’s function will appear, and an additional description of its function appears on the left end of the status bar.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 3 User’s Manual Merlin Mobile User Interface DRAFT Frequently Used Toolbar The Frequently Used toolbar contains shortcuts to commonly used commands.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 3 User’s Manual Merlin Mobile User Interface DRAFT DRAFT View Level Toolbar The View Level toolbar contains shortcuts for viewing specific transactions in a Trace display.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 3 User’s Manual Merlin Mobile User Interface DRAFT Traffic Summary Toolbar The Traffic Summary Toolbar contains commands for working with Traffic Summary reports. This toolbar is located in the Traffic Summary window, which is accessed by selecting Report > Traffic Summary from the menu bar, or by clicking the Traffic Summary icon on the Analysis toolbar.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 4 User’s Manual Gathering Device Information DRAFT DRAFT CHAPTER 4: GATHERING DEVICE INFORMATION DRAFT 4.1 Bluetooth Neighborhood DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT Bluetooth Neighborhood is used to find information about Bluetooth devices in the local area. • Access the Bluetooth Neighborhood window by clicking the Bluetooth Neighborhood button on the toolbar, or by selecting View > Bluetooth Neighborhood from the menu bar.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 4 User’s Manual Gathering Device Information DRAFT Merlin Mobile only loads aliases upon initialization, so you will have to restart the application in order for the new device name aliases to be displayed. DRAFT DRAFT DRAFT DRAFT Figure 4-1: Device addresses and device name aliases in BTnames.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT CHAPTER 5: RECORDING BLUETOOTH TRAFFIC During a recording session, Merlin Mobile monitors and records piconet activity according to the specifications set by the user. When the session ends, Merlin Mobile decodes the data, uploads it to the PC, and displays the recorded packets and related information as a CATC Trace file.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT To configure Merlin Mobile to record traffic on a new piconet, open the Recording Wizard and press Next to advance to the second screen. On the second screen, select “I want to establish a new piconet and have Merlin Mobile record traffic on that piconet.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT Step 9 Advanced — Press the Advanced button in order to open the Modes tab of the Recording Options dialog to further configure the recording parameters. Note that the frequency hop sequence and synchronization method have been set by the Recording Wizard and cannot be changed.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT Step 3 Step 4 Step 5 Step 6 Step 7 Perform Inquiry Now — This option causes Merlin Mobile to perform a general inquiry to discover local Bluetooth devices. Devices that are discovered will then be listed on the screens for Steps 6 and 8. Skip Inquiry — This option skips the inquiry and takes you straight to Step 6.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT Step 8 DRAFT Device Address (page target device): Select or type the address or device name alias of the intended slave device in the combo box on this screen. The combo box lists addresses only for those devices that it has recently encountered via a device search. Note: This step is skipped when using the Sync & Record synchronization method.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT frequency hops that are described in the Bluetooth Specification. Single Frequency Mode limits the recording to a single frequency range that can be specified in the Recording Wizard. To configure Merlin Mobile to record traffic in Bluetooth test mode, open the Recording Wizard and press Next to advance to the second screen.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT DRAFT • • • Page Sync & Record Piconet Recording Sync & Record Piconet Recording Passive Sync & Record Piconet Recording 5.2.1 Make a Manual Inquiry Recording DRAFT DRAFT The Inquiry Recording mode causes Merlin Mobile to perform an inquiry to detect Bluetooth devices within range.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT If Piconet Recording wasn't already selected, the options on the Modes tab will change so that you can configure the piconet recording parameters. If an Inquiry Recording was performed, the addresses of all Bluetooth devices that were discovered will appear in the Master Address and Page Target drop-down lists. Step 4 Select Page Sync & Record from the Sync Method drop-down list.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT Note: In order for this mode to work, the master device must support the inquiry scan substate while connected to other devices.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT Passive Sync & Record is designed to be used with established piconets or private device networks.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT Passive Sync & Record with a Private Device Network Since private device networks do not allow other devices to join the network, Merlin Mobile needs to temporarily assume the identity of a slave in the network in order to obtain the information it needs to synchronize with the devices and capture Bluetooth traffic.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT To stop the recording before the recording session is complete, select Record > Stop from the menu bar, press the Stop button on the standard toolbar, or press the Escape (Esc) key on the keyboard. Merlin Mobile will stop recording and will upload the data that was recorded before the recording was interrupted. 5.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT DRAFT • Triggered!: When a trigger event is detected, the recording state field flashes the message “Triggered!” DRAFT • Uploading: When the recording is finished and Merlin Mobile begins transferring the Trace data to the computer, the word “Uploading” is shown in the recording state field. 5.3.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT 5.4 Uploading Piconet Data When the analyzer has stopped recording, it begins uploading the data to the PC. The upload can be interrupted by selecting Record > Stop from the menu bar, pressing the Stop button on the standard toolbar, or pressing the Escape (Esc) key on the keyboard. The interruption opens the Abort Upload dialog box, which offers the following options: • Stop, but preserve existing upload data.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT 5.5.1 Setting General Recording Options DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT Use the General tab of the Recording Options dialog to define generic recording settings. To set general recording options: Step 1 Open the Recording Options dialog. The General tab is displayed by default. Step 2 Set the Recording Type.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT Step 7 Step 8 (Optional) Set the Trace Filename & Path. Use this option to specify a name and location for the Trace file that is generated with the current set of recording options. If not specified, the default name, data.fdb, and the default location, \Merlin Mobile, are used.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT Step 4 DRAFT DRAFT DRAFT Step 5 DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT Step 6 Step 7 Set the inquiry type. The Inquiry Type for an inquiry recording can be set to one of two options: General (Unlimited) or Dedicated (Limited).
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT Step 3 Step 4 Set the hop sequence. For details, please refer to “Frequency Hop Sequences” on page 38. Set the synchronization method. Merlin Mobile offers three synchronization methods for piconet recording: • Sync & Record — for more information about this method, please see “Make a Manual Sync & Record Piconet Recording” on page 28.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT • Single Frequency — Limits Merlin Mobile to the frequency range specified in the DUT Xmit Freq and DUT Recv Freq boxes. When it is selected, the Sync Method is set to test mode and cannot be modified by the user. DUT Xmit Freq: Allows the user to enter the value of the transmit signal (Xmit Freq) for the Device Under Test (DUT).
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT • • • • • De-whitening Off — When De-whitening Off is selected, Merlin Mobile will try to synchronize without de-whitening the received packets, and assume that they were transmitted un-whitened. After Merlin Mobile has synchronized to the piconet, it should follow changes in the whitening scheme and dynamically track whitened and non-whitened traffic.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT Step 4 DRAFT DRAFT Step 5 Select Additional Timeslot Filtering options, if desired. For more information, see “Additional Timeslot Filtering” on page 43. Click OK to use the settings and close the Recording Options dialog -orContinue configuring the recording options on the General, Modes, and Actions tabs. Note: You may also save the settings as a Recording Options (.rec) file.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT • FLOW — The 1-bit flow indication field can be set to 1 (flow-on) or 0 (flow-off). Selecting Don’t care causes Merlin Mobile to ignore this field. • Length — Use the Length field definition to specify the length, in bytes, of the payload body (the payload minus the payload header and CRC code). For single-slot packets, the length value may range from 1 to 29 bytes.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT Additional Timeslot Filtering DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT Filter Empty Timeslots By default, Merlin Mobile records frequency hop and timestamp information for all time slots, even if the slot is empty. If the Filter Empty Slots option is selected, Merlin Mobile will exclude empty time slots from the recording.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT Note: You may also save the settings as a Recording Options (.rec) file. This will allow you to load the file whenever you want to use those settings. The following section gives details about event actions and sequencing: DRAFT Trigger This action designates an event as a recording trigger. If more than one event is designated as a trigger, the recording will trigger on the first one that is detected.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT Event to Event Sequencing When an event is sequenced to another event, the recording engine waits for the first event to happen and then enables the second event for triggering. Note that an event can be sequenced to another event only if the second event is designated as a trigger, and both are header-type events. 5.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT 5.8 Bluetooth Encryption Bluetooth encryption is a multi-staged process that provides devices with secure, encrypted communications. The process begins with a device prompting the user for a Personal Identification Number (PIN). When the right PIN is entered, the slave begins an encryption setup dialogue with the master. At the beginning of this dialogue, the slave and the master agree on a link key.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 5 User’s Manual Recording Bluetooth Traffic DRAFT Click Apply. The encryption parameters will be added to the Encryption Setup dialog display area. The parameters are displayed in this order: slave device address, PIN, link key status, and current link key.
DRAFT CATC MERLIN MOBILE 1.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 6 User’s Manual CATC Trace Files DRAFT CHAPTER 6: CATC TRACE FILES DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT Merlin Mobile displays Bluetooth piconet traffic recording (.blt) files — also known as Trace™ files — in CATC Trace graphical format. The CATC Trace display makes extensive use of color and graphics to fully document the captured data. Individual packets (subactions) are shown on separate rows, with every field labeled, numbered, and color-coded.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 6 User’s Manual CATC Trace Files DRAFT • • Formats: the Formats tab is used to configure the way that numeric values are displayed. Hiding: the Hiding tab is used to suppress the display of certain fields, packets and transactions. 6.1.1 General Display Options DRAFT DRAFT Use the General tab of the Display Options dialog to define generic display settings. To set general display options: Step 1 Open the Display Options dialog.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 6 User’s Manual CATC Trace Files DRAFT Step 3 DRAFT DRAFT Note: Define pre- and post-trigger colors using the fields labeled Packet #. The one with a minus sign to its left is the pre-trigger field, and the one with a plus sign is the post-trigger field. Step 4 Step 5 DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT Select a field on the Colors tab by left-clicking on it. The Colors dialog will open. Step 6 Choose a new color in the Colors dialog.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 6 User’s Manual CATC Trace Files DRAFT Step 2 Step 3 Step 4 Select the Formats tab. Select new number formats for fields by clicking the radio buttons. Possible formats are: hexadecimal, decimal, binary, and ASCII. Not all formats are available for all fields. You may also change the byte order for some fields by selecting or deselecting the checkbox in the MSB -> LSB (Most Significant Byte to Least Significant Byte) column.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 6 User’s Manual CATC Trace Files DRAFT Click Apply to apply the changes and leave the Display Options dialog open. DRAFT Note: You may also save the changes as a Display Options (.opt) file. You can load Display Options files and apply them to any Trace file. 6.1.5 Saving Display Options DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT Once you have set display options using the Display Options dialog, you can save the settings in a Display Options (.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 6 User’s Manual CATC Trace Files DRAFT • Left-click the arrow in the upper left-hand corner of the transaction number field of the row, or the field heading of the field you want to expand or collapse. You can expand or collapse all rows or fields of the same type (e.g., all L2CAP messages or all CAC header fields) by left-clicking on the arrow and long-clicking — holding down the mouse button for about 1 second.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 6 User’s Manual CATC Trace Files DRAFT DRAFT Figure 6-4: Expanded data field — actual data is displayed DRAFT 6.2.3 Header Fields Header fields can be expanded and collapsed to show or hide additional header data. DRAFT DRAFT DRAFT DRAFT DRAFT Figure 6-5: Collapsed header field — some header data is hidden Figure 6-6: Expanded header field — additional header data is displayed 6.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 6 User’s Manual CATC Trace Files DRAFT • Edit Marker: Allows you to edit the packet's marker comment. This command only appears when the menu is accessed from the row's number field (the first field in the row) and if a marker has been set for the packet. • Clear Marker: Clears the packet's marker. This command only appears when the menu is accessed from the row's number field (the first field in the row) and if a marker has been set for the packet.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 6 User’s Manual CATC Trace Files DRAFT DRAFT DRAFT DRAFT DRAFT the numbers to be grouped, with spaces between the groups. If unchecked, all the numbers on one line will run together. • Bit Order: Choose from Most Significant Bit (MSB) or Least Significant Bit (LSB). • Prev/Next buttons: Click Prev or Next to scroll through the raw quadlet data for all the packets in the Trace file. To save the data: Step 1 Click the Save Data Block... button.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 6 User’s Manual CATC Trace Files DRAFT nels (this command is available only if the active Trace file contains L2CAP transmissions AND the L2CAP protocol level has been decoded during the current viewing of the Trace).
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 6 User’s Manual CATC Trace Files DRAFT 6.4 Trace File Comments DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT A comment of up to 100 characters can be associated with a Trace file. Comments are included in the File Information report. To create, view, or edit a Trace file comment: Step 1 Select File > Edit Comment. The Edit Trace File Comment dialog appears. Step 2 You may now create a new comment or edit the existing comment.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 6 User’s Manual CATC Trace Files DRAFT Step 4 Click OK to save the comment. 6.5.3 Clear (delete) a marker Step 1 Step 2 DRAFT Left-click in the Packet number field that contains the marker, or left-click the marker bar itself. The cell context Trace file menu or marker menu will open. Select Clear Marker. The marker will be deleted, and the red marker bar will be removed. DRAFT DRAFT 6.5.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 6 User’s Manual CATC Trace Files DRAFT Select “Save Range” and enter a starting packet, message, or protocol number on the “From” line, or select a marker from the drop-down list, and enter an ending packet, message, or protocol number on the “To” line, or select a marker from the drop-down list. DRAFT Note: If there are no markers in the Trace file, the drop-down list of markers will not be available.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 6 User’s Manual CATC Trace Files DRAFT 6.8.1 Export to Text Format This option saves a Trace (.blt) file as a text (.txt) file in packet view format. This means that the file will contain the text from the fields in the Trace file. To export a Trace file to packet view format: Step 1 Select File > Export > Packets to Text (Packet View Format). The Export Packets/Messages/Protocols to text dialog will appear.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 6 User’s Manual CATC Trace Files DRAFT of transaction data. This makes it easy to quickly locate specific information in a Trace file. DRAFT 6.9.1 Go to Trigger DRAFT This command repositions the Trace file so that the packet immediately preceding the trigger event is on the first line of the display. If there is no trigger event in the Trace file, this command has no effect.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 6 User’s Manual CATC Trace Files DRAFT Step 2 Step 3 A list of event types will pop up. Choose an event group from the list. All occurrences of events from that event group in the Trace are listed. Choose an event from the list. The display will be repositioned so that the selected event is on the first line of the display. DRAFT DRAFT 6.9.5 Find Use Find to perform a search for events that meet certain criteria.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 6 User’s Manual CATC Trace Files DRAFT DRAFT Step 8 DRAFT Step 9 DRAFT Step 10 DRAFT DRAFT DRAFT Step 11 • Start of the file: The search will start at the beginning of the file (only available when search direction is set to Forward). • End of the file: The search will start at the end of the file (only available when search direction is set to Backward). (Optional) Check Find All to find all matches for the search.
DRAFT CATC MERLIN MOBILE 1.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 7 User’s Manual Decoding Trace Data DRAFT CHAPTER 7: DECODING TRACE DATA DRAFT DRAFT DRAFT DRAFT 7.1 Packet-Level Decoding By default, Merlin Mobile displays all transactions in a Trace file at the baseband packet level, unless the Display Options settings have been configured to do otherwise. Packet-level decoding is a low-level interpretation of the data on a Bluetooth piconet. Merlin Mobile takes the data and separates it into the fields displayed in the Trace.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 7 User’s Manual Decoding Trace Data DRAFT Filtering Hop Frequency Packets Use the Events tab of the Recording Options dialog to filter hop frequency packets (empty slots) from a recording. There are two options for doing this: DRAFT Filter Empty Slots If the Filter Empty Slots option is selected, Merlin Mobile will exclude empty time slots from the recording. This conserves recording memory and eliminates long sequences of hop frequency packets from the Trace.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 7 User’s Manual Decoding Trace Data DRAFT DRAFT DRAFT DRAFT DRAFT • • • DH3 (0xB) DM5 (0xE) DH5 (0xF) Undefined Packets These packet types are undefined in version 1.1 of the Bluetooth Specification, but in the event that you are testing devices based on a version of the specification in which these types are defined, they will be included in Traces made by Merlin Mobile.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 7 User’s Manual Decoding Trace Data DRAFT • Sync word type (CAC, DAC, GIAC, or DIAC): The value of the sync word of the access code. • Access code trailer (Trail): The value of the trailer of the access code. Packet Header Block The packet header block contains fields from the packet header, as described in the Bluetooth Specification, version 1.1. The packet header block can be expanded and collapsed to show or hide the fields, as explained in Section 6.2.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 7 User’s Manual Decoding Trace Data DRAFT • DRAFT DRAFT • • DRAFT • DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT • LM (11) = LMP message Flow indication (L2FL): The value of the flow indication field in the payload header. Possible values: • 1 = flow-on (OK to send) • 0 = flow-off (stop) Payload length indicator (Len): The payload length, in bytes. Payload body (Data): The contents of the payload body for a data field payload format packet.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 7 User’s Manual Decoding Trace Data DRAFT • 010 = Optional scan mode II • 011 = Optional scan mode III • 100, 101, 110, 111 = reserved • Cyclical redundancy check (CRC): The CRC code in the payload. Acknowledge Status Block The acknowledge status block indicates whether the payload data of the current packet was successfully transferred to the target device.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 7 User’s Manual Decoding Trace Data DRAFT DRAFT DRAFT DRAFT • Filtered packets: If a packet is filtered out of the recording, its location is marked by a grey, horizontal bar. • Errors: If errors occur on the bus or in packets or transactions, the fields that contain the errors are highlighted in red. A description of the error can viewed in the field’s tooltip, if it has one. • Warnings: Fields that contain warnings are highlighted in yellow.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 7 User’s Manual Decoding Trace Data DRAFT • Serial Cable Emulation Protocol (RFCOMM) commands • Object Exchange Protocol (OBEX) packets • AT commands • High-Level Data Link Control (HDLC) frames • Point-to-Point Protocol (PPP) packets • Bluetooth Network Encapsulation Protocol (BNEP) messages • Human Interface Device (HID) packets Additionally, users may create custom decoders for their own specific development needs.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 7 User’s Manual Decoding Trace Data DRAFT 7.3.1 L2CAP Channel Decoding Assignments DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT The L2CAP Channel Decoding Assignments dialog and the Assigned to pop-up menu are used to manually configure L2CAP channel assignments (CIDs) for decoding L2CAP messages. Manual assignments are saved with the Trace, so they will be used the next time the Trace is opened and L2CAP messages are decoded.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 7 User’s Manual Decoding Trace Data DRAFT The Trace will update to reflect the new assignments. Note: Manual channel assignments can be removed all at once using the Remove All User assignments command on the Assigned to menu, which is described below. Assigned to Menu The Assigned to menu both shows the current channel assignment and is used to change assignments for decoding L2CAP messages.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 7 User’s Manual Decoding Trace Data DRAFT DRAFT DRAFT DRAFT Step 3 To find out whether a connection assignment was taken from the recording, manually assigned, or is unassigned, click on an item in the Master list. The assignment source will be shown in the Slave channel information area below the list. Assignments that were not taken from the recording can be configured by the user.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 7 User’s Manual Decoding Trace Data DRAFT Step 3 Step 4 To find out whether a channel assignment was taken from the recording (determined by protocol decoder), manually assigned, or is unassigned, click on the row in the list. The assignment source will be shown in the Assignment Info area below the list. Manually assigned and unassigned channels can be configured by the user.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 7 User’s Manual Decoding Trace Data DRAFT DRAFT Decoder scripts for Merlin Mobile are distributed in the \Scripts folder in the Merlin Mobile installation directory. They are identifiable by the .dec extension. Merlin Mobile looks in the \Scripts directory and automatically loads all of the .dec files that it finds. To prevent a particular decoder from being loaded, change its extension to something other than .dec or move it out of the \Scripts directory.
DRAFT CATC MERLIN MOBILE 1.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 8 User’s Manual Reports DRAFT CHAPTER 8: REPORTS DRAFT DRAFT DRAFT DRAFT Merlin Mobile offers several tools for compiling specific information from Trace files. 8.1 File Information The File Information report (Figure 8-1) provides basic information about the active Trace file.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 8 User’s Manual Reports DRAFT The File Information report will open. To save a File Information report: Step 1 Click the Save As... button in the File Information report. The Save As dialog will open. Step 2 Enter a file name. Step 3 Click Save. The file will be saved as a text (.txt) file. DRAFT DRAFT DRAFT 8.2 Error Summary The Error Summary report (Figure 8-2) details errors detected during a recording session for the active file.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 8 User’s Manual Reports DRAFT Step 2 Step 3 DRAFT DRAFT Enter a file name. Click Save. The file will be saved as a text (.txt) file. 8.3 Timing and Bus Usage Calculator The Timing and Bus Usage Calculator (Figure 8-3) calculates the time span, data throughput and bit error rates for a range of packets in a Trace file.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 8 User’s Manual Reports DRAFT The throughput calculation only includes actual payload data bytes. The access code, packet header, payload header, and payload CRC of each packet are not included in the calculation. The result is given in units of bits per second (bps). The throughput is calculated by multiplying the total payload bytes in the packet range by 8, then dividing the product by the total time.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 8 User’s Manual Reports DRAFT DRAFT By default, the Traffic Summary window is docked along the bottom half of the Merlin Mobile display area. If desired, it may be moved out of the application window to another area of the screen. DRAFT DRAFT DRAFT Figure 8-4: Traffic Summary report 8.4.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 8 User’s Manual Reports DRAFT • be further expanded to show the packets categorized by message type, AM_ADDR (member address) and role (master and slave). Errors — Summarizes the traffic by error type. Packets in Range (x to y) By default, the Packets in Range branch is set to summarize the entire Trace. For example, if there are a total of 500 packets in the Trace, then the packet range will be set as 0 to 499.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 8 User’s Manual Reports DRAFT Button Action Prints the Traffic Summary report in text format DRAFT Displays the Traffic Summary report as HTML text Opens the View Options menu DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT DRAFT Opens the Select Range dialog, providing a way to define a range of packets to represent in the Traffic Summary report 8.4.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 8 User’s Manual Reports DRAFT Step 2 Step 3 Enter a starting packet or message number on the “From” line, or select a marker from the drop-down list, and enter an ending packet or message number on the “To” line of the dialog, or select a marker from the drop-down list. Clicking the Reset Range to Whole Trace button sets the From and To entries to include all of the packets in the Trace.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 8 User’s Manual Reports DRAFT Print a Traffic Summary Report To print a Traffic Summary Report: Step 1 Click the Print icon on the Traffic Summary toolbar. A text version of the report will be printed.
DRAFT CATC MERLIN MOBILE 1.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 9 User’s Manual Contact and Warranty Information DRAFT DRAFT CHAPTER 9: CONTACT AND WARRANTY INFORMATION DRAFT 9.1 Contact Information Mailing address DRAFT DRAFT DRAFT DRAFT DRAFT Computer Access Technology Corporation Customer Support 2403 Walsh Avenue Santa Clara, CA 95051-1302 USA Online support http://www.catc.com/ E-mail address support@catc.com Telephone support +1/800.909.2282 (USA and Canada) +1/408.727.6600 (worldwide) Fax +1/408.727.
DRAFT CATC MERLIN MOBILE 1.00 CHAPTER 9 User’s Manual Contact and Warranty Information DRAFT 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, whether special, incidental, consequential, or otherwise, whether under theory of contract, tort (including negligence), indemnity, product liability, or otherwise.
