ZHCACZ5 August   2023 CC2564C

 

  1.   1
  2.   摘要
  3.   商标
  4. 1 引言
  5. 2 运行蓝牙代码
  6. 3 演示应用程序
    1. 3.1 演示应用程序上的设备 1（服务器）设置
    2. 3.2 演示应用程序上的设备 2（客户端）设置
    3. 3.3 从设备 2 启动连接
    4. 3.4 确定支持的服务
    5. 3.5 客户端和服务器之间的数据传输
    6. 3.6 多个 SPPLE 连接指南
  7. 4 使用 LightBlue 应用在 iOS 设备上演示 SPP LE
    1. 4.1 LightBlue 概述
    2. 4.2 SPP LE 服务概述
      1. 4.2.1 特性
  8. 5 LightBlue 作为客户端/SPPLEDemo 作为服务器
    1. 5.1 连接设备
    2. 5.2 启用通知
    3. 5.3 从 LightBlue 中发送数据/在 SPPLEDemo 中接收数据
    4. 5.4 从 SPPLEDemo 中发送数据/在 LightBlue 中接收数据
  9. 6 LightBlue 作为服务器/SPPLEDemo 作为客户端
    1. 6.1 连接设备
    2. 6.2 从 LightBlue 中发送数据/在 SPPLEDemo 中接收数据
    3. 6.3 从 SPPLEDemo 中发送数据/在 LightBlue 中接收数据
  10. 7 应用程序命令
  11. 8 常规命令
    1. 8.1 帮助 (DisplayHelp)
    2. 8.2 获取本地地址
    3. 8.3 设置波特率
    4. 8.4 退出
  12. 9 BR/EDR 命令
  13. 10GAPLE 命令
    1. 10.1  设置可发现性模式
    2. 10.2  设置可连接性模式
    3. 10.3  设置可配对性模式
    4. 10.4  更改配对参数
    5. 10.5  广播 LE
    6. 10.6  启动扫描
    7. 10.7  停止扫描
    8. 10.8  连接 LE
    9. 10.9  断开 LE
    10. 10.10 LE 配对
    11. 10.11 LE 通行密钥响应
    12. 10.12 LE 查询加密
    13. 10.13 设置通行密钥
    14. 10.14 发现 GAPS
    15. 10.15 获取本地名称
    16. 10.16 设置本地名称
    17. 10.17 获取远程名称
    18. 10.18 LE 用户确认响应
    19. 10.19 启用仅 SC
    20. 10.20 重新生成 P256 本地密钥
    21. 10.21 SC 生成 OOB 本地参数
    22. 10.22 设置本地外观
    23. 10.23 获取本地外观
  14. 11SPPLE 命令
    1. 11.1 发现 SPPLE
    2. 11.2 注册 SPPLE
    3. 11.3 LE 发送
    4. 11.4 配置 SPPLE
    5. 11.5 LE 读取
    6. 11.6 环回
    7. 11.7 显示原始模式数据
    8. 11.8 自动读取模式
  15. 12参考文献
  16. 13修订历史记录

10.5 广播 LE

说明

AdvertiseLE 命令负责启用 LE 广播。此命令在成功执行时返回零，而在出现任何错误时返回负值。

参数

唯一必需的参数决定是发送还是禁用广播报告。要禁用，请使用 0 作为第一个参数；要启用，请改用 1。

命令调用示例

  • “AdvertiseLE 1”尝试在本地蓝牙设备上启用低功耗广播。
  • “AdvertiseLE 0”尝试在本地蓝牙设备上禁用低功耗广播。

可能的返回值

  • (0) 成功设置可配对性模式
  • (-4) FUNCTION_ERROR
  • (-6) INVALID_PARAMETERS_ERROR
  • (-8) INVALID_STACK_ID_ERROR
  • (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
  • (-1) BTPS_ERROR_INVALID_PARAMETER
  • (-56) BTPS_ERROR_GAP_NOT_INITIALIZED
  • (-104) BTPS_ERROR_LOCAL_CONTROLLER_DOES_NOT_SUPPORT_LE
  • (-57) BTPS_ERROR_DEVICE_HCI_ERROR

API 调用

根据第一个参数值：

  • GAP_LE_Advertising_Disable(BluetoothStackID)
  • GAP_LE_Set_Advertising_Data(BluetoothStackID, (Advertisement_Data_Buffer.AdvertisingData.Advertising_Data[0] + 1), &(Advertisement_Data_Buffer.AdvertisingData))
  • GAP_LE_Set_Scan_Response_Data(BluetoothStackID, (Advertisement_Data_Buffer.ScanResponseData.Scan_Response_Data[0] + 1), &(Advertisement_Data_Buffer.ScanResponseData))
  • GAP_LE_Advertising_Enable(BluetoothStackID, TRUE, &AdvertisingParameters, &ConnectabilityParameters, GAP_LE_Event_Callback, 0)

API 原型

  • int BTPSAPI GAP_LE_Advertising_Disable(unsigned int BluetoothStackID)
  • int BTPSAPI GAP_LE_Set_Advertising_Data(unsigned int BluetoothStackID, unsigned int Length, Advertising_Data_t *Advertising_Data)
  • int BTPSAPI GAP_LE_Set_Scan_Response_Data(unsigned int BluetoothStackID, unsigned int Length, Scan_Response_Data_t *Scan_Response_Data)
  • int BTPSAPI GAP_LE_Set_Advertising_Data(unsigned int BluetoothStackID, unsigned int Length, Advertising_Data_t *Advertising_Data)
  • int BTPSAPI GAP_LE_Set_Advertising_Data(unsigned int BluetoothStackID, unsigned int Length, Advertising_Data_t *Advertising_Data)

API 说明

  • 提供的 GAP_LE_Advertising_Disable 函数使本地主机能够取消（停止）正在进行的广播过程。如果成功，此函数返回零；如果出现错误情况，则返回负的错误代码。
  • 提供的 GAP_LE_Set_Advertising_Data 使本地主机能够设置在广播过程（通过 GAP_LE_Advertising_Enable 函数启动）中使用的广播数据。如果成功，此函数返回零；如果出现错误情况，则返回负的错误代码。
  • 提供的 GAP_LE_Set_Scan_Response_Data 函数使本地主机能够设置在广播过程（通过 GAP_LE_Advertising_Enable 函数启动）中使用的广播数据。如果成功，此函数返回零；如果出现错误情况，则返回负的错误代码。
  • 提供的 GAP_LE_Set_Advertising_Data 函数使本地主机能够设置在广播过程（通过 GAP_LE_Advertising_Enable 函数启动）中使用的广播数据。如果成功，此函数返回零；如果出现错误情况，则返回负的错误代码。