2403 Walsh Avenue, Santa Clara, CA 95051-1302 Tel: +1/408.727.6600 Fax: +1/408.727.6622 CATC Merlin’s Wand™ 1.22 Bluetooth™ Test Generator User’s Manual Document Revision 1.
CATC MERLIN’S WAND 1.22 User’s Manual CATC Merlin’s Wand 1.22 Bluetooth Test Generator User’s Manual, Document Revision 1.22 Document Disclaimer The information contained in this document has been carefully checked and is believed to be reliable. However, no responsibility can be assumed for inaccuracies that may not have been detected. CATC reserves the right to revise the information presented in this document without notice or penalty.
CATC MERLIN’S WAND 1.22 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.
CATC MERLIN’S WAND 1.
CATC MERLIN’S WAND 1.22 User’s Manual TABLE OF CONTENTS TABLE OF CONTENTS Document Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ii Trademarks and Servicemarks . . . . . . . . . . . . . . . . . . . . . . . . . ii Copyright . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ii FCC Conformance Statement . . . . . . . . . . . . . . . . . . . . . . . . . iii Important Notice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CATC MERLIN’S WAND 1.22 User’s Manual TABLE OF CONTENTS Restarting the Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Chapter 4 Command Generator . . . . . . . . . . . . . . . . . . . . . . . . . 39 Layout of the Command Generator . . . . . . . . . . . . . . . . . . . . 39 Using Command Generator . . . . . . . . . . . . . . . . . . . . . . . . . . 40 Customizing the List of HCI Commands . . . . . . . . . . . . . 41 Tables of Available Commands . . . . . . . . . . . . . . . . . .
CATC MERLIN’S WAND 1.22 User’s Manual TABLE OF CONTENTS Closing Pipes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 Saving Data Pipes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 Saving Data Transmit Pipe Lists. . . . . . . . . . . . . . . . . . . . 74 Saving a Default List . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 Saving Data Receive Pipes . . . . . . . . . . . . . . . . . . . . . . . . 74 Deleting Pipes . . . . . . . . . . . . .
CATC MERLIN’S WAND 1.22 User’s Manual TABLE OF CONTENTS Exit_Periodic_Inquiry_Mode . . . . . . . . . . . . . . . . . . . . . . 93 Inquiry. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 Inquiry_Cancel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 Periodic_Inquiry_Mode . . . . . . . . . . . . . . . . . . . . . . . . . . 94 PIN_Code_Request_Negative_Reply. . . . . . . . . . . . . . . . 95 PIN_Code_Request_Reply . . . . . . . . . . . . . . . . . . . .
CATC MERLIN’S WAND 1.22 User’s Manual TABLE OF CONTENTS Read_SCO_Flow_Control_Enable. . . . . . . . . . . . . . . . . 106 Read_Stored_Link_Key . . . . . . . . . . . . . . . . . . . . . . . . . 106 Read_Voice_Setting . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 Reset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 Set_Event_Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107 Set_Event_Mask . . . . . . . . . . . . . . . . . . . . . . .
CATC MERLIN’S WAND 1.22 User’s Manual TABLE OF CONTENTS InfoRequest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 RegisterPsm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 SendData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 Other L2CAP Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 SDP Command Descriptions . . . . . . . . . . . . . . . . . . . . . . . . 122 AddProfileServiceRecord . . . . . .
CATC MERLIN’S WAND 1.22 User’s Manual TABLE OF CONTENTS ServerSetPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136 Appendix B: Command Generator Examples. . . . . . . . . . . . . . . 137 Device Discovery and Remote Name Request . . . . . . . . . . . 138 Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138 Establish Baseband Connection . . . . . . . . . . . . . . . . . . . . . . 139 Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CATC MERLIN’S WAND 1.22 User’s Manual TABLE OF CONTENTS Sleep() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160 Pipe Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160 ClosePipe() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160 DeletePipe() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161 OpenPipe() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161 ReadPipe() . . . . . .
CATC MERLIN’S WAND 1.22 User’s Manual TABLE OF CONTENTS HCIReadLocalSupportedFeatures() . . . . . . . . . . . . . . . . 189 HCIReadLocalVersionInformation() . . . . . . . . . . . . . . . 190 HCIReadLoopbackMode() . . . . . . . . . . . . . . . . . . . . . . 191 HCIReadNumberOfSupportedIAC() . . . . . . . . . . . . . . . 192 HCIReadPageScanMode() . . . . . . . . . . . . . . . . . . . . . . . 192 HCIReadPageScanPeriodMode() . . . . . . . . . . . . . . . . . 193 HCIReadPageTimeout() . . . . . . . . . . . . .
CATC MERLIN’S WAND 1.22 User’s Manual TABLE OF CONTENTS OBEXServerSetPath(Path) . . . . . . . . . . . . . . . . . . . . . . 220 RFCOMM Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221 RFCloseClientChannel() . . . . . . . . . . . . . . . . . . . . . . . . 221 RFOpenClientChannel() . . . . . . . . . . . . . . . . . . . . . . . . 221 RFRegisterServerChannel() . . . . . . . . . . . . . . . . . . . . . . 222 RFSendData() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CATC MERLIN’S WAND 1.22 User’s Manual TABLE OF CONTENTS MerlinResetAllEncryptionOptions() . . . . . . . . . . . . . . . 249 MerlinSetDisplayOptions() . . . . . . . . . . . . . . . . . . . . . . 249 MerlinSetEncryptionLinkKey() . . . . . . . . . . . . . . . . . . . 250 MerlinSetEncryptionPIN() . . . . . . . . . . . . . . . . . . . . . . . 250 MerlinSetRecordingOptions() . . . . . . . . . . . . . . . . . . . . 251 MerlinStart() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CATC MERLIN’S WAND 1.22 User’s Manual TABLE OF CONTENTS NextNBits(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280 Resolve() . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280 Trace(). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CATC MERLIN’S WAND 1.22 CHAPTER 1 User’s Manual Overview 1. Overview The CATC Merlin's Wand™ Bluetooth™ Test Generator is the newest member in CATC's industry-leading line of high performance, serial communication 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.
CATC MERLIN’S WAND 1.22 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: Bluetooth Wizard, Command Generator, and Script Manager.
CATC MERLIN’S WAND 1.22 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, on page 39.
CATC MERLIN’S WAND 1.22 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.
CATC MERLIN’S WAND 1.22 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.
CATC MERLIN’S WAND 1.22 CHAPTER 1 User’s Manual Overview 1.6 Specifications The following specifications describe a Merlin’s Wand System. Package Dimensions: Connectors: Weight: 3.4 x 2.6 x 1 inches (8.6 x 6.6 x 2.54 centimeters) Host connection (USB, type ‘B’) Audio connection (2.5 millimeter audio stereo jack) 3.0 oz.
CATC MERLIN’S WAND 1.22 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.
CATC MERLIN’S WAND 1.22 CHAPTER 2 User’s Manual Getting Started 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.
CATC MERLIN’S WAND 1.22 CHAPTER 2 User’s Manual Getting Started 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.
CATC MERLIN’S WAND 1.22 CHAPTER 2 User’s Manual Getting Started 2.5 Application Layout The Merlin’s Wand window is made up of the following: • The Main window, where the primary tools are run: Bluetooth Wizard, Command Generator, and Script Manager. • Bluetooth 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.
CATC MERLIN’S WAND 1.22 CHAPTER 2 User’s Manual Note: Getting Started When switching between Bluetooth 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.
CATC MERLIN’S WAND 1.22 CHAPTER 2 User’s Manual Getting Started • Merlin’s Wand Info - Displays details about Merlin’s Wand. • At the bottom of the interface is the Logs window, which contains tabs for the Event Log and the Script Log: • Event Log - Maintains a log of the 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.
CATC MERLIN’S WAND 1.22 CHAPTER 2 User’s Manual Getting Started Table 1: Menu Bar Commands (Continued) Save Script 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...
CATC MERLIN’S WAND 1.22 CHAPTER 2 User’s Manual Getting Started Table 1: Menu Bar Commands (Continued) Data Transfer Manager Opens Data Transfer Manager Help Menu Command Function Help... Displays online Help Update License... Opens the Update License dialog, which is used to install License Keys. License Keys must be obtained from CATC. Display License Information... Displays maintenance expiration and features data for Merlin's Wand.
CATC MERLIN’S WAND 1.
CATC MERLIN’S WAND 1.22 CHAPTER 2 User’s Manual Getting Started Table 2: Keyboard Shortcuts (Continued) Key Combination Operation Key Combination Operation Ctrl + O Open script Ctrl + End Jump to last character of file Ctrl + P Print script... Ctrl + Backspace Delete previous word Ctrl + R Run script F3 Find next Ctrl + S Save script Alt + F4 Shut down Merlin’s Wand application 2.
CATC MERLIN’S WAND 1.22 CHAPTER 3 User’s Manual Bluetooth Wizard 3. Bluetooth Wizard Once Merlin’s Wand is installed and running, it is ready to generate traffic. The easiest way to generate traffic is to use Bluetooth Wizard, a point-and-click tool for creating connections and transferring data between Merlin's Wand and other Bluetooth wireless technology devices.
CATC MERLIN’S WAND 1.22 CHAPTER 3 User’s Manual Bluetooth Wizard Connect to Device -- Choose this option to configure Merlin's Wand to seek out other Bluetooth devices, connect to one of them, and possibly exchange data with that device. Merlin's Wand can connect to and exchange data with two types of devices: Bluetooth wireless headsets that support the Headset Audio Gateway profile and devices that comply with the Object Push profile. 3.
CATC MERLIN’S WAND 1.22 CHAPTER 3 User’s Manual Bluetooth Wizard Clicking this button causes Merlin’s Wand to perform a General Inquiry and collect information on local devices. The Select Device screen opens, displaying the devices that are found. Step 5 From the list, select the device address to which you want Merlin’s Wand to connect, and then click Next.
CATC MERLIN’S WAND 1.22 CHAPTER 3 User’s Manual Bluetooth Wizard Merlin's Wand will query the selected device to determine its profile. When the query is complete, the Select Profile screen will open and display a list of profiles found. Step 6 Select Headset Gateway, then click Next. The Connection Status screen will open, indicating that Merlin's Wand is not connected to the device.
CATC MERLIN’S WAND 1.22 CHAPTER 3 User’s Manual Step 7 Bluetooth Wizard Select Connect. The Connection Status screen will change to show that Merlin's Wand has established an RFCOMM connection with the device. Merlin’s Wand will automatically ring the target device and wait for an answer. Pressing the Ring button will cause Merlin’s Wand to ring the device again. Note The Speaker and Microphone Volume levels can be adjusted by moving the sliders up or down.
CATC MERLIN’S WAND 1.22 CHAPTER 3 User’s Manual Bluetooth Wizard establish an SCO connection with it. Step 9 (Optional) Click the Disconnect button on the Connection Status screen to close the connection. The connection between Merlin's Wand and the device will terminate, and the Connect button will again be available. Selecting Connect will reestablish the connection. 3.
CATC MERLIN’S WAND 1.22 CHAPTER 3 User’s Manual Bluetooth Wizard The Bluetooth Wizard opening screen opens in the Main Window: Step 4 Click the button marked Connect to Device. Clicking this button causes Merlin’s Wand to perform a General Inquiry and collect information on local devices. The Select Device screen opens, displaying the devices that are found.
CATC MERLIN’S WAND 1.22 CHAPTER 3 User’s Manual Bluetooth Wizard Note the messages that appear in the Event Log. These messages provide details about the actions and responses taken in each step. Step 5 From the list, select the device address to which you want Merlin’s Wand to connect, and then click Next. Merlin's Wand will query the selected device to determine its profile. When the query is complete, the Select Profile screen will open and display a list of profiles found.
CATC MERLIN’S WAND 1.22 CHAPTER 3 User’s Manual Bluetooth Wizard The Connection Status screen will open, indicating that Merlin's Wand is not connected to the device.: Step 7 Select Connect. The Connection Status screen will change to show that Merlin's Wand is connected to the device.
CATC MERLIN’S WAND 1.22 CHAPTER 3 User’s Manual Bluetooth Wizard The Speaker and Microphone Volume levels can be adjusted by moving the sliders up or down. The level is indicated by a number, from 0 to 15, to the left of each slider. Note If you cannot establish a connection, you can re-attempt the connection by either pressing Back and re-running the previous two steps, or by pressing the Connect button again.
CATC MERLIN’S WAND 1.22 CHAPTER 3 User’s Manual Bluetooth Wizard 3.4 Connect to a Device: Object Push Merlin's Wand can be configured to transfer files to a Bluetooth wireless device that complies with the Object Push profile. This section shows how to configure Merlin's Wand to connect and transfer files to a Bluetooth device that supports Object Push. Step 1 Turn on the target device (the device that will receive the data). The target device will act as the slave unit in this example.
CATC MERLIN’S WAND 1.22 CHAPTER 3 User’s Manual Bluetooth Wizard to connect, and then double-click or press Next. Merlin's Wand will query the selected device to determine its profile. When the query is complete, the Select Profile screen will open and display a list of profiles found. Step 5 Select Object Push from the list of displayed profiles, and then double-click or press Next.
CATC MERLIN’S WAND 1.22 CHAPTER 3 User’s Manual Step 6 Bluetooth Wizard On the Select Data for Transfer screen, there are options to transfer a file or to transfer text. To transfer a file: Select the radio button next to “Transfer this file.” Type in a filename or locate the file by clicking the browse button to access the Open dialog. By default, the filename in the “Send data to the following file on the receiving device” box matches the name of the file to be transferred.
CATC MERLIN’S WAND 1.22 CHAPTER 3 User’s Manual Bluetooth Wizard When the transfer is complete, Merlin’s Wand will disconnect from the target device: At this point, you can click Back to transfer a different file, click Retransmit to send the file again, or click Restart Wizard to start a new Bluetooth Wizard session. 3.5 Device Emulation: Headset Merlin's Wand can be configured to emulate a wireless device that conforms to the Bluetooth Headset profile.
CATC MERLIN’S WAND 1.22 CHAPTER 3 User’s Manual Bluetooth Wizard The Select Profile screen will open. Step 3 Select Headset, then press Next. The Emulation Status screen will open, indicating that Merlin's Wand has been configured to emulate a device that supports the Headset profile and is awaiting connection from a device. Step 4 Direct a remote Bluetooth device to connect to Merlin's Wand.
CATC MERLIN’S WAND 1.22 CHAPTER 3 User’s Manual Bluetooth Wizard Once the connection is established, the Emulation Status screen will indicate that Merlin's Wand has an RFCOMM connection to the device. Step 5 Click the Answer button to make an SCO connection with the remote device. If the connection attempt is succesful, the screen will change to indicate that an SCO connection has been established.
CATC MERLIN’S WAND 1.22 CHAPTER 3 User’s Manual Step 6 Bluetooth Wizard (Optional) Click the Hang Up button to close the connection. The connection between Merlin's Wand and the device will terminate. 3.6 Device Emulation: Headset Audio Gateway Merlin's Wand can be configured to emulate a wireless device that conforms to the Bluetooth Headset Audio Gateway profile. The following steps show how to set up Merlin's Wand as a Headset Audio Gateway device and connect to it with a remote Bluetooth headset.
CATC MERLIN’S WAND 1.22 CHAPTER 3 User’s Manual Bluetooth Wizard The Emulation Status screen will open, indicating that Merlin's Wand has been configured to emulate a device that supports the Headset Audio Gateway profile and is awaiting connection from a device. Step 4 Direct a remote Bluetooth device to connect to Merlin's Wand. Once the connection is established, the Emulation Status screen will indicate that Merlin's Wand is currently connected to the device.
CATC MERLIN’S WAND 1.22 CHAPTER 3 User’s Manual Step 5 Bluetooth Wizard To verify that Merlin's Wand and the remote device are successfully connected, speak into the microphone on one device and listen for audio on the other. 3.7 Device Emulation: Object Push Merlin's Wand can emulate the file transfer capabilities of wireless devices that support the Object Push profile through the Object Push option. Object Push emulation allows other devices to transfer files to Merlin's Wand.
CATC MERLIN’S WAND 1.22 CHAPTER 3 User’s Manual Bluetooth Wizard The Emulation Status screen will open, indicating that Merlin's Wand has been configured to emulate a Bluetooth device that supports the Object Push profile and is awaiting connection from a device. It is now ready to receive files. If desired, the folder in which transferred files are stored can be changed. To change it, click the Change button and select a new directory in the Browse for Folder dialog.
CATC MERLIN’S WAND 1.22 CHAPTER 3 User’s Manual Bluetooth Wizard The Emulation Status screen will show the file transfer progress: When the transfer is complete, the Emulation Status screen will show that Merlin's Wand is waiting for a connection after having successfully received the file.
CATC MERLIN’S WAND 1.22 CHAPTER 3 User’s Manual Bluetooth Wizard 3.8 Restarting the Wizard When working within Bluetooth Wizard, a new session may be started at any time. Step 1 Click the Restart Wizard button on any screen. • If Merlin's Wand is currently emulating a connected device, the connection will be broken, and Bluetooth Wizard will return to the default Bluetooth Wizard screen.
CATC MERLIN’S WAND 1.22 CHAPTER 4 User’s Manual Command Generator 4. Command Generator The Command Generator is a tool in Merlin’s Wand that presents a menu of protocol commands so that you can select and execute any command in virtually any sequence. Command Generator thus gives maximum control over the traffic generation process. Command Generator requires that you build connections from the Baseband level on up.
CATC MERLIN’S WAND 1.22 CHAPTER 4 User’s Manual Command Generator Parameters Combo Boxes -- Parameters can be entered via the six combo boxes. One or more of the boxes may be activated, depending on which command is currently selected in the Command Menu. Parameters may either be typed into the box or chosen from a pull-down list within the box. Execute -- Pressing the Execute button Wand to run the selected command.
CATC MERLIN’S WAND 1.22 CHAPTER 4 User’s Manual Step 2 Command Generator Choose a protocol to work with by clicking one of the five tabs or a layer in the Protocol Stack Graphic. The list of available commands for the chosen protocol will display in the Command Menu. Note: The HCI tab is displayed by default. Step 3 Select a command from the Command Menu. A description of the command will display in the Command Description Box.
CATC MERLIN’S WAND 1.22 CHAPTER 4 User’s Manual Command Generator Clicking the HCI Customized List button , which is located to the left of the Execute button in Command Generator, will open the Command Group interface. To remove commands from the customized HCI command list, select the radio button beside one of the groups listed in the “Command groups” section of the interface, then press the Remove button . The selected command(s) will move into the “Other HCI commands” list.
CATC MERLIN’S WAND 1.
CATC MERLIN’S WAND 1.
CATC MERLIN’S WAND 1.
CATC MERLIN’S WAND 1.
CATC MERLIN’S WAND 1.22 CHAPTER 4 User’s Manual Command Generator Not Supported Commands Get_Link_Quality Read_Failed_Contact_Counter Reset_Failed_Contact_Counter Read_RSSI Testing Commands Supported Commands Parameters Enable_Device_Under_Test_Mode N/A Read_Loopback_Mode N/A Write_Loopback_Mode Loopback_Mode Not Supported There are no unsupported Testing commands.
CATC MERLIN’S WAND 1.
CATC MERLIN’S WAND 1.22 CHAPTER 4 User’s Manual Command Generator Commands Parameters RequestServiceAttribute HCI_Handle ServiceRecordHandle AttributeID AttributeID AttributeID RequestServiceSearch HCI_Handle ServiceClassID ServiceClassID ServiceClassID RequestServiceSearchAttribute HCI_Handle ServiceClassID ServiceClassID ServiceClassID ResetDatabase N/A Not Supported All SDP commands in Command Generator are supported.
CATC MERLIN’S WAND 1.22 CHAPTER 4 User’s Manual Command Generator Commands Parameters SendData (HCI/DLCI) Data Pipe SendTest (HCI/DLCI) SetLineStatus (HCI/DLCI) LineStatus SetModemStatus (HCI/DLCI) ModemSignals Break Length Not Supported All RFCOMM commands in Command Generator are supported.
CATC MERLIN’S WAND 1.22 CHAPTER 4 User’s Manual Command Generator Not Supported There are no unsupported OBEX commands in Command Generator.
CATC MERLIN’S WAND 1.
CATC MERLIN’S WAND 1.22 CHAPTER 5 User’s Manual Script Manager 5. Script Manager Script Manager is a tool within Merlin’s Wand that presents a text editor window for writing and executing scripts. Scripts can be used to automate Bluetooth command sequences, making the testing process more efficient. This chapter introduces the Script Manager interface. There are a number of commands available to you for writing scripts in Merlin’s Wand.
CATC MERLIN’S WAND 1.22 CHAPTER 5 User’s Manual Script Manager Save Button -- Clicking the Save button saves the script that is currently open in the Work Area. Go To Button -- Clicking the Go To button opens the Go To dialog box. Here, users may enter a line number to go to a specific part of an open script. Line numbers are displayed on the bottom right of the Merlin's Wand application, on the status bar.
CATC MERLIN’S WAND 1.22 CHAPTER 5 User’s Manual Step 3 Script Manager Navigate to the desired file and click Open. The script will display in Script Manager's Work Area. Step 4 Click Run. Script execution will begin, and the label of the Run button will change to Stop. Pressing the Stop button terminates execution of the script. The script's output can be viewed in the Script Log.
CATC MERLIN’S WAND 1.22 CHAPTER 5 User’s Manual Script Manager L2CAP, SDP, RFCOMM, OBEX, and Merlin. Detailed descriptions of the commands can be found in Appendix C: Merlin’s Wand Scripting Commands, on page 155. Step 1 Open Script Manager by clicking the Script Manager icon on the toolbar or by selecting Tools > Script Manager from the menu bar. By default, Script Manager opens an “untitled” script template in the Work Area for composing a new script.
CATC MERLIN’S WAND 1.22 CHAPTER 5 User’s Manual Script Manager sample.script This script demonstrates several common Merlin’s Wand functions. Main() { Trace("Registering a server channel...\n"); rfChannel = RFRegisterServerChannel(); Trace("Server channel: ", rfChannel, "\n\n"); # Add a profile if we got a server channel if(rfChannel != "Failure") { result = SDPAddProfileServiceRecord(rfChannel, "ObjectPush"); Trace("SDPAddProfileServiceRecord returned ", result, "\n"); } Trace("Performing inquiry...\n"
CATC MERLIN’S WAND 1.22 CHAPTER 5 User’s Manual Script Manager # Read the new accessible mode Trace("Current accessible mode is: ", HCIReadScanEnable(), "\n"); Trace("Connecting to ", Devices[0], "\n"); # Connect to the first device in the list. ACLHandle = Connect(Devices[0]); Trace("ACL Handle: ", ACLHandle, "\n"); # Get some SDP query information Trace("\nSDP query results:\n"); serverChannel = SDPQueryProfile(Devices[0], "Headset"); Trace("Headset: Server channel is: ", serverChannel, "\n\n"); # Est
CATC MERLIN’S WAND 1.22 CHAPTER 5 User’s Manual Script Manager Trace("Disconnect returned: ", status, "\n\n"); } Sample-2.script # Sample2.script # # Demonstrates using RFCOMM to wait for and receive data as well as the use of pipes. # # A Transmit pipe called "SamplePipe" should be created in the Data Transfer Manager # before the script is run. This pipe should contain a small amount of data that will be sent # back to the host whenever data is received by the script. Main() { # Do some pipe tests.
CATC MERLIN’S WAND 1.22 CHAPTER 5 User’s Manual Script Manager Trace("RFWaitForConnection returned ", status, "\n"); while(1) { results = RFReceiveData(); Trace("RFReceiveData returned ", results[0], "\n"); if(results[0] != "Success") { ClosePipe("DataIn", "receive"); Trace("Exiting.\n"); return results[0]; } Trace("Received ", results[1], " bytes:\n"); Trace(results[2]); Trace("\n"); result = WritePipe("DataIn", results[2]); Trace("WritePipe returned ", result, "\n"); # Send some data back from a pipe.
CATC MERLIN’S WAND 1.22 CHAPTER 5 User’s Manual Script Manager return result; Trace("MerlinSetEncryptionPIN\n"); result = MerlinSetEncryptionLinkKey('000102030405', "123456"); if(result != "Success") return result; Trace("MerlinSetEncryptionLinkKey\n"); result = MerlinStartRecording(); if(result != "Success") return result; Trace("MerlinStartRecording\n"); Sleep(10000); MerlinStopRecording(); Trace("MerlinStopRecording\n"); MerlinResetAllEncryptionOptions(); MerlinStop(); Trace("MerlinStop\n"); } 61
CATC MERLIN’S WAND 1.
CATC MERLIN’S WAND 1.22 CHAPTER 6 User’s Manual Device Search and Device List Pop-Up Menu 6. Device Search and Device List Pop-Up Menu The Device Search and Device List Pop-Up Menu tools offer shortcut methods for steps that are commonly performed at the beginning of the connection process. They can be used for some commands that would otherwise need to be done in Command Generator. 6.
CATC MERLIN’S WAND 1.22 CHAPTER 6 User’s Manual Device Search and Device List Pop-Up Menu Step 2 (Optional) Set the values for Search Time, Number of Responses and Read Remote Device Name. Step 3 Click Do Inquiry. Merlin's Wand will search for devices. Step 4 To see the results of the search, click the Device List tab in the Device Status window. To see the commands and responses from the Inquiry, view the Event Log in the Logs window. 6.
CATC MERLIN’S WAND 1.22 CHAPTER 6 User’s Manual Device Search and Device List Pop-Up Menu Note: The following instructions assume that a Device Search has been performed and devices are displayed in the Device List. For information about performing a device search, please see Section 6.1, “Device Search,” on page 63. Step 1 Open the Pop-Up Menu by right-clicking on the target device in the Device List. The Device List Pop-Up Menu will open. Step 2 Choose Connect from the menu.
CATC MERLIN’S WAND 1.22 CHAPTER 6 User’s Manual Device Search and Device List Pop-Up Menu menu. The status of the target device should change from In Range to Connected in the Device List. The Piconet tab should now indicate that Merlin's Wand has an ACL connection to the target device. Step 3 Reopen the Pop-Up Menu by right-clicking on the target device in the Device List. The Device List Pop-Up Menu will open.
CATC MERLIN’S WAND 1.22 CHAPTER 6 User’s Manual Step 2 Device Search and Device List Pop-Up Menu Select Get Device Information. The Supported Services and Protocols window will open. The Service Name, Supported Protocols, and Value for the target device will be displayed in the window. Delete a Device Devices that are not connected may be removed from the Device List via the Device List Pop-Up Menu.
CATC MERLIN’S WAND 1.22 CHAPTER 6 User’s Manual Device Search and Device List Pop-Up Menu Disconnect All A fast and easy way to terminate all connections that Merlin's Wand has established with remote devices is to use the Disconnect All… command on the Device List Pop-Up Menu. Step 1 Open the Pop-Up Menu by right-clicking on a device. Step 2 Select Disconnect All… The Existing Connections dialog will open, displaying all pending connections.
CATC MERLIN’S WAND 1.22 CHAPTER 7 User’s Manual Data Transfer Manager and Data Pipes 7. Data Transfer Manager and Data Pipes Data Transfer Manager is a special tool for creating pipes. A pipe is a file or message that has been specially prepared for transmission over an RFCOMM or L2CAP channel. Pipes are necessary with these protocols because RFCOMM and L2CAP only transfer raw data. Pipes are set up to designate the source of the raw data -- either a file or text entered by the user.
CATC MERLIN’S WAND 1.22 CHAPTER 7 User’s Manual Data Transfer Manager and Data Pipes Data Transfer Manager will open, displaying the Data Transmit page. Step 2 Name the pipe by typing a name into the text box labeled Pipe Name. Step 3 To create a pipe from a file: Select the From file radio button. Type in a filename and path or navigate to the desired file by clicking the browse button to bring up the Open dialog.
CATC MERLIN’S WAND 1.22 CHAPTER 7 User’s Manual Data Transfer Manager and Data Pipes Transfer Data Using Command Generator Note: A data pipe needs to be created in Data Transfer Manager before the data can be transferred. See Section 7.1, “Creating Data Pipes,” on page 69 to learn how to do this. Step 1 Open Command Generator by clicking on the Command Generator icon on the Toolbar or selecting Tools > Command Generator from the menu bar.
CATC MERLIN’S WAND 1.22 CHAPTER 7 User’s Manual Data Transfer Manager and Data Pipes Boxes. Step 5 Click the Execute button to send the data pipe. The Event Log will show the transfer of data from Merlin's Wand to the target device. Access Pipes Using Script Manager There are functions available in the scripting API to access pipes. They are: OpenPipe, ClosePipe, ReadPipe, WritePipe, and DeletePipe. Please see Section C.3, “Pipe Commands,” on page 160 for more information.
CATC MERLIN’S WAND 1.22 CHAPTER 7 User’s Manual Data Transfer Manager and Data Pipes 7.4 Closing Pipes Receive pipes on the Data Receive page of Data Transfer Manager can be closed. Closing a receive pipe prevents additional data from being placed in it. Closing it also allows its contents to be viewed in the bottom window of the Data Receive page. For any pipe that isn't closed, this message will appear in the window: “This pipe is open for writing and cannot be viewed.
CATC MERLIN’S WAND 1.22 CHAPTER 7 User’s Manual Data Transfer Manager and Data Pipes Saving Data Transmit Pipe Lists Step 1 (Optional) Delete all pipes. If pipes are already displayed on the Data Transmit page of Data Transfer Manager, any newly created pipes will be added to the displayed list. To create an entirely new list of pipes, the currently displayed list should be deleted.
CATC MERLIN’S WAND 1.22 CHAPTER 7 User’s Manual Data Transfer Manager and Data Pipes To delete a pipe: Step 1 Select the pipe to be deleted. Step 2 Click Delete Pipe. The pipe will be deleted from the displayed pipe list. To delete all pipes: Step 1 Click Delete All Pipes. A warning dialog will come up, asking, “Are you sure you want to delete all pipes from the list?” Click Yes to delete the pipes. All pipes will be cleared from the display. 7.
CATC MERLIN’S WAND 1.22 CHAPTER 7 User’s Manual Data Transfer Manager and Data Pipes 7.9 Modifying Pipes Existing pipes may be modified on the Data Transmit page of Data Transfer Manager. A pipe created from a file can be modified either by associating it with a different file or by changing it to a text-based pipe. A pipe created from text can be modified either by editing the text or by changing the pipe to a file-based pipe. Note: Modifying pipes changes them in Data Transfer Manager.
CATC MERLIN’S WAND 1.22 User’s Manual CHAPTER 8 Using Merlin to Record Merlin’s Wand Traffic 8. Using Merlin to Record Merlin’s Wand Traffic It’s possible to control the CATC Merlin Bluetooth Protocol Analyzer via Merlin’s Wand. The two can be used together to capture real-time 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 the Merlin protocol analyzer.
CATC MERLIN’S WAND 1.22 CHAPTER 8 User’s Manual Using Merlin to Record Merlin’s Wand Traffic Step 5 On the Applications tab, select Merlin from the list of applications. Step 6 Select the Default Properties tab and make sure that “Enable Distributed COM on this computer” is checked. Step 7 Select the Default Security tab and make sure that “Enable remote connection” is checked. Step 8 Click OK.
CATC MERLIN’S WAND 1.22 CHAPTER 8 User’s Manual Step 13 Using Merlin to Record Merlin’s Wand Traffic For Windows NT: (a) Select Start > Settings > Control Panel on the Windows taskbar. The Control Panel window will open. (b) Double-click on Services. The Services dialog will open. (c) Select Remote Procedure Call (RPC) Locator and select Action > Properties from the menu bar. The Remote Procedure Call (RPC) Locator Properties dialog will open. (d) Click Start on the General tab, then click OK.
CATC MERLIN’S WAND 1.22 User’s Manual CHAPTER 8 Using Merlin to Record Merlin’s Wand Traffic 8.2 Set Up Connection Options In addition to establishing connections, the Connect/Disconnect Merlin Bluetooth Analyzer button provides several options for configuring the connection between Merlin's Wand and Merlin. To see the options, click on the options arrow on the right side of the button.
CATC MERLIN’S WAND 1.22 CHAPTER 8 User’s Manual Using Merlin to Record Merlin’s Wand Traffic The machine name/IP address will now be listed on the Connect/Disconnect options menu. By default, it will be selected, as indicated by the checkmark that appears to the left of the name/IP address. 8.3 Start Merlin This step is required only when running Merlin on a remote machine that uses Windows 98 or Windows Me.
CATC MERLIN’S WAND 1.22 CHAPTER 8 User’s Manual Using Merlin to Record Merlin’s Wand Traffic (b) Right-click on the folder and select Properties, or select File > Properties from the menu bar. The Properties dialog will open. (c) Go to the Sharing tab in the Properties dialog. (d) Enable the “Share this folder” option and make sure that the folder is accessible by both the machine running Merlin and the machine running Merlin's Wand. (e) Click OK. Step 2 Click the Set Recording Options button.
CATC MERLIN’S WAND 1.22 CHAPTER 8 User’s Manual Step 4 Using Merlin to Record Merlin’s Wand Traffic Click Open. The path and filename of the recording options file will now be listed on the Set Recording Options drop-down menu. By default, that file will be selected, as indicated by the checkmark that appears to the left of the path and filename. 8.6 Set Merlin Display Options The display options file [*.opt] that Merlin should use can be specified through Merlin's Wand.
CATC MERLIN’S WAND 1.22 CHAPTER 8 User’s Manual Step 2 Using Merlin to Record Merlin’s Wand Traffic Click the Set Display Options button. The Open dialog will be displayed. Step 3 Use the Look in field at the top of the dialog box to browse to the desired file via Network Neighborhood -orIn the File name field, type \\ followed by the name of the computer on which the file is located (for example, \\Computer1). Press Enter to display all shared folders, then navigate to the desired file.
CATC MERLIN’S WAND 1.22 User’s Manual CHAPTER 8 Using Merlin to Record Merlin’s Wand Traffic The Encryption Setup dialog will open. Step 2 Select the Slave Device Address from the drop-down list, or enter it into the combo box. Step 3 Enter the PIN Number for the slave device in the PIN Code text box. or Enter the Link Key for the master-slave connection in the Link Key text box. Step 4 Press the Set button to apply the encryption setup. 8.
CATC MERLIN’S WAND 1.22 User’s Manual CHAPTER 8 Using Merlin to Record Merlin’s Wand Traffic 8.11 Troubleshooting “Server Busy” When Attempting to Launch Merlin “Server Busy" message appears when attempting to launch Merlin on a remote Windows 98 or Windows Me system. • Make sure Merlin is running on the remote machine before clicking the Connect/Disconnect Merlin button in Merlin’s Wand.
CATC MERLIN’S WAND 1.22 User’s Manual • • CHAPTER 8 Using Merlin to Record Merlin’s Wand Traffic the local machine, and try again. If the problem persists, restart the remote machine. Make sure the local computer (the Windows 2000 system running Merlin’s Wand) can reach the remote machine by using its full computer name, such as . Open a command prompt and use the PING command to determine this.
CATC MERLIN’S WAND 1.
CATC MERLIN’S WAND 1.22 CHAPTER 9 User’s Manual Contact and Warranty Information 9. Contact and Warranty Information 9.1 Contact Information Mailing address Computer Access Technology Corporation Customer Support 2403 Walsh Avenue Santa Clara, CA 95051-1302 USA Online support http://www.catc.com/ E-mail address support@catc.com Telephone support +1/800.909.2282 (USA and Canada) +1/408.727.6600 (worldwide) Fax +1/408.727.6622 (worldwide) Sales information sales@catc.com 9.
CATC MERLIN’S WAND 1.22 CHAPTER 9 User’s Manual Contact and Warranty Information CATC shall not be liable for damage to other property caused by any defects in this product, damages based upon inconvenience, loss of use of the product, loss of time or data, commercial loss, or any other damages, whether special, incidental, consequential, or otherwise, whether under theory of contract, tort (including negligence), indemnity, product liability, or otherwise.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Appendix A: Command Generator Command Descriptions A.1 HCI Command Descriptions Note “N/A” means Not Applicable. This indicates that the specified command does not have a parameter. HCI Link Control Commands Accept_Connection_Request Used to accept a new incoming connection request. Execute this command before connection request from another device. By default, all connection requests are accepted.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Authentication_Requested Used to initiate authentication between the two devices associated with the specified HCI_Handle. Command Parameters Examples HCI_Handle 0x0001 Comments Return Events Authentication_Error Authentication_Complete Change_Connection_Link_Key Used to force both connected devices to generate a new link key.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Create_Connection Create_Connection will cause the link manager to create an ACL connection to the Bluetooth wireless device with the BD_ADDR specified by the command parameters. Command Parameters Examples Comments BD_ADDR 010203040506 Enter in HEX as shown. Return Events Create_Connection_Complete Create_Connection_Error Disconnect Disconnect is used to terminate an existing connection.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Return Events Inquiry_Complete Inquiry_Result Inquiry_Error Inquiry_Cancel Inquiry_Cancel will cause Merlin’s Wand to stop the current Inquiry if the Bluetooth device is in Inquiry mode.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions PIN_Code_Request_Negative_Reply PIN_Code_Request_Negative_Reply PIN_Code_Request_Negative_Replyisisused usedtotoreply replytotoa PIN a PIN Code PIN_Code_Request_Negative_Reply Code Request Request fromController the Host Controller the Hostspecify cannotaspecify a PIN event fromevent the Host when thewhen Host cannot PIN code to code for a connection. This command be executed use fortoa use connection.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Read_Remote_Supported_Features Read_Remote_Supported_Features requests a list of the supported features of a remote device.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions process. The Clock_Offset parameter is the difference between its own clock and the clock of the remote device with BD_ADDR. Only bits 2 through 16 of the difference are used and they are mapped to this parameter as bits 0 through 14 respectively. A Clock_Offset_Valid_Flag, located in bit 15 of the Clock_Offset command parameter, is used to indicate if the Clock Offset is valid or not.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions HCI Link Policy Commands Exit_Park_Mode Stops park mode and enters active mode for the specified ACL link. Command Parameters Examples HCI_Handle 0x0001 Comments Return Events Mode_Change Exit_Park_Mode_Error Exit_Sniff_Mode Stops Sniff mode and enters active mode for the specified ACL link.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Return Events Mode_Change Park_Mode_Error QoS_Setup Used to specify Quality of Service parameters for a connection handle.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Return Events Role_Discovery_Complete Role_Discovery_Error Sniff_Mode Places the specified ACL link into Sniff mode.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Return Events Write_Link_Policy_Settings_Complete Write_Link_Policy_Settings_Error HCI Host Controller & Baseband Commands Change_Local_Name Change_Local_Name allows the user-friendly name to be modified for the Merlin’s Wand.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Host_Buffer_Size Used by the Merlin’s Wand to notify the Merlin’s Wand Host Controller about its buffer sizes for ACL and SCO data. The Merlin’s Wand Host Controller will segment the data to be transmitted from the Host Controller to Merlin’s Wand, so that data contained in HCI Data Packets will not exceed these sizes.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Return Events Read_Class_of_Device_Complete Read_Class_of_Device_Error Read_Connection_Accept_Timeout Read_Connection_Accept_Timeout will read the value for the Connection_Accept_Timeout parameter so that Merlin’s Wand can automatically deny a connection request after a specified period has occurred, and to refuse a new connection.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Read_Link_Supervision_Timeout Reads link supervision timeout setting for the specified ACL link. Command Parameters Examples HCI_Handle 0x0001 Comments Return Events Read_Link_Supervision_Timeout_Complete Read_Link_Supervision_Timeout_Error Read_Local_Name Read_Local_Name reads the stored user-friendly name for Merlin’s Wand.
CATC MERLIN’S WAND 1.22 User’s Manual APPENDIX A Command Generator Command Descriptions Return Events Read_Page_Scan_Mode_Complete Read_Page_Scan_Mode_Error Read_Page_Scan_Period_Mode Read_Page_Scan_Period_Mode is used to read the Page_Scan_Period_Mode of Merlin’s Wand.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Read_Scan_Enable Read_Scan_Enable will read the value for the Scan_Enable configuration parameter, which controls whether or not Merlin’s Wand will periodically scan for page attempts and/or inquiry requests from other Bluetooth devices.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Read_Voice_Setting Read_Voice_Setting will read the values for the Voice_Setting parameter in Merlin’s Wand, which controls all the various settings for the voice connections. Command Parameters Examples Comments N/A Return Events Read_Voice_Setting_Complete Read_Voice_Setting_Error Reset Resets the Bluetooth Host Controller, Link Manager, and the radio module of Merlin’s Wand.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Command Parameters Examples Comments Condition 0x01 0x00=Allow Connections from all devices 0x01=Allow Connections from a device with a specific Class of Device 0x02=Allow Connections from a device with a specific BD_ADDR Return Events Set_Event_Filter_Complete Set_Event_Filter_Error Set_Event_Mask Set_Event_Mask is used to control which events are generated by the HCI for the Host.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Write_Authentication_Enable This command will write the value for the Authentication_Enable parameter, which controls whether Merlin’s Wand will require authentication for each connection with other Bluetooth devices. Command Parameters Examples Comments Authentication_Enable 0x0 0x00=Authentication disabled.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Write_Connection_Accept_Timeout Write_Connection_Accept_Timeout will write the value for the Connection_Accept_Timeout configuration parameter, which allows Merlin’s Wand to automatically deny a connection request after a specified period has occurred, and to refuse a new connection. Command Parameters Examples Comments Timeout 0x00 Connection Accept Timeout measured in Number of Baseband slots.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Write_Encryption_Mode Write_Encryption_Mode command will write the value for the Encryption_Mode parameter, which controls whether Merlin’s Wand will require encryption for each connection with other Bluetooth devices. Command Parameters Examples Comments Encryption Mode 0x0 0x00=Encryption disabled.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Write_Page_Timeout Write_Page_Timeout command will write the value for the Page_Reply_Timeout configuration parameter, which allows Merlin’s Wand to define the amount of time a connection request will wait for the remote device to respond before the local device returns a connection failure. Command Parameters Examples Comments Timeout 0x10 0=Illegal Page Timeout.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Write_Scan_Enable The Write_Scan_Enable command will write the value for the Scan_Enable configuration parameter into Merlin’s Wand, which controls whether or not Merlin’s Wand will periodically scan for page attempts and/or inquiry requests from other Bluetooth devices. Command Parameters Examples Comments Scan_Enable 3 0x00=No Scans enabled. 0x01=Inquiry Scan enabled Page Scan disabled.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Return Events Write_Voice_Setting_Complete Write_Voice_Setting_Error HCI Informational Commands Read_BD_ADDR Read_BD_ADDR will read the value of Merlin’s Wand’s address. The BD_ADDR is a 48-bit unique identifier for a Bluetooth device.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Read_Local_Supported_Features Read_Local_Supported_Features will request a list of the supported features for Merlin’s Wand. Command Parameters Examples Comments N/A Return Events Read_Local_Supported_Features_Complete Read_Local_Supported_Features_Error Read_Local_Version_Information Read_Local_Version_Information command will read the values for the version information for Merlin’s Wand.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Read_Loopback_Mode Read_Loopback_Mode will read the value for the setting of the Merlin’s Wand Host Controller’s Loopback_Mode. The setting of the Loopback_Mode will determine the path of information.
CATC MERLIN’S WAND 1.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions CATC_Read_Revision_Information Merlin’s Wand uses this command to read the revision number of the Merlin’s Wand baseband controller. Command Parameters Examples Comments N/A Return Events CATC_Read_Revision_Information_Complete CATC_Read_Revision_Information_Error CATC_Self_Test This command will perform self-test of Merlin’s Wand.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Events Encryption_Change Disconnect_Complete Link_Key_Request_Complete A.3 L2CAP Command Descriptions ConfigurationResponse Response to an incoming configuration request. Command Parameters Examples Comments Reason “Accept” “Accept” (Default) “Reject” “Reject - unacceptable params” “Reject - unknown options” Return Events ConfigurationResponse_Complete ConfigurationSetup Sets L2CAP connection options.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions ConnectRequest Requests establishment of an L2CAP channel in the remote Bluetooth device. Command Parameters Examples HCI_Handle 0x0001 PSM 0x1001 Receive MTU 0x1B6 Comments Return Events Connection_Complete Connection_Failed ConnectResponse Indicates the response to the incoming connection request.This command should be executed before Connection Request.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Return Events Disconnection_Complete Disconnection_Failed EchoRequest Sends an Echo Request over the L2CAP channel. Command Parameters Examples HCI_Handle 0x0001 Data “echo” Comments Return Events EchoRequest_Complete EchoRequest_Failed InfoRequest Sends an Info Request over the L2CAP channel. Info requests are used to exchange implementation-specific information regarding L2CAP’s capabilities.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions SendData Sends data on the specified L2CAP channel. Command Parameters Examples CID 0x0040 Data Pipe “Pipe1” Comments Data_Pipe should be created in the Data Transfer Manager. Return Events SendData_Complete SendData_Failed A.4 Other L2CAP Events Events Connection_Indication Disconnection_Indication Data_Indication Write_Configuration_Complete Command_Complete Error A.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Command Parameters Examples Comments ServerChannel 0x01 Server channel has to be entered for all profiles except for InterCom and Cordless. Return Events AddProfileServiceRecord_Complete AddProfileServiceRecord_Error AddServiceRecord This command will add a pre-defined Service Record according to one of the Bluetooth wireless technology profiles to the SDP database.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Command Parameters Examples Comments Profile HeadSet The following are values of the Profile parameter: HeadsetAudioGateway Headset SerialPort Dialup Fax LAN FileTransfer ObjectPush Sync SyncCommand InterCom Cordless Return Events ProfileServiceSearch_Complete ProfileServiceSearch_Failed RequestServiceAttribute This command will retrieve specific attribute values from a specific service record.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions RequestServiceSearch This command will locate Service Records that match the ServiceSearch Pattern of Service Class IDs. The SDP server will return all Service Record Handles of Service Records that match the given Service Search Pattern. Up to three ServiceClassIDs can be searched in one request.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Return Events ResetDatabase_Complete ResetDatabase_Failed A.6 RFCOMM Command Descriptions AcceptChannel This command will accept or reject incoming request to open an RFCOMM channel from RFCOMM server. This command should be executed before RFCOMM connection request from another device. By default, all connection requests are accepted.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Return Events AdvanceCredit_Complete AdvanceCredit_Error CloseClientChannel This command will close an established RFCOMM channel between Merlin’s Wand and a remotely connected device.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions OpenClientChannel This command will open an RFCOMM channel.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Parameter Values: • BaudRate: Specifies the baud rate. Note that the baud rate setting does not actually affect RFCOMM throughput. Values: 2400, 4800, 7200, 9600, 19200, 38400, 57600, 115200, 230400 • DataFormat: The following values identify the number of data bits.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Command Parameters Examples Comments Data Pipe Pipe1 Data Pipe should be created in the Data Transfer Manager Return Events SendData_Complete SendData_Failed SendTest This command causes Merlin’s Wand to sent a test frame to a remote device over the specified channel.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions SetModemStatus This command will send the ModemStatus to the remote device. It allows the user to send Flow Control and V.24 signals to the remote device.
CATC MERLIN’S WAND 1.22 APPENDIX A User’s Manual Command Generator Command Descriptions Return Events Send_AT_Command_Complete Send_AT_Command_Error A.7 Other RFCOMM Events Events OpenClientChannel_Request CloseClientChannel_Indication Data_Indication PortNegotiation_Indication RequestPortStatus_Indication ModemStatus_Indication LineStatus_Indication Flow_Off_Indication Flow_On_Indication A.8 TCS Command Descriptions RegisterIntercomProfile Registers an Intercom identifier with TCS.
CATC MERLIN’S WAND 1.22 User’s Manual APPENDIX A Command Generator Command Descriptions Return Events Open_TCS_Channel_Complete Open_TCS_Channel_Failed Start_TCS_Call This command must be called right after TCSOpenChannel. It automatically sends a sequence of TCS messages according to the Intercom profile specification of the TCS state machine. After successful execution of this command, TCS state machine is in ACTIVE state and SCO connection is opened.
CATC MERLIN’S WAND 1.22 User’s Manual APPENDIX A Command Generator Command Descriptions A.9 OBEX Command Descriptions ClientConnect This command will create an OBEX connection with a remote device. Command Parameters Examples Comments BD_ADDR 0x010203040506 An HCI Connection has to be established before calling this command. Return Events ClientConnect_Complete ClientConnect_Error ClientDisconnect This command will cause the remote device to close the established OBEX channel.
