# 执行蓝牙 HFP 音频网关功能

您可以使用 `bluetoothctl` 菜单和 `paplay` 命令执行 HFP 音频网关功能。

## 前提条件

开始之前，请[设置您的设备](https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-hfp.html#section-rmp-dgv-mcc-navyanka-08-25-24-1227-32-765)，并且[配置 DUT 以实现 HFP 音频网关功能](https://docs.qualcomm.com/doc/80-70022-13SC/topic/bluez-hfp.html#section-jgk-r3v-mcc-navyanka-08-25-24-1246-49-237)。

## 连接远程设备

要连接远程设备，请从 `bluetoothctl` 菜单运行以下命令：

connect <bt_address>
    Copy to clipboard

**参数**

`<bt_address>` 是远程设备的蓝牙地址。

**示例**

要使用 `<bt_address>` `20:19:D8:36:90:40` 连接到已配对的远程设备，请运行以下命令：

connect 20:19:D8:36:90:40
    Copy to clipboard

**示例输出**

[Test]# connect 20:19:D8:36:90:40
    Attempting to connect to 20:19:D8:36:90:40
    [CHG] Device 20:19:D8:36:90:40 Connected: yes
    [CHG] Device 20:19:D8:36:90:40 UUIDs: 00001108-0000-1000-8000-00805f9b34fb
    [CHG] Device 20:19:D8:36:90:40 UUIDs: 0000110b-0000-1000-8000-00805f9b34fb
    [CHG] Device 20:19:D8:36:90:40 UUIDs: 0000110c-0000-1000-8000-00805f9b34fb
    [CHG] Device 20:19:D8:36:90:40 UUIDs: 0000110e-0000-1000-8000-00805f9b34fb
    [CHG] Device 20:19:D8:36:90:40 UUIDs: 0000111e-0000-1000-8000-00805f9b34fb
    [CHG] Device 20:19:D8:36:90:40 ServicesResolved: yes
    [CHG] Device 20:19:D8:36:90:40 Bonded: yes
    [CHG] Device 20:19:D8:36:90:40 Paired: yes
    [NEW] Endpoint /org/bluez/hci0/dev_20_19_D8_36_90_40/sep1
    [NEW] Transport /org/bluez/hci0/dev_20_19_D8_36_90_40/sep1/fd1
    Connection successful
    [CHG] Transport /org/bluez/hci0/dev_20_19_D8_36_90_40/sep1/fdl State: active
    [CHG] Transport /org/bluez/hci0/dev_20_19_D8_36_90_40/sep1/fd1 Volume: 0x0068 (104)
    [CHG] Transport /org/bluez/hci0/dev_20_19_D8_36_90_40/sep1/fd1 State: idle
    Copy to clipboard

## 验证音频网关功能

要验证音频网关功能，请执行以下操作：

1. 创建一个虚拟 SCO，如下所示：

    1. 运行 SSH。
    2. 通过运行以下命令播放 WAV 文件：

paplay <file.wav> -v
            Copy to clipboard

        **示例**

        要播放 `AG_playback.wav` 文件，请运行以下命令：

paplay AG_playback.wav -v
            Copy to clipboard

        **示例输出**

sh-5.1# paplay AG_playback.wav -v
            Opening a playback stream with sample specification 's16le 2ch 8000Hz' and channel map 'front-left,front-right'
            Connection established.
            Stream successfully created.
            Buffer metrics: maxlength=4194304, tlength=64000, prebuf=63364, minreq=640
            Using sample spec 's16le 2ch 8000Hz', channel map 'front-left,front-right'.
            Connected to device bluez_sink.20_19_D8_36_90_40.handsfree_head_unit (index: 7, suspended: no).
            Stream started.
            Time: 2.003 sec; Latency: 2042009 usec.
            Copy to clipboard
2. 通过运行以下命令从远程设备接收麦克风数据：

parec -v --rate=<rate> --format=<format> --channels=<channel_number> --file-format=<file_format audio_filepath> --device=<device_name>
        Copy to clipboard

    **参数**

    | 选项 | 参数 | 说明 | 示例 |
    | --- | --- | --- | --- |
    | `--rate` | `<rate>` | 播放音频文件的特定采样率。 | `16000` |
    | `--format` | `<format>` | 播放音频文件的特定样本格式。 | `s16le` |
    | `--channels` | `<channel_number>` | 播放音频文件的具体通道数。 | `1` |
    | `--file-format` | `<file_format audio_filepath>` | 用于播放目录中的音频文件的文件格式。 | `wav /data/rec1.wav` |
    | `--device` | `<device_name>` | 播放音频文件的发送端或接收端的设备名称。 | `bluez_source.20_19_D8_36_90_40.handsfree_head_unit` |

    **示例**

    要从远程设备接收表中列出的示例值的麦克风数据，请运行以下命令：

parec -v --rate=16000 --format=s16le --channels=1 --file-format=wav /data/rec1.wav --device=bluez_source.20_19_D8_36_90_40.handsfree_head_unit
        Copy to clipboard
3. 播放录制的麦克风数据并验证音频是否清晰。

## 断开远程设备的连接

要断开远程设备的连接，请从 `bluetoothctl` 菜单运行以下命令：

disconnect <bt_address>
    Copy to clipboard

**参数**

`<bt_address>` 是远程设备的蓝牙地址。

**示例**

要断开与 `<bt_address>` `20:19:D8:36:90:40` 配对的远程设备，请运行以下命令：

disconnect 20:19:D8:36:90:40
    Copy to clipboard

**示例输出**

[MyHeadset]# disconnect 20:19:D8:36:90:40
    Attempting to disconnect from 20:19:D8:36:90:40
    [DEL] Transport /org/bluez/hci0/dev_20_19_D8_36_90_40/sep1/fd2
    [DEL] Endpoint /org/bluez/hci0/dev_20_19_D8_36_90_40/sep1
    [CHG] Device 20:19:D8:36:90:40 ServicesResolved: no
    Successful disconnected
    [CHG] Device 20:19:D8:36:90:40 Connected: no
    Copy to clipboard

Last Published: Nov 03, 2025

[Previous Topic
执行蓝牙 HFP 客户端功能](https://docs.qualcomm.com/bundle/publicresource/80-70022-13SC/topics/bluez-perform-bluetooth-hfp-client-functions.md) [Next Topic
验证 OPP 功能](https://docs.qualcomm.com/bundle/publicresource/80-70022-13SC/topics/bluez-opp.md)