Document Outline

• Document Disclaimer
• Trademarks and Servicemarks
• Copyright
• FCC Conformance Statement
  • Important Notice
• EU Conformance Statement
• Table of Contents
• 1. Overview
  • 1.1 Applications
  • 1.2 Merlin’s Wand User Interface
  • 1.3 Key Features
  • 1.4 Audio Connections - Important Information
  • 1.5 Limitations
  • 1.6 Specifications
• 2. Getting Started
  • 2.1 System Requirements
  • 2.2 Setting Up Merlin’s Wand
  • 2.3 Installing the Software and Starting the Program
    • Install from CD-ROM
    • Install from installation download
    • Start the program
  • 2.4 Displaying the On-Screen Help
  • 2.5 Application Layout
  • 2.6 Menus
  • 2.7 Toolbars
    • Standard
    • Tools and Modes
    • Merlin/Merlin Mobile Analyzer Toolbar
  • 2.8 Tool Tips
  • 2.9 Merlin’s Wand Keyboard Shortcuts
• 3. Profile Wizard
  • 3.1 Starting Profile Wizard
  • 3.2 Connecting to Devices
    • Connect to Device: Dial-Up Gateway
    • Connect to Device: Fax Gateway
    • Connect to Device: File Transfer
    • Connect to Device: HCRP Server
    • Connect to Device: Headset
    • Connect to Device: Headset Audio Gateway
    • Connect to Device: LAN
    • Connect to Device: Object Push
    • Connect to Device: PAN–GN
    • Connect to Device: PAN–NAP
    • Connect to Device: Serial Port
  • 3.3 Emulating Devices
    • Emulate Device: Dial-Up Gateway
    • Emulate Device: Fax Gateway
    • Emulate Device: File Transfer
    • Emulate Device: HCRP Server
    • Emulate Device: Headset
    • Emulate Device: LAN
    • Emulate Device: Object Push
    • Emulate Device: PAN - GN
    • Emulate Device: PAN - NAP
    • Emulate Device: Serial Port
  • 3.4 Restarting the Wizard
  • 3.5 Installing the Virtual COM Port Driver
    • On Windows 2000
  • 3.6 Install a Modem Driver on the Virtual COM Port
  • 3.7 Installation of Network Driver
    • Verifying the Driver’s Installation
    • Configuration of Virtual NIC
• 4. Command Generator
  • 4.1 Layout of the Command Generator
  • 4.2 Using Command Generator
    • Customizing the List of HCI Commands
  • 4.3 Tables of Available Commands
  • HCI Commands
    • Link Control Commands
    • Link Policy Commands
    • Host Controller & Baseband Commands
    • Informational Commands
    • Status Commands
    • Testing Commands
    • CATC-Specific Commands
  • L2CAP Commands
  • SDP Commands
  • RFCOMM Commands
  • TCS Commands
  • OBEX Commands
• 5. Script Manager
  • 5.1 Layout of the Script Manager Window
    • Menubar
    • Toolbar
  • 5.2 Running Scripts
  • 5.3 Writing Scripts
  • 5.4 Script Assistant
  • 5.5 Sample Scripts
• 6. Device Search and Device List Pop-Up Menu
  • 6.1 Device Search
  • 6.2 Device List Pop-Up Menu
    • Create an ACL Connection
    • Establish an Audio Connection
    • Display Device Information
    • Delete a Device
    • Disconnect All
• 7. Data Transfer Manager and Data Pipes
  • 7.1 Creating Data Pipes
  • 7.2 Using Data Pipes
    • Transfer Data Using Command Generator
    • Access Pipes Using Script Manager
  • 7.3 Receive Pipes
  • 7.4 Closing Pipes
  • 7.5 Saving Data Pipes
    • Saving Data Transmit Pipe Lists
    • Saving a Default List
    • Saving Data Receive Pipes
  • 7.6 Deleting Pipes
  • 7.7 Opening Pipe Lists
  • 7.8 Renaming Pipes
  • 7.9 Modifying Pipes
• 8. Using Merlin to Record Merlin’s Wand Traffic
  • 8.1 Set Up a Remote Machine
    • Windows 98/Me Operating Systems
    • Windows NT®/2000 Operating Systems
  • 8.2 Set Up Connection Options
  • 8.3 Start Merlin
  • 8.4 Connect to Merlin with Merlin’s Wand
  • 8.5 Set Merlin Recording Options
  • 8.6 Set Merlin Display Options
  • 8.7 Set Merlin Encryption Options
  • 8.8 Start a Merlin Recording Session
  • 8.9 Stop a Merlin Recording Session
  • 8.10 Disconnect from Merlin Bluetooth Protocol Analyzer
  • 8.11 Troubleshooting
    • “Server Busy” When Attempting to Launch Merlin
    • “Server Execution Failed” When Attempting to Launch Merlin
    • “The Object Exporter Specified Was Not Found” When Attempting to Launch Merlin
• 9. Contact and Warranty Information
  • 9.1 Contact Information
  • 9.2 Warranty and License
• Appendix A: Command Generator Command Descriptions
  • A.1 HCI Command Descriptions
  • HCI Link Control Commands
    • Accept_Connection_Request
    • Add_SCO_Connection
    • Authentication_Requested
    • Change_Connection_Link_Key
    • Change_Connection_Packet_Type
    • Create_Connection
    • Disconnect
    • Exit_Periodic_Inquiry_Mode
    • Inquiry
    • Inquiry_Cancel
    • Periodic_Inquiry_Mode
    • PIN_Code_Request_Negative_Reply
    • PIN_Code_Request_Reply
    • Read_Clock_Offset
    • Read_Remote_Supported_Features
    • Read_Remote_Version_Information
    • Reject_Connection_Request
    • Remote_Name_Request
    • Set_Connection_Encryption
  • HCI Link Policy Commands
    • Exit_Park_Mode
    • Exit_Sniff_Mode
    • Hold_Mode
    • Park_Mode
    • QoS_Setup
    • Read_Link_Policy_Settings
    • Role_Discovery
    • Sniff_Mode
    • Switch_Role
    • Write_Link_Policy_Settings
  • HCI Host Controller & Baseband Commands
    • Change_Local_Name
    • Delete_Stored_Link_Key
    • Host_Buffer_Size
    • Read_Authentication_Enable
    • Read_Class_of_Device
    • Read_Connection_Accept_Timeout
    • Read_Current_IAC_LAP
    • Read_Encryption_Mode
    • Read_Link_Supervision_Timeout
    • Read_Local_Name
    • Read_Number_Of_Supported_IAC
    • Read_Page_Scan_Mode
    • Read_Page_Scan_Period_Mode
    • Read_Page_Timeout
    • Read_PIN_Type
    • Read_Scan_Enable
    • Read_SCO_Flow_Control_Enable
    • Read_Stored_Link_Key
    • Read_Voice_Setting
    • Reset
    • Set_Event_Filter
    • Set_Event_Mask
    • Write_Authentication_Enable
    • Write_Class_of_Device
    • Write_Connection_Accept_Timeout
    • Write_Current_IAC_LAP
    • Write_Encryption_Mode
    • Write_Link_Supervision_Timeout
    • Write_Page_Timeout
    • Write_PIN_Type
    • Write_Scan_Enable
    • Write_Stored_Link_Key
    • Write_Voice_Setting
  • HCI Informational Commands
    • Read_BD_ADDR
    • Read_Buffer_Size
    • Read_Country_Code
    • Read_Local_Supported_Features
    • Read_Local_Version_Information
  • HCI Testing Commands
    • Enable_Device_Under_Test_Mode
    • Read_Loopback_Mode
    • Write_Loopback_Mode
  • CATC-Specific HCI Commands
    • CATC_BER_Test
    • CATC_Change_Headset_Gain
    • CATC_Read_Headset_Gain
    • CATC_Read_PIN_Response_Enable
    • CATC_Read_Revision_Information
    • CATC_Self_Test
    • CATC_Set_Default_PIN_Code
    • CATC_Write_PIN_Response_Enable
  • A.2 Other HCI Events
  • A.3 L2CAP Command Descriptions
    • ConfigurationResponse
    • ConfigurationRequest
    • ConnectRequest
    • ConnectResponse
    • DeregisterPsm
    • DisconnectRequest
    • EchoRequest
    • InfoRequest
    • RegisterPsm
    • SendData
  • A.4 Other L2CAP Events
  • A.5 SDP Command Descriptions
    • AddProfileServiceRecord
    • AddServiceRecord
    • ProfileServiceSearch
    • RequestServiceAttribute
    • RequestServiceSearch
    • RequestServiceSearchAttribute
    • ResetDatabase
  • A.6 RFCOMM Command Descriptions
    • AcceptChannel
    • AcceptPortSettings
    • AdvanceCredit
    • CloseClientChannel
    • CreditFlowEnabled
    • DeregisterServerChannel
    • OpenClientChannel
    • RegisterServerChannel
    • RequestPortSettings
    • RequestPortStatus
    • SendData
    • SendTest
    • SetLineStatus
    • SetModemStatus
    • SendATCommand
  • A.7 Other RFCOMM Events
  • A.8 TCS Command Descriptions
    • RegisterIntercomProfile
    • Open_TCS_Channel
    • Start_TCS_Call
    • Disconnect_TCS_Call
    • Send_Info_Message
  • A.9 OBEX Command Descriptions
    • ClientAbort
    • ClientConnect
    • ClientDisconnect
    • ClientGet
    • ClientPut
    • ClientSetPath
    • ServerDeinit
    • ServerInit
    • ServerSetPath
  • A.10 BNEP Command Descriptions
    • Accept
    • Open
    • Close
    • SetUpConnectionReq
    • SentPKT
    • SendControlPKT
    • RegisterBNEP
    • DeregisterBNEP
    • SetControlTimeout
    • PIN_Code_Request_Negative_Reply
    • PIN_Code_Request_Reply
    • Read_Clock_Offset
• Appendix B: Command Generator Examples
  • B.1 Device Discovery and Remote Name Request
    • Procedure
  • B.2 Establish Baseband Connection
    • Procedure
  • B.3 Baseband Disconnection
    • Procedure
  • B.4 Create Audio Connection
    • Procedure
  • B.5 L2CAP Connection
    • Procedure
  • B.6 L2CAP Channel Disconnect
    • Procedure
  • B.7 SDP Profile Service Search
    • Procedure
  • B.8 SDP Reset Database and Add Profile Service Record
    • Procedure
  • B.9 RFCOMM Client Channel Establishment
    • Procedure
  • B.10 RFCOMM Client Channel Disconnection
    • Procedure
  • B.11 RFCOMM Register Server Channel
    • Procedure
  • B.12 Establish TCS Connection
    • Procedure
  • B.13 OBEX Server Init
    • Procedure
  • B.14 OBEX Client Connection and Client Get & Put
    • Procedure
• Appendix C: Merlin’s Wand Scripting Commands
  • C.1 Bluetooth Addresses
  • C.2 Basic Commands
    • Main()
    • Clock()
    • Connect()
    • Disconnect()
    • DoInquiry()
    • GetDeviceClass()
    • GetRemoteDeviceName()
    • MessageBox()
    • SetDeviceClass()
    • Sleep()
  • C.3 Pipe Commands
    • ClosePipe()
    • DeletePipe()
    • OpenPipe()
    • ReadPipe()
    • WritePipe()
  • C.4 HCI Commands
    • HCIAcceptConnectionRequest()
    • HCIAddSCOConnection()
    • HCIAuthenticationRequested()
    • HCICatcBerTest()
    • HCICatcChangeHeadsetGain()
    • HCICatcReadHeadsetGain()
    • CATC_Read_PIN_Response_Enable()
    • HCICatcReadRevisionInformation()
    • HCICatcSelfTest()
    • HCIChangeConnectionLinkKey()
    • HCIChangeConnectionPacketType()
    • HCIChangeLocalName()
    • HCIDeleteStoredLinkKey()
    • HCIEnableDeviceUnderTestMode()
    • HCIExitParkMode()
    • HCIExitSniffMode()
    • HCIHoldMode()
    • HCIMasterLinkKey()
    • HCIParkMode()
    • HCIPINCodeRequestNegativeReply()
    • HCIPINCodeRequestReply()
    • HCIQoSSetup()
    • HCIReadAuthenticationEnable()
    • HCIReadBDADDR()
    • HCIReadBufferSize()
    • HCIReadClockOffset()
    • HCIReadConnectionAcceptTimeout()
    • HCIReadCountryCode()
    • HCIReadCurrentIACLAP()
    • HCIReadEncryptionMode()
    • HCIReadLinkPolicySettings()
    • HCIReadLinkSupervisionTimeout()
    • HCIReadLocalName()
    • HCIReadLocalSupportedFeatures()
    • HCIReadLocalVersionInformation()
    • HCIReadLoopbackMode()
    • HCIReadNumberOfSupportedIAC()
    • HCIReadPageScanMode()
    • HCIReadPageScanPeriodMode()
    • HCIReadPageTimeout()
    • HCIReadPINType()
    • HCIReadRemoteSupportedFeatures()
    • HCIReadRemoteVersionInformation()
    • HCIReadScanEnable()
    • HCIReadSCOFlowControlEnable()
    • HCIReadStoredLinkKey()
    • HCIReadVoiceSetting()
    • HCIRejectConnectionRequest()
    • HCIRemoveSCOConnection()
    • HCIReset()
    • HCIRoleDiscovery()
    • HCISetConnectionEncryption()
    • HCISetEventFilter()
    • HCISniffMode()
    • HCISwitchRole()
    • HCIWriteAuthenticationEnable()
    • HCIWriteConnectionAcceptTimeout()
    • HCIWriteCurrentIACLAP()
    • HCIWriteEncryptionMode()
    • HCIWriteLinkPolicySettings()
    • HCIWriteLinkSupervisionTimeout()
    • HCIWriteLoopbackMode()
    • HCIWritePageTimeout()
    • HCIWritePINType()
    • HCIWriteScanEnable()
    • HCIWriteStoredLinkKey()
    • HCIWriteVoiceSettings()
  • C.5 OBEX Commands
    • OBEXClientAbort()
    • OBEXClientConnect()
    • OBEXClientDeinit()
    • OBEXClientDisconnect()
    • OBEXClientGet()
    • OBEXClientInit()
    • OBEXClientPut()
    • OBEXClientSetPath()
    • OBEXServerDeinit()
    • OBEXServerSetPath(Path)
  • C.6 RFCOMM Commands
    • RFCloseClientChannel()
    • RFOpenClientChannel()
    • RFRegisterServerChannel()
    • RFSendData()
    • RFSendDataFromPipe()
    • RFReceiveData()
    • RFWaitForConnection()
    • RFAcceptChannel()
    • RFAcceptPortSettings()
    • RFCreditFlowEnabled()
    • RFRequestPortSettings()
    • RFRequestPortStatus()
    • RFSetLineStatus()
    • RFSetModemStatus()
    • RFSendTest()
    • RFAdvanceCredit()
  • C.7 TCS Commands
    • TCSRegisterProfile()
    • TCSOpenChannel()
    • TCSStartCall()
    • TCSDisconnectCall()
    • TCSSendInfoMessage()
  • C.8 L2CAP Commands
    • L2CAPConfigurationRequest()
    • L2CAPConfigurationResponse()
    • L2CAPConnectRequest()
    • L2CAPConnectResponse()
    • L2CAPDeregisterAllPsm()
    • L2CAPDisconnectRequest()
    • L2CAPEchoRequest()
    • L2CAPReceiveData()
    • L2CAPInfoRequest()
    • L2CAPRegisterPsm()
    • L2CAPSendData()
    • L2CAPSendDataFromPipe()
    • L2CAPWaitForConnection()
  • C.9 SDP Commands
    • SDPAddProfileServiceRecord()
    • SDPQueryProfile()
    • SDPResetDatabase()
    • SDPAddServiceRecord()
  • C.10 Merlin Commands
    • MerlinResetAllEncryptionOptions()
    • MerlinSetDisplayOptions()
    • MerlinSetEncryptionLinkKey()
    • MerlinSetEncryptionPIN()
    • MerlinSetRecordingOptions()
    • MerlinStart()
    • MerlinStartRecording()
    • MerlinStop()
    • MerlinStopRecording()
• Appendix D: CATC Scripting Language
  • D.1 Values
  • D.2 Literals
    • Integers
    • Strings
      • Escape Sequences
    • Lists
    • Raw Bytes
    • Null
  • D.3 Variables
    • Global Variables
    • Local Variables
  • D.4 Constants
  • D.5 Expressions
    • select expression
  • D.6 Operators
    • Operator Precedence and Associativity
  • D.7 Comments
  • D.8 Keywords
  • D.9 Statements
    • Expression Statements
    • if Statements
    • if-else Statements
    • while Statements
    • for Statements
    • return Statements
    • Compound Statements
  • D.10 Preprocessing
  • D.11 Functions
  • D.12 Primitives
    • Call()
    • Format()
      • Format Conversion Characters
    • GetNBits()
    • NextNBits()
    • Resolve()
    • Trace()