1、文档简介
本文档介绍了
XR806 SDK的BLE命令的用法及使用示例，以帮助
用户使用BLE命令快速上手BLE功能开发。
2、概述
2.1 背景说明
为了便于BLE功能的测试、开发，XR806 SDK集成了 Zephyr 项目的
Bluetooth 命令。SDK 中的 BLE 命令 主要封装在 cmd_ble.c、cmd_gatt.c 文件中，覆盖了 BLE 常用的功能场景。
2.2 规格特性
XR806 SDK的Bluetooth命令支持扫描、广播、连接、配对绑定等常用场景的命令功能，具体命令的使 用请参考“命令说明”小节。
2.3 文件位置
以SDK包为根目录，BLE命令涉及到的主要文件位置如下。
BLE 命令：
文件分类及位置：
源码文件 ./project/common/cmd/cmd_ble.c
源码文件 ./project/common/cmd/cmd_gatt.c
示例工程 ./project/demo/bluetooth/ble_demo/
3、应用说明
3.1 应用简述
BLE 命令已经集成到 XR806 SDK，下面将对 BLE 命令的使用进行介绍。
3.2 配置说明
使用 BLE 命令功能需要先将工程配置中的 BLE 功能项打开。
BLE 功能使能：
设置说明： 此项配置用于在 SDK 中启用 BLE 功能。
设置方式： 在控制台执行命令“
MAKE menuconfig”，将以下功能项打开：
BLE Controller Ble Host 建议参考 ble_demo 的工程配置 defconfig。
3.3 格式说明
BLE 命令的语法约定如下
= 参数引导符
, 参数分隔符
<> 强制使用
[] 选择使用
3.4 命令说明
BLE 命令提供了扫描、广播、链路管理等命令，命令的简要说明如下表所示。
通用配置命令：主要包含了 init、deinit 两个命令，使用 BLE 命令必须先执行 init 命令进行 BLE 初始化。
设备管理命令：主要对 BLE 的设备名称、地址等进行配置。
扫描命令：提供 BLE 扫描功能，包括主动和被动扫描。
广播命令：提供 BLE 广播功能。
链路管理命令：提供了链路连接、更新等功能。
HCI 命令：提供组装 HCI 命令功能。
安全相关命令：提供配对绑定等功能。
3.4.1 通用配置命令
3.4.1.1 init（BLE模块初始化）
原型：ble init
功能：BLE 模块初始化
参数：N/A
响应：<ACK> 200 OK
示例：N/A
备注：若系统启动后没有进行 BLE 初始化，执行其他 BLE 命令前都需要先执行该初始化命令。
更多详细内容请下载附件查看
已绑定手机
发表于 2022-5-31 10:10
