Teledyne Merlins Wand User Manual
2403 Walsh Avenue, Santa Clara, CA 95051-1302 Tel: +1/408.727.6600 Fax: +1/408.727.6622
CATC Merlin’s Wand
™
Bluetooth
Test Generator
User’s Manual
™
2.00
Document Revision 2.00
May 15, 2003
730-0019-00
CATC MERLIN’S WAND 2.00
User’s Manual
CATC Merlin’s Wand 2.00 Bluetooth Test Generator
User’s Manual, Document Revision 2.00
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’s Wand, Merlin, Merlin Mobile, BTTracer, BTTrainer, and
Merlin are trademarks of Computer Access Technology Corporation.
Bluetooth is a trademark owned by Bluetooth SIG, Inc. and is used by
Computer Access Technology Corporation under license.
Microsoft, Windows,andWindows NT are either registered trademarks or
trademarks of Microsoft Corporation in the United States and/or other
countries.
RadioShack is a registered trademark of RadioShack Corporation.
GN Netcom is a registered trademark of GN Netcom, Inc.
Motorola is a registered trademark of Motorola, Inc.
Belkin is a registered trademark of Belkin Components.
Coby is a registered trademark of Coby Electronics Corporation.
Plantronics is a registered trademark of Plantronics, Inc.
Intel, Pentium,andCeleron are trademarks or registered trademarks of Intel
Corporation or its subsidiaries in the United States and other countries.
AMD, Athlon, Duron,andAMD-K6 are trademarks of Advanced Micro
Devices, Inc.
All other trademarks are property of their respective companies.
Copyright
Copyright 2003, Computer Access Technology Corporation (CATC). All
rights reserved.
This document may be printed and reproduced without additional
permission, but all copies should contain this copyright notice.
ii
Part number: 730-0019-00
CATC MERLIN’S WAND 2.00
User’s Manual
Merlin’s Wand Conformance Statements
FCC Conformance Statement
This equipment has been tested and found to comply with the limits for both
a Class A and Class B digital device, 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 or residential
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. The end user of this product should be aware that any
changes or modifications made to this equipment without the approval of
CATC could result in the product not meeting the Class A or Class B limits,
in which case the FCC could void the user's authority to operate the
equipment.
Important Notice
This equipment contains Transmitter Module FCC ID PNI8001001. 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 centimeters away from all persons.
EU Conformance Statement
This equipment complies with the R&TT Directive 1999/5/EC. It has been
tested and found to comply with EN55022:1998 Class B
(EN61000-3-2:1998, EN61000-3-3:1995), EN55024:1998
(EN61000-4-2:1995, EN61000-4-3:1995, EN61000-4-4:1995,
EN61000-4-5:1995, EN61000-4-6:1995, EN61000-4-11:1994), and
EN60950:1999. The transmitter module was tested and found to comply
with ETS 300 328 (1997).
iii
CATC MERLIN’S WAND 2.00
User’s Manual
iv
CATC MERLIN’S WAND 2.00
User’s Manual -
TABLE OF CONTENTS
DocumentDisclaimer................................ii
TrademarksandServicemarks .........................ii
Copyright .........................................ii
FCCConformanceStatement......................... iii
ImportantNotice................................ iii
EUConformanceStatement.......................... iii
Chapter1 Overview.....................................1
Applications .......................................1
Merlin’sWandUserInterface..........................2
KeyFeatures.......................................3
Audio Connections - Important Information ..............4
Limitations ........................................5
Specifications ......................................6
Chapter2 GettingStarted................................7
SystemRequirements................................7
SettingUpMerlin’sWand ............................7
InstallingtheSoftwareandStartingtheProgram...........8
InstallfromCD-ROM.............................8
Installfrominstallationdownload ...................8
Starttheprogram.................................8
DisplayingtheOn-ScreenHelp ........................9
Application Layout . .................................9
Menus...........................................12
Toolbars..........................................13
Standard ......................................13
ToolsandModes ...............................14
Merlin/MerlinMobileAnalyzerToolbar .............14
ToolTips.........................................14
Merlin’s Wand Keyboard Shortcuts ....................15
Chapter3 ProfileWizard...............................17
StartingProfileWizard..............................17
Connecting to Devices ..............................17
Connect to Device: Dial-Up Gateway ...............19
Connect to Device: Fax Gateway ...................21
Connect to Device: File Transfer ...................22
Connect to Device: HCRP Server...................23
Connect to Device: Headset .......................24
Connect to Device: Headset Audio Gateway ..........25
Connect to Device: LAN .........................26
Connect to Device: Object Push ....................26
v
CATC MERLIN’S WAND 2.00
User’s Manual -
Connect to Device: PAN–GN ......................27
Connect to Device: PAN–NAP .....................28
Connect to Device: Serial Port .....................29
EmulatingDevices .................................30
EmulateDevice:Dial-UpGateway .................31
EmulateDevice:FaxGateway.....................32
EmulateDevice:FileTransfer .....................33
EmulateDevice:HCRPServer.....................33
EmulateDevice:Headset.........................34
EmulateDevice:LAN ...........................35
EmulateDevice: ObjectPush .....................36
EmulateDevice:PAN-GN.......................36
EmulateDevice:PAN-NAP......................37
EmulateDevice:SerialPort.......................38
RestartingtheWizard...............................39
InstallingtheVirtualCOMPortDriver .................39
On Windows 2000 ..............................39
InstallaModemDriverontheVirtualCOMPort .........40
InstallationofNetworkDriver........................41
VerifyingtheDriver’sInstallation ..................42
ConfigurationofVirtualNIC......................42
Chapter 4 Command Generator . . . . . . . ..................43
Layout of the Command Generator ....................43
UsingCommandGenerator ..........................44
CustomizingtheListofHCICommands.............45
TablesofAvailableCommands .......................46
HCICommands ...................................46
LinkControlCommands .........................46
LinkPolicyCommands ..........................48
HostController&BasebandCommands.............48
InformationalCommands.........................50
StatusCommands...............................50
TestingCommands..............................51
CATC-SpecificCommands........................51
L2CAPCommands.................................52
SDPCommands ...................................52
RFCOMMCommands..............................53
TCSCommands ...................................54
OBEXCommands .................................54
Chapter5 ScriptManager ..............................55
Layout of the Script Manager Window..................55
Menubar ......................................55
vi
CATC MERLIN’S WAND 2.00
User’s Manual -
Toolbar .......................................55
Running Scripts....................................57
Writing Scripts ....................................58
ScriptAssistant....................................59
SampleScripts ....................................59
Chapter 6 Device Search and Device List Pop-Up Menu . . . . . 61
DeviceSearch.....................................61
DeviceListPop-UpMenu ...........................62
CreateanACLConnection........................62
Establish an Audio Connection.....................63
DisplayDeviceInformation.......................64
DeleteaDevice.................................65
Disconnect All . ................................66
Chapter7 DataTransferManagerandDataPipes..........67
CreatingDataPipes ................................67
UsingDataPipes...................................68
TransferDataUsingCommandGenerator............69
AccessPipesUsingScriptManager.................70
ReceivePipes .....................................70
ClosingPipes .....................................71
SavingDataPipes..................................71
SavingDataTransmitPipeLists....................72
SavingaDefaultList ............................72
SavingDataReceivePipes........................72
DeletingPipes.....................................72
OpeningPipeLists .................................73
RenamingPipes ...................................73
ModifyingPipes...................................74
Chapter 8 Using Merlin to Record Merlin’s Wand Traffic . . . . 75
SetUpaRemoteMachine ...........................75
Windows 98/Me Operating Systems.................75
Windows NT®/2000 Operating Systems .............76
Set Up Connection Options ..........................78
StartMerlin.......................................79
Connect to Merlin with Merlin’s Wand .................79
SetMerlinRecordingOptions ........................79
SetMerlinDisplayOptions ..........................81
SetMerlinEncryptionOptions........................82
StartaMerlinRecordingSession......................83
StopaMerlinRecordingSession......................83
Disconnect from Merlin Bluetooth Protocol Analyzer......83
vii
CATC MERLIN’S WAND 2.00
User’s Manual -
Troubleshooting . . . ................................83
“ServerBusy”WhenAttemptingtoLaunchMerlin ....83
“Server Execution Failed” When Attempting to Launch
Merlin........................................84
“The Object Exporter Specified Was Not Found” When
AttemptingtoLaunchMerlin......................84
Chapter9 ContactandWarrantyInformation .............85
ContactInformation................................85
WarrantyandLicense...............................85
Appendix A: Command Generator Command Descriptions. . . . 87
HCICommandDescriptions..........................87
HCILinkControlCommands.........................87
Accept_Connection_Request ......................87
Add_SCO_Connection ...........................87
Authentication_Requested ........................88
Change_Connection_Link_Key ....................88
Change_Connection_Packet_Type ..................88
Create_Connection ..............................89
Disconnect ....................................89
Exit_Periodic_Inquiry_Mode ......................89
Inquiry........................................90
Inquiry_Cancel . ................................90
Periodic_Inquiry_Mode ..........................90
PIN_Code_Request_Negative_Reply................91
PIN_Code_Request_Reply........................91
Read_Clock_Offset..............................91
PIN_Code_Request_Negative_Reply................91
PIN_Code_Request_Reply........................91
Read_Clock_Offset..............................91
Read_Remote_Supported_Features .................92
Read_Remote_Version_Information ................92
Reject_Connection_Request.......................92
Remote_Name_Request..........................92
Set_Connection_Encryption .......................93
HCILinkPolicyCommands..........................94
Exit_Park_Mode................................94
Exit_Sniff_Mode................................94
Hold_Mode....................................94
Park_Mode....................................94
QoS_Setup ....................................95
Read_Link_Policy_Settings .......................95
Role_Discovery ................................95
viii
CATC MERLIN’S WAND 2.00
User’s Manual -
Sniff_Mode....................................96
Switch_Role ...................................96
Write_Link_Policy_Settings.......................96
HCIHostController&BasebandCommands............97
Change_Local_Name............................97
Delete_Stored_Link_Key .........................97
Host_Buffer_Size...............................98
Read_Authentication_Enable ......................98
Read_Class_of_Device...........................98
Read_Connection_Accept_Timeout.................99
Read_Current_IAC_LAP.........................99
Read_Encryption_Mode ..........................99
Read_Link_Supervision_Timeout .................100
Read_Local_Name.............................100
Read_Number_Of_Supported_IAC ................100
Read_Page_Scan_Mode.........................100
Read_Page_Scan_Period_Mode...................101
Read_Page_Timeout............................101
Read_PIN_Type...............................101
Read_Scan_Enable.............................102
Read_SCO_Flow_Control_Enable.................102
Read_Stored_Link_Key .........................102
Read_Voice_Setting ............................103
Reset........................................103
Set_Event_Filter ...............................103
Set_Event_Mask...............................104
Write_Authentication_Enable.....................105
Write_Class_of_Device .........................105
Write_Connection_Accept_Timeout ...............106
Write_Current_IAC_LAP........................106
Write_Encryption_Mode ........................107
Write_Link_Supervision_Timeout .................107
Write_Page_Timeout ...........................108
Write_PIN_Type...............................108
Write_Scan_Enable.............................109
Write_Stored_Link_Key .........................109
Write_Voice_Setting............................109
HCIInformationalCommands.......................110
Read_BD_ADDR ..............................110
Read_Buffer_Size..............................110
Read_Country_Code............................110
Read_Local_Supported_Features .................. 111
Read_Local_Version_Information .................111
ix
CATC MERLIN’S WAND 2.00
User’s Manual -
HCITestingCommands............................ 111
Enable_Device_Under_Test_Mode ................111
Read_Loopback_Mode..........................112
Write_Loopback_Mode .........................112
CATC-SpecificHCICommands......................112
CATC_BER_Test ..............................112
CATC_Change_Headset_Gain....................113
CATC_Read_Headset_Gain......................113
CATC_Read_PIN_Response_Enable...............114
CATC_Read_Revision_Information................114
CATC_Self_Test...............................114
CATC_Set_Default_PIN_Code ...................114
CATC_Write_PIN_Response_Enable ..............115
OtherHCIEvents.................................115
L2CAPCommandDescriptions......................115
ConfigurationResponse..........................115
ConfigurationRequest...........................116
ConnectRequest ...............................116
ConnectResponse ..............................116
DeregisterPsm.................................117
DisconnectRequest .............................117
EchoRequest..................................117
InfoRequest...................................117
RegisterPsm ..................................118
SendData.....................................118
OtherL2CAPEvents ..............................118
SDPCommandDescriptions ........................119
AddProfileServiceRecord........................119
AddServiceRecord .............................119
ProfileServiceSearch............................120
RequestServiceAttribute.........................121
RequestServiceSearch...........................121
RequestServiceSearchAttribute ...................122
ResetDatabase.................................122
RFCOMMCommandDescriptions ...................122
AcceptChannel................................122
AcceptPortSettings.............................123
AdvanceCredit ................................123
CloseClientChannel ............................123
CreditFlowEnabled.............................124
DeregisterServerChannel ........................124
OpenClientChannel.............................124
RegisterServerChannel..........................125
x
CATC MERLIN’S WAND 2.00
User’s Manual -
RequestPortSettings ............................125
RequestPortStatus..............................126
SendData.....................................126
SendTest .....................................126
SetLineStatus .................................127
SetModemStatus...............................127
SendATCommand..............................128
OtherRFCOMMEvents ...........................128
TCSCommandDescriptions ........................129
RegisterIntercomProfile.........................129
Open_TCS_Channel............................129
Start_TCS_Call................................129
Disconnect_TCS_Call ..........................130
Send_Info_Message ............................130
OBEXCommandDescriptions.......................130
ClientAbort...................................130
ClientConnect . . ...............................131
ClientDisconnect...............................131
ClientGet.....................................131
ClientPut.....................................131
ClientSetPath .................................132
ServerDeinit ..................................132
ServerInit ....................................132
ServerSetPath.................................133
BNEPCommandDescriptions.......................134
Accept.......................................134
Open........................................134
Close........................................134
SetUpConnectionReq ...........................134
SentPKT.....................................134
SendControlPKT...............................134
RegisterBNEP.................................134
DeregisterBNEP...............................135
SetControlTimeout.............................135
Appendix B: Command Generator Examples. . . . . . . . .......137
DeviceDiscoveryandRemoteNameRequest...........138
Procedure ....................................138
EstablishBasebandConnection......................139
Procedure ....................................139
BasebandDisconnection............................140
Procedure ....................................140
Create Audio Connection ...........................141
Procedure ....................................141
xi
CATC MERLIN’S WAND 2.00
User’s Manual -
L2CAP Connection. ...............................142
Procedure ....................................142
L2CAPChannelDisconnect.........................144
Procedure ....................................144
SDPProfileServiceSearch .........................145
Procedure ....................................145
SDPResetDatabaseandAddProfileServiceRecord.....146
Procedure ....................................146
RFCOMMClientChannelEstablishment ..............147
Procedure ....................................147
RFCOMM Client Channel Disconnection ..............148
Procedure ....................................148
RFCOMMRegisterServerChannel...................149
Procedure ....................................149
Establish TCS Connection ..........................150
Procedure ....................................150
OBEXServerInit.................................152
Procedure ....................................152
OBEX Client Connection and Client Get & Put..........153
Procedure ....................................153
Appendix C: Merlin’s Wand Scripting Commands . . . .......155
BluetoothAddresses ..............................155
BasicCommands.................................155
Main() ......................................155
Clock() ......................................156
Connect() ....................................156
Disconnect() . . . ...............................157
DoInquiry() . . . ...............................157
GetDeviceClass() ..............................158
GetRemoteDeviceName() .......................158
MessageBox() ................................159
SetDeviceClass() ..............................159
Sleep() ......................................160
PipeCommands..................................160
ClosePipe()...................................160
DeletePipe() ..................................161
OpenPipe() ...................................161
ReadPipe() ...................................162
WritePipe()...................................163
HCICommands..................................164
HCIAcceptConnectionRequest() ..................164
HCIAddSCOConnection() .......................164
HCIAuthenticationRequested() ...................165
xii
CATC MERLIN’S WAND 2.00
User’s Manual -
HCICatcBerTest() .............................165
HCICatcChangeHeadsetGain() ...................166
HCICatcReadHeadsetGain() .....................168
CATC_Read_PIN_Response_Enable() .............168
HCICatcReadRevisionInformation() ...............169
HCICatcSelfTest() .............................169
HCIChangeConnectionLinkKey() .................170
HCIChangeConnectionPacketType() ...............171
HCIChangeLocalName() ........................172
HCIDeleteStoredLinkKey() ......................172
HCIEnableDeviceUnderTestMode() ...............173
HCIExitParkMode()............................173
HCIExitSniffMode() ...........................174
HCIHoldMode()...............................175
HCIMasterLinkKey()...........................175
HCIParkMode() ...............................176
HCIPINCodeRequestNegativeReply() .............177
HCIPINCodeRequestReply().....................178
HCIQoSSetup() ...............................178
HCIReadAuthenticationEnable()..................180
HCIReadBDADDR() ...........................180
HCIReadBufferSize() ..........................181
HCIReadClockOffset() .........................182
HCIReadConnectionAcceptTimeout() ..............183
HCIReadCountryCode() ........................184
HCIReadCurrentIACLAP() ......................184
HCIReadEncryptionMode()......................185
HCIReadLinkPolicySettings() ....................186
HCIReadLinkSupervisionTimeout() ...............187
HCIReadLocalName() ..........................187
HCIReadLocalSupportedFeatures() ................188
HCIReadLocalVersionInformation() ...............189
HCIReadLoopbackMode() ......................190
HCIReadNumberOfSupportedIAC() ...............190
HCIReadPageScanMode() .......................191
HCIReadPageScanPeriodMode() .................192
HCIReadPageTimeout() ........................192
HCIReadPINType() ............................193
HCIReadRemoteSupportedFeatures() ..............194
HCIReadRemoteVersionInformation() .............195
HCIReadScanEnable()..........................196
HCIReadSCOFlowControlEnable() ...............196
HCIReadStoredLinkKey() .......................197
xiii
CATC MERLIN’S WAND 2.00
User’s Manual -
HCIReadVoiceSetting() .........................198
HCIRejectConnectionRequest() ..................199
HCIRemoveSCOConnection() ...................199
HCIReset() ...................................200
HCIRoleDiscovery() ...........................200
HCISetConnectionEncryption() ...................201
HCISetEventFilter() ............................202
HCISniffMode()...............................203
HCISwitchRole() ..............................204
HCIWriteAuthenticationEnable() .................204
HCIWriteConnectionAcceptTimeout() .............205
HCIWriteCurrentIACLAP() .....................205
HCIWriteEncryptionMode() .....................206
HCIWriteLinkPolicySettings() ...................207
HCIWriteLinkSupervisionTimeout()...............208
HCIWriteLoopbackMode() ......................209
HCIWritePageTimeout() ........................209
HCIWritePINType()............................210
HCIWriteScanEnable() .........................210
HCIWriteStoredLinkKey() ......................211
HCIWriteVoiceSettings() ........................212
OBEXCommands................................212
OBEXClientAbort()............................212
OBEXClientConnect() ..........................213
OBEXClientDeinit() ...........................213
OBEXClientDisconnect() .......................214
OBEXClientGet() .............................214
OBEXClientInit()..............................216
OBEXClientPut() ..............................216
OBEXClientSetPath() ..........................217
OBEXServerDeinit() ...........................219
OBEXServerSetPath(Path) ......................219
RFCOMMCommands.............................220
RFCloseClientChannel() ........................220
RFOpenClientChannel() ........................221
RFRegisterServerChannel()......................221
RFSendData() ................................222
RFSendDataFromPipe().........................223
RFReceiveData() ..............................223
RFWaitForConnection() ........................224
RFAcceptChannel() ............................225
RFAcceptPortSettings() .........................226
RFCreditFlowEnabled().........................226
xiv
CATC MERLIN’S WAND 2.00
User’s Manual -
RFRequestPortSettings() ........................227
RFRequestPortStatus()..........................229
RFSetLineStatus() .............................230
RFSetModemStatus()...........................231
RFSendTest() .................................232
RFAdvanceCredit() ............................232
TCSCommands ..................................233
TCSRegisterProfile() ...........................233
TCSOpenChannel() ............................234
TCSStartCall() ................................234
TCSDisconnectCall() ...........................235
TCSSendInfoMessage().........................235
L2CAPCommands ...............................237
L2CAPConfigurationRequest() ...................237
L2CAPConfigurationResponse() ..................239
L2CAPConnectRequest() .......................239
L2CAPConnectResponse() ......................240
L2CAPDeregisterAllPsm() ......................241
L2CAPDisconnectRequest() .....................241
L2CAPEchoRequest() ..........................242
L2CAPReceiveData() ..........................243
L2CAPInfoRequest() ...........................243
L2CAPRegisterPsm() ..........................244
L2CAPSendData() .............................245
L2CAPSendDataFromPipe() .....................245
L2CAPWaitForConnection() .....................246
SDPCommands..................................247
SDPAddProfileServiceRecord()...................247
SDPQueryProfile().............................247
SDPResetDatabase() ...........................248
SDPAddServiceRecord() ........................248
MerlinCommands................................249
MerlinResetAllEncryptionOptions() ...............249
MerlinSetDisplayOptions() ......................250
MerlinSetEncryptionLinkKey() ...................250
MerlinSetEncryptionPIN().......................251
MerlinSetRecordingOptions() ....................251
MerlinStart() .................................252
MerlinStartRecording() .........................252
MerlinStop()..................................253
MerlinStopRecording() .........................253
AppendixD:CATCScriptingLanguage...................255
Values ..........................................255
xv
CATC MERLIN’S WAND 2.00
User’s Manual -
Literals .........................................255
Integers......................................255
Strings.......................................256
EscapeSequences ..........................256
Lists.........................................257
RawBytes....................................257
Null.........................................257
Variables........................................257
GlobalVariables...............................258
LocalVariables................................258
Constants........................................259
Expressions......................................259
select expression .............................260
Operators........................................261
OperatorPrecedenceandAssociativity ..........262
Comments.......................................268
Keywords .......................................268
Statements.......................................269
ExpressionStatements ..........................269
if Statements .................................270
if-else Statements ............................270
while Statements ..............................270
for Statements ................................271
return Statements .............................272
Compound Statements ..........................273
Preprocessing ....................................274
Functions........................................275
Primitives .......................................276
Call()........................................277
Format() .....................................277
Format Conversion Characters ................278
GetNBits()....................................279
NextNBits()...................................280
Resolve().....................................280
Trace().......................................281
xvi
CATC MERLIN’S WAND 2.00 CHAPTER 1
User’s Manual Overview
1. Overview
The CATC Merlin's Wand™ Bluetooth™ Test Generator is a member of
CATC's industry-leading line of Bluetooth protocol analysis tools and test
equipment.
Preceded by CATC's Merlin™, a Bluetooth Protocol Analyzer, Merlin's
Wand has been designed as an intelligent Bluetooth wireless technology
device that can be used as a verification/validation tester or as an
engineering debug and analysis tool. Through its software interface,
designers and test technicians will be able to quickly and easily issue
protocol commands and test sequences to analyze or validate designs to
ensure compliance to the Bluetooth specification. Merlin’s Wand can be
used in conjunction with the Merlin protocol analyzer, allowing for
real-time captures of test sequence results, as is required by the Bluetooth
SIG to provide evidence of product compliance to the specification.
1.1 Applications
Merlin's Wand is a combination of hardware and Microsoft®
Windows®-based application software. The hardware/software
combination is capable of acting as a standard Bluetooth master or slave
device within a piconet. By allowing this capability, Merlin's Wand can be
used to establish or participate in a piconet and to send or receive data within
the piconet. Through the Merlin’s Wand Profile Wizard, users can quickly
and easily manage Bluetooth wireless traffic generation. Additionally, via
its Command Generator, Merlin's Wand can issue individual Bluetooth
commands to a device under test, allowing a designer to focus his or her
effort on a specific function or group of functions related to the device.
Furthermore, users can quickly create test sequences with Script Manager,
thus eliminating the difficulties normally associated with the creation of
complex test sequences.
1
CATC MERLIN’S WAND 2.00 CHAPTER 1
User’s Manual Overview
1.2 Merlin’s Wand User Interface
The Merlin’s Wand user interface consists of the Main window, the Logs
window at the bottom of the screen, and the Device Status window on the
left side of the screen.
The application’s primary tools are run within the Main window: Profile
Wizard, Command Generator,andScript Manager.
Each tool offers a different means of generating traffic.
Note: Only one tool can be run at a time.
Profile Wizard is a
point-and-click tool for creating
connections and transferring data
between Merlin’s Wand and other
Bluetooth devices. This tool
requires little Bluetooth wireless
technology experience and allows
you to generate Bluetooth traffic
without having to execute specific Bluetooth commands. Profile Wizard is
described in Chapter 3, Profile Wizard,onpage17.
2
CATC MERLIN’S WAND 2.00 CHAPTER 1
User’s Manual Overview
Command Generator is a
tool that presents a menu of
protocol commands that can
be selected and executed in
virtually any sequence.
Command Generator thus
offers maximum control over
the traffic generation process,
but also requires familiarity
with the Bluetooth
commands. Command
Generator is described in
Chapter 4, Command
Generator,onpage43.
Script Manager is a tool that
provides an editor for writing
and/or executing scripts that
will generate Bluetooth
wireless traffic. With Script
Manager, new scripts can be
written and saved, or existing
scripts may be opened, edited,
and run. Script Manager is
described in Chapter 5, Script
Manager,onpage55.
1.3 Key Features
• Plug-and-play USB connection between test system and test module
• External antenna can be removed to create wired piconet
• Audio connector for connecting audio devices, such as headsets
• Can operate as either a master or slave device in a piconet
• Graphical interface allows for easy selection of command parameters
• Wizard provided to reduce learning curve and memorization of
command sequences
• Test modes provide for these Bluetooth wireless technology
protocols: HCI, L2CAP, SDP, RFCOMM, TCS, BNEP, and OBEX
• Scripting capability for establishment of predefined test sequences
• System information report provides details regarding device under test
3
CATC MERLIN’S WAND 2.00 CHAPTER 1
User’s Manual Overview
• Can be used with Merlin protocol analyzer
• Power-on self-diagnostics
• No external power required -- obtains power from USB connection
• One year warranty and online customer support
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.com.
1.4 Audio Connections - Important Information
Merlin’s Wand has a 2.5 mm audio stereo jack for plugging in headsets.
Headsets need to have a 2.5 mm plug with the following pinout:
1) Microphone (signal from headset; bias power of 2.5 V and
maximum 1 mA provided by Merlin's Wand on the same pin)
2) Speaker (signal to headset; speaker impedance needs to be
>16 Ohm)
3) Ground
The following headsets have been successfully tested with Merlin’s
Wand:
• RadioShack® 43-1957 Super Lightweight Hands-Free Headset
• GN Netcom® GNX Mobile M200
• Motorola® Retractable Hands-Free Headset Model # 98196G
• Belkin® Universal 2.5 mm Personal Hands-Free Kit F8V920-PL
• Coby® CV-M20 Earphone with Built-In Microphone
• Plantronics® CHS122N Hands-Free Headset
• Plantronics M110 Headset for Cordless and Mobile Phones
4
CATC MERLIN’S WAND 2.00 CHAPTER 1
User’s Manual Overview
1.5 Limitations
• The only Inquiry Access Code (IAC) supported at inquiry and
inquiry scan is the General Inquiry Access Code (GIAC)
• The Scan_Enable parameter value of 0x01 (inquiry scan enabled
and page disabled) is not supported
• Page scan intervals and inquiry scan intervals other than 1.28s are
not supported
• Page scan windows and inquiry scan windows other than
11.25ms are not supported
• Optional page scan modes are not supported
• More than one SCO connection at a time is not supported
5
CATC MERLIN’S WAND 2.00 CHAPTER 1
User’s Manual Overview
1.6 Specifications
The following specifications describe a Merlin’s Wand System.
Package
Dimensions: 3.4x2.6x1inches
(8.6 x 6.6 x 2.54 centimeters)
Connectors: Host connection (USB, type ‘B’)
Audio connection (2.5 millimeter audio stereo jack)
Weight: 3.0 oz. (84 g)
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
Host Compatibility
Works with any PC equipped with a functioning USB port and a Microsoft
Windows 98 SE, Windows Me, Windows 2000, or Windows XP operating
system.
Hardware Interfaces
Standard USB Interface -- connects to the host computer
2.4 GHz (ISM band) External Antenna.
2.5 mm audio stereo jack
Product Warranty
CATC offers a one-year limited warranty on its products.
6
CATC MERLIN’S WAND 2.00 CHAPTER 2
User’s Manual Getting Started
2. Getting Started
This chapter describes how to install Merlin’s Wand and its software. Both
install easily in just a few minutes. The Merlin’s Wand software can be
installed on most Windows-based personal computer systems.
2.1 System Requirements
The following is the recommended configuration for the computer that runs
the Merlin’s Wand application and is connected to the Merlin’s Wand
hardware unit.
• Operating system: Microsoft® Windows® 98 SE, Windows
2000, Windows Me, or Windows XP operating system.
Occasionally, after unplugging theMerlin's Wand hardware on a Windows
2000 system, subsequent attempts to plug in the device cause the computer
to recognize the unit as a “USB device” rather than as “Merlin's Wand.” If
this occurs, you will need to restart the computer so that it will recognize
the device properly. To avoid the problem, upgrade to the latest Windows
2000 service pack available from Microsoft.
• Required setup: Microsoft Internet Explorer 5 or later must be
installed.
•Seereadme document on installation CD or in installation
directory for latest hardware requirements.
2.2 Setting Up Merlin’s Wand
The Merlin’s Wand hardware can be set up using the installation CD-ROM
or from installation files downloaded from the CATC website.
Step 1 Attach the external antenna to the Merlin’s Wand hardware
unit by screwing it onto the connector labelled ANT.
Step 2 Plug one end of the USB cable into the USB port on the
Merlin’s Wand hardware, and plug the other end of the USB
cable into a USB port on the host computer.
Windows should automatically detect the Merlin’s Wand hardware and
open the Windows Hardware Wizard to install Merlin’s Wand. If the
installation doesn’t finish automatically, proceed to Step 3.
Step 3 Follow the Hardware Wizard’s on-screen instructions to
complete the installation. If the wizard prompts you for
driver information, insert the Merlin’s Wand installation
CD-ROM and direct the wizard to the directory
<drive>:\software\MerlinWand122. Substitute the drive
7
CATC MERLIN’S WAND 2.00 CHAPTER 2
User’s Manual Getting Started
letter of the CD-ROM drive for <drive>. For example, if the
CD-ROM drive is drive D, navigate to
D:\software\MerlinWand122.
Note: If you are using installation files downloaded from the CATC website, you will
need to direct the wizard to the Disk 1 directory of the installation files so that it
can locate the driver.
2.3 Installing the Software and Starting the Program
The Merlin’s Wand 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’s Wand installation CD-ROM into the
CD-ROM drive of the computer that will be connected to the
Merlin’s Wand hardware.
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 and double-click the file autorun.exe, and proceed to Step 2. If
it still doesn’t start, navigate to the \software\MerlinWand122 directory
on the CD-ROM, double-click the file Setup.exe, and proceed to Step 3.
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’s Wand installation download. Select the file
Setup.exe and click Open.
Step 2 Follow the on-screen instructions to complete the
installation.
Start the program
Once the software has been installed, be sure that the Merlin’s Wand
hardware is connected to the PC via the USB cable before starting the
Merlin’s Wand application. Otherwise, the application will provide a
warning message telling you that the Wand could not be found.
8
CATC MERLIN’S WAND 2.00 CHAPTER 2
User’s Manual Getting Started
To start the application, select Start > Programs > CATC > CATC
Merlin’s Wand. Note that this is the default location for the Merlin’s Wand
application. If it was installed in a different folder, select that folder from the
Programs menu.
2.4 Displaying the On-Screen Help
Access the on-screen Help included with the Merlin’s Wand application by
selecting Help > Help... from the menu bar.
2.5 Application Layout
The Merlin’s Wand window is made up of the following:
• The Main window, where the primary tools are run: Profile
Wizard, Command Generator,andScript Manager.
• Profile Wizard -- A simple, easy-to-use tool that guides
you through the process of establishing connections and
generating traffic between Merlin’s Wand and other
Bluetooth wireless technology devices.
9
CATC MERLIN’S WAND 2.00 CHAPTER 2
User’s Manual Getting Started
• Command Generator -- A tool that allows Bluetooth
commands to be issued in any chosen sequence. If
Command Generator isn't enabled on your Merlin’s Wand
system, a License Key must be obtained from CATC
before it can be used.
• Script Manager -- A notepad-like tool for writing and
launching scripts that cause Merlin’s Wand to generate
traffic. This tool is an optional feature. If Script Manager
isn't enabled on your Merlin’s Wand system, a License
Key must be obtained from CATC before it can be used.
Note: When switching between Profile Wizard, Command Generator and
Script Manager, all connections that have been established between
Merlin’s Wand and another Bluetooth device should be closed.
However, expert users may choose to leave the connections open. If
a connection is left open and you attempt to switch tools, Merlin’s
Wand will prompt you to close the connections. Choosing
Disconnect All will close the connections. Choosing Cancel will
leave the connections open, but some commands might not work
properly in the other tool. When switching to Profile Wizard, any
open connections must be closed.
•TheDevice Status window is on the
left side of the interface. It contains
two tabs: Device List and Connections.
• Device List - Displays a list
of devices that Merlin’s
Wand has discovered. It also
contains information about
the devices found, such as
the Bluetooth address, the
state, the role, the class, and
the device’s local name.
This window is open by default. These symbols in the list
indicate a device’s state: C = Connected; i = In Range.
Right-clicking on a listed device opens the Device List
Pop-Up Menu. The menu presents the following options:
Connect, Add Audio Connection, Get Device Information,
Delete,andDisconnect All. For details on using the Pop-Up
Menu, see Chapter 6, Device Search and Device List Pop-Up
Menu,onpage61.
10
CATC MERLIN’S WAND 2.00 CHAPTER 2
User’s Manual Getting Started
• Connections - Displays a
hierarchical list of all
connections between
Merlin’s Wand and other
devices. At the top of the list
is the address of the
connected device; below it are the various channels established
between Merlin’s Wand and the device. Symbols:
C = Connection; H =HCIACL;S =HCISCO;L = L2CAP;
R = RFCOMM; O =OBEX.
• At the bottom of the interface is the Logs window,which
contains tabs for the Event Log and the Script Log:
• All Log - Captures the commands and events of the
System and Scripts logs
• System Log - Maintains a log of all commands issued by
Merlin’s Wand and the events that ensue, such as a reply
by another device.
• Script Log - Maintains a record of the commands issued
by Script Manager and the events resulting from these
commands. If line numbers are referenced in the Script
Log, double-clicking on the line number will move the
cursor to that line in the Script Manager window.
11
CATC MERLIN’S WAND 2.00 CHAPTER 2
User’s Manual Getting Started
2.6 Menus
The menu bar at the top of the application window contains the following
menus of pull-down commands:
Table 1: Menu Bar Commands
File Menu
Command Function
New Creates a new script file
Open... Opens a script file
Close Closes a script file
Save Saves a script file
Save As.. Saves a script file with a specified name
Print Setup... Sets up the current or a new printer
Print Script... Prints a script file
Exit Exits the Merlin's Wand program
Edit Menu
Command Function
Undo Undoes last change
Cut Cuts text
Copy Copies text
Paste Pastes copied or cut text
Select All Selects all text
Find... Finds specified string
Find Next Repeats last find action
Replace... Searches for a string and replaces it with
anewstring
View Menu
Command Function
Device Status Shows or hides the Device Status window
Logs Shows or hides the Logs window
Toolbars > Opens sub-menu with options for
showing or hiding the Standard, Tools
and Modes, Merlin/Merlin Mobile, and
Scripts toolbars
Status Bar Shows or hides the status bar
Intro Displays Introduction splash screen that
displays when the application first opens
Tools Menu
Command Function
Device Search Opens the Device Search dialog box
12
CATC MERLIN’S WAND 2.00 CHAPTER 2
User’s Manual Getting Started
Table 1: Menu Bar Commands (Continued)
Profile Wizard Opens Profile Wizard
Command Generator Opens Command Generator
Script Manager Opens Script Manager
Data Transfer Manager Opens Data Transfer Manager
Local Device Manager Opens a dialog box that displays
information about Merlin’s Wand
Script Menu
Command Function
Run Runs the open script. Requires that
Script Manager be running.
Stop Stops execution of the open script.
Requires that Script Manager be running.
Help Menu
Command Function
Help... Displays online Help
About Merlin’s Wand Displays version information about
Merlin's Wand.
2.7 Toolbars
There are four toolbars in the Merlin’s Wand user interface: Standard, Tools
and Modes, Merlin/Merlin Mobile, and Scripts. The Toolbar buttons
provide access to frequently-used program functions. Tool tips describe
icon functionality as the mouse pointer is moved over an item.
Standard
Thesebuttons require Script Manager tobe open.
New Script
Opens a new page in Script Manager
Opens Script
Opens a dialog box for selecting a script
Save Script
Opens a Save As dialog box
Print Script
Prints open script
Cut
Cuts selected text in Script Manager
Insert Clipboard Contents
Pastes text from clipboard
13
CATC MERLIN’S WAND 2.00 CHAPTER 2
User’s Manual Getting Started
Tools and Modes
Device Search
Opens Device Search dialog
Local Device Manager
Displays info about Merlin’s Wand
Profile Wizard
Opens Profile Wizard
Command Generator
Opens Command Generator
Script Manager
Opens Script Manager
Data Transfer Manager
Opens Data Transfer Manager dialog
Merlin/Merlin Mobile Analyzer Toolbar
2.8 Tool Tips
For most of the buttons and menus, tool tips provide
useful information.
To display a tool tip, position the mouse pointer over an
item. If a tooltip exists for the item, it will pop up in a
moment.
Connect/Disconnect Merlin Bluetooth Analyzer
Connects to or disconnects from Merlin Bluetooth Analyzer
Set Merlin Recording Options
Displays the Open dialog to choose the Recording Options file
for Merlin Bluetooth Analyzer
Set Merlin Display Options
Displays the Open dialog to choose the Display Options file
for Merlin Bluetooth Analyzer
Start Recording
Starts a Merlin Bluetooth Analyzer recording session
Stop Recording
Stops a Merlin Bluetooth Analyzer recording session
Set Merlin Encryption Options
Opens the Encryption Setup window
14
Loading...