CSR102x Starter Development Kit
Bluetooth® Low Energy Single Mode SoC
CSR102x is a product of Qualcomm Technologies International, Ltd.
2
In this document you will notice a number of references are made to Qualcomm Bluetooth Low Energy SDK. While this is the official name of the SDK moving forward, within the actual SDK you will see it currently referred to as CSR µEnergy. In addition, many of the directories and folders may have the CSR µEnergy SDK naming convention. Please be assured these are the same thing.
Thank you for your understanding while we take the necessary steps to phase out the use of CSR µEnergy across our product lines.
Terminology clarificationQualcomm® Bluetooth® Low Energy
3
Bluetooth Smart Starter Development Kit• Part number: DK-CSR1025-10285-1A SRP $99• What’s in the box• Hands-on with the Starter Development Kit
Kit overviewCSR102x Starter Development Kit
CSR102x is a product of Qualcomm Technologies International, Ltd.
4
• What’s in the boxIncludes a Setup Guide to help get started quickly.
Kit ContentsCSR102x Starter Development Kit
Starter Board with Radio Module USB Flat ProgrammingCable
Prototyping Jumper CablesCSR102x is a product of Qualcomm Technologies International, Ltd.
5
CSR102x Starter Development Kit
On the side of the Development Kit box, a sticker provides the following:• Serial Number
and – most importantly…
• Activation Code
Do Not Throw The Box Away Yet!
CSR102x is a product of Qualcomm Technologies International, Ltd.
6
CSR102x Starter Development Kit
Start Development Kit Board OverviewPowered from USB or Coin Cell
Simple UI (Button and LED)
Breakout pins (J9, J12) available for rapid prototyping
Can be configured as a programmer for external CSR102x boards using External Debug Connector and the flat programming connector
Board Details
CSR102x is a product of Qualcomm Technologies International, Ltd.
7
CSR102x Starter Development KitBoard Details
4
9
2
11
3
1 5
6
7
8
10
12345
Mini-USB ConnectorPower SelectCR2032 coin cell holderFlat Cable ConnectorUSB-SPI Debug IC
6789
10
SPI Interface IsolationPIO Breakout J9PIO Breakout J12Simple UIRadio Module
11 Power Isolation JumpersCSR102x is a product of Qualcomm Technologies International, Ltd.
8
CSR102x Starter Development KitCSR1025 Radio Module
12
4
3 5
1
2
3
4
5
Printed F Antenna
Crystal Oscillator
Power Supply
CSR1025 SoC
Opt. External Flash
CSR102x is a product of Qualcomm Technologies International, Ltd.
9
CSR102x Starter Development Kit
Jumper selectable between USB (3V3 nominal) and CR2032 coin cell.
Replacing jumper with an ammeter inline allows accurate measurement of full system current.
To achieve an accurate SLEEP current measurement it is usually necessary to remove the SPI jumpers, as Debug SPI activity can interfere with SLEEP states.
Power Options and Current Measurement
CSR102x is a product of Qualcomm Technologies International, Ltd.
10
CSR102x Starter Development Kit
• Comprehensive Software Development Kit (SDK)
• PIO headers to allow connection of sensors, daughter boards, and rapid prototyping
• On-board SPI-Debug and programmer
• Option of battery or USB power
• Competitive price of USD $99
Highlights
CSR102x is a product of Qualcomm Technologies International, Ltd.
Hands-On with the Starter Development Kit
Bluetooth® Low Energy Single Mode SoC
12
CSR102x Starter Development Kit
The following guide demonstrates how to compile and program an application for the Starter Development Kit
•Download and Install SDK
•Compile and Download an example application
•Connect to Host
•Simple UI
Hands On – step by step
CSR102x is a product of Qualcomm Technologies International, Ltd.
13
CSR102x Starter Development Kit
The activation code (located on the packaging of the development kit) allows you to download new software and updates to the SDK
Register on https://developer.qualcomm.com/csr102x-activation and use activation code to receive access to the Qualcomm® Bluetooth™ Low Energy SDK.
Activation Code
CSR102x and Qualcomm Bluetooth Low Energy are product of Qualcomm Technologies International, Ltd.
14
CSR102x Starter Development Kit
This example shall utilise the Heart Rate example application,which is part of the Health and Fitness application package.
Therefore in order to proceed both of the following must be installed• uEnergy SDK v3.0.3 (or later)• CSR uEnergy SDK Health and Fitness Package 3.0.2.9 (or later)
• These can be downloaded from https://developer.qualcomm.com/hardware/csr102x/tools/activation-codes
Install SDK
CSR102x is a product of Qualcomm Technologies International, Ltd.
It is recommended that all default options be accepted.
15
CSR102x Starter Development Kit
• Remove the Target board from the anti-static packaging
• Connect the smaller connector of the mini-USB cable to the Target board USB port
• Connect the other end of the mini-USB cable to a free USB port on the development PC
• The device drivers necessary to connect to the target board are installed with the SDK and drivers should load automatically when connected to the PC
Connecting Hardware
CSR102x is a product of Qualcomm Technologies International, Ltd.
16
CSR102x Starter Development KitCustomising Bluetooth Address
CSR102x is a product of Qualcomm Technologies, International, Ltd.
S/N: 397113Xtal Trim PPM : 140002-5B-03F377
Sticker on underside of Starter Development Kit
17
CSR102x Starter Development KitBluetooth Address – HTF FILE
CSR102x is a product of Qualcomm Technologies, International, Ltd.
18
CSR102x Starter Development KitBluetooth Address
002 5B 03F377: :
F377 035B 02HTF file format bdaddr = (0x , 0x , 0x )
Label Format BDA:
CSR102x is a product of Qualcomm Technologies, International, Ltd.
19
002
CSR102x Starter Development KitBluetooth Address
Label Format BDA:
F377 035B 02
5B 03F377: :
HTF file format bdaddr = (0x , 0x , 0x ) 02
CSR102x is a product of Qualcomm Technologies, International, Ltd.
20
5B
CSR102x Starter Development KitBluetooth Address
F377 035B 02
002 03F377: :
5B
Label Format BDA:
HTF file format bdaddr = (0x , 0x , 0x )
CSR102x is a product of Qualcomm Technologies, International, Ltd.
21
HTF file format bdaddr = (0x , 0x , 0x ) 03F377
03F377
CSR102x Starter Development KitBluetooth Address
5B 02
002 5B: :Label Format BDA:
CSR102x is a product of Qualcomm Technologies, International, Ltd.
22
CSR102x Starter Development KitBluetooth Address
002 5B 03F377: :
F377 035B 02
Label Format BDA:
HTF file format bdaddr = (0x , 0x , 0x )
CSR102x is a product of Qualcomm Technologies, International, Ltd.
23
CSR102x Starter Development Kit
hr_sensor.htf
Updated htf file
##############################subsystem=bledevice=smemstore=0x000f# Remove the store id from the smem that is added by the SDK.app_store_id =# Bluetooth device addressbdaddr = {0xF377, 0x5B03, 0x02}# Sleep modesleep_mode = sleep_mode_deep# Battery Thresholdbattery_threshold = 2100…
CSR102x is a product of Qualcomm Technologies, International, Ltd.
24
CSR102x Starter Development KitCustomising Device Name
CSR102x is a product of Qualcomm Technologies, International, Ltd.
25
CSR102x Starter Development KitCustomising Device Name
/* Macro for the device name */#define DEVICE_NAME "CSR HR Sensor"
For example – make use of the board Serial Number.
/* Macro for the device name */#define DEVICE_NAME “HR Sensor 397113"
CSR102x is a product of Qualcomm Technologies, International, Ltd.
26
CSR102x Starter Development Kit
No further customisation should be necessary.We are now ready to program the board.
• Compile the Heart Rate Project
• Download the Heart Rate project to the hardware
Compile Application
CSR102x is a product of Qualcomm Technologies, International, Ltd.
27
CSR102x Starter Development Kit
Click on Build in the menu bar .
Select Build Active Project or press F7 short-cut key.
This builds all the files included in the Active project from the current Workspace into an application image for the target board.
The build is incremental, minimum set of builds are performed to reflect changes to source files and configurations.
The target board should remain connected during compilation.
Compiling the application
CSR102x is a product of Qualcomm Technologies, International, Ltd.
28
CSR102x Starter Development KitBuild and Program
Project Window
Message Area
If any errors occur they will be displayed hereCSR102x is a product of Qualcomm Technologies, International, Ltd.
29
CSR102x Starter Development Kit
Select Run from the Debug menu or press the F5 short-cut key
At this point the Heart Rate application will be running on the hardware.
• It will stop advertising after a couple of minutes
• The button can be connected up to PIO11 with a jumper cable to re-enable adverts (this can also be achieved by power cycling the board via the mini USB cable)
For more details on the heart rate application see the Heart Rate Sensor Application Note in the project source directory.
Download Application to Hardware
CSR102x is a product of Qualcomm Technologies, International, Ltd.
30
CSR102x Starter Development KitCSR8510 Bluetooth Dongle
Q
In order to connect to the development kit you need a suitable host.
The “Profile Demonstrator” software is supplied as part of the SDK. This requires a compatible Bluetooth dongle to communicate with the peripheral device.
The CSR8510 dongle is available to perform this function.
The drivers for this dongle are supplied with the SDK
CSR102x and CSR8510 are products of Qualcomm Technologies, International, Ltd.
31
CSR102x Starter Development KitProfile Demonstrator
Plug in Dongle and allow it to enumerate
Run CSR µEnergy Profile Demonstrator
Click on Discover Devices
CSR102x is a product of Qualcomm Technologies, International, Ltd.
32
CSR102x Starter Development Kit
Locate your device name on the list
Select “Connect to Device”
Connect to your development board
CSR102x is a product of Qualcomm Technologies, International, Ltd.
33
CSR102x Starter Development KitEnd to End Data exchange
CSR102x is a product of Qualcomm Technologies, International, Ltd.
34
CSR102x Starter Development KitConnecting the UI
CSR102x is a product of Qualcomm Technologies, International, Ltd.
The Heart Rate Sensor application includes a basic UI by default
PIO 11 = Button (Wake / Clear Pairing)PIO 15 = Buzzer/LED status indicator
Use the test cables supplied with the kit to connect these together as shown.
Press Button to wake the HR sensorPress and Hold button for 5s to clear pairingLED flashes when pairing is cleared
35
CSR102x Starter Development KitOver The Air Update
CSR102x is a product of Qualcomm Technologies, International, Ltd.
Lets make a simple change to the software - make the UI pulse when a new value is transmitted.SoundBuzzer(buzzer_beep_short);(In our case we have connected the LED to the UI indicator pin)
In main_app.c, find hrMeasTimerHandler (used to periodically send an update to the host)Add the SoundBuzzer call just before SendHRMeasurement();
36
CSR102x Starter Development KitOver The Air Update
CSR102x is a product of Qualcomm Technologies, International, Ltd.
Rebuild the Heart Rate Project.
This time DO NOT program the board.
37
CSR102x Starter Development KitOver The Air Update
CSR102x is a product of Qualcomm Technologies, International, Ltd.
Requires the CSR8510 Dongle
Open the software from the Start MenuOr run the EXE from the demo directory in the install path
Ensure that you have cleared any existing pairing from your HR sensor board (press the button for 5 sec and observe the LED flash).
38
CSR102x Starter Development KitOver The Air Update
CSR102x is a product of Qualcomm Technologies, International, Ltd.
When the update is in progress, the software will attempt to connect to the OTA service on the board.
If the protocol confirms that the receiving unit is compatible with the binary file to transmit, then the upgrade process will begin.
When in progress – the %completion in the status window plus a progress bar will indicate progress.
This update happens in the background – the normal operation is not affected
When complete, the system re-boots into the new image.
39
CSR102x Starter Development KitOver The Air Update
CSR102x is a product of Qualcomm Technologies, International, Ltd.
Reconnect to the board from Profile Demonstrator
You must clear pairing on your board (press and hold the button for 5 seconds)
Once connected, if the application update has been successful you should now see the LED flash every Connection Interval whilst the board is connected to the Profile Demonstrator software.
40
CSR102x Starter Development KitFurther Information
CSR102x is a product of Qualcomm Technologies, International, Ltd.
There are many more profiles available all of which can be used with the Starter Development Kit
41
CSR102x Starter Development KitQualcomm Developer Network
CSR102x is a product of Qualcomm Technologies, International, Ltd.
https://developer.qualcomm.com/hardware/csr102x/csr102x-product-family
Overview of chipsets and development kits available.
Training slides including:
• Introduction to Bluetooth Low Energy• Product Line Overview• Hardware Overview• Introduction to CSRmesh• OTAU Overview• SDK Overview
Thank you
Follow us on:For more information, visit us at: www.qualcomm.com & www.qualcomm.com/blog
Nothing in these materials is an offer to sell any of the components or devices referenced herein.
©2016 Qualcomm Technologies, Inc. and/or its affiliated companies. All Rights Reserved.
Qualcomm is a trademark of Qualcomm Incorporated, registered in the United States and other countries. Other products and brand names may be trademarks or registered trademarks of their respective owners.
References in this presentation to “Qualcomm” may mean Qualcomm Incorporated, Qualcomm Technologies, Inc., and/or other subsidiaries or business units within the Qualcomm corporate structure, as applicable. Qualcomm Incorporated includes Qualcomm’s licensing business, QTL, and the vast majority of its patent portfolio. Qualcomm Technologies, Inc., a wholly-owned subsidiary of Qualcomm Incorporated, operates, along with its subsidiaries, substantially all of Qualcomm’s engineering, research and development functions, and substantially all of its product and services businesses, including its semiconductor business, QCT.