Cypress CYW920735Q60EVB-01 User Manual

Associated Part Family: CYW20735
Doc. No.: 002-23764 Rev. **
Cypress Semiconductor
198 Champion Court
San Jose, CA 95134-1709
www.cypress.com
CYW920735Q60EVB-01 Evaluation Kit User Guide Doc. No.: 002-23764 Rev. ** 2
Contents
Safety Information ............................................................................................................................................................... 4
General Safety Instructions .......................................................................................................................................... 4
ESD Protection ................................................................................................................................................... 4
Handling Boards ................................................................................................................................................. 4
1 Introduction ................................................................................................................................................................. 5
1.1 CYW920735Q60EVB-01 EVB Contents ............................................................................................................. 5
1.2 CYW920735Q60EVB-01 Board Details .............................................................................................................. 6
1.3 WICED Studio Development System ................................................................................................................. 6
1.4 Getting Started ................................................................................................................................................... 7
1.5 IOT Resources and Technical Support ............................................................................................................... 7
1.6 Additional Learning Resources ........................................................................................................................... 7
1.7 Document Conventions ...................................................................................................................................... 7
1.8 Acronyms ........................................................................................................................................................... 8
2 WICED Studio ........................................................................................................................................................... 10
2.1 Before You Begin ............................................................................................................................................. 10
2.2 WICED Studio Overview .................................................................................................................................. 10
2.3 Hardware and Software Requirements ............................................................................................................. 10
2.4 Development Process ...................................................................................................................................... 10
2.5 Setting up WICED Studio ................................................................................................................................. 10
2.5.1 Install WICED Studio ........................................................................................................................... 11
2.5.1.1 Windows ................................................................................................................................ 11
2.5.1.2 Linux ...................................................................................................................................... 11
2.5.1.3 Mac OS X .............................................................................................................................. 11
2.5.2 Connect the WICED Evaluation Board ................................................................................................ 12
2.5.3 Verify Driver Installation ....................................................................................................................... 13
2.5.3.1 Windows ................................................................................................................................ 13
2.5.3.2 Linux ...................................................................................................................................... 13
2.5.3.3 Mac OS X .............................................................................................................................. 13
2.6 Using the WICED Studio IDE ........................................................................................................................... 14
2.6.1 WICED Studio IDE UI .......................................................................................................................... 14
2.6.2 WICED Studio SDK Directory Structure .............................................................................................. 15
2.6.3 WICED Studio Code Examples ........................................................................................................... 15
2.6.4 Build and Load a Sample Application .................................................................................................. 16
2.6.5 Hello Client Peer Application ............................................................................................................... 18
2.6.6 Testing the Hello Sensor Application ................................................................................................... 19
2.6.6.1 Hello Sensor Application Structure ........................................................................................ 19
2.6.6.2 Hello Sensor Application Test Procedure .............................................................................. 19
2.6.6.2.1 Hello Input Characteristic ..................................................................................................... 19
2.6.6.2.2 Hello Configuration Characteristic ....................................................................................... 20
2.6.7 Viewing Application Trace Messages .................................................................................................. 20
2.6.7.1 Routing Trace Messages....................................................................................................... 20
2.6.7.2 View Traces Using a Terminal Emulation Program ............................................................... 21
2.6.7.3 View Traces Using the BTSpy Windows Application ............................................................. 21
3 Kit Operation ............................................................................................................................................................. 23
3.1 Theory of Operation .......................................................................................................................................... 23
3.2 Jumpers ............................................................................................................................................................ 28
3.3 Buttons and Switches ....................................................................................................................................... 30
3.4 Arduino-Compatible Headers ........................................................................................................................... 31
Contents
CYW920735Q60EVB-01 Evaluation Kit User Guide Doc. No.: 002-23764 Rev. ** 3
3.5 Other Headers .................................................................................................................................................. 33
3.6 USB Serial Interface Chip ................................................................................................................................. 34
3.7 Kit Power Supply .............................................................................................................................................. 34
3.8 Test Points........................................................................................................................................................ 34
3.9 Current Measurement ....................................................................................................................................... 35
3.10 SWD Debugging ............................................................................................................................................... 35
3.11 Pin Configuration .............................................................................................................................................. 35
4 Code Examples ......................................................................................................................................................... 36
4.1 Thermostat ....................................................................................................................................................... 36
4.1.1 Project Description ............................................................................................................................... 36
4.1.2 Hardware Connections ........................................................................................................................ 36
4.1.3 Flow Chart ........................................................................................................................................... 37
4.1.4 Verify Output ........................................................................................................................................ 38
5 Hardware ................................................................................................................................................................... 39
5.1 Carrier Module .................................................................................................................................................. 39
5.1.1 CYW20735 .......................................................................................................................................... 39
5.1.2 Antenna ............................................................................................................................................... 39
5.1.3 Crystal ................................................................................................................................................. 39
5.1.4 External Serial Flash ............................................................................................................................ 39
5.2 Base Board ....................................................................................................................................................... 40
5.3 Serial Communication between CYW20735 and FTDI USB-Serial Device ...................................................... 40
5.4 Power ............................................................................................................................................................... 40
5.5 RESET ............................................................................................................................................................. 44
5.6 Thermistor ........................................................................................................................................................ 45
5.7 Motion Sensor .................................................................................................................................................. 45
5.8 LED .................................................................................................................................................................. 46
5.9 Analog Mic ........................................................................................................................................................ 46
5.10 Push Buttons .................................................................................................................................................... 47
Appendix A. CYW20735 Device IO Mapping ......................................................................................................... 48
Document Revision History ............................................................................................................................................. 51
CYW920735Q60EVB-01 Evaluation Kit User Guide Doc. No.: 002-23764 Rev. ** 4
Safety Information
The CYW920735Q60EVB-01 Evaluation Board (EVB) 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. Due to this reason, the board may cause interference to other electrical or electronic devices in close proximity. In a domestic environment, this product may cause radio interference. In such cases, take adequate preventive measures. Also, do not use this board near any medical equipment or RF devices.
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 must be taken.
CYW920735Q60EVB-01 contains electrostatic discharge (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 CYW920735Q60EVB-01 in the protective shipping package.
End-of-Life/Product Recycling This kit has an end-of-life cycle of five years from the year of manufacturing mentioned on the back
of the box. Contact your nearest recycler for discarding the kit.
General Safety Instructions
ESD Protection
ESD can damage boards and associated components. Cypress recommends that you 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
CYW920735Q60EVB-01 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. Any physical action on CYW920735Q60EVB-01 such as changing wires, jumper settings, or measuring voltages can cause stress on the CYW920735Q60EVB-01 printed circuit board assembly (PCBA). You must ensure that the PCBA has proper support on the bottom side to avoid stress on the PCBA when the EVB is in operation.
CYW920735Q60EVB-01 Evaluation Kit User Guide Doc. No.: 002-23764 Rev. ** 5
1 Introduction
Thank you for your interest in the CYW920735Q60EVB-01 Evaluation Board (EVB). The CYW920735Q60EVB-01 EVB enables customers to evaluate and develop single-chip Bluetooth and Bluetooth Low Energy (BLE) applications using the CYW20735B1, dual-mode Bluetooth 5.0 (BLE and BR) wireless MCU.
The CYW920735Q60EVB-01 EVB can be used with WICED Studio to develop and debug your CYW20735 project. The CYW920735Q60EVB-01 EVB offers footprint-compatibility with Arduino shields. In addition, the kit features an onboard programmer and USB-UART chip. The CYW920735Q60EVB-01 EVB supports 1.8 V and 3.3 V operation.
The CYW920735Q60EVB-01 EVB and CYW20735B1 device are supported in WICED Studio. The development system is compatible with Windows, OS X, and Linux operating systems. This document provides instructions for developing sample applications using WICED Studio.
Note: This document applies to WICED Studio 6.2 (or later). The CYW920735Q60EVB-01 EVB is available through the Cypress Online Store or through our distributors.
1.1 CYW920735Q60EVB-01 EVB Contents
The CYW920735Q60EVB-01 EVB includes the following:
One CYW920735Q60EVB-01 evaluation board One USB 2.0 Type-A to Micro-B cable One Quick Start Guide
Figure 1-1. CYW920735Q60EVB-01 Kit Contents
Inspect the kit contents. If you find any part missing, contact your nearest Cypress sales office for assistance:
www.cypress.com/support.
Introduction
CYW920735Q60EVB-01 Evaluation Kit User Guide Doc. No.: 002-23764 Rev. ** 6
1.2 CYW920735Q60EVB-01 Board Details
Figure 1-2 shows CYW920735Q60EVB-01 with the following features:
1. CYW20735B1-based carrier board with onboard antenna
2. Expansion headers that are compatible with Arduino shields
3. Support for 1.8 V and 3.3 V operation of the CYW20735 device
4. Two user-controlled LEDs, one push button, one recovery button, and one reset button
5. Onboard micro-USB connector for programming and debug purposes
Figure 1-2. CYW920735Q60EVB-01 Evaluation Board
1.3 WICED Studio Development System
The WICED Studio Development System comprises a software development kit (SDK) along with the Eclipse integrated development environment (IDE) to enable development of projects with WICED evaluation boards.
The CYW920735Q60EVB-01 board and WICED Studio can be used for feature evaluation, debugging, and developing Bluetooth applications based on the CYW20735 device.
WICED Studio includes libraries and code examples which can speed up the design and development of user applications. For detailed information on WICED Studio installation and usage, see Setting up WICED Studio.
Introduction
CYW920735Q60EVB-01 Evaluation Kit User Guide Doc. No.: 002-23764 Rev. ** 7
1.4 Getting Started
This user guide will provide additional details of the CYW920735Q60EVB-01 EVB: The WICED Studio chapter describes the installation and usage of the kit software. This includes WICED Studio to
develop and debug the applications, Hello Client Peer application to test the hello_sensor application and BTSpy to view trace messages.
The Kit Operation chapter describes the operation of the kit and how to use its various features. The Code Examples chapter describes code examples that will help you understand how to use an example with the
kit.
The Hardware chapter describes the design details of the CYW920735Q60EVB-01 EVB hardware blocks.
1.5 IOT Resources and Technical Support
Cypress provides a wealth of wireless product documentation at www.cypress.com/products/wireless-connectivity to help you to select the right IoT device for your design. In addition, a professional community at
community.cypress.com/community/wireless supplies developers the latest software and tools to solve common evaluation
and integration problems while interacting directly with both Cypress applications engineers and experienced peers.
1.6 Additional Learning Resources
Visit the http://www.cypress.com/documentation/development-kitsboards/cyw920735q60evb-01-evaluation-kit webpage for additional learning resources including datasheets and application notes.
1.7 Document Conventions
Convention
Usage
Courier New
Displays source code examples.
Consolas
API and function names (when mentioned within body text) The WICED_BT_TRACE() macro can be used to generate printf-style messages from the
application code.
Italics
Displays file names, file locations, and reference documentation:
C:\ ...cd\icc\
File > Open
Represents menu paths:
File > Open > New Project
Bold
Displays commands, menu paths, and icon names in procedures: Click the File icon and then click Open.
Times New Roman
Displays an equation: 2 + 2 = 4
Text in gray boxes
Describes Cautions or unique functionality of the product.
Table 1-1. Document Conventions for Guides
Introduction
CYW920735Q60EVB-01 Evaluation Kit User Guide Doc. No.: 002-23764 Rev. ** 8
1.8 Acronyms
Acronym
Definition
ADC
Analog to Digital Converter
API
Application Programming Interface
BR
Basic Rate
BT / BLE
Bluetooth / Bluetooth Low Energy
EEPROM
Electrically Erasable Programmable Read-Only Memory
EM
Electro-magnetic
ESS
Environment Sensing Service
EVB
Evaluation Board
GAP
Generic Access Profile
GATT
Generic Attribute Profile
GPIO
General Purpose Input Output
HAL
Hardware Abstraction Layer
HCI
Host Controller Interface
I2C
Inter-Integrated Circuit
IDE
Integrated Development Environment
JRE
Java Runtime Environment
JTAG
Joint Test Action Group
LE
Low Energy
LED
Light Emitting Diode
LHL
Lean High Land
LPO
Low Power Oscillator
MEMS
Micro Electro-Mechanical System
NTC
Negative Temperature Coefficient
PCB
Printed Circuit Board
PUART
Peripheral UART
PWM
Pulse Width Modulation
RF
Radio Frequency
SDK
Software Development Kit
SIG
Special Interest Group
SoC
System-On-Chip
SPI
Serial Peripheral Interface
SWD
Serial Wire Debug
UART
Universal Asynchronous Receiver/Transmitter
USB
Universal Serial Bus
Introduction
CYW920735Q60EVB-01 Evaluation Kit User Guide Doc. No.: 002-23764 Rev. ** 9
Acronym
Definition
VDD
Voltage Drain Drain
WICED
Wireless Internet Connectivity for Embedded Devices
XTAL
Crystal Oscillator
Table 1-2. List of Acronyms used in this Document
CYW920735Q60EVB-01 Evaluation Kit User Guide Doc. No.: 002-23764 Rev. ** 10
2 WICED Studio
This section provides detailed instructions to set up the Cypress Wireless Internet Connectivity for Embedded Devices (WICED; pronounced wick-ed) CYW920735Q60EVB-01 evaluation board for use with the Cypress WICED Studio Development System for Bluetooth Classic (aka BR - Basic Rate) and Low Energy (LE) devices.
WICED Studio supports application development using a WICED device such as the CYW20735 provided on the CYW920735Q60EVB-01 kit. The development system is compatible with Windows, Mac OS X, and Linux operating systems. This section describes the software components included in WICED Studio and provides instructions for compiling WICED sample applications using WICED Studio.
This document applies to WICED Studio 6.2 and WICED Bluetooth CYW20735 devices.
2.1 Before You Begin
All Cypress software installations require administrator privileges. Make sure that 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 WICED Studio Overview
WICED Studio includes the following:
Generic profile-level and BT stack level APIs (WICED BT API) Sample applications that demonstrate the use of the API Drivers to access on-chip peripherals using WICED HAL APIs (for example, UART, SPI, I2C, ADC, PWM) WICED BT API documentation Utilities to support development, testing, and mass production on Windows, Mac OS X, and Linux environments
2.3 Hardware and Software Requirements
WICED Studio runs on 32- and 64-bit versions of Microsoft Windows, and 64-bit versions of Mac OS X and Linux. The development computer requires a single USB port to connect to the WICED evaluation board.
2.4 Development Process
WICED Studio is distributed as executable installers for Windows, Mac OS X, and Linux. Follow these steps to prepare and run an application:
Download and install WICED Studio (see Install WICED Studio). Connect the WICED evaluation board (see Connect the WICED Evaluation Board). Create and load an application (see Build and Load a Sample Application).
2.5 Setting up WICED Studio
Download WICED Studio from WICED Software page. For more details, please visit Cypress WICED Products website or
Cypress Customer Support Portal.
The WICED Studio distribution is provided as a self-installing executable file inside a zip file. Extract the file to a folder on the local hard drive; do not execute the installer from the zip file. Some customized distributions may also provide a configuration file called config.eml, which should be placed in the same folder prior to running the installer.
WICED Studio
CYW920735Q60EVB-01 Evaluation Kit User Guide Doc. No.: 002-23764 Rev. ** 11
2.5.1 Install WICED Studio
Note: "x.x.x.x" used in the filenames denotes the WICED Studio version numbers in actual files.
2.5.1.1 Windows
1. Unzip the distribution to a local folder, along with the config.eml file, if present.
2. Double-click the WICED-Studio-x.x.x.x-IDE-Installer.exe file.
3. Follow the prompts to override or accept the default folders for the Eclipse IDE and WICED Studio SDK files.
2.5.1.2 Linux
1. Unzip the distribution to a local folder, along with the config.eml file, if present.
2. Open a terminal window and change directory (cd) to the same folder.
3. Apply execute permissions to the installer executable with the following command:
chmod +x ./WICED-Studio-x.x.x.x-IDE-Installer.bin
4. Launch the installer from the same terminal window:
./WICED-Studio-x.x.x.x-IDE-Installer.bin
5. Follow the prompts to override or accept the default folders for the Eclipse IDE and WICED Studio SDK files. If there is a conflict between a pre-existing Java version installed on the system and the Java JRE supplied with the WICED
Studio installer, the following error may be encountered during the Linux installation process: “Installer User Interface Mode Not Supported”
To resolve, use the package manager for your Linux distribution (for example, dnf, apt-get, yum) to update Java to the latest version. For example:
sudo dnf install java
2.5.1.3 Mac OS X
1. Unzip the distribution to a local folder.
2. If there is a config.eml file with the distribution, use Finder to copy the file and the WICED-Studio-x.x.x.x-IDE-Installer app folder to another folder. This is needed as a workaround for a known OSX 10.12 install issue.
3. Double-click the WICED-Studio-x.x.x.x-IDE-Installer app.
4. Follow the prompts to override or accept the default folders for the Eclipse IDE and WICED Studio SDK files.
If the installer fails to execute, you may need to install or update Java to resolve any potential conflict between a pre-existing Java version installed on the system and the Java JRE supplied with the WICED Studio installer.
Open xterm, run the java -version command. If it fails to return any results or states that you are running version 1.6, then you need to install the Java SE Development Kit 8 (JDK8), which can be found here. Once JDK8 is installed, run the java ­version command again with xterm. If this command returns 1.6, then you will need to fix the symbolic link using the following commands:
rm -f /usr/bin/java
ln -s /System/Library/Frameworks/JavaVM.framework/Versions/Current/Commands/java
/usr/bin/java
WICED Studio
CYW920735Q60EVB-01 Evaluation Kit User Guide Doc. No.: 002-23764 Rev. ** 12
2.5.2 Connect the WICED Evaluation Board
Figure 2-1 shows the CYW920735Q60EVB-01 WICED evaluation board.
Figure 2-1. CYW920735Q60EVB-01 Evaluation Board
The Micro-USB connector (J6) supports UART connections and provides +5 V power to the board. Follow these steps before connecting the board and verifying the driver installation:
1. Verify that all the jumpers are in default configuration as shown in Table 3-1 to Table 3-6, so that the Peripheral UART is selected and can display embedded application trace messages. The picture above shows the default jumper locations.
2. Connect J6 of the WICED evaluation board to the development PC with a USB cable. The USB UART driver should load automatically.
See Jumpers and Buttons and Switches for complete information on DIP switches and jumper settings. The LEDs labelled on the board serve the following purposes:
D6 (Green) indicates that VDD3P3 (3.3 V) power is ON D7 (variable color) indicates HCI UART activity D11 (variable color) indicates peripheral UART activity D1 (Yellow) and D2 (Red) are generic user LEDs controlled by GPIOs
WICED Studio
CYW920735Q60EVB-01 Evaluation Kit User Guide Doc. No.: 002-23764 Rev. ** 13
2.5.3 Verify Driver Installation
2.5.3.1 Windows
1. Open the Device Manager (right-click My Computer, select Properties, and then select Device Manager).
2. In the Device Manager window, verify that two new USB serial COM ports are listed under Ports (COM & LPT).
Note: In Figure 2-2, the Device Manager identifies the new WICED evaluation board USB serial COM ports as WICED HCI UART and WICED Peripheral UART. Assigned port numbers vary among systems.
Figure 2-2. Device Manager COM Ports
Note: If an error occurs during driver installation, download new drivers from Windows Update. Verify that you have an Internet connection, disconnect and reconnect the board, and wait for the drivers to automatically install.
If new COM ports for the WICED board do not appear in the Device Manager after the drivers are installed via Windows Update, manually install the drivers from the Drivers\Windows\wiced_uart folder of the WICED Studio installation. Double­click the installer DPInst.ext for 32-bit Windows and DPInst_x64.exe for 64-bit Windows. Alternately, you can run the driver installers from inside WICED Studio; right-click the driver file name and select Open With > System Editor.
If the error persists, check all jumper settings (see Jumpers) on the board and replace the USB cable.
2.5.3.2 Linux
Open a terminal window and verify that two UART ports are listed, usually /dev/ttyWICED_HCI_UART0 and /dev/ttyWICED_PUART1, although numbers may vary.
Note: An additional step may be required when connecting a WICED board to a computer running Linux. On common Linux distributions, the serial UART ports (such as /dev/ttySx or /dev/ttyUSBx devices, including the /dev/ttyWICED_xxx devices installed by WICED Studio) belong to the root user and to the dialout group. Standard users are not allowed to access these devices.
An easy way to allow the current user access to Linux's serial ports is by adding the user to the dialout group. You can do this using the following command:
$sudo usermod -a -G dialout $USER
Note: For this command to take effect, you must log out and log in again.
2.5.3.3 Mac OS X
Open an xterm window and verify that two UART ports are listed, usually /dev/tty.usbserial-144A and /dev/tty.usbserial­144B, although numbers may vary. The lower-numbered port is WICED HCI UART, the higher-numbered port is WICED Peripheral UART.
Note: On OS X versions 10.10 or earlier, the Apple version of the FTDI driver that ships with the OS has known issues. Follow the instructions here and update to a specific version.
WICED Studio
CYW920735Q60EVB-01 Evaluation Kit User Guide Doc. No.: 002-23764 Rev. ** 14
On OS X versions 10.11 and later, use the Apple version of the FTDI driver. Remove previous instance of the FTDI version of the driver, if any, using the following commands in an xterm window:
sudo rm -rf /Library/Extensions/FTDIUSBSerialDriver.kext
sudo rm -rf /System/Library/Extensions/FTDIUSBSerialDriver.kext
Reboot the system after performing the rm commands.
2.6 Using the WICED Studio IDE
This section describes how to use the WICED Studio IDE to create application build targets for the WICED evaluation board and how to download applications to the board.
2.6.1 WICED Studio IDE UI
Double-click the WICED Studio icon on the desktop to start the IDE. Some WICED Studio packages may offer support for multiple devices, and on first-time execution of the IDE, you might be prompted to select the default platform. If prompted, select 20735-B1_Bluetooth. You can change the default platform later from the WICED Target Selector drop-down list in the IDE.
Figure 2-3 shows the WICED Studio UI, illustrating the following functionality available through the IDE:
1. Project Explorer Window - Explore existing applications/firmware and libraries of the SDK.
2. Text Editor Window - Edit your application firmware.
3. Make Target Window - Create and edit Make Targets for the platform to build your application or project.
4. Console Window - View Build messages in the Console window.
5. Help Window - Access Help that contains instructions on building and downloading applications.
Figure 2-3. WICED Studio IDE
WICED Studio
CYW920735Q60EVB-01 Evaluation Kit User Guide Doc. No.: 002-23764 Rev. ** 15
2.6.2 WICED Studio SDK Directory Structure
Table 2-1 lists the directory structure of WICED Studio for the CYW20735 device. WICED Studio may support multiple types
of WICED modules depending on the installed components; some modules may share components, files, and folders. Note: The folder structure presented in the WICED Studio Project Explorer UI window may differ slightly from the directory
structure of the files installed on the file system, as some components may be shared between multiple components in common folders on the file system. It is recommended that WICED Studio be used for accessing files and folders rather than directly through the file system. In case of any discrepancies between the structure presented in WICED Studio and the file system, right-click the component in WICED Studio and select Properties to view the location of the component in the file system. For example, the ARM_GNU toolchain resides under the 43xxx_Wi-Fi folder in the filesystem structure, but as used for the CYW20735 device, the ARM_GNU folder appears in the wiced_tools folder in the WICED Studio Project Explorer UI folder tree.
WICED Studio Project Explorer Directory
Directory Contents
20735-B1_Bluetooth\doc
Reference documentation
20735-B1_Bluetooth\Drivers
USB drivers for the evaluation board
20735-B1_Bluetooth\wiced_tools
Tools including programming tool, and other utilities and scripts
20735-B1_Bluetooth\wiced_tools\ARM_GNU
Toolchain including compiler, linker, and supporting files (libraries and headers)
20735-B1_Bluetooth\apps
Sample applications and the location where your applications will reside.
20735-B1_Bluetooth\build
Output files of built applications (will not be present until a build is performed)
20735-B1_Bluetooth\include
WICED API function prototypes and definitions
20735-B1_Bluetooth\libraries
Sources for various WICED interface libraries
20735-B1_Bluetooth\platforms
Configuration files and information for supported hardware platforms
20735-B1_Bluetooth\test
Tools provided for automation testing
20735-B1_Bluetooth\tools
Common utilities used by the IDE build processes
20735-B1_Bluetooth\WICED
WICED core components
Table 2-1. WICED Studio SDK Directory Structure
2.6.3 WICED Studio Code Examples
Application examples can speed up the design process by serving as templates for development. Code examples are located under the apps Folder (in the Project Explorer window), as shown in Figure 2-4.
The demo directory contains applications that combine various WICED features into a single application. The snip directory contains application snippets that demonstrate how to use various WICED libraries and API functions. The host directory contains applications that demonstrate WICED BT API usage for host MCU apps. Located within each subdirectory in the apps folder is a README.txt that lists and summarizes the applications located within the folder:
WICED Studio
CYW920735Q60EVB-01 Evaluation Kit User Guide Doc. No.: 002-23764 Rev. ** 16
Figure 2-4. Code Examples under apps Folder
For more details on the WICED software stack and APIs, see the documents available in the doc folder in the Project Explorer pane of WICED Studio. The API.html file contains API documentation, and it is recommended that you open the file using the default system web browser. Right-click API.html and select Open With > System Editor.
2.6.4 Build and Load a Sample Application
The Help pane in the lower-right corner of the IDE (see Figure 2-3) describes how to build and download the sample applications shown in the Make Target pane, which is located above the Help pane. The Help pane also describes how to create new applications and associated make targets based on the samples. The Make Target pane contains make targets that are preconfigured for sample applications that run on CYW920735Q60EVB-01 evaluation boards.
The hello_sensor sample demonstrates basic LE sensor functionality. The source file hello_sensor.c contains information on how to exercise the application with the Hello Client host peer application. You can find the source code for the hello_sensor sample and Hello Client host peer application in WICED Studio in the Project Explorer pane under 20735- B1_Bluetooth\apps\demo\hello_sensor. This example shows how to build and run the hello_sensor sample application on the CYW20735:
1. Connect the evaluation board to the PC.
2. Verify that the UART port is present after the WICED evaluation board is connected to the PC (see Verify Driver
Installation).
3. In the WICED Studio Make Target pane, find the make target demo.hello_sensor-CYW920735Q60EVB_01 download in the list. Double-click the Make Target to execute it. The IDE console pane (bottom center of the IDE window) will display the build and download progress.
The build output should look similar to the following:
Loading...
+ 37 hidden pages