ALSA 配置文件简介

做alsa的基本都能体会到alsa-lib的复杂与强大，而alsa-lib的强大正是从asound.conf与.asoundrc等配置文件体现出来的。alsa驱动开发只是一个方面，而真正想随心所欲的配置音频设备，asound.conf与.asoundrc的掌握是必不可少的。所幸，这方面的资料还是比较丰富，所需了解的知识点基本都能从官网上找到文档甚至example。

Alsa-lib层，为不同的驱动提供统一的接口alsa API，简化了开发人员对于驱动层的调用开发。接口定义地址：

https://www.alsa-project.org/alsa-doc/alsa-lib/

关于asound.conf的配置，可以参考官网解释：

https://www.alsa-project.org/main/index.php/Asoundrc

详细的插件讲解，官网网址：

https://www.alsa-project.org/alsa-doc/alsa-lib/pcm_plugins.html

1、Asoundrc

1.1、什么是asoundrc文件？

这里asoundrc文件实际上包含两个文件： “.asoundrc” 和 “asound.conf” 。

.asoundrc 是一个隐藏文件，是针对个人用户的配置文件，存在于用户主目录下。asound.conf 则是全局的配置文件。

1.2、为什么需要asoundrc文件?

事实上，asoundrc（.asoundrc 和 asound.conf）文件对ALSA来说，不是必须的配置文件，也就是说，无论它存不存在，都不影响ALSA的正常工作。那么既然这样，它存在的意义是什么呢？使用asoundrc文件可以实现更多对card/device的高级控制。例如在alsa-lib层进行通道路由和采样率转换，把多块声卡合为一块或者访问多通道卡的多个I/O。然而通过ALSA-lib库这两个文件能够为应用程序提供额外的功能，如通道路由，样本rate转换。

1.3、asoundrc文件什么时候被加载的？

alsa-lib 库将 /usr/share/alsa/alsa.conf 配置文件作为主要的入口点。其他文件在哪是否需要都由这个文件决定。 alsa.conf中自动加载系统全局自定义设置文件 /etc/asound.conf 和用户自定义配置文件 ~/.asoundrc。

这个文件在调用 snd_pcm_open 这个api函数时，会被加载同时解析。

2、Plugin（插件）

在ALSA中，PCM插件扩展了PCM设备的功能和特性。插件可以自动处理诸如：命名设备、采样率转换、通道间的采样复制、写入文件、为多个输入/输出连接声卡/设备（不同步采样）、使用多通道声卡/设备以及其他可能留给你的开发任务。

2.1、Plugin: hw

此插件直接与ALSA内核驱动程序通信，它是一种没有任何转换的原始通信。

pcm.name {
   
    type hw         # Kernel PCM
    card INT/STR        # Card name (string) or number (integer)
    [device INT]        # Device number (default 0)
    [subdevice INT]     # Subdevice number (default -1: first available)
    [sync_ptr_ioctl BOOL]   # Use SYNC_PTR ioctl rather than the direct mmap access for control structures
    [nonblock BOOL]     # Force non-blocking open mode
    [format STR]        # Restrict only to the given format
    [channels INT]      # Restrict only to the given channels
    [rate INT]      # Restrict only to the given rate
    [chmap MAP]     # Override channel maps; MAP is a string array
}

nonblock选项指定设备是否以非阻塞方式打开。注意此选项并不会更改读/写访问的阻塞行为。只影响打开设备时的阻塞行为。如果想保持与旧ALSA版本的兼容性，请关闭此选项。

下面是一个例子：

用vi命令在你的home目录或root目录下创建一个asoundrc配置文件：vi /home/xxx/.asoundrc （或者在打开 /etc/asound.conf 文件）

将下面的代码拷贝到该文件中并保存：

pcm.!default {
   
        type hw
        card 0
}
 
ctl.!default {
   
        type hw           
        card 0
}

名字为default的声卡，指向card0，也就是hw：0，0，测试命令：aplay -D default test.wav

注意：ALSA库定义的default 设备是 hw:0,0。 由 !default 指定的内容将替换ALSA lib API定义的。

hw后面跟的数字是声卡号和设备号，可以用如下命令查看硬件支持声卡数：

cat /proc/asound/cards 或者 ls /dev/snd （注：pcm0c (capture), pcm0p (playback)）

2.2、Slave 定义

在ALSA中，PCM插件扩展了PCM设备的功能和特性。插件可以自动处理诸如：命名设备、采样率转换、通道间的采样复制、写入文件、为多个输入/输出连接声卡/设备（不同步采样）、使用多通道声卡/设备等工作。要使用它们，开发者需要创建一个虚拟从属设备（slave device）。

pcm_slave.NAME {
   
    pcm STR     # PCM name
    # or
    pcm {
    }     # PCM definition
    format STR  # Format or "unchanged"
    channels INT    # Count of channels or "unchanged" string
    rate INT    # Rate in Hz or "unchanged" string
    period_time INT # Period time in us or "unchanged" string
    buffer_time INT # Buffer time in us or "unchanged" string
}

一个最简单的slave用例：

pcm_slave.sltest {
   
	pcm "hw:1,0"
}

上面的实例定义了一个没有任何参数的slave，实际上也就仅仅是给声卡设备定义了一别名而已。对于需要参数的情况，需要注意一点 “PCM types”的参数必须定义在 slave-definition-block ，例如下面这两种方式定义是一致的：

pcm_slave.sl2 {
   
	pcm "hw:1,0"
	rate 48000
}

pcm.rate_convert {
   
	type rate
	slave sl2
}

或者

pcm.rate_convert {
   
	type rate
	slave {
   
		pcm "hw:1,0"
		rate 48000
	}
}

在slave设备配置中加入采样率转换。注意，这两种方式中参数定义的位置。

调用这个设备播放音频的例子： aplay -D rate_convert test.wav ，此时是以48kHz的采样率对test.wav进行播放。

上面的用例用到了 Plugin: Rate

2.3、Plugin: Rate

这个插件可以转换采样率，但是输入输出格式必须为线型。

pcm.name {
   
    type rate               # Rate PCM
    slave STR               # Slave name
    # or
    slave {
                    # Slave definition
            pcm STR         # Slave PCM name
            # or
            pcm {
    }         # Slave PCM definition
            rate INT        # Slave rate
            [format STR]    # Slave format
    }
    converter STR           # optional
    # or
    converter [ STR1 STR2 ...