Cypress Semiconductor CY8CKIT-042-BLE User Manual

CY8CKIT-042-BLE

Bluetooth® Low Energy (BLE)

Pioneer Kit Guide

Doc. # 001-93731 Rev. **

Cypress Semiconductor

198 Champion Court

San Jose, CA 95134-1709

Phone (USA): 800.858.1810

Phone (Intnl): +1.408.943.2600

www.cypress.com

Copyrights

© Cypress Semiconductor Corporation, 2014. The information contained here in is sub ject to change wi thout no tice. Cypress
Semiconductor Corporation assumes no responsibility for the us e of any circuitry othe r than circuitry embodied in a Cypress
product. Nor does it convey or imply any license under patent or other rights. Cypress products are not warranted nor
intended to be used for medical, life support, life saving, critical control or sa fety applicati ons, unless pursu ant to an express
written agreement with Cypress. Furthermore, Cypress does not authorize its products for use as critical components in life­support systems where a malfunction or failure may reasonably be expected to result in significant injury to the user. The
inclusion of Cypress products in life-support systems application implies that the manufacturer assumes all risk of such use
and in doing so indemnifies Cypress against all charges.

Any Source Code (software and/or firmware) is owned by Cypress Semiconductor Corporation (Cypress) and is protected by
and subject to worldwide patent protection (United States and foreign), United States copyright laws and international treaty
provisions. Cypress hereby grants to licensee a personal, non-exclusive, non-transferable license to copy, use, modify, create
derivative works of, and compile the Cypress Source Code and derivative works for the sole purpose of creating custom soft­ware and or firmware in support of licensee product to be used only in conjunction with a Cypress integrated circuit as speci­fied in the applicable agreement. Any reproduction, modification , translation, compilation, or representation of this Source
Code except as specified above is prohibited without the express written permission of Cypress.

Disclaimer: CYPRESS MAKES NO WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, WITH REGARD TO THIS
MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
FOR A PARTICULAR PURPOSE. Cypress reserves the right to make changes without further notice to the materials
described herein. Cypress does not assume any liability arising out of the application or use of any product or circuit
described herein. Cypress does not authorize its products for use as critical components in life-support systems where a
malfunction or failure may reasonably be expected to result in significant injury to the user. The inclusion of Cypress’ product
in a life-support systems application implies that the manufacturer assumes all risk of such use and in doing so indemnifies
Cypress against all charges.

Use may be limited by and subject to the applicable Cypress software license agreement.
CySmart, F-RAM, PRoC, Programmable System-on-Chip, and PSoC Creator are trademarks and PSoC and CapSense are

registered trademarks of Cypress Semiconductor Corporation. All other products and company names mentioned in this
document may be the trademarks of their respective holders.

2

Purchase of I
Philips I

C components from Cypress or one of its sublicensed Associated Companies conveys a license under the

2

C Patent Rights to use these components in an I2C system, provided that the system conforms to the I2C Standard
Specification as defined by Philips. As from October 1st, 2006 Philips Semiconductors has a new trade name - NXP
Semiconductors.

Flash Code Protection

Cypress products meet the specifications contained in their particular Cypress Datasheets. Cypress believes that its family of
products is one of the most secure families of its kind on the market today, regardless of how they are used. There may be
methods, unknown to Cypress, that can breach the code protection features. Any of these methods, to our knowledge, would
be dishonest and possibly illegal. Neither Cypress nor any other semiconductor manufacturer can guarantee the security of
their code. Code protection does not mean that we are guaranteeing the product as “unbreakable.”

Cypress is willing to work with the customer who is concerned about th e integrity of their co de. Code p rotecti on is constantly
evolving. We at Cypress are committed to continuously improving the code protection features of our products.

CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. ** 2

Contents

Safety Information 7

1. Introduction 9

1.1 Kit Contents..................................... ... ... ....................................... ... ... ... .... ..................9

1.2 Board Details ................................... ... ... ... .... ... ...................................... .... ... ... ... .... ...10

1.3 PSoC Creator™.........................................................................................................13

1.4 Getting Started...........................................................................................................14

1.5 Additional Learning Resources..................... ... ... ... ... .... ... ... ... .... ... ... ... ... .... ... ... ... .... ...14

1.6 Technical Support......................................................................................................16

1.7 Documentation Conventions......................................................................................16

1.8 Acronyms...................................................................................................................17

1.5.1 Beginner Resources.......................................................................................14

1.5.2 Application Notes...........................................................................................14

1.5.3 PSoC Creator Example Projects....................................................................15

1.5.4 Component Datasheets .................................................................................15

1.5.5 Bluetooth Learning Resources.......................................................................15

1.5.6 Learning From Peers .....................................................................................15

1.5.7 Other Related Resources...............................................................................16

2. Software Installation 19

2.1 Before You Begin.......................................................................................................19

2.2 Install Software ..........................................................................................................19

2.3 Uninstall Software......................................................................................................22

3. Kit Operation 23

3.1 Theory of Operation..................... .... ... ... ... .... ... ...................................... .... ... ... ... .... ...23

3.2 BLE Pioneer Kit USB Connection..............................................................................25

3.3 Placing Modules on Baseboard.................................................................................25

3.4 Programming and Debugging BLE Device................................................................26

3.5 Dongle Connection....................................................................................................29

3.6 USB-UART Bridge................................................................. .... ... ... ... ... .... ... ... ... .... ...31

3.7 USB-I2C Bridge.........................................................................................................32

3.8 Updating the Onboard Programmer Firmware ..........................................................34

3.9 Measure Coin-cell Power Consumption ....................................... ... ... ... .... ................34

4. Example Projects 37

4.1 Using Example Projects.............................................................................................37

4.2 Kit Test............ .... ... ... ... ... ....................................... ... ....................................... ... .......42

4.2.1 Project Description............................................................................ ... ... .... ...42

4.2.2 Hardware Connections...................................................................................43

4.2.3 Flow Chart......................................................................................................44

4.2.4 Verify Output..................................................................................................45

CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. ** 3

Contents

4.3 CapSense Slider and LED.........................................................................................46

4.3.1 Project Description.................................. .... ... ... ... ....................................... ...46

4.3.2 Hardware Connections ..................................................................................48

4.3.3 Flow Chart .....................................................................................................49

4.3.4 Verify Output..................................................................................................50

4.4 CapSense Proximity..................................................................................................62

4.4.1 Project Description.................................. .... ... ... ... ....................................... ...62

4.4.2 Hardware Connections ..................................................................................63

4.4.3 Flow Chart .....................................................................................................65

4.4.4 Verify Output..................................................................................................66

4.5 BLE Central Mode.....................................................................................................72

4.5.1 Project Description.................................. .... ... ... ... ....................................... ...72

4.5.2 Hardware Connections ..................................................................................74

4.5.3 Flow Chart .....................................................................................................75

4.5.4 Verify Output..................................................................................................76

4.6 BLE Dongle and LED Control....................................................................................79

4.6.1 Project Description.................................. .... ... ... ... ....................................... ...79

4.6.2 Hardware Connections ..................................................................................79

4.6.3 Flow Chart .....................................................................................................80

4.6.4 Verify Output..................................................................................................81

5. Hardware 83

5.1 Pioneer Baseboard....................................................................................................83

5.1.1 PSoC 5LP......................................................................................................83

5.1.2 Power System................................................................................................83

5.1.3 Programming Interface ..................................................................................89

5.1.4 Expansion Connectors...................................................................................90

5.1.5 USB Mini-B Connector...... ... ... ... .... ... ... ... .... ...................................... ... .... ... ...94

5.1.6 CapSense Circuit...........................................................................................95

5.1.7 Pioneer Board LEDs......................................................................................97

5.1.8 Push Buttons .................................................................................................98

5.1.9 Cypress Ferroelectric RAM (F-RAM).............................................................99

5.1.10 Serial Interconnection Between PSoC 5LP and Bluetooth Module .............100

5.1.11 Bluetooth Module Headers ..........................................................................102

5.2 BLE Module Board ..................................................................................................103

5.2.1 PSoC 4 BLE or PRoC BLE..........................................................................103

5.2.2 Bluetooth Module Headers (20-Pin and 24-Pin Headers)........... ... ... ...........104

5.2.3 Wiggle Antenna ...........................................................................................105

5.2.4 Antenna Matching Network.. ... ... .... .......................................... ... .................106

5.2.5 BLE Passives...............................................................................................107

5.2.6 Test Points .................... .... ... ... ....................................... ... ... .... ... .................108

5.3 BLE Dongle Board...................................................................................................108

5.3.1 Power System..............................................................................................108

5.3.2 PRoC BLE ...................................................................................................109

5.3.3 Wiggle Antenna ...........................................................................................109

5.3.4 Antenna Matching Network.. ... ... .... .......................................... ... .................109

5.3.5 USB Type A Plug....... ... .... ... ... ... .... ... ... ....................................... ... ... ... .... ....110

5.3.6 System Status LED and Power LED............................................................ 111

5.3.7 User LED ..................................................................................................... 111

5.3.8 Push Buttons ............................................................................................... 112

4 CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. **

Contents

6. Advanced Topics 113

6.1 Using PSoC 5LP as USB-UART Bridge ..................................................................113

6.2 Using PSoC 5LP as USB-I2C Bridge ......................................................................124

6.3 Developing Applications for PSoC 5LP ...................................................................132

6.3.1 Building a Bootloadable Project for PSoC 5LP. ... ... ... .... ... ... ... ... .... ... ... ... .... .132

6.3.2 Building a Normal Project for PSoC 5LP......................................................141

6.4 PSoC 5LP Factory Program Restore Instructions ...................................................142

6.4.1 PSoC 5LP is Programmed with a Bootloadable Application........................142

6.5 Using FM24V10 F-RAM...........................................................................................148

6.5.1 Address Selection........................................................................................149

6.5.2 Write/Read Operation ..................................................................................149

6.6 CySmart iOS Application .........................................................................................150

6.7 CySmart PC Tool.....................................................................................................158

A. Appendix 167

A.1 Schematics ..............................................................................................................167

A.2 Board Layout ...... ... ... ... ... ....................................... ... .... ... ... ... .... ... ... ... ... .... ... ...........175

A.3 Bill of Materials (BOM).............................................................................................183

Revision History 195

CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. ** 5

Contents

6 CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. **

Safety Information

The CY8CKIT-042-BLE boards contain electrostatic discharge (ESD)
sensitive devices. Electrostatic charges readily accumulate on the
human body and any equipment, which can cause a discharge without
detection. Permanent damage may occur on devices subjected to
high-energy discharges. Proper ESD precautions are recommended
to avoid performance degradation or loss of functionality. Store unused
CY8CKIT-042-BLE boards in the protective shipping package.

End-of-Life/Product Recycling
The end-of-life cycle for this kit is five years from the date of

manufacture mentioned on the back of the box. Contact your nearest
recycler to discard the kit.

The CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit is intended for use as a
development platform for hardware or software in a laboratory environment. The board is an open
system design, which does not include a shielded enclosure. For this reason, the board may cause
interference with other electrical or electronic devices in close proximity. In a domestic environment,
this product may cause radio interference. In such cases, the user may be requir ed to take adequate
preventive measures. Also, this board should not be used near any medical equipment or RF
devices.

The CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit is intended for use as a
development, demonstration and evaluation platform for hardware or software in a laboratory
environment. The kit is not intended for general consumer use. It generates, uses and can radiate
radio frequency energy. It has not been tested for compliance with the limits applicable under any
standard. Operation of the equipment may cause interference with radio communications, in which
case the user at his own expense will be required to take whatever measures may be required to
correct this interference. Cypress recommends that the kit only be used in a shielded room.

Attaching additional wiring to this product or modifying the product ope ration from the factory default
may affect its performance and cause interference with other apparatus in the immediate vicinity. If
such interference is detected, suitable mitigating measures should be taken.

CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. ** 7

Safety Information

General Safety Instructions

ESD Protection

ESD can damage boards and associated components. Cypress recommends that the user perform
procedures only at an ESD workstation. If an ESD workstation is not available, use appropriate ESD
protection by wearing an antistatic wrist strap attached to a grounded metal object.

Handling Boards

CY8CKIT-042-BLE boards are sensitive to ESD. Hold the board only by its edges. After removing
the board from its box, place it on a grounded, static-free surface. Use a conductive foam pad if
available. Do not slide the board over any surface.

Battery Care and Use

■ Use the correct size and type of battery specified in this guide.

■ Keep battery contact surfaces and battery compartment contacts clean by rubbing them with a

■ Remove the battery from a device when it is not expected to be in use for several months.

■ Make sure that you insert the battery into your device properly, with the + (plus) and – (minus)

■ Do not place the battery next to metallic objects such as keys and coins.

■ Never throw the battery into fire.

■ Do not open up the battery.

■ Do not short the battery.

■ Do not subject the battery to high temperatures or high humidity.

■ Store the battery in a dry place.

■ Do not recharge a battery unless it is marked “rechargeable.”

clean pencil eraser or a rough cloth each time you replace batteries.

terminals aligned correctly.

Battery Disposal

Batteries can be safely disposed of with normal household waste. Never dispose of batteries in fire
because they can explode.

It is important not to dispose of large amounts of batteries in a group. Used batteries are often not
completely “dead.” Grouping used batteries together can bring these “live” batteries into contact with
one another, creating safety risks.

8 CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. **

1. Introduction

Thank you for your interest in the CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit. This
kit is designed to showcase the functionality and ease of use of PSoC

devices while developing Bluetooth Low Energy (Bluetooth Smart) app lications. Cypress's BLE solu­tion provides an easy-to-use, intuitive GUI to configure the BLE protocol stack using a BLE compo­nent available in the Cypress standard integrated development environment (IDE), PSoC Creator.
The CySmart PC tool allows emulation of a central device and quick access to peripheral connec­tions and debugging. The solution provides a true single-chip solution with an integrated balun,
Cypress's industry-leading capacitive sensing technology, an analog front end (AFE) for biometric
sensors, and digital peripherals suited to a wide variety of applications. Designed for flexibility, this kit
offers footprint compatibility with several third-party Arduino™ shields. The kit includes a provision to

populate an extra header to support Digilent
features a CapSense
program and debug header, an F-RAM, and USB-UART/I

1.1 Kit Contents

®

®

4 BLE and PRoC™ BLE

®

Pmod™ peripheral modules. In addition, the board

slider, an RGB LED, a push-button switch, an integrated USB programmer, a

2

C bridges.

The BLE Pioneer Kit contains the following, as shown in Figure 1-1.

■ BLE Pioneer Baseboard preloaded with the CY8CKIT-142 PSoC 4 BLE Module

■ CY5671 PRoC BLE Module

■ CY5670 CySmart USB Dongle

■ Quick start guide

■ USB standard A to mini-B cable

■ Four jumper wires (4 inch) and two proximity sensor wires (5 inch)

■ Coin cell

CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. ** 9

Introduction

Figure 1-1. Kit Contents

If any part of the kit is missing, contact your nearest Cypress sales office for help: www.cypress.com/

go/support.

1.2 Board Details

The BLE Pioneer Baseboard consists of the blocks shown in Figure 1-2.

1. RGB LED

2. BLE module reset button

3. CapSense proximity header

4. User button

5. CapSense slider

6. LDO 1.9 V~5 V

7. Arduino compatible I/O header (J2)

8. Arduino compatible power header (J1)

9. Digilent Pmod compatible I/O header (J5)

10.Cyp re ss F-R A M 1 Mb (F M2 4 V10 -G)

11.PSoC 5LP I/O header (J8)

12.PSoC 5LP - programmer and debugger (CY8C5868LTI-LP039)

13.Coin cell holder (bottom side)

14.USB conn ec to r (J1 3)

15.Power LED

16.Status LED

10 CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. **

17.System power supply jumper (J16)

18.Arduino compatible I/O header (J3)

19.Arduino compatible I/O header (J4)

20.BLE power supply jumper (J15)

21.BLE module headers (J10/J11)
Figure 1-2. BLE Pioneer Baseboard Markup

Introduction

CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. ** 11

Introduction

(/%7%%"

1@1@

1@1@

1@1@

1@1@

1@1@

1@1@

1@1@

1@1@

1@1@

1@1@

7%%3(/%

1@1@

1@1@

1@1@

1@73&'

1@1@

1@1@

1@1@

93&41@

(/%1@

7%%%1@

7%%

(/%

1@

8JHHMF

BOUFOOB

,)[
DSZTUBM
CPUUPNTJEF

$NPE

$UBOL

"OUFOOB
NBUDIJOH
OFUXPSL"./

$:$-2*#-

14P$#-&EFWJDF

14P$
#-&NPEVMF
IFBEFS+

14P$
#-&NPEVMF
IFBEFS+

QJO6"35
IFBEFS

4"3CZQBTT

DBQBDJUPS

CPUUPNTJEF

(/%7%%"

1@1@

1@1@

1@1@

1@1@

1@1@

1@1@

1@1@

1@1@

1@1@

1@1@

7%%3(/%

1@1@

1@1@

1@1@

1@73&'

1@1@

1@1@

1@1@

93&41@

(/%1@

7%%%1@

7%%

(/%

8JHHMF

BOUFOOB

$NPE

$UBOL

"OUFOOB
NBUDIJOH
OFUXPSL"./

.)[

DSZTUBM

$:#--29*

13P$#-&EFWJDF

13P$
#-&NPEVMF
IFBEFS+

13P$
#-&NPEVMF
IFBEFS+

QJO6"35
IFBEFS

4"3CZQBTT

DBQBDJUPS

CPUUPNTJEF

1@

1@

1@

.)[

DSZTUBM

,)[
DSZTUBM
CPUUPNTJEF

Figure 1-3 shows a markup of the onboard components, where red BLE module denotes the PSoC 4

BLE module and black BLE module denotes the PRoC BLE module.
Figure 1-3. BLE Module Markup

12 CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. **

The Dongle board consists of the blocks shown in Figure 1-4.

13P$#-&

SFTFUCVUUPO

$:#--29*

13P$#-&EFWJDF

14P$-1
QSPHSBNNJOHUFTUQPJOUT

$:$-5*-1

14P$-1QSPHSBNNFS

BOEEFCVHHFS

6TFSCVUUPO

1PXFS-&%

64#QMVH

4UBUVT-&%

8JHHMF

BOUFOOB

"OUFOOB
NBUDIJOH

OFUXPSL

"./

.)[DSZTUBM

6TFS-&%

13P$FYUFSOBMQSPHSBNNJOHIFBEFS

,)[

DSZTUBM

CPUUPNTJEF

48%*0

48%$-,

93&4

(/%

7#64

1@

1@

Figure 1-4. BLE Dongle Markup

Introduction

1.3 PSoC Creator™

PSoC Creator is a state-of-the-art, easy-to-use integrated design environment (IDE). It introduces
revolutionary hardware and software co-design, powered by a library of preverified and
precharacterized PSoC Components™.

With PSoC Creator, you can:

■ Drag and drop PSoC Components to build a schematic of your custom design

■ Automatically place and route components and configure GPIOs

■ Develop and debug firmware using the included component APIs

PSoC Creator also enables you to tap into an entire tool e cosystem wit h integrate d compiler ch ains
and production programmers for PSoC devices.

For more information, visit www.cypress.com/psoccreator.

CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. ** 13

Introduction

1.4 Getting Started

This guide will help you get acquainted with the BLE Pioneer Kit:

■ The Software Installation chapter on page 19 describes the installation of the kit software. This

includes the PSoC Creator IDE for development and debu gging applications, PSoC Programmer
for programming hex files, and the CySmart PC Tool for BLE host emulation.

■ The Kit Operation chapter on page 23 describes the major features of the BLE Pioneer Kit and

functionalities such as programming, debugging the USB-UART and USB-I

■ The Example Projects chapter on page 37 describes multiple PSoC 4 BLE and PRoC BLE code

examples that will help you understand how to create your own BLE application using the BLE
component and device.

■ The Hardware chapter on page 83 details the hardware content of the kit and the hardware

operation.

■ The Advanced Topics chapter on page 113 explains the functionality of some features of the kit,

such as the USB-UART bridge, USB-I

■ The Appendix on page 167 provides schematics, board layouts, and the bill of materials (BOM).

2

C bridge, F-RAM, iOS app, and CySmart PC Tool.

1.5 Additional Learning Resources

Visit www.cypress.com/go/psoc4ble and www.cypress.com/procble for additional learning resources
in the form of datasheets, technical reference manuals, and application notes.

2

C bridges.

Visit www.cypress.com/go/cysmart for information on the CySmart PC tool.

1.5.1 Beginner Resources

PSoC Creator Traini ng: www.cypress.com/go/creatorstart/creatortraining

1.5.2 Application Notes

Visit www.cypress.com/appnotes to view a growing list of application notes for PSoC 3, PSoC 4,
PSoC 4 BLE, PRoC BLE, and PSoC 5LP.

14 CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. **

1.5.3 PSoC Creator Example Projects

These simple example projects demonstrate how to configure and use PSoC Creator co mponents.
To open an example proje ct in PSoC Creator, go to File > Example Project (see Figure 1-5) and
choose the required example project.

Figure 1-5. PSoC Creator Example Projects

Introduction

1.5.4 Component Datasheets

Right-click a component and select Open Datasheet (see Figure 1-6). Visit this page for the BLE
component datasheet.

Figure 1-6. Opening Component Datasheet

1.5.5 Bluetooth Learning Resources

The Bluetooth Developer Portal provides material by the Special Interest Group (SIG) for learning
various aspects of the Bluetooth Low Energy protocol and systems. Some of them are:

■ Training videos

■ GATT profiles

■ Bluetooth community forum

1.5.6 Learning From Peers

Cypress Developer Community Forums: Visit www.cypress.com/forums

CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. ** 15

Introduction

1.5.7 Other Related Resources

■ Digilent PMod: www.digilentinc.com/pmods/

■ Arduino: http://arduino.cc/en/Main/ArduinoBoardUno

1.6 Technical Support

For assistance, go to our support web page, www.cypress.com/support, or contact our customer
support at [phone] Ext. 2 (in the USA) or [phone] Ext. 2 (International).

1.7 Documentation Convent i ons

Table 1-1. Document Conventions for Guides

Convention Usage

Courier New

Italics

[Bracketed, Bold]

File > Open

Bold

Times New Roman

Text in gray boxes Describes cautions or unique functionality of the product.

Displays file locations, user entered text, and source code:

C:\...cd\icc\

Displays file names and reference documentation:
Read about the sourcefile.hex file in the PSoC Creator User Guide.

Displays keyboard commands in procedures:
[Enter] or [Ctrl] [C]

Represents menu paths:
File > Open > New Project

Displays commands, menu paths, and icon names in procedures:
Click the File icon and then click Open.

Displays an equation:

2 + 2 = 4

16 CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. **

1.8 Acronyms

Table 1-2. Acronyms Used in this Document

Acronym Definition

ADC Analog-to-Digital Converter
API Application Programming Interface
BLE Bluetooth Low Energy
CD Compact Disc
CDC Communications Device Class
COM Communication Port
DVD Digital Video Disc
ESD Electrostatic Discharge
F-RAM Ferroelectric Random Access Memory
GUI Graphical User Interface
GPIO General Purpose Input/Output
I2C Inter-Integrated Circuit
IAS Immediate Alert Service
IDAC Interconnecting Digital-Analog Converter
IDE Integrated Development Environment
ISO International Organization for Standardization
LDO Low Drop Out (voltage regulator)
LED Light-Emitting Diode
LP Low Power
LPT Line Print Terminal
PrISM Precise Illumination Signal Modulation
PRoC Programmable Radio-on-Chip
PRM Protocol Service Multiplexer
PSoC Programmable Systems-on-Chip
PWM Pulse-Width Modulation
QFN Quad Flat No-lead (package)
RGB Red Green Blue
SAR Successi ve Approximation Register
SPI Serial Peripheral Interface
SWD Serial Wire Debug
UART Universal Asynchronous Receiver Transmitter
USB Universal Serial Bus
USB CDC Universal Serial Bus Communications Device Class

Introduction

CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. ** 17

Introduction

18 CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. **

2. Software Installation

This chapter describes the steps to install the software tools and packages on a PC for using the
BLE Pioneer Kit. This includes the IDE on which the projects will be built and used for programming.

2.1 Before You Begin

All Cypress software installations require administrator privileges. However, this is not the case for
installed software. Before you install the kit software, close any other Cypress software that is
currently running.

2.2 Install Software

Follow these steps to install the BLE Pioneer Kit software:

1. Download the BLE Pioneer Kit software from www.cypress.com/CY8CKIT-042-BLE. The kit
software is available in the following formats:

a. CY8CKIT-042-BLE Kit Setup: This installation package contains the files related to the kit.

However, it does not include the Windows Installer or Microsoft .NET framework packages. If
these packages are not on your computer, the installer directs you to download and install
them from the Internet.

b. CY8CKIT-042-BLE Kit Only: This executable file installs only the kit contents, which include kit

code examples, hardware files, and user documents. This package can be used if all the
software prerequisites (listed in step 5) are installed on your PC.

c. CY8CKIT-042-BLE DVD ISO: This file is a complete package, stored in a DVD-ROM image

format, that you can use to create a DVD or extract using an ISO extraction program such as
WinZip or WinRAR. The file can also be mounted similar to a virtual CD/DVD using virtual
drive programs such as ‘Virtual CloneDrive’ and ‘MagicISO’. This file includes all the required
software, utilities, drivers, hardware files, and user documents.

2. If you have downloaded the ISO file, mount it on a virtual drive; if you do not have a virtual drive
to mount, extract the ISO contents. Double-click cyautorun.exe in the root directory of the
extracted content or mounted ISO if “Autorun from CD/DVD” is not enabled on the PC. The
installation window will appear automatically.

Note: If you are using the “Kit Setup” or “Kit Only” file, then go to step 4 for installation.

CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. ** 19

Software Installation

3. Click Install CY8CKIT-042-BLE Kit to start the kit installation, as shown in Figure 2-1.
Figure 2-1. Kit Installer Screen

4. Select the folder in which you want to install the CY8CKIT-042-BLE kit-related files. Choose the
directory and click Next.

5. When you click Next, the CY8CKIT-042-BLE Kit installer automatically installs the required
software, if it is not present on your computer. Following are the required software:
Note: Incase of Setup Only installer package, please download and install below prerequisites.

a. PSoC Creator 3.1 or later: Download the latest version from www.cypress.com/psoccreator.
b. PSoC Programmer 3.21.1 or later: This is installed as part of PSoC Creator installation

(www.cypress.com/programmer).

c. CySmart 1.0 or later: Download the latest version from www.cypress.com/go/cysmart.

20 CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. **

Software Installation

6. Choose the Typical/Custom/Complete installation type in the Product Installation Overview
window, as shown in Figure 2-2. Click Next after you select the installation type.

Figure 2-2. Product Installation Overview

7. Read the license agreement and select I accept the terms in the license agreement to
continue with installation. Click Next.

8. When the installation begins, a list of packages appears on the installation page. A green check
mark appears next to each package after successful installation.

9. Click Finish to complete the CY8CKIT-042-BLE kit installation.

10.Enter your contact information or select the check box Continue Without Contact Information.
Click Finish to complete the CY8CKIT-042-BLE kit installation.

11.After the installation is complete, the kit contents are available at the following location:

<Install_Directory>\CY8CKIT-042-BLE Kit

Default location:
Windows 7 (64-bit): C:\Program Files (x86)\Cypress\CY8CKIT-042-BLE Kit
Windows 7 (32-bit): C:\Program Files\Cypress\CY8CKIT-042-BLE Kit
Note: For Windows 7/8/8.1 users, the installed files and the folder are read only. To use the installer

example project, follow the steps outlined in the Example Projects chapter on page 37.
The kit installer also installs the CySmart PC Tool for PC. This software, along with the Dongle,

allows the PC to emulate as a BLE central device. Refer to CySmart PC Tool on page 158 for more
details on how to use the CySmart PC Tool.

CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. ** 21

Software Installation

2.3 Uninstall Software

The software can be uninstalled using one of the following methods:

■ Go to Start > All Programs > Cypress > Cypress Update Manager > Cypress Update

Manager; select the Uninstall button.

■ Go to Start > Control Panel > Programs and Features for Windows 7 or Add/Remove

Programs for Windows XP; select the Uninstall/Change button.

22 CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. **

3. Kit Operation

Status LED

Green

BLE/Arduino Compatible Headers

Proximity wire

connector

CapSense Slider

5 Segment

Reset SW

(Push Button)

USB

Mini B

PSoC 5LP

Programmer/Serial

Communication

PSoC 5LP

10 pin Prog. header

PSoC 5LP I/Os

16 pin Expansion header

PMOD header

6 pin PMOD header

ESD

Protection

MOSFET

Protection ckt

LDO

ORing

Diodes

BLE/Arduino Compatible Headers

Jumper

BLE current measuring

Coin cell

Battery holder

Power

LED Red

BLE Module I/Os

20 pin header

FRAM

I2C pull-up

via FET

ORing

Diodes

User SW

(Push Button)

BLE Module I/Os

24 pin header

VIN

VBUS

VCC

D+ / D-

VDD

BLE Reset

3.3V

~3V

SWD

I2C / SPI / UART

I2C

Voltage Ctrl

3 pin Jumper

RGB LED

MOSFET

Protection ckt

BLE SWD

10 pin Prog. header

PRoC BLE/

PSoC 4 BLE

This chapter introduces you to the BLE Pioneer kit and the features that will be used as part of the kit
operation. These primarily include USB connection, programming/debugging, and programmer firm-

ware update. The chapter also describes the USB-UART and USB-I
tools that can be used to communicate with the BLE device on the kit.

3.1 Theory of Operation

Figure 3-1, Figure 3-2, and Figure 3-3 show the block diagrams for the BLE Pioneer Baseboard,

BLE Module board, and Dongle.
Figure 3-1. BLE Pioneer Baseboard Block Diagram

2

C bridges along with the PC

The BLE Pioneer board acts as the baseboard for the PSoC 4 BLE (red module) and PRoC BLE
(black module), which can be connected to the BLE Pioneer board. The Pioneer board contains a

CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. ** 23

PSoC 5LP that is used as an onboard programmer or debugger, and for the USB-Serial interface.
The Baseboard is Arduino form factor compatible, enabling Arduino shields to be connected on top

of the board to extend the functionality of BLE modules. The board also features a 1-Mb F-RAM, an
RGB LED, a five-segment CapSense slider, a proximity header, a user switch, and a reset switch for
the PSoC 4 BLE and PRoC BLE devices on the module. The Pioneer board supports three voltage
levels: 1.9 V, 3.3 V, and 5 V.

The baseboard can also be used as a standalone programmer to program and debug other
PSoC 4 BLE/PRoC BLE devices using serial wire debug (SWD), and as a USB-Serial bridge. The
firmware on PSoC 5LP device enables bootloading over USB to upgrade the firmware.

Kit Operation

PRoC BLE/

PSoC 4

BLE

BLE I/Os

20 pin Header (Digital, Power and Ground Pins)

GPIO

GPIO

KHz

Crystal

Decaps

CMOD

SAR

Bypass Cap

CTANK

VREF

Power

RF

matching

MHz

Crystal

Test

points

4 pin

header

RX/ TX/ Gnd

BLE I/Os

24 pin Header (Analog, Power and Ground Pins)

Ferrite Bead

VDDD/A/R

Power

Power

Decaps

MATCHING

CIRCUIT

PSoC 5LP

68QFN

I2C

UART

SWD

SPI

USB

2.0

Type-A

Plug

10-Pin Programming

Header

SWD

USER Button

USER LED

XRES Button

XRES

RF

Test Points

Protection

Circuits

D+ / D-

STATUS LED
POWER LED

EXTRA GPIO

CRYSTALS

PRoC BLE

56QFN

Power

Figure 3-2. BLE Module Block Diagram

This kit includes two modules boards. These boards act as a basic breakout board for the
CY8C4247LQI-BL483 and CYBL10563-56LQXI BLE silicon. The PSoC 4 BLE and PRoC BLE
Modules are identical except for the silicon. In addition to including the PSoC 4 BLE and PRoC BLE
devices, the module boards also contain the BLE passives (resistors, capacitors, external crystals,
and antenna-matching network), an onboard antenn a, and headers for conn ecting to the Baseboard.

The Dongle is the host's wireless interface for the BLE device or project on the baseboard. The
dongle has a PRoC BLE device, configurable over various interfaces to work as expected for any
project. It also contains a PSoC 5LP, to be used as an onboard pr ogrammer or de bugger, and for the
USB-Serial interface, as shown in Figure 3-3.

The Dongle has a USB A-type plug to connect the PSoC 5LP to the USB port of the host PC. The
PSoC 5LP then communicates with the PRoC BLE device over UART or multiplexed I

2

C or an SPI
bus. The board also features a user LED, a user switch, and a reset switch for the PRoC BLE
device. The Dongle is powered directly through the USB port (VBUS) at 5.0 V.

The Dongle can also be used as a standalone programmer to program and debug other PSoC
devices (outside the dongle board) using SWD, and as a USB-Serial bridge after removing the
resistor between the SWD pins of PSoC 5LP and PRoC BLE.

Figure 3-3. BLE Dongle Block Diagram

24 CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. **

3.2 BLE Pioneer Kit USB Connection

The BLE Pioneer kit connects to a PC over the USB interface (J13) and derives power from it. The
kit enumerates as a composite device, as shown in Table 3-1.

Note: Ensure that you install the kit installer on the system for successful enumeration. To download

and install the BLE Pioneer Kit, visit www.cypress.com/go/CY8CKIT-042-BLE.
Table 3-1. BLE Pioneer Kit Enumerated Interfaces

Port Description

USB Composite Device Composite device
KitProg Programmer and debugger
KitProg USB-UART USB-UART bridge, which will appear as a COM# port

USB Input Device

Figure 3-4. KitProg Driver Installation (appearance may differ depending on Windows platform)

USB-I

2

C bridge

Kit Operation

3.3 Placing Modules on Baseboard

To connect the BLE Modules (PSoC 4 BLE or PRoC BLE) on the Baseboard, place the BLE Module
over the headers J10 and J11 while keeping the antenna on the module directing outside the
baseboard and press it. Note that the two parallel headers J10 and J11 are not equal (24-pin and
20-pin, respectively) and will not allow the BLE Module to be inserted in the opposite direction.

Figure 3-5. Baseboard with J10 and J11 Headers to connect BLE Modules

CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. ** 25

Kit Operation

To remove the BLE Modules from the BLE Pioneer kit, hold the BLE Pioneer kit in one hand and the
BLE Module in the other, as shown in Figure 3-6, and pull it out in a rocking motion.

Figure 3-6. Remove BLE Module Connected on BLE Pioneer Kit

3.4 Programming and Debugging BLE Device

The kit can be programmed and debugged using the onboard PSoC 5LP programmer and
debugger. Before programming the device, ensure that PSoC Creator and PSoC Programmer are
installed on the PC. See the section Install Software on page 19 for more information.

1. To program the device, plug the USB cable into the programming USB connector, J13, as shown

in Figure 3-7. The kit will enumerate as a composite device.

Figure 3-7. Connect USB Cable to J13

26 CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. **

Kit Operation

Mini USB PSoC 5LP

PSoC 4 BLE/

PRoC BLE

SWDCLK

Reset

SWDIO

D+

D-

2. The onboard PSoC 5LP uses SWD to program the PSoC 4 BLE or PRoC BLE device. See

Figure 3-8 for this implementation.

Figure 3-8. SWD Programming PSoC 4 BLE/PRoC BLE using PSoC 5LP

3. To load the desired example project, open PSoC Creator and go to

Workspace

4. Build the project by choosing

. This will provide the option to browse to and open your saved project.

Build > Build <Project Name> or [Shift] [F6], as shown in

Figure 3-9.

Figure 3-9. Build an Example Project

File > Open > Project/

CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. ** 27

Kit Operation

5. If there are no errors during build, program the firmware into the kit by choosing Debug >

Program

BLE Pioneer Kit and the kit will be ready f or use. For example, if the

or pressing [Ctrl] [F5], as shown in Figure 3-10. This will program the device on the

PSoC_4_BLE_Kit_Test

project is programmed successfully to the PSoC 4 BLE Module on the BLE Pioneer kit, then you
will observe the blue LED toggling every second. If debugging is needed on the project, go to
step 6.

Figure 3-10. Programming Device From PSoC Creator

6. To debug the project using PSoC Creator, choose

Debug > Debug or press [F5].

7. When the project is built and programmed into the device on the BLE Pioneer Kit, PSoC Creator
will enter the Debug mode; you can use it to debug your application. For more details on using
the debug features, see the Cypress application note Getting Started with PSoC 4 BLE.

28 CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. **

3.5 Dongle Connection

The Dongle, shown in Figure 3-11, provides the BLE Central device capability using the CySmart PC
Tool (see CySmart PC Tool on page 158) on the PC. It helps in connecting and validating the
example projects loaded on the BLE Pioneer Kit (Baseboard with one of the modules) through BLE.
The CySmart PC Tool on the PC is the interface with which to configure the Dongle and analyze the
BLE data transferred after connection with a BLE peripheral.

Figure 3-11. Dongle

Kit Operation

After being connected to the PC through a USB port, the Dongle enumerates as a composite device,
similar to the BLE Pioneer Kit. When enumerated, it allows similar features, such as programming/

debugging of the onboard PRoC BLE, USB-UART bridge, and USB-I
interface is used to communicate with the CySmart PC Tool and emulate a BLE central device on
PRoC BLE.

2

C bridge. Additionally, the

CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. ** 29

Kit Operation

The Dongle works along with the CySmart PC Tool, as shown in Figure 3-12. The CySmart PC Tool
is installed as part of the BLE Pioneer Kit in st allation. The CySmart PC Tool op eration is e xplained i n

CySmart PC Tool on page 158.

Figure 3-12. Dongle Interface on CySmart PC Tool

In case the Dongle contains custom firmware on PRoC BLE, the original CySmart firmware can be
programmed back to the Dongle to restore the Dongle functionality. Follow these steps to do the
same:

1. Connect the Dongle to the USB port on the PC.

2. Open PSoC Programmer 3.21.1 by going to

PSoC Programmer 3.21.1

> PSoC Programmer 3.21.1.

Start > All Programs > Cypress >

3. When PSoC Programmer opens, it will automatically detect the KitProg on the Dongle. Click the

File Load button and browse to the location of the BLE_Dongle_CySmart.hex file. The hex file is

located at:

C:\Program Files (x86)\Cypress\
CY8CKIT-042-BLE Kit\<version>\Firmware\BLE Dongle\Hex Files\

Figure 3-13. Open Hex File

30 CY8CKIT-042-BLE Bluetooth® Low Energy (BLE) Pioneer Kit Guide, Doc. # 001-93731 Rev. **