项目简介
本项目是一个展示 BLE 协议和功能的应用集合,提供了信标、传感器与客户端通信、环境传感、警报通知、电池服务、心率监测等多种不同类型的 BLE 应用示例。项目包含构建和测试嵌入式蓝牙应用所需的 SDK 代码,可借助 ModusToolbox IDE 或命令行完成代码的构建、烧录等操作。
项目的主要特性和功能
- 丰富的 BLE 应用示例,涵盖 Google Eddystone 和 Apple iBeacons 实现、Vendor Specific Service 和 Client、Environmental Sensing Service 等多种应用场景。
- 双模式蓝牙栈,ROM 中包含双模式蓝牙栈(BR/EDR 和 BLE),支持 GAP、GATT、SMP 等多种蓝牙协议。
- 便捷的开发工具,提供 Device Configurator 用于创建自定义引脚映射,Bluetooth Configurator 用于创建和配置 BLE GATT 数据库和 BR/EDR SDP 记录。
- 多平台支持,支持 CYW20819A1、CYW20721B2 等芯片对应的开发板。
- 支持 Over - The - Air(OTA)固件升级功能。
- 提供丰富的 API 和驱动,包括 BT 栈和配置文件级别的 API 用于嵌入式 BT 应用开发,以及访问板载外设的 API 和驱动。
- 有基于 Android、iOS、Windows 等系统的对等应用,可用于测试和参考。
安装使用步骤
前提条件
假设用户已经下载了本项目的源码文件,且具备 ModusToolbox 2.1 开发环境。
使用 ModusToolbox IDE
- 打开 ModusToolbox IDE,在 Quick Panel 中点击 New Application 链接(或使用 File > New > ModusToolbox IDE Application)。
- 选择用于 BTSDK 的开发板。
- 先选择 'wiced_btsdk' 项目,此项目包含 SDK,所有 BTSDK 应用都会使用,只需在工作目录(Eclipse 工作区)创建一次,注意不要更改项目名称。
- 'wiced_btsdk' 项目创建完成后,再次点击 New Application 链接,选择要使用的开发板和应用。
- 在 IDE 中选中应用,在 Quick Panel 中选择 Build 来构建应用。
- 若要将应用烧录到开发板,在 Quick Panel 中选择 Program。
使用命令行
- 在 Windows 系统中,通过 \ModusToolbox\tools_2.1\modus - shell\Cygwin.bat 打开 Cygwin 来构建应用。
- 使用
git clone
命令复制 'wiced_btsdk' 仓库,该项目包含所有应用使用的 SDK,只需在工作目录创建一次。 - 使用
git clone
命令复制 BTSDK 应用仓库 [mtb - examples - (board) - btsdk - (type)],应用仓库目录应与 'wiced_btsdk' 处于同一文件夹层级。 - 进入 'wiced_btsdk' 根文件夹,使用
make getlibs
下载所有所需的依赖项,例如:bash cd wiced_btsdk make getlibs
- 构建应用,例如:
bash cd../mtb - examples - CYW920819EVB - 02 - btsdk - hid cd hid/ble_mouse/ make build
- 烧录应用到开发板,可使用以下命令:
bash make qprogram
- 若要同时完成构建和烧录,可使用:
bash make program
应用设置
可通过应用的 makefile 或命令行配置应用设置,如设置蓝牙设备地址(BT_DEVICE_ADDRESS)、UART 端口(UART)、启用调试(ENABLE_DEBUG)等。
下载应用到开发板
若下载应用到开发板时遇到问题,可按以下步骤操作: 1. 按住开发板上的 'Recover' 按钮。 2. 按住开发板上的 'Reset' 按钮。 3. 释放 'Reset' 按钮。 4. 一秒后,释放 'Recover' 按钮。
注意:此方法仅适用于将应用镜像下载到 FLASH 存储的开发板,仅支持 RAM 下载(DIRECT_LOAD)的开发板(如 CYW9M2BASE - 43012BT)可通过电源循环从 ROM 启动。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】