%20(2).svg)
项目简介
本项目是基于蓝牙低能耗（BLE）技术的示例项目，展示了BLE协议和相关功能。项目包含Google Eddystone和Apple iBeacons实现、BLE各种服务及客户端应用等多个应用。同时提供完整的SDK和开发工具，支持多种开发板，便于开发者进行嵌入式蓝牙应用开发。
项目的主要特性和功能
- 多种BLE应用示例，涵盖信标、环境传感、心率监测、警报通知等常见场景。
- 支持多开发板，可在CYW20819A1、CYW20721B2等芯片对应的开发板上运行。
- 丰富的SDK功能，具备双模式蓝牙堆栈、BT堆栈和配置文件级API、WICED HCI协议、访问板载外设的API和驱动等。
- 多协议支持，支持GAP、GATT、SMP、RFCOMM等蓝牙协议，以及多种BLE和BR/EDR配置文件。
- 支持OTA升级，可通过空中下载进行固件升级。
- 开发工具支持，提供Device Configurator和Bluetooth Configurator等工具，方便设备和蓝牙配置。
- 多平台支持，有基于Android、iOS、Windows等平台的对等应用用于测试和参考。
安装使用步骤
准备工作
假设已下载项目源码文件，需先安装ModusToolbox 2.1。
使用ModusToolbox IDE
- 在ModusToolbox IDE中，点击“New Application”链接（或使用“File > New > ModusToolbox IDE Application”）。
- 选择BTSDK对应的开发板。
- 先选“wiced_btsdk”项目（包含SDK，所有BTSDK应用依赖此项目，在工作目录创建一次，勿改名称）。
- 创建“wiced_btsdk”项目后，再次点击“New Application”链接，选择开发板和应用。
- 在IDE中选应用，在快速面板选“Build”构建应用。
- 对开发板编程（下载应用），在快速面板选“Program”。
使用命令行
- 在Windows上，用\ModusToolbox\tools_2.1\modus-shell\Cygwin.bat构建应用。
- 复制“wiced_btsdk”仓库。
- 复制BTSDK应用仓库，与“wiced_btsdk”处于同一文件夹级别。
- 进入“wiced_btsdk”根目录，用“make getlibs”下载依赖项：
cd wiced_btsdk make getlibs - 构建应用，如：
cd ../mtb-examples-CYW920819EVB-02-btsdk-hid cd hid/ble_mouse/ make build - 对开发板编程（下载应用），使用：
make qprogram - 同时构建和编程开发板，使用：
make program注：make program = make build + make qprogram 。
应用设置
可通过应用的makefile或命令行配置，常见选项： - BT_DEVICE_ADDRESS：设置蓝牙设备地址，如20819A10FFEE。默认SDK组合7位十六进制设备ID和主机PC MAC地址最后5位十六进制数字设置BDA。 - UART：设置应用下载的UART端口，如Windows“COM6”、Linux“/dev/ttyWICED_HCI_UART0”、macOS“/dev/tty.usbserial-000154”。默认SDK自动检测端口。
下载应用到开发板
若遇问题，按以下步骤操作： 1. 按住开发板“Recover”按钮。 2. 按住开发板“Reset”按钮。 3. 释放“Reset”按钮。 4. 一秒后，释放“Recover”按钮。 注：此步骤仅适用于将应用程序映像下载到闪存存储的开发板。仅支持RAM下载（DIRECT_LOAD）的开发板，如CYW9M2BASE-43012BT，可通过电源循环从ROM启动。
使用BSP（平台）
选择替代BSP
应用makefile有默认BSP（见“TARGET”），也列出支持的其他BSP（见“SUPPORTED_TARGETS”）。选替代BSP，将TARGET设为支持的BSP之一。
创建自定义BSP
可按需创建完整自定义BSP或仅自定义引脚配置： - 完整BSP：选现有BSP为模板，复制重命名，修改mk文件，在应用makefile中设置TARGET和相关参数，必要时用Device Configurator更新design.modus文件。 - 仅自定义引脚配置 - 多应用：在现有BSP文件夹中创建新文件夹，复制design.modus文件，在应用makefile中添加相关配置，必要时用Device Configurator更新design.modus文件。 - 仅自定义引脚配置 - 单应用：在应用中创建新文件夹，复制design.modus文件，在应用makefile中添加相关配置，必要时用Device Configurator更新design.modus文件。
使用库
在应用中使用库，需对应用makefile做以下更改：
1. 更新makefile变量“COMPONENTS”包含库，如：
COMPONENTS += fw_upgrade_lib
2. 更新makefile变量“SEARCH_LIBS_AND_INCLUDES”指向库位置，如：
SEARCH_LIBS_AND_INCLUDES+=$(CY_SHARED_PATH)/dev-kit/libraries/btsdk-ota
文档查看
BTSDK技术简报和发行说明可在线查看。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】