DAPM之二：audio paths与dapm kcontrol

最新推荐文章于 2023-08-13 00:53:27 发布
最新推荐文章于 2023-08-13 00:53:27 发布
阅读量3.2w 收藏 67
点赞数 10
分类专栏： ALSA
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/azloong/article/details/6334922
版权

在用alsa_amixer controls时，除了我们之前提到的snd_soc_add_controls添加的kcontrols外，还有一些多出来的controls。其实多出来的那些都是属于dapm kcontrol，主要用于切换音频路径。


一、AUDIO PATHS OVERVIEW

以标准内核2.6.32的wm8900 codec为例。先看AUDIO PATHS OVERVIEW，红色线路是LINPUT1(Left Input) -> LEFT INPUT PGA -> LEFT INPUT MIXER -> LEFT OUTPUT MIXER -> LINEOUT1L，表示从LINPUT输入的信号通过这条路径送到LINEOUT输出，再具现一点，就是录音信号直接放到SPK播出。在这条路径上，有三个带+号的圆圈，那就是多路混合器mixer，用于切换输入源或将多个输入源混合输出。

土黄色部分为LEFT INPUT PGA：可选择LINPUT1、LINPUT2和LINPUT3；

绿色部分是LEFT INPUT MIXER：可选择INPUTPGA、LINPUT2、LINPUT3和AUX/LCOM；

蓝色部分是LEFT OUTPUT MIXER：可选择INPUTMIXER、LINPUT3、AUX/LCOM和LEFT DAC等。

配置声音通路时，主要是对mixer做切换输入源操作。如要实现Playback，则需要打通DAC -> OUTPUT MIXER -> LINEOUT通路。



二、配置声音通路 

这里先绕开代码，先用alsa_amixer实际操作切换声音路径（以上图的红色路径为例），有个直观印象。

~ # alsa_amixer controls
numid=1,iface=MIXER,name='Mic Bias Level'
......省略......
numid=68,iface=MIXER,name='Left Input Mixer AUX Switch'
numid=69,iface=MIXER,name='Left Input Mixer Input PGA Switch'
numid=66,iface=MIXER,name='Left Input Mixer LINPUT2 Switch'
numid=67,iface=MIXER,name='Left Input Mixer LINPUT3 Switch'
numid=73,iface=MIXER,name='Left Input PGA LINPUT1 Switch'
numid=74,iface=MIXER,name='Left Input PGA LINPUT2 Switch'
numid=75,iface=MIXER,name='Left Input PGA LINPUT3 Switch'
numid=3,iface=MIXER,name='Left Input PGA Switch'
numid=2,iface=MIXER,name='Left Input PGA Volume'
numid=4,iface=MIXER,name='Left Input PGA ZC Switch'
numid=57,iface=MIXER,name='Left Output Mixer AUX Bypass Switch'
numid=60,iface=MIXER,name='Left Output Mixer DACL Switch'
numid=56,iface=MIXER,name='Left Output Mixer LINPUT3 Bypass Switch'
numid=58,iface=MIXER,name='Left Output Mixer Left Input Mixer Switch'
numid=59,iface=MIXER,name='Left Output Mixer Right Input Mixer Switch'
......省略......
~ #

以上打印出所有的codec kcontrols，以之前对应的颜色区分了INPUT PGA、INPUT MIXER、OUTPUT MIXER三个mixer的路径选择。要打开红色通路，则进行如下操作：

alsa_amixer cset numid=3,iface=MIXER,name='Left Input PGA Switch' 1
alsa_amixer cset numid=73,iface=MIXER,name='Left Input PGA LINPUT1 Switch' 1
alsa_amixer cset numid=69,iface=MIXER,name='Left Input Mixer Input PGA Switch' 1
alsa_amixer cset numid=58,iface=MIXER,name='Left Output Mixer Left Input Mixer Switch' 1
alsa_amixer cset numid=43,iface=MIXER,name='LINEOUT1 Switch' 1

numid3 ： 使能Left Input PGA；

numid73： 令Left Input PGA选择LINPUT1输入源；

numid69： 令Left Input Mixer选择Left Input PGA输入源；

numid58： 令Left Output Mixer选择Left Input Mixer输入源；

numid43： 使能LINEOUT1。

这里仅以最基本的alsa-util来配置回路，在实际应用中，可自己实现alsa mixer或编写asound.conf虚拟出不同的devices，前者较典型见Android2.2的ALSAControl.cpp，后者在之后的章节会提一下。我偏向于asound.conf实现，灵活性较高，不同的codec改动asound.conf就行了。


三、AUDIO PATHS代码实现

知道声音通路如何配置后，回到驱动代码实现。音频路径功能与普通的snd_kcontrol差不多，但写法稍微复杂一点，以'Left Output Mixer Left Input Mixer Switch'为例说明。

1、实现Left Output Mixer的输入源选择

static const struct snd_kcontrol_new wm8900_loutmix_controls[] = {
SOC_DAPM_SINGLE("LINPUT3 Bypass Switch", WM8900_REG_LOUTMIXCTL1, 7, 1, 0),
SOC_DAPM_SINGLE("AUX Bypass Switch", WM8900_REG_AUXOUT_CTL, 7, 1, 0),
SOC_DAPM_SINGLE("Left Input Mixer Switch", WM8900_REG_BYPASS1, 7, 1, 0),
SOC_DAPM_SINGLE("Right Input Mixer Switch", WM8900_REG_BYPASS2, 3, 1, 0),
SOC_DAPM_SINGLE("DACL Switch", WM8900_REG_LOUTMIXCTL1, 8, 1, 0),
};

2、添加名为Left Output Mixer的widget

static const struct snd_soc_dapm_widget wm8900_dapm_widgets[] = {
/* Externally visible pins */
......省略......
/* Input */
......省略......
SND_SOC_DAPM_MIXER("Left Input Mixer", WM8900_REG_POWER2, 5, 0,
		   wm8900_linmix_controls,
		   ARRAY_SIZE(wm8900_linmix_controls)),
......省略......
/* Output */
......省略......
SND_SOC_DAPM_MIXER("Left Output Mixer", WM8900_REG_POWER3, 3, 0,
		   wm8900_loutmix_controls,
		   ARRAY_SIZE(wm8900_loutmix_controls)),
......省略......
};

MIXER：多个输入源混合成一个输出，用SND_SOC_DAPM_MIXER定义这个widget，类型为snd_soc_dapm_mixer；
MUX：多路选择器，多路输入，但只能选择一路作为输出，用SND_SOC_DAPM_MUX定义这个widget，类型为snd_soc_dapm_mux；
PGA：单路输入，单路输出，带gain调整的部件，用SND_SOC_DAPM_PGA定义这个widget，类型为snd_soc_dapm_pga。

3、搭建音频路径

static const struct snd_soc_dapm_route audio_map[] = {
/* Inputs */
......省略......
/* Outputs */
......省略......
{"Left Output Mixer", "Left Input Mixer Switch", "Left Input Mixer"},
......省略......
};

前面的"Left Output Mixer"表示操作目的对象sink，对应widgets中的名为Left Output Mixer的widget；

中间的"Left Input Mixer Switch"表示操作行为control，对应wm8900_loutmix_controls中的名为Left Input Mixer Switch的kcontrol；

后面的"Left Input Mixer"表示操作源对象source，对应widgets中的名为Left Input Mixer的widget。

合起来的意思：通过动作"Left Input Mixer Switch"将输入源"Left Input Mixer"送到目的混合器"Left Output Mixer"输出。

这里我的解析有点拗口，直接看dapm.txt更清晰一点：

e.g., from the WM8731 output mixer (wm8731.c)
The WM8731 output mixer has 3 inputs (sources)
 1. Line Bypass Input
 2. DAC (HiFi playback)
 3. Mic Sidetone Input
Each input in this example has a kcontrol associated with it (defined in example
above) and is connected to the output mixer via it's kcontrol name. We can now
connect the destination widget (wrt audio signal) with it's source widgets.
	/* output mixer */
	{"Output Mixer", "Line Bypass Switch", "Line Input"},
	{"Output Mixer", "HiFi Playback Switch", "DAC"},
	{"Output Mixer", "Mic Sidetone Switch", "Mic Bias"},
So we have :-
	Destination Widget  <=== Path Name <=== Source Widget
Or:-
	Sink, Path, Source
Or :-
	"Output Mixer" is connected to the "DAC" via the "HiFi Playback Switch".
When there is no path name connecting widgets (e.g. a direct connection) we
pass NULL for the path name.

注意：dapm kcontrol名称 = 目的对象sink名称 + 操作行为control名称，即'Left Output Mixer Left Input Mixer Switch'，操作源对象source名称被忽略。之后深入源码分析。

4、将kcontrols、widgets和route串联起来

static int wm8900_add_widgets(struct snd_soc_codec *codec)
{
	snd_soc_dapm_new_controls(codec, wm8900_dapm_widgets,
				  ARRAY_SIZE(wm8900_dapm_widgets));
	snd_soc_dapm_add_routes(codec, audio_map, ARRAY_SIZE(audio_map));
	snd_soc_dapm_new_widgets(codec);
	return 0;
} 


四、dapm kcontrol

好了，如果仅仅是为了实现audio paths的话，了解以上应该是足够的了。但人生的追求不应该那么简单，我们要从更根源处剖析问题，以后再审视相似的问题时，站的高度也不同。

snd_soc_dapm_route的定义：

/*
 * DAPM audio route definition.
 *
 * Defines an audio route originating at source via control and finishing
 * at sink.
 */
struct snd_soc_dapm_route {
	const char *sink;
	const char *control;
	const char *source;
};

sink为目的对象名称，control为操作行为名称，source为源对象名称。

为方便起见，先定义一些名词：source为输入源，在widgets中定义，如"Left Input Mixer"；sources为输入源选择，如wm8900_loutmix_controls；control为操作行为，具体在sources数组中定义，如"Left Input Mixer Switch"；sink为目的混合器，在widgets中定义，如"Left Output Mixer"；route为音频路径，连接source、control和sink，如{"Left Output Mixer", "Left Input Mixer Switch", "Left Input Mixer"}。

1、snd_soc_dapm_new_controls()函数进行widget内存分配、链表初始化工作，比较简单，按下不表。

2、snd_soc_dapm_add_routes()，该函数的注释值得一看：snd_soc_dapm_add_routes - Add routes between DAPM widgets. Connects 2 dapm widgets together via a named audio path. The sink is the widget receiving the audio signal, whilst the source is the sender of the audio signal.

以MIXER类型snd_soc_dapm_mixer为例，简单介绍调用过程：

snd_soc_dapm_add_routes
  -->snd_soc_dapm_add_route [添加一个snd_soc_dapm_mixer类型的route]
       -->分配snd_soc_dapm_path内存，初始化这个path，令path->sink=sink，path->source=source
          dapm_connect_mixer
            -->检查操作行为control是否存在：从sources中找到name匹配的control
               path->name = control.name;接着将这个path的sink、source和list插入到各自的链表中
               (注：path三大要素中的两个都已经得到即sink和source，差kcontrol。)
               dapm_set_path_status
                 -->判定指定source是否被选择了，是则置p->connect = 1；否则置p->connect = 0

以上的核心部分是path的建立和链表插入操作，如果在sink->kcontrols中找不到name相匹配的kcontrol，则这个route无效，不创建path。这里path->name为找到的sink->kcontrol.name。

其实dapm_set_path_status挺困惑的，path的connect理应包含两个操作：1是指定source的选择，2是sink本身的使能。但这里connect状态仅仅是检查source是否选择而已，不检查指定sink是否使能，看起来不太合理。后面会解决这个疑问。这里我理解可能还有些偏差或有遗漏的地方。

3、snd_soc_dapm_new_widgets()

snd_soc_dapm_new_widgets
  -->遍历dapm_widgets链表，找到为switch、mixer类型的widget
     w->power_check = dapm_generic_check_power;
     dapm_new_mixer
       -->/* add dapm control with long name.
           * for dapm_mixer this is the concatenation of the
           * mixer and kcontrol name.
           * for dapm_mixer_named_ctl this is simply the
           * kcontrol name.
           */
          snd_soc_dapm_mixer dapm kcontrol：path->long_name = sink->name + kcontrol->name
          snd_soc_dapm_mixer_named_ctl dapm kcontrol：path->long_name = kcontrol->name
          snd_soc_cnew为path分配一个kcontrol，置这个kcontrol的name为path->long_name
          snd_ctl_add添加这个dapm kcontrol
          
          dapm_power_widgets
            -->Scan each dapm widget for complete audio path.A complete path is a route that has valid endpoints i.e.:-

经过snd_soc_dapm_new_widgets()，终于为snd_soc_dapm_mixer类型的widget建立用于route切换的dapm kcontrol，使得alsa_amixer可以通过控制这些dapm kcontrol来达到音频通路切换的目的。

注：SND_SOC_DAPM_MIXER和SND_SOC_DAPM_MIXER_NAMED_CTL建立的widget仅体现在dapm kcontrol的名字上面，前者为sink->name + kcontrol->name，后者简单的为kcontrol->name。

4、snd_soc_dapm_path[补充]

/* dapm audio path between two widgets */
struct snd_soc_dapm_path {
	char *name;
	char *long_name;
	/* source (input) and sink (output) widgets */
	struct snd_soc_dapm_widget *source;
	struct snd_soc_dapm_widget *sink;
	struct snd_kcontrol *kcontrol;
	/* status */
	u32 connect:1;	/* source and sink widgets are connected */
	u32 walked:1;	/* path has been walked */
	struct list_head list_source;
	struct list_head list_sink;
	struct list_head list;
};

以上的过程分析非常简略，其实一切都是围绕path展开的。可以把重点放在path的分析上面，搞懂path数据，基本就能理解这个dapm kcontrol的一切了。总的来说：

path->name = sink->kcontrol[i].name，上例是"Left Input Mixer Switch"；

path->long_name = sink->name + sink->kcontrol[i].name，上例是"Left Output Mixer Left Input Mixer Switch"；

path->source = source，上例是名为"Left Input Mixer"的widget；

path->sink = sink，上例是名为"Left Output Mixer"的widget；

path->connect：通道connect状态，根据sink->kcontrol[i]判断。

path->kcontrol = snd_soc_cnew(&w->kcontrols[i], w, path->long_name);可见path->kcontrol对应sink->kcontrol[i]，但名为path->long_name。因此上层可以通过path->long_name找到对应的sink->kcontrol[i]。


五、如何触发path connect

dapm kcontrol的触发很大程度上可以参考snd_kcontrol探究，但更为复杂。当上层触发dapm kcontrol时，会做两个重要动作：1是切换音频通路，这与普通的kcontrol做法基本一致；2是使能dapm widget(power up/down)，这就是分歧之处。

回到<三、AUDIO PATHS代码实现>复习一下"Left Input Mixer Switch"的kcontrol写法：SOC_DAPM_SINGLE("Left Input Mixer Switch", WM8900_REG_BYPASS1, 7, 1, 0)。

1、SOC_DAPM_SINGLE宏定义：

/* dapm kcontrol types */
#define SOC_DAPM_SINGLE(xname, reg, shift, max, invert) /
{	.iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, /
	.info = snd_soc_info_volsw, /
	.get = snd_soc_dapm_get_volsw, .put = snd_soc_dapm_put_volsw, /
	.private_value =  SOC_SINGLE_VALUE(reg, shift, max, invert) }

SOC_SINGLE宏定义：

#define SOC_SINGLE(xname, reg, shift, max, invert) /
{	.iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, /
	.info = snd_soc_info_volsw, .get = snd_soc_get_volsw,/
	.put = snd_soc_put_volsw, /
	.private_value =  SOC_SINGLE_VALUE(reg, shift, max, invert) }

从这里就可以看出，dapm kcontrol跟普通的kcontrol不同之处，以put为例：

dapm kcontrol：.put = snd_soc_dapm_put_volsw

kcontrol：.put = snd_soc_put_volsw

2、snd_soc_dapm_put_volsw

snd_soc_dapm_put_volsw
  -->dapm_mixer_update_power
       -->snd_kcontrol_chip
            -->找到dapm kcontrol所在的widget(也就是操作目的对象sink)
       -->snd_soc_test_bits
            -->Tests a register with a new value and checks if the new value is different from the old value. 
          dapm_power_widgets
            -->power up/down对象widget，更底层可追溯到dapm_seq_run_coalesced
     检查是否有widget->event [这里不分析Event的情况，继续往下走]
     snd_soc_update_bits
       -->根据dapm kcontrol:SOC_DAPM_SINGLE定义的reg、shift和max设置音频通路，方法与普通的kcontrol一样

这是底层方法差异，往上应该没必要说了，与snd_kcontrol探究一致。

sepnic
关注
  • 10
    点赞
  • 踩
  • 67
    收藏
    觉得还不错? 一键收藏
  • 5
    评论
专栏目录
ALSA声卡驱动中的DAPM详解之三：如何定义各种widget
sinat_37817094的博客
11-27 4007
1.定义widget   codec域widget的定义   platform域widget的定义   音频路径path域widget的定义   音频数据流stream域widget的定义 2.定义dapm kcontrol 3.建立widget和route DAPM框架中几个重要的数据结构：snd_soc_dapm_widget，snd_soc_dapm_path，snd_soc_dapm_r...
DAPM之二：音频通路与dapm kcontrol
05-03
从应用到内核系统分析了dapm kcontrol的作用、配置、建立及触发过程，理解这些对于alsa音频通道切换会有较大的帮助。
ASoC驱动框架简介
hqmo的博客
11-10 3817
简介 ASoC框架是一种linux系统声卡驱动框架，是针对嵌入式设备在linux alsa声卡驱动框架基础上进行了一层封装，意在将声卡和cpu两部分的控制代码分离开来； 如上图是音频系统的硬件示意图，声卡通过I2S接口与cpu进行音频数据传输，通过I2C接口与cpu进行控制通讯（数据接口和控制接口也可以是其他）； 录音数据通路：麦克风---->声卡–(I2S)->DMA---->内存； 播放数据通路：内存---->DMA–(I2S)->声卡---->扬声器； 如图所..
DAPM-path、route、context
雨天不打滑的博客
03-05 2043
介绍了dapm的path、route、context
linux alsa笔记 widget建立dapm kcontrol 7 13
lsn946803746的专栏
07-14 656
1.widget建立dapm kcontrol定义一个widget，我们需要指定两个很重要的内容：一个是用于控制widget的电源状态的reg/shift等寄存器信息，另一个是用于控制音频路径切换的dapm kcontrol信息，这些dapm kcontrol有它们自己的reg/shift寄存器信息用于切换widget的路径连接方式。创建了widget的实例，并把它们注册到声卡的widgts链表中，
DAPM-基础及control控件
雨天不打滑的博客
03-05 2152
本文主要介绍DAPM的基础知识以及kcontrol控件
Linux内核4.14版本——alsa框架分析(14)——DAPM(5)——注册widget、route、path
yangguoyu8023的博客
07-10 1532
在驱动程序中初始化并注册widget和route
SOC_SINGLE(xname, reg, shift, max, invert) 参数测试
What the Fuck
07-23 1996
以前在使用这个接口时遇到的这5个参数中前面4个靠字面含义可知，第5个invert就有点含糊了，它指的是谁的invert，当时没有深究，今天终于找到到了它的作用。 我在使用一颗codec时有个mix的开关需要使用SOC_SINGLE()这个宏来描述一下，看datasheet上bit15=0为power off，bit15=1为poweron。于是我还按照原来的用法把invert设置为了
Linux ALSA架构：DPAM概念详解（三）
最新发布
m0_51231887的博客
08-13 474
Linux ALSA架构：DPAM概念详解（三） 一、DAPM简介 DAPM是Dynamic Audio Power Management的缩写，直译过来就是动态音频电源管理的意思，DAPM是为了使基于linux的移动设备上的音频子系统，在任何时候都工作在最小功耗状态下。DAPM对用户空间的应用程序来说是透明的，所有与电源相关的开关都在ASOC core中完成。用户空间的应用程序无需对代码做出修改，也无需重新编译，DAPM根据当前激活的音频流（playback/capture）和声卡中的mixer等的配置来
Linux驱动——ALSA
Hello Mr.Z的博客
05-03 2179
ALSA_control&dapm宏定义 小狼@http://blog.csdn.net/xiaolangyangyang Control宏定义： SOC_SINGLE_VALUE SOC_SINGLE_VALUE_EXT SOC_SINGLE SOC_SINGLE_TLV SOC_DOUBLE SOC_DOUBLE_R SOC_DOUBLE_TLV SOC_DOUBLE_R_TLV SOC_DOUBLE_S8_TLV SOC_ENUM_DOUBLE SOC_ENUM_SINGLE SOC..
ALSA声卡驱动中的DAPM详解之四：在驱动程序中初始化并注册widget和route
DroidPhone的专栏
11-01 2万+
前几篇文章我们从dapm的数据结构入手，了解了代表音频控件的widget，代表连接路径的route以及用于连接两个widget的path。之前都是一些概念的讲解以及对数据结构中各个字段的说明，从本章开始，我们要从代码入手，分析dapm的详细工作原理： 如何注册widget如何连接两个widget一个widget的状态裱画如何传递到整个音频路径中 /*******************
AUDIO CODEC DAPM详解.zip
12-30
本文目的帮助理解音频系统ALSA中的dapm机制建立和触发过程，在这之中，涉及到音频路径的搭建和选择（相信这部分对于大家来说更有应用意义）。在dapm机制深入分析中，会展现alsa设计者的各种理念及实现技巧，很多细节...
AUDIO CODEC DAPM（包括dapm机制和音频路径详细分析）
07-29
本文目的帮助理解音频系统中的dapm机制建立和触发过程，在这之中，涉及到音频路径的搭建和选择（相信这部分对于大家来说更有应用意义） 。在dapm机制深入分析中，会展现alsa设计者的各种理念及实现技巧，很多细节上...
alsa（asoc dapm）框架分析
12-24
alsa（asoc dapm）框架分析，描述了alsa 音频驱动开发过程中一些工具的使用和驱动的分析框架
DAPM：Alexandra Neculae的实验室-创建了一个包含所有实验室的新仓库
02-19
DAPM：Alexandra Neculae的实验室-创建了一个包含所有实验室的新仓库
DAPM之一：概述
热门推荐
AZURE
04-18 3万+
DAPM--Dynamic Audio Power Management，对应结构体是snd_soc_dapm_widget和snd_soc_dapm_route，对应的操作函数是snd_soc_dapm_new_controls()、snd_soc_dapm_add_routes()和snd_soc_dapm_new_widgets()。在我看来，DAPM是音频驱动初接触者的噩梦。从何处来，到何处去？它字面上的意义是音频电源动态管理，但是往往困惑于它是怎么被触发的？而最郁闷的是：这方面的资料是最少的，我涉
如何在Android平台上使用USB Audio设备
AZURE
09-09 2万+
需求：USB Headset插上去后，声音要从本地CODEC切换到USB Headset输出/输入。 上网搜了有关USB Audio Hotplug的东西，比较适用的资源如下： 1、Hotplugging USB audio devices (Howto) 题目看起
ALSA之CODEC分析
AZURE
01-15 2万+
ALSA: Advanced Linux Sound Architecture，它包括内核驱动集合、API库和工具。用户层程序直接调用libsound的API库，不需要打开设备等操作，因此编程者不需要了解底层细节。 这里不分析ALSA的核心代码core，也不阐述如何在用户层进行声卡编程，仅仅简要介绍在ALSA的架构上添加一个声卡驱动，即上图中的Sound Driver。其实文档《wirte an
snd_soc_dapm_post_pmu
07-27
snd_soc_dapm_post_pmu 是 ALSA 音频子系统中的一个函数，负责处理音频设备的电源管理单元 (PMU) 相关的后处理逻辑。 在 ALSA 音频子系统中，音频设备需要进行电源管理以实现功耗优化和资源利用的最佳化。PMU 是...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 5
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值