项目简介
本项目是一系列蓝牙开发示例的集合,展示了蓝牙 RFCOMM 配置文件的使用,涵盖 Serial Port Profile(SPP)、Phonebook Client Profile、Message Access Client Profile 等示例应用。示例代码的构建和测试依赖于 'wiced_btsdk' 仓库,该仓库提供开发嵌入式蓝牙应用所需的资源和工具。
项目的主要特性和功能
- 支持 GAP、GATT、SMP、RFCOMM、SDP、AVDT/AVCT、BLE Mesh 等多种蓝牙协议。
- ROM 中包含双模式蓝牙栈(BR/EDR 和 BLE)。
- 提供 BT 栈和配置文件级别的 API 用于嵌入式蓝牙应用开发,以及访问板载外设的 API 和驱动。
- 采用 WICED HCI 协议简化主机/MCU 应用开发。
- 支持 Over-The-Air(OTA)固件升级。
- 包含 Device Configurator 用于创建自定义引脚映射,Bluetooth Configurator 用于创建 BLE GATT 数据库。
- 提供基于 Android、iOS、Windows 等平台的对等应用,用于测试和参考。
- 提供用于协议跟踪、制造测试等的实用工具。
- 提供 API、数据表、配置文件和功能的详细文档。
安装使用步骤
前提条件
假设用户已下载项目源码文件,需安装 ModusToolbox 2.1。
使用 ModusToolbox IDE
- 安装 ModusToolbox 2.1。
- 在 ModusToolbox IDE 中,点击快速面板“New Application”链接(或“File > New > ModusToolbox IDE Application”)。
- 选择 BTSDK 对应的开发板。
- 先选 'wiced_btsdk' 项目(含 SDK),在工作目录创建一次,勿改项目名。
- 创建 'wiced_btsdk' 项目后,再点击“New Application”,选开发板和应用程序。
- 在 IDE 选应用程序,在快速面板选“Build”构建应用程序。
- 对开发板编程(下载应用程序),在快速面板选“Program”。
使用命令行
- 安装 ModusToolbox 2.1。
- 在 Windows 上,用 \ModusToolbox\tools_2.1\modus-shell\Cygwin.bat 中的 Cygwin 构建应用程序。
- 复制 'wiced_btsdk' 仓库(含 SDK),在工作目录创建一次。
- 复制 BTSDK 应用仓库 [mtb-examples-(board)-btsdk-(type)],与 'wiced_btsdk' 在同一文件夹级别。
- 进入 'wiced_btsdk' 根文件夹,用 'make getlibs' 下载附属文件。
- 构建应用程序,调用 'make build'。
- 对开发板编程,调用 'make qprogram'。
- 构建并编程,调用 'make program'(make program = make build + make qprogram)。
应用设置
应用设置可通过应用程序的 makefile 配置,也可通过命令行传递。 - BT_DEVICE_ADDRESS:设置蓝牙设备地址(BDA),如 20819A10FFEE。默认 SDK 组合设备 ID 和主机 PC MAC 地址设置 BDA。 - UART:设置应用程序下载的 UART 端口,如 Windows 上 'COM6' 等。默认 SDK 自动检测端口。
下载应用程序到开发板
若下载遇问题,按以下步骤操作: 1. 按住开发板 'Recover' 按钮。 2. 按住开发板 'Reset' 按钮。 3. 释放 'Reset' 按钮。 4. 一秒后,释放 'Recover' 按钮。 此步骤仅适用于将应用程序映像下载到 FLASH 存储的开发板。仅支持 RAM 下载(DIRECT_LOAD)的开发板,如 CYW9M2BASE-43012BT,可通过电源循环从 ROM 启动。
使用 BSP(平台)
所有 BTSDK 支持的 BSP 在 \wiced_btsdk\dev-kit\bsp\ 文件夹。
选择替代 BSP
查看应用程序 makefile 的 "TARGET" 和 "SUPPORTED_TARGETS",将 TARGET 设置为支持的 BSP 之一。
自定义 BSP
- 完整 BSP:选现有 BSP 为模板复制重命名,修改 .mk 文件,在 makefile 设置 TARGET 等,按需更新 design.modus 并构建应用程序。
- 仅自定义引脚配置 - 多个应用程序:在现有 BSP 文件夹创建文件夹,复制 design.modus 文件,在 makefile 添加配置,按需更新 design.modus 并构建应用程序。
- 仅自定义引脚配置 - 每个应用程序:在应用程序创建文件夹,复制 design.modus 文件,在 makefile 添加配置,按需更新 design.modus 并构建应用程序。
使用库
在 \wiced_btsdk\dev-kit\libraries 文件夹找到支持的库。在应用程序 makefile 做以下更改: 1. 更新 "COMPONENTS" 变量包含库。 2. 更新 "SEARCH_LIBS_AND_INCLUDES" 变量指向库位置。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】