Broadcom WICED Smart User manual

MMPWICED-Smart-QSG203-R
5300 California Avenue • Irvine, CA 92617 • Phone: [phone] • Fax: [phone] September 24, 2014
QuickStartGuide
WICEDSmart
S
WICED Smart™ Development System
Broadcom Confidential

Broadcom®, the pulse logo, Connecting everything®, WICED™, WICED™ Smart, and the Connecting
everything logo 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.
Broadcom Corporation
5300 California Avenue
Irvine, CA 92617
© 2014 by Broadcom Corporation
All rights reserved
Printed in the U.S.A.
Revision History
Revision Date Change Description
MMPWICED-Smart-QSG203-R 09/24/14 Updated:
•“Verify Driver Installation” on page 12.
• The build output on page 15.
•“USB Powered Application” on page 17.
•“Coin Cell Powered Application” on page 17.
•Figure 4 on page 17.
MMPWICED-Smart-QSG202-R 07/30/14 Updated:
• The document structure by converting to sections.
• “WICED Smart Development System Overview” on page
8.
• “Setting Up the WICED Smart SDK” on page 10.
• “Using the WICED Smart IDE” on page 13.
• Appendix B: “IDE Hints & Tips,” on page 25.
• Appendix D: “Recovering a Corrupt WICED Smart Tag,”
on page 27.
• Added:
• “Development Process” on page 9.
Removed:
• Appendix C: “Using WICED Smart SDK With Eclipse on
Linux.”
MMPWICED-Smart-QSG201-R 05/26/14 Updated:
• Figure 2: “Reset Button,” on page 14
• Figure 9: “Application Button,” on page 21
• Appendix E, “Recovering a Corrupt WICED Smart Tag”,
on page 26
• Figure 11: “Boot ROM Button Location–SW2, 3, and 4
Positions,” on page 26
MMPWICED-Smart-QSG200-R 04/02/14 Initial release for WICED Smart SDK 2.0
Broadcom Confidential

Table of ContentsWICED Smart Quick Start Guide
Broadcom®WICED Smart Development System
September 24, 2014 • MMPWICED-Smart-QSG203-R Page 3
Table of Contents
About This Document..................................................................................................................................6
Purpose and Scope................................................................................................................................. 6
Audience ................................................................................................................................................. 6
Acronyms and Abbreviations................................................................................................................... 6
Document Conventions........................................................................................................................... 6
References.............................................................................................................................................. 7
Technical Support........................................................................................................................................ 7
Section 1: WICED Smart Development System Overview...............................................8
WICED Smart Tag......................................................................................................................................... 8
Software Development Kit........................................................................................................................... 8
Directory Structure....................................................................................................................................... 9
Hardware and Software Requirements....................................................................................................... 9
Development Process..................................................................................................................................9
Section 2: Setting Up the WICED Smart SDK .................................................................10
Windows Instructions................................................................................................................................10
Install the WICED Smart SDK and IDE................................................................................................. 10
Connect the WICED Smart Tag............................................................................................................ 11
Verify Driver Installation ........................................................................................................................ 12
Section 3: Using the WICED Smart IDE...........................................................................13
Build and Load a Sample Application...................................................................................................... 13
Run an Application..................................................................................................................................... 17
USB Powered Application ..................................................................................................................... 17
Coin Cell Powered Application.............................................................................................................. 17
Application Test Example...................................................................................................................... 18
Viewing Traces from the WICED Smart Tag ............................................................................................ 19
What Now.................................................................................................................................................... 21
Appendix A: Testing a WICED Smart Tag with Windows 8...........................................22
The Hello Sensor Tag Application.........................................................................................................22
The Hello Client PC Application ............................................................................................................ 23
Testing the Hello Application................................................................................................................. 24
Appendix B: IDE Hints & Tips ..........................................................................................25
Hints ...................................................................................................................................................... 25
Shortcuts ............................................................................................................................................... 25
Appendix C: Multiple WICED Smart Tags .......................................................................26
Appendix D: Recovering a Corrupt WICED Smart Tag..................................................27
Broadcom Confidential

List of FiguresWICED Smart Quick Start Guide
Broadcom®WICED Smart Development System
September 24, 2014 • MMPWICED-Smart-QSG203-R Page 4
List of Figures
Figure 1: WICED Smart Tag .............................................................................................................................. 8
Figure 2: WICED Smart IDE ............................................................................................................................14
Figure 3: Reset Button ..................................................................................................................................... 16
Figure 4: Coin Cell Power Switch Positions..................................................................................................... 17
Figure 5: LightBlue iOS Application Showing the WICED Smart Tag Heart Rate Monitor Application............ 18
Figure 6: Configure UART for Tracing ............................................................................................................. 19
Figure 7: Connecting the WICED Smart Tag to a PC Running Windows 8.....................................................22
Figure 8: HelloClient Select Device Window.................................................................................................... 23
Figure 9: HelloClient Application......................................................................................................................24
Figure 10: Application Button........................................................................................................................... 24
Figure 11: Configuration for Two WICED Smart Tags.....................................................................................26
Figure 12: Boot ROM Button Location—SW2, SW3, and SW4 Positions....................................................... 27
Broadcom Confidential

List of TablesWICED Smart Quick Start Guide
Broadcom®WICED Smart Development System
September 24, 2014 • MMPWICED-Smart-QSG203-R Page 5
List of Tables
Table 1: Overview of the WICED Smart SDK Top-Level Directory....................................................................9
Broadcom Confidential

About This Document
Broadcom®WICED Smart Development System
September 24, 2014 • MMPWICED-Smart-QSG203-R Page 6
WICED Smart Quick Start Guide
About This Document
Purpose and Scope
This document provides detailed instructions to set up the Broadcom®Wireless Internet Connectivity for
Embedded Devices (WICED; pronounced "wick-ed") Smart development system.
The WICED™Smart development system supports application development using a WICED Smart Tag. The
development system is compatible with the Windows, OS X, and Linux operating systems. This document
describes the software components included in the WICED Smart development system and provides
instructions for compiling WICED Smart sample applications using the WICED Smart Integrated Development
Environment (IDE).
The instructions in this document must be completed before the WICED Smart SDK and WICED Smart Tag can
be used.
Audience
This document is for software developers who are using the WICED Smart Development System to create
applications for Broadcom Bluetooth Smart devices.
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:
Note: This document applies to WICED Smart SDK 2.1.x.
Convention Description
Bold Buttons, tabs, lists and other GUI items: click Next, select the Startup tab.
Monospace Command lines and application outputs:
hello_sensor-BCM920737TAG_Q32 download
< > Placeholders for required elements: <WICED-Smart-SDK>
' ' Application Names, Configuration Parameters: 'heart_rate_monitor'
Broadcom Confidential

Technical Support
Broadcom®WICED Smart Development System
September 24, 2014 • MMPWICED-Smart-QSG203-R Page 7
WICED Smart Quick Start Guide
References
The references in this section may be used with this document.
For Broadcom documents, replace the "xx" in the document number with the largest number available to ensure
you have the most current version of this document.
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.
Customers who work directly with Broadcom, can acquire technical documentation and software from the
Broadcom CSP (support.broadcom.com). For a CSP account, contact your Broadcom Sales or Engineering
support representative.
Customers who work with Broadcom through a distribution channel can acquire technical documentation and
software from the Broadcom Support Community website (community.broadcom.com).
Note: Customers who work directly with Broadcom can acquire technical documentation and software
from the Broadcom Customer Support Portal (CSP) (support.broadcom.com). Customers who work
with Broadcom through a distribution channel can acquire technical documentation and software from
the Broadcom Support Community website (community.broadcom.com).
Document (or Item) Name Number Source
[1] WICED™Smart Tag User Guide 920737TAG03-HWUM1xx-R WICED Smart SDK
[2] Smart Designer: Using the WICED SMART IDE to
Develop Custom Applications WICED-SWUM10x-R WICED Smart SDK
[3] BCM20736 Data Sheet 20736-DS100-R Broadcom CSP
[4] BCM20737 Data Sheet 20737-DS100-R Broadcom CSP
Broadcom Confidential

WICED Smart Development System OverviewWICED Smart Quick Start Guide
Broadcom®WICED Smart Development System
September 24, 2014 • MMPWICED-Smart-QSG203-R Page 8
Section 1: WICED Smart Development
System Overview
The WICED Smart development system is composed of a WICED Smart tag, the WICED Smart Software
Development Kit (SDK), and the WICED Smart Integrated Development Environment (IDE).
WICED Smart Tag
The Broadcom WICED Smart tag (Figure 1) incorporates a Broadcom BCM20737 Bluetooth Smart chip and
additional circuitry to enable programming, debugging, and evaluation of Bluetooth Smart applications. The
BCM20737TAG supports a superset of BCM20736 and BCM20737 features.
The BCM20737TAG, included in the BCM92073X_LE_KIT, can be used for feature evaluation, debugging, and
developing Bluetooth Smart applications for either the BCM20736 or the BCM20737. For final production, the
desired feature must be mapped to the chip that it is available on. Refer to the specific chip's data sheet or the
product brief for that purpose.
Figure 1: WICED Smart Tag
Software Development Kit
The WICED Smart SDK includes:
• Bluetooth Smart software stack including GAP, ATT, GATT, and SMP profiles
• Generic profile-level API
• Drivers to access onboard peripherals including UART, SPI, I2C, ADC, PWM, Keyscan, etc.
• Reference applications for the devices with profiles defined by the Bluetooth SIG
• WICED Smart API documentation and related documents
• Utilities to support development in Windows, OS X, and Linux environments
Broadcom Confidential

Directory StructureWICED Smart Quick Start Guide
Broadcom®WICED Smart Development System
September 24, 2014 • MMPWICED-Smart-QSG203-R Page 9
Directory Structure
Table 1 is an overview of the top-level directory of the WICED Smart SDK.
Hardware and Software Requirements
• The WICED Smart SDK runs on 32- and 64-bit versions of Microsoft Windows, OS X, and Linux.
• The SDK is distributed as:
– A standalone 7zip file suitable for all operating systems.
– A bundle with the WICED Integrated Development Environment as an executable installer for Windows
and the Mac operating systems.
• The development computer requires a single USB port to connect to the WICED Smart tag.
Development Process
To prepare and run an application, perform the following high-level steps:
1. Download and install the WICED Smart SDK and IDE “Install the WICED Smart SDK and IDE” on page 10.
2. Connect the WICED Smart tag (see “Connect the WICED Smart Tag” on page 11.)
3. Create and load an application (see “Build and Load a Sample Application” on page 13 and Reference [2]
on page 7).
4. Run the application (see “Run an Application” on page 17).
Table 1: Overview of the WICED Smart SDK Top-Level Directory
WICED-Smart SDK Directories Directory Contents
Apps ROM & RAM-based example applications
Doc API, reference documentation, and schematics
Drivers Windows USB-serial drivers for the WICED Smart tag
include WICED API function prototypes, constants, and defaults
Platforms Configuration files and information for supported hardware
platforms
Tools Tool chain including compiler, download tool, and other
utilities/scripts
Wiced-Smart WICED Smart core Bluetooth components
Note: The 7zip extraction utility is available from 7-zip.org. 7zip is needed to extract the standalone
WICED Smart SDK 7zip archive. The standard Windows zip file extraction utility may silently corrupt
the SDK archive during the extraction process. Do NOT use it.
Broadcom Confidential

Setting Up the WICED Smart SDKWICED Smart Quick Start Guide
Broadcom®WICED Smart Development System
September 24, 2014 • MMPWICED-Smart-QSG203-R Page 10
Section 2: Setting Up the WICED Smart
SDK
Download the WICED Smart SDK from the Broadcom Support Community website (community.broadcom.com)
or from the Broadcom Customer Support Portal (support.broadcom.com).
Windows Instructions
Install the WICED Smart SDK and IDE
The WICED Smart SDK is provided as a self-installing executable file. Double-click the Wiced-Smart-SDK-
2.x.x-IDE-Installer.exe file to begin the installation. A setup window similar to the screenshot below is displayed.
After being presented with the above screen:
1. Click Next to continue with the installation.
2. In the Choose IDE Install Folder window, choose the IDE installation folder and click Next.
3. In the Choose SDK Install Folder window, choose the SDK installation folder and click Next.
4. In the Pre-Installation Summary window, click Next to install using the current IDE and SDK folder
selections. (Click Previous once or twice to modify the SDK and/or IDE installation folders, respectively.)
After installation has completed, start the WICED Smart IDE by using the WICED Smart IDE desktop icon.
Broadcom Confidential