BCM20704 - Cypress Semiconductor

The following document contains information on Cypress products. Although the document is marked with the name
“Broadcom”, the company that originally developed the specification, Cypress will continue to offer these products to
new and existing customers.
CONTINUITY OF SPECIFICATIONS
There is no change to this document as a result of offering the device as a Cypress product. Any changes that have
been made are the result of normal document improvements and are noted in the document history page, where
supported. Future revisions will occur when appropriate, and changes will be noted in a document history page.
CONTINUITY OF ORDERING PART NUMBERS
Cypress continues to support existing part numbers. To order these products, please use only the Ordering Part
Numbers listed in this document.
FOR MORE INFORMATION
Please visit our website at www.cypress.com or contact your local sales office for additional information about
Cypress products and services.
OUR CUSTOMERS
Cypress is for true innovators – in companies both large and small.
Our customers are smart, aggressive, out-of-the-box thinkers who design and develop game-changing products that
revolutionize their industries or create new industries with products and solutions that nobody ever thought of before.
ABOUT CYPRESS
Founded in 1982, Cypress is the leader in advanced embedded system solutions for the world’s most innovative
automotive, industrial, home automation and appliances, consumer electronics and medical products. Cypress’s
programmable systems-on-chip, general-purpose microcontrollers, analog ICs, wireless and USB-based connectivity
solutions and reliable, high-performance memories help engineers design differentiated products and get them to
market first.
Cypress is committed to providing customers with the best support and engineering resources on the planet enabling
innovators and out-of-the-box thinkers to disrupt markets and create new product categories in record time. To learn
more, go to www.cypress.com.
Cypress Semiconductor Corporation
Document Number: 002-14776 Rev. **
198 Champion Court
San Jose, CA 95134-1709
408-943-2600
Revised July 1, 2016
Application Note
BCM20704
Over-The-Air Throughput Test Setup Using
Broadcom® BlueTool™ Software
20704-AN200-R
5300 California Avenue • Irvine, CA 92617 • Phone: 949-926-5000 • Fax: 949-926-5203
June 9, 2015
Revision History
Revision
Date
Change Description
20704-AN200-R
06/09/15
Initial release
Broadcom Corporation
5300 California Avenue
Irvine, CA 92617
© 2015 by Broadcom Corporation
All rights reserved
Printed in the U.S.A.
Broadcom®, the pulse logo, Connecting everything®, the Connecting everything logo, and BlueTool™ are
among the trademarks of Broadcom Corporation and/or its affiliates in the United States, certain other
countries and/or the EU. Any other trademarks or trade names mentioned are the property of their respective
owners.
BCM20704 Application Note
Table of Contents
Table of Contents
About This Document .................................................................................................................................. 4
Purpose and Audience ............................................................................................................................ 4
About BlueTool........................................................................................................................................ 4
Acronyms and Abbreviations................................................................................................................... 4
Document Conventions ........................................................................................................................... 4
References .............................................................................................................................................. 5
Technical Support ........................................................................................................................................ 5
System Requirements.................................................................................................................................. 6
Host System Requirements..................................................................................................................... 6
Hardware Requirements ......................................................................................................................... 6
Software Requirements........................................................................................................................... 6
System Connections .................................................................................................................................... 7
Launching BlueTool ..................................................................................................................................... 7
Configuring BlueTool for Throughput Testing .......................................................................................... 7
Setting Up the HCI Control Transport ..................................................................................................... 8
Setting Up the HCI Control Transport for Device 1 .......................................................................... 8
Setting Up the HCI Control Transport for Device 2 .......................................................................... 9
Setting Up HCI Control.......................................................................................................................... 10
Setting Up HCI Control for Device 1 .............................................................................................. 10
Setting Up HCI Control for Device 2 .............................................................................................. 12
Setting Up for Throughput Testing ........................................................................................................ 14
Setting Up Device 1 for Throughput Testing .................................................................................. 14
Setting Up Device 2 for Throughput Testing .................................................................................. 16
BlueTool Support for Perl Scripts............................................................................................................. 17
Broadcom®
June 9, 2015 • 20704-AN200-R
Over-The-Air Throughput Test Setup
Page 3
BCM20704 Application Note
About This Document
About This Document
Purpose and Audience
This application note contains instructions for using Broadcom® BlueTool™ software to prepare two BCM20704equipped devices for Bluetooth throughput testing.
This application note is for engineers responsible for conducting Bluetooth throughput measurements of
BCM20704-equipped devices.
About BlueTool
BlueTool is a proprietary Broadcom software tool for exercising, testing, scripting, debugging, and programming
devices that use Broadcom Bluetooth chips. BlueTool runs on a standard PC running the Microsoft Windows
operating system. BlueTool interfaces with the Broadcom Bluetooth chips at the HCI protocol layer. The HCI
UART is supported.
Acronyms and Abbreviations
In most cases, acronyms and abbreviations are defined on first use.
For a comprehensive list of acronyms and other terms used in Broadcom documents, go to:
http://www.broadcom.com/press/glossary.php.
Document Conventions
The following conventions may be used in this document:
Convention
Description
Bold
User input and actions: for example, type exit, click OK, press Alt+C
Code: #include <iostream>
HTML: <td rowspan = 3>
Command line commands and parameters: wl [-l] <command>
Monospace
<>
[]
Placeholders for required elements: enter your <username> or wl <command>
Indicates optional command-line parameters: wl [-l]
Indicates bit and byte ranges (inclusive): [0:3] or [7:0]
Broadcom®
June 9, 2015 • 20704-AN200-R
Over-The-Air Throughput Test Setup
Page 4
BCM20704 Application Note
Technical Support
References
The references in this section may be used in conjunction with this document.
Note: Broadcom provides customer access to technical documentation and software through its
Customer Support Portal (CSP) and Downloads and Support site (see Technical Support).
For Broadcom documents, replace the “xx” in the document number with the largest number available in the
repository to ensure that you have the most current version of the document.
Document (or Item) Name
Document Number
Source
Bundled with the BlueTool
software package.
Broadcom CSP
Broadcom Items
[1]
BTSP User’s Guide
–
[2]
Software for Exercising, Testing, Scripting,
Debugging, and Programming Devices
BlueTool-QSG1xx-R
Other Items
[3]
ActivePerl Documentation
–
[4]
General information on Perl
–
ActiveState Docs @
http://docs.activestate.com
http://www.perl.org
http://www.activestate.com
http://perl.oreilly.com
Technical Support
Broadcom provides customer access to a wide range of information, including technical documentation,
schematic diagrams, product bill of materials, PCB layout information, and software updates through its
customer support portal (https://support.broadcom.com). For a CSP account, contact your Sales or Engineering
support representative.
In addition, Broadcom provides other product support through its Downloads and Support site
(http://www.broadcom.com/support/).
Broadcom®
June 9, 2015 • 20704-AN200-R
Over-The-Air Throughput Test Setup
Page 5
BCM20704 Application Note
System Requirements
System Requirements
Host System Requirements
A personal computer running the Microsoft Windows operating system is required to use BlueTool. Broadcom
recommends running Windows XP; however, other versions of Windows are supported.
Note: BlueTool is constantly being revised, resulting in operational and other changes to the graphical
user interface. Consequently, this document only contains basic instructions on using BlueTool. These
instructions should remain the same for all BlueTool releases. If discrepancies exist between this
document and the version of BlueTool you are using, contact your Broadcom technical representative
or visit Broadcom’s CSP (see also “References” on page 5).
Hardware Requirements
The following hardware is required to use BlueTool:
•
Two USB cables.
•
Two Broadcom Bluetooth BCM20704-based devices.
•
Two UART-to-USB adapter boards.
The adapter boards are not required if using the USB transport on the BCM20704 device.
Note: Contact your Broadcom sales representative for the UART-to-USB adapter boards.
Software Requirements
BlueTool provides support for Perl scripting. If this feature is being used to automate throughput testing (see
“BlueTool Support for Perl Scripts” on page 17), a Win32 version of ActivePerl (5.8.4 or higher) must be installed
on the host computer. Earlier versions of ActivePerl are not supported.
Note: ActivePerl is available from ActiveState at www.activestate.com.
Broadcom®
June 9, 2015 • 20704-AN200-R
Over-The-Air Throughput Test Setup
Page 6
BCM20704 Application Note
System Connections
System Connections
Figure 1: System Setup
Launching BlueTool
Complete these steps to launch BlueTool and display the log window:
1. Click Start, go to All Programs, select Broadcom BlueTool, and click BlueTool to open the BlueTool
application.
2. In BlueTool application, click View and select Log Window to display the log window.
3. Click View and select Log Window Details to enable the log window to display detailed log information.
Configuring BlueTool for Throughput Testing
This section contains instructions on configuring BlueTool for over-the-air throughput testing.
•
“Setting Up the HCI Control Transport” on page 8
•
“Setting Up HCI Control” on page 10
•
“Setting Up for Throughput Testing” on page 14
Note: As shown in Figure 1 on page 7, the host PC has two UART connections. The associated COM
ports displayed in the screenshots of this section are com20 and com21. These COM ports can vary
among different test setups.
Broadcom®
June 9, 2015 • 20704-AN200-R
Over-The-Air Throughput Test Setup
Page 7
BCM20704 Application Note
Configuring BlueTool for Throughput Testing
Setting Up the HCI Control Transport
Setting Up the HCI Control Transport for Device 1
1. Click Transport and select HCI Control (keyboard shortcut CTRL+1) to display the Select HCI Control
Window Transport window.
2. Select the UART option and select or type the Device 1 COM port, and then click OK. If using the USB
transport, select the USB option and select the correct USB port, and then click OK.
BlueTool displays an HCI Control window with the selected COM port and rate displayed in the window title.
For the case of the following screenshot, the port and rate are shown as com20@115200.
Command Group list
(pull-down menu)
Broadcom®
June 9, 2015 • 20704-AN200-R
Over-The-Air Throughput Test Setup
Page 8
BCM20704 Application Note
Configuring BlueTool for Throughput Testing
Setting Up the HCI Control Transport for Device 2
1. Click Transport and select HCI Control (keyboard shortcut CTRL+1) to display the Select HCI Control
Window Transport window.
2. Select the UART option and select or type the Device 2 COM port, and then click OK. If using USB transport,
select the USB option and select the correct USB port, and then click OK.
BlueTool displays an HCI Control window with the selected COM port and rate displayed in the window title.
For the case of the following screenshot, the port and rate are shown as com21@115200.
Broadcom®
June 9, 2015 • 20704-AN200-R
Over-The-Air Throughput Test Setup
Page 9
BCM20704 Application Note
Configuring BlueTool for Throughput Testing
Setting Up HCI Control
Setting Up HCI Control for Device 1
1. In the HCI Control window, do the following to reset the device:
a. Select 7.3: Host Controller & Baseband Commands (3 key) from the Command Group list.
b. Double-click Reset to reset the device (reset status will be available in the log window)
2. If using the USB transport, skip this step.
In the HCI Control window, do the following to update the UART baud rate:
a. Select 0: Vendor-specific Commands (0 key) from the Command Group list.
b. Double-click Update_UART_Baud_Rate.
c. Select 3000000 from the Baud_Rate list and click OK.
3. In the HCI Control window, do the following to evoke the HCI Command window for setting the event filter:
a. Select 7.3: Host Controller & Baseband Commands (3 key) from the Command Group list.
b. Double-click Set_Event_Filter.
Broadcom®
June 9, 2015 • 20704-AN200-R
Over-The-Air Throughput Test Setup
Page 10
BCM20704 Application Note
Configuring BlueTool for Throughput Testing
4. In the HCI Command window, do the following to set the event filter:
a. Set Filter_Type to Connection Setup.
b. Set Connection_Setup_Filter_Condition_Type to Allow connections from all devices.
c. Set Auto_Accept_Flag to Do Auto accept the connection with role switch disabled.
d. Click OK.
5. Do the following to enable inquiry and page scanning:
a. In the HCI Control window, double-click Write_Scan_Enable
b. In the HCI Command: Write_Scan_Enable window, select Inquiry and Page Scan enabled and click
OK.
Broadcom®
June 9, 2015 • 20704-AN200-R
Over-The-Air Throughput Test Setup
Page 11
BCM20704 Application Note
Configuring BlueTool for Throughput Testing
Setting Up HCI Control for Device 2
1. In the HCI Control window, do the following to reset the device:
a. Select 7.3: Host Controller & Baseband Commands (3 key) from the Command Group list.
b. Double-click Reset to reset the device (check for Success status in the log window)
2. If using the USB transport, skip this step.
In the HCI Control window, do the following to update the UART baud rate:
a. Select 0: Vendor-specific Commands (0 key) from the Command Group list.
b. Double-click Update_UART_Baud_Rate.
c. Select 3000000 from the Baud_Rate list and click OK.
Broadcom®
June 9, 2015 • 20704-AN200-R
Over-The-Air Throughput Test Setup
Page 12
BCM20704 Application Note
Configuring BlueTool for Throughput Testing
3. Do the following to enter the Inquiry scan state:
a. In the HCI Control window, select 7.1: Link Control Commands (1 key), then double-click Inquiry.
b. In the HCI Command: Inquiry window, click OK.
BlueTool displays the Inquiry Results window, which shows the Bluetooth device address (BD ADDR) of
nearby Bluetooth devices.
4. Do the following to create a Bluetooth link between Device 1 and Device 2:
a. In the HCI Control window, double-click Create_Connection.
b. In the HCI Command: Create Connection window:
– From the BD_ADDR list, select the Bluetooth device to which a connection is to be made.
– Under Packet_Type select the packet types to be used.
– Click OK.
Broadcom®
June 9, 2015 • 20704-AN200-R
Over-The-Air Throughput Test Setup
Page 13
BCM20704 Application Note
Configuring BlueTool for Throughput Testing
Setting Up for Throughput Testing
Setting Up Device 1 for Throughput Testing
1. Click Transport and select Throughput Tests... (keyboard shortcut CTRL+3).
2. In the Select Throughput Tests Transport window, choose UART, select or type the Device 1 COM port, and
then click OK. If using USB transport, select the USB option and select the correct USB port, and then click
OK.
Broadcom®
June 9, 2015 • 20704-AN200-R
Over-The-Air Throughput Test Setup
Page 14
BCM20704 Application Note
Configuring BlueTool for Throughput Testing
3. In the Throughput Tests window, do the following in both the Transmit Test and Receive Test panes:
a. Verify that a value is generated for the connection handle.
b. Select the Data pattern option.
c. If not already selected, select ASCII, and then enter the desired data pattern (a typical ASCII data pattern
is a string of alphanumeric characters).
d. In the Count field, enter the number of bytes to be sent, being sure not to exceed the total byte limitations
of the host PC.
e. Select Synchronize with local transport, and then select the communications port for Device 2 from
the list (in the example screenshot, the communications port for Device 2 is com21@115200).
Note: Clicking the Execute Test button in the Transmit Test pane automatically selects the Receive
Test settings for the Device 2 communications port (that is, com21@115200 in the above screenshot).
Broadcom®
June 9, 2015 • 20704-AN200-R
Over-The-Air Throughput Test Setup
Page 15
BCM20704 Application Note
Configuring BlueTool for Throughput Testing
Setting Up Device 2 for Throughput Testing
1. Click Transport and select Throughput Tests... (keyboard shortcut CTRL+3).
2. In the Select Throughput Tests Transport window, choose UART, select or type the Device 2 COM port, and
then click OK. If using USB transport, select the USB option and select the correct USB port, and then click
OK.
3. In the Throughput Tests window, do the following in both the Transmit Test and Receive Test panes:
a. Verify that a value is generated for the connection handle.
b. Select the Data pattern option.
c. If not already selected, select ASCII, and then enter the desired data pattern (a typical ASCII data pattern
is a string of alphanumeric characters).
d. In the Count field, enter the number of bytes to be sent, being sure not to exceed the total byte limitations
of the host PC.
e. Select Synchronize with local transport, and then select the communications port for Device 1 from
the list (in the example screenshot, the communications port for Device 1 is com20@115200).
Note: Clicking the Execute Test button in the Transmit Test pane automatically selects the Receive
Test settings for the Device 1 communications port (that is, com20@115200 in the above screenshot).
Broadcom®
June 9, 2015 • 20704-AN200-R
Over-The-Air Throughput Test Setup
Page 16
BCM20704 Application Note
BlueTool Support for Perl Scripts
BlueTool Support for Perl Scripts
The BlueTool application Bluetooth support (BTSP) Perl module provides an interface for automating BlueTool
operations using Perl scripts. To use BlueTool scripting capabilities, ActivePerl 5.8.4 (or higher) must be installed
on the host PC prior to installing BlueTool.
Sample scripts are included with BlueTool installation software. These files are saved to the following folder
during BlueTool installation:
\\Broadcom BlueTool\Scripts
During installation, the BTSP User Guide is saved to the Broadcom\BlueTool folder. This user guide describes
the fundamentals of automating BlueTool with Perl. A PDF file reader is required to view this guide.
Note: ActivePerl software is available from ActiveState at www.activestate.com.
Note: References to general information on using Perl are provided in “References” on page 5.
Broadcom®
June 9, 2015 • 20704-AN200-R
Over-The-Air Throughput Test Setup
Page 17
BCM20704 Application Note
Broadcom® Corporation reserves the right to make changes without further notice to any products or
data herein to improve reliability, function, or design.
Information furnished by Broadcom Corporation is believed to be accurate and reliable. However,
Broadcom Corporation does not assume any liability arising out of the application or use of this
information, nor the application or use of any product or circuit described herein, neither does it
convey any license under its patent rights nor the rights of others.
®
Broadcom Corporation
5300 California Avenue
Irvine, CA 92617
© 2015 by BROADCOM CORPORATION. All rights reserved.
20704-AN200-R
June 9, 2015
Phone: 949-926-5000
Fax: 949-926-5203
E-mail: info@broadcom.com
Web: www.broadcom.com