CSR102x Starter Development Kit Bluetooth Low Energy Single Mode SoC CSR102x is a product of Qualcomm Technologies International, Ltd.
Qualcomm Bluetooth Low Energy Terminology clarification 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. 2
Kit overview 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 CSR102x is a product of Qualcomm Technologies International, Ltd. 3
Kit Contents What s in the box Includes a Setup Guide to help get started quickly. Starter Board with Radio Module USB Flat Programming Cable CSR102x is a product of Qualcomm Technologies International, Ltd. Prototyping Jumper Cables 4
Do Not Throw The Box Away Yet! On the side of the Development Kit box, a sticker provides the following: Serial Number and most importantly Activation Code CSR102x is a product of Qualcomm Technologies International, Ltd. 5
Board Details Start Development Kit Board Overview Powered 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 CSR102x is a product of Qualcomm Technologies International, Ltd. 6
Board Details 1 2 3 4 5 6 7 Mini-USB Connector Power Select CR2032 coin cell holder Flat Cable Connector USB-SPI Debug IC SPI Interface Isolation PIO Breakout J9 8 PIO Breakout J12 9 Simple UI 10 Radio Module 11 Power Isolation Jumpers 2 3 4 1 5 6 7 8 9 10 11 CSR102x is a product of Qualcomm Technologies International, Ltd. 7
CSR1025 Radio Module 1 Printed F Antenna 4 2 Crystal Oscillator 1 2 3 5 3 4 5 Power Supply CSR1025 SoC Opt. External Flash CSR102x is a product of Qualcomm Technologies International, Ltd. 8
Power Options and Current Measurement 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. CSR102x is a product of Qualcomm Technologies International, Ltd. 9
Highlights 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 CSR102x is a product of Qualcomm Technologies International, Ltd. 10
Hands-On with the Starter Development Kit Bluetooth Low Energy Single Mode SoC
Hands On step by step 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 CSR102x is a product of Qualcomm Technologies International, Ltd. 12
Activation Code 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/csr102 x-activation and use activation code to receive access to the Qualcomm Bluetooth Low Energy SDK. CSR102x and Qualcomm Bluetooth Low Energy are product of Qualcomm Technologies International, Ltd. 13
Install SDK 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 It is recommended that all default options be accepted. CSR102x is a product of Qualcomm Technologies International, Ltd. 14
Connecting Hardware 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 CSR102x is a product of Qualcomm Technologies International, Ltd. 15
Customising Bluetooth Address S/N: 397113 Xtal Trim PPM : 14 0002-5B-03F377 Sticker on underside of Starter Development Kit 16
Bluetooth Address HTF FILE 17
Bluetooth Address Label Format BDA: 002: 5B: 03F377 HTF file format bdaddr = (0x F377, 0x 5B03, 0x 02 ) 18
Bluetooth Address Label Format BDA: 002: 5B: 03F377 HTF file format bdaddr = (0x F377, 0x 5B03, 0x 02 ) 19
Bluetooth Address Label Format BDA: 002: 5B: 03F377 HTF file format bdaddr = (0x F377, 0x 5B03, 0x 02 ) 20
Bluetooth Address Label Format BDA: 002: 5B: 03F377 HTF file format bdaddr = (0x F377, 0x 5B03, 0x 02 ) 21
Bluetooth Address Label Format BDA: 002: 5B: 03F377 HTF file format bdaddr = (0x F377, 0x 5B03, 0x 02 ) 22
Updated htf file hr_sensor.htf ############################## subsystem=ble device=smem store=0x000f # Remove the store id from the smem that is added by the SDK. app_store_id = # Bluetooth device address bdaddr = {0xF377, 0x5B03, 0x02} # Sleep mode sleep_mode = sleep_mode_deep # Battery Threshold battery_threshold = 2100 23
Customising Device Name 24
Customising 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" 25
Compile Application 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 26
Compiling the application Click on Build in the menu bar. Select Build Active Project or press F7 shortcut 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. 27
Build and Program Project Window Message Area If any errors occur they will be displayed here 28
Download Application to Hardware 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. 29
CSR8510 Bluetooth Dongle 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. Q The drivers for this dongle are supplied with the SDK CSR102x and CSR8510 are products of Qualcomm Technologies, International, Ltd. 30
Profile Demonstrator Plug in Dongle and allow it to enumerate Run CSR µenergy Profile Demonstrator Click on Discover Devices 31
Connect to your development board Locate your device name on the list Select Connect to Device 32
End to End Data exchange 33
Connecting the UI 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 sensor Press and Hold button for 5s to clear pairing LED flashes when pairing is cleared 34
Over The Air Update 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(); 35
Over The Air Update Rebuild the Heart Rate Project. This time DO NOT program the board. 36
Over The Air Update Requires the CSR8510 Dongle Open the software from the Start Menu Or 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). 37
Over The Air Update 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. 38
Over The Air Update 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. 39
Further Information There are many more profiles available all of which can be used with the Starter Development Kit 40
Qualcomm Developer Network 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 41
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.