# 启用音频
本节介绍如何配置麦克风和扬声器连接的硬件，并提供验证基本音频用例的步骤。
Tab QCS6490
Tab IQ-9075
Tab IQ-8275
- *class* tabincludedirective
-
设置流程
**前提条件**
- 按照 [Qualcomm Linux 编译指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-254/introduction.html)中所述搭建基础架构。
- 刷写最新的软件版本，将其写入至开发板中。
- 设置 SSH 连接：
1. 通过执行[使用 SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-254/how_to.html#use-ssh) 中提到的步骤，在 Permissive 模式下启用 SSH。
2. 连接到设备：
ssh root@
Copy to clipboard
例如，如果设备的 IP 地址为 10.92.160.222，执行以下命令：
ssh root@10.92.160.222
Copy to clipboard
**设置音频硬件**
1. 要激活板卡上的数字麦克风接口 (DMIC)，请使用 DIP 2。将 PIN 2 切换到 ON 位置。
2. 将扬声器连接到板卡。
- *class* tabincludedirective
-
设置流程
**前提条件**
- 按照 [Qualcomm Linux 编译指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-254/introduction.html)中所述搭建基础架构。
- 刷写最新的软件版本，将其写入至开发板中。
- 设置 SSH 连接：
1. 通过执行[使用 SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-254/how_to.html#use-ssh) 中提到的步骤，在 Permissive 模式下启用 SSH
2. 要连接到设备，可运行以下命令：
ssh root@
Copy to clipboard
例如，如果设备的 IP 地址为 10.92.160.222，执行以下命令：
ssh root@10.92.160.222
Copy to clipboard
**设置音频硬件**
将扬声器连接到板卡。
Note
EVT 板需要进行硬件返工，以使音频功能正常工作。
- *class* tabincludedirective
-
设置流程
Note
音频功能需要 NXP 或其他第三方 codec 的固件和许可证。NXP 的 Mercury Codec 是 Qualcomm Dragonwing IQ-8275 的默认 codec。
**前提条件**
- 按照 [Qualcomm Linux 编译指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-254/introduction.html)中所述搭建基础架构。
- 刷写最新的软件版本，将其写入至开发板中。
- 设置 SSH 连接。
1. 在 Permissive 模式下启用 SSH。如需了解更多指导，请参阅[使用 SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-254/how_to.html#use-ssh)
2. 连接到设备：
ssh root@
Copy to clipboard
例如，如果设备的 IP 地址为 10.92.160.222，则运行
ssh root@10.92.160.222
Copy to clipboard
**设置音频硬件**
1. 从 NXP 获取 Mercury Codec 所需的许可证和固件。
2. 关闭设备。
3. 打开设备的后面板。
4. 将 DIP 开关 S6 bit7 设置为 ON，将 DIP 开关 S6 bit8 设置为 OFF。
5. 设备上电。
6. 运行以下命令：
ssh root@ip-addr
mount -o rw,remount /
Copy to clipboard
7. 将从 NXP 收到的 Mercury 固件推送到以下位置：
ssh root@ip-addr
scp -r mercury_firmware\. root@[ip-addr]:/etc/firmware/
Copy to clipboard
8. 将设备设置为刷写模式。使用 `dac_mer_testapp` 选择 1 (Flash Mercury)，然后选择 5。
ssh root@ip-addr
dac_mer_testapp
Copy to clipboard
9. 刷写固件：
mercuryflasher -f
Copy to clipboard
如果上述命令失败，请检查以下命令的输出以进行调试。
检查 ping 是否有效：
mercuryflasher -p
Copy to clipboard
检查读取是否有效：
mercuryflasher -r
Copy to clipboard
Note
所有命令都应返回成功或 0a。
Mercuryflasher 工具无法直接在第一个候选编译版本上运行。如需了解详细信息，请参阅最新工具。
10. 关闭设备。
11. 将 DIP 开关 S6 bit7 设置为 OFF。使用上图作为参考。
12. 设备上电。
13. 要播放，请按如下方式将耳机/扬声器设备连接到线路输出 1/2 端口。
14. 要录制，请按如下方式将麦克风/耳机设备连接到 MIC1 端口。
## 使用 GStreamer 启用音频
如需使用 GStreamer 应用解码和编码音频，请参阅以下内容。
- [音频解码示例](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-50/gst-audio-decode-sample.html)
- [音频编码示例](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-50/gst-audio-encode-example-without-flac.html)
Note
要检查不同芯片组的 GStreamer 应用，请参阅[多媒体示例应用程序的源信息](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-50/example-applications.html#multimedia-sample-applications)。
GStreamer 是一个开源多媒体框架。Qualcomm 提供 GStreamer 插件作为 Qualcomm IM SDK 的一部分。
### GStreamer 插件
- 用于音频解码器和编码器的 GStreamer 插件是 Qualcomm IM SDK 的一部分。下载完整的 Qualcomm IM SDK 以使用 [pulsesrc](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-50/pulsesrc.html) 和 [pulsesink](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-50/pulsesink.html)。
- [Qualcomm IM SDK 快速入门指南](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-51/introduction.html)介绍了如何下载和编译 Qualcomm IM SDK。
### GStreamer 示例程序
[GStreamer 音频应用示例](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-50/audio-sample-applications.html)用例是 Qualcomm IM SDK 的一部分。在运行示例应用之前，先满足这些[先决条件](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-50/example-applications.html)。
使用命令行或 GST 应用程序运行音频用例。
### 使用 Gstreamer 应用播放和录制音频
使用命令行运行 `gst-launch-1.0` 以进行[音频播放/采集](https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-50/audio-use-cases.html)。
Note
对于 QCS8275，使用 `dac_mer_testapp` 启用播放和录制，如 [启用音频](https://docs.qualcomm.com/doc/80-70020-16SC/topic/enable-audio.html#enable-audio) 中所述。
## 使用 PulseAudio 启用音频
### PulseAudio 录制
>
>
> Tab QCS6490
> Tab IQ-9075
> Tab IQ-8275
>
> - *class* tabincludedirective
>
> - 1. 设置 PulseAudio 录制：
>
>
> parec -v --rate=48000 --format=s16le --channels=1 --file-format=wav /opt/test.wav --device=regular2
> Copy to clipboard
>
>
> 命令行 Shell 应如下所示：
>
> 
> 2. 选择 Ctrl + C 停止录制。
>
>
> 支持的格式为 `s16le`、`s24le`、`s32le`、`s24-32le`，速率可以为 `8000`、`16000`、`22050`、`24000`、`32000`、`44100`、`48000`、`88200`、`96000`、`176400`、`192000`、`352800`、`384000`、`705600` 和 `768000`，通道数量可以从 `1` 到最多 `8` 个不等。
>
> - *class* tabincludedirective
>
> - 1. 设置 PulseAudio 录制：
>
>
> parec -v --rate=48000 --format=s16le --channels=1 --file-format=wav /opt/test.wav --device=regular2
> Copy to clipboard
>
>
> 命令行 Shell 应如下所示：
>
> 
> 2. 选择 **Ctrl + C** 停止录制。
>
>
> 支持的格式为 `s16le`、`s24le`、`s32le`、`s24-32le`，速率可以为 `8000`、`16000`、`22050`、`24000`、`32000`、`44100`、`48000`、`88200`、`96000`、`176400`、`192000`、`352800`、`384000`、`705600` 和 `768000`，通道数量可以从 `1` 到最多 `4` 个不等。
>
> - *class* tabincludedirective
>
> - 1. 要开始播放或录制用例，请配置 Mercury Codec 和 DAC。
>
>
> 启用播放和采集：
>
>
> ssh root@ip-addr
> dac_mer_testapp
> Copy to clipboard
> 2. 选择选项 2（SOC Mercury），然后选择 1（启用播放设置）以进行播放和录制用例。
> 3. 在新的命令 shell 中运行以下命令：
>
>
> ssh root@ip-addr
> parec -v --rate=48000 --format=s16le --channels=1 --file-format=wav /opt/test.wav --device=regular2
> Copy to clipboard
>
>
> 命令行 Shell 应如下所示：
>
> 
> 4. 选择 Ctrl + C 停止录制。
>
>
> 支持的格式为 `s16le`、`s24le`、`s32le`、`s24-32le`，速率可以为 `8000`、`16000`、`22050`、`24000`、`32000`、`44100`、`48000`、`88200`、`96000`、`176400`、`192000`、`352800`、`384000`、`705600` 和 `768000`，通道数量可以从 `1` 到最多 `4` 个不等。
### 录音音量设置
>
>
> Tab QCS6490
> Tab IQ-9075
> Tab IQ-8275
>
> - *class* tabincludedirective
>
> - 1. 使用 `parec` 工具启动音频采集。
> 2. 同时打开新的命令提示符。打开 `ssh root@ip-addr` 并运行以下命令来设置音量：
>
>
> pactl set-source-volume regular2
> Copy to clipboard
>
>
> `` 范围从 0 到 65,535。
>
> - *class* tabincludedirective
>
> - 1. 使用 `parec` 实用工具开始采集。
> 2. 同时打开新的命令提示符。打开 `ssh root@ip-addr` 并运行以下命令：
>
>
> pactl set-source-volume regular2
> Copy to clipboard
>
>
> `` 范围从 0 到 65,535。
>
> - *class* tabincludedirective
>
> - 1. 使用 `parec` 实用工具开始采集。
> 2. 同时打开新的命令提示符。打开 `ssh root@ip-addr` 并运行以下命令：
>
>
> pactl set-source-volume regular2
> Copy to clipboard
>
>
> `` 范围从 0 到 65,535。
### PulseAudio 播放
>
>
> Tab QCS6490
> Tab IQ-9075
> Tab IQ-8275
>
> - *class* tabincludedirective
>
> - 1. 将 .wav 音频文件推送到设备进行播放：
>
>
> scp test.wav root@[ip-addr]:/opt/
> Copy to clipboard
> 2. 推送 test.wav 文件后，使用 `ssh root@ip-add` 进入设备 shell。
> 3. 开始播放：
>
>
> paplay /opt/test.wav -v
> Copy to clipboard
>
>
> 命令行 Shell 应如下所示：
>
> 
>
> - *class* tabincludedirective
>
> - 1. 将 .wav 文件推送到设备：
>
>
> scp test.wav root@[ip-addr]:/opt/
> Copy to clipboard
> 2. 推送 test.wav 文件后，使用 `ssh root@ip-add` 进入设备 shell。
> 3. 开始播放：
>
>
> paplay /opt/test.wav -v
> Copy to clipboard
>
>
> 命令行 Shell 应如下所示：
>
> 
>
> - *class* tabincludedirective
>
> - 1. 将 .wav 文件推送到设备：
>
>
> scp test.wav root@[ip-addr]:/opt/
> Copy to clipboard
> 2. 推送 test.wav 文件后，使用 `ssh root@ip-add` 进入设备 shell。
> 3. 使用以下命令进行播放：
>
>
> paplay /opt/test.wav -v
> Copy to clipboard
>
>
> 命令行 Shell 应如下所示：
>
> 
### 播放音量设置
>
>
> Tab QCS6490
> Tab IQ-9075
> Tab IQ-8275
>
> - *class* tabincludedirective
>
> - 1. 使用 `paplay` 工具启动扬声器上的音频播放。
> 2. 同时打开新的命令提示符。打开 `ssh root@ip-addr` 并运行以下命令来设置音量：
>
>
> pactl set-sink-volume low-latency0
> Copy to clipboard
>
>
> `` 范围从 0 到 65,535。
>
> - *class* tabincludedirective
>
> - 1. 使用 `paplay` 工具在扬声器上开始播放。
> 2. 同时打开新的命令提示符。打开 `ssh root@ip-addr` 并运行以下命令：
>
>
> pactl set-sink-volume low-latency0
> Copy to clipboard
>
>
> `` 范围从 0 到 65,535。
>
> - *class* tabincludedirective
>
> - 1. 使用 `paplay` 工具在扬声器上开始播放。
> 2. 同时打开新的命令提示符。打开 `ssh root@ip-addr` 并运行以下命令：
>
>
> pactl set-sink-volume low-latency0
> Copy to clipboard
>
>
> `` 范围从 0 到 65,535。
PulseAudio 是一种通用声音服务器。它作为应用程序和硬件设备之间的中间件运行。
在 `build-qcom-wayland/workspace/sources/pulseaudio` 处找到 PulseAudio 的源代码。
本节列出了常用的 PulseAudio API。如需了解所有 API 的完整描述，请参见[开源 PulseAudio 文档](https://www.freedesktop.org/software/pulseaudio/doxygen/index.html)。
如需了解更多信息，请参见 [PulseAudio API](https://www.freedesktop.org/software/pulseaudio/doxygen/simple_8h.html) 文档。
### pa\_stream\_new
使用指定的名称和示例类型创建新的、未连接的流。
pa_stream* pa_stream_new (
pa_context * c,
const char *name,
const pa_sample_spec * ss,
const pa_channel_map *map)
Copy to clipboard
**参数**
| c | 创建流的上下文 |
| --- | --- |
| name | 流名称。 |
| ss | 示例格式 |
| map | 通道映射。默认值为 NULL。 |
**返回值**
[pa_stream](https://freedesktop.org/software/pulseaudio/doxygen/stream_8h.html#a960d798980692a2ff01e5a70553d4f29)\* 句柄
### pa\_stream\_get\_state
返回当前流状态。
pa_stream_state_t pa_stream_get_state(
const pa_stream *p)
Copy to clipboard
**参数**
| p | pa\_stream 句柄 |
| --- | --- |
**返回值**
返回 [pa_stream_state_t](https://freedesktop.org/software/pulseaudio/doxygen/def_8h.html#a750e398d2ce663b858c87d8aa2f81eaa)
### pa\_stream\_get\_device\_name
返回此流在服务器中连接到的接收端或发送端名称。
const char* pa_stream_get_device_name(const pa_stream *s)
Copy to clipboard
**参数**
| s | pa\_stream 句柄 |
| --- | --- |
**返回值**
设备名称
### pa\_stream\_connect\_playback
将流连接到 Sink。
int pa_stream_connect_playback (
pa_stream * s,
const char * dev,
const pa_buffer_attr *attr,
pa_stream_flags_t flags,
const pa_cvolume *volume,
pa_stream *sync_stream)
Copy to clipboard
**参数**
| s | 连接到接收端的流 |
| --- | --- |
| dev | 要连接的接收端名称。默认值为 NULL，由服务器决定。 |
| attr | 缓存属性。默认值为 NULL。 |
| flags | 更多标志。默认值为 0。 |
| volume | 初始音量。默认值为 NULL。 |
| sync\_stream | 将此流与指定流同步。独立流的默认值为 NULL。 |
**返回值**
成功时返回零。
### pa\_stream\_connect\_record
将流连接到 Source。
int pa_stream_connect_record(
pa_stream *s,
const char * dev,
const pa_buffer_attr * attr,
pa_stream_flags_t flags)
Copy to clipboard
**参数**
| s | 连接到发送端的流 |
| --- | --- |
| dev | 要连接的发送端名称。默认值为 NULL，由服务器决定。 |
| attr | 缓存属性。默认值为 NULL。 |
| flags | 更多标志。默认值为 0。 |
**返回值**
成功时返回零。
### pa\_stream\_write
将数据写入服务器（用于播放流）。
int pa_stream_write(
pa_stream * p,
const void * data,
size_t nbytes,
pa_free_cb_t free_cb,
int64_t offset,
pa_seek_mode_t seek)
Copy to clipboard
**参数**
>
>
> | p | 要使用的流 |
> | --- | --- |
> | data | 要写入的数据 |
> | nbytes | 要写入的数据长度（以字节为单位）。必须是流的采样点规格帧大小的倍数。 |
> | free\_cb | 数据清理例程。请求内部副本的默认值为 NULL。 |
> | offset | 寻找偏移量。上行流，则必须为 0。必须是流的采样点规格帧大小的倍数。 |
> | seek | 查找模式。如为上行流，则必须为 PA\_SEEK\_RELATIVE。 |
**返回值**
成功时返回零。
### pa\_stream\_set\_write\_callback
设置当新数据可以写入流时调用的回调函数。
void pa_stream_set_write_callback(
pa_stream * p,
pa_stream_request_cb_t cb,
void *userdata)
Copy to clipboard
**参数**
| p | 要使用的流 |
| --- | --- |
| cb | 要设置的回调函数 |
| userdata | 要发送到回调的用户数据。 |
**返回值**
无
### pa\_stream\_set\_read\_callback
设置当流中有新数据可用时调用的回调函数。
void pa_stream_set_read_callback(
pa_stream * p,
pa_stream_request_cb_t cb,
void *userdata)
Copy to clipboard
**参数**
| p | 要使用的流 |
| --- | --- |
| cb | 要设置的回调函数 |
| userdata | 要发送到回调的用户数据。 |
**返回值**
无
### pa\_stream\_disconnect
断开流与 Source/Sink 的连接。
int pa_stream_disconnect(pa_stream *s)
Copy to clipboard
**参数**
| s | pa\_stream 句柄 |
| --- | --- |
**返回值**
成功时返回零。
如需了解更多信息，请参见 [PulseAudio API](https://freedesktop.org/software/pulseaudio/doxygen/stream_8h.html) 文档。
Last Published: Jul 23, 2025
[Previous Topic
音频概述](https://docs.qualcomm.com/bundle/publicresource/80-70020-16SC/topics/overview.md) [Next Topic
定制音频用例](https://docs.qualcomm.com/bundle/publicresource/80-70020-16SC/topics/customize.md)