> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 验证 GAP 功能

> 蓝牙低功耗 GAP 是现有 BR/EDR GAP 的扩展。

<a id="bluez-gap" />

要执行蓝牙 GAP 功能，您必须先完成以下过程中的步骤。

## 前提条件

* 启用 SSH 以访问您的主机设备。有关说明，请参阅 <a href="https://dragonwingdocs.qualcomm.com/Key-Documents/Flash-Guide/how-to-sign-in-with-ssh" target="_self">使用 SSH 登录</a>。

* 将被测设备（DUT）和远程设备置于蓝牙有效范围内。

## 为蓝牙 GAP 功能设置设备

1. 在命令提示符中使用以下命令运行 SSH：

   ```text theme={null}
   ssh root@<device_IP_address>
   ```

   **示例**

   如果设备的 IP 地址为 `10.92.160.222`，请运行以下命令：

   ```text theme={null}
   ssh root@10.92.160.222
   ```

2. 输入以下密码以连接到 SSH：

   ```text theme={null}
   oelinux123
   ```

3. 运行以下命令打开蓝牙测试应用程序：

   ```text theme={null}
   bluetoothctl
   ```

   **示例输出**

   ```text theme={null}
   sh-5.1# bluetoothctl
   Agent registered        uetoothd...
   [CHG] Controller 22:22:F1:C1:99:C0 Pairable: yes
   ```

   * 要查看 GAP 功能，请运行以下命令：

     ```text theme={null}
     help
     ```

     此命令提供 **bluetoothctl** 的主菜单。主菜单包括子菜单和 GAP 功能。要执行 GAP 功能，请参阅 <a href="perform-bluetooth-gap-functions" target="_self">执行蓝牙 GAP 功能</a>。

     **示例输出**

     ```text theme={null}
     [bluetooth]# help
     Menu main:
     Available commands:
     -------------------
     advertise                                         Advertise Options Submenu
     monitor                                           Advertisement Monitor Options Submenu
     scan                                              Scan Options Submenu
     gatt                                              Generic Attribute Submenu
     admin                                             Admin Policy Submenu
     player                                            Media Player Submenu
     endpoint                                          Media Endpoint Submenu
     transport                                         Media Transport Submenu
     list                                              List available controllers
     show [ctrl]                                       Controller information
     select <ctrl>                                     Select default controller
     devices [Paired/Bonded/Trusted/Connected]         List available devices, with an optional property as the filter
     system-alias <name>                               Set controller alias
     reset-alias                                       Reset controller alias
     power <on/off>                                    Set controller power
     pairable <on/off>                                 Set controller pairable mode
     discoverable <on/off>                             Set controller discoverable mode
     discoverable-timeout [value]                      Set discoverable timeout
     agent <on/off/capability>                         Enable/disable agent with given capability
     default-agent                                     Set agent as the default one
     advertise <on/off/type>                           Enable/disable advertising with given type
     set-alias <alias>                                 Set device alias
     scan <on/off/bredr/le>                            Scan for devices
     info [dev]                                        Device information
     pair [dev]                                        Pair with device
     cancel-pairing [dev]                              Cancel pairing with device
     trust [dev]                                       Trust device
     untrust [dev]                                     Untrust device
     block [dev]                                       Block device
     unblock [dev]                                     Unblock device
     remove <dev>                                      Remove device
     connect <dev>                                     Connect device
     disconnect [dev]                                  Disconnect device
     menu <name>                                       Select submenu
     version                                           Display version
     quit                                              Quit program
     exit                                              Quit program
     help                                              Display help about this program
     export                                            Print environment variables
     ```

   * 要验证设备上蓝牙的状态，请运行以下命令：

     ```text theme={null}
     show
     ```

     **示例输出**

     ```text theme={null}
     [bluetooth]# show
     Controller 8C:FD:F0:21:84:23 (public)
              Name: qcs9100-ride-sx
              Alias: qcs9100-ride-sx
              Class: 0x00000000
              Powered: no
              Discoverable: no
              DiscoverableTimeout: 0x000000b4
              Pairable: yes
              UUID: A/V Remote Control        (0000110e-0000-1000-8000-00805f9b34fb)
              UUID: PnP Information           (00001200-0000-1000-8000-00805f9b34fb)
              UUID: Message Access Server     (00001132-0000-1000-8000-00805f9b34fb)
              UUID: Message Notification Se.. (00001133-0000-1000-8000-00805f9b34fb)
              UUID: A/V Remote Control Target (0000110c-0000-1000-8000-00805f9b34fb)
              UUID: Generic Access Profile    (00001800-0000-1000-8000-00805f9b34fb)
              UUID: Phonebook Access Server   (0000112f-0000-1000-8000-00805f9b34fb)
              UUID: Generic Attribute Profile (00001801-0000-1000-8000-00805f9b34fb)
              UUID: OBEX File Transfer        (00001106-0000-1000-8000-00805f9b34fb)
              UUID: Device Information        (0000180a-0000-1000-8000-00805f9b34fb)
              UUID: IrMC Sync                 (00001104-0000-1000-8000-00805f9b34fb)
              UUID: Handsfree                 (0000111e-0000-1000-8000-00805f9b34fb)
              UUID: OBEX Object Push          (00001105-0000-1000-8000-00805f9b34fb)
              Modalias: usb:v1D6Bp0246d0541
              Discovering: no
              Roles: central
              Roles: peripheral
     Advertising Features:
              ActiveInstances: 0x00 (0)
              SupportedInstances: 0x10 (16)
              SupportedIncludes: tx-power
              SupportedIncludes: appearance
              SupportedIncludes: local-name
              SupportedSecondaryChannels: 1M
              SupportedSecondaryChannels: 2M
              SupportedSecondaryChannels: Coded
     ```

## 后续步骤

### <a href="perform-bluetooth-gap-functions" target="_self">执行蓝牙 GAP 功能</a>

您可以使用 **bluetoothctl** 主菜单中提供的命令执行各种蓝牙 GAP 功能。蓝牙 GAP 功能包括启用和禁用蓝牙、运行和停止查询扫描以发现附近的设备，以及启用设备可发现模式。GAP 还支持与远程蓝牙设备配对、查看已绑定或已配对设备的列表以及取消设备配对。
