# 串行端口 Profile (Serial Port Profile)

SPP 是一种蓝牙 profile，可通过虚拟串行端口促进设备之间的无线通信。

要执行蓝牙 SPP 服务器或客户端功能，必须首先完成以下过程中的步骤。

## 设置设备的蓝牙 SPP 功能

**前提条件**

- 启用 SSH 以访问您的主机设备。有关说明，请参阅[使用 SSH 登录](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-254/how_to.html#use-ssh)。
- 将 DUT 和远程设备放置在蓝牙附近。

**步骤**

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

ssh root@<device_IP_address>
        Copy to clipboard

    **示例**

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

ssh root@10.92.160.222
        Copy to clipboard
2. 输入以下密码来连接 SSH：

oelinux123
        Copy to clipboard
3. 通过运行以下命令打开蓝牙测试应用程序：

btapp
        Copy to clipboard

    **示例输出**

sh-5.1# btapp
        get_ap_interface
        :: get_ap_interface
        
        ***************** Menu *******************
                 gap_menu
                 test_menu
                 a2dp_sink_menu
                 hfp_client_menu
                 gattctest_menu
                 gattstest_menu
                 hogp_menu
                 hfp_ag_menu
                 a2dp_source_menu
                 spp_client_menu
                 spp_server_menu
                 eslap_menu
                 exit
        ******************************************
        Copy to clipboard
4. 启用蓝牙并按如下方式配对设备：

    1. 通过运行以下命令转到 **Gap Menu**：

gap_menu
            Copy to clipboard
    2. 运行以下命令，启用蓝牙：

enable
            Copy to clipboard

        **示例输出**

gap_menu
            
            ***************** Menu *******************
                     enable
                     disable
                     inquiry
                     cancel_inquiry
                     get_role_req<space><bt_address>     eg. get_role_req 00:11:22:33:44:55
                     pair<space><bt_address><space><transport>     eg. pair 00:11:22:33:44:55 0(auto)/1(BREDR)/2(BLE)
                     unpair<space><bt_address>     eg. unpair 00:11:22:33:44:55
                     inquiry_list
                     bonded_list
                     get_state
                     get_bt_name
                     get_bt_address
                     set_bt_name<space><bt name>     eg. set_bt_name MDM_Fluoride
                     set_scan_mode<space><scan mode value (range 0-2)>     eg. set_scan_mode 0 --0-BT_SCAN_MODE_NONE,1- BT_SCAN_MODE_CONNECTABLE,2-BT_SCAN_MODE_CONNECTABLE_DISCOVERABLE
                     set_afh<space><AFH_Host_Channel_Classification>     eg. set_afh 112233445566778899f0
                     send_hci_cmd<space><hci_cmd>     eg. send_hci_cmd 01,04,05,33,8b,9e,0a,00 - For Inquiry
                     read_clock<space><which_clock range(0-1)><space><bt_address>     eg. read_clock 0(local)/1(acl connection) 00:11:22:33:44:55
                     main_menu
                     switch_role_req<bt_address><space><new_role>     eg. switch_role_req 00:11:22:33:44:55 0 or get_role_req 00:11:22:33:44:55 1
            ******************************************
            enable
            current State = 0, new state = 1
            BT State is ON
            Copy to clipboard
    3. 通过运行以下命令将设备配对以进行 SPP 传出：

pair <bt_address> <transport>
            Copy to clipboard

        要接受主动/被动配对，输入 `yes`。

        **参数**

        - [运行蓝牙查询扫描](https://docs.qualcomm.com/doc/80-70018-13SC/topic/gap_commands.html#section-iy1-xnf-41c)以获取远程设备的 `<bt_address>`。
        - `<transport>` 参数的值可以是：

            - `0`：自动选择
            - `1`：BR/EDR
            - `2`：蓝牙低功耗

        **示例**

        要启动 `<bt_address>` `98:09:cf:a9:82:23` 的 BR/EDR 配对，请运行以下命令：

pair 98:09:cf:a9:82:23 1
            Copy to clipboard

        **示例输出**

pair 98:09:cf:a9:82:23 1
            BR/EDR Bonding
            ACL state:0 change with reason 00 for device: f8:7d:76:9d:9b:6b
            ************************************************
            Pairing state for MyDeviceA is BOND NONE
            ************************************************
            BT pairing request :: MyDeviceB :: Pairing Code :: 776996
            ************************************************
            **Please enter yes / no **
            yes
            ************************************************
            Pairing state for MyDeviceB is BONDED
            ************************************************
            Copy to clipboard
    4. 通过运行以下命令返回 **Main Menu**：

main_menu
            Copy to clipboard
5. 根据需要转到 SPP 服务器或客户端菜单。

    - 要转到 **SPP Server Menu**，从 `main_menu` main\_menu 运行以下命令：

spp_server_menu
            Copy to clipboard

        **示例输出**

main_menu
            
            ***************** Menu *******************
                     gap_menu
                     test_menu
                     a2dp_sink_menu
                     hfp_client_menu
                     gattctest_menu
                     gattstest_menu
                     hogp_menu
                     hfp_ag_menu
                     a2dp_source_menu
                     spp_client_menu
                     spp_server_menu
                     eslap_menu
                     exit
               ******************************************
            spp_server_menu
            
            ***************** Menu *******************
                     start_server
                     stop_server
                     send_file<space><directory_with_file_name>eg: send_file /var/fileName.txt
                     recv_file<space><directory_with_file_name>eg: recv_file /var/fileName.txt
                     send_data<space><with_size>eg: send_data 1000[Note:1000 means 1MB]
                     recv_data
                     main_menu
            ******************************************
            Copy to clipboard

        有关 SPP 服务器功能，请参阅[执行蓝牙 SPP 服务器功能](https://docs.qualcomm.com/doc/80-70018-13SC/topic/perform_bluetooth_functions_in_spp_server.html#perform-bluetooth-functions-in-spp-server)。
    - 要转到 **SPP Client Menu**，从 `main_menu` main\_menu 运行以下命令：

spp_client_menu
            Copy to clipboard

        **示例输出**

main_menu
            
            ***************** Menu *******************
                     gap_menu
                     test_menu
                     a2dp_sink_menu
                     hfp_client_menu
                     gattctest_menu
                     gattstest_menu
                     hogp_menu
                     hfp_ag_menu
                     a2dp_source_menu
                     spp_client_menu
                     spp_server_menu
                     eslap_menu
                     exit
               ******************************************
            spp_client_menu
            
            ***************** Menu *******************
                     connect <bt_addr>
                     disconnect
                     send_file<space><directory_with_file_name>eg: send_file /var/fileName.txt
                     recv_file<space><directory_with_file_name>eg: recv_file /var/fileName.txt
                     send_data<space><with_size>eg: send_data 1000[Note:1000 means 1MB]
                     recv_data
                     main_menu
               ******************************************
            Copy to clipboard

        有关 SPP 客户端功能，请参阅执行蓝牙 SPP 客户端功能。
6. 在对远程备上安装任何支持 SPP 客户端和服务器角色的第三方蓝牙主机应用程序。例如，来自 Google Play 商店的蓝牙 SPP 服务器/客户端应用程序。

    - DUT：测试设备
    - 远程设备：任何智能手机

**后续步骤**

- [执行蓝牙 SPP 服务器功能](https://docs.qualcomm.com/doc/80-70018-13SC/topic/perform_bluetooth_functions_in_spp_server.html)
您可以使用 `spp_server_menu` 选项执行 SPP 服务器功能。
- [执行蓝牙 SPP 客户端功能](https://docs.qualcomm.com/doc/80-70018-13SC/topic/perform_bluetooth_functions_in_spp_client.html)
您可以使用 `spp_client_menu` 选项执行 SPP 客户端功能。

Last Published: Apr 30, 2025

[Previous Topic
执行蓝牙 GAP 功能](https://docs.qualcomm.com/bundle/publicresource/80-70018-13SC/topics/gap_commands.md) [Next Topic
执行蓝牙 SPP 服务器功能](https://docs.qualcomm.com/bundle/publicresource/80-70018-13SC/topics/perform_bluetooth_functions_in_spp_server.md)