Bluetooth Low Energy (BLE) Pioneer Kit Guide CY8CKIT-042-BLE. Doc. # Rev. *I

Transcription

1 CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide Doc. # Rev. *I Cypress Semiconductor 198 Champion Court San Jose, CA Phone (USA): Phone (Intnl):

2 Copyrights Copyrights Cypress Semiconductor Corporation, The information contained herein is subject to change without notice. Cypress Semiconductor Corporation assumes no responsibility for the use of any circuitry other 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 safety applications, unless pursuant 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 software and or firmware in support of licensee product to be used only in conjunction with a Cypress integrated circuit as specified 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, 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. Purchase of I 2 C components from Cypress or one of its sublicensed Associated Companies conveys a license under the Philips I 2 C Patent Rights to use these components in an I 2 C system, provided that the system conforms to the I 2 C 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 the integrity of their code. Code protection 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. # Rev. *I 2

3 Contents Safety Information 6 1. Introduction Kit Contents BLE Pioneer Baseboard Details PSoC Creator PSoC Creator Code Examples Kit Code Examples PSoC Creator Help Component Datasheets Getting Started Additional Learning Resources Bluetooth Learning Resources Other Related Resources Technical Support Documentation Conventions Acronyms Software Installation Before You Begin Install Software Windows 8.1 and Windows 10 USB Selective Suspend Setting Kit Operation Theory of Operation KitProg BLE Pioneer Kit USB Connection Placing PSoC 4 BLE Module on Baseboard Programming and Debugging BLE Device Programming using PSoC Creator Debugging using PSoC Creator Programming using PSoC Programmer Updating BLE Dongle for CySmart Central Emulation Tool USB-UART Bridge USB-I2C Bridge Updating the KitProg Firmware Example Projects Using Example Projects CapSense Slider and LED Project Description Hardware Connections...43 CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 3

4 Contents Flow Chart Verify Output CapSense Proximity Project Description Hardware Connections Flow Chart Verify Output BLE Central Mode Project Description Hardware Connections Flow Chart Verify Output Eddystone Project Description Hardware Connection Flow Chart Verify Output BLE Dongle and LED Control Project Description Hardware Connections Flow Chart Verify Output Direct Test Mode (DTM) Project Description Hardware Connection Verify Output Hardware BLE Pioneer Baseboard PSoC 5LP Power System Programming Interface Expansion Connectors USB Mini-B Connector CapSense Circuit BLE Pioneer Baseboard LEDs Push-Buttons Cypress Ferroelectric RAM (F-RAM) Serial Interconnection between KitProg and Module Module Headers Module Board PSoC 4 BLE Device Module Power Connections Module Headers (20-Pin and 24-Pin Headers) Wiggle Antenna Antenna Matching Network BLE Passives Test Points BLE Dongle Board Power System USB Type-A Plug User LED CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 4

5 Contents 6. Advanced Topics Using FM24V10 F-RAM Address Selection Write/Read Operation A. Appendix 115 A.1 Bill of Materials (BOM) A.2 KitProg Status LED States A.3 Adding BLE Module-Compatible Headers on Your Baseboard A.4 Programming BLE Modules via MiniProg A.5 BLE Modules and BLE Dongles Compatible with the BLE Pioneer Kit A.6 Migrating Projects Across Different Pioneer Series Kits Revision History 132 CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 5

6 Safety Information 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. Therefore, 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 should take adequate preventive measures. Also, this board should not be used near any medical equipment or critical RF devices. The kit is not intended for general consumer use. Cypress recommends that the kit only be used in a shielded room. Attaching additional wiring to this product or modifying the product operation 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. The CY8CKIT-042-BLE, as shipped from the factory, has been verified to meet with the requirements of CE as a Class A product. CY8CKIT-042-BLE boards contain ESD-sensitive devices. Electrostatic charges readily accumulate on the human body and any equipment, and can 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. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 6

7 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 the chassis ground (any unpainted metal surface) on the board when handling parts. 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 clean pencil eraser or a rough cloth each time you replace batteries. 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) terminals aligned correctly. 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. Battery Disposal Batteries can be safely disposed with normal household waste. Never dispose batteries in fire because they can explode. It is important not to dispose 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. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 7

8 Regulatory Compliance Information The CY8CKIT-042-BLE kit contains devices that transmit and receive radio signals in accordance with the spectrum regulations for the 2.4-GHz unlicensed frequency range. Cypress Semiconductor Corporation has obtained regulatory approvals for this kit to be used in specific countries. These countries include the United States (FCC Part 15), Canada (IC RSS210), and Japan (JRF/TELEC). Additional regional regulatory agency approval may be required to operate these throughout the world. This kit, as shipped from the factory, has been tested and found to comply with the limits and requirements for the following compliances: As a Class B digital device, pursuant to part 15 of the FCC Rules. As a Class B digital apparatus, compliant with Canadian ICES-003. CAUTION: Only the PCB antenna(s) that were certified with the module may be used. Other antennas may be used only if they are of the same type and have the same or lower gain. The module must be recertified as a Class II permissive change if the module is built into a different device than the evaluation board (EVB) it was certified with. The manufacturer is not responsible for any radio or television interference caused by unauthorized modifications to this equipment. Such modifications could void the user's authority to operate the equipment. Regulatory Statements and Product Labeling United States (FCC) The CY8CKIT-142 PSoC 4 BLE and CY5677 PRoC BLE modular transmitter complies with Part 15 of the Federal Communications Commission (FCC) Rules. The FCC ID for these devices are WAP-CY8CKIT-142 for CY8CKIT-142 and WAP-CY5677 for CY5677. Operation is subject to the following two conditions: This device may not cause harmful interference This device must accept any interference received, including interference that may cause undesired operation. CAUTION: Changes or modifications not expressly approved by the party responsible for compliance could void the user s authority to operate the equipment. The antennas for this transmitter must be installed to provide a separation distance of 20 cm from all persons and must not be co-located or operating in conjunction with any other antenna or transmitter. Canada (IC) This device complies with the Industry Canada license-exempt RSS standard(s). Operation is subject to the following two conditions: This device may not cause interference. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 8

9 This device must accept any interference, including interference that may cause undesired operation of the device. This equipment complies with radio frequency exposure limits set forth by Industry Canada for an uncontrolled environment. This equipment should be installed and operated with minimum distance 20 cm between the device and the user or bystanders. CAUTION: Any changes or modifications not expressly approved by the party responsible for compliance could void the user s authority to operate the equipment. Contains IC: CY8CKIT-142 and CY5677 Le présent appareil est conforme aux CNR d'industrie Canada applicables aux appareils radio exempts de licence. L'exploitation est autorisée aux deux conditions suivantes: (1) l'appareil ne doit pas produire de brouillage, et (2) l'utilisateur de l'appareil doit accepter tout brouillage radioélectrique subi, même si le brouillage est susceptible d'en compromettre le fonctionnement. Cet équipement est conforme aux limites d'exposition aux radiofréquences définies par Industrie Canada pour un environnement non contrôlé. Cet équipement doit être installé et utilisé avec un minimum de 20cm de distance entre le dispositif et l'utilisateur ou des tiers. Contains IC: CY8CKIT-142 and CY5677 Japan (TELEC) CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 9

10 1. Introduction Thank you for your interest in the CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit. The BLE Pioneer Kit enables customers to evaluate and develop BLE projects using the PSoC 4 BLE device. Bluetooth SMART or Bluetooth Low Energy (BLE) is a full-featured, layered, communication protocol that includes a 2.4-GHz radio, a link layer, and an application layer. However, you do not need to understand the complex protocol to implement your projects using PSoC 4 BLE. The Cypress BLE solution, which includes the device, the BLE Component, and the BLE firmware stack will take care of it for you. The Cypress BLE firmware stack is royalty free. You will use two software tools, PSoC Creator and CySmart Central Emulation Tool, to develop and debug your BLE project. PSoC Creator is Cypress standard integrated design environment (IDE). The BLE protocol has been abstracted into an easy drag-and-drop BLE Component in PSoC Creator. The CySmart Central Emulation Tool is a host tool for Windows PCs, which provides an easy-to-use GUI to enable customers to test and debug their BLE projects. The BLE Pioneer Kit offers footprint-compatibility with Arduino shields as well as 6-pin Digilent Pmod daughter cards. In addition, the kit features a CapSense slider, an RGB LED, a pushbutton switch, an onboard programmer/debugger and the USB-UART/I 2 C bridge functionality block (KitProg), a coin cell battery holder, and a Cypress F-RAM. The BLE Pioneer Kit supports 1.9 V, 3 V, 3.3 V, or 5 V as operating voltages. The BLE Pioneer Kit supports the PSoC4 BLE device which is a 32-bit, 48-MHz ARM Cortex -M0 BLE solution with CapSense, 12-bit analog front end (1x SAR ADC, 4x low-power opamps, 2x low-power comparators, and 2x current DACs), 4x TCPWM 1, 2x SCBs 2, 4x UDBs 3, LCD 4, I 2 S 5, and 36 GPIOs. PSoC 4 BLE provides a complete solution for sports and fitness monitors, wearable electronics, medical devices, home automation systems, and sensorbased low-power systems for the Internet of Things (IoT). The PSoC 4 BLE is available in 128KB and 256KB flash configurations. The PSoC 4 BLE is supported by royalty-free protocol stacks compatible with Bluetooth 4.1 and Bluetooth Configurable timer, counter, and pulse-width modulator. 2. Serial communication blocks (configurable to I 2 C, SPI, or UART). 3. Universal digital blocks 4. Configurable liquid crystal display driver. 5. Configurable integrated interchip sound serial bus interface. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 10

11 Introduction 1.1 Kit Contents The BLE Pioneer Kit contains the following items (see Figure 1-1): BLE Pioneer Baseboard preloaded with the CY8CKIT-142 PSoC 4 BLE Module CY5677 CySmart BLE 4.2 USB Dongle (BLE 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 (3-V CR2032) Figure 1-1. Kit Contents The BLE Modules that are shipped as part of the BLE Pioneer Kit support 128KB flash and Bluetooth 4.1. The BLE Modules that support 256KB flash and Bluetooth 4.2 can be ordered separately. For more information about these modules, refer to BLE Modules and BLE Dongles Compatible with the BLE Pioneer Kit on page 125. If any part of the BLE Pioneer Kit is missing, contact your nearest Cypress sales office for help: CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 11

12 Introduction 1.2 BLE Pioneer Baseboard Details The BLE Pioneer Baseboard consists of the blocks shown in Figure RGB LED 2. BLE device reset button 3. CapSense proximity header 4. User button 5. CapSense slider 6. Arduino-compatible I/O headers (J2/J3/J4) 7. Arduino-compatible power header (J1) 8. Digilent Pmod-compatible I/O header (J5) 9. Cypress F-RAM 1 Mb (FM24V10-G) 10.PSoC 5LP I/O header (J8) 11.PSoC 5LP programmer and debugger (CY8C5868LTI-LP039) 12.Coin cell holder (bottom side) 13.USB connector (J13) 14.Power LED and Status LED 15.System power supply jumper (J16) - LDO 1.9 V~5 V 16.BLE power supply jumper / current measurement (J15) 17.BLE module headers (J10/J11) Figure 1-2. BLE Pioneer Baseboard CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 12

13 Introduction Figure 1-3 shows a markup of the onboard components of the PSoC 4 BLE module. See BLE Modules and BLE Dongles Compatible with the BLE Pioneer Kit on page 125 for more details. Figure 1-4 shows the BLE Dongle board blocks. Figure 1-3. BLE Module Markup kHz crystal Figure 1-4. BLE Dongle Markup CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 13

14 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 pre-verified and precharacterized PSoC Components. With PSoC Creator, you can: 1. Drag and drop Components to build your hardware system design in the main design workspace 2. Codesign your application firmware with the PSoC hardware 3. Configure Components using configuration tools 4. Explore the library of 100+ Components 5. Review Component datasheets Figure 1-5. PSoC Creator Features PSoC Creator also enables you to tap into an entire tool ecosystem with integrated compiler chains and production programming programmers for PSoC devices. For more information, visit Visit PSoC Creator training page for video tutorials on learning and using PSoC Creator. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 14

15 Introduction PSoC Creator Code Examples PSoC Creator includes a large number of code examples. These examples are available from the PSoC Creator Start Page, as Figure 1-6 shows. Code examples can speed up your design process by starting you off with a complete design, instead of a blank page. The code examples also show how PSoC Creator Components can be used for various applications. Code examples and documentation are included, as shown in Figure 1-7 on page 16. In the Find Example Project dialog shown in Figure 1-7, you have several options: Filter for examples based on architecture or device family, that is, PSoC 3, PSoC 4 or PSoC 5LP; project name; or keyword. Select from the menu of examples offered based on the Filter Options. Review the example project s description (on the Documentation tab). Review the code from the Sample Code tab. You can copy the code from this window and paste to your project, which can help speed up code development. Create a new project (and a new workspace if needed) based on the selection. This can speed up your design process by starting you off with a complete, basic design. You can then adapt that design to your application. Figure 1-6. Code Examples in PSoC Creator CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 15

16 Introduction Figure 1-7. Code Example Projects with Sample Code Kit Code Examples This kit includes a number of code examples, which can be used to quickly evaluate the functionality of this kit. These examples are described in the Example Projects chapter on page 37. If you are a beginner in BLE, refer to the PSoC Creator code examples such as BLE_FindMe and BLE_Device_Information_Service as pointed out in section You may also refer the application note Getting Started with PSoC 4 BLE. The four Kit code examples viz CapSense Slider and LED, CapSense Proximity, BLE Central Mode and Eddystone are intermediatory level examples that will help to design a system around the kit. Refer to the 4.2 CapSense Slider and LED and later for details. The CySmart Dongle code example is an advanced level example that will demonstrate a complete solution around the kit. Refer to 4.6 BLE Dongle and LED Control for details. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 16

17 Introduction PSoC Creator Help Visit the PSoC Creator home page to download the latest version of PSoC Creator. Then, launch PSoC Creator and navigate to the following items: Quick Start Guide: Choose Help > Documentation > Quick Start Guide. This guide gives you the basics for developing PSoC Creator projects. Simple Component example projects: Choose File > Code Example. These example projects demonstrate how to configure and use PSoC Creator Components. System Reference Guide: Choose Help > System Reference Guide. This guide lists and describes the system functions provided by PSoC Creator. Component datasheets: Right-click a Component and select Open Datasheet, as shown in Figure 1-8. Visit the PSoC 4 Component Datasheets page for a list of all PSoC 4 Component datasheets. Document Manager: PSoC Creator provides a document manager to help you to easily find and review document resources. To open the document manager, choose the menu item Help > Document Manager Component Datasheets Right-click a Component and select Open Datasheet (see Figure 1-8). Figure 1-8. Opening Component Datasheet 1.4 Getting Started This guide will help you get acquainted with the BLE Pioneer Kit: The Software Installation chapter on page 21 describes the installation of the kit software. This includes the PSoC Creator IDE for development and debugging applications, PSoC Programmer for programming hex files, and the CySmart Central Emulation Tool for BLE Central emulation. The Kit Operation chapter on page 25 describes the major features of the BLE Pioneer Kit such as USB-UART and USB-I 2 C bridges and functionalities such as programming and debugging. The Example Projects chapter on page 37 describes multiple PSoC 4 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 86 details the hardware content of the BLE Pioneer Kit and BLE Dongle, and the hardware operation. The Advanced Topics chapter on page 113 explains the functionality of FM24V10 F-RAM. The Appendix on page 115 provides the bill of materials (BOM), KitProg LED states, list of BLE modules and dongles compatible with the BLE Pioneer Kit, migrating projects across Pioneer series kits, and programming BLE modules using MiniProg3. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 17

18 Introduction 1.5 Additional Learning Resources Cypress provides a wealth of information at to help you to select the right PSoC device for your design, and to help you to quickly and effectively integrate the device into your design. For a comprehensive list of resources, see KBA86521, How to Design with PSoC 3, PSoC 4, and PSoC 5LP. Visit and for additional learning resources including datasheets, technical reference manuals, and application notes.the following is an abbreviated list: Overview: PSoC 4 BLE Portfolio and PSoC Roadmap Product Selectors: PSoC 1, PSoC 3, PSoC 4, or PSoC 5LP. In addition, PSoC Creator includes a device selection tool. Datasheets: Describe and provide electrical specifications for the PSoC 4 device family CapSense Design Guide: Learn how to design capacitive touch-sensing applications with the PSoC 4 family of devices. Application Notes and Code Examples: Cover a broad range of topics, from basic to advanced level. Many of the application notes include code examples. Visit the PSoC 3/4/5 Code Examples webpage for a list of all available PSoC Creator code examples. To access code examples from within PSoC Creator, see PSoC Creator Code Examples on page 15. Technical Reference Manuals (TRM): Provide detailed descriptions of the architecture and registers in each PSoC 4 device family. Development Kits: CY8CKIT-040, CY8CKIT-042, and CY8CKIT-044 are easy-to-use and inexpensive development platforms. These kits include connectors for Arduino-compatible shields and Digilent Pmod peripheral modules. CY8CKIT-141, CY8CKIT-143, and CY8CKIT-143A are additional BLE Modules compatible with the BLE Pioneer Kit. CY8CKIT-049 is a very low-cost prototyping platform for PSoC 4100/4200 families. The MiniProg3 kit provides an interface for flash programming and debug. Knowledge Base Articles (KBA): Provide design and application tips from experts on using the device. PSoC Creator Training: Visit for a comprehensive list of video trainings on PSoC Creator. Cysmart Central Emulation Tool: Visit for information on the CySmart Central Emulation Tool. Learning From Peers: Visit to meet enthusiastic PSoC developers discussing the next generation embedded systems on Cypress Developer Community Forums 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 CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 18

19 Introduction Other Related Resources Digilent Pmod: Arduino: Technical Support If you have any questions, our technical support team is happy to assist you. You can create a support request on the Cypress Technical Support page. If you are in the United States, you can talk to our technical support team by calling our toll-free number: Select option 2 at the prompt. You can also use the following support resources if you need quick assistance. Self-help. Local Sales Office Locations. 1.7 Documentation Conventions Table 1-1. Document Conventions for Guides Convention Courier New Italics [Bracketed, Bold] File > Open Bold Times New Roman Text in gray boxes Usage 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: = 4 Describes cautions or unique functionality of the product. 1.8 Acronyms Table 1-2. Acronyms Used in this Document Acronym ADC API BD address BLE CDC COM DLE ECDH DVD analog-to-digital converter application programming interface Bluetooth device address Bluetooth Low Energy Communications Device Class communication port data length extension Elliptic Curve Diffie-Hellman digital video disc Definition CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 19

20 Introduction Table 1-2. Acronyms Used in this Document (continued) ESD F-RAM GATT GUI GPIO I 2 C IAS IDAC IDE LDO LE LED LP LPT MTU OTA PHY PrISM PSM PSoC PWM QFN RDK RGB SAR SIG SMA SPI SWD TLM UART UID URI URL USB UUID Acronym Definition electrostatic discharge ferroelectric random access memory generic attribute profile graphical user interface general-purpose input/output inter-integrated circuit immediate alert service current output digital-to-analog converter integrated development environment low drop out (voltage regulator) low energy light-emitting diode low power line print terminal maximum transmission unit over-the-air physical layer Precise Illumination Signal Modulation protocol service multiplexer Programmable System-on-Chip pulse width modulation quad flat no-lead (package) reference design kit red green blue successive approximation register special interest group SubMiniature version A serial peripheral interface serial wire debug telemetry universal asynchronous receiver transmitter universal identifier uniform resource identifier uniform resource locator Universal Serial Bus universal unique identifier CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 20

21 2. Software Installation This chapter describes the steps to install the software tools and packages on a computer for using the BLE Pioneer Kit. This includes the IDE in which the projects will be built and used for programming. 2.1 Before You Begin All Cypress software installations require administrator privileges. Ensure you have the required privileges on the system for successful installation. 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 kit software from The software is available in the following formats: a. CY8CKIT-042-BLE Kit Complete Setup: This installation package contains the files related to the BLE Pioneer 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 Package: This executable file installs only the BLE Pioneer Kit contents, which include 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 computer. 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 using the appropriate ISO extractor (such as MagicISO or PowerISO). 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 computer. The installation window will appear automatically. Note: If you are using the Kit Complete Setup or Kit Only Package file, then go to step 4 for installation. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 21

22 Software Installation 3. Click Install CY8CKIT-042-BLE Kit to start the installation, as shown in Figure 2-1. Figure 2-1. 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. The following software packages are required: Note: For the Kit Only Package, download and install the following prerequisites. a. PSoC Creator 4.1 or later: Download the latest version from b. PSoC Programmer 3.26 or later: This is installed as part of PSoC Creator installation ( c. CySmart 1.2 SP1 or later: Download the latest version from CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 22

23 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 Continue Without Contact Information check box. 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 projects, follow the steps outlined in the Example Projects chapter on page 37. The BLE Pioneer Kit installer also installs the CySmart Central Emulation Tool on your computer. This software, along with the BLE Dongle, allows the computer to emulate as a BLE Central device. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 23

24 Software Installation 2.3 Windows 8.1 and Windows 10 USB Selective Suspend Setting The Windows 8.1 and Windows 10 operating systems issue a suspend command to a connected USB device if there is no activity on its USB bus. This may happen to the BLE Pioneer Kit/BLE Dongle if the driver installation is not complete or the driver is not found. In this situation, as a response to the suspend command from the operating system, the KitProg will shut down the onboard LDO to remain within the USB suspend current requirement. Due to this, the BLE Pioneer Kit will not be powered and will not be functional. To prevent this, do either of the following: Install the kit software on the Windows 8.1 or Windows 10 operating system before using the BLE Pioneer Kit. Disable the USB selective suspend setting for the BLE Pioneer Kit from Power Options on Windows 8.1, by following these steps: a. From Control Panel, go to Power Options. b. Click Change Plan Settings corresponding to your power plan. c. Click Change Advanced Power Settings. d. Under Advanced settings, expand USB Settings > USB selective suspend setting. e. Select the Disabled option for Plugged in and On battery operation. f. Click OK. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 24

25 3. Kit Operation This chapter introduces you to the BLE Pioneer Kit and the features that will be used as part of its operation. We will discuss features such as USB connection, programming/debugging, and programmer firmware update. The chapter also describes the USB-UART and USB-I 2 C bridges along with the PC tools that can be used to communicate with the BLE device on the BLE Pioneer 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, PSoC 4 BLE Module, and BLE Dongle. Figure 3-1. BLE Pioneer Baseboard Block Diagram BLE/Arduino Compatible Headers Status LED Green KitProg 10 pin Prog. header Reset SW (Push Button) User SW (Push Button) BLE SWD 10 pin Prog. header Proximity wire header GPIO USB Mini B D+ / D- VBUS KitProg Programmer/Serial Communication XRES SWD I2C / UART BLE Module I/Os 24 pin header I2C pull-up via FET RGB LED ESD Protection KitProg I/Os 16 pin Expansion header Power LED Red MOSFET Protection ckt 3.3V FRAM I2C VCC LDO VDD ORing Diodes Jumper BLE current measuring BLE Module I/Os 20 pin header ~3V ORing Diodes Voltage Ctrl 3 pin Jumper Coin cell Battery holder MOSFET Protection ckt PMOD header 6 pin PMOD header CapSense Slider 5 Segment GPIO VIN 3.3V BLE/Arduino Compatible Headers Power Signal The BLE Pioneer Baseboard acts as the baseboard for the PSoC 4 BLE Module. The BLE Pioneer Baseboard contains a PSoC 5LP device, that has KitProg firmware, 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 the PSoC 4 BLE Module. 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 device on the module. The BLE Pioneer Baseboard supports three voltage levels: 1.9 V, 3.3 V, and 5 V. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 25

26 Kit Operation The BLE Pioneer Baseboard can also be used as a standalone programmer to program and debug other BLE devices using SWD, and as a USB-Serial interface. The KitProg firmware on PSoC 5LP device enables bootloading PSoC 5LP over USB to upgrade the firmware. Figure 3-2. PSoC 4 BLE Module Block Diagram BLE I/Os 20 pin header (Digital pins) KHz Crystal Decaps GPIO VREF SAR Bypass Cap MHz Crystal 4 pin header RX/ TX PSoC 4 BLE CMOD CTANK Test points VDDD/A/R Ferrite Bead GPIO Decaps RF Matching Circuit BLE I/Os 24 pin header (Analog pins) Power Signal This BLE Pioneer Kit includes the PSoC 4 BLE Module. This module act as a basic breakout board for the CY8C4247LQI-BL483 (PSoC 4 BLE) device. Besides the PSoC4 BLE Module, there are additional modules available, which can be ordered separately. The complete list is available in BLE Modules and BLE Dongles Compatible with the BLE Pioneer Kit on page 125. The BLE Dongle is the wireless interface for the CySmart Central Emulation Tool. It has a PRoC BLE device for BLE communication and KitProg for onboard programming, debugging, and for the USB- Serial interface, as shown in Figure 3-3. The BLE Dongle has a USB Type-A plug to connect the KitProg to the USB port of the host computer. The KitProg then communicates with the PRoC BLE device over UART or multiplexed I 2 C or an SPI bus. The BLE Dongle 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. Figure 3-3. BLE Dongle Block Diagram Test Points USB 2.0 Type-A Plug VBUS D+ / D- KitProg Programmer/Serial Communication I2C / UART SWD XRES PRoC BLE Crystals RF Matching Circuit User SW (Push Button) SWD User LED Blue ESD Protection Status LED Green Power LED Red Reset SW (Push Button) 10 pin Programming header Power Signal CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 26

27 Kit Operation 3.2 KitProg KitProg is the hardware/firmware block for onboard programming, debugging, and bridge functionality. It is a common reusable hardware/firmware block used across many Cypress kit platforms. It consists of a PSoC 5LP, which connects to the computer over an USB interface and connects to the PSoC 4 BLE device over SWD, I 2 C, and UART pins. The KitProg communicates with PSoC Programmer and PSoC Creator software to program/debug the target PSoC 4 BLE over the SWD interface. The main advantage of an onboard programmer/ debugger is that users do not have to buy an extra programmer/debugger hardware. 3.3 BLE Pioneer Kit USB Connection The BLE Pioneer Kit powers from a computer over the USB interface (J13). It enumerates as a composite device, as shown in Table 3-1. USB drivers required for this enumeration are part of the kit installer. The kit should be installed properly for its correct operation. Visit for the latest kit installer. Table 3-1. BLE Pioneer Kit Enumerated Interfaces Port USB Composite Device USB Input Device KitProg KitProg USB-UART Description Composite device USB-I 2 C bridge, KitProg command interface USB-I 2 C bridge, programmer, and debugger USB-UART bridge, which appears as a COM# port Figure 3-4. KitProg Driver Installation (appearance may differ depending on Windows version) CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 27

28 Kit Operation 3.4 Placing PSoC 4 BLE Module on Baseboard Plug the module into the BLE Pioneer Baseboard on headers J10 and J11, while keeping the antenna directed outside. Note that the two parallel headers J10 and J11 are not equal (24-pin and 20-pin, respectively) and will not allow the module to be inserted in the opposite direction. Figure 3-5. Baseboard with J10 and J11 Headers to Connect PSoC 4 BLE Module To remove the PSoC 4 BLE Module from the BLE Pioneer Kit, hold the BLE Pioneer Kit in one hand and the module in the other, as shown in Figure 3-6, and pull it out using a rocking motion. Figure 3-6. Remove Module Connected on BLE Pioneer Kit CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 28

29 Kit Operation 3.5 Programming and Debugging BLE Device The BLE Pioneer Kit and BLE Dongle can be programmed and debugged using the KitProg. Before programming the device, ensure that PSoC Creator and PSoC Programmer are installed on the computer. See the section Install Software on page 21 for more information Programming using PSoC Creator 1. Connect the BLE Pioneer Kit/BLE Dongle to the computer s USB port, as shown in Figure 3-7. Figure 3-7. Connect USB Cable to J13 2. Load the desired example project in PSoC Creator from File > Open > Project/Workspace. 3. Build the project by choosing Build > Build <Project Name> or [Shift] [F6], as shown in Figure 3-8. Figure 3-8. Build an Example Project CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 29

30 Kit Operation 4. If there are no errors during build, program the firmware by clicking the Program button on the tool bar or pressing [Ctrl] [F5], as shown in Figure 3-9. This will program the device on the BLE Pioneer Kit/BLE Dongle and it will be ready for use. Figure 3-9. Programming Device From PSoC Creator Debugging using PSoC Creator For debugging the project using PSoC Creator, follow steps 1 to 5 from Programming using PSoC Creator on page 29 followed by: 1. Click the Debug icon or press [F5], as shown in Figure Figure Start Debug on PSoC Creator 2. When PSoC Creator opens in debug mode, use the buttons on the toolbar for debugging. For more details on using the debug features, see the Cypress application note Getting Started with PSoC 4 BLE. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 30

31 Kit Operation Programming using PSoC Programmer PSoC Programmer (3.26 or later) can be used to program existing hex files into both BLE Pioneer Kit or BLE Dongle. To do this, follow these steps. 1. Connect the BLE Pioneer Kit or BLE Dongle to a computer and open PSoC Programmer from Start > All Programs > Cypress > PSoC Programmer <version> > PSoC Programmer <version>. 2. Click the File Load button at the top left corner of the window. Browse for the desired hex file and click Open. Figure Select Hex File 3. Go to File > Program to start programing the kit with the selected file. Note: If the hex file does not match the device selected, then PSoC Programmer will throw an error of device mismatch and terminate programming. Figure Program Hex File to Kit 4. When the programming is finished successfully, indicated by a PASS message on the status bar, the BLE Pioneer Kit/BLE Dongle is ready for use. Close PSoC Programmer. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 31

32 Kit Operation 3.6 Updating BLE Dongle for CySmart Central Emulation Tool The BLE Dongle, provides a BLE Central mode capability using the CySmart Central Emulation Tool on the computer. The CySmart Central Emulation Tool on the PC is the interface with which to configure the BLE Dongle and analyze the data transferred after connecting with a BLE Peripheral. The BLE Dongle works along with the CySmart Central Emulation Tool, as shown in Figure The CySmart Central Emulation Tool is installed as part of the BLE Pioneer Kit installation and can be opened from Start > All Programs > Cypress > CySmart <version> > CySmart <version>. The tool operation is explained in the user guide, which can be accessed from Help > Help Topics. Figure BLE Dongle Interface on CySmart Central Emulation Tool If the BLE Dongle contains custom firmware on PRoC BLE, the original CySmart firmware can be programmed back to restore the CySmart functionality. It must be connected through the USB and enumerated as KitProg. To do this, follow these steps: 1. Connect the BLE Dongle to the USB port on the computer. 2. Open PSoC Programmer by going to Start > All Programs > Cypress > PSoC Programmer <version> > PSoC Programmer <version>. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 32

33 Kit Operation 3. Click the File Load button and browse to the location of the BLE_4_2_Dongle_CySmart_256K.hex file. The hex file is located at: <Install_Directory>\CY8CKIT-042-BLE Kit\<version>\Firmware\BLE Dongle\ Hex Files\ Note: If Cypress releases new versions of the CySmart Central Emulation Tool and the BLE Dongle firmware, then the CySmart Central Emulation Tool will display a message requesting to update the firmware, as shown in the following figures. Figure Update BLE Dongle Firmware with Hex from Latest Kit Installer Choose the.hex file from the respective location and update the BLE Dongle firmware. Figure Open Hex File CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 33

34 Kit Operation 4. Ensure the other settings match as shown in Figure Click the Program button to start programming. The status bar at the bottom of the PSoC Programmer window will show the programming status and the result (Pass/Fail). Figure Programming Hex File to Dongle 5. After programming is completed successfully, the BLE Dongle firmware is updated and can be used to connect to the CySmart Central Emulation Tool. 3.7 USB-UART Bridge The KitProg on both the BLE Pioneer Baseboard and BLE Dongle acts as a USB-UART bridge. When connected to a computer, a device named KitProg USB-UART is available under Ports (COM & LPT) in the Device Manager. The UART lines between PSoC 4 BLE Module and KitProg are hard-wired onboard, with UART_RX assigned to P1_4 and UART_TX assigned to P1_5 on the PSoC 4 BLE device. COM terminal software, such as Hyperterminal or TeraTerm, can be used to send and receive data. UART data sent from the PSoC 4 BLE device on the UART_TX line will be received by the software. Data entered in the software will be received by PSoC 4 BLE on the UART_RX line. Refer to the Advanced Topics section in CY8CKIT-042 PSoC 4 Pioneer Kit User Guide for more details. Table 3-2 lists the specifications supported by the USB-UART bridge. Table 3-2. Specifications Supported by USB-UART Bridge Parameter Supported Values Baud Rate 1200, 2400, 4800, 9600, 19200, 38400, 57600, and Data Bits 8 Parity None Stop Bits 1 Flow Control None File Transfer Protocols supported Xmodem, 1K Xmodem, Ymodem, Kermit, and Zmodem (only speeds greater than 2400 baud) CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 34

35 Kit Operation 3.8 USB-I 2 C Bridge The KitProg can function as USB-I 2 C bridge and communicate with the Bridge Control Panel (BCP) software utility. When connected to BCP, the KitProg\<serial number> is available under Connected I2C/SPI/RX8 Ports in the BCP. The I 2 C connection between PSoC 4 BLE device and Kit- Prog is used to transfer data between BCP and the PSoC 4 BLE device. The I 2 C lines on PSoC 4 BLE device are P3_4 (SDA) and P3_5 (SCL), which are hard-wired onboard to I 2 C lines of KitProg. The USB-I 2 C supports I 2 C speed of 50 khz, 100 khz, 400 khz and 1 MHz. BCP is installed as part of the PSoC Programmer installation and can be accessed from Start > All Programs > Cypress > Bridge Control Panel. Refer to the Advanced section in the CY8CKIT-042 PSoC 4 Pioneer Kit User Guide for more details. To use the USB-I 2 C functionality, select the KitProg\<serial number> in the BCP. On successful connection, the Connected and Powered status box turn green, as shown in Figure Figure KitProg USB-I 2 C Connected in Bridge Control Panel CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 35

36 Kit Operation 3.9 Updating the KitProg Firmware The KitProg firmware normally does not require any update. If an update is required, then PSoC Programmer will display a warning message when the kit is connected to it, as shown in Figure Figure Update KitProg To update the KitProg, go to the Utilities tab on PSoC Programmer and click Upgrade Firmware, as shown in Figure Figure Update KitProg from PSoC Programmer CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 36

37 4. Example Projects This chapter demonstrates the functionality of the PSoC 4 BLE device using the BLE Pioneer Kit example projects. Download and install the kit setup file from the kit web page. The example projects can be accessed on the Start Page of PSoC Creator under Examples and Kits. 4.1 Using Example Projects Follow these steps to open and use the example projects: 1. Launch PSoC Creator from Start > All Programs > Cypress > PSoC Creator 4.1 > PSoC Creator On the Start page, click on CY8CKIT-042-BLE under Start > Kits. A list of code examples appears, as shown in Figure Click the desired example project. Figure 4-1. Open Example Project from PSoC Creator 4. Select the folder where you want to save the project and click OK. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 37

38 Example Projects 5. Every BLE project use a public address set in the BLE Component GUI to advertise and scan, depending on the role: Peripheral or Central mode. If multiple kits in close proximity have the same public address, then wrong devices may be connected or connections may fail. To prevent this, change the Public address (and preferably Device name) in the BLE Component GAP Settings tab as shown in Figure 4-2. Click OK. Alternatively, you can select the 'Silicon generated' device address by selecting the check box. This way, the Bluetooth device (BD) address is generated using the silicon ID, unique to each device. Click OK. Figure 4-2. Change BLE Public Address and Name 6. Build the example project by choosing Build > Build <Project Name>, as shown in Figure 4-3. A hex file will be generated. Figure 4-3. Build Project from PSoC Creator CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 38

39 Example Projects 7. Connect the BLE Pioneer Baseboard to the computer through the USB Mini-B connector J13. Ensure that the PSoC 4 BLE module is placed on the baseboard. 8. Choose Debug > Program in PSoC Creator, as shown in Figure 4-4. Figure 4-4. Program Device in PSoC Creator 9. If the device is not yet acquired, PSoC Creator will open the programming window. Select KitProg and click the Port Acquire button, as shown in Figure 4-5. Note: The serial ID starting with 'BLE' belongs to the BLE Dongle (see Updating BLE Dongle for CySmart Central Emulation Tool on page 32). Figure 4-5. Port Acquire CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 39

40 Example Projects 10.After the device is acquired, it is shown in a structure below the KitProg. Click the Connect button and then OK to exit the window and start programming, as shown in Figure 4-6. Figure 4-6. Connect Device From PSoC Creator and Program This document refers to the BLE Pioneer Kits, BLE Dongle, and PC/mobile as Central or Peripheral devices. A Central device is normally the master and requests/commands data from the Peripheral device. BLE-enabled phones and computers are one such example. Peripheral devices store the actual data and send it to the Central device when requested. Examples include BLE-enabled sensors, proximity beacons, and so on. If you are a beginner in BLE, refer to the PSoC Creator code examples such as BLE_FindMe and BLE_Device_Information_Service as pointed out in section You may also refer the application note Getting Started with PSoC 4 BLE. The four Kit code examples viz. CapSense Slider and LED, CapSense Proximity, BLE Central Mode and Eddystone are intermediatory level examples that will help to design a system around the kit. Refer to the 4.2 CapSense Slider and LED and later for details. The CySmart Dongle code example is an advanced level example that will demonstrate a complete solution around the kit. Refer to 4.6 BLE Dongle and LED Control for details. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 40

41 Example Projects 4.2 CapSense Slider and LED Project Description This project demonstrates connectivity between the BLE Pioneer Kit (acting as a Peripheral and GATT server device) and CySmart Central Emulation tool or mobile device running the CySmart mobile application (acting as a Central and GATT client device). This project demonstrates the following: Advertisement with timeout Connection with any Central device Two custom services in single profile Data transfer over BLE custom service using notifications, read, and write Low-power mode implementation for coin-cell operation The BLE profile in this project consists of two BLE custom services: CapSense and RGB LED. The CapSense service consists of one custom characteristic, termed as CapSense Slider. The CapSense slider characteristic is used to send one byte data, ranging from 0 to 100, as notification to the GATT client device. This data is the finger location read by the CapSense Component on the five-segment slider (CSS1) present on the kit. This characteristics supports notification, which allows the GATT server to send data to the connected client device whenever new data is available. The RGB LED service also consists of one custom characteristic, termed as RGB LED Control. This characteristic supports two operations, read and write, through which the connected GATT client device can read data as well as write a new value to the characteristic. This data has four byte values indicating red, green, blue, and the intensity values to control the onboard RGB LED. The properties for the custom service/characteristics are configured in the BLE Component under the Profiles tab, as shown in Figure 4-7. Figure 4-7. Attributes Configuration in BLE Component for Custom Services CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 41

42 Example Projects The project consists of the following files: main.c/.h These files contain the main function, which is the entry point and execution of the firmware application. They also contain the function definition for initialization of the system and reading the CapSense slider data from the CapSense Component. BLEApplications.c/.h These files contain all the macros and function definitions related to BLE communication and operation. They include the event callback function definition that is registered with the BLE Component startup and used to send BLE-related events from the BLE stack to the application layer for processing. These files contain a method to send CapSense notifications to the GATT client device and process the Read and Write commands on the RGB LED characteristic by the GATT client device. They update the BLE Connection parameter, which is important for low-power mode usage. HandleLowPower.c/.h These files contain the function to handle low-power mode. This function is continuously called in the main loop and is responsible for pushing the BLE hardware block (BLESS) as well as the CPU to Deep Sleep mode as much as possible. The wakeup source is either the BLE hardware block link layer internal timer or the interrupt from the user button press (SW2). This allows for very low power mode implementation and operation using a coin cell. This is the default firmware that comes in the PSoC 4 BLE Module shipped with the kit. Figure 4-8. TopDesign for PSoC_4_BLE_CapSense_Slider_LED Project CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 42

43 Example Projects Hardware Connections No specific hardware connections are required for this project because all connections are hardwired on the BLE Pioneer Baseboard. The pin assignment for this project is in PSoC_4_BLE_CapSense_Slider_LED.cydwr in the Workspace Explorer, as shown in Figure 4-9. Figure 4-9. Pin Selection for CapSense Slider and LED Project CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 43

44 Example Projects Flow Chart Figure 4-10 shows the flow chart of the code implemented. Figure CapSense Slider and LED Project Flow Chart System initialized. Wait for interrupt from User Button to Wakeup Start Advertisement Advertisement Time-out? NO NO Connected to Central device before timeout? YES Process BLE Events Put system to low power mode and wait for interrupt from BLE Link Layer CapSense Slider Swipped? YES Notifications Enabled? YES YES NO Send finger position over CapSense custom service NO Extract Data and change color/ brightness on LED. Keep LED ON for set time YES Received RGB LED Data? NO YES BLE Connection Still Present? NO System in Deep Sleep and waiting for User button press CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 44

45 Example Projects Verify Output The project can be verified by two methods: using the CySmart Central Emulation Tool and BLE Dongle or using the CySmart mobile application CySmart Central Emulation Tool To verify the CapSense and LED project using the CySmart Central Emulation Tool, follow these steps: Note: Refer CySmart Central Emulation tool to learn how to use the tool. 1. Connect the BLE Dongle to one of the USB ports on the computer. 2. Start the CySmart Central Emulation Tool on the computer by going to Start > All Programs > Cypress > CySmart <version> > CySmart <version>. You will see a list of BLE Dongles connected to it. If no dongle is found, click Refresh. Select the BLE Dongle and click Connect. Figure Connect to BLE Dongle 3. Place the PSoC 4 BLE Module on the BLE Pioneer Kit. 4. Power the BLE Pioneer Kit through the USB connector J Program the BLE Pioneer Kit with the PSoC_4_BLE_CapSense_Slider_LED example project. Follow steps in Using Example Projects on page 37 to program the device. 6. After programming successfully, press the user button (SW2) on the BLE Pioneer Kit to start the advertisement. Advertisement is indicated by a blinking red LED on the baseboard. Note: The project has an advertisement timeout of 30 seconds after which it returns to Deep Sleep mode. Press SW2 again to restart the advertisement. 7. On the CySmart Central Emulation Tool, click Start Scan to see the list of available BLE Peripheral devices. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 45

46 Example Projects 8. Double-click the Slider LED device to connect, or click Slider LED and then click Connect. Figure Connect to BLE Slider and LED Peripheral 9. When connected, the CySmart Central Emulation Tool will display a message for the Update connection parameters. Select Yes, as shown in Figure Figure Update Connection Parameter Option Note: If you select No, the project will still work. However, the current consumption will be higher due to faster connection interval. 10.Click Discover All Attributes to find all attributes supported. Figure Discover All Attributes CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 46

47 Example Projects 11.Locate the attribute Client Characteristic Configuration descriptor (UUID 0x2902) under CapSense slider characteristic (UUID 0x0003CAA F9B0131). Click Read Value to read the existing Client Characteristic Configuration Descriptor (CCCD) value as shown in Figure Figure Read CCCD for CapSense Slider Characteristic 12.Modify the Value field of CCCD to '01:00' and click Write Value. This enables the notifications on the CapSense slider characteristic. Figure Write CCCD to Enable Notifications CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 47

48 Example Projects 13.Swipe your finger on the CapSense slider on the BLE Pioneer kit, as shown in Figure 4-17 and see the notification values in the CapSense Slider value field, as shown in Figure Figure CapSense Slider Figure CapSense Slider Notification Received 14.To disable notifications, modify the Value field of the Client Characteristic Configuration descriptor to '00:00' and click Write Value. Figure Disable Notifications CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 48

49 Example Projects 15.Locate the RGB LED Control characteristic (UUID 0x0003CBB F9B0131). Click Read Value to read the existing 4-byte onboard RGB LED color information, as shown in Figure The four bytes indicate red, green, blue, and the overall brightness, respectively. Figure Read RGB LED Control Characteristic Value 16.Modify the four bytes of data in the Value field and click Write Value. You will see the corresponding change in the color and intensity of the RGB LED on the BLE Pioneer Kit, as shown in Figure The RGB LED will be on for 3 seconds before switching off to conserve power. Note: If the kit is powered from a coin cell and not the USB Vbus, then the color mixing and intensity will vary. This is because the coin cell provides a lower driving voltage for RGB LEDs. Figure Write RGB LED Control Characteristic Value Figure RGB LED Control with PSoC 4 BLE Module CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 49

50 Example Projects 17.To disconnect from the device, click Disconnect, as shown in Figure Figure Disconnect from the Device 18.To connect to this peripheral again, restart advertising by pressing the user button (SW2) on the BLE Pioneer Kit. Advertising is indicated by the blinking red LED CySmart Mobile Application To verify the CapSense and LED project using the CySmart mobile application (refer CySmart Mobile App webpage), follow these steps: 1. Plug the PSoC 4 BLE Module on the BLE Pioneer Baseboard. 2. Connect the BLE Pioneer Kit into the computer using the J13 USB connector. 3. Program the kit with the PSoC_4_BLE_CapSense_Slider_LED example project. See Using Example Projects on page 37 for programming instructions. 4. Press the user button (SW2) on the BLE Pioneer Kit to start the advertisement. This is indicated by the blinking red LED on the BLE Pioneer Kit. 5. Open the application on the mobile device. If Bluetooth is not enabled on the device, the application will ask to enable it. 6. After Bluetooth is enabled, the CySmart mobile application will automatically search for available peripherals and list them. Select the Slider LED peripheral as shown in Figure Figure Slider LED Peripheral CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 50

51 Example Projects 7. When connected, the CySmart mobile application will list the profiles supported by the peripherals. Scroll and select the CapSense icon, as shown in Figure Figure CapSense Service Page 8. Swipe your finger on the CapSense slider on the BLE Pioneer Kit and see a similar response on the CapSense page in the CySmart application (Figure 4-26). Figure CapSense Slider 9. Press the back button to return to the service selection page. Scroll and tap on the RGB LED service. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 51

52 Example Projects 10.On the RGB LED service page, swipe over the color gamut to see a similar color response on the BLE Pioneer Kit RGB LED. The slider below the color gamut controls the intensity of the RGB LED color. The RGB LED will be on for 3 seconds before switching off. This is done to conserve power. Figure RGB LED Control with CySmart Mobile Application 11.To disconnect from the BLE Pioneer Kit, return to the CySmart mobile application home screen by pressing the back button. 12.To reconnect to the Peripheral, press the user button (SW2) on the BLE Pioneer Kit again and then scan for devices using CySmart mobile application. 4.3 CapSense Proximity Project Description This project demonstrates connectivity between the BLE Pioneer Kit (acting as a Peripheral and GATT server device) and the CySmart Central Emulation Tool or mobile device running the CySmart mobile application (acting as a Central and GATT client device). This project demonstrates the following: Advertisement with timeout Connection with any Central device One custom service Data transfer over BLE custom service using notifications Low-power mode implementation for coin cell operation The BLE profile in this project consists of a single BLE custom service, called CapSense. The CapSense service consists of a custom characteristic, termed as CapSense Proximity. The CapSense proximity characteristic is used to send one byte data, ranging from 0 to 255, as notification to the GATT client device. This data is the difference count read by the CapSense Component on the one-wire proximity sensor (J14) connected on the kit. This characteristic supports CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 52

53 Example Projects notification, which allows the GATT server to send data to the connected GATT client device whenever new data is available. The properties for the custom attributes are configured in the BLE Component under the Profiles tab, as shown in Figure Figure Attributes Configuration in BLE Component for CapSense Proximity CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 53

54 Example Projects The project consists the following files: main.c/.h These files contain the main function, which is the entry point and execution of the firmware application. They contain function definition for initialization of the system and reading the CapSense proximity data from the CapSense Component. BLEApplications.c/.h These files contain all the macros and function definitions related to BLE communication and operation. They include the event callback function definition that is registered with the BLE Component startup and used to send BLE-related events from the BLE stack to the application layer for processing. These files contain a method to send CapSense notifications to the GATT client device. They update the BLE Connection parameter, which is important for low-power mode usage. HandleLowPower.c/.h These files contain the function to handle low-power mode. This function is continuously called in the main loop and is responsible for pushing the BLE hardware block (BLESS) as well as the CPU to Deep Sleep mode as much as possible. The wakeup source is either the BLE hardware block link layer internal timer or the interrupt from the user button press (SW2). This allows for very low-power mode implementation and operation using a coin cell. The red LED is used as the status LED and provides visual confirmation on advertising or connection states. A blinking red LED indicates advertising state. Figure Top Design for PSoC_4_BLE_CapSense_Proximity Project CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 54

55 Example Projects Hardware Connections Ensure that the PSoC 4 BLE module is placed on the baseboard. Connect a five-inch wire (provided as part of this kit) to the proximity connector J14 on the baseboard. Loop the wire as shown in Figure Note: Ensure that the proximity sensor loop wire is kept away as much as possible from the BLE antenna on the PSoC 4 BLE Module. Figure Proximity Sensor Connection on BLE Pioneer Kit with PSoC 4 BLE Module The pin assignment for this project is in PSoC_4_BLE_CapSense_Proximity.cydwr in the Workspace Explorer, as shown in Figure Figure Pin Selection for CapSense Proximity Project CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 55

56 Example Projects Flow Chart Figure 4-32 shows the flow chart of code implemented. Figure CapSense Proximity Project Flow Chart System initialized. Wait for interrupt from User Button to Wakeup Start Advertisement Advertisement Time-out? NO Connected to Central device? NO YES Put system to low power mode and wait for interrupt from BLE Link Layer Process BLE events Proximity value Changed? YES Notification enabled? YES YES NO Send the proximity data to Central device NO YES BLE connection still exists? NO System is put in Sleep and waits for User Button press CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 56

57 Example Projects Verify Output The project can be verified by two methods: using the CySmart Central Emulation Tool and BLE Dongle or using the CySmart ios/android app CySmart Central Emulation Tool To verify the CapSense Proximity project using the CySmart Central Emulation Tool, follow these steps: Note: Refer CySmart Central Emulation tool to learn how to use the tool. 1. Connect the BLE Dongle to one of the USB ports on the computer. 2. Start the CySmart Central Emulation Tool on the computer by going to Start > All Programs > Cypress > CySmart <version> > CySmart <version>. You will see a list of dongles connected to it. If no dongle is found, click Refresh. Select the BLE Dongle and click Connect. Figure Connect to BLE Dongle 3. Connect a five-inch wire (included in the kit) to the proximity sensor connector J14 and make a loop of it. 4. Power the BLE Pioneer Kit through the USB connector J Program the BLE Pioneer Kit with the PSoC_4_BLE_CapSense_Proximity example project. Follow the steps in Using Example Projects on page 37 to program the device. 6. After programming successfully, press the user button (SW2) on the BLE Pioneer kit to start the advertisement. This is indicated by a blinking red LED on the baseboard. Note: The project has an advertisement timeout of 30 seconds after which it returns to Deep Sleep mode. Press SW2 again to restart the advertisement. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 57

58 Example Projects 7. On the CySmart Central Emulation Tool, click Start Scan to see the list of available BLE Peripheral devices. Figure Start Scanning 8. Double-click CapSense Proximity to connect or click Connect to connect to the BLE Pioneer Kit. Figure Connect to CapSense Proximity Peripheral 9. When connected, the CySmart Central Emulation Tool will display a message for the Update connection parameters. Select Yes, as shown in Figure Figure Update Connection Parameter Option Note: If you select No, the project will still work. However, the current consumption will be higher due to faster connection interval. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 58

59 Example Projects 10.Click Discover All Attributes to find all attributes supported by the Peripheral. Figure Discover All Attributes 11.When all the attributes are listed, locate the Client Characteristic Configuration descriptor (UUID 0x2902) under CapSense Proximity characteristic (UUID 0x0003CAA F9B0131). Click Read Value to read the existing CCCD value as shown in Figure Figure Read CapSense Proximity CCCD CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 59

60 Example Projects 12.Modify the Value field to '01:00' and click Write Value. This enables the notifications on the CapSense proximity characteristic. Figure Write CCCD to Enable Notifications 13.Bring your hand closer to the proximity sensor on the BLE Pioneer Kit, as shown in Figure 4-40 and observe the value changing in the characteristic value field, as shown in Figure Figure CapSense Proximity Sensing with PSoC 4 BLE Module Figure CapSense Proximity Notification Received 14.Modify the Value field of the Client Characteristic Configuration descriptor to '00:00' to disable notifications. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 60

61 Example Projects 15.To disconnect from the device, click Disconnect, as shown in Figure Figure Disconnect from the Device 16.Press user button (SW2) to wake up from sleep and restart the advertisement for the next connection CySmart Mobile Application To verify the CapSense Proximity project using the CySmart mobile application (refer CySmart Mobile App webpage), follow these steps: 1. Place the PSoC 4 BLE Module on the BLE Pioneer Baseboard. 2. Connect the five-inch wire as a loop to the proximity connector J14 on the baseboard. 3. Plug the BLE Pioneer Kit into the computer, using the J13 USB connector. 4. Program the kit with the PSoC_4_BLE_CapSense_Proximity example project. Follow steps in Using Example Projects on page 37 to program the device. 5. Press the user button (SW2) on the BLE Pioneer Kit to start the advertisement. 6. Open the CySmart mobile application on the mobile device. If Bluetooth is not enabled on the device, the app will ask to enable it. 7. The app will automatically search for available peripherals and list them. Select the CapSense Proximity peripheral, as shown in Figure Figure Connect to CapSense Proximity Peripheral CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 61

62 Example Projects 8. When connected, the app will list the services supported by the peripherals. Scroll and select the CapSense Proximity service. 9. When the CapSense service page opens, bring your hand near the sensor wire on the BLE Pioneer Kit and see a similar response in the app as a bar graph, as shown in Figure Figure CapSense Proximity Sensing with PSoC 4 BLE Module 10.To disconnect from the BLE Pioneer Kit, return to the device selection screen on the CySmart mobile application. 11.To reconnect to the Peripheral, press the user button (SW2) on the BLE Pioneer Kit to restart the advertisement and scan for the device in the CySmart mobile application. 4.4 BLE Central Mode Project Description The BLE projects described above have been functioning as Peripheral devices. This means that the firmware role was set to be a Peripheral and GATT server; another device such as the CySmart Central Emulation Tool or CySmart mobile application will connect to it and collect the data. This example project demonstrates the Central and GATT client mode where it will scan for a Peripheral device, connect to it, and send commands. In this project, the BLE Pioneer Kit scans and autoconnects to a particular Peripheral device supporting Immediate Alert Service (IAS). Whenever the Peripheral with a predetermined public address is found, a connection request is sent followed by discovering the attributes. When the discovery is over, you can send one of the three alert levels to the Peripheral device over the IAS. This is done by pressing the SW2 button on the BLE Pioneer Kit and cycling through the alert levels. The BLE Central project supports low-power mode operation, where the firmware supports BLE Hardware block and CPU Deep Sleep mode whenever possible. The system remains in Deep Sleep when disconnected. Press SW2 to wake up the system and start scanning (blinking blue LED). The scanning timeout interval is set to 30 seconds. If a particular Peripheral device is found advertising before timeout, a connection is made (blue LED always ON). If no such device is found, then the CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 62

63 Example Projects system stops scanning and returns to Deep Sleep mode (LED OFF). Press SW2 again to wake the system and restart scanning. To aid in evaluation, the Peripheral project with the particular public address is provided in the same workspace. This Peripheral project supports IAS and has fixed public address that the Central device will recognize and auto-connect to. The project should be programmed on the BLE Dongle and powered through the USB port of the computer. The received alert levels (No, Mid, and High alert) on the BLE Dongle are represented by different LED status. No Alert is represented by LED OFF, Mid Alert by blinking LED, and High Alert with LED always ON. Upon each successive button press on the BLE Pioneer Kit, the LED state on the BLE Dongle changes in a circular fashion. The PSoC_4_BLE_Central_IAS demonstrates the BLE Central functionality on PSoC 4 BLE Module. Additionally, the BLE_Dongle_Peripheral_IAS project is to be programmed on the BLE Dongle. This project is present in both the PSoC_4_BLE_Central_IAS workspace and can be used to program the BLE Dongle separately. Note: If the BLE Dongle is programmed with the BLE_Dongle_Peripheral_IAS example, it will not work with the CySmart PC utility. Reprogram the BLE Dongle with the CySmart firmware according to Updating BLE Dongle for CySmart Central Emulation Tool on page 32 to use the CySmart Central Emulation Tool. Figure PSoC_4_BLE_Central_IAS TopDesign CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 63

64 Example Projects Figure BLE_Dongle_Peripheral_IAS TopDesign Hardware Connections No specific hardware connections are required for this project because all connections are hardwired on the BLE Pioneer Baseboard. BLE_Dongle_Peripheral_IAS programs the BLE Dongle with Peripheral mode firmware. The pin assignment for this project is in PSoC_4_BLE_Central_IAS.cydwr in the Workspace Explorer, as shown in Figure Figure Pin Selection for BLE IAS Central Example Project Similarly, the pin assignment for the BLE Dongle Peripheral project is in BLE_Dongle_Peripheral_IAS.cydwr in the Workspace Explorer as shown in Figure Figure Pin Selection for BLE IAS Peripheral Example Project CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 64

65 Example Projects Flow Chart Figure 4-49 shows the flow chart for the IAS GATT client mode example project. Figure IAS GATT Client Mode Flow Chart Start Start BLE component Scan for Peripherals and blink Blue LED Yes Dongle Peripheral found? Yes Connect to the Peripheral and turn on Blue LED No Disconnected? No User switch pressed? Yes Send the next alert level to the Peripheral No Process BLE Events CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 65

66 Example Projects Figure 4-50 shows the flow chart for the IAS GATT server mode example project. Figure IAS GATT Server Mode Flow Chart Start Start PWM and BLE components Register IAS Callback Start Advertisement and wait for connection Yes Connected Wait for alert notification No Disconnected? Turn off LED Low Notification level? Mid Blink LED every second High Turn on LED Process incoming BLE events CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 66

67 Example Projects Verify Output 1. Connect the BLE Dongle to one of the USB ports on the computer. Figure Connect BLE Dongle to USB Port 2. In the PSoC Creator Workspace Explorer, right-click the BLE_Dongle_Peripheral_IAS project and select Set As Active Project, as shown in Figure Figure Set Dongle Peripheral Project as Active CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 67

68 Example Projects 3. Program the BLE Dongle with the BLE_Dongle_Peripheral_IAS project. Follow the steps described in Using Example Projects on page 37. Note: Do not update the public device address (inside the BLE Component) for the BLE_Dongle_Peripheral_IAS example project. Changing the BLE_Dongle_Peripheral_IAS example project public address will lead to no connection with the BLE Central device on the BLE Pioneer kit. 4. Power the BLE Pioneer Kit through USB connector J In the Workspace Explorer, right-click the PSoC_4_BLE_Central_IAS project and select Set As Active Project, as shown in Figure Figure Set Central IAS Project as Active 6. Program the BLE Pioneer Kit with the PSoC_4_BLE_Central_IAS project. 7. Press the SW2 button on the BLE Pioneer Kit to wake the system and start scanning. Scanning is indicated by a blinking LED. 8. Wait for the BLE connection between the BLE Dongle and the BLE Pioneer Kit. The connection success status is indicated on the baseboard in the following three stages: a. Fast blinking blue LED represents scanning mode. During this mode, the BLE Pioneer Kit is scanning for Peripheral devices. b. Slow blinking blue LED represents discovery mode. During this mode, the BLE Pioneer Kit has found the BLE Dongle Peripheral device and has started the connection procedure. c. The blue LED remains on, representing the connected mode. This mode indicates that the Peripheral device is connected and the application can now send alert levels. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 68

69 Example Projects 9. Press the SW2 button on the BLE Pioneer Kit to send the next alert level to the BLE Dongle. The alert level will rotate from No Alert to Mid Alert to High Alert. Figure User Button on BLE Pioneer Kit with PSoC 4 BLE Module 10.Check if the LED behavior changes for each alert notification on the BLE Dongle according to the following table: Alert Level No Alert Mild Alert High Alert LED State LED Off LED Blinking LED On Note: To revert the CySmart functionality to the dongle, program the dongle hex file, as described in Updating BLE Dongle for CySmart Central Emulation Tool on page 32. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 69

70 Example Projects 4.5 Eddystone Project Description This project demonstrates a BLE beacon based on Google's Eddystone protocol on the BLE Pioneer Kit. A beacon is a wireless device that broadcasts data (such as temperature) over a periodic radio signal from a known location. BLE-based beacons use the BLE advertisement packets to broadcast data. This project demonstrates the following: Beacon (non-connectable advertisement) Beacon configuration (connectable advertisement) Google's Eddystone is a protocol that defines BLE advertisement data formats for beacons. In Eddystone parlance, the advertisement data is called a frame and the advertisement data format is called a frame type. The protocol supports multiple frame types that may be used individually or in combinations to create beacons for a variety of applications. Figure Characteristic Configuration in BLE Component for Eddystone Beacon The BLE profile in this project consists of two BLE custom services, Eddystone and Eddystone Configuration (see Figure 4-55). The project broadcasts one of the following beacon frames in a non-connectable advertisement packet. Eddystone-UID frame broadcasts a unique 16-byte Beacon ID composed of a 10-byte namespace and a 6-byte instance. The Beacon ID may be useful in mapping a device to a record in external storage. The namespace portion of the ID may be used to group a particular set of beacons, while the instance ID identifies individual devices in the group. The division of the ID into namespace and instance components may also be used to optimize BLE scanning strategies, for example, by filtering only on the namespace. More details are available here. Eddystone-URL frame broadcasts a URL using a compressed encoding format to fit more within the limited advertisement packet. More details are available here. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 70

71 Example Projects Eddystone-TLM frame broadcasts telemetry information about the beacon itself such as battery voltage, device temperature, and counts of broadcast packets. More details are available here. The Eddystone Configuration Service consists of nine characteristics as follows. Lock State Read returns true if the device is locked. Lock Locks the beacon and sets the single-use lock-code. Unlock Unlocks the beacon and clears the single-use lock-code. URI Data Reads/writes the URI. URI Flags Reads/writes the flags. Advertised Tx Power Levels Reads/writes the Advertised Power Levels array. Tx Power Mode Reads/writes the TX Power Mode. Beacon Period The period in milliseconds that an Eddystone-URL packet is transmitted. Reset Resets to default values. More details on the Eddystone Configuration service can be found here. The project consists of the following files: main.c/.h These files contain the main function, which is the entry point and execution of the firmware application. They contain function definitions for initialization and handling low power mode of the system. By default on power-on-reset, the system will do a non-connectable advertisement of URL/ URI and TLM packets. When the SW2 button is pressed, the device will enter connectable mode and various characteristics can be configured. Eddystone.c/.h These files contain the functions required to implement the Eddystone protocol including advertisement packet creation (for UID/URL and TLM), advertisement scheduling, and configuration read/write. The battery and temperature data are also updated before the TLM packets are constructed and advertised. WatchdogTimer.c/.h These files contain functions that provide necessary timing for the operation of the system. Battery.c/.h These files contain a function that will measure the battery voltage of the kit. This information is advertised as part of the TLM packets. Temperature.c/.h These files contain a function that will measure the die temperature of the PSoC device. An external sensor may be attached to measure ambient temperature. This information is advertised as part of the TLM packets. The green LED indicates UID/URL packet transmissions, the blue LED indicates TLM packet transmissions, and the red LED indicates that the device is in connectable mode. In this mode, when connected, the beacon configuration can be modified. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 71

72 Example Projects PSoC_4_BLE_ Eddystone demonstrate this functionality on PSoC 4 BLE Module. Figure Top Design for PSoC_4_BLE_Eddystone Project Hardware Connection Ensure that the PSoC 4 BLE module is placed on the baseboard. Connect a wire (provided as part of this kit) between VREF (connector J3) and P3.0 (connector J2) on the baseboard (see Figure 4-57). Figure VREF (J3) and P3.0 (J2) Connectors on BLE Pioneer Kit with PSoC 4 BLE Module CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 72

73 Example Projects The pin assignment for this project is in PSoC_4_BLE_Eddystone.cydwr in the Workspace Explorer, as shown in Figure Figure Pin Selection for Eddystone Project Flow Chart Figure 4-59 shows the flow chart of code implemented. Figure Eddystone Project Flow Chart System initialized Start Non-connectable Advertisement of URL/URI Packets Start Non-connectable Advertisement of TLM Packets Low Power Mode Yes No Is current advertisment packet URL/URI Yes Advertisment Timeout? No SW2 Pressed? No Yes Start Connectable Advertisement Connection Established Before timeout? Yes Read/write Configurations as Requested No Is Disconnected? Yes CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 73

74 Example Projects Verify Output The project can be verified using an Android smart phone or an ios device (iphone or ipad). Before proceeding further make sure that a beacon application (such as Locate Beacon for Android or Chrome browser for ios) and the CySmart app are installed on the smart phone/device. Also make sure that Bluetooth is turned on in the device, and you have a working internet connection. To verify the Eddystone project in ios, using Chrome for ios browser, follow these steps. Before you start, make sure the Chrome browser for ios is installed in your ios device and the Chrome widget is added to the widgets view. 1. Place the PSoC 4 BLE Module on the BLE Pioneer Baseboard. 2. Power the BLE Pioneer Kit through the USB connector J Program the BLE Pioneer Kit with the PSoC_4_BLE_Eddystone example project. Follow steps in Using Example Projects on page 37 to program the device. 4. After programming successfully, the firmware starts the non-connectable advertisement of UID/ URL and TLM packets. Advertisement of UID/URL packets is indicated by the green LED and TLM packets is indicated by blue LED on the baseboard. 5. Pull down the notification area. You should be able to see the link in the notification area as shown in Figure 4-60 on page 74. Figure ios Notification Shade Showing the Beacon Advertised Web Link 6. Touching the link will take you to the website. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 74

75 Example Projects To verify the Eddystone project in Android devices using the Locate Beacon application, follow these steps. 1. Place the PSoC 4 BLE Module on the BLE Pioneer Baseboard. 2. Power the BLE Pioneer Kit through the USB connector J Program the BLE Pioneer Kit with the PSoC_4_BLE_Eddystone example project. Follow steps in Using Example Projects on page 37 to program the device. 4. After programming successfully, the firmware starts the non-connectable advertisement of UID/ URL and TLM packets. Advertisement of UID/URL packets is indicated by the green LED and TLM packets is indicated by blue LED on the baseboard. 5. Launch the Locate application on the smart phone/device. 6. Click the Locate Beacons button to start scanning for beacons (see Figure 4-61). Figure Locate Beacon App Home Screen CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 75

76 Example Projects 7. In the next screen a list of Visible Beacons will be displayed. Click the desired beacon (see Figure 4-62) to display its status and information (see Figure 4-63). Figure Locate Beacon App Showing Discovered Beacons Figure Locate Beacon Showing Details about Selected Beacon CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 76

77 Example Projects To read and write characteristics (using an Android or ios device, and CySmart app) of the beacon follow these steps. 1. Press SW2 on the BLE Pioneer Kit baseboard to start the connectable advertisement. The advertisement state is indicated by the red LED. 2. Launch the CySmart app on your Android smart phone/device. 3. Connect to the CY Eddystone device from the list by clicking on it (see Figure 4-64). Figure CySmart App Showing the CY Eddystone Beacon CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 77

78 Example Projects 4. Click the GATT DB menu option (see Figure 4-65). Figure CySmart Showing GATT DB Option for CY Eddystone Device 5. Click on Unknown Service (see Figure 4-66) to see all available characteristics. Figure CySmart Showing Unknown Service in GATT DB CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 78

79 Example Projects 6. Click on any of the characteristics to read and modify it. For reference on Eddystone Configuration characteristics, refer to the Google Eddystone page. To understand more about the CySmart app, refer to the CySmart user guide. 7. Disconnect from the device to go back to the beacon mode. 4.6 BLE Dongle and LED Control Project Description This firmware supports the CySmart debug tool (refer CySmart Central Emulation Tool) by acting as the BLE host emulator. This is the default firmware that comes in the BLE Dongle shipped with the kit. This project additionally demonstrates LED brightness control via a custom BLE profile, which works with the CapSense slider example explained in CapSense Slider and LED on page 41. The device will scan for the Peripheral, which acts as a CapSense slider and LED device, and connect to it automatically. This is achieved by filtering the advertisement packets for the CapSense slider service data. Then, it will enable slider notifications and process the received notifications. Whenever CapSense detects activity, it will notify the finger location to the BLE Dongle; it will update the LED brightness using PWM. The custom GATT client LED control will be stopped if the CySmart Central Emulation Tool acquires the dongle. The dongle will enter the CySmart emulator mode, in which it will process all BLE commands as triggered by the user via the tool. The project uses custom command/event protocol to exchange data between the CySmart Central Emulation Tool and the BLE device via a USB-CDC interface. It uses the Cypress USB-UART bridge functionality from the PSoC 5LP-based KitProg module. Note: This project is meant only for the PRoC BLE device and works on the CY5677 CySmart BLE 4.2 USB Dongle hardware. Figure Top Design for BLE_4_2_Dongle_CySmart_256K Project CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 79

80 Example Projects Hardware Connections No specific hardware connections are required for this project because all connections are hardwired on the BLE Dongle. The pin assignment for this project is in BLE_4_2_Dongle_CySmart_256K.cydwr in the Workspace Explorer, as shown in Figure Figure Pin Selection for BLE Dongle Project CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 80

81 Example Projects Flow Chart Figure Flow Chart for BLE_4_2_Dongle_CySmart_256K Project Power BLE Dongle Start BLE, PrISM and UART Component CySmart tool started Yes Enter CySmart emulator mode No No User button triggered Exit CySmart emulator mode Yes Scan for CapSense device No Yes CapSense device found? Perform connect and GATT Discovery sequence System in sleep and waiting for user button press Yes Update LED brightness as per slider position Yes Enable notifications for CapSense slider Notification occurs with valid position value? No USB suspend triggered? Wait for slider position change notifications No CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 81

82 Example Projects Verify Output This project will be used when the CySmart Central Emulation Tool is invoked for testing other example projects. In addition, the LED control operation can be verified as follows. 1. Power the BLE Pioneer kit through the USB connector J Program the BLE Pioneer kit with the PSoC_4_BLE_CapSense_Slider_LED example project described in CapSense Slider and LED on page Connect the BLE Dongle to one of the USB ports on the computer. 4. Program the BLE Dongle with the BLE_4_2_Dongle_CySmart_256K project. See Using Example Projects on page 37 for programming instructions. 5. Press the user button SW2 on both the BLE Dongle and the BLE Pioneer Kit. The BLE Dongle will start scanning and the BLE Pioneer Kit will start advertising. 6. Wait for the BLE connection between the BLE Dongle and the BLE Pioneer Baseboard. The connection success status will be indicated by a 3-second ON state of the red LED followed by the OFF state on the BLE Pioneer Baseboard. 7. Swipe your finger on the CapSense slider and check the LED brightness variation on the BLE Dongle. 4.7 Direct Test Mode (DTM) Project Description Bluetooth Core specification (v4.0 and later), Volume 6, Part F defines Direct Test Mode (DTM) as a method to test the BLE PHY layer and provide a report back to the tester. It uses a Host Controller Interface (HCI) with a two-wire UART as the communication protocol. The Device Under Test (DUT) is the BLE system that is to be tested (for example, BLE Pioneer Kit). With DTM, the RF performance of the BLE system can be verified during development or on a production line. The environment consists of the DUT and a tester. The tester has two parts; the upper tester sends commands through the HCI and the lower tester performs the corresponding action over the RF link. The tester compares the command sent over the HCI and the response received over RF, and provides a result of the performance. Figure Direct Test Mode (DTM) Setup HCI/UART Upper Tester DUT RF (2.4 GHz) Lower Tester The BLE Component allows configuring the device in DTM by enabling the HCI. The appropriate responses to commands from the tester are performed by the BLE protocol stack and does not involve separate application handling. The only task required are to start the BLE Component and call the API to process the events. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 82

83 Example Projects The HCI is enabled in the BLE Component under the General settings. Note that when the HCI mode is selected, all other tabs are hidden and cannot be configured. This is because in HCI mode, there are no upper layer processes. On enabling HCI mode, the components automatically reserves a UART block to allow communication between the tester and BLE stack. The UART exposes the pins that can be assigned in <project.cydwr> file under the Pins tab. The only options to be configured for HCI mode are the baud rate and the pins for communication with the tester. Figure HCI Mode in BLE Component CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 83

84 Example Projects Many companies develop BLE testers for Direct Test Mode. It is also possible to create PC-based software tools that will send HCI commands over serial communication links. For PC-based software, the serial communication link is the COM port, which is enumerated by the KitProg on the PSoC 5LP of the BLE Pioneer kit. In such a case, the UART pins on the PSoC 4 BLE should be assigned to P1_4 and P1_5. These pins are hardwired to pins on the PSoC 5LP which allows USB-UART data communication between the PC-based software and the BLE device. For external BLE testers, the serial communication is mostly over RS232. To test with that type of system, an external RS232 voltage translator is required, such as Digilent's PmodRS232. This translator will modify the signal levels of the serial communication between the BLE device and the RS232 port on the tester. The UART pins of the BLE device can be assigned to P0_0 and P0_1 and header J5 can be used to connect to the RS232 translator. Figure J5 Header to Interface RS232 Translator CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 84

85 Example Projects Hardware Connection For DTM test mode, it is recommended to use SMA connectors and connect the tester and DUT using an SMA to SMA connector cable. This ensures that there is minimum interference to RF communication between the DUT and tester, and the performance measured is the true RF performance of the device. The BLE Pioneer Kit module with SMA connector (CY8CKIT-141 PSoC 4 BLE) is available separately and can be ordered from the Cypress web page. Four UART pins are exposed when HCI mode is selected in the BLE Component. These pins should be assigned to allow communication with the external tester. The connection depends on the tester being used. If the tester is PC-based software that communicates with HCI over a serial link, then the onboard PSoC 5LP on the BLE Pioneer Kit can act as the USB-UART bridge. The KitProg on the PSoC 5LP enumerates as a USB-UART interface and opens a COM port on the computer. This COM port is then used by the software tool to communicate commands to the BLE device. In this case, the UART pins should be assigned as follows. Table 4-1. UART Pin Assignment for PC Software Tester UART Pins RX TX RTS CTS Pin Assigned P1_4 P1_5 P1_6 P1_7 The UART for HCI communication exposes hardware flow control lines CTS and RTS. They can either be connected to the hardware control lines of the tester or CTS connected to ground for operation without hardware flow control. If the tester is an external hardware tester (CBT), then connect any of the RS232 voltage translators to header J5 on the BLE Pioneer Kit. The UART pins should be assigned as follows. Table 4-2. UART Pin Assignment for RS232 Voltage Translator UART Pins RX TX RTS CTS Pin Assigned P0_0 P0_1 P0_2 P0_ Verify Output 1. Connect the BLE Pioneer Kit through the USB connector J Program the BLE Pioneer Kit with the PSoC_4_BLE_DTM project, as described in Using Example Projects on page 37. Programming should complete successfully. 3. Connect the serial link, UART, or RS232 to the tester. 4. On the software tool for tester, configure the UART communication with the correct COM port and baud rate, as set in the BLE Component. 5. Start the test. The tool will generate the report after the end of the test. This depends on the tester/tool being used. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 85

86 5. Hardware This chapter describes the contents of the BLE Pioneer Kit hardware and its different blocks, such as the power block, USB connection, Arduino-compatible headers, module connectors, and CapSense slider. The schematic and board layouts are available at the following location: <Install_Directory>\Cypress\CY8CKIT-042-BLE Kit\<version>\Hardware. 5.1 BLE Pioneer Baseboard PSoC 5LP An onboard PSoC 5LP contains the KitProg, which is used to program and debug the BLE device. The PSoC 5LP connects to the USB port of the computer through a USB Mini-B connector and to the SWD interface of the BLE device. PSoC 5LP is a true system-level solution providing MCU, memory, analog, and digital peripheral functions in a single chip. The CY8C58LPxx family offers a modern method of signal acquisition, signal processing, and control with high accuracy, high bandwidth, and high flexibility. The analog capability spans the range from thermocouples (near DC voltages) to ultrasonic signals. For more information, visit the PSoC 5LP web page. See Serial Interconnection between KitProg and Module on page 102 for more details Power System The power supply system on the BLE Pioneer Baseboard is versatile, allowing the input supply to come from the following sources: 5-V power from the onboard USB connector 5-V to 12-V VIN power from the Arduino power header (J1) 3-V from the CR2032 coin cell CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 86

87 SOD123 SOD123 SOD123 SOD123 Hardware An adjustable LDO is used to output three different voltage levels (1.9 V, 3.3 V, and 5 V) to power the module. These voltages are selected with the J16 jumper, as shown in Figure 5-1. Figure 5-1. Schematics and Board Highlight of LDO and Power Selection Jumper D1 VBUS VIN D2 D EN_CTRL VCC + C1 1 ufd U1 1 CTL OUT 4 2 VCC C 5 3 NC GND 6 BA00BC0WFP-E2 R1 11K 1% VADJ 3216 D3 + C2 4.7uF VDD VCC R3 14.7K 1% R4 10K 1% R5 4.3K 1% EN_CTRL EN_CTRL R10 10K J16 3 PIN HDR TABLE: LDO PIN FUNCTIONS TABLE: VOLTAGE SELECTION JUMPER SETTINGS Pin No. Symbol Function JUMPER SETTING O/P VOLTAGE 1 CTL Output Voltage ON / OFF control SHORT 2 & 3 5V 2 VCC Power supply voltage input SHORT 1 & 2 3.3V 3 N.C. Unconnected terminal REMOVE JUMPER 1.9V 4 OUT Voltage output 5 C Output voltage regulation terminal TP4 BLACK TP5 BLACK TP6 BLACK 6 GND Ground NO LOAD NO LOAD GND Test Points The input to the LDO can come from either the USB, the VIN pin in the Arduino header J1, or header J9. Note: The typical dropout voltage of the selected LDO is 0.3 V at 500-mA output current. This gives a minimum output of 4.6 V from the input voltage of 5 V from the VBUS. This drop also considers the voltage drop across the Schottky diode connected at the output of the LDO to protect against voltage applied at the output terminal of the regulator. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 87

88 Hardware The BLE Pioneer Baseboard also contains a CR2032 coin cell holder to power it using a coin cell, as shown in Figure 5-2. Figure 5-2. Schematics and Board Highlight of Coin Cell Holder Protection Circuits The power supply rail has reverse-voltage, overvoltage, short circuits, and excess current protection features, as shown in Figure 5-3. Figure 5-3. Power Supply Block Diagram With Protection Circuits I/O Header 5V Vin Coin cell Battery Holder ~3V 3.3V MOSFET based Protection Ckt LDO BLE Module USB 5V ESD Protection PTC PSoC 5LP 10 Pin Prog. Header PSoC 5LP PSoC 4 BLE 10 Pin Prog. Header A PTC resettable fuse is connected to protect the computer's USB ports from shorts and overcurrent. ORing diodes prevent damage to components when the BLE Pioneer Baseboard is powered from different voltage sources at the same time. ESD protection is provided for the USB Mini-B connector. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 88

89 Hardware A MOSFET-based protection circuit is provided for overvoltage and reverse-voltage protection for the 3.3-V rail from J1.5, as shown in Figure 5-4. Figure 5-4. Schematics and Board Highlight of MOSFET Protection Circuit for 3.3-V Rail from J1.5 V3.3 Q1 R7 ZERO NO LOAD PMOS( NTR4171PT1G) VDD PMOS( DMP3098L-7) Vz=3.9V(BZT52C3V9-7-F) R8 15K D9 Q3 PMOS(PMV48XP,215) R9 10K Q2 CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 89

90 Hardware Current Measurement Jumper To demonstrate the low power consumption of PSoC 4 BLE Module, a two-pin header (J15) is populated in series with the power supply to the module. This can be used to measure current using an ammeter without the need to desolder any component from the BLE Pioneer Baseboard, as shown in Figure 5-5. Figure 5-5. Schematics and Board Highlight of Current Measurement Jumper J HDR2 VDD BLE_VDD R44 ZERO 0805 NO LOAD VTARG 0603 R45 ZERO CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 90

91 Hardware The following methods are supported for measuring the current consumption of the module. When the BLE Pioneer Baseboard is powered through the USB port (J13), remove jumper J15 and connect an ammeter, as shown in Figure 5-6. Figure 5-6. Current Measurement when Powered from USB Port CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 91

92 Hardware When the BLE Pioneer Baseboard is powered from an external voltage supply, remove the USB cable from J13. Connect the positive terminal of the external voltage supply to the positive terminal of the ammeter and the negative terminal of the ammeter to the upper pin of J15. Connect the negative terminal of the external voltage supply to an onboard GND pin. Figure 5-7 shows the required connections. Figure 5-7. Current Measurement when Powered Separately VOLTAGE SOURCE - + CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 92

93 Hardware To measure the power consumption of only the module with coin cell, connect the coin cell directly to the PSoC 4 BLE Module, as shown in Figure 5-8. The BLE Pioneer Baseboard is designed with additional circuits to protect the BLE device and the F-RAM in an Arduino environment. Note that power consumption measurements on the BLE Pioneer Baseboard will also include the power consumed by these additional circuits. Connect the positive terminal of the coin cell to pin J2.2 and negative terminal to pin J2.4 using wires. Figure 5-8. Powering the Module using a Coin Cell Programming Interface The BLE Pioneer Kit allows you to program and debug the PSoC 4 BLE in two ways: Using the onboard KitProg Using a CY8CKIT-002 MiniProg3 programmer and debugger Expansion Connectors Arduino-Compatible Headers (J1, J2, J3, J4, and J12-unpopulated) Arduinocompatible power header (J1) The BLE Pioneer Kit has five Arduino-compatible headers: J1, J2, J3, J4, and J12, as shown in Figure 5-9. You can develop applications based on the Arduino shield's hardware. Figure 5-9. Arduino Headers Arduinocompatible I/O header (J3/J4) Arduinocompatible I/O header (J2) CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 93

94 Hardware The J1 header contains I/O pins for reset, I/O reference voltage (IOREF), and power supply line. The J2 header is an analog port that contains I/O pins for SAR ADC, comparator, and opamp. The J3 header is primarily a digital port that contains I/O pins for PWM, I 2 C, SPI, and analog reference. The J4 header is also a digital port that contains I/O pins for UART and PWM. The J12 header is an Arduino ICSP-compatible header for the SPI interface and is not populated. Refer to the No Load Components section of Bill of Materials (BOM) on page 115 for the header part number. Note: Take care when powering the Arduino shields via Arduino-compatible power header (J1). The V3.3 pin will output 5 V when the board is powered from USB/VIN and the system power supply jumper (J16) is set to 5 V operation. Additional Functionality of Header J2 The J2 header is a 6 2 header that supports Arduino shields. The Port 2 and Port 3 pins of PSoC 4 BLE are brought to this header. The Port 2 pins also connect to the onboard CapSense slider through 560-ohm resistors. When the CapSense feature is not used, remove these resistors to help ensure better performance with these pins Pmod Connector - Digilent Pmod Compatible (J5-unpopulated) This port supports Digilent Pmod modules (see Figure 5-10). Pmods are small I/O interfaces that connect with the embedded control boards through either 6- or 12-pin connectors. The BLE Pioneer Kit supports the 6-pin Pmod Type 2 (SPI) interface. For Digilent Pmod cards, go to This header is not populated on the BLE Pioneer Baseboard. You must populate this header before connecting the Pmod daughter cards. Refer to the No Load Components section of Bill of Materials (BOM) on page 115 for the header part number. Figure Schematics and Board Highlight of Pmod Connector Digilent Pmodcompatible I/O header (J5) CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 94

95 Hardware PSoC 5LP GPIO Header (J8) An 8 2 header is provided on the BLE Pioneer Baseboard to pull out several pins of PSoC 5LP to support advanced features such as a low-speed oscilloscope and a low-speed digital logic analyzer (see Figure 5-11). This header also contains the USB-Serial interface pins that can be used when these pins are not accessible on the Arduino headers because a shield is connected. Note: You can use PSoC 5LP for your own custom firmware. Figure Schematics and Board Highlight of PSoC 5LP GPIO Expansion Header UART RX SPI_SSEL VDD 1 P5LP0_0 3 1 P5LP3_4 5 3 P5LP3_6 7 5 P5LP12_6 9 7 P5LP12_111 9 P5LP12_ P5LP2_ J8 2 P5LP1_2 2 4 P5LP0_1 4 6 P5LP3_5 6 8 P5LP3_ P5LP12_ P5LP3_ P5LP12_ x2 RECPT UART TX SPI_MOSI PSoC 5LP GPIO Expansion Header USB-Serial Bridge Connections P5LP12_ UART RX P5LP12_ UART TX P5LP12_ SPI SCLK / I2C SCL P5LP12_ SPI MISO / I2C SDA P5LP12_ SPI MOSI P5LP2_ SPI SSEL CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 95

96 Hardware USB Mini-B Connector The PSoC 5LP connects to the USB port of a computer through a Mini-B connector (see Figure 5-12), which can also be used to power the BLE Pineer Baseboard. A resettable polyfuse is used to protect the computer's USB ports from shorts and overcurrent. If more than 500 ma is drawn from the USB port, the fuse will automatically break the connection until the short or overload is removed. Figure Schematics and Board Highlight of USB Mini-B Connector NO LOAD TP2 RED VBUS F1 PTC Resettable Fuse 1 2 S2 S1 7 6 J13 VBUS 1 DM 2 DP 3 ID 4 GND 5 USB MINI B DM DP D6 D7 D8 P5LP_DM P5LP_DP K R C uf CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 96

97 Hardware CapSense Circuit CapSense Slider The BLE Pioneer Kit has a five-segment linear capacitive touch slider, which is connected to the PSoC 4 BLE Module pins (see Figure 5-13). The CMOD and CTANK capacitors are required for CapSense functionality and are provided on the PSoC 4 BLE Module (see Module Board on page 104). A 2.2-nF capacitor is present on the CMOD pin, P4[0], for CapSense operation. BLE Pioneer Kit also supports CapSense designs that enable waterproofing. The connection of the shield to the pin or to ground is made by resistors R12 and R13, respectively. By default, R13 is mounted on the BLE Pioneer Baseboard, which connects the shield to ground. Populate R12 and remove R13 when evaluating waterproofing designs, which will connect the shield to the designated pin, P1[6]. Figure Schematics and Board Highlight of CapSense Slider and Shield Setting CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 97

98 Hardware Proximity Header The BLE Pioneer Baseboard contains a header (J14) for CapSense proximity wire connection (see Figure 5-14). Figure Schematics and Board Highlight of Proximity Header CON6 SS 1 MOSI 2 MISO 3 SCK 4 GND 5 VCC 6 P0_2 P0_0 P0_1 P0_3 VDD P2_0 R19 ZERO 0603 J14 1x1 RECP Proximity Header CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 98

99 Hardware BLE Pioneer Baseboard LEDs The BLE Pioneer Baseboard has three LEDs. A green LED (LED2) indicates the status of the programmer. An amber LED (LED1) indicates the status of power supplied to the board. The BLE Pioneer Kit also has a general-purpose tricolor LED (LED3) for user applications. These are connected to P2_6 (red LED), P3_6 (green LED) and P3_7 (blue LED). Figure 5-15 and Figure 5-16 show the schematics of these LEDs. Figure Schematics of Status and Power LED P5LP3_1 R11 LED ohm Status LED Green Status LED VADJ TP1 RED NO LOAD R2 LED ohm Power LED Figure Schematics and Board Highlight of RGB LED LED3 R28 2.2K R29 1.5K P2_6 1 4 BLE_VDD R G R30 1.5K 2 3 P3_6 P3_7 B RGB LED CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 99

100 Hardware Push-Buttons The BLE Pioneer Baseboard contains a reset push-button and a user push-button, as shown in Figure The reset button is connected to the XRES pin of BLE device and is used to reset it. The user button is connected to P2[7] of the BLE device. Both the buttons connect to ground on activation (active low). Figure Schematics and Board Highlight of Reset Button and User Button SW1 SW2 /XRES /XRES 1 2 P2_ C uf EVQ-PE105K RESET EVQ-PE105K USER SWITCH RESET (SW1) User Button (SW2) CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 100

101 Hardware Cypress Ferroelectric RAM (F-RAM) The BLE Pioneer Baseboard contains the FM24V10-G F-RAM device (see Figure 5-18), which can be accessed through I 2 C lines P5[0] and P5[1] of the PSoC 4 BLE Module. The F-RAM is 1-Mbit (128KB) with an I 2 C speed up to 1 Mbps. The I 2 C slave address of the F-RAM device is seven bits wide, and the LSB two bits are configurable through physical pins and are hardwired to 00 on the board. By default, the address of the F-RAM device used on the BLE Pioneer Baseboard is 0x50. This address can be modified by changing the R32/R36 and R33/R37 pairs. The operating voltage range of the F-RAM is between 2 V and 3.6 V. To prevent the application of 5 V from the adjustable LDO regulator on the BLE Pioneer Baseboard, a MOSFET-based protection circuit similar to the one used for the 3.3-V rail is connected between the output of the regulator and the VDD pin of the F-RAM. The protection circuit cuts off the power to the F-RAM when the output of the regulator is greater than 3.6 V. Figure Schematics and Board Highlight of F-RAM CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 101

102 Hardware Serial Interconnection between KitProg and Module The KitProg is also a USB-Serial interface. It supports USB-UART and USB-I 2 C bridges (see Figure 5-19). The pull-up resistors on the I 2 C bus are enabled when the protocol is selected from the user interface (such as Bridge Control Panel). The USB-Serial pins of the KitProg are also available on the Arduino header; therefore, it can be used to control Arduino shields with the SPI/I 2 C/UART interface. Refer USB-UART Bridge on page 34 and USB-I2C Bridge on page 35 for more information on how to use these serial interconnections. Figure Schematics and Board Highlight of Serial Interface and I 2 C Pull-Up via FET P5LP2_6 VDD P5LP2_7 R22 2.2K R23 2.2K 2 P5LP12_ U4 NTZD3152P R26 ZERO SDA SPI_MISO / I2C_SDA P5LP12_0 R27 ZERO SCL SPI_SCLK / I2C_SCL I2C Connection CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 102

103 Hardware Module Headers The PSoC 4 BLE Module is connected to the BLE Pioneer Baseboard using the two (24-pin and 20-pin) module headers, as shown in Figure Figure Schematics and Board Highlight of Module Headers P1_6 P1_7 P1_5 P1_3 P1_4 P1_1 VREF P0_4 P0_2 P0_0 J VDDD GND /XRES P0_7 P0_6 P1_2 P1_0 P0_5 P0_3 P0_1 J10 GND 1 2 P3_6 3 4 P3_4 5 6 P3_2 7 8 P3_ P4_ P4_ P2_ P2_ P2_ P2_ VDDR VDDA P3_7 P3_5 P3_3 P3_1 P5_1 P5_0 P2_7 P2_5 P2_3 P2_1 GND HEADER 10x2 Digital Pins HEADER 12x2 Analog Pins For information on how to add these on your own board, refer to Adding BLE Module-Compatible Headers on Your Baseboard on page 123. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 103

104 Hardware 5.2 Module Board PSoC 4 BLE Device The PSoC 4 BLE device is the main component on the module. It provides the RF interface and analog and digital capability. The PSoC 4 BLE pins are mapped to the module headers (see Figure 5-21). For more information, refer to the BLE web page. See BLE Modules and BLE Dongles Compatible with the BLE Pioneer Kit on page 125 for details. Figure Schematics and Board Highlight of Module Headers for BLE Pins ER 10x2 al Pins P1.2 P1.0 P0.5 P0.3 P Ohm Wiggle Antenna J4 2 C pf No Load L1 6.8nH P6.0 P6.1 /XRES P4.0 P4.1 P5.0 P5.1 VDDR VCCD U1 VDDD VDDA XTAL24I XTAL24O P3.7 P3.6 P3.5 P3.4 P3.3 P3.2 P3.1 P3.0 VDDD XTAL32O/P6.0 XTAL32I/P6.1 XRES P4.0 P4.1 P5.0 P5.1 CY8C4247LQI-BL483 VSSD VDDR GANT1 ANT GANT2 VDDR P2.7 P2.6 VREF 42 P2.5 P P2.4 P P2.3 P P2.2 P P2.1 P P2.0 P2.0 VDDA P1.7 P P1.6 P P1.5 P P1.4 P P1.3 P P1.2 P P1.1 P1.1 VDDA P0.0 P0.1 P0.2 P0.3 P0.4 P0.5 P0.6 P0.7 P1.0 1 C pf EPAD 57 VCCD 56 VSSA P3.7 P3.6 P3.5 P3.4 P3.3 P3.2 P3.1 P3.0 VDDA VREF P2.7 P2.6 VDDR XTAL24I XTAL24O VDDR P0.0 P0.1 P0.2 P0.3 VDDD P0.4 P0.5 P0.6 P0.7 P VDDD PCA: PCB: CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 104

105 Hardware Module Power Connections The PSoC 4 BLE module has three power domains: VDDD, VDDA, and VDDR. The VDDD connection supplies power for digital device operation, VDDA supplies power for analog device operation, and VDDR connection supplies power for the device radio. By default, these domains are shorted using a 330-ohm, 100-MHz ferrite bead. The domains are shorted for standalone usage scenarios of module, such as programming the module using MiniProg 3 or using the module as a standalone data acquisition unit. It is recommended to place the ferrite bead between the supply to avoid ripple between VDDR and the other two domains. If the supply ripple is less that 100 mv, these can be changed to a zero-ohm resistor. Figure Schematics and Board Highlight of Ferrite Bead and Power Pin CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 105

106 Hardware Module Headers (20-Pin and 24-Pin Headers) The PSoC 4 BLE Module connects to the BLE Pioneer Baseboard using two (20-pin and 24-pin) module headers (Figure 5-23). All GPIOs and power domains are brought out to these headers. These headers are the counterparts of the connectors in Expansion Connectors on page 93. Figure Schematics and Board Highlight of Headers VDDR TP2 RED P3.6 P3.4 P3.2 P3.0 P4.0 P4.1 P2.6 P2.4 P2.2 P2.0 J VDDA P3.7 P3.5 P3.3 P3.1 P5.1 P5.0 P2.7 P2.5 P2.3 P2.1 TP3 RED TP1 VREF RED P0.4 P0.2 P0.0 HEADER 12x2 Analog Pins J2 VDDD TP4 RED P P1.7 P1.5 P /XRES P0.7 P P0.6 P P P1.0 P0.5 P0.3 P0.1 TP5 BLACK HEADER 10x2 Digital Pins CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 106

107 Hardware Wiggle Antenna PSoC 4 BLE module uses the wiggle antenna. Refer to the Antenna Design Guide (AN91445) for details. Figure Board Highlight of Wiggle Antenna CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 107

108 Hardware Antenna Matching Network An Antenna Matching Network is required between the BLE device and the antenna to achieve optimum performance (Figure 5-25). The matching network has four main tasks: Transform the balanced output of the radio to an unbalanced connection to the antenna (balun). Transform the output impedance of the radio to a 50-ohm antenna. Suppress harmonics to a level below the regulations level in TX mode. Suppress the local oscillator (LO) leakage in RX mode. Figure Schematics and Board Highlight of Antenna Matching Network and Antenna CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 108

109 Hardware BLE Passives Module boards include a 24-MHz crystal and a 32-kHz crystal, the CMOD and shield (CTANK) circuit for CapSense, a SAR bypass capacitor, and adequate decoupling capacitors for all the power domains, as shown in Figure Figure Schematics and Board Highlight External Crystal, CMOD, CTANK, Decaps, Jumpers VDDR 0402 C1 C2 C3 C4 C5 C6 C7 C uf 1.0 uf 1.0 uf uf 0.1 uf 1.0 uf 0.1 uf 1.0 uf 0MHz VDDD VREF 0402 C9 C uf uf 0402 C uf 0603 C uf 0603 C uf SAR bypass VDDA VCCD VDDD 0402 C16 C17 C18 C uf uf uf uf 0603 C uf 0805 R1 Zero Ohm No Load P4.0 P4.1 No Load 0805 R2 Zero Ohm Shunt Resistor C pf CMOD C pf C_Tank CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 109

110 Hardware Test Points All power domains are brought out as test points for easy probing. 5.3 BLE Dongle Board See PSoC 4 BLE Device on page 104 for schematics of PRoC BLE pins. The pinout for PSoC 4 BLE and PRoC BLE are identical. See Wiggle Antenna on page 107 for schematics of wiggle antenna. See Antenna Matching Network on page 108 for schematics of antenna matching network. See BLE Pioneer Baseboard LEDs on page 99 for schematics of power and status LED. See Push-Buttons on page 100 for schematics of push-buttons. Figure Board Highlight CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 110

111 Hardware Power System The BLE Dongle is powered directly using 5 V from the USB port, as shown in Figure Figure Power Supply Block Diagram With Protection Circuits Headers USB USB 5V PTC 5V 5V PRoC PSoC5LP ESD Protection Protection Circuits The PTC resettable fuse is connected to protect the computer's USB ports from shorts and overcurrent USB Type-A Plug The KitProg on the BLE Dongle connects to the USB port of a computer through a USB Type-A plug (Figure 5-29). The BLE Dongle is powered using the same plug. A resettable polyfuse is used to protect the computer's USB ports from shorts and overcurrent. If more than 500 ma is applied to the USB port, the fuse will automatically break the connection until the short or overload is removed. The VBUS, D+, and D lines from the USB connector are also protected against ESD events using TVS diodes. Figure Schematics and Board Highlight of USB Type-A Plug CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 111

112 Hardware User LED A user LED is provided to indicate status from the PRoC BLE device (Figure 5-30). It is also used to show the bind status. Figure Schematics and Board Highlight of User LED BLE_STATUS R7 LED ohm Status LED Blue CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 112

113 6. Advanced Topics This chapter describes the functionality of the FM24V10 F-RAM in the BLE Pioneer Kit. 6.1 Using FM24V10 F-RAM The BLE Pioneer Baseboard has an onboard ferroelectric RAM chip that can hold up to 1 Mb of data. The chip provides an I 2 C communication interface for data access. It is hardwired to the I 2 C lines (P5_0 and P5_1). Because the F-RAM device is an I 2 C slave, it can be accessed or shared among various I 2 C masters on the same line. For more details on the F-RAM device, refer to the device datasheet Address Selection The slave address of the F-RAM device consists of three parts, as shown in Figure 6-1: slave ID, device select, and page select. Slave ID is an F-RAM family-specific ID located in the datasheet of the particular F-RAM device. For the device used in the BLE Pioneer Baseboard (FM24V10), the slave ID is 1010b. Device select bits are set using the two physical pins A2 and A1 in the device. The setting of these two pins on the BLE Pioneer Baseboard is controlled by resistors R32/R36 (A1) and R33/R37 (A2). Because the memory location in F-RAM is divided into two pages of 64KB each, the page select bit is used to refer to one of the two pages in which the read or write operations will take place. Figure 6-1. F-RAM I 2 C Address Byte Structure CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 113

114 Advanced Topics Write/Read Operation The device datasheet includes details on how to perform a write/read operation with the F-RAM. Figure 6-2 and Figure 6-3 provide a snapshot of the write/read packet structure as a quick reference. Figure 6-2. F-RAM Single-Byte and Multiple-Byte Write Packet Structure Figure 6-3. F-RAM Single-Byte and Multiple-Byte Read Packet Structure As shown in the figures, all operations start with the slave address followed by the memory address. For write operations, the bus master sends each byte of data to the memory, and the memory generates an acknowledgement condition. For read operations, after receiving the complete slave address and memory address, the memory begins shifting data from the current address on the next clock. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 114

115 A. Appendix A.1 Bill of Materials (BOM) A.1.1 BLE Pioneer Baseboard Item Qty. Reference Value Description Manufacturer Manufacturer Part No. PCB, mm x mm, High Tg, ENIG finish, 4 Cypress layer, Color = RED, Silk = WHITE. 2 1 BT1 CR2032 Battery Holder CR2032 EJECT HOLDER COIN CELL MPD BA C1 1.0 uf CAP TANT 1UF 35V 10% 1210 AVX Corporation TAJB105K035RNJ 4 1 C2 4.7 uf CAP TANT 4.7UF 20V 10% 1210 AVX Corporation TAJB475K020RNJ 5 1 C ufd CAP 10000PF 16V CERAMIC 0402 SMD TDK Corporation C1005X7R1C103K050BA 6 1 C4 100 ufd CAP CER 100UF 6.3V 20% X5R 1210 TDK Corporation C3225X5R0J107M250AC C5,C8,C9,C10,C ,C14,C17,C18,C CAP.1UF 16V CERAMIC 0.1 ufd 19,C21,C23,C25, X5R 0402 TDK Corporation C1005X5R1A104K050BA C26,C27,C C6,C7,C11,C13,C CAP CERAMIC 1.0UF 25V 1.0 ufd 15,C16,C20 X5R % Taiyo Yuden TMK107BJ105KA-T 9 1 C29 33 uf CAP CER 33UF 6.3V 20% X5R 0805 TDK Corporation C2012X5R0J336M125AC 10 6 D1,D2,D3,D4,D5, D10 MBR0520L 11 3 D6,D7,D8 ESD diode 12 1 D9 3.9V Zener 13 1 D11 2.7V Zener 14 1 F1 FUSE 15 2 J1, J4 8x1 RECP 16 1 J2 6x2 RECP 17 1 J3 10x1 RECP DIODE SCHOTTKY 0.5A Fairchild Semiconductor 20V SOD-123 MBR0520L SUPPRESSOR ESD 5VDC 0603 SMD Bourns Inc. CG0603MLC-05LE DIODE ZENER 3.9V 500MW Diodes Inc SOD12 BZT52C3V9-7-F DIODE ZENER 2.7V 500MW ON Semiconductor SOD123 MMSZ4682T1G PTC RESETTABLE.50A 15V 1812 Bourns MF-MSMF050-2 CONN HEADER FEMALE Protectron Electromech 8POS.1" GOLD P CONN HEADER FMAL Protectron Electromech 12PS.1" DL GOLD P CONN HEADER FMALE Protectron Electromech 10POS.1" GOLD P CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 115

116 Appendix Item Qty. Reference Value Description Manufacturer Manufacturer Part No J8 8X2 RECP CONN HEADER FMAL Protectron Electromech 16PS.1" DL GOLD P J10 12X2 RECP CONN HEADER 2.54MM Sullins Connector 24POS GOLD Solutions SBH11-PBPC-D12-ST-BK 20 1 J11 10X2 RECP CONN HEADER 2.54MM Sullins Connector 20POS GOLD Solutions SBH11-PBPC-D10-ST-BK 21 1 J13 USB MINI B MINI USB RCPT R/A DIP TE Connectivity J14 1X1 RECP 23 1 J15 2p_jumper 24 1 J16 3p_jumper 25 1 LED LED2 Power LED Amber Status LED Green 27 1 LED3 RGB LED 28 3 L1,L2,L MHz 29 3 Q2,Q4,Q6 PMOS 30 1 Q1, PMOS 31 2 Q3,Q5 PMOS 32 1 R1 11K 1% 33 1 R2 560 ohm 34 1 R3 14.7K 1% 35 1 R4 10K 1% 36 1 R5 4.3K 1% 37 1 R6 100K R19,R26,R27,R3 6,R37,R38,R45,R 46,R47,R52,R53, R54,R55,R56 ZERO 39 2 R8,R58 15K 40 2 R9,R20 10K 1% 41 1 R10 10K 42 1 R ohm 43 2 R13,R14 ZERO CONN RCPT 1POS.100" SNGL HORZ Samtec Inc CONN HEADR BRKWAY Protectron Electromech.100 2POS STR CONN HEADR BRKWAY Protectron Electromech.100 3POS STR LED 595NM AMB DIFF 0805 Avago Technologies SMD LED GREEN CLEAR 0805 SMD Chicago Miniature LED RED/GREEN/BLUE PLCC4 SMD Cree, Inc. FERRITE CHIP 330 OHM 0805 Murata MOSFET P-CH 30V 2.2A SOT23 ON Semiconductor MOSFET P-CH 30V 3.8A SOT23-3 Diodes Inc MOSFET P-CH 20V 3.5A NXP Semiconductors SOT23 RES 11K OHM 1/10W 1% 0603 SMD Panasonic - ECG RES 560 OHM 1/8W 5% 0805 SMD Panasonic - ECG RES 14.7K OHM 1/10W 1% Panasonic - ECG 0603 SMD RES 10K OHM 1/10W 1% 0603 SMD Panasonic - ECG RES 4.3K OHM 1/10W 1% 0603 SMD Panasonic - ECG RES 100K OHM 1/10W 5% 0402 SMD Panasonic - ECG RES 0.0 OHM 1/10W 0603 SMD RES 15K OHM 1/10W 1% 0603 SMD RES 10K OHM 1/8W 1% 0805 SMD RES 10K OHM 1/10W 5% 0603 SMD RES 820 OHM 1/8W 5% 0805 SMD RES 0.0 OHM 1/8W 0805 SMD Panasonic - ECG Panasonic - ECG Stackpole Electronics Inc Panasonic - ECG Panasonic - ECG Panasonic-ECG BCS-101-L-S-HE P P HSMA-C170 CMD17-21VGC/TR8 CLV1A-FKB- CJ1M1F1BB7R4S3 BLM21PG331SN1D NTR4171PT1G DMP3098L-7 PMV48XP,215 ERJ-3EKF1102V ERJ-6GEYJ561V ERJ-3EKF1472V ERJ-3EKF1002V ERJ-3EKF4301V ERJ-2GEJ104X ERJ-3GEY0R00V ERJ-3EKF1502V RMCF0805FT10K0 ERJ-3GEYJ103V ERJ-6GEYJ821V ERJ-6GEY0R00V CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 116

117 Appendix Item Qty. Reference Value Description Manufacturer Manufacturer Part No R15,R16 22E RES 22 OHM 1/10W 1% 0603 SMD Panasonic - ECG ERJ-3EKF22R0V 45 2 R17,R18 15K RES 15K OHM 1/10W 5% 0603 SMD Panasonic - ECG ERJ-3GEYJ153V 46 5 R22,R23,R28,R3 RES 2.2K OHM 1/10W 5% 2.2K 1,R SMD Panasonic - ECG ERJ-3GEYJ222V 47 2 R24,R25 30K RES 30K OHM 1/10W 5% 0603 SMD Panasonic - ECG ERJ-3GEYJ303V 48 2 R29,R30 1.5K RES 1.5K OHM 1/10W 5% 0603 SMD Panasonic - ECG ERJ-3GEYJ152V 49 5 R39,R40,R41,R4 RES 560 OHM 1/10W 5% 560 ohm 2,R SMD Panasonic - ECG ERJ-3GEYJ561V 50 2 SW1,SW2 SW PUSH- SWITCH TACTILE SPST-NO Panasonic - ECG BUTTON 0.05A 12V EVQ-PE105K 51 1 TP5 BLACK TEST POINT PC MINI Keystone Electronics.040"D Black TVS1,TVS2 5V 350W TVS UNIDIR 350W 5V SOD- Dioded Inc. 323 SD U1 LDO IC REG LDO ADJ 1A Rohm Semiconductor TO252-5 BA00BC0WFP-E U2 PSoC 5LP 68QFN PSoC 5LP chip for Cypress Semiconductor USB debug channel and USB-Serial interface CY8C5868LTI-LP U3 F-RAM F-RAM 1-Mbit (128K X 8) Cypress Semiconductor I2C interface FM24V10-G 56 1 U4 DUAL PMOS MOSFET 2P-CH 20V 430MA ON Semiconductor SOT-563 NTZD3152PT1G Install on Bottom of PCB As per the Silk Screen in the Corners 57 4 N/A N/A Special Jumper Installation Instructions Install jumper 58 2 J15,J16 across pins 1 and 2 Label 59 1 N/A N/A 60 1 N/A N/A No load components 61 1 C ufd 62 1 C ufd 63 9 R7,R59,R32,R33, R34,R48,R49,R5 0,R R21 4.7K Zero Ohm BUMPER CYLIN 0.375" DIA BLK Rectangular Connectors MINI JUMPER GF 6.0MM CLOSE TYPE BLACK LBL, PCA Label, Vendor Code, Datecode, Serial Number Rev 04 (YYWWVVXXXXX) LBL, QR code, 12mm X 12mm CAP.1UF 16V CERAMIC Y5V 0402 CAP CERAMIC 1.0UF 25V X5R % RES 0.0 OHM 1/10W JUMP 0603 RES 4.7K OHM 1/10W 5% 0603 SMD 3M Kobiconn Cypress Semiconductor Cypress Semiconductor TDK Corporation Taiyo Yuden SJ61A E C1005X5R1A104K050BA TMK107BJ105KA-T TE Connectivity Panasonic - ECG ERJ-3GEYJ472V CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 117

118 Appendix Item Qty. Reference Value Description Manufacturer Manufacturer Part No J7,J6 50MIL KEYED CONN HEADER 10 PIN SMD 50MIL KEYED SMD Samtec FTSH L-DV-K 66 1 J9 2 PIN HDR CONN HEADER FEMALE Sullins Connector 2POS.1" GOLD Solutions PPPC021LFBN-RC 67 2 TP4,TP5 BLACK TEST POINT 43 HOLE 65 Keystone Electronics PLATED BLACK TP1,TP2,TP3 RED TEST POINT 43 HOLE 65 Keystone Electronics PLATED RED R44,R12 ZERO RES 0.0 OHM 1/8W 0805 SMD Panasonic-ECG ERJ-6GEY0R00V 70 1 J12 3x2 RECPT CONN HEADER FMAL 6PS Sullins Connector.1" DL GOLD Solutions PPPC032LFBN-RC 71 1 J5 6X1 RECP RA CONN FEMALE 6POS.100" R/A GOLD Sullins Connector Solutions PPPC061LGBN-RC A.1.2 A Module CY8CKIT-142 PSoC 4 BLE Module Item Qty. Reference Value Description Manufacturer Manufacturer Part No C1,C3,C5,C7,C9,C 11,C16,C18 C2,C4,C6,C8,C10, C12,C15,C17,C19, C uf 1.0 uf 4 1 C pf 5 1 C pf 6 1 C23 36 pf 7 1 C24 18 pf 8 1 C pf 9 1 J1 Header J2 Header 20 PSoC 4 BLE Module printed circuit board CAP.1UF 16V CERAMIC Y5V 0402 CAP CERAMIC 1.0UF 25V X5R % CAP CER 2200PF 50V 5% NP CAP CER 10000PF 50V 5% NP CAP CER 36PF 50V 5% NP CAP CER 18PF 50V 1% NP CAP CER 1.5PF 50V NP CONN HEADR FMALE 24POS.1" DL AU CONN HEADR FMALE 20POS.1" DL AU 11 1 L1 6.8nH CER INDUCTOR 6.8NH L2,L3,L U1 330 MHz PSoC 4 BL E 14 1 Y KHz 15 1 Y2 24MHz FERRITE CHIP 330 OHM QFN PSoC 4 BLE CRYSTAL KHZ 12.5PF SMD CRYSTAL MHZ 8PF SMD Cypress qualified vendor Samsung Electro- Mechanics America, Inc TDK Corporation Murata Electronics Murata Electronics Murata Electronics Murata Electronics Johanson Technology Inc Sullins Connector Sullins Connector Johanson Technology Inc Murata Electronics Cypress Semiconductor ECS Inc ECS Inc Rev03 CL05F104ZO5NNNC C1608X5R1E105K080AC GRM2165C1H222JA01D GRM2195C1H103JA01D GRM1555C1H360JA01D GRM1555C1H180FA01D 500R07S1R5BV4T SFH11-PBPC-D12-ST-BK SFH11-PBPC-D10-ST-BK L-07C6N8JV6T BLM21PG331SN1D CY8C4247LQI-BL483 ECS B ECS CKM CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 118

119 Appendix Item Qty. Reference Value Description Manufacturer Manufacturer Part No LBL - No Load components 17 1 C pf 18 1 C25 100pF 19 1 R1 Zero Ohm LBL, PCA Label, Vendor Code, Datecode, Serial Number Rev 04 (YYWWVVXXXXX) CAP CER 1.2PF 50V NP CAP CER 100PF 50V 10% X7R 0603 RES 0.0 OHM 1/10W JUMP 0603 Cypress qualified vendor Johanson Technology Inc Kemet - 500R07S1R2BV4T TE Connectivity R2 Rbleed No Load R3 4.7K 22 1 J3 4 HEADER 23 4 TP1,TP2,TP3,TP4 RED 24 1 TP5 BLACK RES 4.7K OHM 1/10W 5% 0603 SMD CONN HEADER 4POS.100 R/A 15AU TEST POINT 43 HOLE 65 PLATED RED TEST POINT 43 HOLE 65 PLATED BLACK Panasonic - ECG FCI Keystone Electronics 5000 Keystone Electronics 5001 C0603C101K5RACTU ERJ-3GEYJ472V HLF CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 119

120 Appendix A.1.3 CY5677 CySmart BLE 4.2 USB Dongle Item Qty Reference Value Description Manufacturer Mfr Part Number C1, C4, C6, C7, C9, C11, C14, C16, C25, C28, C29, C32, C35, C36, C38, C41, C42 C2, C3, C5, C8, C10, C12, C13, C15, C17,C18, C24, C26, C30, C31, C33, C34, C ufd 1.0 ufd 4 1 C pfd 5 1 C22 36 pf 6 1 C23 18 pf 7 1 C ufd 8 3 D1, D2, D3 ESD diode 9 1 F1 FUSE 10 1 J J LED LED LED3 USB A PLUG 50MIL KEYED SMD Status LED Blue Status LED Green Power LED Red BLE Dongle Printed circuit board CAP.1UF 16V CERAMIC Y5V 0402 CAP CERAMIC 1.0UF 25V X5R % CAP CER 1.2PF 50V NP CAP CER 36PF 50V 5% NP CAP CER 18PF 50V 1% NP CAP 10000PF 16V CERAMIC 0402 SMD SUPPRESSOR ESD 5VDC 0603 SMD PTC RESETTABLE.50A 15V 1812 CONN PLUG USB 4POS RT ANG PCB CONN HEADER 10POS DUAL SHRD SMD LED BLUE CLEAR THIN 0805 SMD LED GREEN CLEAR 0805 SMD LED SUPER RED CLEAR 0805 SMD 15 1 L1 5.1 nh CER INDUCTOR 5.1NH R8, R11 Zero Ohm 17 1 R7 820 ohm 18 2 R22, R ohm RES 0.0 OHM 1/8W 0805 SMD RES 820 OHM 1/10W 5% 0603 SMD RES 820 OHM 1/8W 5% 0805 SMD Cypress qualified vendor TDK Corporation Taiyo Yuden Johanson Technology Inc Murata Electronics Murata Electronics TDK Corporation Bourns Inc. Bourns Rev02 C1005X5R1A104K050BA TMK107BJ105KA-T 500R07S1R2BV4T GRM1555C1H360JA01D GRM1555C1H180FA01D C1005X7R1C103K050BA CG0603MLC-05LE MF-MSMF050-2 Molex Inc FCI LiteOn Inc Chicago Miniature LiteOn Inc Johanson Technology Inc Panasonic-ECG Panasonic - ECG Panasonic - ECG T1LF LTST-C171TBKT CMD17-21VGC/TR8 LTST-C170KRKT L-07C5N1SV6T ERJ-6GEY0R00V ERJ-3GEYJ821V ERJ-6GEYJ821V CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 120

121 Appendix Item Qty Reference Value Description Manufacturer Mfr Part Number 19 2 R9, R10 2.2K 20 9 R1, R2, R3, R4, R12, R13, R14, R15, R26 ZERO 21 2 R17, R18 22E 22 1 R21 100K 23 2 R19, R20 15K 24 2 R23, R24 30K 25 2 SW1, SW2 SW RA PUSH 26 1 TVS1 5V 350W 27 1 U U2 PRoC BLE DUAL PMOS 29 1 U3 PSoC 5LP 30 1 Y KH z 31 1 Y2 24MHz 32 1 N/A N/A No load components 33 1 C pf 34 1 C21 100pF 35 1 C ufd RES 2.2K OHM 1/10W 5% 0603 SMD RES 0.0 OHM 1/10W 0603 SMD RES 22 OHM 1/10W 1% 0603 SMD RES 100K OHM 1/10W 5% 0402 SMD RES 15K OHM 1/10W 5% 0603 SMD RES 30K OHM 1/10W 5% 0603 SMD SWITCH TACTILE SPST-NO 0.05A 12V TVS UNIDIR 350W 5V SOD- 323 PRoC BLE, 56QFN 256KB MOSFET 2P-CH 20V 430MA SOT-563 PSoC 5LP Programmable System on Chip, 68QFN CRYSTAL KHZ 12.5PF SMD CRYSTAL MHZ 8PF SMD LBL, PCA Label, Vendor Code, Datecode, Serial Number Rev 03 (YYWWV- VXXXXX); Only barcode CAP CER 1.2PF 50V NP CAP CER 100PF 50V 10% X7R 0603 CAP.1UF 16V CERAMIC Y5V 0402 Panasonic - ECG Panasonic - ECG Panasonic - ECG Panasonic - ECG Panasonic - ECG Panasonic - ECG Panasonic - ECG Diodes Inc. Cypress Semiconductor ON Semiconductor Cypress Semiconductor ECS Inc ECS Inc Cypress qualified vendor Johanson Technology Inc Kemet TDK Corporation ERJ-3GEYJ222V ERJ-3GEY0R00V ERJ-3EKF22R0V ERJ-2GEJ104X ERJ-3GEYJ153V ERJ-3GEYJ303V EVQ-P3401P SD05-7 CYBL LQXI NTZD3152PT1G CY8C5868LTI-LP039 ECS B ECS CKM - 500R07S1R2BV4T C0603C101K5RACTU C1005X5R1A104K050BA CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 121

122 Appendix Item Qty Reference Value Description Manufacturer Mfr Part Number 36 1 C ufd 37 1 R5 Zero Ohm 38 2 R6, R16 4.7K TP1, TP2, TP3, TP4, TP5, TP6, TP7, TP8, TP9, TP10, TP11, TP12, TP13, TP14, TP15 CAP CERAMIC 1.0UF 25V X5R % A.2 KitProg Status LED States RES 0.0 OHM 1/10W JUMP 0603 RES 4.7K OHM 1/10W 5% 0603 SMD Taiyo Yuden TMK107BJ105KA-T TE Connectivity Panasonic - ECG No load No load - - ERJ-3GEYJ472V User Indication Scenario Action Required by user LED blinks fast: Frequency = 4.00 Hz LED blinks slow: Frequency = 0.67 Hz LED starts blinking at power up, if bootloadable file is corrupt. Entered Bootloader mode by holding the Reset button of the BLE Pioneer Kit/BLE Dongle during kit power up. SWD operation is in progress. LED blinks very fast: Any I 2 C traffic. Frequency = 15.0 Hz Kit's COM port connect/disconnect event (one blink). LED is ON. LED is OFF. USB enumeration successful. Kit is in the idle state waiting for commands. Power LED is ON. Bootload the KitProg.cyacd file: In PSoC Programmer, connect to the kit, open the Utilities tab, and press the Upgrade Firmware button. Release the Reset button and replug power if you entered this mode by mistake. If the mode entry was intentional, bootload the new.cyacd file using the Bootloader Host tool shipped with PSoC Creator. In PSoC Programmer, watch the log window for status messages for SWD operations. In the Bridge Control Panel, the LED blinks on I 2 C command requests. In Bridge Control Panel or any other serial port terminal program, distinguish the kit's COM port number by the blinking LED when the port is connected or disconnected. The kit functions can be used by PSoC Creator, PSoC Programmer, Bridge Control Panel, and any serial port terminal program. This means that the USB enumeration was unsuccessful. This can happen if the kit is not powered from the USB host or the kit is not connected to the USB host through the USB cable. Verify the USB cable and check if PSoC Programmer is installed on the PC. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 122

123 Appendix A.3 Adding BLE Module-Compatible Headers on Your Baseboard The baseboard should have a 20-pin header and a 24-pin header. Dimension of these connectors are given here. Figure A-1. Connectors on BLE Pioneer Kit Baseboard 940 mils 740 mils Pin 1 Pin 1 20 pin header 24 pin header These headers are available for purchase from Digikey. Description CONN HEADER 2.54MM 24POS GOLD CONN HEADER 2.54MM 20POS GOLD Manufacturer Sullins Connector Solutions Sullins Connector Solutions Manufacturer Part Number Digikey Part Number SBH11-PBPC-D12-ST-BK SBH11-PBPC-D12-ST-BK- ND SBH11-PBPC-D10-ST-BK S9172-ND CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 123

124 Appendix A.4 Programming BLE Modules via MiniProg3 If the BLE Modules are to be used without the BLE Pioneer Baseboard, they can be programmed using MiniProg3. The J2 header has five adjacent pins VDDD, GND, XRES, P0[7], and P0[6]. These pins can be used to program the BLE Module using MiniProg3. Figure A-2. Programming a BLE Module via MiniProg3 Follow these steps to program the module: 1. Connect the MiniProg3 to the J2 connector, with the VDD of the MiniProg3 aligned to the VDDD on the module. 2. Click Start > All Programs > Cypress > PSoC Programmer <version> > PSoC Programmer <version>. 3. Open the desired.hex file in PSoC Programmer. 4. On the Programmer tab, set the Programming Mode to Reset. 5. Set AutoDetection to On. 6. Set Programmer Characteristics > Protocol to SWD. 7. Set Programmer Characteristics > Voltage to the desired value. 8. Click the Toggle Power icon below the menu bar to power the module. 9. Click the Program icon below the menu bar to program the module. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 124

125 Appendix A.5 BLE Modules and BLE Dongles Compatible with the BLE Pioneer Kit Different BLE modules and BLE dongles can work with the BLE Pioneer Kit, as listed in the following tables. BLE Module Availability Flash Size Bluetooth Version CY8CKIT-142 PSoC 4 BLE Module As part of the kit 128KB Bluetooth 4.1 CY8CKIT-141 PSoC 4 BLE SMA Module Available separately 128KB Bluetooth 4.1 CY8CKIT-143 PSoC 4 BLE 256KB Module Available separately 256KB Bluetooth 4.1 CY8CKIT-143A PSoC 4 BLE 256KB Module Available separately 256KB Bluetooth 4.2 BLE Dongle Availability Flash Size Bluetooth Version CY5677 CySmart BLE 4.2 USB Dongle (BLE Dongle) Available separately 256KB Bluetooth 4.2 A.5.1 CY8CKIT-142 PSoC 4 BLE Module This is the default PSoC 4 BLE Module shipped as part of the BLE Pioneer Kit (it can also be ordered separately). This module has the CY8C4247LQI-BL483 silicon, with 128KB flash and 16KB RAM. Figure A-3. CY8CKIT-142 PSoC 4 BLE Module A.5.2 CY8CKIT-141 PSoC 4 BLE SMA Module This module is identical to the default PSoC 4 BLE Module, except that it has an SMA connector instead of a wiggle antenna; this connector can be used to connect to an external antenna. This module can be ordered separately. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 125

126 Appendix Figure A-4. CY8CKIT-141 PSoC 4 BLE SMA Module A.5.3 CY8CKIT-143 PSoC 4 BLE 256KB Module This is the higher flash equivalent of the PSoC 4 BLE Module. It has the CY8C4248LQI-BL483 silicon, with 256KB flash and 32KB RAM. It can be ordered separately. Figure A-5. CY8CKIT-143 PSoC 4 BLE 256KB Module A.5.4 CY8CKIT-143A PSoC 4 BLE 256KB Module This module is similar to the CY8CKIT-143 Module, but supports Bluetooth 4.2 features and DMA. It has the CY8C4248LQI-BL583 silicon, with 256KB flash and 32KB RAM. It can be ordered separately. CY8CKIT-042-BLE Bluetooth Low Energy (BLE) Pioneer Kit Guide, Doc. # Rev. *I 126