Teledyne Merlin Mobile User Manual
2403 Walsh Avenue, Santa Clara, CA 95051-1302 Tel: +1/408.727.6600 Fax: +1/408.727.6622
CATC Merlin Mobile
Bluetooth™Protocol Analyzer
User’s Manual
SW Version 2.0
™
18 March 2000
Merlin Mobile User’s ManualCATC SW Version 2.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.
Trademarks and Servicemarks
CATC, Merlin, Merlin’s Wand, Merlin Mobile, BTTracer, BTTrainer,
Advisor, Chief, FireInspector, Inspector, Detective, Traffic Generator,
BusEngine,USB4DOS,UPT,HPT,UHT,IBTracer,andSATracer are
trademarks of Computer Access Technology Corporation.
Microsoft, Windows NT, Windows 2000, Windows 98SE, Windows Me,and
Windows XP are registered trademarks of Microsoft Inc.
All other trademarks are property of their respective companies.
Copyright
Copyright © 2003, Computer Access Technology Corporation (CATC); All
Rights Reserved.
Portions of this product are supplied courtesy of Richard Herveille.
Copyright (c) 2002, 2003 Richard Herveille, rherveille@opencores.org. All
rights reserved.
This document may be printed and reproduced without additional
permission, but all copies should contain this copyright notice.
FCC Conference Statement
This equipment has been tested and found to comply with the limits for a
Class A digital device and an intentional radiator, pursuant to Part 15 of the
FCC Rules. These limits are designed to provide reasonable protection
against harmful interference when the equipment is operated in a
commercial environment. This equipment generates, uses, and can radiate
radio frequency energy and, if not installed and used in accordance with the
instruction manual, may cause harmful interference to radio
communications. Operation of this equipment in a residential area is likely
to cause harmful interference in which case the user will be required to
correct the interference at their own expense. The end user of this product
should be aware that any changes or modifications made to this equipment
2
Merlin Mobile User’s ManualCATC SW Version 2.0
without the approval of CATC could result in the product not meeting the
Class A limits, in which case the FCC could void the user's authority to
operate the equipment.
Important Notice: To comply with FCC RF exposure requirements
(sections 1.1307 and 1.310 of the Rules) only the antenna supplied by
CATC must be used for this device. The antenna must be located at least 20
cm away from all persons.
FCC Testing applies to FCC ID: KH7BT004APA-X.
EU Conference Statement
This equipment complies with the R&TT Directive 1999/5/EC. It has been
tested and found to comply with EN55022:1994/A1:1995/A2:1997 Class A,
EN61000-4-2:1995, EN61000-4-3:1995, EN61000-4-4:1995,
EN61000-4-5:1995, EN61000-4-6:1995, EN61000-4-11:1994,
EN61010-1:1993, and ESTI EN 300 328-1 V1.2.2 (2000-07).
Manual Version 2.0 Part number: 730-0032-00
3
Merlin Mobile User’s ManualCATC SW Version 2.0
4
Merlin Mobile User’s ManualCATC SW Version 2.0
TABLE OF CONTENTS
Chapter1 Overview.....................................1
BluetoothSpecification .............................................2
Merlin Mobile Analyzer System Components. . ..........................2
MerlinMobileSpecifications.........................................2
SystemRequirements...............................................3
UsingMerlinMobilewithMerlin’sWand ..............................3
MerlinMobileAutomation ..........................................3
HCITrace........................................................4
FeaturesofMerlinMobile...........................................4
Chapter2 GettingStarted................................7
InstallingMerlinMobile ............................................7
SoftwareInstallation.........................................7
HardwareInstallation...............................................7
StartingandStoppingMerlinMobile ..................................8
StartingtheApplication ......................................8
ExitingtheApplication.......................................8
StartingtheAnalyzerUnit ....................................8
ShuttingDowntheAnalyzerUnit...............................8
DisplayingHelp...................................................9
UpdatingtheBusEngineandFirmware.................................9
UpdatingtheDriver................................................9
UpdatingtheDriveronWindows2000 ..........................9
UpdatingtheDriveronWindows98SE ........................10
UpdatingtheDriveronWindowsMe...........................11
UpdatingtheDriveronWindowsXP...........................12
LicenseKeys ....................................................12
UpdateLicense............................................12
LicenseInformation ........................................13
InstallingtheHCIProbe............................................13
HCIProbeconfigurations....................................14
2-portRS232toUSBconverter ...............................16
YourFirstBluetoothRecording......................................17
InquiryRecording..........................................20
Chapter3 SoftwareOverview............................23
TheMainDisplayWindows ........................................23
Toolbar ........................................................26
StatusBar.......................................................28
RecordingProgress.........................................28
StatusBarPositionDefinitions: ...............................28
RecordingStatus...........................................29
AnalyzerStatus............................................30
SearchStatus..............................................31
ZoomIn..................................................31
1
Merlin Mobile User’s ManualCATC SW Version 2.0
ZoomOut ................................................31
ToolTips .......................................................31
MerlinAnalyzerKeyboardShortcuts .................................31
Chapter4 RecordingWizard ............................33
StartingRecordingWizard...................................33
RecordingaTrafficonaNewPiconet.................................34
RecordinganExistingPiconet ......................................44
RecordinginTestMode............................................54
RecordinginReducedHoppingMode..........................54
RecordinginSingleFrequencyMode.................................59
Chapter5 RecordingOptions............................63
RecordingModes.................................................63
Piconetrecording ..........................................63
Inquiryrecording ..........................................63
IUT:HCImode ............................................64
OpeningtheRecordingOptionsDialogBox............................64
RecordingOptions-General........................................65
Recordingtype ............................................65
Options..................................................66
BufferSize ...............................................66
TriggerPosition ...........................................67
RecordingOptions-Piconet ........................................67
HopSequence.............................................68
SyncMethod..............................................69
AdditionalSettings.........................................73
Debug ...................................................75
RecordingOptions-Inquiry ........................................75
RecordingOptions-HCI...........................................76
HCIWindowLayout........................................77
RecordingHCITraffic.............................................79
RecordingOptions-Events.........................................80
PayloadLengthError.......................................87
RecordingOptions-Actions........................................87
ActionButtons-TheirFunctions..............................88
BlueDotMenus ...........................................90
SavingRecordingOptions..........................................95
RecordingBluetoothTraffic ........................................95
Chapter6 DisplayOptions ..............................97
GeneralDisplayOptions ...........................................98
SettingColor,Formatting,andHidingOptions..........................99
SettingColorDisplayOptions ................................99
ChangingFieldFormats....................................100
HidingDisplayOptions ....................................101
LevelHidingOptions.............................................101
2
Merlin Mobile User’s ManualCATC SW Version 2.0
LevelHidingParameters....................................102
SavingDisplayOptions...........................................103
Chapter7 ReadingaCATCTrace.......................105
TraceViewFeatures .............................................105
InterpretingtheDisplayedInformation...............................105
Tooltips .......................................................106
SetMarker.....................................................106
EditorClearMarker .............................................107
ExpandedandCollapsedDataFormats...............................108
HideFrequencyHops.............................................110
HideNullsandPolls..............................................110
HideIDPackets.................................................111
HideVoice(SCO)Packets.........................................111
MenusinClickedFields...........................................111
HideUnassociatedTraffic.........................................111
Chapter8 DecodingProtocols...........................113
Introduction ....................................................113
LMPandL2CAPMessages........................................113
DecodingandViewingProtocolData................................114
DecodingViatheDecodingToolbar ..........................114
DecodingViatheDisplayOptionsDialogBox..................115
Tooltips .......................................................116
ViewingPacketsinLMPandL2CAPMessages........................116
TypesofLMPandL2CAPMessages ................................116
ViewingL2CAPChannelConnections...............................117
ViewingProtocolMessagesandTransactions..........................118
ViewingL2CAPMessagesinProtocolMessages................119
HowtoDecode...........................................119
ExpandingProtocolMessages ...............................119
ChangingProtocolAssignments ....................................120
UsingtheDecodingAssignmentsDialogBox...................120
RemovingUser-AssignedProtocolAssignments.................121
ManuallyAssigningProtocols ...............................122
OtherAssignments:OBEXClient/ServerStatus.................122
ChanginganOBEXClientorServerStatus.....................123
DecodingBNEP..........................................123
DecodingHID............................................123
OtherDecodingOptions....................................124
Chapter9 OtherFeatures..............................125
Search.........................................................125
GotoTrigger.............................................125
GotoPacket/Message/Protocol ..............................125
GotoMarker.............................................126
Goto...................................................127
3
Merlin Mobile User’s ManualCATC SW Version 2.0
Error ...................................................130
SoftBitError.............................................130
LossofSync.............................................130
Find....................................................130
Event Groups . . ..........................................132
Union,Intersection,andExclusion............................136
UsingFind...............................................136
FindNext ...............................................138
DeviceList.....................................................139
EditComment ..................................................140
ExportingData..................................................140
FileInformation.................................................141
ErrorSummary..................................................142
TimingCalculations..............................................142
BusUtilization..................................................143
TrafficSummary ................................................147
Encryption .....................................................147
ConfiguringMerlinMobileforEncryption .....................148
Chapter10 HowtoContactCATC.......................151
Chapter11 WarrantyandLicense.......................151
Index . . . . . . . . ........................................153
4
Merlin Mobile User’s ManualCATC SW Version 2.0
1. 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. Merlin Mobile non-intrusively monitors
piconet traffic and records and displays captured Bluetooth data.
Like its predecessor, the CATC Merlin™ Bluetooth Protocol Analyzer, Merlin
Mobile uses CATC's BusEngine™ technology, which incorporates a real-time
recording engine with programmable data, state, and error detection, and event
triggering, filtering, counting, and sequencing. This enables users to optimize
recording memory usage to capture the data that is most important.
The Merlin Mobile system consists of the analyzer hardware unit and the analyzer
software. The Merlin Mobile analyzer unit monitors and captures baseband packets
on a piconet in a non-intrusive manner. The packets can then be viewed and
decoded with the Merlin Mobile software. The software displays the piconet data in
CATC Trace™ format and is capable of decoding and organizing the data for these
Bluetooth protocol levels: Baseband, LMP, L2CAP, SDP, TCS, RFCOMM,
OBEX, AT, HDLC, PPP, BNEP, HID, AVCTP, AVDTP, IP, TCP, and UDP. In
addition, users can use the CATC Scripting Language (CSL) to create custom
decoders for specific development purposes.
The Merlin Mobile analyzer unit is configured and controlled by the analyzer
software. It can be used with portable computers for field service and maintenance,
as well as with desktop units in a development environment. Furthermore, Merlin
Mobile Automation™ and compatibility with the CATC Merlin's Wand™
Bluetooth Test Generator provide the capability for creating a fully-automated
testing environment.
The Merlin Mobile analyzer includes provisions for on-the-fly detection of, and
triggering on, numerous events. Such events include specific packet headers,
payload headers, data patterns, and many abnormal (error) traffic conditions.
Merlin Mobile continuously records the piconet data in a wrap-around fashion until
it is manually stopped or until the trigger event is detected. Upon detection of a
triggering event, the analyzer continues, as necessary, to record data until the
recording buffer is filled.
The Merlin Mobile application may be used with or without the analyzer box. When
used without the analyzer box, it functions as a CATC Trace™ viewer. As a Trace
viewer, it can be used to view, analyze and print CATC Trace files.
1
Merlin Mobile User’s ManualCATC SW Version 2.0
1.1 Bluetooth Specification
Please refer to the Bluetooth Specification, version 1.1, for details on the Bluetooth
wireless technology protocol. The Bluetooth Specification is available from the
Bluetooth SIG at its web site: http://www.bluetooth.org.
1.2 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
1.3 Merlin Mobile Specifications
Package
Dimensions: 5.3 x 2.1 x 0.4 inches
(135x54x5millimeters)
Weight: 2 ounces
(57 grams)
Hardware Interfaces
Connectors: Standard 16-bit Type II PC Card
Antenna: 2.4 gigahertz external (ISM band)
Power Consumption
Idle: 300 milliamps (typical)
Active: 350 milliamps (typical)
Environmental Conditions
Operating Range: 0 to 55 °C (32 to 131 °F)
Storage Range: -20 to 80 °C (-4 to 176 °F)
Humidity: 10 to 90%, non-condensing
Recording Memory Size
32 MB DRAM for traffic data capture
32 MB DRAM for timing, state & other data
Certification
Bluetooth version 1.1 qualified
Class 2 designation with +4dBm transmit power and <-70 receiver sensitivity
2
Merlin Mobile User’s ManualCATC SW Version 2.0
FCC and CE compliant
1.4 System Requirements
The following is the recommended configuration for the host machine that runs the
Merlin Mobile Analyzer application and is connected to the Merlin Mobile
Analyzer box.
• Operating system: Microsoft® Windows® 98 SE, Windows 2000, Windows
ME, or Windows XP operating system.
• Required setup: Microsoft Internet Explorer 4 or later must be installed.
• See readme.html for the latest system requirements.
1.5 Using Merlin Mobile with Merlin’s Wand
Merlin Mobile can be used in conjunction with the CATC Merlin's Wand™
Bluetooth Test Generator, which provides the ability to issue specific protocol
commands and test sequences on a piconet. Using Merlin Mobile and Merlin's
Wand together allows for real-time capturing of test sequence results as is required
by the Bluetooth SIG to provide evidence of product compliance to the
specification.
Merlin's Wand has built-in functionality for controlling Merlin Mobile. Through
Merlin's Wand, a Bluetooth recording session can be set up on Merlin Mobile, even
if the Merlin Mobile application runs on a remote computer.
For more information about using Merlin Mobile with Merlin's Wand, please
consult the Merlin's Wand documentation or contact CATC.
1.6 Merlin Mobile Automation
The Merlin Mobile software includes an Application Program Interface
(API) for developing testing programs and scripts in C++ and Visual Basic.
The API reproduces most of the commands embodied in the Merlin Mobile
trace viewer software. This API allows users to automate procedures that
otherwise have to be run manually via the trace viewer software. The
Automation API can be run locally on the PC attached to Merlin Mobile or
remotely over a network connection.
For further details, refer to the Automation API for CATC Bluetooth
Analyzers reference manual included in the installation CD-ROM. You can
also download the document from the CATC website.
3
1.7 HCI Trace
In addition to the ability to record Bluetooth traffic off-the-air, using the
analyzer's hardware and radio module, the Merlin can record serial
Bluetooth HCI traffic from Bluetooth devices, or 'IUT's (Implementations
Under Test).
While the off-the-air traffic is captured by the analyzers hardware, the HCI
Traffic from the IUTs is captured by the analyzer application using an HCI
probe (provided by CATC) that is connected directly to the IUT hardware.
In a typical setup, the HCI commands and data to transmit are passed from
the Bluetooth application to the Bluetooth baseband (Host to Controller),
while events and data that was received are passed from the Bluetooth
baseband to the Bluetooth application (Controller to Host).
To capture the data, the HCI Probe should be connected to the respective
'Host to Controller' and 'Controller to Host' lines. When the recording of the
IUT's HCI is enabled and the application starts a recording, the serial data is
captured as incoming serial data. For this, up to two COM ports should be
configured for each IUT.
Merlin Mobile User’s ManualCATC SW Version 2.0
1.8 Features of Merlin Mobile
• Sophisticated software analyzes all piconet traffic
• Identifies & highlights abnormal bus conditions
• Decodes Baseband packets and provides decoding for 12 additional
protocol levels
• Complies with Bluetooth v.1.1 specification
• 64 MB of physical data recording memory nets 32 MB of raw Bluetooth traffic
• Programmable real-time event triggering and traffic capture filtering
• CATC Trace graphical presentation of captured data with extensive customization options
• Adjustable recording size
• Adjustable trigger position
• Comprehensive search functions
• Accurate timestamping of packets
• Field upgradeable firmware and BusEngine™
• Software operates as a stand-alone Trace viewer
• Connects to the host computer through an available Type II PC Card slot
• One-year warranty and hotline customer support
• Traffic Generation
4
Traffic generation capability is provided by Merlin’s Wand.
• Bluetooth™ BusEngine
CATC’s BusEngine™ Technology is at the heart of the new Merlin Mobile
Analyzer. The revolutionary BusEngine core uses state-of-the-art EPLD
technology and incorporates both the real-time recording engine and the
configurable building blocks that implement data/state/error detection,
triggering, capture filtering, external signal monitoring and event counting
& sequencing. And like the flash-memory-based firmware that controls its
operation, all BusEngine logic is fully field upgradeable, using
configuration files that can be downloaded from the CATC Website.
Merlin Mobile User’s ManualCATC SW Version 2.0
5
Merlin Mobile User’s ManualCATC SW Version 2.0
6
Merlin Mobile User’s ManualCATC SW Version 2.0
2. Getting Started
This chapter describes how to install Merlin Mobile and its software, how to start
Merlin Mobile, and how to set up the analyzer unit.
2.1 Installing Merlin Mobile
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.
Software Installation
The Merlin Mobile software can be installed from the installation CD-ROM or from
installation files downloaded from the CATC website.
Install from CD-ROM
Step 1 Insert the Merlin Mobile installation CD-ROM into the
CD-ROM drive of the computer that will be connected to the
Merlin Mobile analyzer unit.
The autorun program should start automatically. If it doesn’t
start, use Windows Explorer or My Computer to navigate to the
CD-ROM drive directory, double-click the file autorun.exe,
and proceed to Step 2. If it still doesn’t start, navigate to the
\Software directory on the CD-ROM, double-click the file
Setup.exe,andproceedtoStep3.
Step 2 Choose Install Software to start the setup program.
Step 3 Follow the on-screen instructions to complete the installation.
Install from installation download
Step 1 Select Start > Run... from the Windows taskbar and click the
Browse button, then navigate to the Disk 1 directory of the
Merlin Mobile installation download. Select the file Setup.exe
andclickOpen.
Step 2 Follow the on-screen instructions to complete the installation.
2.2 Hardware Installation
Step 1 Insert the Merlin Mobile analyzer unit into the PC Card slot on
the desktop or laptop computer that will be running the Merlin
Mobile software.
7
Merlin Mobile User’s ManualCATC SW Version 2.0
Step 2 The New Hardware Wizard will automatically detect Merlin
Mobile and will guide you through the rest of the installation.
2.3 Starting and Stopping Merlin Mobile
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.
Exiting the Application
Any of the following actions will close the Merlin Mobile application:
• Clickonthe‘X’ in the upper right corner of the application window.
• Select File > Exit from the menu bar.
•PressAlt + F4.
• Double-click the Merlin Mobile control icon in the upper left corner of the
application window.
• Click the Merlin Mobile control icon to access the Control menu and choose
Close.
Starting the Analyzer Unit
The Merlin Mobile analyzer unit is powered on whenever it is connected to the host
computer via the PC Card slot and the host computer is on. The analyzer will
initialize itself and perform an exhaustive self-diagnostic test that lasts about five
seconds.
Shutting Down the Analyzer Unit
On Windows 98 SE and Windows Me
• Shut down the Merlin Mobile unit by removing it from the PC Card slot or by
shutting down the host computer.
On Windows 2000 and Windows XP
• Shut down the Merlin Mobile unit by shutting down the host computer.
-OR-
• Use the Add/Remove Hardware Wizard to stop Merlin Mobile so that it may
safely be removed from the PC Card slot.
8
Merlin Mobile User’s ManualCATC SW Version 2.0
2.4 Displaying Help
The Merlin Mobile application has a Help file that is useful as an on-screen
reference. Access the Help file by choosing Help > Help Topics... from the menu
bar.
2.5 Updating the BusEngine and Firmware
The BusEngine core is the heart of the Merlin Mobile 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. 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 with the software. They
are also updated anytime that the driver is updated.
2.6 Updating the Driver
The driver, BusEngine, and firmware are all automatically updated when the Merlin
Mobile software is installed or upgraded.
To find out the current driver version number, please consult Merlin Mobile’s
Readme file.
The driver may also be manually updated. The steps below explain how to manually
update the driver.
Note: The Merlin Mobile analyzer unit must be attached to the computer via the PC Card slot before
updating the driver.
Updating the Driver on Windows 2000
Step 1 Select Start > Settings > Control Panel from the desktop taskbar,
then double-click on Add/Remove Hardware in the Control
Panel window.
The Add/Remove Hardware Wizard will open.
Step 2 Click Next.
Step 3 Choose “Uninstall/Unplug a device” and click Next.
Step 4 Choose “Unplug/Eject a device” and click Next.
Step 5 Select CATC Merlin Mobile Bluetooth Protocol Analyzer from
the list of devices and click the Properties button.
The Properties window will open.
9
Merlin Mobile User’s ManualCATC SW Version 2.0
Step 6 Select the Driver tab in the Properties window and click Update
Driver.
The Upgrade Device Driver Wizard will open.
Step 7 Click Next.
Step 8 Choose “Display a list of the known drivers for this device so
that I can choose a specific driver.” Then, click Next.
Step 9 Choose “Have disk” and click Next.
The Install from Disk window will open.
Step 10 Install from the Merlin Mobile installation CD-ROM:
Make sure that the installation CD is in the computer’s
CD-ROM drive, then click Browse and navigate to the \Software
directory on the CD, or type the drive letter followed by
\Software (e.g., “D:\Software”) in the combo box. Click OK.
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.
Step 11 Select CATC Merlin Mobile Bluetooth Protocol Analyzer from
the list of devices in the Upgrade Device Driver Wizard and
click Next.
Step 12 Click Next to install the driver.
Step 13 Click Finish to close the Wizard.
Step 14 Check the driver version on the Driver tab of the Properties
window to make sure that the driver was successfully upgraded.
Step 15 Close the remaining open windows.
Updating the Driver on Windows 98 SE
Step 1 Select Start > Settings > Control Panel from the desktop taskbar,
then double-click on System Properties in the Control Panel
window.
The System Properties window will open.
Step 2 Select the Device Manager tab.
Step 3 Look in the CATC Analyzers directory and select CATC Merlin
Mobile Bluetooth Protocol Analyzer.
or
Look in the Universal Serial Bus Controllers directory and select
CATC Merlin Mobile Bluetooth Protocol Analyzer.
Step 4 Click the Properties button.
The Properties window will open.
10
Merlin Mobile User’s ManualCATC SW Version 2.0
Step 5 Select the Driver tab and click on the Update Driver button.
The Update Device Driver Wizard will open.
Step 6 Click Next.
Step 7 Choose “Search for a better driver than the one your device is
using now.” and click Next.
Step 8 Enter or browse to the location of the driver and click Next.
Step 9 Click Next to install the driver.
Note: If a message appears saying that Windows cannot locate the driver,
click OK to close the message box and then enter or browse to the
location of the driver to continue.
Step 10 Click Finish.
Step 11 Click the Driver File Details button to check the driver version
and make sure that the driver was successfully upgraded.
Step 12 Close the remaining open windows.
Updating the Driver on Windows Me
Step 1 Select Start > Settings > Control Panel from the desktop taskbar,
then double-click on System Properties in the Control Panel
window.
The System Properties window will open.
Step 2 Select the Device Manager tab.
Step 3 Look in the CATC Analyzers directory and select CATC Merlin
Mobile Bluetooth Protocol Analyzer.
or
Look in the Universal Serial Bus Controllers directory and select
CATC Merlin Mobile Bluetooth Protocol Analyzer.
Step 4 Click the Properties button.
The Properties window will open.
Step 5 Select the Driver tab and click on the Update Driver button.
The Update Device Driver Wizard will open.
Step 6 Choose “Automatically search for a better driver.” and click
Next.
The Select Other Driver window will open.
Step 7 Select the newest driver and click OK.
The driver will install.
Step 8 Click Finish.
Step 9 Click the Driver File Details button to check the driver version
and make sure that the driver was successfully upgraded.
11
Merlin Mobile User’s ManualCATC SW Version 2.0
Step 10 Close the remaining open windows.
Updating the Driver on Windows XP
Step 1 Select Start > Control Panel from the desktop taskbar, then
double-click Performance and Maintenance.
Step 2 Double-click on System.
The System Properties window will open.
Step 3 Select the Hardware tab and click the Device Manager button.
The Device Manager window will open.
Step 4 Look in the CATC Analyzers directory and select CATC Merlin
Mobile Bluetooth Protocol Analyzer.
or
Look in the Universal Serial Bus Controllers directory and select
CATC Merlin Mobile Bluetooth Protocol Analyzer.
Step 5 Select Action > Update Driver... from the Device Manager menu
bar.
The Hardware Update Wizard will open.
Step 6 Choose “Install from a list or specific location.”
Step 7 Choose “Don’t search” then click Have Disk.
Step 8 Enter or browse to the location of the driver and click OK.
Step 9 Select CATC Merlin Mobile Bluetooth Protocol Analyzer from
the list and click Next.
The driver will install.
Step 10 Click Finish.
Step 11 Select Action > Properties from the Device Manager menu bar
to check the driver version and make sure that the driver was
successfully upgraded.
Step 12 Close the remaining open windows.
2.7 License Keys
A License Key is necessary to enable software maintenance in Merlin Mobile.
License Keys must be obtained from CATC.
Update License
Follow these steps to install a license key:
Step 1 Select Help > Update License… from the menu bar.
The Update License dialog will come up.
12
Merlin Mobile User’s ManualCATC SW Version 2.0
Step 2 Enter the path and filename for the License Key or use the
Browse button to navigate to the directory that contains the
License Key. Select the .lic file, and then click Update Device.
License Information
Licensing information for Merlin Mobile may be viewed by selecting Help >
Display License Information... from the menu bar. The License Information
window will open, displaying the maintenance expiration and features data for
Merlin Mobile.
2.8 Installing the HCI Probe
If you are planning to record HCI traffic, you will need to install an HCI
probe.
The HCI Probe allows you to connect the analyzer software to a single IUT.
If more IUTs are to be monitored (up to three) additional HCI Probes should
be used.
The probe is composed of the following components:
[a] HCITrace Probe Cable
[b] HCITrace RS232 Cable
[c] TTL to RS232 converter
[d] 2-port RS232 to USB converter
[e] USB cable
13
HCITrace Probe Cable
The HCITrace Probe Cable has three probes:
‘Gnd’ – Should be connected to the reference/ground wire
•
• ‘Host’ – Should be connected to the wire that carries the down-link traffic from
the host to the controller.
• ‘BTC’– Should be connected to the wire that carries the up-link traffic from
the controller to the host.
HCITrace RS232 Cable
Has three DB-9 connectors:
•
RS-232/Probe - Should be connected to the HCITrace Probe Cable or to the
TTL to RS232 converter (depending whether the signal voltage in the IUT is
TTL or RS-232).
• COM A - Should be connected to one of the serial inputs of the 2-port RS232
to USB converter.
• COM B - Should be connected to one of the other serial input of the 2-port
RS232 to USB converter.
Merlin Mobile User’s ManualCATC SW Version 2.0
TTL to RS232 converter
Should be used only when the signal voltage in the IUT is TTL and not
RS-232.
The DB-9 connector marked with ‘TTL’ should be connected to the
HCITrace Probe Cable.
The DB-9 connector marked with ‘RS-232’ should be connected to the
'RS-232'/Probe connector of the HCITrace RS232 Cable.
2-port RS232 to USB converter -
This converter is used so the serial signals can be delivered to the host
machine through a USB input.
USB cable –
Connects the 2-port RS232 to USB converter to the Host machine USB
port.
HCI Probe configurations
The HCI Probe can be used in two configurations:
•
For monitoring UART level signals
• For monitoring RS232 level signals
14
Merlin Mobile User’s ManualCATC SW Version 2.0
Monitoring UART Level Signals
For monitoring RS232 level signals, the TTL to RS-232 converter should be
used. To assemble the HCI probe for this configuration, perform the
following steps. Refer to the photo and component list shown previously
for references to components [a] through [e].
Step 1 Connect the DB-9 connector of the HCITrace Probe Cable [a] to
the connector marked with ‘TTL’ in the TTL to RS-232
converter [c].
Step 2 Connect the DB-9 connector marked with ‘RS-232’ in the TTL
to RS-232 converter [c] to the connector marked with
‘'RS-232/Probe’’ in the HCITrace RS-232 Cable [b].
Step 3 Connect the connector marked with ‘COM A’ in the HCITrace
RS-232 Cable [b] to ‘Connector A’ in the 2-port RS232 to USB
converter [d].
Step 4 Connect the connector marked with ‘COM B’ in the HCITrace
RS-232 Cable [b] to ‘Connector B’ in the 2-port RS232 to USB
converter [d].
Step 5 Connect the USB cable to the USB connector of the 2-port
RS232 to USB converter [e].
Monitoring RS232 level Signals
Legend for photo:
[a] HCI Probe Cable
[b] HCI Trace RS-232 Cable
15
Merlin Mobile User’s ManualCATC SW Version 2.0
[c] Connectors A and B on the other end of the HCI Trace RS-232
Cable
[d] Two-Port RS-232 to USB Converter
For monitoring RS232 level signals do not use the converter. To assemble
the HCI probe for this configuration, perform the following steps:
Step 1 Connect the DB-9 connector of the HCITrace Probe Cable [a] to
the connector marked with ‘'RS-232/Probe’’ in the HCITrace
RS-232 Cable [b].
Step 2 Connect the connector marked with ‘COM A’ in the HCITrace
RS-232 Cable [c] to ‘Connector A’ in the 2-port RS232 to USB
converter [d].
Step 3 Connect the connector marked with ‘COM B’ in the
HCITrace RS-232 Cable [c] to ‘Connector B’ in the 2-port
RS232 to USB converter [d].
Step 4 Connect the USB cable [not shown] to the USB connector of the
2-port RS232 to USB converter [d].
2-port RS232 to USB converter
The 2-port RS232 to USB converter [d] allows the user to connect two serial
connectors to the host machine via a single USB connection. When
connected to the host machine the converter emulates two separate virtual
COM ports that can be used as other real COM ports. Prior of using this
converter as part of the HCI probe several drivers need to be installed. The
drivers are provided on the installation CD-ROM in the HCI Probe\Drivers
sub directory.
Once the converter is connected to a host machine the user is prompted to
provide the place where the system can install the drivers from.
16
Merlin Mobile User’s ManualCATC SW Version 2.0
After installing the drivers two new COM ports are going to be available, as
seen in the following snapshot of the Device Manager.
2.9 Your First Bluetooth Recording
After installing and launching the software, you can test Merlin Mobile by
synchronizing to a piconet and then recording the traffic. In this inquiry test,
Merlin Mobile will issue a General Inquiry that asks local devices to
identify themselves. Merlin Mobile then records the responses.
Step 1 Click the down-arrow on the Record button
and select Piconet.
Step 2 From the menu, select Record > Recording Options.
The following dialog box will open showing factory default
settings. Merlin defaults to “Page Sync & Record." This setting
tells Merlin Mobile to
perform a General Inquiry and then collect sync
17
Merlin Mobile User’s ManualCATC SW Version 2.0
information from the specified slave device when the slave responds. Merlin Mobile
then waits for the Master to begin paging the Slave devices. When paging begins,
Merlin Mobile synchronizes to the Master and begins recording.
Step 3 Select the General tab.
The Recording Options dialog box opens showing factory
default settings such as “manual trigger” and 8 MB buffer size.
For the General Inquiry recording you are about to create, leave
these settings unchanged.
18
Merlin Mobile User’s ManualCATC SW Version 2.0
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.
19
Merlin Mobile User’s ManualCATC SW Version 2.0
Step 4 Click OK to close the Recording Options window and activate
the recording options you selected.
At this point, Merlin Mobile will be ready to record.
Inquiry Recording
Merlin Mobile can also record an inquiry process where the Merlin Mobile
performs a general inquiry and asks local devices to identify themselves.
Step 1 Click the down-arrow on the right side of the Record:Piconet
button on the toolbar .
A sub-menu appears with options for Piconet Recording Mode,
and Inquiry Recording Mode.
Step 2 Select Inquiry Recording Mode.
The button changes appearance and shows the label Record:
Inquiry
Step 3 From the menu, select Setup > Recording Options.
The Recording Options dialog opens with the Inquiry page
displaying.
Step 4 If desired, make any changes to the options, then click OK.
Step 5 Click the button (i.e. the button itself, and not
the down-arrow.)
20
Merlin Mobile User’s ManualCATC SW Version 2.0
Merlin Mobile starts to record the Bluetooth traffic immediately
using the settings from the Piconet page in the Recording
Options dialog. The Bluetooth Inquiry process will proceed for
whatever amount of time is set for creating an Inquiry action (0
to 80 seconds). After the inquiry time has elapsed, the analyzer
will uploads the data and displays the packets.
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.tfb or whatever name you
assign as the default filename. While the file is being saved, you
should see a brown progress bar at the bottom of the screen.
When the bar turns white, it indicates that the data has been
savedtodisk.
Step 6 To save a current recording for future reference, Select Save As
under File on the Menu Bar.
OR
Click on the Tool Bar.
You see the standard Save As screen.
21
Merlin Mobile User’s ManualCATC SW Version 2.0
Step 7 Give the recording a unique name and save it to the appropriate
directory.
22
Loading...