ZHCACY9 August   2023 CC2564C

 

  1.   1
  2.   摘要
  3.   商标
  4. 1演示概述
  5. 2运行蓝牙代码
  6. 3演示应用程序
    1. 3.1 演示应用中的设备 1（主机/HID 主机）设置
    2. 3.2 演示应用上的设备 2（客户端/HID 设备）设置
    3. 3.3 从 HID 主机发起连接
    4. 3.4 从 HID 设备发起连接
    5. 3.5 主机与设备之间的通信
  7. 4应用程序命令
  8. 5Gap 命令
    1. 5.1  帮助 (DisplayHelp)
    2. 5.2  查询
    3. 5.3  显示查询列表
    4. 5.4  配对
    5. 5.5  结束配对
    6. 5.6  PIN 码响应
    7. 5.7  通行密钥响应
    8. 5.8  用户确认响应
    9. 5.9  设置可发现性模式
    10. 5.10 设置可连接性模式
    11. 5.11 设置可配对性模式
    12. 5.12 更改简易配对参数
    13. 5.13 获取本地地址
    14. 5.14 设置本地名称
    15. 5.15 获取本地名称
    16. 5.16 设置设备类别
    17. 5.17 获取设备类别
    18. 5.18 获取远程名称
  9. 6人机接口演示配置文件
    1. 6.1 主机
      1. 6.1.1  连接远程 HID 设备
      2. 6.1.2  关闭连接
      3. 6.1.3  控制请求
      4. 6.1.4  获取报告请求
      5. 6.1.5  设置报告请求
      6. 6.1.6  获取协议请求
      7. 6.1.7  设置协议请求
      8. 6.1.8  获取空闲请求
      9. 6.1.9  设置空闲请求
      10. 6.1.10 数据写入
    2. 6.2 客户端
      1. 6.2.1 获取报告响应
      2. 6.2.2 设置报告响应
      3. 6.2.3 获取协议响应
      4. 6.2.4 设置协议响应
      5. 6.2.5 获取空闲响应
      6. 6.2.6 设置空闲响应
  10. 7参考文献
  11. 8修订历史记录

5.13 获取本地地址

说明

GetLocalAddress 命令负责查询本地蓝牙设备的蓝牙设备地址。此函数在成功执行时返回零，而在出现任何错误时返回负值。必须存在蓝牙协议栈 ID，才能尝试调用此函数。

参数

使用此命令时不需要包含参数。参数对查询的结果没有影响。

可能的返回值

  • (0) 成功查询本地地址
  • (-1) BTPS_ERROR_INVALID_PARAMETER
  • (-2) BTPS_ERROR_INVALID_BLUETOOTH_STACK_ID
  • (-8) INVALID_STACK_ID_ERROR
  • (-4) FUNCTION_ERROR

API 调用

GAP_Query_Local_BD_ADDR(BluetoothStackID, &BD_ADDR)

API 原型

int BTPSAPI GAP_Query_Local_BD_ADDR(unsigned int BluetoothStackID, BD_ADDR_t *BD_ADDR)

API 说明

此函数负责查询（和报告）本地蓝牙设备的设备地址。第二个参数是指向缓冲区的指针，该缓冲区用于接收本地蓝牙设备的设备地址。如果该函数成功，则 BD_ADDR 参数指向的缓冲区将填充从本地蓝牙设备读取的设备地址。如果此函数返回负值，则无法查询本地蓝牙设备的设备地址（错误情况）。