Download Print this page
Silicon Laboratories QSG120 Quick Start Manual
Silicon Laboratories QSG120 Quick Start Manual

Silicon Laboratories QSG120 Quick Start Manual

Silicon labs appbuilder-based bluetooth smart c-sdk

Advertisement

Quick Links

QSG120: Silicon Labs AppBuilder-Based
Bluetooth® Smart C-SDK Quick-Start
Guide
This quick-start guide provides basic information on configuring,
building, and installing both SoC and NCP Bluetooth Smart appli-
cations using the AppBuilder-based C-SDK and an EFR32™BG
or Blue Gecko Module Wireless Starter Kit.
This guide is designed for new users of the Silicon Labs AppBuilder-based Bluetooth
Smart C-SDK. It provides instructions to get started using the example applications
provided with the C-SDK to demonstrate different Bluetooth Smart functionality.
silabs.com | Smart. Connected. Energy-friendly.
KEY FEATURES
• Product overview
• Setting up your development environment
• Discovering the Bluetooth Smart C-SDK
• Working with example applications using
the SoC or NCP demo for Smart Phone
• About other example applications
• Flashing the pre-built demonstration files
Rev. 1.1

Advertisement

loading
Need help?

Need help?

Do you have a question about the QSG120 and is the answer not in the manual?

Questions and answers

Summary of Contents for Silicon Laboratories QSG120

  • Page 1 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide This quick-start guide provides basic information on configuring, KEY FEATURES building, and installing both SoC and NCP Bluetooth Smart appli- cations using the AppBuilder-based C-SDK and an EFR32™BG • Product overview or Blue Gecko Module Wireless Starter Kit.
  • Page 2: Product Overview

    QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Product Overview 1. Product Overview Before following the procedures in this guide you must have • Purchased your Bluetooth Smart Wireless Starter Kit (WSTK). • SLWSTKT6020A EFR32BG Wireless Starter Kit or •...
  • Page 3 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Product Overview 1.4 Documentation The SDK installer provides a documentation index (in documentation/index.htm and also linked from a Start Menu entry) that contains links to documentation locations. Simplicity Studio provides links to hardware documentation and other appnotes.
  • Page 4 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Setting Up Your Development Environment 2. Setting Up Your Development Environment 2.1 Install Third-Party Tools Install third-party tools, such as IAR Embedded Workbench for ARM and its associated files (see section 1.2 Software Components...
  • Page 5 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Setting Up Your Development Environment 2.4 Install Simplicity Studio During installation, Simplicity Studio obtains updates and additional packages specific to your connected hardware. 1. As soon as Simplicity Studio launches, it searches for updates. This operation can take several minutes.
  • Page 6 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Setting Up Your Development Environment 3. Simplicity Studio then installs software packages related to your connected hardware. This procedure can take some time, during which the green progress indicator may appear stationary. However, the update steps above the progress indicator are continuous- ly refreshed.
  • Page 7 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Setting Up Your Development Environment Figure 2.6 Kit Selection Dialog 7. A part selection dialog is displayed. Your connected part should be selected. Click [Next >]. Figure 2.7 Part Selection Dialog 8.
  • Page 8 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Setting Up Your Development Environment Figure 2.8 Build Environment Configuration 9. The software sample applications were tested with the WSTK Board Controller Software Build 435. This WSTK firmware package or later must be installed on your kit. To update your WSTK board controller firmware, click on the Kit Manager tile in the Simplicity perspective.
  • Page 9 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Setting Up Your Development Environment 2.5 Navigation in Simplicity Studio Simplicity Studio is built on the Eclipse platform. As such, it is broken up into different “perspectives,” each of which allows access to a specific set of functionality.
  • Page 10 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Discovering the Bluetooth Smart C-SDK 3. Discovering the Bluetooth Smart C-SDK If you are discovering the C-SDK from the Build Environment Configuration Add … step described in section 2.4 Install Simplicity Stu- dio, go to step 4.
  • Page 11 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Discovering the Bluetooth Smart C-SDK Figure 3.3 Add SDKs 6. Click [OK] to return to the starting configuration page. 7. Click [Finish] (from initial configuration) or [OK] (from the settings icon).
  • Page 12 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Working with Example Applications 4. Working with Example Applications When working with example applications in the Silicon Labs AppBuilder-based Bluetooth Smart C-SDK, you will execute the following steps: 1. Select an example application.
  • Page 13 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Working with Example Applications 4.1 Selecting an Example Application The Bluetooth Smart C-SDK comes with a number of example applications. This guide provides instructions for building, loading, and interacting with the both the SoC and NCP variants of the Demo for the Smart Phone App. See section 5.
  • Page 14 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Working with Example Applications Figure 4.2 New Example Project Dialog 3. Click [Next]. 4. Select an example from the list. For the purposes of this guide, select either the SoC demo for Smart Phone App or the NCP demo for Smart Phone App.
  • Page 15 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Working with Example Applications Figure 4.4 Project Configuration Dialog silabs.com | Smart. Connected. Energy-friendly. Rev. 1.1 | 14...
  • Page 16 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Working with Example Applications 4.2 Generating the Application Source Files 1. When you finish creating your example project, an AppBuilder General tab opens. Click [Generate]. Figure 4.5 AppBuilder General Tab 2. In the Overwrite Dialog, if necessary, uncheck ble-xxx-callbacks.c, and check efr32xxx.hwconf. Click [OK].
  • Page 17 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Working with Example Applications Figure 4.7 Generation Confirmation Dialog 4.3 Flashing and Interacting with the Application The procedure to flash and run the application differs depending on whether you are using an SoC example or an NCP example.
  • Page 18 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Working with Example Applications 4.3.1 SoC Example 1. After you click [OK] on the Generation Confirmation dialog, the AppBuilder General tab returns. Click the Debug control to compile and flash the application to the EFR32.
  • Page 19 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Working with Example Applications Figure 4.10 Debug Window Resume Control Next to the Resume control are Suspend, Disconnect, Reconnect, and Stepping controls. Click the Disconnect control when you are ready to exit Debug mode.
  • Page 20 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Working with Example Applications Figure 4.13 Blue Gecko App - SoC Results 6. Touch the device (image b). The app displays the measured temperature, and a fixed timestamp (image c). To demonstrate the retail beacon mode, briefly (< 2s) press PB0 on the WSTK until the display changes to BEACON MODE. Touch Retail Beacon on the Blue Gecko app.
  • Page 21 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Working with Example Applications 4.3.2 NCP Example 1. After you have generated the example, open a console window and change to the project folder. A .mk file should be in the list of files in that directory Figure 4.15 Project Folder List...
  • Page 22 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Working with Example Applications Figure 4.17 Flash Programmer Tile 5. In the Flash Programmer dialog, click [Browse] to go to the exe-target folder and select the hex binary image. Figure 4.18 Flash Programmer Dialog silabs.com | Smart.
  • Page 23 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Working with Example Applications 6. After you have selected the image, click [Program]. A dialog shows the procedure’s progress. Wait until flashing has completed and the dialog closes. Figure 4.19 Flash Progress 7.
  • Page 24 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Working with Example Applications Figure 4.22 Blue Gecko App - NCP Results 10. Touch the device (image b). The app displays a fixed temperature, and an actual timestamp (image c). The other functions are the same as for the SoC version. To demonstrate the retail beacon mode, briefly (< 2s) press PB0 on the WSTK until the display changes to BEACON MODE.
  • Page 25 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide About Other Example Applications 5. About Other Example Applications Most of the other example applications are available in both SoC and NCP versions and are built and flashed to the EFR32BG using the same procedures as described for the Demo example.
  • Page 26 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide About Other Example Applications • Apple Notification Center - client: The Apple Notification Center Service (ANCS) gives Bluetooth accessories that connect to iOS devices through a Bluetooth low-energy link a simple and convenient way to access many kinds of notifications generated on iOS devices.
  • Page 27 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Flashing the Pre-Built Demonstration Files 6. Flashing the Pre-Built Demonstration Files The SoC examples also are provided as pre-built binary files, ready to be flashed and used. 1. In the Simplicity perspective, click the Demos tile.
  • Page 28 QSG120: Silicon Labs AppBuilder-Based Bluetooth® Smart C-SDK Quick-Start Guide Flashing the Pre-Built Demonstration Files Figure 6.3 Flash Progress silabs.com | Smart. Connected. Energy-friendly. Rev. 1.1 | 27...
  • Page 29 The products are not designed or authorized to be used within any Life Support System without the specific written consent of Silicon Laboratories. A "Life Support System" is any product or system intended to support or sustain life and/or health, which, if it fails, can be reasonably expected to result in significant personal injury or death.